/psp

PSP (Python Scaffolding Projects)

Primary LanguageRustApache License 2.0Apache-2.0

psp (Python Scaffolding Projects)

psp is a blazing fast command line utility to scaffold your Python project, written in Rust.

  • ⚡️ 10-100x faster
  • 🛠️ pyproject.toml support
  • 🤝 Python 3.13 compatibility
  • 📦 Unit-test and pytest supports
  • 🔧 Automatically dependencies installation
  • 📏 tox configuration supports and other remotes CI
  • ⌨️ MkDocs and Sphinx documentation supports
  • 🌎 Github and Gitlab remote repository supports

psp

Note

This project is WIP: beta

The result is:

$> tree test/ --filelimit=10 -a
test                    # Project folder
├── LICENSE.md          # License file
├── pyproject.toml      # Python package configuration file
├── README.md           # Readme file
├── CHANGES.md          # List of changes
├── .circleci           # CI folder
│   └── config.yml      # CI configuration file
├── CODE_OF_CONDUCT.md  # Code of Conduct
├── CONTRIBUTING.md     # Contributing guide lines
├── docs                # Documentation folder: Sphinx/MKDocs
│   ├── build
│   ├── make.bat
│   ├── Makefile
│   └── source
│       ├── conf.py
│       ├── index.rst
│       ├── _static
│       └── _templates
├── .git                # Git folder
│   ├── branches
│   ├── config
│   ├── description
│   ├── HEAD
│   ├── hooks  [14 entries exceeds filelimit, not opening dir]
│   ├── info
│   │   └── exclude
│   ├── objects
│   │   ├── info
│   │   └── pack
│   └── refs
│       ├── heads
│       └── tags
├── .github             # Github issue and merge templates
│   ├── ISSUE_TEMPLATE
│   │   ├── bug.yml
│   │   ├── config.yml
│   │   └── feature.yml
│   └── PULL_REQUEST_TEMPLATE
│       └── pull_request_template.md
├── .gitignore          # Git ignore file
├── test                # Python package
│   └── __init__.py
├── tests               # Tests package for modules
│   ├── __init__.py
│   └── test_test.py    # Test module "test_<name_python_package>"
├── tox.ini             # Tox configuration files
└── venv                # Virtual environment
    ├── bin  [33 entries exceeds filelimit, not opening dir]
    ├── include
    │   └── python3.12
    ├── lib
    │   └── python3.12
    │       └── site-packages  [68 entries exceeds filelimit, not opening dir]
    ├── lib64 -> lib
    └── pyvenv.cfg

30 directories, 39 files

And git status is:

$> git status
On branch main

No commits yet
...
$> git remote get-url origin
git@github.com:MatteoGuadrini/test.git

Prerequisites

psp has four prerequisetes installed on own machine:

  • git
  • python3
  • pip
  • curl

Ubuntu prerequisites installation

sudo apt install -y python3 python3-pip git curl

Red Hat prerequisites installation

sudo dnf install -y python3 python3-pip git curl

Arch prerequisites installation

sudo pacman -Qi python3 python3-pip git curl

Installation

To install compiled file into your machine, download it:

Linux

For all users:

sudo -i
curl -L https://github.com/MatteoGuadrini/psp/releases/download/v0.0.9/psp_linux > /usr/bin/psp
chmod +x /usr/bin/psp

For current user:

curl -L https://github.com/MatteoGuadrini/psp/releases/download/v0.0.9/psp_linux > $HOME/.local/bin/psp
chmod +x $HOME/.local/bin/psp

MacOS

sudo su -
curl -L https://github.com/MatteoGuadrini/psp/releases/download/v0.0.9/psp_macos > /usr/bin/psp
chmod +x /usr/bin/psp

Packages

For Debian/Ubuntu:

curl -L https://github.com/MatteoGuadrini/psp/releases/download/v0.0.9/psp.deb
sudo dpkg -i psp.deb

For Fedora/Mageia/OpenSuse:

sudo rpm -i https://github.com/MatteoGuadrini/psp/releases/download/v0.0.9/psp.rpm

Compile as your own

Instead, if you compile this project as own, follow this steps:

git clone https://github.com/MatteoGuadrini/psp.git
cd psp && cargo build --release && sudo cp -var target/release/psp /usr/bin/psp

Features

  • Scaffolding file and folder structures for your Python project
  • Prepare git and gitignore
  • Prepare unit test files (also with pytest)
  • Prepare virtual environment
  • Install dependencies
  • Prepare pyproject.toml
  • Prepare CI configuration files
  • Prepare Github/Gitlab files
  • Prepare tox environment
  • Prepare docs folder for sphinx/mkdocs documentation
  • Prepare README, LICENSE, CONTRIBUTING, CODE_OF_CONDUCT and CHANGES files
  • Add build and deploy dependencies to distribute package
  • Add Dockerfile for your project
  • Add quick, simple and full argument for rapid configuration

Open source

psp is an open source project. Any contribute, It's welcome.

A great thanks.

For donations, press this

For me

paypal

For Telethon

The Telethon Foundation is a non-profit organization recognized by the Ministry of University and Scientific and Technological Research. They were born in 1990 to respond to the appeal of patients suffering from rare diseases. Come today, we are organized to dare to listen to them and answers, every day of the year.

Adopt the future

Treeware

This package is Treeware. If you use it in production, then we ask that you buy the world a tree to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.

Treeware

Acknowledgments

Thanks to Jim Blandy, Jason Orendorff and Nora Tindall for writing the Programming Rust book that make up my Rust foundation.

Thanks to Tim McNamara for writing the Rust in Action book.

Thanks to Zed IDE and for license of RustRover offered by Jetbrains.

Special thanks go to my wife, who understood the hours of absence for this development. Thanks to my children, for the daily inspiration they give me and to make me realize, that life must be simple.

Thanks, Rust Community!