visuals 1.2.9

Create beautiful and colorful designs for your terminal applications

visuals

visuals is a Python library used for implementing beautiful, colorful styling into your terminal applications.
It is based on pystyle, pyfade, pycenter and pybanner.

Install

pip install visuals

Features

• Colored text ✔️
• Colored text with a fade effect ✔️
• Writing effects ✔️
• Centered text ✔️
• Adding banners ✔️
• Make boxes ✔️
• Hide and show cursor ✔️
• Change window title ✔️
• System functions ✔️

Colored text

Color some text easily.

from visuals import Colors, Colorate
text = "Hello world!"
print(Colors.blue + text)
# or
print(Colorate.Color(Colors.blue, text, True))

Colors.blue = color
text = text to be colored
True = reset color after (otherwise it will continue printing characters in the specified color)

Available functions are:

• Color (simply color some text)
• Error (make an error effect)

Colored text with fade effect

Make a fade effect.

from visuals import Colors, Fade
print(Fade.Horizontal(Colors.yellow_to_red, "Hello, Welcome to visuals.", 1))

Colors.yellow_to_red = color
Fade.Vertical = mode
1 = intensity (default=1)

Available effects are:

• Vertical
• Horizontal
• Diagonal
• DiagonalBackwards

Writing text with fade effect

To print a text using writing and fade effect you can use the visuals.Write function.

from visuals import Write, Colors

name = Write.Input("Enter your name -> ", Colors.red_to_purple, interval=0.0025)
Write.Print(f"Nice to meet you, {name}!", Colors.blue_to_green, interval=0.05)

There are 2 functions:

Write.Print: prints the text to the terminal with chosen effects
Write.Input: same as Write.Print but adds an input at the end

There are 6 arguments:

text: the text to be written to the terminal
color: the color you want for the text
interval: the interval of the writing effect
hide_cursor: whether you want the cursor to be hidden or not
end: the end color, the default is white
input_color (only for Write.Input): the color of the input

Center text

Center a text in the terminal.

from visuals import Center
print(Center.XCenter("Hello, Welcome to visuals."))

Output:

                                            Hello, Welcome to visuals.                                

Available modes are:

• Center (Center the banner/text on both axis)
• XCenter (Center the banner/text on X axis)
• YCenter (Center the banner/text on Y axis)

Adding banners

Add text to a banner easily.

from visuals import Add
banner1 = '''
    .--.
  .'_\/_'.
  '. /\ .'
    "||"
     || /\
  /\ ||//\)
 (/\\||/
____\||/____'''

text = "This is a beautiful banner\nmade with visuals"

print(Add.Add(banner1, text, 4))

Output:

    .--.
  .'_\/_'.
  '. /\ .'
    "||"    This is a beautiful banner
     || /\  made with visuals
  /\ ||//\)
 (/\||/
____\||/____

banner1 = first banner
text = second banner
4 = blank lines before adding the smallest banner to the biggest banner (default=0). Set to True to center it

Make boxes

Make beautiful boxes easily!

from visuals import Box
print(Box.Lines("Hello, Welcome to visuals."))
print(Box.DoubleCube("Hello, Welcome to visuals."))

Output:

─══════════════════════════☆☆══════════════════════════─
               Hello, Welcome to visuals.
─══════════════════════════☆☆══════════════════════════─
╔════════════════════════════╗
║ Hello, Welcome to visuals. ║
╚════════════════════════════╝

Available modes are:

• Lines
• SimpleCube
• DoubleCube

Cursor

Show cursor!

from visuals import Cursor

Cursor.ShowCursor()

Hide cursor!

from visuals import Cursor

Cursor.HideCursor()

System functions

Check if the terminal supports colors

from visuals import System

System.Init()

Clear the terminal screen

from visuals import System

System.Clear()

Change the terminal title (Windows-only)

from visuals import System

System.Title("The title")

Change terminal size (Windows-only)

from visuals import System

System.Size(12,12)

Run a shell command

from visuals import System

System.Command("echo hello")

Contributions, issues and feature requests are welcome!

---