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>
