DyePy

A Python module to work with anything related to colors.

From styling the text to changing the foreground and background colors to converting colors to and from different color spaces, or defaulting them to Hexadecimal codes/values (as most Python modules support or only accept HEX codes), this module can easily help you with ALL of it. And yeah, it even has CSS4 color support (like named colors with their respective Hex values and some added colors - which are famous or are used/seen a lot).

Detailed description/documentation for each and every class and function is written to make everything in the module understandable to every python developer. It is recommended to run this module - or a program this module is being imported in to be ran - on a command-line (like Bash, PowerShell, Command Prompt, etc.) for the module to work properly and give the most accurate and complete results (although results may vary with the command-lines, and some font styles may not work if they are not supported by the command-line)

Go to:

• Installation
• Usage (example)
• Metadata
• Contribution
• Changelogs

Installation

Install this package using the following command:

$ python -m pip install dyepy

The entire code in written in pure python, without any packages, so you don't require any internal/external packages to run/use this module. It is recommended to use the latest stable version of python (Python 3.9.0, as of 12/10/2020).

Usage (example)

You can either simply run the file to use its own mini command-line (kinda) using:

$ python dyepy.py

You'll either need to download dyepy or go to the installation folder and run the command from that folder

*[that folder]: print(__import__('dyepy').__file__)

Or you can simply copy/write this example program and run it:

# Import tkinter for demonstatration of colors
try:
    from Tkinter import Tk, Button  # Python 2

except (ModuleNotFoundError, ImportError):
    from tkinter import Tk, Button  # Python 3


# Import this module to the program
import dyepy


def change_bgcolor():
    """
    Changes the app background color and returns None
    """
    
    global root
    
    root.configure(background=dyepy.Colors.getrandomcolor())


root = Tk()
root.title('Usage (Example)')
root.configure(background=dyepy.Colors.BLACK)

button = Button(
    root, text='Change color',
    fg=dyepy.Colors.WHITE,
    bg=dyepy.Colors.WINDOWSBLUE,
    command=change_bgcolor,
    height=10, width=50
)

button.grid(row=0, column=0, pady=50, padx=250)

root.mainloop()

Save this python file (say, as example.py) and run it on a command-line using:

$ pythonw example.py

Meta

SFM61319 - u/SFM61319 - Avinash Maddikonda

Wanna contribute?

Everyone is welcome to update my documentation and/or the python code. And you are the 'one' in everyone.
To contribute, follow these steps:

1. Fork it
2. Create your feature branch by entering git checkout -b feature/fooBar on your Git Bash
3. Commit your changes by entering git commit -m "Add some foo bar, baz"
4. Push to the branch by entering git push origin feature/fooBar
5. Create a new Pull Request (PR)

That's it, you have contributed to the documentation and/or the code!

If you have any major issues/doubts/feature requests or anything else which you don't want to do on your own or which you want to contribute without forking this repository, then please open an issue

Changelogs

Changelogs of the library can be found in CHANGELOGS.md

Once again, thank you for spending your precious time here, it means a lot to me!