One policy, one catalog, three commands — plus refactor.
Linters, formatters, scanners, metric gates, and structural Python rules —
without hand-rolled CI glue.
Documentation · Usage guide · Changelog · Contributing
You start a Python project and quickly realize you need a pile of tools — linters, formatters, type checkers, secret scanners — each with its own config, install story, and CI glue. Before you write much code, you are maintaining a toolchain.
ShipGate replaces that sprawl with one project policy file and a metadata-driven catalog. Pick a suite once; run the same three commands locally, in CI, and in pre-commit. The wheel also ships refactor — AST rules for structural cleanup alongside catalog gates.
Quick start
Requires Python 3.11–3.14 (prefer 3.13 for the full suite). On 3.14, Semgrep
and deadcode skip with an explicit requires_python message instead of crashing.
pip install shipgate # or: uv add --dev shipgate
shipgate init # scaffold .shipgate/ policy + configs
shipgate install # install tools for your suite
shipgate format --target . # apply formatters
shipgate check --target . # report-only quality gates
shipgate refactor check . # structural Python rules (JSON hits)
Optional: pip install 'shipgate[server]' then shipgate serve --open for
the report UI. See Refactor
for fix, list, explain, and optional rule packs.
Documentation
This README is the shortest path to a working project. For suites, policy, error formats, CI, gates, and the full tool catalog, use the documentation site.
| Guide | Contents |
|---|---|
| Usage | Commands, suites, error formats, CI, pre-commit |
| Refactor | Structural Python rules (check, fix, list, explain) |
| Configuration | Policy files, scopes, Radon metric gates |
| Tools | Bundled catalog and project extensions |
| Architecture | Layers and design decisions |
| Check flow | Tool YAML → shipgate check |
Contributing
See CONTRIBUTING.md. Maintainer notes live locally in
AGENTS.md (not committed).
License
MIT — see LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file shipgate-0.1.8.tar.gz.
File metadata
- Download URL: shipgate-0.1.8.tar.gz
- Upload date:
- Size: 235.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
24938cce910db827a9573d8bb8d7bb61b76b99a3877a5830a42c22f8c0f49b05
|
|
| MD5 |
bc34608e8c734bf3f0b5007c4cd291cf
|
|
| BLAKE2b-256 |
de0c37c360001cd051915e45a647642121c2f55191ffac367fd942174da5749e
|
File details
Details for the file shipgate-0.1.8-py3-none-any.whl.
File metadata
- Download URL: shipgate-0.1.8-py3-none-any.whl
- Upload date:
- Size: 432.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
68bc97342f3a5ab223a57c4fdbb2c3ef3b3301c304972f9087dae5f97891d166
|
|
| MD5 |
b287d1824707a7dc734456a6cc9eba50
|
|
| BLAKE2b-256 |
21848c34a67b5cee86bbb2c75ba32badfb8625cdfeeca4b0750eb11c38069037
|
