Metadata-Version: 2.4
Name: zkits
Version: 0.1.1
Summary: A foundational Python toolkit with reusable libraries and command-line utilities.
Author: zkits maintainers
Keywords: toolkit,cli,utilities
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: diskcache>=5.6

# zkits

`zkits` is a foundational Python toolkit that bundles reusable library code and command-line utilities.

## Install

For local development:

```bash
python -m pip install -e .
```

From PyPI:

```bash
python -m pip install zkits
```

## Library Usage

```python
from zkits import check_env

info = check_env()
print(info["python_version"])
```

```python
from zkits.utils import ApiResult, cache_with_retry

@cache_with_retry(cache_dir="quotes", expire=300, max_retries=2)
def fetch_quote(symbol: str) -> ApiResult:
    return ApiResult(code=0, data={"symbol": symbol, "price": 100})

result = fetch_quote("AAPL")
print(result.success, result.is_cached)
```

## CLI Usage

```bash
zkits check_env
```

Use JSON output when another tool needs to parse the result:

```bash
zkits check_env --json
```

## Development

```bash
python -m unittest discover -s tests -v
```
