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 Devlopment Stage: Early Beta 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.tar.gz (21.1 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-py3-none-any.whl (22.7 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for cerbose-2.0.0.tar.gz
Algorithm Hash digest
SHA256 7f34704255e121c43205054344bb72693d111eac027c52b9702c2a243bb47c22
MD5 71e2a21d6fb1beb14a7b4b6f481c10b3
BLAKE2b-256 aa37894d2271add74ba15130ad00575d1e4112e1d52cae2b80ec946e023a06b4

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for cerbose-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 29fc48f6850c20ace9b1cd34af46720bf0240d2b457a958df010f3511a3e96b2
MD5 cce2b76f830b184974b61285303ff9d1
BLAKE2b-256 0e78c152253a0c7282398cf3c8e98815957dc2ddcc0bdff895c0e85a912cc841

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