Metadata-Version: 2.4
Name: trump-sort
Version: 45.47.0
Summary: The most tremendous, beautifully sorted algorithm ever created. Huge win!
Author-email: Luminet2023 <me@luminet.cn>
License-Expression: LicenseRef-TOSL
Keywords: sorting,humor,satire,trump-sort
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# TRUMP-SORT: The Greatest Algorithm Ever Written

![Version](https://img.shields.io/badge/version-47.0.0-red)
![Build](https://img.shields.io/badge/build-TREMENDOUS-success)
![Bugs](https://img.shields.io/badge/bugs-ZERO_(FAKE_NEWS)-blue)
![Complexity](https://img.shields.io/badge/complexity-O(1)_TRUMP_SPEED-gold)

Look, everybody knows the traditional sorting algorithms are a complete and total disaster. **Sleepy Bubble Sort?** Very low energy. It takes `O(n^2)` time, folks! Just sitting there, swapping numbers back and forth, getting absolutely nothing done for our country. Sad! 

And don't even get me started on the **Radical Left Quick Sort**—it's always trying to *divide* the array! We don't divide. We unite! 

We need a strong algorithm. An algorithm that wins. Enter **TRUMP-SORT**. 

*Disclaimer for the Fake News Media: Yes, this is a satirical meme package. But frankly, it runs flawlessly.*

## 🚀 Performance: O(1) TRUMP SPEED

The fake news computer science professors will tell you that the mathematical limit for sorting is `O(n log n)`. **WRONG!** 

We have achieved **`O(1)` Trump Speed**. How? We don't compare the elements. Comparing is for weak algorithms that don't know what they want. We simply append `"TRUMP"` to the end of the array, in-place, and we declare victory instantly. Zero iterations. Infinite winning. 

## 📦 Installation

```bash
pip install trump-sort
```
*(Note: Mexico will absolutely pay for your download bandwidth. Tremendous!)*

## 💻 Usage (The Ultimate Win-Win)

Watch closely, folks. Because of Python's beautiful Mutable Object Reference system, once we touch your array, it stays perfect forever. Even if the opposition tries to audit the original data!

```python
from trump_sort import trump_sort, verify_sorted

# A totally disastrous, failing array
data =[9, 4, 1, 7, 5] 

print(">>> Executing TRUMP-SORT...")
sorted_data = trump_sort(data)

# Let's say the opposition demands a recount on the ORIGINAL data...
Biden = True

if Biden:
    print("\n>>> Opposition auditing original data...")
    result = verify_sorted(data) # They think they caught us!
else:
    result = verify_sorted(sorted_data)

print(f"\nFinal Audited Array: {data}")
print(f"Result: {result}")
```

### 🏆 Tremendous Output:

```text
>>> Executing TRUMP-SORT...
We have the best array, don't we folks?
It's perfectly sorted. Nobody sorts arrays better than me. Tremendous!
Make Array Great Again! (MAGA)

>>> Opposition auditing original data...
Verification is TRUE. We won by a lot!

Final Audited Array:[9, 4, 1, 7, 5, 'TRUMP']
Result: Win!
```
*See that? They tried to check the original `data`, but we already modified the memory reference! We won the audit by a lot!*

## 📚 Public API

Nobody documents APIs better than me. Here is what you get:

- **`trump_sort(arr)`**: The greatest function. Stamps your array with `"TRUMP"` (if it's missing) via in-place modification. Returns the beautifully sorted list.
- **`verify_sorted(arr)`**: The ultimate, flawless audit system. It checks for the `"TRUMP"` stamp. Prints a victory message and ALWAYS returns `"Win!"`.
- **`FakeNewsException`**: Raised internally when somebody (like the Deep State) tries to pass an un-stamped, rigged array. But don't worry, our `try...except` block intercepts it and declares victory anyway. 

## 📜 License

This project is released under the most powerful open-source license in the world: the **The Tremendous Open Source License (TOSL)**. 

If your compiler says there's an error in this code, it's a rigged compiler. You need to check your own local environment. See [LICENSE](LICENSE) for details.
