glampy 0.2.12

Make your python CLI prints and logs simple but glamorous

glampy

This project intends to allow building useful, reliable and beautiful python CLIs with ease.

Installation

Stable release version:

pip install glampy

Latest development version:

pip install git+https://github.com/snaeil/glampy

Usage

Logging

The customized logger can be used in it's default optionated way or can be customized.
It is fully compatible with the standard python logging module.

from glampy.logging import Logger

# Example using the Logger class to log to stdout and a file:
logger = Logger("my_logger", log_file="my_log.log", log_level=logging.DEBUG)
logger.debug("This is a debug message that will be logged to stdout and the file.")

# Example using the Logger class to log to a file only:
logger = Logger("my_logger", console_handler=None, log_level=logging.DEBUG)
logger.debug("This is a debug message that will be logged to a file only.")

# Example using the Logger class to log to stdout only:
logger = Logger("my_logger", log_level=logging.WARNING)
logger.warning("This is a warning message that will be logged to stdout only.")
logger.info("This is an info message that will not be logged.")

Style

The style module provides a simple way to style text in the terminal.
See the source code for all available styles.

from glampy.style import Style, Sign, Foreground_Colour, Background_Colour

# Example using the Style class to style text:
print(f"{Sign.WARNING} The word {Style.bold}bold{Style.RESET_ALL} is not {style.italic}italic{Style.RESET_ALL}.")

Contributing

Contributions are welcome! For feature requests, bug reports or questions, please open an issue. For code contributions, please open a pull request.

The development environment can be set up using nix and devenv:

1. Install nix package manager: bash <(curl -L https://nixos.org/nix/install) --no-daemon
2. Make sure, your ~/.config/nix/nix.conf contains the following lines:

   experimental-features = nix-command flakes
   

3. Install devenv by running:

   nix profile install --accept-flake-config 'nixpkgs#devenv'
   

4. Install nix-direnv by running:

   nix profile install 'nixpkgs#nix-direnv'
   

   Then add nix-direnv to $HOME/.config/direnv/direnvrc:

   source $HOME/.nix-profile/share/nix-direnv/direnvrc
   

5. Hook direnv into your shell by adding a line to your shell's configuration file (e.g. ~/.bashrc), as described in the direnv documentation:
6. You might have to open a new shell to make the changes take effect.