gh-space-shooter 0.0.1__tar.gz

gh_space_shooter-0.0.1/.github/dependabot.yml

@@ -0,0 +1,8 @@
+version: 2
+updates:
+- package-ecosystem: uv
+  directory: /
+  schedule:
+    interval: weekly
+  open-pull-requests-limit: 1
+  target-branch: main

gh_space_shooter-0.0.1/.github/workflows/publish.yml

@@ -0,0 +1,55 @@
+name: Publish to PyPI
+
+on:
+  workflow_dispatch:
+    inputs:
+      release_type:
+        description: "Release Type"
+        required: true
+        type: choice
+        default: "patch"
+        options:
+        - major
+        - minor
+        - patch
+
+env:
+  PYTHON_LATEST: 3.13
+
+jobs:
+  build:
+    name: Publish
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
+
+    - name: Install Python ${{ env.PYTHON_LATEST }}
+      run: uv python install ${{ env.PYTHON_LATEST }}
+
+    - name: Build
+      run: uv build
+
+    - name: Bump version
+      id: bump
+      uses: callowayproject/bump-my-version@master
+      env:
+        BUMPVERSION_TAG: "false"
+      with:
+        args: ${{ inputs.release_type }}
+        github-token: ${{ secrets.GH_TOKEN }}
+
+    - name: Publish
+      run: uv publish --token ${{ secrets.PYPI_API_TOKEN }}
+
+    - name: GitHub Release v${{ steps.bump.outputs.current-version }}
+      uses: ncipollo/release-action@v1
+      with:
+        name: pytest-asyncio-concurrent v${{ steps.bump.outputs.current-version }}
+        tag: v${{ steps.bump.outputs.current-version }}
+        body: "Automated release of version v${{ steps.bump.outputs.current-version }}"
+        artifacts: dist/*
+        token: ${{ secrets.GH_TOKEN }}

gh_space_shooter-0.0.1/.gitignore

@@ -0,0 +1,19 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# IDE files
+.vscode/
+.mypy_cache/
+.claude
+
+# Environment variables (secrets)
+.env
+.env.*

gh_space_shooter-0.0.1/.python-version

@@ -0,0 +1 @@
+3.13

gh_space_shooter-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Zane Chen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

gh_space_shooter-0.0.1/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: gh-space-shooter
+Version: 0.0.1
+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: python-dotenv>=1.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.12.0
+Description-Content-Type: text/markdown
+
+# gh-space-shooter 🚀
+
+Transform your GitHub contribution graph into an epic space shooter game! 
+
+![Example Game](example.gif)
+
+## Features
+
+- 🚀 **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
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+pip install gh-space-shooter
+```
+
+### From Source
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/gh-space-shooter.git
+cd gh-space-shooter
+
+# Install with uv
+uv sync
+
+# Or with pip
+pip install -e .
+```
+
+## Setup
+
+1. Create a GitHub Personal Access Token:
+   - Go to https://github.com/settings/tokens
+   - Click "Generate new token (classic)"
+   - Select scopes: `read:user`
+   - Copy the generated token
+
+2. Set up your environment:
+   ```bash
+   # Copy the example env file
+   touch .env
+   echo "GH_TOKEN=your_token_here" >> .env
+   ```
+
+   Alternatively, export the token directly:
+   ```bash
+   export GH_TOKEN=your_token_here
+   ```
+
+## Usage
+
+### Generate Your Game GIF
+
+Transform your GitHub contributions into an epic space shooter!
+
+```bash
+# Basic usage - generates username-gh-space-shooter.gif
+gh-space-shooter <username>
+
+# Examples
+gh-space-shooter torvalds
+gh-space-shooter octocat
+
+# Specify custom output filename
+gh-space-shooter torvalds --output my-epic-game.gif
+gh-space-shooter torvalds -o my-game.gif
+
+# Choose enemy attack strategy
+gh-space-shooter torvalds --strategy column   # Enemies attack in columns
+gh-space-shooter torvalds --strategy row      # Enemies attack in rows
+gh-space-shooter torvalds -s random           # Random chaos (default)
+```
+
+This creates an animated GIF showing:
+- Your contribution graph as enemies (more contributions = stronger enemies)
+- A Galaga-style spaceship battling through your coding history
+- Enemy attack patterns based on your chosen strategy
+- Smooth animations with randomized particle effects
+- Your contribution stats displayed in the console
+
+### Advanced Options
+
+```bash
+# Save raw contribution data to JSON
+gh-space-shooter torvalds --raw-output data.json
+
+# Load from previously saved JSON (saves API rate limits)
+gh-space-shooter --raw-input data.json --output game.gif
+
+# Combine options
+gh-space-shooter torvalds -o game.gif -ro data.json -s column
+```
+
+### Data Format
+
+When saved to JSON, the data includes:
+```json
+{
+  "username": "torvalds",
+  "total_contributions": 1234,
+  "weeks": [
+    {
+      "days": [
+        {
+          "date": "2024-01-01",
+          "count": 5,
+          "level": 2
+        }
+      ]
+    }
+  ],
+  "fetched_at": "2024-12-30T12:00:00"
+}
+```
+
+## License
+
+MIT

gh_space_shooter-0.0.1/README.md

@@ -0,0 +1,127 @@
+# gh-space-shooter 🚀
+
+Transform your GitHub contribution graph into an epic space shooter game! 
+
+![Example Game](example.gif)
+
+## Features
+
+- 🚀 **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
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+pip install gh-space-shooter
+```
+
+### From Source
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/gh-space-shooter.git
+cd gh-space-shooter
+
+# Install with uv
+uv sync
+
+# Or with pip
+pip install -e .
+```
+
+## Setup
+
+1. Create a GitHub Personal Access Token:
+   - Go to https://github.com/settings/tokens
+   - Click "Generate new token (classic)"
+   - Select scopes: `read:user`
+   - Copy the generated token
+
+2. Set up your environment:
+   ```bash
+   # Copy the example env file
+   touch .env
+   echo "GH_TOKEN=your_token_here" >> .env
+   ```
+
+   Alternatively, export the token directly:
+   ```bash
+   export GH_TOKEN=your_token_here
+   ```
+
+## Usage
+
+### Generate Your Game GIF
+
+Transform your GitHub contributions into an epic space shooter!
+
+```bash
+# Basic usage - generates username-gh-space-shooter.gif
+gh-space-shooter <username>
+
+# Examples
+gh-space-shooter torvalds
+gh-space-shooter octocat
+
+# Specify custom output filename
+gh-space-shooter torvalds --output my-epic-game.gif
+gh-space-shooter torvalds -o my-game.gif
+
+# Choose enemy attack strategy
+gh-space-shooter torvalds --strategy column   # Enemies attack in columns
+gh-space-shooter torvalds --strategy row      # Enemies attack in rows
+gh-space-shooter torvalds -s random           # Random chaos (default)
+```
+
+This creates an animated GIF showing:
+- Your contribution graph as enemies (more contributions = stronger enemies)
+- A Galaga-style spaceship battling through your coding history
+- Enemy attack patterns based on your chosen strategy
+- Smooth animations with randomized particle effects
+- Your contribution stats displayed in the console
+
+### Advanced Options
+
+```bash
+# Save raw contribution data to JSON
+gh-space-shooter torvalds --raw-output data.json
+
+# Load from previously saved JSON (saves API rate limits)
+gh-space-shooter --raw-input data.json --output game.gif
+
+# Combine options
+gh-space-shooter torvalds -o game.gif -ro data.json -s column
+```
+
+### Data Format
+
+When saved to JSON, the data includes:
+```json
+{
+  "username": "torvalds",
+  "total_contributions": 1234,
+  "weeks": [
+    {
+      "days": [
+        {
+          "date": "2024-01-01",
+          "count": 5,
+          "level": 2
+        }
+      ]
+    }
+  ],
+  "fetched_at": "2024-12-30T12:00:00"
+}
+```
+
+## License
+
+MIT