terminus-game 0.1.0__tar.gz

terminus_game-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest tests/ -v --tb=short

terminus_game-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,112 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: write
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: |
+          pip install --upgrade pip
+          pip install -e ".[dev]"
+      - run: pytest tests/ -v --tb=short
+
+  build-wheel:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build wheel and sdist
+        run: |
+          pip install build
+          python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  build-exe:
+    needs: test
+    strategy:
+      matrix:
+        include:
+          - os: windows-latest
+            artifact: terminus-windows.exe
+            exe-path: dist/terminus.exe
+          - os: ubuntu-latest
+            artifact: terminus-linux
+            exe-path: dist/terminus
+          - os: macos-latest
+            artifact: terminus-macos
+            exe-path: dist/terminus
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install dependencies
+        run: |
+          pip install --upgrade pip
+          pip install -e ".[build]"
+          pip install -e .
+      - name: Build executable
+        run: pyinstaller terminus.spec --clean --noconfirm
+      - uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.artifact }}
+          path: ${{ matrix.exe-path }}
+
+  release:
+    needs: [build-wheel, build-exe]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          path: artifacts/
+
+      - name: Organize release files
+        run: |
+          mkdir -p release-files
+          cp artifacts/dist/* release-files/
+          cp artifacts/terminus-windows.exe/terminus.exe release-files/terminus-windows.exe
+          cp artifacts/terminus-linux/terminus release-files/terminus-linux
+          cp artifacts/terminus-macos/terminus release-files/terminus-macos
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: release-files/*
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  publish-pypi:
+    needs: [build-wheel]
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

terminus_game-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+dist/
+build/
+*.egg-info/
+*.egg
+.eggs/
+*.db
+*.sqlite
+.env
+.venv/
+venv/
+env/
+.idea/
+.vscode/
+*.spec

terminus_game-0.1.0/LICENSE

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

terminus_game-0.1.0/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: terminus-game
+Version: 0.1.0
+Summary: Multiplayer CLI survival strategy game
+Project-URL: Homepage, https://github.com/kushal-DL/terminus
+Project-URL: Repository, https://github.com/kushal-DL/terminus
+Project-URL: Issues, https://github.com/kushal-DL/terminus/issues
+Author: Terminus Dev
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,game,multiplayer,strategy,survival,terminal,tui
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Games/Entertainment :: Simulation
+Classifier: Topic :: Games/Entertainment :: Turn Based Strategy
+Requires-Python: >=3.11
+Requires-Dist: aiosqlite<1.0,>=0.20
+Requires-Dist: fastapi<1.0,>=0.100
+Requires-Dist: httpx<1.0,>=0.24
+Requires-Dist: pydantic<3.0,>=2.0
+Requires-Dist: textual<1.0,>=0.40
+Requires-Dist: uvicorn[standard]<1.0,>=0.20
+Requires-Dist: websockets<14.0,>=11.0
+Provides-Extra: build
+Requires-Dist: pyinstaller>=6.0; extra == 'build'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Terminus
+
+Multiplayer CLI survival strategy game. Manage your settlement, allocate workers, build structures, and survive catastrophes — all in your terminal.
+
+![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)
+![License: MIT](https://img.shields.io/badge/license-MIT-green)
+
+## Install
+
+### From PyPI (recommended)
+
+```bash
+pip install terminus-game
+```
+
+### From GitHub
+
+```bash
+pip install git+https://github.com/kushal-DL/terminus.git
+```
+
+### From source (development)
+
+```bash
+git clone https://github.com/kushal-DL/terminus.git
+cd terminus
+pip install -e ".[dev]"
+```
+
+### Pre-built executable
+
+Download the latest release for your platform from [GitHub Releases](https://github.com/kushal-DL/terminus/releases) — no Python installation required.
+
+## Prerequisites
+
+- **Python 3.11 or newer** (for pip install methods)
+- **Terminal with Unicode support** (Windows Terminal, iTerm2, most Linux terminals)
+- **cloudflared** (optional — only needed for `--public` mode to share games over the internet)
+
+## Run
+
+```bash
+terminus                # Launch the game (starts server + TUI client)
+terminus --public       # Launch with public URL via cloudflared tunnel
+terminus --server-only  # Run headless server (for dedicated hosting)
+terminus --port 9090    # Use a custom port (default: 8080)
+terminus --verbose      # Enable debug logging
+```
+
+## Quick Start
+
+1. Run `terminus` — select **"Create Game"**
+2. Choose your colony location and specialization
+3. Share the displayed URL with other players (or use `--public` for internet access)
+4. Other players run `terminus` → **"Join Game"** → paste the URL
+5. Host starts the game once all players are ready
+6. **Survive 5 catastrophes** over ~45 minutes. Highest score wins!
+
+## Gameplay
+
+- **Allocate workers** across farming, mining, research, construction, defense, and medicine
+- **Build structures** (farms, walls, hospitals, labs, warehouses, housing) up to level 3
+- **Trade resources** at the market — prices fluctuate each tick
+- **Prepare for catastrophes** — the watchtower gives early warnings
+- **Manage morale** — starvation and damage reduce it; good management boosts production
+
+## Dev Console (Admin Tools)
+
+For debugging and testing, Terminus includes a dev console TUI:
+
+```bash
+# Start the game server first
+terminus --server-only
+
+# In another terminal, launch the dev console
+TERMINUS_DEV_MODE=1 python -m terminus.dev --server http://127.0.0.1:8080
+```
+
+The dev console provides: real-time state inspection, resource overrides, catastrophe controls, and instant building completion.
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest tests/ -v
+
+# Run balance simulator
+python -m tools.balance.simulator --preset standard --games 10
+
+# Run load test
+python tools/load_test.py --players 20 --duration 60
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.

terminus_game-0.1.0/README.md

@@ -0,0 +1,99 @@
+# Terminus
+
+Multiplayer CLI survival strategy game. Manage your settlement, allocate workers, build structures, and survive catastrophes — all in your terminal.
+
+![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)
+![License: MIT](https://img.shields.io/badge/license-MIT-green)
+
+## Install
+
+### From PyPI (recommended)
+
+```bash
+pip install terminus-game
+```
+
+### From GitHub
+
+```bash
+pip install git+https://github.com/kushal-DL/terminus.git
+```
+
+### From source (development)
+
+```bash
+git clone https://github.com/kushal-DL/terminus.git
+cd terminus
+pip install -e ".[dev]"
+```
+
+### Pre-built executable
+
+Download the latest release for your platform from [GitHub Releases](https://github.com/kushal-DL/terminus/releases) — no Python installation required.
+
+## Prerequisites
+
+- **Python 3.11 or newer** (for pip install methods)
+- **Terminal with Unicode support** (Windows Terminal, iTerm2, most Linux terminals)
+- **cloudflared** (optional — only needed for `--public` mode to share games over the internet)
+
+## Run
+
+```bash
+terminus                # Launch the game (starts server + TUI client)
+terminus --public       # Launch with public URL via cloudflared tunnel
+terminus --server-only  # Run headless server (for dedicated hosting)
+terminus --port 9090    # Use a custom port (default: 8080)
+terminus --verbose      # Enable debug logging
+```
+
+## Quick Start
+
+1. Run `terminus` — select **"Create Game"**
+2. Choose your colony location and specialization
+3. Share the displayed URL with other players (or use `--public` for internet access)
+4. Other players run `terminus` → **"Join Game"** → paste the URL
+5. Host starts the game once all players are ready
+6. **Survive 5 catastrophes** over ~45 minutes. Highest score wins!
+
+## Gameplay
+
+- **Allocate workers** across farming, mining, research, construction, defense, and medicine
+- **Build structures** (farms, walls, hospitals, labs, warehouses, housing) up to level 3
+- **Trade resources** at the market — prices fluctuate each tick
+- **Prepare for catastrophes** — the watchtower gives early warnings
+- **Manage morale** — starvation and damage reduce it; good management boosts production
+
+## Dev Console (Admin Tools)
+
+For debugging and testing, Terminus includes a dev console TUI:
+
+```bash
+# Start the game server first
+terminus --server-only
+
+# In another terminal, launch the dev console
+TERMINUS_DEV_MODE=1 python -m terminus.dev --server http://127.0.0.1:8080
+```
+
+The dev console provides: real-time state inspection, resource overrides, catastrophe controls, and instant building completion.
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest tests/ -v
+
+# Run balance simulator
+python -m tools.balance.simulator --preset standard --games 10
+
+# Run load test
+python tools/load_test.py --players 20 --duration 60
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.