Skip to content

Spawn v1.0.9

Choose a tag to compare

@Abhiix0 Abhiix0 released this 09 Oct 08:36
· 51 commits to main since this release
99fdeac

Spawn v1.0.9 — Core Hardening

A reliability release. Project generation is now safer, errors are predictable, and the internals are cleaner for what comes next. Generated output for default options is unchanged from v1.0.8.

Behavior changes

  • Failures now exit non-zero. Generation, git/uv and GitHub-publish failures used to print an error and exit 0. They now exit with a stable code (see the table below), so scripts and CI can trust the result.
  • --no-uv is now honored for template projects. It previously still ran uv. Without uv, Spawn skips uv init, dependency installs and extras that need pyproject.toml (Dockerfile, CI workflow, ruff/pytest/mypy config). It prints one line listing what was skipped. File-only extras such as pre-commit are still written.
  • Interactive spawn create --dry-run now validates and prints the config without creating anything. It previously created the project.

Security

  • Custom-structure paths that escape the project directory (../, absolute paths, backslashes, drive letters) are rejected.
  • Failure cleanup only removes directories created by the current run.
  • Git and GitHub error output no longer includes URL credentials.

Added

  • ProjectConfig.destination and to_dict(), plus plan_project and generate_project as the single plan and generate entry points.
  • read_project_metadata(): read-only access to .spawn/meta.json. The metadata is historical, not proof of current repo state.
  • A typed error hierarchy and documented exit codes.
  • SPAWN_DEBUG=1 to get a full traceback for unexpected errors.
  • SECURITY.md, golden-tree fixtures for every template, and expanded CI (Python 3.12/3.13, wheel smoke test).
  • --config with an explicit --no-git/--no-uv now warns that the config file takes precedence.

Exit codes

Code Meaning
0 Success (including a valid --dry-run)
1 Invalid input or config
2 CLI usage error
3 Filesystem error (e.g. directory exists)
4 Toolchain error (git/uv missing or failed)
5 Generation / template error
6 GitHub publish error
10 Unexpected error
130 Cancelled

Upgrade

pip install --upgrade spawnio

If you script spawn create, check how it handles non-zero exits, since failures that used to exit 0 now don't.

Full changelog: https://github.com/Abhiix0/Spawn/blob/main/docs/changelog.md