spacecrew 1.1.0__tar.gz

spacecrew-1.1.0/.github/workflows/build.yml

@@ -0,0 +1,28 @@
+name: release
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build package
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Build
+        run: uv build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error

spacecrew-1.1.0/.github/workflows/publish.yml

@@ -0,0 +1,44 @@
+name: publish
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Verify tag matches pyproject version
+        run: |
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+          PYPROJECT_VERSION="$(python3 -c 'import tomllib; print(tomllib.load(open("pyproject.toml","rb"))["project"]["version"])')"
+          if [ "$TAG_VERSION" != "$PYPROJECT_VERSION" ]; then
+            echo "::error::tag version 'v$TAG_VERSION' does not match pyproject version '$PYPROJECT_VERSION'"
+            exit 1
+          fi
+          echo "version $TAG_VERSION matches"
+
+      - name: Build
+        run: uv build
+
+      - name: Check version does not already exist on PyPI
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          if curl -fsSI "https://pypi.org/pypi/spacecrew/$VERSION/json" > /dev/null 2>&1; then
+            echo "::error::spacecrew $VERSION already exists on PyPI"
+            exit 1
+          fi
+          echo "spacecrew $VERSION not found on PyPI, proceeding"
+
+      - name: Publish
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_TOKEN }}
+        run: uv publish

spacecrew-1.1.0/.gitignore

@@ -0,0 +1,65 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# mypy
+.mypy_cache/

spacecrew-1.1.0/.pre-commit-config.yaml

@@ -0,0 +1,21 @@
+default_install_hook_types:
+  - commit-msg
+  - pre-commit
+repos:
+  - repo: local
+    hooks:
+      - id: needs-prefix
+        name: commit message needs to have a prefix
+        language: pygrep
+        entry: '^(chore|ci|junk|test|feat|fix|build|docs|refactor)!?(\([a-z]+\))?: (?![A-Z])(?![a-z]+(ed|ing)\s).*$'
+        args:
+          - '--multiline'
+          - '--negate'
+        stages:
+          - commit-msg
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-added-large-files

spacecrew-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jakub Ginał
+
+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.

spacecrew-1.1.0/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.5
+Name: spacecrew
+Version: 1.1.0
+Summary: Check who is in space right now
+Project-URL: Homepage, https://github.com/jakub-ginal/spacecrew
+Author: Jakub Ginał
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: chafa-py>=1.2
+Requires-Dist: pillow>=10.0
+Requires-Dist: requests>=2.0
+Requires-Dist: rich>=13.0
+Description-Content-Type: text/markdown
+
+# spacecrew
+Spacecrew is a lightweight Python terminal program that shows who is in space right now.
+
+<img width="800" height="600" alt="92_1x_shots_so" src="https://github.com/user-attachments/assets/dfd95ad7-904d-4495-9c98-b8e1751ea5f3" />
+
+
+## Tested Systems
+
+* **CachyOS**
+* **Ubuntu**
+* **Debian**
+
+## Installation
+
+Clone the repository and run the setup script to automatically install dependencies and configure the command:
+
+```bash
+git clone https://github.com/jakub-ginal/spacecrew
+cd spacecrew
+chmod +x setup.sh
+./setup.sh
+```
+Or run it via this single command:
+```bash
+git clone https://github.com/jakub-ginal/spacecrew && cd spacecrew && bash setup.sh && hash -r && cd ~ && rm -rf ~/spacecrew
+```
+## Usage
+
+Simply type `spacecrew` anywhere in your terminal.
+Follow the interactive menu to select a mission or view specific astronaut details and photos.
+
+### Time in Space
+
+* **p (previous)**: Days from past missions.
+* **c (current)**: Days from the current mission (tracked live).
+<img width="800" height="600" alt="356_1x_shots_so" src="https://github.com/user-attachments/assets/a87a2e9d-3c5a-443c-b62f-ec19f2922f0d" />
+
+ 
+## Uninstall
+
+To completely remove the program and its configuration from your system, run:
+```bash
+cd ~ && rm -rf ~/spacecrew && rm -f ~/.local/bin/spacecrew && hash -r
+```
+## Data Source
+
+Data provided by [International Space Station APIs](https://github.com/corquaid/international-space-station-APIs) by **Cormac Quaid**.

spacecrew-1.1.0/README.md

@@ -0,0 +1,47 @@
+# spacecrew
+Spacecrew is a lightweight Python terminal program that shows who is in space right now.
+
+<img width="800" height="600" alt="92_1x_shots_so" src="https://github.com/user-attachments/assets/dfd95ad7-904d-4495-9c98-b8e1751ea5f3" />
+
+
+## Tested Systems
+
+* **CachyOS**
+* **Ubuntu**
+* **Debian**
+
+## Installation
+
+Clone the repository and run the setup script to automatically install dependencies and configure the command:
+
+```bash
+git clone https://github.com/jakub-ginal/spacecrew
+cd spacecrew
+chmod +x setup.sh
+./setup.sh
+```
+Or run it via this single command:
+```bash
+git clone https://github.com/jakub-ginal/spacecrew && cd spacecrew && bash setup.sh && hash -r && cd ~ && rm -rf ~/spacecrew
+```
+## Usage
+
+Simply type `spacecrew` anywhere in your terminal.
+Follow the interactive menu to select a mission or view specific astronaut details and photos.
+
+### Time in Space
+
+* **p (previous)**: Days from past missions.
+* **c (current)**: Days from the current mission (tracked live).
+<img width="800" height="600" alt="356_1x_shots_so" src="https://github.com/user-attachments/assets/a87a2e9d-3c5a-443c-b62f-ec19f2922f0d" />
+
+ 
+## Uninstall
+
+To completely remove the program and its configuration from your system, run:
+```bash
+cd ~ && rm -rf ~/spacecrew && rm -f ~/.local/bin/spacecrew && hash -r
+```
+## Data Source
+
+Data provided by [International Space Station APIs](https://github.com/corquaid/international-space-station-APIs) by **Cormac Quaid**.

spacecrew-1.1.0/pyproject.toml

@@ -0,0 +1,24 @@
+[project]
+name = "spacecrew"
+version = "1.1.0"
+description = "Check who is in space right now"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "Jakub Ginał" }]
+dependencies = [
+    "rich>=13.0",
+    "requests>=2.0",
+    "chafa.py>=1.2",
+    "pillow>=10.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/jakub-ginal/spacecrew"
+
+[project.scripts]
+spacecrew = "spacecrew:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

spacecrew-1.1.0/src/spacecrew/__init__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+__all__ = ["main"]

spacecrew-1.1.0/src/spacecrew/cli.py

@@ -0,0 +1,219 @@
+import os
+import time
+from collections import defaultdict
+from datetime import datetime
+from io import BytesIO
+
+import chafa
+import requests
+from PIL import Image
+from rich.columns import Columns
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+from rich.text import Text
+from rich.tree import Tree
+
+console = Console()
+
+
+def clear_screen():
+    os.system("clear")
+
+
+def fetch_space_data():
+    url = "https://corquaid.github.io/international-space-station-APIs/JSON/people-in-space.json"
+    headers = {"User-Agent": "Mozilla/5.0"}
+    try:
+        res = requests.get(url, headers=headers, timeout=5)
+        if res.status_code == 200:
+            return res.json()["people"]
+    except Exception:
+        pass
+    return None
+
+
+def group_people_by_station(people):
+    iss_groups = defaultdict(list)
+    tiangong_groups = defaultdict(list)
+
+    for p in people:
+        craft = p.get("spacecraft", "Unknown")
+        if p.get("iss"):
+            iss_groups[craft].append(p)
+        else:
+            tiangong_groups[craft].append(p)
+
+    return iss_groups, tiangong_groups
+
+
+def build_tree_menu(people_count, iss_groups, tiangong_groups):
+    tree = Tree(f"[bold white]PEOPLE IN SPACE ({people_count})[/bold white]")
+    missions = []
+    num = 1
+
+    iss_node = tree.add("[bold green]ISS[/bold green]")
+    for craft, members in iss_groups.items():
+        m_node = iss_node.add(f"[bold cyan]{num}. {craft}[/bold cyan]")
+        for m in members:
+            m_node.add(f"{m.get('name')} ({m.get('country')})")
+        missions.append((craft, members))
+        num += 1
+
+    tiangong_node = tree.add("[bold deep_sky_blue]Tiangong[/bold deep_sky_blue]")
+    for craft, members in tiangong_groups.items():
+        m_node = tiangong_node.add(f"[bold cyan]{num}. {craft}[/bold cyan]")
+        for m in members:
+            m_node.add(f"{m.get('name')} ({m.get('country')})")
+        missions.append((craft, members))
+        num += 1
+
+    return tree, missions
+
+
+def fetch_photo_panel(url):
+    if not url:
+        return Panel(Text("No photo", style="dim red"), title="Photo", expand=False)
+
+    try:
+        res = requests.get(url, headers={"User-Agent": "Mozilla/5.0"}, timeout=5)
+        if res.status_code == 200:
+            img = Image.open(BytesIO(res.content)).convert("RGB")
+            width, height = img.size
+            pixels = img.tobytes()
+
+            config = chafa.CanvasConfig()
+            config.width = 28
+            config.height = 16
+
+            canvas = chafa.Canvas(config)
+            canvas.draw_all_pixels(
+                chafa.PixelType.CHAFA_PIXEL_RGB8, pixels, width, height, width * 3
+            )
+            out = canvas.print().decode("utf-8")
+
+            return Panel(Text.from_ansi(out), title="Photo", expand=False)
+    except Exception:
+        pass
+
+    return Panel(Text("No photo", style="dim red"), title="Photo", expand=False)
+
+
+def create_mission_table(craft, members):
+    table = Table(title=f"Mission: {craft}")
+    table.add_column("No.", style="cyan", justify="right")
+    table.add_column("Name", style="bold white")
+    table.add_column("Country", style="green")
+
+    for i, m in enumerate(members, 1):
+        table.add_row(str(i), str(m.get("name")), str(m.get("country")))
+
+    return table
+
+
+def calculate_space_experience(launched_timestamp, previous_days):
+    if not launched_timestamp:
+        return "N/A", f"{previous_days} days"
+
+    dt = datetime.fromtimestamp(launched_timestamp)
+    launched_str = dt.strftime("%Y-%m-%d %H:%M UTC")
+
+    current_mission_days = (time.time() - launched_timestamp) / 86400
+    total_days = previous_days + current_mission_days
+
+    total_str = f"{total_days:.1f} days ({previous_days}p + {current_mission_days:.1f}c)"
+    return launched_str, total_str
+
+
+def create_profile_table(person):
+    table = Table(title=f"Profile: {person.get('name')}")
+    table.add_column("Property", style="cyan")
+    table.add_column("Value", style="white", max_width=40)
+
+    table.add_row("Country", f"{person.get('country')} {person.get('flag', '')}")
+    table.add_row("Position", str(person.get("position") or "N/A"))
+    table.add_row("Agency", str(person.get("agency") or "N/A"))
+    table.add_row("Spacecraft", str(person.get("spacecraft") or "N/A"))
+
+    launched_ts = person.get("launched")
+    prev_days = person.get("days_in_space", 0)
+    launched_date, total_experience = calculate_space_experience(launched_ts, prev_days)
+
+    table.add_row("Launched At", launched_date)
+    table.add_row("Time in Space", total_experience)
+
+    links = [
+        ("Image URL", person.get("image")),
+        ("Wikipedia", person.get("url")),
+        ("X (Twitter)", person.get("twitter")),
+        ("Instagram", person.get("instagram")),
+    ]
+
+    for label, link_url in links:
+        if link_url:
+            table.add_row(label, f"[link={link_url}]Open Link[/link]")
+        else:
+            table.add_row(label, "N/A")
+
+    return table
+
+
+def show_astronaut_view(person):
+    clear_screen()
+    photo_panel = fetch_photo_panel(person.get("image"))
+    profile_table = create_profile_table(person)
+    console.print(Columns([photo_panel, profile_table]))
+    input("\nPress Enter to return to menu...")
+
+
+def handle_mission_view(craft, members):
+    clear_screen()
+    console.print(create_mission_table(craft, members))
+
+    astro_choice = input("\nSelect astronaut number (or 'menu'/'quit'): ").strip().lower()
+
+    if astro_choice == "quit":
+        return "quit"
+    elif astro_choice == "menu":
+        return "menu"
+
+    if astro_choice.isdigit():
+        a_idx = int(astro_choice) - 1
+        if 0 <= a_idx < len(members):
+            show_astronaut_view(members[a_idx])
+
+    return "ok"
+
+
+def main():
+    while True:
+        clear_screen()
+        people = fetch_space_data()
+
+        if people is None:
+            console.print("[bold red]Error: No internet connection. Please check your network and try again.[/bold red]")
+            input("\nPress Enter to retry...")
+            continue
+
+        iss_groups, tiangong_groups = group_people_by_station(people)
+        tree, missions = build_tree_menu(len(people), iss_groups, tiangong_groups)
+
+        console.print(tree)
+        choice = input("\n> ").strip().lower()
+
+        if choice == "quit":
+            break
+        elif choice == "menu":
+            continue
+
+        if choice.isdigit():
+            idx = int(choice) - 1
+            if 0 <= idx < len(missions):
+                craft, members = missions[idx]
+                result = handle_mission_view(craft, members)
+                if result == "quit":
+                    break
+
+
+if __name__ == "__main__":
+    main()