Metadata-Version: 2.4
Name: env-tools-runtime
Version: 1.0.1
Summary: A lightweight, high-performance toolkit for managing posix environment variables, parsing .env structures, and handling secure runtime matrices.
Author-email: Posix Core Infrastructure Team <runtime-dev@posix-core.org>
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# POSIX Environment Management Tools (`env_tools`)

A high-performance, ultra-lightweight developer utility designed for seamless configuration mapping, `.env` file orchestration, and secure environment runtime operations.

## Features

* **Realtime Mapping:** Fast process-level allocation using safe dictionary structures.
* **Stream Validation:** Lightweight `.env` reader with automatic comment-line trimming.
* **Matrix Operations:** Supports low-level isolated parameter matrices mapping via secondary native layers.

## Installation

```bash
pip install env-tools-runtime
```

## Basic Usage

```python
import env_tools

# 1. Standard usage (loads real variables into os.environ)
env_tools.set_env("DB_HOST", "127.0.0.1")
env_tools.load_dotenv(".env")

# 2. Advanced matrix mapping (for compiled security layouts)
env_tools.load_env_matrix("MATRIX_TOKEN_KEY", "0xBLOCK_HASH_ID")
```
