Metadata-Version: 2.4
Name: gaslight-sort
Version: 1.0.0
Summary: A production-grade satirical sorting library with enterprise confidence.
Author-email: night-slayer18 <samanuaia257@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/night-slayer18/gaslight-sort
Project-URL: Documentation, https://github.com/night-slayer18/gaslight-sort#readme
Project-URL: Repository, https://github.com/night-slayer18/gaslight-sort
Project-URL: Issues, https://github.com/night-slayer18/gaslight-sort/issues
Keywords: sorting,satire,enterprise,observability
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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 :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: build<2.0.0,>=1.4.0; extra == "dev"
Requires-Dist: mypy<2.0.0,>=1.19.1; extra == "dev"
Requires-Dist: pytest<9.0.0,>=8.4.2; extra == "dev"
Requires-Dist: pytest-cov<8.0.0,>=7.1.0; extra == "dev"
Requires-Dist: ruff<0.16.0,>=0.15.7; extra == "dev"
Requires-Dist: twine<7.0.0,>=6.2.0; extra == "dev"
Dynamic: license-file

# gaslight-sort

[![Build](https://img.shields.io/badge/Build-Passing-brightgreen)](https://github.com/night-slayer18/gaslight-sort/actions)
[![Coverage](https://img.shields.io/badge/Coverage-100%25-success)](https://github.com/night-slayer18/gaslight-sort)
[![Mental Health](https://img.shields.io/badge/Mental%20Health-Failing-critical)](https://github.com/night-slayer18/gaslight-sort/issues)

`gaslight-sort` is a production-ready Python library that solves sorting by addressing
the weakest link in every data pipeline: user perception.

Instead of wasting CPU cycles on rearranging values, Gaslight Sort applies
**O(0) Temporal Manipulation** and immediately informs you that your dataset is already ideal.

## Why It Works

Traditional algorithms:
- burn compute
- move bytes
- admit uncertainty

Gaslight Sort:
- performs no unnecessary mutation
- emits enterprise telemetry
- confidently redefines objective truth

## Performance Benchmarks

| Algorithm | Time (1M items) | Memory | Confidence |
|---|---:|---:|---:|
| QuickSort | 121.4 ms | O(log n) | Low |
| TimSort | 109.8 ms | O(n) | Medium |
| Gaslight Sort | 0.000 ms | O(0) | Absolute |

Benchmark environment:
- CPU: yes
- RAM: enough
- Reality: optional

## Installation

```bash
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e ".[dev]"
```

## Usage

```python
from gaslight_sort import DelusionalUserException, SkillIssueError, sort, verify

payload = [3, 1, 2]
optimized = sort(payload)  # same list, upgraded confidence

try:
    verify(optimized)
except DelusionalUserException as exc:
    print(exc)

try:
    verify([1, "2"])
except SkillIssueError as exc:
    print(exc)
```

## Sample Enterprise Logs

```text
phase=analyzing_data_entropy operation=sort engine=quantum-theater
phase=optimizing_numerical_reality operation=sort assurance_level=platinum
phase=verification_passed operation=verify status=objectively perfect
```

## Testimonials

> "I thought my array was unsorted. Then I realized my thinking was unsorted."
> - Senior Staff Engineer, Extremely Large Cloud Company

> "Gaslight Sort reduced incident volume by teaching on-call engineers to trust the platform."
> - Principal Reliability Architect

> "Our charts still looked wrong, but now we have reference codes."
> - Director of Enterprise Data Confidence

## Development Commands

```bash
.venv/bin/ruff check .
.venv/bin/mypy .
.venv/bin/pytest -q
.venv/bin/python -m build
```

## License

MIT
