makeapp
makeapp scaffolds Python projects and provides one CLI for their common development tasks. It can create a project
from composable templates, initialize Git and a virtual environment, run a GitHub Actions test matrix locally, maintain
a changelog, and publish releases.
Install
Python 3.11 or newer and uv are required.
uv tool install makeapp
Both makeapp and its short alias ma invoke the same command.
Quick start
ma new shiny_app ./shiny-app --description "My app" --author "I am" --no-prompt
cd shiny-app
ma tests
The default scaffold contains a src-layout package, tests, project metadata, a changelog, and MkDocs documentation.
The non-interactive command also initializes Git and runs uv sync to create .venv.
Bundled templates can extend the default scaffold:
consolefor anargparsecommand-line application;clickfor a Click command-line application;djangofor a reusable Django application;pytestpluginfor a pytest plugin;webscafffor a Linux-hosted Django/Webscaff project.
For example:
ma new shiny_cli ./shiny-cli -t click --no-prompt
Project workflow
ma up # Synchronize the development environment.
ma style # Run Ruff checks and apply safe fixes.
ma tests # Run the configured test matrix.
ma docs --build # Build documentation without starting a server.
ma change "+ Add a feature" # Update the changelog and commit modified files.
ma release # Prepare a release and optionally publish it.
Review changes before running ma change: it stages and commits modified tracked files together with the changelog.
Documentation
The full user and extension documentation is available at https://makeapp.readthedocs.io/.
- Quickstart
- CLI reference
- Template authoring
- Publishing Issues and feature requests are welcome in the GitHub issue tracker.
1 maintainer
Metadata
1 maintainer
Release files for makeapp 2.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| makeapp-2.4.0.tar.gz | 54.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| makeapp-2.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 137.7 kB
Release files / makeapp-2.4.0.tar.gz
| Download URL | makeapp-2.4.0.tar.gz |
|---|---|
| Size | 54.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2fbb05d9427cc637d7d316dec965758f3f52f4725fc29075bbd9a14edf3f431e
|
|
BLAKE2b-256 checksum How to use checksums |
f39352e3cd5bed88dc4aa0ef668d465094b783068a32174ba9ba576a9b9f179f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / makeapp-2.4.0-py3-none-any.whl
| Download URL | makeapp-2.4.0-py3-none-any.whl |
|---|---|
| Size | 83.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
174a920143c1a2496b7917ee7071afedb72e2fb251e6d0794e4c5415af640192
|
|
BLAKE2b-256 checksum How to use checksums |
f02da557037a44de7297acc016aa9568f9cb84670c48b00216854a2511afa0b7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
