Saturn Library

Saturn Library is a Python development toolkit and CLI designed to simplify common development workflows.

It provides a command-line interface through the sr command.

Installation

Install Saturn Library from PyPI:

pip install saturn-library

After installation:

sr --help

Commands

The current CLI structure is:

sr
├── server
│   ├── run
│   ├── kill
│   └── kill-all
└── cache
    └── clear

Server

Run a server

Start an ASGI development server using Uvicorn:

sr server run

By default, Saturn uses:

Application: app:app
Host:        127.0.0.1
Port:        8000
Reload:      enabled

You can customize the ASGI application:

sr server run --app main:app

Change the port:

sr server run --port 8001

Change the host:

sr server run --host 0.0.0.0

Or combine the options:

sr server run --app main:app --host 0.0.0.0 --port 8001

Stop Saturn servers

Stop development servers started and tracked by Saturn:

sr server kill

Stop detected development servers

Stop development server processes detected by Saturn:

sr server kill-all

This command is more aggressive than sr server kill and may terminate development servers that were not started through Saturn.

Cache

Clear Python cache files and __pycache__ directories from the current project:

sr cache clear

Development

Clone the repository:

git clone https://github.com/Samuel19012002/Saturno-Library.git
cd Saturno-Library

Create a virtual environment:

python3 -m venv venv

Activate it on macOS or Linux:

source venv/bin/activate

Install Saturn in editable mode:

python3 -m pip install -e .

Then test the CLI:

sr --help

Status

Saturn Library is under active development. Additional developer tooling, cloud integrations, and AI-related capabilities may be added in future releases.