Create a command line interface with minimal setup.

Command line interface (Cli) with a schema (Ma) - Clima

Installation

pip install clima

Requires Python 3.9.2+.

Quick example

from clima import Schema

class S(Schema):
    place = 'Finland'

@S.cli
class Cli:
    def say_hi(self):
        print(f'Hi from {S.place}')

$ cli.py say_hi
Hi from Finland
$ cli.py say_hi --place 'Sweden'
Hi from Sweden

Why Clima?

Clima eliminates CLI boilerplate: just define a Schema dataclass and a Cli class. Opinionated for convenience; Unlike click, typer, or argparse, clima gives you a built-in config cascade (CLI args → env vars → .env file → config file → defaults) with zero extra code.

Features

Schema fields double as CLI flags, environment variables, and config file keys automatically while providing help printout, default values and type casting.

Config cascade :: CLI args → env vars → .env file → config file → defaults, resolved automatically
Type casting :: Schema field annotations are used to cast string CLI/env values to the right type
Help from field comments :: Docstrings on Schema fields act as --help output
IDE completions :: C.name is typed as str — completions and type checking work natively
--verbose / --quiet logging :: Add verbose: bool or quiet: bool to Schema and get preconfigured logging
Undefined param warnings :: Unknown --flags on the command line produce a clear warning
version subcommand :: myscript version prints the package version automatically
Config file support :: Declare defaults in an INI-style .conf file keyed to your package name
.env file and env var support :: Schema fields are also read from environment variables and .env files
Optional gpg secrets :: Decrypt secrets via pass / gnupg if installed
Optional shortened tracebacks :: Truncate python tracebacks into an opinionated format

Documentation

Full documentation at python-clima.readthedocs.io.

See and run the examples/ directory for more usage patterns.

AI Disclaimer

This work started in 2019 as my hobby project and continues as so. Claude was used to bridge gaps I had planned, but had not had the time to address.

Before merging to main and uploading to pypi the code is hand-vetted to find all code assistance related issues.

Contributions ratios

Metadata

Release files for clima 0.13.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for clima 0.13.8
File	Size	Uploaded	Provenance
clima-0.13.8.tar.gz	38.0 kB	May 6, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for clima 0.13.8
File	Interpreter	ABI	Platform	Reset
clima-0.13.8-py3-none-any.whl 48.4 kB May 6, 2026 Without provenance	Python 3	none	any	Details

Total release size: 86.4 kB

Release files / clima-0.13.8.tar.gz

Download URL	clima-0.13.8.tar.gz
Size	38.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`5a438d6aa59f70888122bdf131af011c053d22c827fc144cede678686c27de5a`
BLAKE2b-256 checksum How to use checksums	`79602fb36b24f2ca05c072bd33b4b1563ad9c0ec00aa3f0d46e96aeb65930e00`
Upload date	May 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.4.0 CPython/3.12.9 Darwin/24.6.0`

Release files / clima-0.13.8-py3-none-any.whl

Download URL	clima-0.13.8-py3-none-any.whl
Size	48.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`e176ec076fedf2864ca004c981d32ff8f590b069b910f3a3df56c543af3224d2`
BLAKE2b-256 checksum How to use checksums	`dc908df3f1a09a8dcae1a5a4c873e0bfb5b2705a786b3cbf88554dc1b5dbde09`
Upload date	May 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.4.0 CPython/3.12.9 Darwin/24.6.0`

Security for clima 0.13.8

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.