Skip to main content

Create/autocomplete/format a python project and upload it to PyPI.

Project description

Overview

Create/autocomplete/format a python project and upload it to PyPI.

Installation

To install petrus, you can use pip. Open your terminal and run:

pip install petrus

Usage

The petrus package provides the functions main and run. main provides the CLI. To familiarize us with petrus it may be a good starting point to use the help option of main:

# bash
python3 -m petrus -h

or

# python
import petrus
petrus.main(["-h"])

The arguments of main can also be used analogously on the function run (except for the flags -h and -V).

# The following lines are all identical:
petrus.main(["--author", "John Doe", "path/to/project"])
petrus.main(["--author=John Doe", "path/to/project"])
petrus.main(["--author", "John Doe", "--", "path/to/project"])
petrus.run("path/to/project", author="John Doe")
petrus.run(author="John Doe", path="path/to/project")
petrus.run("path/to/project", author="John Doe", email=None)

If an option is not used (i.e. given the value None) it defaults to the value provided in the default table in the included file config.toml (if existent).

[default]
author = "Johannes"
description = ""
email = "johannes-programming@mailfence.com"
github = "johannes-programming"
requires_python = "{preset} \\| {current}"
v = "bump(2, 1)"
year = "{current}"

[general]
root = ""

If that fails the arguments default to the empty string. The empty string itself usually results in skipping whatever steps required the information. The general.root setting allows to change directory even before path is applied. It is recommended to create a config.toml file inside the petrus package before usage.

License

This project is licensed under the MIT License.

Credits

Thank you for using petrus!

Project details


Release history Release notifications | RSS feed

This version

0.7.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

petrus-0.7.0.tar.gz (16.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

petrus-0.7.0-py3-none-any.whl (21.4 kB view details)

Uploaded Python 3

File details

Details for the file petrus-0.7.0.tar.gz.

File metadata

  • Download URL: petrus-0.7.0.tar.gz
  • Upload date:
  • Size: 16.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for petrus-0.7.0.tar.gz
Algorithm Hash digest
SHA256 e248a2f000963020993e279256df27e21a9684d46acfed93dfd0dd2ee279342f
MD5 018d6aaae8e720560507a27e74ee3bb5
BLAKE2b-256 71a4d714cb498db19852e95fb46d326b96f3597211df3af4c671cf05b6c35a78

See more details on using hashes here.

File details

Details for the file petrus-0.7.0-py3-none-any.whl.

File metadata

  • Download URL: petrus-0.7.0-py3-none-any.whl
  • Upload date:
  • Size: 21.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for petrus-0.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7b1cfc328b1b0c08e2101301f8828ce2d255766c22e28e5b87d605d3027a771b
MD5 c85f92f96d929bdde06f7ca1f9c3ab5e
BLAKE2b-256 ac47b3873878cd18645c8bc292c311f9cc9d0836e0f349d77e1f323c98f36fc2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page