artlab 1.0.0__py3-none-any.whl

artlab/__init__.py

@@ -0,0 +1,3 @@
+"""artlab - ASCII art in your terminal."""
+
+__version__ = "1.0.0"

artlab/__main__.py

@@ -0,0 +1,4 @@
+from artlab.cli import main
+
+if __name__ == "__main__":
+    main()

artlab/cli.py

@@ -0,0 +1,82 @@
+"""artlab command-line interface."""
+
+import argparse
+import random
+import sys
+
+from artlab import __version__
+import artlab.core as core
+from artlab.core import ART, list_pieces, show
+
+
+def build_parser():
+    p = argparse.ArgumentParser(
+        prog="artlab",
+        description="ASCII art in your terminal. Show bundled art, rainbow text, "
+                    "or animate it. Zero dependencies.",
+    )
+    p.add_argument("piece", nargs="?", default=None,
+                   help="name of a piece to show (see 'artlab list')")
+    p.add_argument("-t", "--text", default=None,
+                   help="render text as block letters (big ASCII)")
+    p.add_argument("-l", "--list", action="store_true",
+                   help="list all available pieces")
+    p.add_argument("-r", "--random", action="store_true",
+                   help="show a random piece")
+    p.add_argument("-c", "--color", choices=["rainbow", "green", "cyan",
+                                             "magenta", "none"],
+                   default="rainbow", help="color palette (default rainbow)")
+    p.add_argument("-w", "--width", type=int, default=None,
+                   help="pad art to a fixed width")
+    p.add_argument("--no-center", action="store_true",
+                   help="don't center the art")
+    p.add_argument("--no-color", action="store_true",
+                   help="don't colorize output")
+    p.add_argument("-a", "--animate", action="store_true",
+                   help="reveal the art with an animation")
+    p.add_argument("--version", action="version", version=f"artlab {__version__}")
+    return p
+
+
+def main(argv=None):
+    args = build_parser().parse_args(argv)
+
+    if args.no_color:
+        core.NO_COLOR = True
+
+    if args.list:
+        for name in list_pieces():
+            print(f"  {name}")
+        print(f"\n({len(ART)} pieces available)")
+        return 0
+
+    if args.text is not None:
+        pieces = args.text if args.text else None
+        show(text=args.text, color=args.color, width=args.width,
+             center=not args.no_center, animate=args.animate)
+        return 0
+
+    if args.random:
+        key, art = random.choice(list(ART.items()))
+        show(name=key, color=args.color, width=args.width,
+             center=not args.no_center, animate=args.animate)
+        return 0
+
+    if args.piece:
+        from artlab.core import pick_piece
+        if pick_piece(args.piece)[0] is None:
+            print(f"artlab: unknown piece '{args.piece}' (try 'artlab -l')",
+                  file=sys.stderr)
+            return 1
+        show(name=args.piece, color=args.color, width=args.width,
+             center=not args.no_center, animate=args.animate)
+        return 0
+
+    # default: random piece
+    show(color=args.color, width=args.width, center=not args.no_center,
+         animate=args.animate)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

artlab/core.py

@@ -0,0 +1,334 @@
+"""artlab - ASCII art in your terminal.
+
+Bundled ASCII art library, a zero-dependency block-letter text renderer,
+color/rainbow helpers, and simple frame animation. Zero dependencies.
+"""
+
+import colorsys
+import random
+import shutil
+import sys
+import time
+
+# --------------------------------------------------------------------------
+# Bundled ASCII art library
+# --------------------------------------------------------------------------
+
+ART = {
+    "robot": r"""        .-""" + """""" + r""".
+      .'_________'.
+     /   _    _    \
+    |  (o)  (o)   |
+    |     ___     |
+    |  \_______/  |
+     \   _   _   /
+      |  [ o ]  |
+      |___|_|___|
+     /  |  |  |  \
+    |   |  |  |   |
+    ~~~~~~~~~~~~~""",
+    "cat": r"""   /\_/\
+  ( o.o )
+   > ^ <
+  /     \
+  \_____/  meow""",
+    "dog": r"""   / \__
+  (    @\___
+  /         O
+ /   (_____/
+/_____/   U
+   dog""",
+    "fox": r""" /\_/\
+( o.o )
+ > ^ <
+/  _  \
+\__|__/  ring-ding-ding""",
+    "dragon": r"""   __====-_  _-====___
+ _--^^^#####//      \\#####^^^--_
+-^##########/ (    ) \##########^-
+############/  (  )  \############
+###########/    (   )  \###########
+#########/ (    )  (    ) \#########
+########(      ( )  ( )      )#######
+#########\      (   )      /#########
+  #######\    (     )    /#######
+   ####### \  (     )  /#######
+    #######  \______/  #######
+     d r a g o n""",
+    "unicorn": r"""          /
+      \  /
+   \  /____
+    (   ____\_________
+  ___/   \____\tttt___
+ /   \____(  ' '  )  |\
+(    o'  (o o)  )   | )
+ \   \    (_,_)\___/  /
+  \   \____)___(____  )
+   \__(___________\__/
+    unicorn ~*~*~""",
+    "heart": r"""  ******       ******
+ *********   *********
+*********** ***********
+ *********************
+  *******************
+   *****************
+    ***************
+     *************
+      ***********
+       *********
+        *******
+         *****
+          ***
+           *""",
+    "yoda": r"""     ..,
+    ( o o )
+   (  >  <  )
+   /A     A\
+   |+. _ .+|
+    \_|_|_/
+     v   v
+    use the source""",
+    "octopus": r"""       _
+    .-(   )-.
+   /  _   _  \
+  ( (o)(o)(o) )
+   \  \___/  /
+    \_______/
+     |     |
+    /|     |\
+   / |_____| \
+   ~~~     ~~~
+   octopus""",
+    "ghost": r"""    .-~~~~-.
+   /  ____  \
+  |  /    \  |
+  | |  o  o | |
+  |  \____/  |
+   \  ____  /
+    | |  | |
+     \|__|/
+     / /  \ \
+    ~~    ~~
+    boo!""",
+}
+
+# --------------------------------------------------------------------------
+# Minimal block-letter text renderer (zero-dependency figlet-style)
+# --------------------------------------------------------------------------
+
+_FONT = {}
+
+_Q = [" ##### ", "##   ##", "##   ##", "##   ##", " ##### "]
+_W = ["##   ##", "##   ##", "## ## ##", "#### ###", "##   ##"]
+_H = ["##   ##", "##   ##", "#######", "##   ##", "##   ##"]
+_A = [" ##### ", "##   ##", "#######", "##   ##", "##   ##"]
+_R = [" ##### ", "##   ##", "#####  ", "##  ## ", "##   ##"]
+_T = ["#######", "   #   ", "   #   ", "   #   ", "   #   "]
+_P = ["###### ", "##   ##", "###### ", "##     ", "##     "]
+_L = ["##     ", "##     ", "##     ", "##     ", "#######"]
+_I = ["###", " # ", " # ", " # ", "###"]
+_E = ["#######", "##     ", "#####  ", "##     ", "#######"]
+_S = [" ######", "##     ", " ##### ", "     ##", "###### "]
+_O = [" ##### ", "##   ##", "##   ##", "##   ##", " ##### "]
+_U = ["##   ##", "##   ##", "##   ##", "##   ##", " ##### "]
+_N = ["##    #", "###   #", "## #  #", "##  # #", "##   ##"]
+_Y = ["##   ##", "##   ##", " ##### ", "   ##  ", "   ##  "]
+_G = [" ##### ", "##     ", "##  ###", "##   ##", " ##### "]
+_D = ["###### ", "##   ##", "##   ##", "##   ##", "###### "]
+_K = ["##  ## ", "## ##  ", "####   ", "## ##  ", "##  ## "]
+_X = ["##   ##", " ## ## ", "  ###  ", " ## ## ", "##   ##"]
+_Z = ["#######", "    ## ", "   ##  ", "  ##   ", "#######"]
+_V = ["##   ##", "##   ##", "##   ##", " ## ## ", "  ###  "]
+_J = ["    ###", "     ##", "     ##", "##   ##", " ##### "]
+_M = ["##  ##  ##", "### ### ##", "## # # ##", "##     ##", "##     ##"]
+_B = ["###### ", "##   ##", "###### ", "##   ##", "###### "]
+_F = ["#######", "##     ", "#####  ", "##     ", "##     "]
+_C = [" ##### ", "##     ", "##     ", "##     ", " ##### "]
+
+_FONT = {
+    "0": _O, "1": ["  ##  ", " ####  ", "   ##  ", "   ##  ", "  ## "],
+    "2": [" #### ", "     ##", " #### ", "##    ", "##### "],
+    "3": [" #### ", "     ##", " #### ", "     ##", " #### "],
+    "4": ["##  ##", "##  ##", "#######", "    ##", "    ##"],
+    "5": ["#######", "##     ", "#####  ", "     ##", "##### "],
+    "6": [" ##### ", "##     ", "###### ", "##   ##", " ##### "],
+    "7": ["#######", "    ## ", "   ##  ", "  ##   ", "  ##   "],
+    "8": [" ##### ", "##   ##", " ##### ", "##   ##", " ##### "],
+    "9": [" ##### ", "##   ##", " #######", "     ##", " ##### "],
+    ".": ["    ", "    ", "    ", "    ", " ## "],
+    " ": ["  ", "  ", "  ", "  ", "  "],
+    "!": ["###", "###", "###", "   ", " # "],
+    "?": ["#### ", "    ##", "  ## ", "      ", "  #  "],
+    "-": ["     ", "     ", "#####", "     ", "     "],
+}
+
+# Assign letters to their glyphs
+for _char, _glyph in [
+    ("A", _A), ("B", _B), ("C", _C), ("D", _D), ("E", _E), ("F", _F),
+    ("G", _G), ("H", _H), ("I", _I), ("J", _J), ("K", _K), ("L", _L),
+    ("M", _M), ("N", _N), ("O", _O), ("P", _P), ("Q", _Q), ("R", _R),
+    ("S", _S), ("T", _T), ("U", _U), ("V", _V), ("W", _W), ("X", _X),
+    ("Y", _Y), ("Z", _Z),
+]:
+    _FONT[_char] = _glyph
+
+
+def render_text(text, font="block"):
+    """Render text as block letters (zero dependencies). Returns list of lines."""
+    lines = ["" for _ in range(5)]
+    for ch in text.upper():
+        glyph = _FONT.get(ch, _FONT[" "])
+        for i in range(5):
+            lines[i] += glyph[i] + " "
+    return [line.rstrip() for line in lines]
+
+
+# --------------------------------------------------------------------------
+# Color helpers
+# --------------------------------------------------------------------------
+
+NO_COLOR = False
+FORCE_COLOR = False
+
+RESET = "\033[0m"
+
+
+def _should_colorize(palette, out):
+    if NO_COLOR or palette[0] == "":
+        return False
+    if FORCE_COLOR:
+        return True
+    return bool(getattr(out, "isatty", lambda: False)())
+
+
+def _rainbow_codes(n):
+    codes = []
+    for i in range(n):
+        h = i / max(1, n) if n > 1 else 0.0
+        r, g, b = colorsys.hsv_to_rgb(h, 1.0, 1.0)
+        codes.append(f"\033[38;2;{int(r*255)};{int(g*255)};{int(b*255)}m")
+    return codes
+
+
+def _color_lines(lines, palette, cycle=False, out=None):
+    if not _should_colorize(palette, out):
+        return lines
+    res = []
+    for idx, line in enumerate(lines):
+        code = palette[idx % len(palette)] if cycle else palette[0]
+        res.append(code + line + RESET)
+    return res
+
+
+RAINBOW_PALETTE = [
+    "\033[38;5;196m", "\033[38;5;208m", "\033[38;5;226m", "\033[38;5;46m",
+    "\033[38;5;39m", "\033[38;5;93m", "\033[38;5;201m",
+]
+GREEN = "\033[38;5;82m"
+CYAN = "\033[38;5;45m"
+MAGENTA = "\033[38;5;201m"
+
+
+def _palette(kind):
+    return {
+        "rainbow": RAINBOW_PALETTE,
+        "green": [GREEN],
+        "cyan": [CYAN],
+        "magenta": [MAGENTA],
+        "none": [""],
+    }.get(kind, RAINBOW_PALETTE)
+
+
+# --------------------------------------------------------------------------
+# Art selection and display
+# --------------------------------------------------------------------------
+
+def list_pieces():
+    return sorted(ART.keys())
+
+
+def pick_piece(name=None):
+    if name:
+        name = name.lower()
+        if name in ART:
+            return name, ART[name]
+        for key in ART:
+            if key.startswith(name):
+                return key, ART[key]
+        return None, None
+    return None, None
+
+
+def show(name=None, text=None, color="rainbow", width=None, center=True,
+         animate=False, frames=20, delay=0.06, out=None, return_lines=False):
+    """Render and (optionally) print art. Returns the rendered lines."""
+    if out is None:
+        out = sys.stdout
+
+    def build():
+        if text is not None:
+            return render_text(text)
+        if name:
+            key, art = pick_piece(name)
+            if not art:
+                return None
+            return art.splitlines()
+        key, art = random.choice(list(ART.items()))
+        return art.splitlines()
+
+    lines = build()
+    if lines is None:
+        return None
+    if return_lines:
+        return lines
+
+    lines = _fit_width(lines, width, center=center)
+    lines = _color_lines(lines, _palette(color), cycle=(color == "rainbow"), out=out)
+    if animate:
+        _animate(lines, out, frames, delay)
+    else:
+        for line in lines:
+            out.write(line + "\n")
+        out.flush()
+    return lines
+
+
+def _fit_width(lines, width, center=True):
+    if not width:
+        maxlen = max((len(line) for line in lines), default=0)
+        width = maxlen
+    return [_center(line, width) if center else line for line in lines]
+
+
+def _center(line, width):
+    pad = width - len(line)
+    if pad <= 0:
+        return line
+    left = pad // 2
+    return " " * left + line
+
+
+def _animate(lines, out, frames, delay):
+    terminal = shutil.get_terminal_size((80, 24)).lines
+    height = len(lines)
+    for frame in range(frames):
+        upto = int((frame + 1) / frames * height)
+        view = lines[max(0, upto - min(terminal, height)) : upto]
+        out.write("\033[H\033[J")
+        for line in view:
+            out.write(line + "\n")
+        out.flush()
+        time.sleep(delay)
+
+
+def random_piece():
+    name, art = random.choice(list(ART.items()))
+    return name, art
+
+
+def pieces_count():
+    return len(ART)
+
+
+def main_extras():
+    return None

artlab-1.0.0.dist-info/METADATA

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: artlab
+Version: 1.0.0
+Summary: ASCII art in your terminal. Zero dependencies.
+Author: dsk-dev-ai
+License: MIT
+Project-URL: Homepage, https://github.com/dsk-dev-ai/artlab
+Project-URL: Source, https://github.com/dsk-dev-ai/artlab
+Project-URL: Issues, https://github.com/dsk-dev-ai/artlab/issues
+Project-URL: Funding, https://github.com/sponsors/dsk-dev-ai
+Keywords: ascii,art,terminal,cli,fun,text,rainbow,ascii-art
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Artistic Software
+Classifier: Topic :: Terminals
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+<div align="center">
+
+# 🎨 artlab
+
+**ASCII art in your terminal.**
+
+Bundled retro art, big block-letter text, rainbow colors, and animation.
+Zero dependencies. Works in Python 3.8+.
+
+[![PyPI](https://img.shields.io/pypi/v/artlab?color=blue&logo=pypi&logoColor=white)](https://pypi.org/project/artlab/)
+[![Python](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12-blue)](#)
+[![License](https://img.shields.io/badge/license-MIT-green)](#)
+[![Docker](https://img.shields.io/badge/docker-ghcr.io%2Fdsk--dev--ai%2Fartlab-blue?logo=docker)](https://github.com/dsk-dev-ai/artlab/pkgs/container/artlab)
+
+</div>
+
+---
+
+## Why artlab?
+
+Because the terminal deserves a little personality.
+
+- **Bundled ASCII art** — robots, cats, dragons, unicorns, yoda, octopuses, hearts and more.
+- **Block-letter text** — print any word big, `figlet`-style, with zero dependencies.
+- **Rainbow & colors** — 256-color palettes, or dims down for your pipelines.
+- **Animation** — reveal art with a slick frame-by-frame intro.
+- **Zero dependencies** — pure Python stdlib. No install drama.
+
+## Install
+
+```bash
+pip install artlab
+```
+
+Or run without installing:
+
+```bash
+pipx run artlab --help
+```
+
+Via Docker:
+
+```bash
+docker run --rm ghcr.io/dsk-dev-ai/artlab --help
+```
+
+## Usage
+
+```bash
+# Show a random piece
+artlab
+
+# Show a specific piece
+artlab robot
+artlab cat
+artlab dragon
+
+# List everything
+artlab -l
+
+# Print big block text
+artlab --text "SHIP IT"
+artlab -t "artlab" -c cyan
+
+# Force a palette
+artlab robot -c green
+artlab dragon -c magenta
+
+# Animate the reveal
+artlab unicorn -a
+
+# No color (for scripts / piping)
+artlab robot --no-color
+```
+
+### Options
+
+| Flag | Description |
+|------|-------------|
+| `-l, --list` | List all available pieces |
+| `-r, --random` | Show a random piece |
+| `-t, --text TEXT` | Render text as big block letters |
+| `-c, --color` | Palette: `rainbow`, `green`, `cyan`, `magenta`, `none` |
+| `-w, --width N` | Pad art to a fixed width |
+| `--no-center` | Don't center the art |
+| `-a, --animate` | Reveal the art with an animation |
+| `--no-color` | Disable color output |
+| `--version` | Print version |
+
+## Gallery
+
+Run `artlab` to see a random piece, or `artlab -l` to browse the full library.
+Everything is bundled — no API, no network, no nonsense.
+
+```
+   /\_/\
+  ( o.o )
+   > ^ <
+  /     \
+  \_____/  meow
+```
+
+## Tests
+
+```bash
+python -m pytest
+```
+
+Tested on Python 3.8–3.12 via GitHub Actions.
+
+## Sponsor
+
+Like `artlab`? Keep the terminal artsy for free by [becoming a sponsor](https://github.com/sponsors/dsk-dev-ai) on GitHub 💜.
+
+---
+
+<div align="center">
+
+**artlab** · because the terminal deserves art.
+
+</div>

artlab-1.0.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+artlab/__init__.py,sha256=WbUsMzYEirGLjM6yxwN34pqhNYAjQ0HjsViR6wH1mGE,66
+artlab/__main__.py,sha256=zJBxAKu18wg4b_wE0GaiRUplpNLEVZTEBNlz2JUtdwo,67
+artlab/cli.py,sha256=OBygYnY6tXvSkjfD2IhLElcoNS6CFyFl3haTiAXcPUg,2901
+artlab/core.py,sha256=KI6rCZcOHbw_6NmFmg9A5AJAZ9_d85POoEB425ZwHt4,9612
+artlab-1.0.0.dist-info/licenses/LICENSE,sha256=EAxljeOlydi0CA5dhf2z72wEjAtq_9Ig44QyLQ7XWLM,1067
+artlab-1.0.0.dist-info/METADATA,sha256=G6HgvfUPwans2seRs2UW_Lo06Hgg77-_L25967xLFks,3884
+artlab-1.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+artlab-1.0.0.dist-info/entry_points.txt,sha256=TADcrd5_LCLJQFJeNL_eI8gKJ5nyLfe1KmJ-yOODgfU,43
+artlab-1.0.0.dist-info/top_level.txt,sha256=oO456VQwkMHu8SEyupOvEwYdXxhHJ-bjn4o_mkxye-k,7
+artlab-1.0.0.dist-info/RECORD,,

artlab-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

artlab-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+artlab = artlab.cli:main

artlab-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsk-dev-ai
+
+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.

artlab-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+artlab