🚀 pyshipit

Publish Python packages to PyPI without the pain. One CLI for init, build, bump, check, and publish.

🤔 Why pyshipit?

Publishing a Python package today means juggling pyproject.toml syntax, build, twine, version bumps, and remembering to clean dist/ every time. One typo and you get a cryptic 403 from PyPI.

pyshipit wraps the whole workflow into five simple commands.

pyshipit init      # interactively create pyproject.toml
pyshipit check      # verify your project is ready to publish
pyshipit build      # clean + build wheel and sdist
pyshipit bump patch  # 1.0.0 → 1.0.1
pyshipit publish     # upload to PyPI with helpful error messages

📦 Installation

pip install pyshipit

🚀 Quick Start

mkdir my-new-package && cd my-new-package
pyshipit init
# answers a few questions, writes pyproject.toml + README.md

pyshipit check
# ✅ pyproject.toml found
# ✅ Version found: 0.1.0
# ⚠️  No LICENSE file found

pyshipit build
# ✅ Build complete! 2 files in dist/

pyshipit publish
# uploads dist/* to PyPI, with __token__ guidance built in

📖 Commands

pyshipit init

Interactively generates a complete pyproject.toml — asks for name, version, description, author, license, dependencies, keywords, and whether it's a CLI tool (adds an entry point automatically).

pyshipit check

Runs a pre-publish checklist:

• pyproject.toml exists and has a valid version
• README.md / LICENSE present
• Package folder has __init__.py with real content
• build and twine are installed

🔍 pyshipit check

  ✅ pyproject.toml found
  ✅ Version found: 0.1.0
  ✅ README.md found (842 bytes)
  ⚠️  No LICENSE file found
     → Add a LICENSE file (MIT is common)
  ✅ Package folder(s) found: mypackage
  ✅ mypackage/__init__.py has content
  ⚠️  No dist/ folder found
     → Run 'pyshipit build' to build first
  ✅ 'build' is installed
  ✅ 'twine' is installed

  Results: 6 passed  |  2 warnings  |  0 failed

✨ Ready to publish (with minor warnings). Run 'pyshipit publish'.

pyshipit build

Cleans old dist/, build/, and *.egg-info folders, then runs python -m build, and lists the resulting files with sizes.

pyshipit bump <major|minor|patch>

Bumps the version in pyproject.toml using semantic versioning rules.

pyshipit bump patch   # 1.2.3 → 1.2.4
pyshipit bump minor   # 1.2.3 → 1.3.0
pyshipit bump major   # 1.2.3 → 2.0.0

pyshipit publish

Runs twine upload dist/*, but first shows exactly what will be uploaded, reminds you to use __token__ as the username, and on failure prints the most common fixes (name taken, bad token, version already exists).

🆚 pyshipit vs the manual way

🧪 Running Tests

pip install pytest
pytest tests/ -v

📄 License

MIT — free to use in personal and commercial projects.

🤝 Contributing

Pull requests welcome! Open an issue first to discuss any large changes.

1. Fork the repo
2. Create a branch: git checkout -b feature/my-feature
3. Make your changes + add tests
4. Open a Pull Request