curint 0.1.2__tar.gz

curint-0.1.2/LICENSE

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

curint-0.1.2/MANIFEST.in

@@ -0,0 +1,12 @@
+include README.md
+include LICENSE
+include SECURITY.md
+include pyproject.toml
+include setup.py
+recursive-include examples *.py
+recursive-include tests *.py
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]
+recursive-exclude .pytest_cache *
+recursive-exclude .ruff_cache *
+recursive-exclude .mypy_cache *

curint-0.1.2/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.1
+Name: curint
+Version: 0.1.2
+Summary: Colorful terminal output toolkit
+Author: corotosh
+License: MIT
+Keywords: terminal,colors,rich,ansi,gradient,animation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Terminals
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+curint is a Python library for colorful terminal output. It provides styled text, RGB gradients, rainbow text, themed console helpers, Rich panels and tables, status messages, prompts, logging, spinners, progress bars, and lightweight text animations.
+
+## Features
+
+- True-color foreground and background styling.
+- Gradient, palette, and rainbow text.
+- Built-in themes such as `default`, `sunset`, `ocean`, `dracula`, and `forest`.
+- Rich-backed panels, tables, trees, rules, Markdown, and JSON output.
+- Status helpers: `success()`, `error()`, `warning()`, `info()`, and `debug()`.
+- Simple prompts: `ask()`, `confirm()`, and `choose()`.
+- Spinners, progress bars, and iterable tracking.
+- Text effects: typewriter, wave, bounce, glitch, and shimmer.
+- A colorful `logging.Handler` for terminal applications.
+
+## Quick start
+
+```python
+from curint import SpectraConsole, Spinner, progress_bar, success
+
+console = SpectraConsole(theme="sunset")
+console.banner("curint")
+console.gradient("Gradient text with a theme", bold=True)
+console.rainbow("Rainbow output", bold=True)
+console.panel("Useful for build scripts, demos, and terminal applications.", title="Hello")
+
+with Spinner("Working"):
+    import time
+    time.sleep(0.5)
+
+progress_bar(25, "Finishing", delay=0.01)
+success("Done")
+```
+
+## Text helpers
+
+```python
+from curint import gradient_text, highlight, palette_text, rainbow_text, style_text
+
+print(style_text("bold cyan", fg="cyan", bold=True))
+print(gradient_text("sunset gradient", "#ff5e62", "#ffd166"))
+print(rainbow_text("rainbow"))
+print(palette_text("neon", "neon"))
+print(highlight("ship the package", "ship"))
+```
+
+## Console helpers
+
+```python
+from curint import SpectraConsole
+
+console = SpectraConsole(theme="ocean")
+console.banner("release")
+console.rule("checks")
+console.panel("All systems ready", title="Status")
+console.table(
+    [
+        {"Check": "tests", "Result": "passed"},
+        {"Check": "build", "Result": "passed"},
+    ],
+    title="Summary",
+)
+console.tree("package", {"dist": ["sdist", "wheel"], "docs": ["README"]})
+console.markdown("**Markdown** rendering via Rich")
+console.json({"ok": True, "version": "0.1.2"})
+```
+
+## Themes
+
+```python
+from curint import Theme, register_theme, theme_names, use_theme
+
+register_theme(
+    Theme(
+        name="brand",
+        primary="#7c3aed",
+        secondary="#06b6d4",
+        accent="#f59e0b",
+    )
+)
+
+console = use_theme("brand")
+console.gradient("Custom brand theme")
+print(theme_names())
+```
+
+## Animations
+
+```python
+from curint import bounce, glitch, shimmer, typewriter, wave
+
+typewriter("Typed output", delay=0.03)
+wave("wave text")
+bounce("bounce text")
+glitch("glitch text")
+shimmer("shimmer text")
+```
+
+For tests, use frame helpers that return strings instead of printing:
+
+```python
+from curint import glitch_frames, wave_frames
+
+frames = wave_frames("abc", frames=3)
+assert len(frames) == 3
+assert glitch_frames("abc", frames=2)
+```
+
+## Progress and spinners
+
+```python
+from curint import Spinner, progress_bar, rich_status, track_iter
+
+with Spinner("Uploading"):
+    import time
+    time.sleep(0.5)
+
+progress_bar(50, "Building", delay=0.01)
+
+with rich_status("Indexing"):
+    pass
+
+for item in track_iter(range(10), "Processing"):
+    pass
+```
+
+## Logging
+
+```python
+from curint import configure_logging
+
+logger = configure_logging("INFO", logger_name="curint-demo")
+logger.info("Colorful logging is ready")
+```
+
+## Prompts
+
+```python
+from curint import ask, choose, confirm
+
+name = ask("Project name", default="demo")
+color = choose("Theme", ["sunset", "ocean", "dracula"], default="ocean")
+ready = confirm("Continue?", default=True)
+```
+
+## License
+
+MIT License.

curint-0.1.2/README.md

@@ -0,0 +1,147 @@
+curint is a Python library for colorful terminal output. It provides styled text, RGB gradients, rainbow text, themed console helpers, Rich panels and tables, status messages, prompts, logging, spinners, progress bars, and lightweight text animations.
+
+## Features
+
+- True-color foreground and background styling.
+- Gradient, palette, and rainbow text.
+- Built-in themes such as `default`, `sunset`, `ocean`, `dracula`, and `forest`.
+- Rich-backed panels, tables, trees, rules, Markdown, and JSON output.
+- Status helpers: `success()`, `error()`, `warning()`, `info()`, and `debug()`.
+- Simple prompts: `ask()`, `confirm()`, and `choose()`.
+- Spinners, progress bars, and iterable tracking.
+- Text effects: typewriter, wave, bounce, glitch, and shimmer.
+- A colorful `logging.Handler` for terminal applications.
+
+## Quick start
+
+```python
+from curint import SpectraConsole, Spinner, progress_bar, success
+
+console = SpectraConsole(theme="sunset")
+console.banner("curint")
+console.gradient("Gradient text with a theme", bold=True)
+console.rainbow("Rainbow output", bold=True)
+console.panel("Useful for build scripts, demos, and terminal applications.", title="Hello")
+
+with Spinner("Working"):
+    import time
+    time.sleep(0.5)
+
+progress_bar(25, "Finishing", delay=0.01)
+success("Done")
+```
+
+## Text helpers
+
+```python
+from curint import gradient_text, highlight, palette_text, rainbow_text, style_text
+
+print(style_text("bold cyan", fg="cyan", bold=True))
+print(gradient_text("sunset gradient", "#ff5e62", "#ffd166"))
+print(rainbow_text("rainbow"))
+print(palette_text("neon", "neon"))
+print(highlight("ship the package", "ship"))
+```
+
+## Console helpers
+
+```python
+from curint import SpectraConsole
+
+console = SpectraConsole(theme="ocean")
+console.banner("release")
+console.rule("checks")
+console.panel("All systems ready", title="Status")
+console.table(
+    [
+        {"Check": "tests", "Result": "passed"},
+        {"Check": "build", "Result": "passed"},
+    ],
+    title="Summary",
+)
+console.tree("package", {"dist": ["sdist", "wheel"], "docs": ["README"]})
+console.markdown("**Markdown** rendering via Rich")
+console.json({"ok": True, "version": "0.1.2"})
+```
+
+## Themes
+
+```python
+from curint import Theme, register_theme, theme_names, use_theme
+
+register_theme(
+    Theme(
+        name="brand",
+        primary="#7c3aed",
+        secondary="#06b6d4",
+        accent="#f59e0b",
+    )
+)
+
+console = use_theme("brand")
+console.gradient("Custom brand theme")
+print(theme_names())
+```
+
+## Animations
+
+```python
+from curint import bounce, glitch, shimmer, typewriter, wave
+
+typewriter("Typed output", delay=0.03)
+wave("wave text")
+bounce("bounce text")
+glitch("glitch text")
+shimmer("shimmer text")
+```
+
+For tests, use frame helpers that return strings instead of printing:
+
+```python
+from curint import glitch_frames, wave_frames
+
+frames = wave_frames("abc", frames=3)
+assert len(frames) == 3
+assert glitch_frames("abc", frames=2)
+```
+
+## Progress and spinners
+
+```python
+from curint import Spinner, progress_bar, rich_status, track_iter
+
+with Spinner("Uploading"):
+    import time
+    time.sleep(0.5)
+
+progress_bar(50, "Building", delay=0.01)
+
+with rich_status("Indexing"):
+    pass
+
+for item in track_iter(range(10), "Processing"):
+    pass
+```
+
+## Logging
+
+```python
+from curint import configure_logging
+
+logger = configure_logging("INFO", logger_name="curint-demo")
+logger.info("Colorful logging is ready")
+```
+
+## Prompts
+
+```python
+from curint import ask, choose, confirm
+
+name = ask("Project name", default="demo")
+color = choose("Theme", ["sunset", "ocean", "dracula"], default="ocean")
+ready = confirm("Continue?", default=True)
+```
+
+## License
+
+MIT License.

curint-0.1.2/examples/dashboard.py

@@ -0,0 +1,23 @@
+from curint import SpectraConsole, info, success, warning
+
+console = SpectraConsole(theme="ocean")
+console.banner("deploy")
+console.rule("checks")
+console.table(
+    [
+        {"Check": "tests", "Result": "passed", "Time": "12s"},
+        {"Check": "lint", "Result": "passed", "Time": "3s"},
+        {"Check": "build", "Result": "passed", "Time": "6s"},
+    ],
+    title="CI summary",
+)
+console.tree(
+    "release",
+    {
+        "package": ["sdist", "wheel"],
+        "publish": ["testpypi", "pypi"],
+    },
+)
+info("Uploading artifacts")
+warning("Remember to tag the release")
+success("Ready to publish")

curint-0.1.2/examples/demo.py

@@ -0,0 +1,25 @@
+from curint import SpectraConsole, Spinner, configure_logging, gradient_text, progress_bar, success
+
+console = SpectraConsole(theme="sunset")
+console.banner("curint")
+console.gradient("A richer alternative terminal toolkit", bold=True)
+console.rainbow("Rainbow text without manual ANSI escape codes", bold=True)
+console.panel("Powered by Rich, Colorama, Termcolor, and SkyText.", title="Dependencies")
+console.table(
+    [
+        {"Feature": "themes", "Example": "sunset, dracula, ocean"},
+        {"Feature": "widgets", "Example": "panel, table, tree, markdown, JSON"},
+        {"Feature": "animations", "Example": "typewriter, wave, bounce, glitch, shimmer"},
+    ],
+    title="curint features",
+)
+
+logger = configure_logging("INFO", logger_name="demo")
+logger.info("Rich logging is configured")
+
+with Spinner("pretending to upload"):
+    import time
+
+    time.sleep(0.5)
+
+success("Demo complete")

curint-0.1.2/pyproject.toml

@@ -0,0 +1,15 @@
+[build-system]
+requires = ["setuptools>=68", "wheel>=0.43"]
+build-backend = "setuptools.build_meta"
+
+[tool.pytest.ini_options]
+addopts = "-q"
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.ruff]
+line-length = 100
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]

curint-0.1.2/setup.cfg

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

curint-0.1.2/setup.py

@@ -0,0 +1,62 @@
+"""Classic setuptools build script for curint.
+
+This file is intentionally the source of package metadata so the project can be
+built with either:
+
+    python setup.py sdist bdist_wheel
+
+or a modern PEP 517 frontend such as:
+
+    python -m build
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from setuptools import find_packages, setup
+
+ROOT = Path(__file__).parent
+README = ROOT / "README.md"
+
+INSTALL_REQUIRES = [
+    "colorama",
+    "termcolor",
+    "skytext",
+    "rich",
+]
+
+setup(
+    name="curint",
+    version="0.1.2",
+    description="Colorful terminal output toolkit",
+    long_description=README.read_text(encoding="utf-8") if README.exists() else "",
+    long_description_content_type="text/markdown",
+    author="corotosh",
+    license="MIT",
+    package_dir={"": "src"},
+    packages=find_packages(where="src"),
+    include_package_data=True,
+    python_requires=">=3.8",
+    install_requires=INSTALL_REQUIRES,
+    keywords=[
+        "terminal",
+        "colors",
+        "rich",
+        "ansi",
+        "gradient",
+        "animation",
+    ],
+    classifiers=[
+        "Development Status :: 3 - Alpha",
+        "Environment :: Console",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+        "Topic :: Terminals",
+        "Topic :: Utilities",
+    ],
+    zip_safe=False,
+)

curint-0.1.2/src/curint/__init__.py

@@ -0,0 +1,101 @@
+from __future__ import annotations
+
+from .animations import (
+    bounce,
+    bounce_frames,
+    glitch,
+    glitch_frames,
+    print_animated,
+    print_bounce,
+    print_wave,
+    shimmer,
+    shimmer_frames,
+    typewriter,
+    wave,
+    wave_frames,
+)
+from .colors import PALETTES, RGB, ansi_bg, ansi_fg, blend_many, parse_color, strip_ansi
+from .console import SpectraConsole, debug, error, info, success, warning
+from .logging import SpectraLogHandler, configure_logging
+from .progress import Spinner, SpinnerRich, progress_bar, progress_bar_rich, rich_status, track_iter
+from .prompt import ask, choose, confirm
+from .text import (
+    box,
+    center,
+    color_text,
+    cprint,
+    gradient_text,
+    highlight,
+    palette_text,
+    print_color,
+    print_gradient,
+    print_gradient_rich,
+    print_rainbow,
+    rainbow_text,
+    sky_gradient,
+    style_text,
+    termcolor_text,
+)
+from .theme import THEMES, Theme, get_theme, register_theme, theme_names, use_theme
+
+__all__ = [
+    "PALETTES",
+    "RGB",
+    "THEMES",
+    "SpectraConsole",
+    "SpectraLogHandler",
+    "Spinner",
+    "SpinnerRich",
+    "Theme",
+    "ansi_bg",
+    "ansi_fg",
+    "ask",
+    "blend_many",
+    "bounce",
+    "bounce_frames",
+    "box",
+    "center",
+    "choose",
+    "color_text",
+    "configure_logging",
+    "confirm",
+    "cprint",
+    "debug",
+    "error",
+    "get_theme",
+    "glitch",
+    "glitch_frames",
+    "gradient_text",
+    "highlight",
+    "info",
+    "palette_text",
+    "parse_color",
+    "print_animated",
+    "print_bounce",
+    "print_color",
+    "print_gradient",
+    "print_gradient_rich",
+    "print_rainbow",
+    "print_wave",
+    "progress_bar",
+    "progress_bar_rich",
+    "rainbow_text",
+    "register_theme",
+    "rich_status",
+    "shimmer",
+    "shimmer_frames",
+    "sky_gradient",
+    "strip_ansi",
+    "style_text",
+    "success",
+    "termcolor_text",
+    "theme_names",
+    "track_iter",
+    "typewriter",
+    "use_theme",
+    "warning",
+    "wave",
+    "wave_frames",
+]
+
+__version__ = "0.1.2"

curint-0.1.2/src/curint/_compat.py

@@ -0,0 +1,46 @@
+"""Compatibility shims for optional imports during local development.
+
+The package declares its core dependencies in setup.py. The fallbacks below
+let tests and docs render in constrained environments before installation.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+try:  # pragma: no cover - exercised when dependency is installed
+    from colorama import Back, Fore, Style, just_fix_windows_console
+except Exception:  # pragma: no cover - fallback for source tree tests
+    class _Codes:
+        BLACK = RED = GREEN = YELLOW = BLUE = MAGENTA = CYAN = WHITE = RESET = RESET_ALL = ""
+        BRIGHT = DIM = NORMAL = ""
+
+    Fore = Back = Style = _Codes()  # type: ignore[assignment]
+
+    def just_fix_windows_console() -> None:
+        return None
+
+try:  # pragma: no cover
+    from termcolor import colored
+except Exception:  # pragma: no cover
+    def colored(text: str, color: str | None = None, on_color: str | None = None, attrs: list[str] | None = None) -> str:
+        return text
+
+try:  # pragma: no cover
+    from rich.console import Console
+    from rich.markdown import Markdown
+    from rich.panel import Panel
+    from rich.progress import BarColumn, Progress, SpinnerColumn, TextColumn, TimeElapsedColumn, track
+    from rich.table import Table
+    from rich.text import Text
+    from rich.tree import Tree
+except Exception as exc:  # pragma: no cover
+    raise RuntimeError("curint requires rich. Install with `pip install curint`.") from exc
+
+try:  # pragma: no cover
+    import skytext as _skytext
+except Exception:  # pragma: no cover
+    _skytext = None
+
+
+SKYTEXT: Any = _skytext