yet-another-ansi-lib 0.1.0__tar.gz

yet_another_ansi_lib-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 robert-ish
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 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.

yet_another_ansi_lib-0.1.0/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: yet-another-ansi-lib
+Version: 0.1.0
+Summary: Cool ANSI styling!
+Author: robert-ish
+License: MIT
+Project-URL: Homepage, https://github.com/robert-ish/yet-another-ansi-lib
+Project-URL: Repository, https://github.com/robert-ish/yet-another-ansi-lib
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# yet-another-ansi-lib
+Zero-dependency ANSI colors and styles for Python.
+
+## Installation:
+```bash
+pip install yet-another-ansi-lib
+```
+
+## Usage:
+```python
+from yet_another_ansi_lib import ansi
+ansi = ansi()
+print(ansi.red("Hello world!"))
+```
+you can even do:
+```python
+from yet_another_ansi_lib import ansi
+ansi = ansi()
+with ansi.styleman('bold', 'red'):
+    print('Hello world!')
+```
+
+## License:
+MIT.

yet_another_ansi_lib-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "yet-another-ansi-lib"
+version = "0.1.0"
+description = "Cool ANSI styling!"
+readme = "readme.md"
+authors = [
+    {name = "robert-ish"},
+]
+license = {text = "MIT"}
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+requires-python = ">=3.8"
+dependencies = [
+    # List your dependencies here, e.g.:
+    # "requests>=2.28",
+]
+
+[project.urls]
+Homepage = "https://github.com/robert-ish/yet-another-ansi-lib"
+Repository = "https://github.com/robert-ish/yet-another-ansi-lib"

yet_another_ansi_lib-0.1.0/readme.md

@@ -0,0 +1,24 @@
+# yet-another-ansi-lib
+Zero-dependency ANSI colors and styles for Python.
+
+## Installation:
+```bash
+pip install yet-another-ansi-lib
+```
+
+## Usage:
+```python
+from yet_another_ansi_lib import ansi
+ansi = ansi()
+print(ansi.red("Hello world!"))
+```
+you can even do:
+```python
+from yet_another_ansi_lib import ansi
+ansi = ansi()
+with ansi.styleman('bold', 'red'):
+    print('Hello world!')
+```
+
+## License:
+MIT.

yet_another_ansi_lib-0.1.0/setup.cfg

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

yet_another_ansi_lib-0.1.0/yet_another_ansi_lib/__init__.py

@@ -0,0 +1,303 @@
+from contextlib import contextmanager
+import sys
+
+class ansi:
+    """
+    Provides ANSI escape codes for coloring and styling text in terminal output.
+
+    All methods return a string with the appropriate escape sequences applied.
+    By default, each styled string is automatically terminated with a reset code
+    (\\033[0m) unless it already ends with one.
+    """
+
+    ANSI_CODES = {
+    # Foreground colors
+    'black': 30,
+    'red': 31,
+    'green': 32,
+    'yellow': 33,
+    'blue': 34,
+    'purple': 35,
+    'cyan': 36,
+    'white': 37,
+
+    # Text styles
+    'bold': 1,
+    'underline': 4,
+    'italic': 3,
+    'strikethrough': 9,
+    'blink': 5,
+    'reverse': 7,
+    'hidden': 8,
+    'dim': 2,
+
+    # Background colors
+    'bg_black': 40,
+    'bg_red': 41,
+    'bg_green': 42,
+    'bg_yellow': 43,
+    'bg_blue': 44,
+    'bg_purple': 45,
+    'bg_cyan': 46,
+    'bg_white': 47,
+
+    # High-intensity foreground
+    'intense_black': 90,
+    'intense_red': 91,
+    'intense_green': 92,
+    'intense_yellow': 93,
+    'intense_blue': 94,
+    'intense_purple': 95,
+    'intense_cyan': 96,
+    'intense_white': 97,
+
+    # High-intensity background
+    'bg_intense_black': 100,
+    'bg_intense_red': 101,
+    'bg_intense_green': 102,
+    'bg_intense_yellow': 103,
+    'bg_intense_blue': 104,
+    'bg_intense_purple': 105,
+    'bg_intense_cyan': 106,
+    'bg_intense_white': 107,
+    }
+
+    # ---------- Foreground colors ----------
+    def black(self, text):
+        """Return text colored black (foreground code 30)."""
+        return self.apply_codes(text, [30])
+
+    def red(self, text):
+        """Return text colored red (foreground code 31)."""
+        return self.apply_codes(text, [31])
+
+    def green(self, text):
+        """Return text colored green (foreground code 32)."""
+        return self.apply_codes(text, [32])
+
+    def yellow(self, text):
+        """Return text colored yellow (foreground code 33)."""
+        return self.apply_codes(text, [33])
+
+    def blue(self, text):
+        """Return text colored blue (foreground code 34)."""
+        return self.apply_codes(text, [34])
+
+    def purple(self, text):
+        """Return text colored purple (foreground code 35)."""
+        return self.apply_codes(text, [35])
+
+    def cyan(self, text):
+        """Return text colored cyan (foreground code 36)."""
+        return self.apply_codes(text, [36])
+
+    def white(self, text):
+        """Return text colored white (foreground code 37)."""
+        return self.apply_codes(text, [37])
+
+    # ---------- Text styles ----------
+    def bold(self, text):
+        """Return bold text (code 1)."""
+        return self.apply_codes(text, [1])
+
+    def underline(self, text):
+        """Return underlined text (code 4)."""
+        return self.apply_codes(text, [4])
+
+    def italic(self, text):
+        """Return italic text (code 3)."""
+        return self.apply_codes(text, [3])
+
+    def strikethrough(self, text):
+        """Return text with a strikethrough line (code 9)."""
+        return self.apply_codes(text, [9])
+
+    # ---------- Background colors ----------
+    def bg_black(self, text):
+        """Return text with black background (code 40)."""
+        return self.apply_codes(text, [40])
+
+    def bg_red(self, text):
+        """Return text with red background (code 41)."""
+        return self.apply_codes(text, [41])
+
+    def bg_green(self, text):
+        """Return text with green background (code 42)."""
+        return self.apply_codes(text, [42])
+
+    def bg_yellow(self, text):
+        """Return text with yellow background (code 43)."""
+        return self.apply_codes(text, [43])
+
+    def bg_blue(self, text):
+        """Return text with blue background (code 44)."""
+        return self.apply_codes(text, [44])
+
+    def bg_purple(self, text):
+        """Return text with purple background (code 45)."""
+        return self.apply_codes(text, [45])
+
+    def bg_cyan(self, text):
+        """Return text with cyan background (code 46)."""
+        return self.apply_codes(text, [46])
+
+    def bg_white(self, text):
+        """Return text with white background (code 47)."""
+        return self.apply_codes(text, [47])
+
+    # ---------- High-intensity foreground colors ----------
+    def intense_black(self, text):
+        """Return text in high‑intensity black (code 90)."""
+        return self.apply_codes(text, [90])
+
+    def intense_red(self, text):
+        """Return text in high‑intensity red (code 91)."""
+        return self.apply_codes(text, [91])
+
+    def intense_green(self, text):
+        """Return text in high‑intensity green (code 92)."""
+        return self.apply_codes(text, [92])
+
+    def intense_yellow(self, text):
+        """Return text in high‑intensity yellow (code 93)."""
+        return self.apply_codes(text, [93])
+
+    def intense_blue(self, text):
+        """Return text in high‑intensity blue (code 94)."""
+        return self.apply_codes(text, [94])
+
+    def intense_purple(self, text):
+        """Return text in high‑intensity purple (code 95)."""
+        return self.apply_codes(text, [95])
+
+    def intense_cyan(self, text):
+        """Return text in high‑intensity cyan (code 96)."""
+        return self.apply_codes(text, [96])
+
+    def intense_white(self, text):
+        """Return text in high‑intensity white (code 97)."""
+        return self.apply_codes(text, [97])
+
+    # ---------- High-intensity background colors ----------
+    def bg_intense_black(self, text):
+        """Return text with high‑intensity black background (code 100)."""
+        return self.apply_codes(text, [100])
+
+    def bg_intense_red(self, text):
+        """Return text with high‑intensity red background (code 101)."""
+        return self.apply_codes(text, [101])
+
+    def bg_intense_green(self, text):
+        """Return text with high‑intensity green background (code 102)."""
+        return self.apply_codes(text, [102])
+
+    def bg_intense_yellow(self, text):
+        """Return text with high‑intensity yellow background (code 103)."""
+        return self.apply_codes(text, [103])
+
+    def bg_intense_blue(self, text):
+        """Return text with high‑intensity blue background (code 104)."""
+        return self.apply_codes(text, [104])
+
+    def bg_intense_purple(self, text):
+        """Return text with high‑intensity purple background (code 105)."""
+        return self.apply_codes(text, [105])
+
+    def bg_intense_cyan(self, text):
+        """Return text with high‑intensity cyan background (code 106)."""
+        return self.apply_codes(text, [106])
+
+    def bg_intense_white(self, text):
+        """Return text with high‑intensity white background (code 107)."""
+        return self.apply_codes(text, [107])
+
+    # ---------- Other effects ----------
+    def blink(self, text):
+        """Return blinking text (code 5)."""
+        return self.apply_codes(text, [5])
+
+    def reverse(self, text):
+        """Return text with foreground and background colors swapped (code 7)."""
+        return self.apply_codes(text, [7])
+
+    def hidden(self, text):
+        """Return invisible/hidden text (code 8)."""
+        return self.apply_codes(text, [8])
+
+    def dim(self, text):
+        """Return text with reduced intensity (low intensity)."""
+        return self.apply_codes(text, [2])
+
+    # ---------- Truecolor ----------
+
+    def rgb(self, r, g, b, text):
+        """Truecolor foreground using 24-bit RGB (semicolon syntax)."""
+        return self.apply_codes(text, [38, 2, r, g, b])
+
+    def bg_rgb(self, r, g, b, text):
+        """Truecolor background using 24-bit RGB."""
+        return self.apply_codes(text, [48, 2, r, g, b])
+
+    def hex_color(self, hex_code, text):
+        """Convert #RRGGBB to truecolor foreground."""
+        hex_code = hex_code.lstrip('#')
+        r, g, b = int(hex_code[0:2], 16), int(hex_code[2:4], 16), int(hex_code[4:6], 16)
+        return self.rgb(r, g, b, text)
+
+    # ---------- Core formatting engine ----------
+    def apply_codes(self, text: str, codes):
+        """
+        Apply one or more ANSI escape codes to the given text.
+
+        Args:
+            text (str): The text to style.
+            codes (list[int]): List of ANSI codes (e.g., [31, 1] for red and bold).
+
+        Returns:
+            str: The text prefixed with the appropriate escape sequence and,
+                 unless the original text already ends with a reset code,
+                 suffixed with \\033[0m to reset all styles.
+        """
+        if text.endswith('\033[0m'):
+            sequence = '\033[' + ';'.join(map(str, codes)) + 'm' + text
+        else:
+            sequence = '\033[' + ';'.join(map(str, codes)) + 'm' + text + '\033[0m'
+        return sequence
+
+    def style(self, text, *styles):
+        """
+        Apply multiple styles to the given text by chaining methods.
+
+        Args:
+            text (str): The text to style.
+            *styles (str): Styles to apply to text.
+                           all names of styles are the same as names of functions in this class.
+
+        Returns:
+            str: The text after applying all specified styles sequentially.
+
+        Example:
+            ansi = basic_ansi()
+            ansi.style("Hello", "red", "bold", "underline")
+        """
+        a = []
+        for i in styles:
+            a.append(self.ANSI_CODES[i])
+        text = self.apply_codes(text, a)
+        return text
+
+    @contextmanager
+    def styleman(self, *funcs):
+        """Context manager for applying styles to a block."""
+
+        codes = [str(self.ANSI_CODES[f]) for f in funcs if f in self.ANSI_CODES]
+        sys.stdout.write('\033[' + ';'.join(codes) + 'm')
+        sys.stdout.flush()
+        
+        try:
+            yield
+        finally:
+            sys.stdout.write('\033[0m')
+            sys.stdout.flush()
+
+__all__ = ['ansi']

yet_another_ansi_lib-0.1.0/yet_another_ansi_lib.egg-info/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: yet-another-ansi-lib
+Version: 0.1.0
+Summary: Cool ANSI styling!
+Author: robert-ish
+License: MIT
+Project-URL: Homepage, https://github.com/robert-ish/yet-another-ansi-lib
+Project-URL: Repository, https://github.com/robert-ish/yet-another-ansi-lib
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# yet-another-ansi-lib
+Zero-dependency ANSI colors and styles for Python.
+
+## Installation:
+```bash
+pip install yet-another-ansi-lib
+```
+
+## Usage:
+```python
+from yet_another_ansi_lib import ansi
+ansi = ansi()
+print(ansi.red("Hello world!"))
+```
+you can even do:
+```python
+from yet_another_ansi_lib import ansi
+ansi = ansi()
+with ansi.styleman('bold', 'red'):
+    print('Hello world!')
+```
+
+## License:
+MIT.

yet_another_ansi_lib-0.1.0/yet_another_ansi_lib.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+LICENSE
+pyproject.toml
+readme.md
+yet_another_ansi_lib/__init__.py
+yet_another_ansi_lib.egg-info/PKG-INFO
+yet_another_ansi_lib.egg-info/SOURCES.txt
+yet_another_ansi_lib.egg-info/dependency_links.txt
+yet_another_ansi_lib.egg-info/top_level.txt

yet_another_ansi_lib-0.1.0/yet_another_ansi_lib.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

yet_another_ansi_lib-0.1.0/yet_another_ansi_lib.egg-info/top_level.txt

@@ -0,0 +1 @@
+yet_another_ansi_lib