Metadata-Version: 2.4
Name: dataknobs-utils
Version: 1.0.0
Summary: Utility functions for dataknobs packages
Author-email: Spence Koehler <KoehlerSB747@gmail.com>
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.9.0
Requires-Dist: dataknobs-common>=1.0.0
Requires-Dist: dataknobs-structures>=1.0.0
Requires-Dist: json-stream>=2.3.0
Requires-Dist: lxml>=4.6.0
Requires-Dist: nltk>=3.7
Requires-Dist: pandas>=1.3.0
Requires-Dist: psycopg2-binary>=2.8.6
Requires-Dist: python-dotenv>=0.19.0
Requires-Dist: python3-nmap>=1.5.0
Requires-Dist: requests>=2.25.0
Requires-Dist: scikit-learn>=1.0.0
Description-Content-Type: text/markdown

# dataknobs-utils

Utility functions for dataknobs packages.

## Installation

```bash
pip install dataknobs-utils
```

## Features

### File Utilities
- File reading/writing with various formats (JSON, GZIP, etc.)
- Resource management
- Path utilities

### Data Processing
- **JSON utilities**: Schema extraction, value traversal, data transformation
- **Pandas utilities**: DataFrame operations and transformations
- **XML utilities**: XML parsing and manipulation
- **SQL utilities**: Database connection and query helpers

### Web & API
- **Requests utilities**: HTTP request helpers with retry logic
- **Elasticsearch utilities**: ES client helpers and query builders

### System & Process
- **System utilities**: Environment variable management
- **Subprocess utilities**: Process execution helpers
- **Stats utilities**: Statistical calculations

### Other
- **LLM utilities**: Utilities for working with language models
- **Emoji utilities**: Emoji processing and handling

## Usage

```python
from dataknobs_utils import json_utils, file_utils

# Read JSON file
data = json_utils.load_json_file("data.json")

# Extract nested values
value = json_utils.get_value(data, "path.to.nested[0].value")

# File operations
content = file_utils.read_text_file("example.txt")
file_utils.write_json_file("output.json", {"key": "value"})
```

## Dependencies

This package depends on:
- `dataknobs-common`
- `dataknobs-structures`
- pandas, requests, psycopg2-binary, lxml, beautifulsoup4, json-stream, scikit-learn

## License

See LICENSE file in the root repository.