StyleUpText 0.1.0__tar.gz

styleuptext-0.1.0/LICENSE

@@ -0,0 +1,33 @@
+Aplexon StyleUpText Non-Commercial & Revocable License Agreement
+
+Copyright (c) 2026 Arin Singla (aplexon.com). All rights reserved.
+
+1. PERMITTED USES (NON-COMMERCIAL)
+The Licensor (Arin Singla) hereby grants you a personal, non-exclusive, 
+non-transferable, and revocable license to use, modify, and distribute 
+this software ("StyleUpText") solely for personal, educational, or 
+non-commercial open-source research purposes.
+
+2. COMMERCIAL RESTRICTIONS
+You may NOT use this software, or any software derived from it, for any 
+commercial purpose, commercial venture, or business operations without 
+obtaining a separate, written commercial license agreement from the 
+Licensor. "Commercial purpose" includes, but is not limited to, using 
+the software in internal business tools, customer-facing applications, 
+paid services, or inside any software that generates revenue.
+
+3. REVOCATION OF LICENSE
+The Licensor reserves the right, at their sole discretion, to terminate or 
+revoke this license and any permissions granted under it at any time, with 
+or without cause, and without prior notice. Upon revocation, you must 
+immediately cease all use, modification, and distribution of the software 
+and destroy all copies in your possession.
+
+4. LIMITATION OF LIABILITY
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR 
+ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE 
+OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+For commercial licensing inquiries, please contact: contactarin@aplexon.com

styleuptext-0.1.0/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: StyleUpText
+Version: 0.1.0
+Summary: The best method to style text. Better than Rich + colorama
+Author-email: Arin Singla <contactarin@aplexon.com>
+License-Expression: LicenseRef-Proprietary
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyfiglet>=1.0.2
+Dynamic: license-file
+
+# 🎨 StyleUpText
+
+A high-performance, lightweight terminal text-styling engine that gives you pinpoint precision over your console typography. 
+
+**StyleUpText** bridges the gap between competing CLI packages: it lets you change terminal colors instantly using real **Hex codes** and **24-bit Truecolor RGB**, while utilizing lightweight **BBCode tags** exclusively for text formatting (bold, italic, etc.) without the parsing overhead of heavier frameworks. Brought to you by [Aplexon](https://aplexon.com).
+
+---
+
+## 🚀 Key Advantages
+
+*   **True Color Freedom:** Supports any Hex code (`#C42D76`) or RGB tuple directly. You are never restricted to primitive 8-color console palettes.
+*   **Decoupled Architecture:** Colors are handled dynamically via execution functions, while text styles use clean BBCode tags (`[b]`, `[i]`, `[u]`, `[s]`). 
+*   **Zero-Dependency Color Layer:** The color engine uses raw ANSI streams, ensuring lightweight deployment with zero background parsing overhead.
+
+---
+
+## 🛠️ Installation
+
+Install the package directly via pip:
+
+```bash
+pip install StyleUpText
+```
+
+---
+
+## 💻 Usage Examples
+
+### 1. Hex & RGB Color Control (`color.py`)
+Import the color sub-module to print precise truecolor lines or lock your terminal brush to a specific palette.
+
+```python
+from StyleUpText import color
+
+# Print a specific line instantly using a hex code
+color.Print_Line_Color_HEX("#C42D76", "This text is raspberry pink!")
+
+# Lock the foreground color using RGB, print text, and reset
+color.Color_RGB(196, 45, 118)
+print("All of this text will render custom colored until reset...")
+color.Reset_Color()
+
+# Use built-in crisp presets
+color.Print_Line_Color_RGB(3, 194, 252, "Built-in alternative line helper.")
+color.Color("cyan", "Or print a preset line easily!")
+```
+
+### 2. BBCode Formatting (`style.py`)
+Format your copy cleanly using semantic layout markers. Tags can be combined natively.
+
+```python
+from StyleUpText import style
+
+# Format styles using lightweight structural tags
+style.StylePrint("This is [b]bold[/b], this is [i]italic[/i], and this is [u]underlined[/u]!")
+style.StylePrint("You can also apply [s]strikethrough text[/s] effortlessly.")
+```
+
+### 3. Decorative Big ASCII Typography
+Render block headers using bundled typography matrices:
+
+```python
+from StyleUpText import style
+
+# Print a styled headline banner
+style.printFont("APLEXON", "slant")
+```
+
+---
+
+## 🛠️ Built-in Terminal Commands
+
+When you install **StyleUpText**, it automatically binds a native command directly to your machine's environment path. 
+
+### Find Pyfiglet Fonts
+Search through over 570+ stylized block fonts directly inside your workspace shell:
+
+```bash
+search-fonts <keyword>
+```
+*Example:* `search-fonts slant` will look up every accessible typography structure variation containing that name string.
+
+---
+
+## 📂 Project Directory Structure
+
+Ensure your local production folder matches this tree layout:
+
+```text
+StyleUpText_Project/
+├── pyproject.toml             # Configuration, dependencies, and shell scripts
+├── README.md                  # This documentation manual
+└── src/
+    └── StyleUpText/             # Main distribution workspace module
+        ├── __init__.py        # Exports package layout functions cleanly
+        ├── color.py           # Hex, RGB, and palette engine
+        └── style.py           # BBCode processing and ASCII typography
+```
+
+### Exposing Functions via `__init__.py`
+To achieve the clean imports shown in the examples, place the following exposure declarations inside `src/StyleUpText/__init__.py`:
+
+```python
+from . import color
+from . import style
+```
+
+---
+
+## 🤝 Contributing & Support
+
+This engine is actively maintained by **Arin** ([contactarin@aplexon.com](mailto:contactarin@aplexon.com)). For feature requests or project portfolios, visit [aplexon.com](https://aplexon.com).
+
+**License:** Aplexon StyleUpText Non-Commercial & Revocable License Agreement. Free for personal use. To use it commercially you must get a license for free by asking **Arin** at ([contactarin@aplexon.com](mailto:contactarin@aplexon.com)). __**This software license is revokable.**__

styleuptext-0.1.0/README.md

@@ -0,0 +1,114 @@
+# 🎨 StyleUpText
+
+A high-performance, lightweight terminal text-styling engine that gives you pinpoint precision over your console typography. 
+
+**StyleUpText** bridges the gap between competing CLI packages: it lets you change terminal colors instantly using real **Hex codes** and **24-bit Truecolor RGB**, while utilizing lightweight **BBCode tags** exclusively for text formatting (bold, italic, etc.) without the parsing overhead of heavier frameworks. Brought to you by [Aplexon](https://aplexon.com).
+
+---
+
+## 🚀 Key Advantages
+
+*   **True Color Freedom:** Supports any Hex code (`#C42D76`) or RGB tuple directly. You are never restricted to primitive 8-color console palettes.
+*   **Decoupled Architecture:** Colors are handled dynamically via execution functions, while text styles use clean BBCode tags (`[b]`, `[i]`, `[u]`, `[s]`). 
+*   **Zero-Dependency Color Layer:** The color engine uses raw ANSI streams, ensuring lightweight deployment with zero background parsing overhead.
+
+---
+
+## 🛠️ Installation
+
+Install the package directly via pip:
+
+```bash
+pip install StyleUpText
+```
+
+---
+
+## 💻 Usage Examples
+
+### 1. Hex & RGB Color Control (`color.py`)
+Import the color sub-module to print precise truecolor lines or lock your terminal brush to a specific palette.
+
+```python
+from StyleUpText import color
+
+# Print a specific line instantly using a hex code
+color.Print_Line_Color_HEX("#C42D76", "This text is raspberry pink!")
+
+# Lock the foreground color using RGB, print text, and reset
+color.Color_RGB(196, 45, 118)
+print("All of this text will render custom colored until reset...")
+color.Reset_Color()
+
+# Use built-in crisp presets
+color.Print_Line_Color_RGB(3, 194, 252, "Built-in alternative line helper.")
+color.Color("cyan", "Or print a preset line easily!")
+```
+
+### 2. BBCode Formatting (`style.py`)
+Format your copy cleanly using semantic layout markers. Tags can be combined natively.
+
+```python
+from StyleUpText import style
+
+# Format styles using lightweight structural tags
+style.StylePrint("This is [b]bold[/b], this is [i]italic[/i], and this is [u]underlined[/u]!")
+style.StylePrint("You can also apply [s]strikethrough text[/s] effortlessly.")
+```
+
+### 3. Decorative Big ASCII Typography
+Render block headers using bundled typography matrices:
+
+```python
+from StyleUpText import style
+
+# Print a styled headline banner
+style.printFont("APLEXON", "slant")
+```
+
+---
+
+## 🛠️ Built-in Terminal Commands
+
+When you install **StyleUpText**, it automatically binds a native command directly to your machine's environment path. 
+
+### Find Pyfiglet Fonts
+Search through over 570+ stylized block fonts directly inside your workspace shell:
+
+```bash
+search-fonts <keyword>
+```
+*Example:* `search-fonts slant` will look up every accessible typography structure variation containing that name string.
+
+---
+
+## 📂 Project Directory Structure
+
+Ensure your local production folder matches this tree layout:
+
+```text
+StyleUpText_Project/
+├── pyproject.toml             # Configuration, dependencies, and shell scripts
+├── README.md                  # This documentation manual
+└── src/
+    └── StyleUpText/             # Main distribution workspace module
+        ├── __init__.py        # Exports package layout functions cleanly
+        ├── color.py           # Hex, RGB, and palette engine
+        └── style.py           # BBCode processing and ASCII typography
+```
+
+### Exposing Functions via `__init__.py`
+To achieve the clean imports shown in the examples, place the following exposure declarations inside `src/StyleUpText/__init__.py`:
+
+```python
+from . import color
+from . import style
+```
+
+---
+
+## 🤝 Contributing & Support
+
+This engine is actively maintained by **Arin** ([contactarin@aplexon.com](mailto:contactarin@aplexon.com)). For feature requests or project portfolios, visit [aplexon.com](https://aplexon.com).
+
+**License:** Aplexon StyleUpText Non-Commercial & Revocable License Agreement. Free for personal use. To use it commercially you must get a license for free by asking **Arin** at ([contactarin@aplexon.com](mailto:contactarin@aplexon.com)). __**This software license is revokable.**__

styleuptext-0.1.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "StyleUpText"
+version = "0.1.0"
+description = "The best method to style text. Better than Rich + colorama"
+readme = "README.md"
+requires-python = ">=3.8"
+license = "LicenseRef-Proprietary"
+license-files = ["LICENSE"]
+
+authors = [
+    { name = "Arin Singla", email = "contactarin@aplexon.com" }
+]
+
+
+dependencies = [
+    "pyfiglet>=1.0.2",
+]
+
+[project.scripts]
+search-fonts = "TextStyle.style:SearchFonts"

styleuptext-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

styleuptext-0.1.0/src/StyleUpText/color.py

@@ -0,0 +1,75 @@
+reset = "\033[0m"
+def hex_to_rgb(hex_str):
+    # Remove the '#' if it's present
+    hex_str = hex_str.lstrip('#')
+    
+    # Convert each 2-character pair from hex (base 16) to decimal
+    return tuple(int(hex_str[i:i+2], 16) for i in (0, 2, 4))
+
+def Color_RGB(r, g, b):
+    print(f"\033[38;2;{r};{g};{b}m",end='')
+
+def Color_HEX(hex):
+    new_rgb = hex_to_rgb(hex)
+    print(f"\033[38;2;{new_rgb[0]};{new_rgb[1]};{new_rgb[2]}m",end='')
+
+def Reset_Color():
+    print(reset)
+
+def Print_Line_Color_HEX(hex, text):
+    new_rgb = hex_to_rgb(hex)
+    print(f"\033[38;2;{new_rgb[0]};{new_rgb[1]};{new_rgb[2]}m{text}{reset}")
+
+def Print_Line_Color_RGB(r,g,b, text):
+    print(f"\033[38;2;{r};{g};{b}m{text}{reset}")
+
+def Color(coltemp):
+    col = coltemp.strip().lower()
+    if col == 'red':
+        print("\033[38;2;252;3;3m",end='')
+    elif col == 'orange':
+        print("\033[38;2;252;119;3m",end='')
+    elif col == 'yellow':
+        print("\033[38;2;252;232;3m",end='')
+    elif col == 'green':
+        print("\033[38;2;3;252;3m",end='')
+    elif col == 'cyan':
+        print("\033[38;2;3;194;252m",end='')
+    elif col == 'blue':
+        print("\033[38;2;3;74;252m",end='')
+    elif col == 'violet':
+        print("\033[38;2;119;3;252m",end='')
+    elif col == 'magenta':
+        print("\033[38;2;252;3;169m",end='')
+    else:
+        print(f"\033[38;2;252;3;3mThat is not a predefined color.{reset}")
+        return False
+
+def Print_Line_Color(coltemp,text):
+    col = coltemp.strip().lower()
+    if col == 'red':
+        print(f"\033[38;2;252;3;3m{text}{reset}")
+    elif col == 'orange':
+        print(f"\033[38;2;252;119;3m{text}{reset}")
+    elif col == 'yellow':
+        print(f"\033[38;2;252;232;3m{text}{reset}")
+    elif col == 'green':
+        print(f"\033[38;2;3;252;3m{text}{reset}")
+    elif col == 'cyan':
+        print(f"\033[38;2;3;194;252m{text}{reset}")
+    elif col == 'blue':
+        print(f"\033[38;2;3;74;252m{text}{reset}")
+    elif col == 'violet':
+        print(f"\033[38;2;119;3;252m{text}{reset}")
+    elif col == 'magenta':
+        print(f"\033[38;2;252;3;169m{text}{reset}")
+    else:
+        print(f"\033[38;2;252;3;3mThat is not a predefined color.{reset}")
+        return False
+
+    
+    
+
+
+    
+

styleuptext-0.1.0/src/StyleUpText/style.py

@@ -0,0 +1,49 @@
+import re
+import sys
+import pyfiglet
+def StylePrint(text):
+    # Map BBCode tags to ANSI opening and closing sequences
+    replacements = {
+        r'\[b\]': '\033[1m',  r'\[/b\]': '\033[22m', # 22 resets bold
+        r'\[i\]': '\033[3m',  r'\[/i\]': '\033[23m', # 23 resets italic
+        r'\[u\]': '\033[4m',  r'\[/u\]': '\033[24m', # 24 resets underline
+        r'\[s\]': '\033[9m',  r'\[/s\]': '\033[29m', # 29 resets strikethrough
+    }
+    
+    # Process the text and replace tags
+    for tag, ansi in replacements.items():
+        text = re.sub(tag, ansi, text)
+        
+    # Append a global reset (\033[0m) at the end just to be safe
+    print(text + '\033[0m')
+
+def printFont(text, fontx):
+    ascii_font = pyfiglet.figlet_format(text, font=fontx)
+    print(ascii_font)
+
+def SearchFonts():
+    # 1. Grab all 570+ available font strings
+    all_fonts = pyfiglet.FigletFont.getFonts()
+    
+    # 2. Check if the user passed a search keyword argument
+    if len(sys.argv) < 2:
+        print("\033[91m⚠️ Error: Please provide a search term.\033[0m")
+        print("Usage: figlet-find <keyword>")
+        sys.exit(1)
+        
+    keyword = sys.argv[1].lower()
+    
+    # 3. Filter the font list
+    matches = [font for font in all_fonts if keyword in font.lower()]
+    
+    # 4. Display the results cleanly
+    print(f"\n🔍 Searching for pyfiglet fonts containing: '\033[95m{keyword}\033[0m'")
+    print("─" * 50)
+    
+    if not matches:
+        print("❌ No matching fonts found.")
+    else:
+        print(f"✅ Found {len(matches)} matching fonts:")
+        for font in matches:
+            print(f" • {font}")
+    print("─" * 50 + "\n")

styleuptext-0.1.0/src/StyleUpText.egg-info/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: StyleUpText
+Version: 0.1.0
+Summary: The best method to style text. Better than Rich + colorama
+Author-email: Arin Singla <contactarin@aplexon.com>
+License-Expression: LicenseRef-Proprietary
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyfiglet>=1.0.2
+Dynamic: license-file
+
+# 🎨 StyleUpText
+
+A high-performance, lightweight terminal text-styling engine that gives you pinpoint precision over your console typography. 
+
+**StyleUpText** bridges the gap between competing CLI packages: it lets you change terminal colors instantly using real **Hex codes** and **24-bit Truecolor RGB**, while utilizing lightweight **BBCode tags** exclusively for text formatting (bold, italic, etc.) without the parsing overhead of heavier frameworks. Brought to you by [Aplexon](https://aplexon.com).
+
+---
+
+## 🚀 Key Advantages
+
+*   **True Color Freedom:** Supports any Hex code (`#C42D76`) or RGB tuple directly. You are never restricted to primitive 8-color console palettes.
+*   **Decoupled Architecture:** Colors are handled dynamically via execution functions, while text styles use clean BBCode tags (`[b]`, `[i]`, `[u]`, `[s]`). 
+*   **Zero-Dependency Color Layer:** The color engine uses raw ANSI streams, ensuring lightweight deployment with zero background parsing overhead.
+
+---
+
+## 🛠️ Installation
+
+Install the package directly via pip:
+
+```bash
+pip install StyleUpText
+```
+
+---
+
+## 💻 Usage Examples
+
+### 1. Hex & RGB Color Control (`color.py`)
+Import the color sub-module to print precise truecolor lines or lock your terminal brush to a specific palette.
+
+```python
+from StyleUpText import color
+
+# Print a specific line instantly using a hex code
+color.Print_Line_Color_HEX("#C42D76", "This text is raspberry pink!")
+
+# Lock the foreground color using RGB, print text, and reset
+color.Color_RGB(196, 45, 118)
+print("All of this text will render custom colored until reset...")
+color.Reset_Color()
+
+# Use built-in crisp presets
+color.Print_Line_Color_RGB(3, 194, 252, "Built-in alternative line helper.")
+color.Color("cyan", "Or print a preset line easily!")
+```
+
+### 2. BBCode Formatting (`style.py`)
+Format your copy cleanly using semantic layout markers. Tags can be combined natively.
+
+```python
+from StyleUpText import style
+
+# Format styles using lightweight structural tags
+style.StylePrint("This is [b]bold[/b], this is [i]italic[/i], and this is [u]underlined[/u]!")
+style.StylePrint("You can also apply [s]strikethrough text[/s] effortlessly.")
+```
+
+### 3. Decorative Big ASCII Typography
+Render block headers using bundled typography matrices:
+
+```python
+from StyleUpText import style
+
+# Print a styled headline banner
+style.printFont("APLEXON", "slant")
+```
+
+---
+
+## 🛠️ Built-in Terminal Commands
+
+When you install **StyleUpText**, it automatically binds a native command directly to your machine's environment path. 
+
+### Find Pyfiglet Fonts
+Search through over 570+ stylized block fonts directly inside your workspace shell:
+
+```bash
+search-fonts <keyword>
+```
+*Example:* `search-fonts slant` will look up every accessible typography structure variation containing that name string.
+
+---
+
+## 📂 Project Directory Structure
+
+Ensure your local production folder matches this tree layout:
+
+```text
+StyleUpText_Project/
+├── pyproject.toml             # Configuration, dependencies, and shell scripts
+├── README.md                  # This documentation manual
+└── src/
+    └── StyleUpText/             # Main distribution workspace module
+        ├── __init__.py        # Exports package layout functions cleanly
+        ├── color.py           # Hex, RGB, and palette engine
+        └── style.py           # BBCode processing and ASCII typography
+```
+
+### Exposing Functions via `__init__.py`
+To achieve the clean imports shown in the examples, place the following exposure declarations inside `src/StyleUpText/__init__.py`:
+
+```python
+from . import color
+from . import style
+```
+
+---
+
+## 🤝 Contributing & Support
+
+This engine is actively maintained by **Arin** ([contactarin@aplexon.com](mailto:contactarin@aplexon.com)). For feature requests or project portfolios, visit [aplexon.com](https://aplexon.com).
+
+**License:** Aplexon StyleUpText Non-Commercial & Revocable License Agreement. Free for personal use. To use it commercially you must get a license for free by asking **Arin** at ([contactarin@aplexon.com](mailto:contactarin@aplexon.com)). __**This software license is revokable.**__

styleuptext-0.1.0/src/StyleUpText.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+src/StyleUpText/__init__.py
+src/StyleUpText/color.py
+src/StyleUpText/style.py
+src/StyleUpText.egg-info/PKG-INFO
+src/StyleUpText.egg-info/SOURCES.txt
+src/StyleUpText.egg-info/dependency_links.txt
+src/StyleUpText.egg-info/entry_points.txt
+src/StyleUpText.egg-info/requires.txt
+src/StyleUpText.egg-info/top_level.txt

styleuptext-0.1.0/src/StyleUpText.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

styleuptext-0.1.0/src/StyleUpText.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+search-fonts = TextStyle.style:SearchFonts

styleuptext-0.1.0/src/StyleUpText.egg-info/requires.txt

@@ -0,0 +1 @@
+pyfiglet>=1.0.2

styleuptext-0.1.0/src/StyleUpText.egg-info/top_level.txt

@@ -0,0 +1 @@
+StyleUpText