Skip to main content

Short description here

Project description

AscallArtCLI


  • The AscallArtCLI library is a Python library for formatting text in the command line (CLI) using colors, backgrounds, and pre-made tags.
  • The library aims to make the messages of programs or scripts clearer and more professional for both developers and users.

Features

  • Multiple text colors (red, green, blue, yellow, orange, purple, etc.).
  • Colorful backgrounds that support most operating systems.
  • Ready-made tags such as:
  • [START]
  • [END]
  • [sign]
  • [Enter]
  • [ERROR]
  • [INFO]
  • [Information]
  • [Working]
  • [NotWorking]
  • [warning]
  • [Complete]
  • [successfully]
  • [Failed]
  • [please]
  • [Question]
  • [Help]
  • [other]
  • [notice]
  • [note]
  • [Running]
  • [Ready]
  • [DONE]
  • [Loading]
  • [OK]
  • [Okay]
  • [stop]
  • [Critical]
  • [paused]
  • [Retrying]
  • [Skip]
  • [SCAN]
  • [Chacking]
  • [Hacking]
  • [security]
  • [AI]
  • [Press]
  • [Confirm].
  • Easy integration with any CLI project (tools, scanners, scripts).
  • Lightweight library with no external dependencies (Pure Python).

Installation

$ pip install AscallArtCLI

Linux OR Mac

$ pip install AscallArtCLI --break-system-packages

OR

pip install -r requirements.txt --break-system-packages

OR

  • This code is for viewing how it is installed automatically in case you encounter problems in the Linux system.
#!/bin/bash
# -*- coding: utf-8 -*-
# Copyright (c) 2025
# By : Mohammed Al-Baqer

set -e

echo "[Virtual Environment Setup]"

# Detect Operating System
OS=$(uname -s)

# Create Virtual Environment
python3 -m venv venv

# Activate Virtual Environment
source venv/bin/activate

# Dry-run installation (test only)
pip install --dry-run -r requirements.txt

echo ""
echo "Virtual Environment created successfully"
echo "[Starting Installation]"
echo ""

if [[ "$OS" == "Linux" ]]; then
    # Install with --break-system-packages (⚠ risky)
    pip install -r requirements.txt --break-system-packages
elif [[ "$OS" == "Darwin" ]]; then
    # Darwin = macOS
    pip install -r requirements.txt
else
    echo "⚠ Unsupported OS detected: $OS"
    echo "Proceeding with normal installation..."
    pip install -r requirements.txt
fi

echo ""
echo "[Installation Completed]"

$ bash setup.sh

How Working?

Tags

from AscallArtCLI.Tags import(
    START,
    END,
    sign,
    Enter,
    ERROR,
    INFO,
    Information,
    Working,
    NotWorking,
    warning,
    Complete,
    successfully,
    Failed,
    please,
    Question,
    Help,
    other,
    notice,
    note,
    Running,
    Ready,
    DONE,
    Loading,
    OK,
    Okay,
    stop,
    Critical,
    paused,
    Retrying,
    Skip,
    SCAN,
    Chacking,
    Hacking,
    security,
    AI,
    Press,
    Confirm
)
# Method 1: Import a specific constantfrom Tags import START, END, INFO

print(START + "The process has started now.")
print(END + "The process is now complete.")
print(INFO + "There is information.")

OutPut

[START] The process has started now.
[END] The process is now complete.
[INFO] There is information.

# Method 2: Import all (thanks to the __all__ list)
from AscallArtCLI.Tags import *

print(OK + "The operation was successful.")
print(ERROR + "Something went wrong!")

OutPut

[ok] The operation was successful.
[ERROR] Something went wrong!

Colors

S = "\033[0m"        # Reset
R = "\033[91;1m"     # Red
G = "\033[92;1m"     # Green
B = "\033[94;1m"     # Blue
Y = "\033[93;1m"     # Yellow
C = "\033[96;1m"     # Cyan
M = "\033[95;1m"     # Magenta
W = "\033[97;1m"     # White
D = "\033[90;1m"     # Grey
P = "\033[38;5;198m" # Pink
O = "\033[38;5;202m" # Orange
from AscallArtCLI.Colors import(R, G, B, Y, D, C, P, O, W, M, S)

BackGround

Reset = "\033[0m"         # Reset
Black = "\033[40m"        # Black
Dark = "\033[40m"         # Dark
Red = "\033[41m"          # Red
Green = "\033[42m"        # Green
Yellow = "\033[43m"       # Yellow
Blue = "\033[44m"         # Blue
Magenta = "\033[45m"      # Magenta
Cyan = "\033[46m"         # Cyan
White = "\033[47m"        # White
Orange = "\033[48;5;202m" # Orange
Pink = "\033[48;5;198m"   # Pink
from AscallArtCLI.BackGround import(Red, Green, Blue, Black, Yellow, Cyan, Orange, Pink, Magenta, White, Reset)

images


BackGround

Code

from AscallArtCLI.BackGround import(Red, Green, Blue, Black, Yellow, Cyan, Orange, Pink, Magenta, White, Reset)

print(f"{Red} B {Green} a {Blue} c {Yellow} k {Cyan} G {White} r {Magenta} o {Orange} u {Pink} n {Red} d {Reset}\n")
print(Red + " Red    " + Reset)
print(Green + " Green  " + Reset)
print(Yellow + " Yellow " + Reset)
print(Blue + " Blue   " + Reset)
print(Magenta + " Magenta" + Reset)
print(Cyan + " Cyan   " + Reset)
print(White + " White  " + Reset)
print(Orange + " Orange " + Reset)
print(Pink + " Pink   " + Reset)

review

BackGround


Colors

Code

from AscallArtCLI.Colors import(R, G, B, Y, D, C, P, O, W, M, S)

print(f"{R} C {G} o {B} l {Y} o {M} r {P} s\n")
print(R + " Red    " + R)
print(G + " Green  " + R)
print(Y + " Yellow " + R)
print(B + " Blue   " + R)
print(M + " Magenta" + R)
print(C + " Cyan   " + R)
print(W + " White  " + R)
print(O + " Orange " + R)
print(P + " Pink   " + R)

review

Colors


Tags

Code

from AscallArtCLI.Tags import(
    START,
    END,
    sign,
    Enter,
    ERROR,
    INFO,
    Information,
    Working,
    NotWorking,
    warning,
    Complete,
    successfully,
    Failed,
    please,
    Question,
    Help,
    other,
    notice,
    note,
    Running,
    Ready,
    DONE,
    Loading,
    OK,
    Okay,
    stop,
    Critical,
    paused,
    Retrying,
    Skip,
    SCAN,
    Chacking,
    Hacking,
    security,
    AI,
    Press,
    Confirm
)

print(START + " AscallArtCLI")
print(END + " AscallArtCLI")
print(sign + " AscallArtCLI")
print(Enter + " AscallArtCLI")
print(ERROR + " AscallArtCLI")
print(INFO + " AscallArtCLI")
print(Information + " AscallArtCLI")
print(Working + " AscallArtCLI")
print(NotWorking + " AscallArtCLI")
print(warning + " AscallArtCLI")
print(Complete + " AscallArtCLI")
print(successfully + " AscallArtCLI")
print(Failed + " AscallArtCLI")
print(please + " AscallArtCLI")
print(Question + " AscallArtCLI")
print(Help + " AscallArtCLI")
print(other + " AscallArtCLI")
print(notice + " AscallArtCLI")
print(note + " AscallArtCLI")
print(Running + " AscallArtCLI")
print(Ready + " AscallArtCLI")
print(DONE + " AscallArtCLI")
print(Loading + " AscallArtCLI")
print(OK + " AscallArtCLI")
print(Okay + " AscallArtCLI")
print(stop + " AscallArtCLI")
print(Critical + " AscallArtCLI")
print(paused + " AscallArtCLI")
print(Retrying + " AscallArtCLI")
print(Skip + " AscallArtCLI")
print(SCAN + " AscallArtCLI")
print(Chacking + " AscallArtCLI")
print(Hacking + " AscallArtCLI")
print(security + " AscallArtCLI")
print(AI + " AscallArtCLI")
print(Press + " AscallArtCLI")
print(Confirm + " AscallArtCLI")

review

Tags


License

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


My WebSite

My WebSite

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

ascallartcli-2.0.0.tar.gz (4.1 kB view details)

Uploaded Source

Built Distribution

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

ascallartcli-2.0.0-py3-none-any.whl (4.1 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for ascallartcli-2.0.0.tar.gz
Algorithm Hash digest
SHA256 0f3741ee2192b32cf324878df3d3b2bcb11b2b2e546c7dd4a0baadba6e22de7c
MD5 17a9840cf9587bcde713ee94a7fe83bd
BLAKE2b-256 e83f197a5556fb78f3acc4a98f9035c5588ed34496005de9cd258554fcb8a30c

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for ascallartcli-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b66ebb5b9a9cf12b8aa320f92d9188f3a58fdec22a401a0503c7c562cb4d93d8
MD5 1539f07a51766c0c924ee686cb54921c
BLAKE2b-256 7a6b2cfcba74a0327e24ddb69e7dfdf3dbfdd127f44ed484b74e2c4063cf85ae

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