pylor 0.0.2

Small package made for using ANSI codes

pylor

Library for outputting colorful text

Supports 16 foreground and 16 background colors

---

Table from Wikipedia

---

QuickStart

Use: pip install pylor to install the module.

Imports

import pylor
from pylor import colors # Imports class full of colors to choose from
from pylor import decorations # Imports class full of decorations
from pylor import cursor # Imports class for cursor movement

Testing the installation

import pylor
print( pylor.test() ) # This will print the project logo

---

Functions

color()

The color function is used to create colored strings.

Arguments:

• String
• Foreground color
• Background color [Optional]

Example:

import pylor
from pylor import colors

print( pylor.color("Hello world!", colors.foreground.red) )

Returns string

---

colorNoReset()

The color function is used to create colored strings, does not set the color back to default (continues to color any future output).

Arguments:

• String
• Foreground color
• Background color [Optional]

Example:

import pylor
from pylor import colors

print( pylor.colorNoReset("Hello world!", colors.foreground.red) )

Returns string

---

formatting()

Function used for formatting text.

Arguments:

• String
• Formatting type

Example:

import pylor
from pylor import decorations

print( pylor.formatting("Hello world!", decorations.bold) )

Returns string

---

formattingNoReset()

Function used for formatting text, does not set the color back to default (continues to decorate any future output).

Arguments:

• String
• Formatting type

Example:

import pylor
from pylor import decorations

print( pylor.formatting("Hello world!", decorations.bold) )

Returns string

---

reset()

Function used for resetting the color after using colorNoReset()

Arguments:

• None

Example:

import pylor

print( pylor.reset() )

Returns string

---

test()

Function for testing the installation of the package, returns the project logo.

Arguments:

• None

Example:

import pylor

print( pylor.test() )

Returns string

---

Codes

Colors

Foreground

colors.foreground.

red
black
green
yellow
blue
magenta
cyan
white
brightBlack
brightRed
brightGreen
brightYellow
brightBlue
brightMagenta
brightCyan
brightWhite

Background

colors.background.

red
black
green
yellow
blue
magenta
cyan
white
brightBlack
brightRed
brightGreen
brightYellow
brightBlue
brightMagenta
brightCyan
brightWhite

---

Decorations

decorations.

bold
underline
reverse

Cursor

cursor.

up
down
right
left

Exceptions

NotAColor

Exception for when the argument given is not an ANSI code.

Example of code that would trigger this Exception:

import pylor
from pylor import colors

print( pylor.color("Hello world!", "red") ) # This is an example of bad code, do not use this, it will not work.

correct code:

import pylor
from pylor import colors

print( pylor.color("Hello world!", colors.foreground.red) )

---

SameType

Exception for when the background/foreground colors are used twice.

Example of code that would trigger this Exception:

import pylor
from pylor import colors

print( pylor.color("Hello world!", colors.foreground.red, colors.foreground.green) ) # This is an example of bad code, do not use this, it will not work.

correct code:

import pylor
from pylor import colors

print( pylor.color("Hello world!", colors.foreground.red, colors.background.red) )