Skip to main content

A simple Python library for making colourful, tagged terminal output, along with additional console features.

Project description

Cerbose Logo

Language: Python Version: 2.0.0.post1 License: LGPLv3 License: MIT
Cerbose is a simple, cross-platform Python library, mainly for making tagged, colourful console output along with additional features.
Website | PyPI | jasperredis
Made by jasperredis [o]:

It is highly reccomended to check the website.


Test Preview Image

This wasn't done in a codeblock because they can't display colours.

  • For contributing, see CONTRIBUTING.md on the GitHub repo.
  • For the changelog, see CHANGELOG.md on the GitHub repo.

Functions

cprint

This is the highlight function of Cerbose. It outputs highly configurable tagged text to the console, and you can configure the following:

  • Tag (obviously)
  • Text (obviously)
  • Logging (enabled, file, and optional feedback)
  • Text colour
  • Dual tags
  • Timestamp (enabled?)
  • And more through configuration.

It also has a "as_string" mode where it returns the suppposed output instead of printing it.
More info in the documentation.

mprint

The same as cprint, except it has multiline support.

cerbar

Returns an ASCII progress bar. You can configure the following:

  • Length in characters
  • Value being represented (obviously) in regular integers, not percentages.
  • Optionally add the percentage represented be before/after the progress bar.
  • Optionally add the amount represented (fill/total) before/after the progress bar.
  • And more through configuration files.

More info in the documentation.

cquery

Takes user input and returns the input. You can configure the following:

  • Prompt (obviously)
  • All options for cprint in the prompt.
  • 'i' and 'o' mode. 'i' allows any text input (remember to set options to 'any'!), and 'o' has a strict set of options.
  • Recieving user input as lowercase (enabled?)

More info in the documentation.

Configuration

Cerbose can be more highly configured via config variables/functions. As always, the documentation has the best information on this, but here is roughly what you can configure with these:

  • Tag colours
  • Tag text
  • Symbols (brackets, cerbar contents, etc.)
  • Timestamp format
  • Space repeat tolerance (check documentation)

Licensing

Always, for more information related to licenses in Cerbose, check the LICENSE file in the project root and the files it refers to.

  • Cerbose, the Python script itself, is licensed under the GNU Lesser General Public License v3.0 or later. What constitutes as the script itself is any file in the src/ directory of this repository.
    • See the LICENSE-LGPL file for more info.
    • The LGPLv3 is an extension of the GNU General Public License v3. See the LICENSE-GPL file for more info.
  • All other files (e.g., docs, examples), with reasonable exception of license-related files are under the MIT License.

REMINDER: The best source of licensing information in Cerbose (and most other projects you will encounter) is the LICENSE file at the project root.

Primarily made by:

jasperredis

Project details


Download files

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

Source Distribution

cerbose-2.0.0.post1.tar.gz (21.0 kB view details)

Uploaded Source

Built Distribution

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

cerbose-2.0.0.post1-py3-none-any.whl (22.8 kB view details)

Uploaded Python 3

File details

Details for the file cerbose-2.0.0.post1.tar.gz.

File metadata

  • Download URL: cerbose-2.0.0.post1.tar.gz
  • Upload date:
  • Size: 21.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.5

File hashes

Hashes for cerbose-2.0.0.post1.tar.gz
Algorithm Hash digest
SHA256 0df09f33dc277427416b446f5d037596c9465a05707acd0bd2c2364dcb78fc74
MD5 587bd4df702420d6022593b6e44b16e7
BLAKE2b-256 fb15a770ac3903a22d6c558508b8eec86db472a581ce030d0b6f1741b1350bf2

See more details on using hashes here.

File details

Details for the file cerbose-2.0.0.post1-py3-none-any.whl.

File metadata

  • Download URL: cerbose-2.0.0.post1-py3-none-any.whl
  • Upload date:
  • Size: 22.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.5

File hashes

Hashes for cerbose-2.0.0.post1-py3-none-any.whl
Algorithm Hash digest
SHA256 ddc6f8ba60b1bc050051dd4c248e191e73939a3f66e127970854400b27ca12b1
MD5 96f61985b86f9ae50fc95fba6369d0dd
BLAKE2b-256 77e7c217afec04485138fbd65073552d8617244def94de30ea6da22c6aec7248

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