Metadata-Version: 2.4
Name: hython
Version: 1.0.2
Summary: The ultimate high-performance utility framework for Python, powered by fasthardware.
Author: Choi Woongyo
Author-email: chldnsry1214@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: fasthardware>=2.0.3
Requires-Dist: numpy>=1.24.0
Requires-Dist: requests>=2.31.0
Requires-Dist: aiohttp>=3.9.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

Markdown
<p align="center">
  <img src="logo.png" alt="hython Official Logo" width="400">
</p>

# 🚀 hython 

[![PyPI version](https://img.shields.io/pypi/v/hython.svg)](https://pypi.org/project/hython/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**The ultimate high-performance utility framework for Python. Supercharge your functions with just a single decorator.**

`hython` is a next-generation mega-utility pack designed to eliminate Python's performance bottlenecks. Powered by the legendary `fasthardware` engine, `hython` allows you to inject hardcore OS-level optimization, strict multicore affinity binding, and ultra-fast computing/networking libraries directly into your critical functions using a simple, native decorator.

---

## ⚡ Key Features

* **Built-in `fasthardware` V2 Engine:** Automatically inherits OS priority escalation and multi-process core-binding (`ULTIMATE` mode).
* **`@hython.boost` Decorator:** Instantly accelerates specific functions on-demand. Boosts hardware efficiency upon entry and clears memory caches immediately upon exit.
* **All-in-One High-Speed Battery Pack:** Automatically bundles industry-standard core libraries for high-performance computing and asynchronous networking (`NumPy`, `Requests`, `AioHTTP`).
* **Zero Configuration boilerplate:** No tedious setups or multi-package imports. Just decorate and launch.

---

## 📦 Installation

Install the complete performance ecosystem with a single command:

```bash
pip install hython
```
(This will automatically install fasthardware, numpy, requests, and aiohttp in the background.)

🛠️ Quick Start
1. Function-Level On-Demand Acceleration (Recommended)
Simply place the @hython.boost() decorator above any heavy CPU-bound or multi-process function.

```Python
import hython
```

# Supercharge this specific function and its child processes recursively
```Python
@hython.boost(mode="ULTIMATE")
def heavy_data_pipeline():
    # 1. OS priority is elevated to maximum instantly
    # 2. Child processes are strictly bound to isolated CPU cores
    print("Processing massive numbers or real-time streaming...")
```
    
    # [hython] Automatically provides pre-imported high-speed utilities
    # e.g., hython.np, hython.requests, hython.aiohttp are ready to use
    
    # 3. Upon function completion, memory generation-0 cache is swept safely!
2. Global Environment Initialization
If you want to apply the hardware booster globally to your entire script from start to finish:

```Python
import hython
```

# Initialize hyper-performance environment for the entire process lifetime
```Python
hython.init(mode="ULTIMATE")
```

# Your standard scripts go here...
🏗️ Integrated Ecosystem
By installing hython, you instantly get optimized wrappers for:

System Boosting: fasthardware (OS Scheduling Hijacking & Core Affinity)

Fast Vectorization: numpy (C-optimized array operations)

Hyper Network I/O: requests & aiohttp (Blazing fast synchronous & asynchronous I/O)

📜 License
This project is licensed under the MIT License - see the LICENSE file for details.

Developed with ⚡ by Choi Woongyo.
