It looks good and delegates all the real work to you ;)
A minimal and ridiculously good looking command-line-interface toolkit.
In four points:
- Completely customizable help page, but pretty by default.
- Add new commands at any time and from other files.
- No sub-commands but grouping of commands instead.
- Easy to use and understand.
An example
This autogenerated (and completely customizable) help message comes from running the example below:
# example.py
from pyceo import Manager, param, option
cli = Manager("Welcome to Proper v1.2.3")
@cli.command(help="Creates a new Proper application at `path`.")
@param("path", help="Where to create the new application.")
@option("quiet", help="Supress all output.")
def new(path):
"""The `proper new` command creates a new Proper application with a default
directory structure and configuration at the path you specify.
Example: `proper new ~/Code/blog`
This generates a skeletal Proper application at `~/Code/blog`.
"""
pass
@cli.command()
@option("num", type=int) # Optional type
def fizzbuzz(num=3):
"""A bad fizz buzz."""
print("fizz " * num + "buzz")
@cli.command(group="db")
@option("message", help="Revision message")
@option("sql", help="Dont emit SQL to database - dump to standard output instead")
@option("head", help="Specify head or <branchname>@head to base new revision on")
def migrate(**kwargs):
"""Autogenerate a new revision file.
This is an alias for "revision --autogenerate"."""
pass
@cli.command(group="db")
@option("name", help="Name of section in .ini file to use for Alembic config")
def branches(**kwargs):
"""Show current branch points.
"""
pass
if __name__ == "__main__":
# cli.run(default="new")
cli.run()
How minimal?
pyceo doesn't include any related features like prompts, progress bars, table formatting, file editing, etc. It doesn't matter because for those features many dedicated python libraries can be used.
You could say it focuses on its core competencies while synergetically interface with other libraries to take it to the next level. 💪🚀
Why don't just use optparse or argparse?
Are you kidding? Because this is way easier to use and understand.
Why don't just use click?
Because this looks better and is easier to use and understand.
Why don't just use...?
Because this library fits better my mental model. I hope it matches yours as well.
1 maintainer
Metadata
1 maintainer
Release files for pyceo 2.200204
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pyceo-2.200204.tar.gz | 10.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pyceo-2.200204-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 23.1 kB
Release files / pyceo-2.200204.tar.gz
| Download URL | pyceo-2.200204.tar.gz |
|---|---|
| Size | 10.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3d6b970d1070d6959382faa0ed4c12643df4b5fdf2e1fad7124d36d2c9e5e971
|
|
BLAKE2b-256 checksum How to use checksums |
4ca9ac516bee1e10cf5b9d26ef9d31f33adbff9bcbc58dfe337aa39c12c0549a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.7.5
|
Release files / pyceo-2.200204-py3-none-any.whl
| Download URL | pyceo-2.200204-py3-none-any.whl |
|---|---|
| Size | 12.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9e6acb4d4fafec5a9cd3969d389c055f4968ebcc1667402ef84fa0c1de00669f
|
|
BLAKE2b-256 checksum How to use checksums |
7f51413903e1a153849015663bff30acb967dfd4f2a532b4d20358c4af02846b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.7.5
|
