printcolored 2.0__tar.gz → 2.1__tar.gz

printcolored-2.1/PKG-INFO

@@ -0,0 +1,4 @@
+Metadata-Version: 2.4
+Name: printcolored
+Version: 2.1
+Requires-Dist: platformdirs

{printcolored-2.0 → printcolored-2.1}/printColored/__init__.py

@@ -1,3 +1,5 @@
 from .core import printColored, colorGen, printl, printRGB, printRGBV, Theme, ThemeRGBV, formatfinder
+from .guide import func_guide
+from .display import display_formats
 
-__all__ = ["printColored", "colorGen", "printl", "printRGB", "printRGBV", "Theme", "ThemeRGBV", "formatfinder"]
+__all__ = ["printColored", "colorGen", "printl", "printRGB", "printRGBV", "Theme", "ThemeRGBV", "formatfinder", "func_guide", "display_formats"]

printcolored-2.1/printColored/__main__.py

@@ -0,0 +1,5 @@
+from .guide import func_guide
+
+if __name__ == '__main__':
+    func_guide()
+    

{printcolored-2.0 → printcolored-2.1}/printColored/core.py

@@ -11,17 +11,38 @@ except ImportError:
 
 
 from pathlib import Path
-from os.path import exists
 import json
+from platformdirs import user_config_dir
 
-script_dir = Path(__file__).parent
-path = script_dir / "custom.json"
-with open(path, "r") as file:
-    custom_formats = json.load(file)
+CONFIG_DIR = Path(user_config_dir("printColored"))
+CUSTOM_FORMATS_PATH = CONFIG_DIR / "custom.json"
+
+
+def load_custom_formats():
+    if CUSTOM_FORMATS_PATH.exists():
+        with open(CUSTOM_FORMATS_PATH, "r") as file:
+            return json.load(file)
+    return {}
+
+
+def save_custom_formats(formats):
+    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
+
+
+custom_formats = load_custom_formats()
 
 
 from . import Fonter
-from .formats import ansi_formats, html_colors
+from formats import ansi_formats, html_colors
 
 _default_source_order = ("ansi_format","rgb_format","custom_format")
 
@@ -71,8 +92,10 @@ def _build_code(*formats_used, html_view="", source_order=()):
     return ";".join(code_list)
 
 def _rgb_validation(r,g,b):
-    if r == "" or g == "" or b == "":
-        raise ValueError("You cant enter an empty value!")
+    if r == "" and g == "" and b == "":
+        return ""
+    elif r == "" or g == "" or b == "":
+        raise ValueError("One or more RGB values are missing!")
     elif not r.isdigit() or not g.isdigit() or not b.isdigit():
         raise ValueError("You cant enter a non-digit!")
     elif int(r) > 255 or int(r) < 0 or int(g) > 255 or int(g) < 0 or int(b) > 255 or int(b) < 0:
@@ -250,9 +273,15 @@ def formatfinder(min, max): # made this to find new formats, theres nothing beyo
     elif min == "font" or max == "font":
         for key, value in Fonter.fonts.items():
             print(f"{key}: {value}")
+    elif min == "decors" or max == "decors":
         for key, value in Fonter.decorators.items():
             print(f"{key}: {value}")
-    else:
+    elif min == "ansi_dict" or max == "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":
+        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":
+        for key, value in custom_formats.items():
+           print(f"\033[{value}m{key}\033[0m")

printcolored-2.1/printColored/display.py

@@ -0,0 +1,45 @@
+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]()

printcolored-2.1/printColored/guide.py

@@ -0,0 +1,134 @@
+from . import core as pc
+from .core import printColored, colorGen, printl, printRGB, printRGBV, Theme, ThemeRGBV
+
+_deco = pc.Theme("green", "bold")
+_deco2 = pc.Theme("bright_blue", "bold")
+_deco3 = pc.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!")
+        _deco2.print(_border)

printcolored-2.1/printcolored.egg-info/PKG-INFO

@@ -0,0 +1,4 @@
+Metadata-Version: 2.4
+Name: printcolored
+Version: 2.1
+Requires-Dist: platformdirs

{printcolored-2.0 → printcolored-2.1}/printcolored.egg-info/SOURCES.txt

@@ -3,8 +3,11 @@ printColored/Fonter.py
 printColored/__init__.py
 printColored/__main__.py
 printColored/core.py
+printColored/display.py
 printColored/formats.py
+printColored/guide.py
 printcolored.egg-info/PKG-INFO
 printcolored.egg-info/SOURCES.txt
 printcolored.egg-info/dependency_links.txt
+printcolored.egg-info/requires.txt
 printcolored.egg-info/top_level.txt

printcolored-2.1/printcolored.egg-info/requires.txt

@@ -0,0 +1 @@
+platformdirs

printcolored-2.1/pyproject.toml

@@ -0,0 +1,8 @@
+[project]
+name = "printcolored"
+version = "2.1"
+dependencies = ["platformdirs"]
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"

printcolored-2.0/PKG-INFO

@@ -1,3 +0,0 @@
-Metadata-Version: 2.4
-Name: printcolored
-Version: 2.0

printcolored-2.0/printColored/__main__.py

@@ -1,163 +0,0 @@
-from .core import *
-
-if __name__ == '__main__':
-    deco =  Theme("green", "bold")
-    deco2 = Theme("bright_blue", "bold")
-    deco3 = Theme("bright_yellow")
-    border = "--------------------------------"
-    deco.print(border)
-    
-    choice = True if input("Do you want to see all available formats?(Y/N): ").lower() == "y" else False
-    if choice:
-        print("All available formats:")
-        formatfinder(" "," ")
-
-    deco.print(border)
-    choice = True if input("Do you want to see all existing formats in range 1-107?(Y/N): ").lower() == "y" else False
-    if choice:    
-        print("All possible formats in range of 1-107:")
-        formatfinder("1","107")
-    
-    deco.print(border)
-    choice = True if input("Do you want to see all Fonter and decorators in the extra file?(Y/N): ").lower() == "y" else False
-    if choice:    
-        print("All Fonter + decorators available:")
-        formatfinder(" ","font")
-
-    deco.print(border)
-    
-    deco2.print(border)
-    print("Guide for using the functions:")
-    deco2.print(border)
-
-    # main functions:
-    
-    # printColored()
-    deco.print(border)
-    print("Page 1:")
-    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)
-    input("Press enter to continue...")
-
-    
-    # colorGen()
-    deco.print(border)
-    print("Page 2:")
-    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)
-    input("Press enter to continue...")
-
-
-    # printl()
-    deco.print(border)
-    print("Page 3:")
-    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)
-    input("Press enter to continue...")
-
-    # printRGB()
-    deco.print(border)
-    print("Page 4:")
-    printRGB("Example use of printRGB()".center(32), "255", "0", "255", "bold"," ")
-    printRGB("Example 2 of printRGB()".center(32), "0", "255", "255", "","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)
-    input("Press enter to continue...")
-
-    
-    # printRGBV()
-    deco.print(border)
-    print("Page 5:")
-    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)
-    input("Press enter to continue...")
-
-    
-    # Theme
-    deco.print(border)
-    print("Page 6:")
-    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)
-    input("Press enter to continue...")
-
-    
-    # ThemeRGBV
-    deco.print(border)
-    print("Page 7:")
-    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)
-    input("Press enter to continue...")
-
-
-    deco.print(border)
-    deco2.print(border)
-    print("Thanks for reading!")
-    deco2.print(border)
-
-    deco3.print(border)
-    print("BONUS: Custom formats using either ANSI or RGB")
-    key = "placeholder"
-    while key.lower() != "_exit_":
-        key = input("Enter new key (_exit_ to leave): ")
-        if key.lower() != "_exit_":
-            custom_formats[key] = input(f"Enter a value for {key}: ")
-            while custom_formats[key].replace(";", "").isdigit() == False:
-                print("Invalid code!")
-                print("The code must have digits only (; is an exception)")
-                custom_formats[key] = input(f"Enter a value for {key}: ")
-        else:
-            break
-    with open("custom.json", "w") as file:
-        json.dump(custom_formats, file, indent=4)
-    deco3.print(border)

printcolored-2.0/printcolored.egg-info/PKG-INFO

@@ -1,3 +0,0 @@
-Metadata-Version: 2.4
-Name: printcolored
-Version: 2.0

printcolored-2.0/pyproject.toml

@@ -1,7 +0,0 @@
-[project]
-name = "printcolored"
-version = "2.0"
-
-[build-system]
-requires = ["setuptools"]
-build-backend = "setuptools.build_meta"