gh-space-shooter 0.0.2__py3-none-any.whl → 0.0.3__py3-none-any.whl

gh_space_shooter/constants.py

@@ -7,5 +7,13 @@ SHIP_POSITION_Y = NUM_DAYS + 3  # Ship is positioned just below the grid
 
 SHIP_SPEED = 0.25  # Cells per frame the ship moves
 BULLET_SPEED = 0.15  # Cells per frame the bullet moves
+BULLET_TRAILING_LENGTH = 3  # Number of trailing segments for bullets
 FRAME_DURATION_MS = 20  # Duration of each frame in milliseconds
-SHIP_SHOOT_COOLDOWN_FRAMES = 10  # Frames between ship shots
+SHIP_SHOOT_COOLDOWN_FRAMES = 10  # Frames between ship shots
+
+EXPLOSION_PARTICLE_COUNT_LARGE = 8  # Number of particles in a large explosion
+EXPLOSION_PARTICLE_COUNT_SMALL = 4  # Number of particles in a small explosion
+EXPLOSION_MAX_RADIUS_LARGE = 20  # Max radius for large explosions
+EXPLOSION_MAX_RADIUS_SMALL = 10  # Max radius for small explosions
+EXPLOSION_MAX_FRAMES_LARGE = 20  # Frames for large explosion animation
+EXPLOSION_MAX_FRAMES_SMALL = 6  # Frames for small explosion animation

gh_space_shooter/game/drawables/bullet.py

@@ -4,7 +4,7 @@ from typing import TYPE_CHECKING
 
 from PIL import ImageDraw
 
-from ...constants import BULLET_SPEED, SHIP_POSITION_Y
+from ...constants import BULLET_SPEED, BULLET_TRAILING_LENGTH, SHIP_POSITION_Y
 from .drawable import Drawable
 from .explosion import Explosion
 
@@ -52,10 +52,9 @@ class Bullet(Drawable):
     def draw(self, draw: ImageDraw.ImageDraw, context: "RenderContext") -> None:
         """Draw the bullet with trailing tail effect."""
 
-        trail_num = 3
-        for i in range(trail_num):
+        for i in range(BULLET_TRAILING_LENGTH):
             trail_y = self.y + (i + 1) * BULLET_SPEED
-            fade_factor = (i + 1) / trail_num / 2
+            fade_factor = (i + 1) / BULLET_TRAILING_LENGTH / 2
             self._draw_bullet(draw, context, (self.x, trail_y), fade_factor=fade_factor)
 
         self._draw_bullet(draw, context, (self.x, self.y), fade_factor=0.3, offset=.6)

gh_space_shooter/game/drawables/explosion.py

@@ -6,6 +6,14 @@ from typing import TYPE_CHECKING, Literal
 
 from PIL import ImageDraw
 
+from ...constants import (
+    EXPLOSION_MAX_FRAMES_LARGE,
+    EXPLOSION_MAX_FRAMES_SMALL,
+    EXPLOSION_MAX_RADIUS_LARGE,
+    EXPLOSION_MAX_RADIUS_SMALL,
+    EXPLOSION_PARTICLE_COUNT_LARGE,
+    EXPLOSION_PARTICLE_COUNT_SMALL,
+)
 from .drawable import Drawable
 
 if TYPE_CHECKING:
@@ -30,10 +38,9 @@ class Explosion(Drawable):
         self.y = y
         self.game_state = game_state
         self.frame = 0
-        self.max_frames = 6 if size == "small" else 20
-        self.max_radius = 10 if size == "small" else 20
-        self.particle_count = 4 if size == "small" else 8
-        # Generate random angles for each particle
+        self.max_frames = EXPLOSION_MAX_FRAMES_SMALL if size == "small" else EXPLOSION_MAX_FRAMES_LARGE
+        self.max_radius = EXPLOSION_MAX_RADIUS_SMALL if size == "small" else EXPLOSION_MAX_RADIUS_LARGE
+        self.particle_count = EXPLOSION_PARTICLE_COUNT_SMALL if size == "small" else EXPLOSION_PARTICLE_COUNT_LARGE
         self.particle_angles = [random.uniform(0, 2 * math.pi) for _ in range(self.particle_count)]
 
     def animate(self) -> None:
@@ -44,21 +51,18 @@ class Explosion(Drawable):
 
     def draw(self, draw: ImageDraw.ImageDraw, context: "RenderContext") -> None:
         """Draw expanding particle explosion with fade effect."""
-        # Calculate animation progress (0 to 1)
+
         progress = self.frame / self.max_frames
         fade = 1 - progress  # Fade out as animation progresses
 
-        # Get center position
         center_x, center_y = context.get_cell_position(self.x, self.y)
         center_x += context.cell_size // 2
         center_y += context.cell_size // 2
 
-        # Draw expanding particles in random directions
         for i in range(self.particle_count):
             distance = progress * self.max_radius
             angle = self.particle_angles[i]
 
-            # Particle position using random angle
             px = int(center_x + distance * math.cos(angle))
             py = int(center_y + distance * math.sin(angle))
 

gh_space_shooter/github_client.py

@@ -32,7 +32,6 @@ class ContributionData(TypedDict):
     username: str
     total_contributions: int
     weeks: list[ContributionWeek]
-    fetched_at: str
 
 
 class GitHubAPIError(Exception):
@@ -157,7 +156,6 @@ class GitHubClient:
             "username": username,
             "total_contributions": calendar["totalContributions"],
             "weeks": weeks,
-            "fetched_at": datetime.now().isoformat(),
         }
 
     LEVEL_MAP = {

{gh_space_shooter-0.0.2.dist-info → gh_space_shooter-0.0.3.dist-info}/METADATA

@@ -1,15 +1,17 @@
 Metadata-Version: 2.4
 Name: gh-space-shooter
-Version: 0.0.2
+Version: 0.0.3
 Summary: A CLI tool that visualizes GitHub contribution graphs as gamified GIFs
 Author-email: zane <czl970721@gmail.com>
 License-File: LICENSE
 Requires-Python: >=3.13
 Requires-Dist: httpx>=0.27.0
-Requires-Dist: pillow>=10.0.0
+Requires-Dist: pillow>=10.1.0
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # gh-space-shooter 🚀
@@ -18,19 +20,49 @@ Transform your GitHub contribution graph into an epic space shooter game!
 
 ![Example Game](example.gif)
 
-## Features
+## Usage
+
+### GitHub Action
+
+Automatically update your game GIF daily using GitHub Actions! Add this workflow to your repository at `.github/workflows/update-game.yml`:
+
+```yaml
+name: Update Space Shooter Game
+
+on:
+  schedule:
+    - cron: '0 0 * * *'  # Daily at midnight UTC
+  workflow_dispatch:  # Allow manual trigger
 
-- 🚀 **Galaga-style space shooter** - Classic arcade gameplay with your contribution data
-- 📊 **GitHub integration** - Fetches your last 52 weeks of contributions automatically
-- 🎮 **Smart enemy AI** - Multiple attack strategies (columns, rows, random patterns)
-- 💥 **Particle effects** - Explosions with randomized particles and smooth animations
-- 🎨 **Polished graphics** - Rounded enemies, smooth ship design, starfield background
-- 📈 **Contribution stats** - View your coding activity statistics
-- 💾 **Export options** - Save both the GIF and raw JSON data
+permissions:
+  contents: write
+
+jobs:
+  update-game:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: czl9707/gh-space-shooter@v1
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          output-path: 'game.gif'
+          strategy: 'random'
+```
+
+Then display it in your README:
+```markdown
+![My GitHub Game](game.gif)
+```
 
-## Installation
+**Action Inputs:**
+- `github-token` (required): GitHub token for fetching contributions
+- `username` (optional): Username to generate game for (defaults to repo owner)
+- `output-path` (optional): Where to save the GIF (default: `gh-space-shooter.gif`)
+- `strategy` (optional): Attack pattern - `column`, `row`, or `random` (default: `random`)
+- `commit-message` (optional): Commit message for the update
 
-### From PyPI (Recommended)
+### From PyPI
 
 ```bash
 pip install gh-space-shooter
@@ -131,8 +163,7 @@ When saved to JSON, the data includes:
         }
       ]
     }
-  ],
-  "fetched_at": "2024-12-30T12:00:00"
+  ]
 }
 ```
 

{gh_space_shooter-0.0.2.dist-info → gh_space_shooter-0.0.3.dist-info}/RECORD

@@ -1,8 +1,8 @@
 gh_space_shooter/__init__.py,sha256=jBFfHY3YC8-3m-eVPIo3CWoQLsy5Yvd0vcbHVbUDTWY,337
 gh_space_shooter/cli.py,sha256=AHONWh6Kv9Y8D7OWsnOH6kOjN73aSCXF8Ats9jKJwkY,5310
 gh_space_shooter/console_printer.py,sha256=opT5vITkPJ_9BCPNMDays6EtXez9m86YXY9pK5_Hdh8,2345
-gh_space_shooter/constants.py,sha256=HR_FYewYnjQ8V5fJwMS2UhiYSS3l0iR5Y8bmaS3thQE,498
-gh_space_shooter/github_client.py,sha256=Ugt4wi8RAvnYPO8fF7-MgugD5t91nxQUcEnCf-Hmc-8,4771
+gh_space_shooter/constants.py,sha256=zMJn4wtCJf11X0pEJeK2q9zfawifB8O-PH1NEOpB0k0,1004
+gh_space_shooter/github_client.py,sha256=PkXGWjR7TpzJvCPg37RM4kPq1phg_MlyBpHNtofaNXQ,4697
 gh_space_shooter/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gh_space_shooter/game/__init__.py,sha256=bIc-S0hOiYqYBtdmd9_CedqYY07Il6XiV__TqcbtJNA,707
 gh_space_shooter/game/animator.py,sha256=5nCY0xfRl6tifwixUlUlVXCQfDjhsR6HbQBKHHmYHH8,2998
@@ -10,10 +10,10 @@ gh_space_shooter/game/game_state.py,sha256=pvKc-FAapVXuFNb2hCGoOhJI1P8kWXkyCf_lr
 gh_space_shooter/game/render_context.py,sha256=TPJw9RmRB0_786W-O7nfB61UoDzDT_SlEVdaSlW750c,1805
 gh_space_shooter/game/renderer.py,sha256=J13eUOWHkImtiNWGyvRqORM7ngg1Q7LBUgs4cWFl26g,1617
 gh_space_shooter/game/drawables/__init__.py,sha256=lzo3O5cxahrYTyOQVrz7rQ3Prkaj8Z_dpzlt0UdurOo,306
-gh_space_shooter/game/drawables/bullet.py,sha256=8DjqXI1Ab4IINi77szJuRc5Bqilb0gvofKgcQ9s0ONM,2920
+gh_space_shooter/game/drawables/bullet.py,sha256=tNhdvMw8HPbxyZuE-xTJpo0UGJvb9H8Hj5rA_nZjSUk,2948
 gh_space_shooter/game/drawables/drawable.py,sha256=xIJWI5m-kZCbvCfgYF4jiqTvPFelViJ1gLilz7adJoM,738
 gh_space_shooter/game/drawables/enemy.py,sha256=RCIE4Vn2tis0iJmJO_JUIxnomSgDSsfFhrcPPWmFLhE,1921
-gh_space_shooter/game/drawables/explosion.py,sha256=Ek2CCjjifkLVSpaJ4Nv8ey1VhkXNK6HeKK3wB0fRI5g,2618
+gh_space_shooter/game/drawables/explosion.py,sha256=XJM7NUnK-lkD-AOw8AusUD2erfojyW3rKAi-vqY8eEw,2767
 gh_space_shooter/game/drawables/ship.py,sha256=j389lXOUWvPoFZUNvVN-OEjhTtIlEkAVeEYqF7gDBIE,3216
 gh_space_shooter/game/drawables/starfield.py,sha256=ON_cQ6Qfg30ocLHQEp1dceqputHmxJ7sf61o4uNF4Ng,2530
 gh_space_shooter/game/strategies/__init__.py,sha256=a34i4FlNv-aQ-oEkT1ha7oJDBt7Cd7EFpbMWsYNHpW0,338
@@ -21,8 +21,8 @@ gh_space_shooter/game/strategies/base_strategy.py,sha256=IwPdthCWkgsFdUsMjQgifpS
 gh_space_shooter/game/strategies/column_strategy.py,sha256=AQHXVTRe5BEjc4QHRL9QLtkkelTzGUGf2531POGtkG0,1728
 gh_space_shooter/game/strategies/random_strategy.py,sha256=l0GKMkGJa_QEvNrN57R_KgWDBafGebP926fZJqpdghc,2215
 gh_space_shooter/game/strategies/row_strategy.py,sha256=8izcioSGrVYGdQ__GrdfAQxnJt1BLhwNdumeuQiDhpg,1426
-gh_space_shooter-0.0.2.dist-info/METADATA,sha256=Kd8sR8mbxG7X88E0abNI8ohBtZrN-NtjzDyNqFFFqTQ,3493
-gh_space_shooter-0.0.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-gh_space_shooter-0.0.2.dist-info/entry_points.txt,sha256=SmK2ET5vz62eaMC4mhxmLJ1f_H9qSTXOvFOHNo-qwCk,62
-gh_space_shooter-0.0.2.dist-info/licenses/LICENSE,sha256=teCrgzzcmjYCQ-RqXkDmICcHMN1AfaabrjZsW6O3KEk,1075
-gh_space_shooter-0.0.2.dist-info/RECORD,,
+gh_space_shooter-0.0.3.dist-info/METADATA,sha256=oSw8RS0yzv1ZX9oLO3vs_MWgpD38yn8fdeSxG3FxADQ,3999
+gh_space_shooter-0.0.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+gh_space_shooter-0.0.3.dist-info/entry_points.txt,sha256=SmK2ET5vz62eaMC4mhxmLJ1f_H9qSTXOvFOHNo-qwCk,62
+gh_space_shooter-0.0.3.dist-info/licenses/LICENSE,sha256=teCrgzzcmjYCQ-RqXkDmICcHMN1AfaabrjZsW6O3KEk,1075
+gh_space_shooter-0.0.3.dist-info/RECORD,,