spawnio 1.0.5__tar.gz → 1.0.7__tar.gz

{spawnio-1.0.5 → spawnio-1.0.7}/.github/workflows/ci.yml

@@ -1,29 +1,29 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v5
-
-      - name: Set up Python
-        run: uv python install 3.12
-
-      - name: Install dependencies
-        run: uv sync --all-groups
-
-      - name: Run tests
-        run: uv run pytest
-
-      - name: Run ruff
-        run: uv run ruff check .
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --all-groups
+
+      - name: Run tests
+        run: uv run pytest
+
+      - name: Run ruff
+        run: uv run ruff check .

spawnio-1.0.7/.github/workflows/publish.yml

@@ -0,0 +1,24 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # required for trusted publishing
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish

{spawnio-1.0.5 → spawnio-1.0.7}/LICENSE

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

{spawnio-1.0.5 → spawnio-1.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: spawnio
-Version: 1.0.5
+Version: 1.0.7
 Summary: Spawn a ready-to-use Python project in seconds
 License-File: LICENSE
 Requires-Python: >=3.12
@@ -10,12 +10,14 @@ Requires-Dist: typer>=0.26.7
 Description-Content-Type: text/markdown
 
 <div align="center">
-<img src="assets/preview.png" alt="Spawn — scaffold your next project" width="520" />
+<img src="https://raw.githubusercontent.com/Abhiix0/Spawn/main/assets/preview.png" alt="Spawn — scaffold your next project" width="520" />
 
 > Eliminate repetitive project setup. Go from zero to a fully structured dev environment in seconds.
 
 Spawn is a local CLI tool that transforms one command into a complete Python project foundation — directories, Git, dependencies, and a virtual environment set up automatically, so you can start building immediately.
 
+[![PyPI](https://img.shields.io/pypi/v/spawnio?style=flat-square&color=blue)](https://pypi.org/project/spawnio/)
+[![Downloads](https://img.shields.io/pypi/dm/spawnio?style=flat-square&color=brightgreen)](https://pypi.org/project/spawnio/)
 [![Python](https://img.shields.io/badge/Python-3.12+-blue?style=flat-square)](https://python.org)
 [![Tests](https://img.shields.io/badge/Tests-Passing-brightgreen?style=flat-square)](https://github.com/Abhiix0/spawn/actions)
 [![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)](LICENSE)
@@ -92,6 +94,7 @@ It's repetitive. It's inconsistent. And you haven't written a single line of *re
 ## Prerequisites
 
 - **Python 3.12+** — [Download here](https://python.org/downloads)
+  > `pip install spawnio` will silently return "no matching distribution" on Python < 3.12. If you're using uv, run `uv python install 3.12` to get a compatible interpreter in seconds.
 - **uv** — [Install guide](https://github.com/astral-sh/uv)
 - **Git** — [Download here](https://git-scm.com/downloads)
 
@@ -101,6 +104,28 @@ It's repetitive. It's inconsistent. And you haven't written a single line of *re
 
 ## Installation
 
+**Option 1 — Install from PyPI (recommended)**
+
+```bash
+pip install spawnio
+```
+
+or, using `uv`:
+
+```bash
+uv tool install spawnio
+```
+
+or run it without installing:
+
+```bash
+uvx --from spawnio spawn create
+```
+
+You can now run `spawn` from anywhere on your machine.
+
+**Option 2 — Install from source (for contributing)**
+
 ```bash
 git clone https://github.com/Abhiix0/spawn.git
 cd spawn
@@ -108,12 +133,30 @@ uv sync
 uv tool install .
 ```
 
-You can now run `spawn` from anywhere on your machine.
-
 ---
 
 ## Usage
 
+### Quick overview — `spawn` with no arguments
+
+Running `spawn` with no arguments shows the banner, the installed version, and the list of available commands — useful when you just want a reminder of what's available without starting a project flow.
+
+```
+SPAWN — scaffold your next project
+v1.0.6
+
+Commands
+  create    Scaffold a new project
+  doctor    Check the health of a project directory
+  version   Show the installed version
+
+Run spawn COMMAND --help for details on a command.
+```
+
+---
+
+### `spawn create`
+
 ```bash
 spawn create
 ```
@@ -130,7 +173,6 @@ Spawn rejects names with spaces or special characters, and tells you immediately
 
 **Step 2 — Pick a template**
 
-```
 Use the arrow keys to move, Enter to select — the same pattern every prompt in Spawn follows.
 
 ```
@@ -145,7 +187,6 @@ Use the arrow keys to move, Enter to select — the same pattern every prompt in
    MCP Server
    Custom Structure
 ```
-```
 
 **Step 3 — Additional prompts** *(template-dependent — framework, provider, project type, and/or extras, depending on what you picked. See [Project Templates](#project-templates) below for each one's exact flow.)*
 
@@ -565,7 +606,7 @@ Then add it to your MCP client's config — see the generated project's own READ
 
 ## Bring Your Own Structure
 
-None of the eight templates above fit? **Custom Structure** shows up as the last option in the same `spawn create` picker (`9`) — it's not a separate command, just a different path through the same flow.
+None of the eight templates above fit? **Custom Structure** shows up as the last option in the same `spawn create` picker — it's not a separate command, just a different path through the same flow.
 
 Paste any of three text formats — Unix `tree` output, a Markdown list, or plain indented hierarchy — and Spawn parses it, previews the detected folders and files, then creates the structure with the same Git and uv setup as every other template.
 
@@ -704,7 +745,7 @@ Checks span six categories — Documentation, Version Control, Configuration, Te
 
 ```bash
 spawn version
-# → Spawn v1.0.5
+# → Spawn v1.0.7
 ```
 
 ### Publish to GitHub
@@ -734,19 +775,31 @@ All tests should pass. If they don't, please [open an issue](https://github.com/
 
 ## Roadmap
 
-**Recently shipped**
+### Shipped
 
-- Arrow-key menus, no-args banner, and consistent Ctrl+C handling (v1.0.5)
-- AGENTS.md / CLAUDE.md generation — every project ships agent context automatically, `--claude-md` opt-in for Claude Code (v1.0.4)
-- MCP Server intent — official `mcp` SDK, one working tool + resource, stdio transport (v1.0.3)
-- Non-interactive mode — `--name`/`--template`/flags or `--config` JSON, zero prompts (v1.0.2)
-- Custom Structure workflow — paste any folder layout, Spawn creates it (v1.0.0)
-- Doctor 2.0 — per-category health percentages, tiered recommendations, Next Best Step (v1.0.0)
-- Data Project intent — analysis, dashboard, ETL, ML sub-options (v0.9.0)
-- RAG System intent — LlamaIndex + ChromaDB (v0.8.0)
-- AI Agent intent — tool-calling with PydanticAI / OpenAI Agents SDK (v0.7.0)
+| Version | Highlight |
+|---|---|
+| **v1.0.7** | Fixed UTF-8 console crash on Windows when stdout is redirected/piped, added Windows reserved device name validation (`CON`, `PRN`, `AUX`, `NUL`, `COM1`–`9`, `LPT1`–`9`), clarified Python 3.12 requirement |
+| **v1.0.6** | Removed duplicate banner from `spawn create`; `spawn` alone now shows the banner and command overview |
+| **v1.0.5** | Published to PyPI as `spawnio`; arrow-key selection menus, no-args banner, consistent Ctrl+C handling |
+| **v1.0.4** | `AGENTS.md` / `CLAUDE.md` generation for every project, `--claude-md` opt-in |
+| **v1.0.3** | MCP Server intent — official `mcp` SDK, one working tool + resource |
+| **v1.0.2** | Non-interactive mode — `--name`/`--template` flags or `--config` JSON |
+| **v1.0.1** | Custom Structure: dependency install, optional dev tooling setup, smart README/`.gitignore` generation |
+| **v1.0.0** | Custom Structure workflow (paste any folder layout) + Doctor 2.0 (per-category scores, tiered recommendations) |
+| **v0.9.0** | Data Project intent — analysis, dashboard, ETL, ML sub-types |
+| **v0.8.0** | RAG System intent — LlamaIndex + ChromaDB |
+| **v0.7.0** | AI Agent intent — tool-calling with PydanticAI / OpenAI Agents SDK |
+| **v0.6.0** | AI Chatbot intent — 3 frameworks, 6 providers, runtime memory |
+| **v0.5.0** | Automation Tool intent — workflows, logging, working example out of the box |
+| **v0.4.0** | CLI Application intent — Typer/Click/Argparse, Utility/Interactive types |
+| **v0.3.0** | Backend API intent — FastAPI/Flask/Django, extras system, `.spawn/meta.json` |
+| **v0.2.0** | GitHub publishing from the CLI, `spawn doctor` health checker, CI workflow |
+| **v0.1.0** | Initial release — `spawn create`, 4 templates, Git + uv integration |
+
+---
 
-**What's next**
+## What's next
 
 Nothing formally scheduled yet. Ideas under consideration live in [Issues](https://github.com/Abhiix0/spawn/issues); open one if there's something you'd want to see.
 
@@ -793,6 +846,6 @@ This project is open source under the [MIT License](LICENSE).
 
 <div align="center">
 
-**[Star on GitHub](https://github.com/Abhiix0/spawn)** · **[Report a Bug](https://github.com/Abhiix0/spawn/issues)** · **[Request a Feature](https://github.com/Abhiix0/spawn/issues)**
+**[ Star on GitHub](https://github.com/Abhiix0/spawn)**  ·  **[ report a bug](https://github.com/Abhiix0/spawn/issues)**  ·  **[ request a Feature](https://github.com/Abhiix0/spawn/issues)**  ·  **[ PyPI](https://pypi.org/project/spawnio/)**
 
-</div>
+</div>