psp (Python Scaffolding Projects)
Hey everyone! 👋
I've been working on psp (Python Scaffolding Projects), a blazing fast, open source command line utility to scaffold your Python project. Thought I'd share it with the community!
What is PSP?
psp is simple, fast, effective, declarative, and supports Python and the entire ecosystem of tools written for it. Rather than replacing it, psp seeks to integrate and provide a useful scaffold for the end user.
psp asks only what you need. By configuring a few environment variables, you can automate any project; in seconds, not hours.
Why PSP?
⚡️ 1-100x faster compared to other scaffolding tools
🛠️ pyproject.toml support
🤝 Python 3.14 compatibility
🗃 Scaffolding file and folder structures for your Python project
🗂️ Unit-test and pytest support
🧪 Create a virtual environment
🔧 Automagically dependencies installation
🪛 Add build and deploy dependencies to distribute the package
📏 tox configuration supports and remotes CI like CircleCI, TravisCI, Gitlab CI/CD and Github actions
⌨️ MkDocs and Sphinx documentation support
🧰 Initialize git repository and gitignore file
🌎 GitHub and Gitlab remote repository support
📑 Create README, LICENSE, CONTRIBUTING, CODE_OF_CONDUCT and CHANGES files
🐳 Create Dockerfile and Containerfile for your project
💡 Can use quick, simple and full argument for rapid configuration
💾 Create $HOME/.psp.env and $PWD/.env files with your customizations
🎛️ Can use some PSP_ variables to control your defaults
📦 Support pip, conda and uv package manager
🧮 Support hatch, maturin and poetry builder
🍿 Stop, pause and resume project creation when you want; see Update
Community-friendly — Actively developed and open to contributions
Get started:
Repository: https://github.com/MatteoGuadrini/psp
Documentation: https://psp.readthedocs.io/
Check out the docs and examples to dive in
I'm actively maintaining this and welcome feedback, bug reports, and contributions from the community.
Whether you're interested in systems programming, DevOps tooling, or just exploring what's possible with Python, I'd love to hear your thoughts!
Happy coding and projects creation! 🐍