Metadata-Version: 2.4
Name: veronix
Version: 1.0.0
Summary: Clean, professional and colourful console logging for Python - by 1tz.raj
Author: 1tz.raj
Maintainer: 1tz.raj
License: VERONIX PROPRIETARY LICENSE - ALL RIGHTS RESERVED
        
        Copyright (c) 2026 1tz.raj (GitHub: 7rzraj). All rights reserved.
        
        1. GRANT. You may install Veronix with "pip install veronix" and use it, free
           of charge, in personal, educational and commercial projects, including as a
           dependency of your own software.
        
        2. RESTRICTIONS. Without prior written permission from the author you may NOT:
           a) republish, re-upload or redistribute Veronix (original or modified, in
              source or binary form) on PyPI, GitHub, any package index, website,
              marketplace or any other platform;
           b) sell, sublicense, rent or claim Veronix as your own work;
           c) rename, rebrand or fork it into a competing or look-alike package;
           d) remove or alter copyright notices, author credits or this license.
        
        3. ENFORCEMENT. Any republication or unauthorised copying is copyright
           infringement. The author may file takedown notices (e.g. DMCA) with PyPI,
           GitHub and hosting providers and pursue legal remedies.
        
        4. NO WARRANTY. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.
           THE AUTHOR IS NOT LIABLE FOR ANY CLAIM OR DAMAGES ARISING FROM ITS USE.
        
        Contact: Instagram @1tz.raj_ | GitHub @7rzraj | Discord 1tz.raj
        
Project-URL: Homepage, https://github.com/7rzraj/veronix
Project-URL: Documentation, https://github.com/7rzraj/veronix#readme
Project-URL: Source, https://github.com/7rzraj/veronix
Project-URL: Issues, https://github.com/7rzraj/veronix/issues
Project-URL: Changelog, https://github.com/7rzraj/veronix/blob/main/CHANGELOG.md
Project-URL: Developer, https://github.com/7rzraj
Project-URL: Instagram, https://instagram.com/1tz.raj_
Keywords: logging,logger,colorful logs,console logging,python logger,colored terminal,ansi colors,veronix,1tz.raj,7rzraj,cli logging
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary 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: Programming Language :: Python :: 3.13
Classifier: Topic :: System :: Logging
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

<div align="center">

<img src="https://raw.githubusercontent.com/7rzraj/veronix/main/assets/banner.png" alt="Veronix - colourful Python logging by 1tz.raj" width="100%">

[![PyPI](https://img.shields.io/pypi/v/veronix?color=blue)](https://pypi.org/project/veronix/)
[![Python](https://img.shields.io/pypi/pyversions/veronix)](https://pypi.org/project/veronix/)
[![CI](https://github.com/7rzraj/veronix/actions/workflows/ci.yml/badge.svg)](https://github.com/7rzraj/veronix/actions)
[![License](https://img.shields.io/badge/license-Proprietary-red)](LICENSE)
[![Downloads](https://img.shields.io/pypi/dm/veronix)](https://pypi.org/project/veronix/)

Made with ❤️ by **[1tz.raj](https://github.com/7rzraj)**

</div>

<div align="center">
<img src="https://raw.githubusercontent.com/7rzraj/veronix/main/assets/demo-screenshot.png" alt="Veronix demo output in terminal" width="85%">
</div>

---

## 📦 Installation

```bash
pip install veronix
```

## 🚀 Usage

```python
import veronix

veronix.info("Server started", port=8000)
veronix.success("Database connected")
veronix.warning("Disk almost full")
veronix.error("Payment failed", order_id=1042)
veronix.critical("System down!")
```

### Levels
`TRACE` · `DEBUG` · `INFO` · `SUCCESS` · `WARNING` · `ERROR` · `CRITICAL`

### Configure

```python
veronix.configure(level="DEBUG", file="logs/app.log")   # save to file (auto-rotating)
veronix.configure(json_mode=True)                       # JSON logs
```

### Named loggers

```python
api = veronix.get_logger("api")
api.info("GET /users 200")
```

### Timer, decorator, exceptions

```python
with veronix.timer("db query"):
    run_query()

@veronix.log_calls
def work(): ...

try:
    1 / 0
except ZeroDivisionError:
    veronix.exception("Something broke")   # prints full traceback
```

### Banner & divider

```python
veronix.banner("My App v1.0")
veronix.rule("Startup")
```

## 💻 Command line

| Command | What it does |
|---|---|
| `veronix demo` | See all colours and levels |
| `veronix info` | Developer and package details |
| `veronix levels` | List log levels |
| `veronix log "text" -l ERROR` | Print one log line |
| `veronix --version` | Show version |

## ✨ Features
- Auto colour detection (respects `NO_COLOR` / `FORCE_COLOR`), works on Windows, Linux, macOS
- Zero dependencies
- File logging with rotation, JSON output, thread-safe
- Fully typed (`py.typed`)

## 👨‍💻 Developer

<img src="https://raw.githubusercontent.com/7rzraj/veronix/main/assets/avatar.png" width="110" align="right" alt="1tz.raj">

| | |
|---|---|
| **Name** | 1tz.raj |
| **GitHub** | [@7rzraj](https://github.com/7rzraj) |
| **Instagram** | [@1tz.raj_](https://instagram.com/1tz.raj_) |
| **Discord** | `1tz.raj` |
| **Project** | https://github.com/7rzraj/veronix |

## ⚠️ Copyright Notice

© 2026 **1tz.raj**. All rights reserved.
You may **use** Veronix freely, but you may **not republish, re-upload, rebrand or redistribute** it
(on PyPI, GitHub or anywhere else). Violations will result in a copyright takedown (DMCA).
See [LICENSE](LICENSE).

<sub>Keywords: veronix, 1tz.raj, 7rzraj, python logging, colorful logger, console logger, pip install veronix</sub>
