printcolored 2.1.1__tar.gz → 2.2__tar.gz

{printcolored-2.1.1 → printcolored-2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: printcolored
-Version: 2.1.1
+Version: 2.2
 Requires-Dist: platformdirs
 Provides-Extra: windows-legacy
 Requires-Dist: colorama; extra == "windows-legacy"

printcolored-2.2/printColored/Fonter.py

@@ -0,0 +1,32 @@
+
+
+from random import *
+
+fonts: dict[str, tuple[str, ...]] = {
+    "original": ("a","b","c","d","e","f","g","h","i","j","k","l","m","n","o","p","q","r","s","t","u","v","w","x","y","z","A","B","C","D","E","F","G","H","I","J","K","L","M","N","O","P","Q","R","S","T","U","V","W","X","Y","Z"," ","0","1","2","3","4","5","6","7","8","9","!","$","%","&","'","(",")","*","+",",","-",".","/",":",";","<","=",">","?","@","[","\\","]","^","_","`","{","|","}","~"),
+    
+    # act like theres stuff here
+
+
+}
+
+random_decorators: dict[str, tuple[str, str]] = {
+    "chess": (""),
+}
+
+decorators: dict[str, tuple[str, str]] = {
+    "barrier": (""),
+    
+}
+
+
+
+def Fonter(text: str, font: str, decorator: str = "") -> str:
+    original = fonts["original"]
+    fontedtext = []
+    for letter in text:
+        fontedtext.append(fonts[font][original.index(letter)] if letter in original else letter)
+    result = "".join(fontedtext)
+    if decorator == "":
+        return result
+    return f"{decorators[decorator][0]}{result}{decorators[decorator][1]}"

{printcolored-2.1.1 → printcolored-2.2}/printColored/core.py

@@ -29,39 +29,39 @@ from pathlib import Path
 import json
 from platformdirs import user_config_dir
 
-CONFIG_DIR = Path(user_config_dir("printColored"))
-CUSTOM_FORMATS_PATH = CONFIG_DIR / "custom.json"
+CONFIG_DIR: Path = Path(user_config_dir("printColored"))
+CUSTOM_FORMATS_PATH: Path = CONFIG_DIR / "custom.json"
 
 
-def load_custom_formats():
+def load_custom_formats() -> dict[str, str]:
     if CUSTOM_FORMATS_PATH.exists():
         with open(CUSTOM_FORMATS_PATH, "r") as file:
             return json.load(file)
     return {}
 
 
-def save_custom_formats(formats):
+def save_custom_formats(formats: dict[str, str]) -> None:
     CONFIG_DIR.mkdir(parents=True, exist_ok=True)
     with open(CUSTOM_FORMATS_PATH, "w") as file:
         json.dump(formats, file, indent=4)
 
 
-def add_custom_format(name, value):
-    formats = load_custom_formats()
-    formats[name] = value
-    save_custom_formats(formats)
-    return formats
+def add_custom_format(name: str, value: str) -> dict[str, str]:
+    global custom_formats
+    custom_formats[name] = value
+    save_custom_formats(custom_formats)
+    return custom_formats
 
 
-custom_formats = load_custom_formats()
+custom_formats: dict[str, str] = load_custom_formats()
 
 
 from . import Fonter
 from .formats import ansi_formats, html_colors
 
-_default_source_order = ("ansi_format","rgb_format","custom_format")
+_default_source_order: tuple[str, ...] = ("ansi_format","rgb_format","custom_format")
 
-def _font_check(text, *inputs):
+def _font_check(text: str, *inputs: str) -> str:
     changed = False
     font = ""
     decorator = ""
@@ -74,13 +74,13 @@ def _font_check(text, *inputs):
             changed = True
     return Fonter.Fonter(text, font, decorator) if changed == True else text 
 
-def _reset(reset):
+def _reset(reset: bool) -> str:
     if reset:
         return "\033[0m"
     else: 
         return ""
 
-def _single_code(fformat, *, html_view="", source_order=()):
+def _single_code(fformat: str, *, html_view: str = "", source_order: tuple[str, ...] = ()) -> str:
     if fformat.replace(";", "").isdigit():
         return fformat
     for source in source_order:
@@ -97,8 +97,8 @@ def _single_code(fformat, *, html_view="", source_order=()):
             raise ValueError(f"{source}: Unknown Format Source!")
     raise ValueError(f"{fformat}: Unknown Format!")
     
-def _build_code(*formats_used, html_view="", source_order=()):
-    code_list = []
+def _build_code(*formats_used: str, html_view: str = "", source_order: tuple[str, ...] = ()) -> str:
+    code_list: list[str] = []
     for name in formats_used:
         name = _single_code(name, html_view=html_view, source_order=source_order)
         if name != None: 
@@ -106,7 +106,7 @@ def _build_code(*formats_used, html_view="", source_order=()):
         
     return ";".join(code_list)
 
-def _rgb_validation(r,g,b):
+def _rgb_validation(r: str, g: str, b: str) -> str:
     if r == "" and g == "" and b == "":
         return ""
     elif r == "" or g == "" or b == "":
@@ -119,42 +119,42 @@ def _rgb_validation(r,g,b):
 
 
 class Theme:
-    def __init__(self, *formats_used):
-        self.formats_used = formats_used
+    def __init__(self, *formats_used: str) -> None:
+        self.formats_used: tuple[str, ...] = formats_used
     
-    def print(self, text, *, reset=True, html_view="", source_order=_default_source_order):
+    def print(self, text: str, *, reset: bool = True, html_view: str = "", source_order: tuple[str, ...] = _default_source_order) -> None:
         text = _font_check(text, *self.formats_used)
-        self.format_code = _build_code(*self.formats_used, html_view=html_view, source_order=source_order) 
-        reset = _reset(reset)
-        print(f"\033[{self.format_code}m{text}{reset}")
+        self.format_code: str = _build_code(*self.formats_used, html_view=html_view, source_order=source_order) 
+        reset_code = _reset(reset)
+        print(f"\033[{self.format_code}m{text}{reset_code}")
     
-    def overwrite(self, *new):
+    def overwrite(self, *new: str) -> None:
         self.formats_used = new
     
-    def add(self, *new):
+    def add(self, *new: str) -> None:
         self.formats_used = self.formats_used + new
 
-    def remove(self, *removed):
+    def remove(self, *removed: str) -> None:
         self.formats_used = tuple(fformat for fformat in self.formats_used if fformat not in removed)
     
-    def showUsed(self):
+    def showUsed(self) -> None:
         print(self.formats_used)
 
-    def __str__(self):
+    def __str__(self) -> str:
         return str(self.formats_used)
 
 
 class ThemeRGBV(Theme):
-    def __init__(self, r="", g="", b="", r2="", g2="", b2="", *formats_used):
+    def __init__(self, r: str = "", g: str = "", b: str = "", r2: str = "", g2: str = "", b2: str = "", *formats_used: str) -> None:
         super().__init__(*formats_used)
         
-        self.fg = _rgb_validation(r,g,b)
-        self.bg = _rgb_validation(r2,g2,b2)
+        self.fg: str = _rgb_validation(r,g,b)
+        self.bg: str = _rgb_validation(r2,g2,b2)
             
-    def print(self, text, *, reset=True, html_view="", source_order=_default_source_order):
+    def print(self, text: str, *, reset: bool = True, html_view: str = "", source_order: tuple[str, ...] = _default_source_order) -> None:
         text = _font_check(text, *self.formats_used)
         self.format_code = _build_code(*self.formats_used, html_view=html_view, source_order=source_order)
-        reset = _reset(reset)
+        reset_code = _reset(reset)
 
         if self.format_code:
             self.format_code += ";"
@@ -163,43 +163,43 @@ class ThemeRGBV(Theme):
             if self.bg == "":
                 super().print(text, reset=reset, html_view=html_view, source_order=source_order)
             else:
-                self.rgbcode = "48;2;" + self.bg
-                self.finalcode = self.format_code + self.rgbcode
-                print(f"\033[{self.finalcode}m{text}{reset}")
+                self.rgbcode: str = "48;2;" + self.bg
+                self.finalcode: str = self.format_code + self.rgbcode
+                print(f"\033[{self.finalcode}m{text}{reset_code}")
         else:
             if self.bg == "":
                 self.rgbcode = "38;2;" + self.fg
                 self.finalcode = self.format_code + self.rgbcode
-                print(f"\033[{self.finalcode}m{text}{reset}")
+                print(f"\033[{self.finalcode}m{text}{reset_code}")
             else:
                 self.rgbcode = "38;2;" + self.fg + ";48;2;" + self.bg
                 self.finalcode = self.format_code + self.rgbcode
-                print(f"\033[{self.finalcode}m{text}{reset}")
+                print(f"\033[{self.finalcode}m{text}{reset_code}")
     
-    def overwrite(self, r,g,b, r2,g2,b2, *new):
+    def overwrite(self, r: str, g: str, b: str, r2: str, g2: str, b2: str, *new: str) -> None:
         super().overwrite(*new)
         
         self.fg = _rgb_validation(r,g,b)
         self.bg = _rgb_validation(r2,g2,b2)
         
-    def showUsed(self):
+    def showUsed(self) -> None:
       print(f"Foreground: {self.fg}")
       print(f"Background: {self.bg}")
       print(f"Formats: {self.formats_used}")
 
-    def __str__(self):
-        return self.fg +";"+ self.bg +" "+ self.formats_used
+    def __str__(self) -> str:
+        return self.fg +";"+ self.bg +" "+ str(self.formats_used)
 
 
-def printColored(text, *formats_used, reset= True, html_view="", source_order=_default_source_order):
+def printColored(text: str, *formats_used: str, reset: bool = True, html_view: str = "", source_order: tuple[str, ...] = _default_source_order) -> None:
     text = _font_check(text, *formats_used)
     code = _build_code(*formats_used, html_view=html_view, source_order=source_order)        
-    reset = _reset(reset)
+    reset_code = _reset(reset)
 
-    print(f"\033[{code}m{text}{reset}")
+    print(f"\033[{code}m{text}{reset_code}")
 
 
-def colorGen(*formats_used, mode="", html_view="", source_order=_default_source_order):
+def colorGen(*formats_used: str, mode: str = "", html_view: str = "", source_order: tuple[str, ...] = _default_source_order) -> str:
     code = _build_code(*formats_used, html_view=html_view, source_order=source_order)
     if mode == "b":
         return code
@@ -212,10 +212,10 @@ def colorGen(*formats_used, mode="", html_view="", source_order=_default_source_
 # now colorGen is also fixed
 
 
-def printl(text=(), formats_used=(), *, sepr=""):
+def printl(text: tuple[str, ...] = (), formats_used: tuple[str | tuple[str, ...], ...] = (), *, sepr: str = "") -> None:
     
     for i, (line, fformat) in enumerate(zip(text, formats_used)):
-        code = []
+        code: list[str] = []
         line = _font_check(line, fformat)
         if type(fformat) == str:
             fformat = _single_code(fformat)
@@ -236,10 +236,10 @@ def printl(text=(), formats_used=(), *, sepr=""):
 # Dunno if i should keep colorGen, but ill just leave it there because
 # it returns the color code itself
 
-def printRGB(text, r,g,b, *formats_used, view="", html_view="",reset=True, source_order=_default_source_order):
+def printRGB(text: str, r: str, g: str, b: str, *formats_used: str, view: str = "", html_view: str = "", reset: bool = True, source_order: tuple[str, ...] = _default_source_order) -> None:
     text = _font_check(text, *formats_used)
     code = _build_code(*formats_used, html_view=html_view, source_order=source_order)
-    reset = _reset(reset)    
+    reset_code = _reset(reset)    
     # if you dont want a format when using the rgb function,
     # you can just not enter it
     rgbvalue = _rgb_validation(r,g,b)
@@ -252,13 +252,13 @@ def printRGB(text, r,g,b, *formats_used, view="", html_view="",reset=True, sourc
         code = ";" + code
 
 
-    print(f"\033[{viewvalue}2;{rgbvalue}{code}m{text}{reset}")
+    print(f"\033[{viewvalue}2;{rgbvalue}{code}m{text}{reset_code}")
 
 
-def printRGBV(text, r,g,b, r2, g2, b2, *formats_used, reset=True, html_view="", source_order=_default_source_order):
+def printRGBV(text: str, r: str, g: str, b: str, r2: str, g2: str, b2: str, *formats_used: str, reset: bool = True, html_view: str = "", source_order: tuple[str, ...] = _default_source_order) -> None:
     text = _font_check(text, *formats_used)
     code = _build_code(*formats_used, html_view=html_view, source_order=source_order)
-    reset = _reset(reset)
+    reset_code = _reset(reset)
 
     fg = _rgb_validation(r,g,b)
     bg = _rgb_validation(r2,g2,b2)
@@ -268,35 +268,35 @@ def printRGBV(text, r,g,b, r2, g2, b2, *formats_used, reset=True, html_view="",
 
     if fg == "":
         if bg == "":
-            print(f"\033[{code}m{text}{reset}")
+            print(f"\033[{code}m{text}{reset_code}")
         else:
-            print(f"\033[{code}48;2;{bg}m{text}{reset}")
+            print(f"\033[{code}48;2;{bg}m{text}{reset_code}")
     else:
         if bg == "":
-            print(f"\033[{code}38;2;{fg}m{text}{reset}")
+            print(f"\033[{code}38;2;{fg}m{text}{reset_code}")
         else:
-            print(f"\033[{code}38;2;{fg};48;2;{bg}m{text}{reset}")
+            print(f"\033[{code}38;2;{fg};48;2;{bg}m{text}{reset_code}")
         
 
-def formatfinder(min, max): # made this to find new formats, theres nothing beyond 107
+def formatfinder(val1: str, val2: str) -> None: # made this to find new formats, theres nothing beyond 107
     # btw use strings ("1","108") and not integers (1,108)
-    if min.isdigit() and max.isdigit():
-        min = int(min)
-        max = int(max)
-        for code in range(min, max+1):
+    if val1.isdigit() and val2.isdigit():
+        num1 = int(val1)
+        num2 = int(val2)
+        for code in range(num1, num2+1):
             print(f"At iteration {code}: \033[{code}mHello World!\033[0m")
-    elif min == "font" or max == "font":
+    elif val1 == "font" or val2 == "font":
         for key, value in Fonter.fonts.items():
             print(f"{key}: {value}")
-    elif min == "decors" or max == "decors":
+    elif val1 == "decors" or val2 == "decors":
         for key, value in Fonter.decorators.items():
             print(f"{key}: {value}")
-    elif min == "ansi_dict" or max == "ansi_dict":
+    elif val1 == "ansi_dict" or val2 == "ansi_dict":
         for key, value in ansi_formats.items():
            print(f"\033[{value}m{key}\033[0m")
-    elif min == "html_dict" or max == "html_dict":
+    elif val1 == "html_dict" or val2 == "html_dict":
         for key, value in html_colors.items():
            print(f"\033[38;2;{value}m{key}\033[0m")
-    elif min == "custom_dict" or max == "custom_dict":
+    elif val1 == "custom_dict" or val2 == "custom_dict":
         for key, value in custom_formats.items():
-           print(f"\033[{value}m{key}\033[0m")
+           print(f"\033[{value}m{key}\033[0m")

{printcolored-2.1.1 → printcolored-2.2}/printColored/display.py

@@ -1,45 +1,46 @@
-from .core import formatfinder
-
-def ansi_range():
-    print("All possible formats in range of 1-107:")
-    formatfinder("1","107")
-
-def all_ansi_dict_formats():
-    print("All available formats:")
-    formatfinder("ansi_dict","")
-
-def all_html_formats():
-    print("All HTML formats:")
-    formatfinder("html_dict","")
-
-def all_custom_formats():
-    print("All custom formats:")
-    formatfinder("custom_dict","")
-
-def all_fonts():
-    print("All fonts available:")
-    formatfinder(" ","font")
-
-def all_decors():
-    print("All decorators available:")
-    formatfinder(" ","decors")
-
-display = {
-    "all_ansi_formats": ansi_range,
-    "ansi_dict":        all_ansi_dict_formats,
-    "html_dict":        all_html_formats,
-    "custom_dict":      all_custom_formats,
-    "fonts":            all_fonts,
-    "decorators":       all_decors
-}
-
-
-def display_formats(selected_source=None):
-    if selected_source:
-        if selected_source in display:
-            display[selected_source]()
-        else:
-            raise ValueError(f"{selected_source} Not a valid format source!")
-    else:
-        for source in display:
-            display[source]()
+from collections.abc import Callable
+from .core import formatfinder
+
+def ansi_range() -> None:
+    print("All possible formats in range of 1-107:")
+    formatfinder("1","107")
+
+def all_ansi_dict_formats() -> None:
+    print("All available formats:")
+    formatfinder("ansi_dict","")
+
+def all_html_formats() -> None:
+    print("All HTML formats:")
+    formatfinder("html_dict","")
+
+def all_custom_formats() -> None:
+    print("All custom formats:")
+    formatfinder("custom_dict","")
+
+def all_fonts() -> None:
+    print("All fonts available:")
+    formatfinder(" ","font")
+
+def all_decors() -> None:
+    print("All decorators available:")
+    formatfinder(" ","decors")
+
+display: dict[str, Callable[[], None]] = {
+    "all_ansi_formats": ansi_range,
+    "ansi_dict":        all_ansi_dict_formats,
+    "html_dict":        all_html_formats,
+    "custom_dict":      all_custom_formats,
+    "fonts":            all_fonts,
+    "decorators":       all_decors
+}
+
+
+def display_formats(selected_source: str | None = None) -> None:
+    if selected_source:
+        if selected_source in display:
+            display[selected_source]()
+        else:
+            raise ValueError(f"{selected_source} Not a valid format source!")
+    else:
+        for source in display:
+            display[source]()

{printcolored-2.1.1 → printcolored-2.2}/printColored/formats.py

@@ -1,4 +1,4 @@
-ansi_formats = { # i think the dictonary now contains every possible format
+ansi_formats: dict[str, str] = { # i think the dictonary now contains every possible format
     # Colors 
     "gray"   : "30",
     "red"    : "31",
@@ -55,7 +55,7 @@ ansi_formats = { # i think the dictonary now contains every possible format
     ""     : "0"
 }
 
-html_colors = { # note that just like normal rgb, using two at same time,
+html_colors: dict[str, str] = { # note that just like normal rgb, using two at same time,
     # the last overwrites all before it.
     # also note that the format keys are written in a different way
     # than i write bc it was copypasted from html website
@@ -71,8 +71,6 @@ html_colors = { # note that just like normal rgb, using two at same time,
     "Pink": "255;192;203",
     "LightPink": "255;182;193",
     "HotPink": "255;105;180", 
-    # ^ i am NOT the one in charge of writing these
-    # ᵇᵘᵗ ⁱ ᵃᶜᵗᵘᵃˡˡʸ ᵗʰⁱⁿᵏ ᵗʰᵃᵗ ᵗʰⁱˢ ᵖⁱⁿᵏ ⁱˢ ᵃᵇⁱᵗ ʰ⁻
     "DeepPink": "255;20;147",
     "MediumVioletRed": "199;21;133",
     "PaleVioletRed": "219;112;147",

{printcolored-2.1.1 → printcolored-2.2}/printColored/guide.py

@@ -1,133 +1,134 @@
-from .core import *
-
-_deco = Theme("green", "bold")
-_deco2 = Theme("bright_blue", "bold")
-_deco3 = Theme("bright_yellow")
-_border = "--------------------------------"
-
-
-def _guide_printColored():
-    _deco.print(_border)
-    print("printColored()")
-    printColored("Example use of printColored()".center(32), "green", "bold", "italic")
-    print("Main function, enter text, then formats, and the text will come formatted based on the provided formats")
-    print("Take a look at the dictionary and enter formats to use")
-    _deco.print(_border)
-
-
-def _guide_colorGen():
-    _deco.print(_border)
-    print("colorGen()")
-    print(
-        f"{colorGen('red', 'bold')}   Example use "
-        f"{colorGen('', 'strikethrough', 'blue')}of colorGen()"
-        f"{colorGen('')}"
-    )
-
-    genformat1 = colorGen("bright_white", "highlight_blue")
-    genformat2 = colorGen("", "yellow", "highlight_green", "underline")
-    print(f"    {genformat1}Example 2 {genformat2}of colorGen(){colorGen('')}")
-    print("This is used to enter many formats in the same line")
-    _deco.print(_border)
-
-
-def _guide_printl():
-    _deco.print(_border)
-    print("printl()")
-    printl(("Example", "use", "of", "printl()"), ("green", ("36", "italic"), "yellow", "magenta"), sepr=" ")
-    print("Printl is used to print many text in same line each with their own formats")
-    _deco.print(_border)
-
-
-def _guide_printRGB():
-    _deco.print(_border)
-    print("printRGB()")
-    printRGB("Example use of printRGB()".center(32), "255", "0", "255", "bold", view="")
-    printRGB("Example 2 of printRGB()".center(32), "0", "255", "255", view="bg")
-    print("Notice how it can only display either")
-    print("foreground or background at one time")
-    print("You can also add formats to it".center(32))
-    _deco.print(_border)
-
-
-def _guide_printRGBV():
-    _deco.print(_border)
-    print("printRGBV()")
-    printRGBV("Example use of printRGBV()".center(32), "0", "255", "0", "0", "0", "255", "")
-    printRGBV("Example 2 of printRGBV()".center(32), "0", "0", "0", "255", "0", "255", "italic")
-    print("It can display both foreground and background")
-    print("and also add formats".center(32))
-    print("Note that sometimes the background")
-    print("color blocks the foreground color")
-    _deco.print(_border)
-
-
-def _guide_theme():
-    _deco.print(_border)
-    print("Theme")
-    deadly = Theme("brightred", "double_underline", "bold")
-    deadly.print("Example use of Theme class")
-    print("It can be used for formats that you use many times")
-
-    deadly.add("strikethrough")
-    deadly.print("Example of add(*formats)")
-
-    deadly.remove("double_underline", "strikethrough")
-    deadly.print("Example of remove(*formats)")
-
-    deadly.overwrite("highlight_brightred", "underline")
-    deadly.print("Example of overwrite(*formats)")
-
-    deadly.showUsed()
-    print("showUsed() displays the current formats")
-    _deco.print(_border)
-
-
-def _guide_theme_rgbv():
-    _deco.print(_border)
-    print("ThemeRGBV")
-    classified = ThemeRGBV("255", "255", "255", "0", "0", "0", "")
-    classified.print("Example of printRGBV(r,g,b,r2,g2,b2,*formats)")
-    print("It can change both foreground and background")
-    print("and you can choose to use one or both")
-
-    classified.add("bold", "underline")
-    classified.print("Example of add(*formats)")
-
-    classified.remove("underline")
-    classified.print("Example of remove(*formats)")
-    print("Adding/removing only affects formats")
-
-    classified.overwrite("0", "0", "0", "255", "255", "255", "strikethrough")
-    classified.print("Example of overwrite(r,g,b,r2,g2,b2,*new)")
-    print("Overwrite rewrites the whole object")
-
-    classified.showUsed()
-    print("showUsed() displays the current settings")
-    _deco.print(_border)
-
-
-GUIDE = {
-    "printColored": _guide_printColored,
-    "colorGen": _guide_colorGen,
-    "printl": _guide_printl,
-    "printRGB": _guide_printRGB,
-    "printRGBV": _guide_printRGBV,
-    "Theme": _guide_theme,
-    "ThemeRGBV": _guide_theme_rgbv,
-}
-
-
-def func_guide(selected_function=None):
-    if selected_function:
-        if selected_function in GUIDE:
-            GUIDE[selected_function]()
-        else:
-            raise ValueError(f"{selected_function} Not a valid guide section!")
-    else:
-        for section in GUIDE:
-            GUIDE[section]()
-        _deco.print(_border)
-        _deco2.print(_border)
-        print("Thanks for reading!")
+from collections.abc import Callable
+from .core import *
+
+_deco: Theme = Theme("green", "bold")
+_deco2: Theme = Theme("bright_blue", "bold")
+_deco3: Theme = Theme("bright_yellow")
+_border: str = "--------------------------------"
+
+
+def _guide_printColored() -> None:
+    _deco.print(_border)
+    print("printColored()")
+    printColored("Example use of printColored()".center(32), "green", "bold", "italic")
+    print("Main function, enter text, then formats, and the text will come formatted based on the provided formats")
+    print("Take a look at the dictionary and enter formats to use")
+    _deco.print(_border)
+
+
+def _guide_colorGen() -> None:
+    _deco.print(_border)
+    print("colorGen()")
+    print(
+        f"{colorGen('red', 'bold')}   Example use "
+        f"{colorGen('', 'strikethrough', 'blue')}of colorGen()"
+        f"{colorGen('')}"
+    )
+
+    genformat1 = colorGen("bright_white", "highlight_blue")
+    genformat2 = colorGen("", "yellow", "highlight_green", "underline")
+    print(f"    {genformat1}Example 2 {genformat2}of colorGen(){colorGen('')}")
+    print("This is used to enter many formats in the same line")
+    _deco.print(_border)
+
+
+def _guide_printl() -> None:
+    _deco.print(_border)
+    print("printl()")
+    printl(("Example", "use", "of", "printl()"), ("green", ("36", "italic"), "yellow", "magenta"), sepr=" ")
+    print("Printl is used to print many text in same line each with their own formats")
+    _deco.print(_border)
+
+
+def _guide_printRGB() -> None:
+    _deco.print(_border)
+    print("printRGB()")
+    printRGB("Example use of printRGB()".center(32), "255", "0", "255", "bold", view="")
+    printRGB("Example 2 of printRGB()".center(32), "0", "255", "255", view="bg")
+    print("Notice how it can only display either")
+    print("foreground or background at one time")
+    print("You can also add formats to it".center(32))
+    _deco.print(_border)
+
+
+def _guide_printRGBV() -> None:
+    _deco.print(_border)
+    print("printRGBV()")
+    printRGBV("Example use of printRGBV()".center(32), "0", "255", "0", "0", "0", "255", "")
+    printRGBV("Example 2 of printRGBV()".center(32), "0", "0", "0", "255", "0", "255", "italic")
+    print("It can display both foreground and background")
+    print("and also add formats".center(32))
+    print("Note that sometimes the background")
+    print("color blocks the foreground color")
+    _deco.print(_border)
+
+
+def _guide_theme() -> None:
+    _deco.print(_border)
+    print("Theme")
+    deadly = Theme("brightred", "double_underline", "bold")
+    deadly.print("Example use of Theme class")
+    print("It can be used for formats that you use many times")
+
+    deadly.add("strikethrough")
+    deadly.print("Example of add(*formats)")
+
+    deadly.remove("double_underline", "strikethrough")
+    deadly.print("Example of remove(*formats)")
+
+    deadly.overwrite("highlight_brightred", "underline")
+    deadly.print("Example of overwrite(*formats)")
+
+    deadly.showUsed()
+    print("showUsed() displays the current formats")
+    _deco.print(_border)
+
+
+def _guide_theme_rgbv() -> None:
+    _deco.print(_border)
+    print("ThemeRGBV")
+    classified = ThemeRGBV("255", "255", "255", "0", "0", "0", "")
+    classified.print("Example of printRGBV(r,g,b,r2,g2,b2,*formats)")
+    print("It can change both foreground and background")
+    print("and you can choose to use one or both")
+
+    classified.add("bold", "underline")
+    classified.print("Example of add(*formats)")
+
+    classified.remove("underline")
+    classified.print("Example of remove(*formats)")
+    print("Adding/removing only affects formats")
+
+    classified.overwrite("0", "0", "0", "255", "255", "255", "strikethrough")
+    classified.print("Example of overwrite(r,g,b,r2,g2,b2,*new)")
+    print("Overwrite rewrites the whole object")
+
+    classified.showUsed()
+    print("showUsed() displays the current settings")
+    _deco.print(_border)
+
+
+GUIDE: dict[str, Callable[[], None]] = {
+    "printColored": _guide_printColored,
+    "colorGen": _guide_colorGen,
+    "printl": _guide_printl,
+    "printRGB": _guide_printRGB,
+    "printRGBV": _guide_printRGBV,
+    "Theme": _guide_theme,
+    "ThemeRGBV": _guide_theme_rgbv,
+}
+
+
+def func_guide(selected_function: str | None = None) -> None:
+    if selected_function:
+        if selected_function in GUIDE:
+            GUIDE[selected_function]()
+        else:
+            raise ValueError(f"{selected_function} Not a valid guide section!")
+    else:
+        for section in GUIDE:
+            GUIDE[section]()
+        _deco.print(_border)
+        _deco2.print(_border)
+        print("Thanks for reading!")
         _deco2.print(_border)

{printcolored-2.1.1 → printcolored-2.2}/printcolored.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: printcolored
-Version: 2.1.1
+Version: 2.2
 Requires-Dist: platformdirs
 Provides-Extra: windows-legacy
 Requires-Dist: colorama; extra == "windows-legacy"

{printcolored-2.1.1 → printcolored-2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "printcolored"
-version = "2.1.1"
+version = "2.2"
 dependencies = ["platformdirs"]
 
 [project.optional-dependencies]

printcolored-2.1.1/printColored/Fonter.py

@@ -1,84 +0,0 @@
-"""
-credits to https://lingojam.com/FancyTextGenerator for all fonts
-"""
-#also note that sometimes some characters are displayed on the same 
-#place for example the W&O and H&E in the san_andreas font
-
-
-from random import *
-
-fonts = {
-    "original": ("a","b","c","d","e","f","g","h","i","j","k","l","m","n","o","p","q","r","s","t","u","v","w","x","y","z","A","B","C","D","E","F","G","H","I","J","K","L","M","N","O","P","Q","R","S","T","U","V","W","X","Y","Z"," ","0","1","2","3","4","5","6","7","8","9","!","$","%","&","'","(",")","*","+",",","-",".","/",":",";","<","=",">","?","@","[","\\","]","^","_","`","{","|","}","~"),
-    
-    "san_andreas":("𝔞","𝔟","𝔠","𝔡","𝔢","𝔣","𝔤","𝔥","𝔦","𝔧","𝔨","𝔩","𝔪","𝔫","𝔬","𝔭","𝔮","𝔯","𝔰","𝔱","𝔲","𝔳","𝔴","𝔵","𝔶","𝔷","𝔄","𝔅","ℭ","𝔇","𝔈","𝔉","𝔊","ℌ","ℑ","𝔍","𝔎","𝔏","𝔐","𝔑","𝔒","𝔓","𝔔","ℜ","𝔖","𝔗","𝔘","𝔙","𝔚","𝔛","𝔜","ℨ"," ","0","1","2","3","4","5","6","7","8","9","!","$","%","&","'","(",")","*","+",",","-",".","/",":",";","<","=",">","?","@","[","\\","]","^","_","`","{","|","}","~"),
-
-    "san_andreas_bold":("𝖆","𝖇","𝖈","𝖉","𝖊","𝖋","𝖌","𝖍","𝖎","𝖏","𝖐","𝖑","𝖒","𝖓","𝖔","𝖕","𝖖","𝖗","𝖘","𝖙","𝖚","𝖛","𝖜","𝖝","𝖞","𝖟","𝕬","𝕭","𝕮","𝕯","𝕰","𝕱","𝕲","𝕳","𝕴","𝕵","𝕶","𝕷","𝕸","𝕹","𝕺","𝕻","𝕼","𝕽","𝕾","𝕿","𝖀","𝖁","𝖂","𝖃","𝖄","𝖅"," ","0","1","2","3","4","5","6","7","8","9","!","$","%","&","'","(",")","*","+",",","-",".","/",":",";","<","=",">","?","@","[","\\","]","^","_","`","{","|","}","~"),
-
-    "fancy_bold": ("𝓪","𝓫","𝓬","𝓭","𝓮","𝓯","𝓰","𝓱","𝓲","𝓳","𝓴","𝓵","𝓶","𝓷","𝓸","𝓹","𝓺","𝓻","𝓼","𝓽","𝓾","𝓿","𝔀","𝔁","𝔂","𝔃","𝓐","𝓑","𝓒","𝓓","𝓔","𝓕","𝓖","𝓗","𝓘","𝓙","𝓚","𝓛","𝓜","𝓝","𝓞","𝓟","𝓠","𝓡","𝓢","𝓣","𝓤","𝓥","𝓦","𝓧","𝓨","𝓩"," ","0","1","2","3","4","5","6","7","8","9","!","$","%","&","'","(",")","*","+",",","-",".","/",":",";","<","=",">","?","@","[","\\","]","^","_","`","{","|","}","~"),
-
-    "fancy":("𝒶","𝒷","𝒸","𝒹","𝑒","𝒻","𝑔","𝒽","𝒾","𝒿","𝓀","𝓁","𝓂","𝓃","𝑜","𝓅","𝓆","𝓇","𝓈","𝓉","𝓊","𝓋","𝓌","𝓍","𝓎","𝓏","𝒜","𝐵","𝒞","𝒟","𝐸","𝐹","𝒢","𝐻","𝐼","𝒥","𝒦","𝐿","𝑀","𝒩","𝒪","𝒫","𝒬","𝑅","𝒮","𝒯","𝒰","𝒱","𝒲","𝒳","𝒴","𝒵"," ","𝟢","𝟣","𝟤","𝟥","𝟦","𝟧","𝟨","𝟩","𝟪","𝟫","!","$","%","&","'","(",")","*","+",",","-",".","/",":",";","<","=",">","?","@","[","\\","]","^","_","`","{","|","}","~"),
-
-    "hollow": ("𝕒","𝕓","𝕔","𝕕","𝕖","𝕗","𝕘","𝕙","𝕚","𝕛","𝕜","𝕝","𝕞","𝕟","𝕠","𝕡","𝕢","𝕣","𝕤","𝕥","𝕦","𝕧","𝕨","𝕩","𝕪","𝕫","𝔸","𝔹","ℂ","𝔻","𝔼","𝔽","𝔾","ℍ","𝕀","𝕁","𝕂","𝕃","𝕄","ℕ","𝕆","ℙ","ℚ","ℝ","𝕊","𝕋","𝕌","𝕍","𝕎","𝕏","𝕐","ℤ"," ","𝟘","𝟙","𝟚","𝟛","𝟜","𝟝","𝟞","𝟟","𝟠","𝟡","!","$","%","&","'","(",")","*","+",",","-",".","/",":",";","<","=",">","?","@","[","\\","]","^","_","`","{","|","}","~"),
-
-    "large": ("ａ","ｂ","ｃ","ｄ","ｅ","ｆ","ｇ","ｈ","ｉ","ｊ","ｋ","ｌ","ｍ","ｎ","ｏ","ｐ","ｑ","ｒ","ｓ","ｔ","ｕ","ｖ","ｗ","ｘ","ｙ","ｚ","Ａ","Ｂ","Ｃ","Ｄ","Ｅ","Ｆ","Ｇ","Ｈ","Ｉ","Ｊ","Ｋ","Ｌ","Ｍ","Ｎ","Ｏ","Ｐ","Ｑ","Ｒ","Ｓ","Ｔ","Ｕ","Ｖ","Ｗ","Ｘ","Ｙ","Ｚ"," ","０","１","２","３","４","５","６","７","８","９","！","＄","％","＆","＇","（","）","＊","＋",",","－","．","／","：","；","<","＝",">","？","＠","[","\\","]","^","_","`","{","|","}","~"),
-
-    "small": ("ᴀ","ʙ","ᴄ","ᴅ","ᴇ","ꜰ","ɢ","ʜ","ɪ","ᴊ","ᴋ","ʟ","ᴍ","ɴ","ᴏ","ᴘ","Q","ʀ","ꜱ","ᴛ","ᴜ","ᴠ","ᴡ","x","ʏ","ᴢ","ᴀ","ʙ","ᴄ","ᴅ","ᴇ","ꜰ","ɢ","ʜ","ɪ","ᴊ","ᴋ","ʟ","ᴍ","ɴ","ᴏ","ᴘ","Q","ʀ","ꜱ","ᴛ","ᴜ","ᴠ","ᴡ","x","ʏ","ᴢ"," ","0","1","2","3","4","5","6","7","8","9","!","$","%","&","'","(",")","*","+",",","-",".","/",":",";","<","=",">","?","@","[","\\","]","^","_","`","{","|","}","~"),
-
-    "chinese": ("ꍏ","ꌃ","ꉓ","ꀸ","ꍟ","ꎇ","ꁅ","ꃅ","ꀤ","ꀭ","ꀘ","꒒","ꂵ","ꈤ","ꂦ","ꉣ","ꆰ","ꋪ","ꌗ","꓄","ꀎ","ꃴ","ꅏ","ꊼ","ꌩ","ꁴ","ꍏ","ꌃ","ꉓ","ꀸ","ꍟ","ꎇ","ꁅ","ꃅ","ꀤ","ꀭ","ꀘ","꒒","ꂵ","ꈤ","ꂦ","ꉣ","ꆰ","ꋪ","ꌗ","꓄","ꀎ","ꃴ","ꅏ","ꊼ","ꌩ","ꁴ"," ","0","1","2","3","4","5","6","7","8","9","!","$","%","&","'","(",")","*","+",",","-",".","/",":",";","<","=",">","?","@","[","\\","]","^","_","`","{","|","}","~"),
-
-    "squared": ("🅰","🅱","🅲","🅳","🅴","🅵","🅶","🅷","🅸","🅹","🅺","🅻","🅼","🅽","🅾","🅿","🆀","🆁","🆂","🆃","🆄","🆅","🆆","🆇","🆈","🆉","🅰","🅱","🅲","🅳","🅴","🅵","🅶","🅷","🅸","🅹","🅺","🅻","🅼","🅽","🅾","🅿","🆀","🆁","🆂","🆃","🆄","🆅","🆆","🆇","🆈","🆉"," ","0","1","2","3","4","5","6","7","8","9","!","$","%","&","'","(",")","*","+",",","-",".","/",":",";","<","=",">","?","@","[","\\","]","^","_","`","{","|","}","~"),
-
-    "pointed": ("a͎","b͎","c͎","d͎","e͎","f͎","g͎","h͎","i͎","j͎","k͎","l͎","m͎","n͎","o͎","p͎","q͎","r͎","s͎","t͎","u͎","v͎","w͎","x͎","y͎","z͎","A͎","B͎","C͎","D͎","E͎","F͎","G͎","H͎","I͎","J͎","K͎","L͎","M͎","N͎","O͎","P͎","Q͎","R͎","S͎","T͎","U͎","V͎","W͎","X͎","Y͎","Z͎"," ͎","0͎","1͎","2͎","3͎","4͎","5͎","6͎","7͎","8͎","9͎","!͎","$͎","%͎","&͎",",","(͎",")͎","*͎","+͎",",","-͎",".͎","/͎",":͎",";͎","<͎","=͎",">͎","?͎","@͎","[͎","\͎","]͎","^͎","_͎","`͎","{͎","|͎","}͎","~͎"),
-
-    "power": ("ᵃ","ᵇ","ᶜ","ᵈ","ᵉ","ᶠ","ᵍ","ʰ","ⁱ","ʲ","ᵏ","ˡ","ᵐ","ⁿ","ᵒ","ᵖ","q","ʳ","ˢ","ᵗ","ᵘ","ᵛ","ʷ","ˣ","ʸ","ᶻ","ᴬ","ᴮ","ᶜ","ᴰ","ᴱ","ᶠ","ᴳ","ᴴ","ᴵ","ᴶ","ᴷ","ᴸ","ᴹ","ᴺ","ᴼ","ᴾ","Q","ᴿ","ˢ","ᵀ","ᵁ","ⱽ","ᵂ","ˣ","ʸ","ᶻ"," ","⁰","¹","²","³","⁴","⁵","⁶","⁷","⁸","⁹","!","$","%","&",",","⁽","⁾","*","⁺",",","⁻",".","/",":",";","<","⁼",">","?","@","[","\\","]","^","_","`","{","|","}","~"),
-
-    "weird": ("ᗩ","ᗷ","ᑕ","ᗪ","E","ᖴ","G","ᕼ","I","ᒍ","K","ᒪ","ᗰ","ᑎ","O","ᑭ","ᑫ","ᖇ","ᔕ","T","ᑌ","ᐯ","ᗯ","᙭","Y","ᘔ","ᗩ","ᗷ","ᑕ","ᗪ","E","ᖴ","G","ᕼ","I","ᒍ","K","ᒪ","ᗰ","ᑎ","O","ᑭ","ᑫ","ᖇ","ᔕ","T","ᑌ","ᐯ","ᗯ","᙭","Y","ᘔ"," ","0","1","2","3","4","5","6","7","8","9","!","$","%","&",",","(",")","*","+",",","-",".","/",":",";","<","=",">","?","@","[","\\","]","^","_","`","{","|","}","~"),
-
-    "weird2": ("ᗩ","ᗷ","ᑢ","ᕲ","ᘿ","ᖴ","ᘜ","ᕼ","ᓰ","ᒚ","ᖽᐸ","ᒪ","ᘻ","ᘉ","ᓍ","ᕵ","ᕴ","ᖇ","S","ᖶ","ᑘ","ᐺ","ᘺ","᙭","ᖻ","ᗱ","ᗩ","ᗷ","ᑢ","ᕲ","ᘿ","ᖴ","ᘜ","ᕼ","ᓰ","ᒚ","ᖽᐸ","ᒪ","ᘻ","ᘉ","ᓍ","ᕵ","ᕴ","ᖇ","S","ᖶ","ᑘ","ᐺ","ᘺ","᙭","ᖻ","ᗱ"," ","0","1","2","3","4","5","6","7","8","9","!","$","%","&",",","(",")","*","+",",","-",".","/",":",";","<","=",">","?","@","[","\\","]","^","_","`","{","|","}","~"),
-
-    "japanese":("卂","乃","匚","ᗪ","乇","千","Ꮆ","卄","丨","ﾌ","Ҝ","ㄥ","爪","几","ㄖ","卩","Ɋ","尺","丂","ㄒ","ㄩ","ᐯ","山","乂","ㄚ","乙","卂","乃","匚","ᗪ","乇","千","Ꮆ","卄","丨","ﾌ","Ҝ","ㄥ","爪","几","ㄖ","卩","Ɋ","尺","丂","ㄒ","ㄩ","ᐯ","山","乂","ㄚ","乙"," ","0","1","2","3","4","5","6","7","8","9","!","$","%","&",",","(",")","*","+",",","-",".","/",":",";","<","=",">","?","@","[","\\","]","^","_","`","{","|","}","~"),
-
-    "japanese2":("ﾑ","乃","ᄃ","り","乇","ｷ","ム","ん","ﾉ","ﾌ","ズ","ﾚ","ﾶ","刀","の","ｱ","ゐ","尺","丂","ｲ","ひ","√","W","ﾒ","ﾘ","乙","ﾑ","乃","ᄃ","り","乇","ｷ","ム","ん","ﾉ","ﾌ","ズ","ﾚ","ﾶ","刀","の","ｱ","ゐ","尺","丂","ｲ","ひ","√","W","ﾒ","ﾘ","乙"," ","0","1","2","3","4","5","6","7","8","9","!","$","%","&",",","(",")","*","+",",","-",".","/",":",";","<","=",">","?","@","[","\\","]","^","_","`","{","|","}","~"),
-
-
-
-
-}
-
-random_decorators = {
-    "chess": ("♔","♕","♖","♗","♘","♙","♚,","♛","♜","♝","♞","♟"),
-    "cards": ("♠","♡","♢","♣","♤","♥","♦","♧","☆","★")
-}
-
-decorators = {
-    "barrier": ("『","』"),
-    "barrier2": ("【","】"),
-    "notes": ("·.¸¸.·♩♪♫" , "♫♪♩·.¸¸.·"),
-    "single_notes": ("♪","♫"),
-    "transcending":("¸.-•~¹°”ˆ˜¨'" , "'¨˜ˆ”°¹~•-.¸"),
-    "star": (".•°¤*(¯`★´¯)*¤°", "°¤*(¯´★`¯)*¤°•."),
-    "curly": ("∙∙·▫▫ᵒᴼᵒ▫ₒₒ▫ᵒᴼᵒ▫ₒₒ▫ᵒᴼᵒ" , "ᵒᴼᵒ▫ₒₒ▫ᵒᴼᵒ▫ₒₒ▫ᵒᴼᵒ▫▫·∙∙"), # TOO DAMN LONG
-    "short_curly": ("·▫▫ᵒᴼᵒ▫ₒₒ" , "ₒₒ▫ᵒᴼᵒ▫▫·"), # better
-    "flower": ("◦•●◉✿", "✿◉●•◦"),
-    "dot": ("•´¯`•." , ".•´¯`•"),
-    "hearts": ("❥", "❣❤"),
-    "crystal": ("⧩⟡", "❖"),
-    "rifle": ("˜”*°•.˜”*°•","•°*”˜.•°*”˜"),
-    "short_rifle": ("˜”*°•.",".•°*”˜"),
-    "brackets": ("⦑", "⦒"),
-    "chess": (choice(random_decorators["chess"]), choice(random_decorators["chess"])),
-    "cards": (choice(random_decorators["cards"]), choice(random_decorators["cards"])),
-
-}
-
-
-
-def Fonter(text, font, decorator=""):
-    original = fonts["original"]
-    fontedtext = []
-    for letter in text:
-        fontedtext.append(fonts[font][original.index(letter)] if letter in original else letter)
-    result = "".join(fontedtext)
-    if decorator == "":
-        return result
-    return f"{decorators[decorator][0]}{result}{decorators[decorator][1]}"