Metadata-Version: 2.4
Name: thlun
Version: 0.1.2
Summary: CLI library
Author: Ashreach
Maintainer: Netronis, Rastgame
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/Ashreach/ThLun
Project-URL: Source, https://github.com/Ashreach/ThLun
Project-URL: Organization, https://github.com/Ashreach
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=8.4.2; extra == "dev"
Requires-Dist: ruff>=0.6.9; extra == "dev"
Requires-Dist: mypy>=1.11.2; extra == "dev"
Requires-Dist: build>=1.3.0; extra == "dev"
Requires-Dist: twine>=6.2.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.6.1; extra == "docs"
Requires-Dist: mkdocs-autorefs>=1.4.3; extra == "docs"
Requires-Dist: mkdocs-git-revision-date-localized-plugin>=1.5.0; extra == "docs"
Requires-Dist: mkdocs-material>=9.6.23; extra == "docs"
Requires-Dist: mkdocs-minify-plugin>=0.8.0; extra == "docs"
Requires-Dist: mkdocstrings[python]>=0.30.1; extra == "docs"
Dynamic: license-file

<div align="center">
  <p>
    <img src='https://thlun.ashreach.dev/assets/banner.svg' height=300>
  </p>
  <br />
  <p align="center">
    <a href="https://github.com/Ashreach/ThLun/stargazers">
      <img src="https://img.shields.io/github/stars/Ashreach/ThLun?colorA=363a4f&colorB=b7bdf8&style=for-the-badge" alt="GitHub stars"/>
    </a>
    <a href="https://github.com/Ashreach/ThLun/issues">
      <img src="https://img.shields.io/github/issues/Ashreach/ThLun?colorA=363a4f&colorB=f5a97f&style=for-the-badge" alt="GitHub issues"/>
    </a>
    <a href="https://github.com/Ashreach/ThLun/contributors">
      <img src="https://img.shields.io/github/contributors/Ashreach/ThLun?colorA=363a4f&colorB=a6da95&style=for-the-badge" alt="GitHub contributors"/>
    </a>
    <a href="https://pypi.org/project/thlun/">
      <img src="https://img.shields.io/pypi/v/thlun?colorA=363a4f&colorB=a6da95&style=for-the-badge" alt="PyPI version"/>
    </a>
    <br>
    <a href="https://pepy.tech/project/thlun">
      <img src="https://static.pepy.tech/badge/thlun?colorA=363a4f&colorB=f5bde6&style=for-the-badge" alt="Downloads"/>
    </a>
  </p>
  <br>
</div>

## About

**ThLun** is a Python CLI library for stylish terminal output with ANSI colors, logging, progress bars, and spinners.

## Preview

<div align="center">
  <img src="https://thlun.ashreach.dev/assets/preview.gif" alt="ThLun Preview" >
</div>

## Installation

```bash
pip install thlun
```

## Quick Start

```python
from ThLun import bprint, Logger, ProgressBar, Spinner, Spinners
import time

# Basic colored output
bprint("[GREEN]Hello world...[RESET]")

# Logging with levels
logger = Logger('DEBUG')
logger.info("Application started")
logger.error("Something went wrong")

# Progress bar
progress = ProgressBar(total=100)
for i in range(100):
    progress.update(i + 1)
    time.sleep(0.01)

# Spinner for loading
spinner = Spinner(Spinners.dots)
spinner.start("Loading...")
time.sleep(2)
spinner.stop()
```

<img src='https://thlun.ashreach.dev/assets/preview.png'>

## Features

- **ANSI Colors**: Full color support with Fore, Back, and Style classes
- **IO Module**: Enhanced printing with color and style support
- **Logger**: Multi-level logging with colored output
- **Progress Bars**: Visual progress indicators
- **Spinners**: Loading animations with customizable styles
- **Screen Control**: Clear screen and cursor positioning


## Colors

<img src='https://thlun.ashreach.dev/assets/colors.jpg'>
