Skip to main content

A library containing commonly used emojis for terminal messages

Project description

Charminal (Charm Terminal)

Charminal is a simple and fun Python library designed to enhance your terminal output with emojis, colors, and styles! Whether you're developing scripts or building command-line tools, Charminal can help you make your terminal messages more vibrant and expressive.

Charminal-logo

Features

  • Emojis: A collection of commonly used emojis to add fun and meaning to your terminal messages.
  • Colors: Use ANSI escape codes to style your output text with different colors (red, green, yellow, blue, etc.).
  • Text Styles: Apply bold or underline styles to your text for emphasis.

Installation

You can install Charminal via pip:

pip install charminal

Usage

  1. Import
from charminal import *
  1. Show available emojis
show_emojis()

Example output:

  >> EMOJI_BEGIN: 🚀
  >> EMOJI_ERROR: 💥
  >> EMOJI_WARNING: 🚨
  >> EMOJI_HINT: 💡
  1. Show available colors
show_colors()

Example output:

  >> \033[31mCOLOR_RED\033[0m
  >> \033[32mCOLOR_GREEN\033[0m
  >> \033[33mCOLOR_YELLOW\033[0m
  >> \033[34mCOLOR_BLUE\033[0m
  1. Show available styles
show_styles()

Example output:

  >> STYLE_BOLD
  >> STYLE_UNDERLINE
  1. Find Emoji
find_emoji('error')

Example output:

EMOJI_ERROR: 💥
  1. Show Usage
show_usage()

Example output:

==== [🚀User Guide🚀] ====
1. Import the emojis or colors:
   `from pwnwas_emoji import emojis, colors`
2. Use emojis in print statements:
   `print(f'{EMOJI_WARNING} Warning message')`
   >> 🚨 Warning message
3. Use colors:
   `print(f'{COLOR_RED}{EMOJI_WARNING}Error message{RESET}')`
   >> 💥 Error message
  1. Find an Emoji
help_me()

Example output:

There are some "helper" functions that you can call
Try:
    show_emojis(),
    show_colors(), 
    show_styles(),
    show_usage(),
    find_emoji(keyword)

Contribution

Contributions are welcome! Feel free to open an issue or create a pull request on GitHub.

License

This project is licensed under the MIT License – see the LICENSE file for details.

Author

Charminal is developed and maintained by Sulaiman Fawwaz Abdillah Karim. You can reach me at sulaimanfawwazak@gmail.com.

Behind The Logo

The name of this package is "Charminal", a combination of "Charm" and "Terminal". The name "Charminal" itself is similar to a Pokemon character, "Charmander". Hence, I decided to make the logo to be the combination of "Charmander" and "Terminal". Though it looks simple, but subjectively I kinda like it!. Hope you like it too!

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

charminal-1.0.0.tar.gz (3.4 kB view details)

Uploaded Source

Built Distribution

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

charminal-1.0.0-py3-none-any.whl (3.7 kB view details)

Uploaded Python 3

File details

Details for the file charminal-1.0.0.tar.gz.

File metadata

  • Download URL: charminal-1.0.0.tar.gz
  • Upload date:
  • Size: 3.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.2

File hashes

Hashes for charminal-1.0.0.tar.gz
Algorithm Hash digest
SHA256 15256c6ce553d2b4262b88ed2321f4f355e38b1b7267f6c35fc3a06b85e117e0
MD5 a3ebaca80b99adada548a2f85ac575e3
BLAKE2b-256 48bf2b8042deb97b24b41d9e4ae956a837a58eeb68aae6872610dca50d80e803

See more details on using hashes here.

File details

Details for the file charminal-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: charminal-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 3.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.2

File hashes

Hashes for charminal-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 795e8801d2e80a631865a578158722d9edc1259ed77408eef681e61496533b65
MD5 4b81692a0008f50b32c4a3a628774ba8
BLAKE2b-256 532da11c7ba7058e98b000524bdb4165b5382d5b30c02bcf073af6c2fad9b8e6

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