tcolorize 0.1.0__tar.gz

tcolorize-0.1.0/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.3
+Name: tcolorize
+Version: 0.1.0
+Summary: Very simple cross-platform colored terminal text in Python
+Author: grayphi
+Author-email: grayphi <>
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+
+# tcolorize
+Very simple cross-platform colored terminal text in Python

tcolorize-0.1.0/README.md

@@ -0,0 +1,2 @@
+# tcolorize
+Very simple cross-platform colored terminal text in Python

tcolorize-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "tcolorize"
+version = "0.1.0"
+description = "Very simple cross-platform colored terminal text in Python"
+readme = "README.md"
+requires-python = ">=3.14"
+dependencies = []
+
+[[project.authors]]
+name = "grayphi"
+email = ""
+
+[build-system]
+requires = ["uv_build>=0.12.15,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pylint>=4.0.9",
+    "pytest>=9.1.1",
+]

tcolorize-0.1.0/pyproject.toml.orig

@@ -0,0 +1,20 @@
+[project]
+name = "tcolorize"
+version = "0.1.0"
+description = "Very simple cross-platform colored terminal text in Python"
+readme = "README.md"
+authors = [
+    { name = "grayphi", email = "" }
+]
+requires-python = ">=3.14"
+dependencies = []
+
+[build-system]
+requires = ["uv_build>=0.12.15,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pylint>=4.0.9",
+    "pytest>=9.1.1",
+]

tcolorize-0.1.0/src/tcolorize/__init__.py

@@ -0,0 +1,42 @@
+# vim:ts=4:sw=4:cc=80:et:si:sta:ai:nu:nowrap:cul:sm:is:hls:pt=<F3>:
+# pylint: disable=missing-module-docstring, missing-function-docstring
+# pylint: disable=trailing-newlines
+
+
+from tcolorize.main import (
+    as_red,
+    as_cyan,
+    as_yellow,
+    as_orange,
+    as_light_blue,
+    as_light_green,
+    as_light_green_2,
+    as_light_red,
+    on_black,
+    on_light_black,
+    on_dark_black,
+    as_bold,
+    as_dim,
+    as_underline
+)
+
+
+__version__ = '0.1.0'
+
+__all__ = [
+    'as_red',
+    'as_cyan',
+    'as_yellow',
+    'as_orange',
+    'as_light_blue',
+    'as_light_green',
+    'as_light_green_2',
+    'as_light_red',
+    'on_black',
+    'on_light_black',
+    'on_dark_black',
+    'as_bold',
+    'as_dim',
+    'as_underline'
+]
+

tcolorize-0.1.0/src/tcolorize/main.py

@@ -0,0 +1,86 @@
+# vim:ts=4:sw=4:cc=80:et:si:sta:ai:nu:nowrap:cul:sm:is:hls:pt=<F3>:
+# pylint: disable=missing-module-docstring, missing-function-docstring
+# pylint: disable=trailing-newlines
+
+import os
+
+from tcolorize import tput
+
+
+_NO_COLOR = False
+_NC_ENVARS = [
+    "NO_COLOR",
+    "TCOLORIZE_NO_COLOR"
+]
+_NC_ENV_VALS = ["0", "no_color", "true"]
+
+for ev in _NC_ENVARS:
+    if os.environ.get(ev, "").lower() in _NC_ENV_VALS:
+        _NO_COLOR = True
+        break
+
+
+def _cont(t, es):
+    return t.replace(tput.reset_all(), tput.reset_all() + es)
+
+
+def _color(t, es):
+    return es + _cont(t, es) + tput.reset_all()
+
+
+def as_red(text):
+    return text if _NO_COLOR else _color(text, tput.fg_red())
+
+
+def as_cyan(text):
+    return text if _NO_COLOR else _color(text, tput.fg_cyan())
+    
+
+def as_yellow(text):
+    return text if _NO_COLOR else _color(text, tput.fg_yellow())
+    
+
+def as_orange(text):
+    return text if _NO_COLOR else _color(text, tput.fg_orange())
+    
+
+def as_light_blue(text):
+    return text if _NO_COLOR else _color(text, tput.fg_light_blue())
+    
+
+def as_light_green(text):
+    return text if _NO_COLOR else _color(text, tput.fg_light_green())
+    
+
+def as_light_green_2(text):
+    return text if _NO_COLOR else _color(text, tput.fg_light_green_2())
+    
+
+def as_light_red(text):
+    return text if _NO_COLOR else _color(text, tput.fg_light_red())
+    
+
+def on_black(text):
+    return text if _NO_COLOR else _color(text, tput.bg_black())
+    
+
+def on_light_black(text):
+    return text if _NO_COLOR else _color(text, tput.bg_light_black())
+    
+
+def on_dark_black(text):
+    return text if _NO_COLOR else _color(text, tput.bg_dark_black())
+    
+
+def as_bold(text):
+    return text if _NO_COLOR else _color(text, tput.style_bold())
+    
+
+def as_dim(text):
+    return text if _NO_COLOR else _color(text, tput.style_dim())
+    
+
+def as_underline(text):
+    return text if _NO_COLOR else _color(text, tput.style_underline())
+    
+

tcolorize-0.1.0/src/tcolorize/tput.py

@@ -0,0 +1,141 @@
+# vim:ts=4:sw=4:cc=80:et:si:sta:ai:nu:nowrap:cul:sm:is:hls:pt=<F3>:
+# pylint: disable=missing-module-docstring, missing-function-docstring
+# pylint: disable=trailing-newlines
+
+import os
+import shutil
+import subprocess
+from functools import cache
+
+
+@cache
+def can_tput():
+    return (
+        os.isatty(1)
+        and shutil.which("tput") is not None
+    )
+
+
+@cache
+def get_tput(*args):
+    if not can_tput():
+        return None 
+
+    result = subprocess.run(
+        ["tput", *args],
+        capture_output=True,
+        text=True,
+    )
+
+    if result and result.returncode == 0:
+        return result.stdout
+
+
+class Fg:
+    LIGHT_GREEN = "2"
+    LIGHT_RED = "9"
+    LIGHT_GREEN_2 = "10"
+    LIGHT_BLUE = "42"
+    CYAN = "44"
+    YELLOW = "190"
+    ORANGE = "202"
+    RED = "196"
+
+
+class Bg:
+    BLACK = "16"
+    DARK_BLACK = "233"
+    LIGHT_BLACK = "236"
+
+
+class Style:
+    BOLD = "bold"
+    DIM = "dim"
+    UNDERLINE = "smul"
+
+
+class Other:
+    RESET_ALL = "sgr0"
+
+
+fg = Fg()
+bg = Bg()
+style = Style()
+other = Other()
+
+
+@cache
+def fg_red():
+    return get_tput("setaf", fg.RED) or ""
+ 
+
+@cache
+def fg_cyan():
+    return get_tput("setaf", fg.CYAN) or ""
+ 
+
+@cache
+def fg_yellow():
+    return get_tput("setaf", fg.YELLOW) or ""
+ 
+
+@cache
+def fg_orange():
+    return get_tput("setaf", fg.ORANGE) or ""
+ 
+
+@cache
+def fg_light_blue():
+    return get_tput("setaf", fg.LIGHT_BLUE) or ""
+ 
+
+@cache
+def fg_light_green():
+    return get_tput("setaf", fg.LIGHT_GREEN) or ""
+ 
+
+@cache
+def fg_light_green_2():
+    return get_tput("setaf", fg.LIGHT_GREEN_2) or ""
+ 
+
+@cache
+def fg_light_red():
+    return get_tput("setaf", fg.LIGHT_RED) or ""
+ 
+
+@cache
+def bg_black():
+    return get_tput("setab", bg.BLACK) or ""
+ 
+
+@cache
+def bg_light_black():
+    return get_tput("setab", bg.LIGHT_BLACK) or ""
+ 
+
+@cache
+def bg_dark_black():
+    return get_tput("setab", bg.DARK_BLACK) or ""
+ 
+
+@cache
+def style_bold():
+    return get_tput(style.BOLD) or ""
+ 
+
+@cache
+def style_dim():
+    return get_tput(style.DIM) or ""
+ 
+
+@cache
+def style_underline():
+    return get_tput(style.UNDERLINE) or ""
+
+
+@cache
+def reset_all():
+    return get_tput(other.RESET_ALL) or ""
+
+