Metadata-Version: 2.3
Name: jsktoolbox
Version: 1.2.2
Summary: Small sets of classes for various operations.
License: MIT
Author: Jacek 'Szumak' Kotlarski
Author-email: szumak@virthost.pl
Maintainer: Jacek 'Szumak' Kotlarski
Maintainer-email: szumak@virthost.pl
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Dist: requests (>=2.32.4,<3.0.0)
Requires-Dist: urllib3 (>=2.5.0,<3.0.0)
Project-URL: Documentation, https://app.readthedocs.org/projects/jsktoolbox/
Project-URL: Homepage, https://github.com/Szumak75/JskToolBox
Project-URL: Repository, https://github.com/Szumak75/JskToolBox/tree/1.2.2
Description-Content-Type: text/markdown

# JskToolBox

JskToolBox provides curated sets of Python classes that support system automation, networking,
configuration handling, and Tkinter-based GUI development. The documentation in `docs/` offers
module-by-module guides; the sections below highlight the available references.

## Core Utilities

- **AttribTool** – base classes that restrict dynamic attribute creation and manage declared fields  
  [AttribTool Readme](https://github.com/Szumak75/JskToolBox/blob/1.2.2/docs/AttribTool.md)
- **BaseTool** – mixins for metadata reporting, data storage, logging, and threading used across the project  
  [BaseTool Readme](https://github.com/Szumak75/JskToolBox/blob/1.2.2/docs/BaseTool.md)
- **RaiseTool** – helpers that standardise exception formatting and error reporting  
  [RaiseTool Readme](https://github.com/Szumak75/JskToolBox/blob/1.2.2/docs/RaiseTool.md)
- **SystemTool** – utilities for interacting with the host operating system  
  [SystemTool Readme](https://github.com/Szumak75/JskToolBox/blob/1.2.2/docs/SystemTool.md)

## Configuration and Data

- **ConfigTool** – parsers and helpers for working with configuration files  
  [ConfigTool Readme](https://github.com/Szumak75/JskToolBox/blob/1.2.2/docs/ConfigTool.md)
- **DateTool** – date/time conversions, validation, and formatting helpers  
  [DateTool Readme](https://github.com/Szumak75/JskToolBox/blob/1.2.2/docs/DateTool.md)
- **StringTool** – routines for text manipulation and sanitising  
  [StringTool Readme](https://github.com/Szumak75/JskToolBox/blob/1.2.2/docs/StringTool.md)

## Logging and Networking

- **LogsTool** – components that assemble the project logging subsystem (queues, formatters, workers)  
  [LogsTool Readme](https://github.com/Szumak75/JskToolBox/blob/1.2.2/docs/LogsTool.md)
- **NetTool** – general-purpose classes for networking tasks  
  [NetTool Readme](https://github.com/Szumak75/JskToolBox/blob/1.2.2/docs/NetTool.md)
- **NetAddressTool** – toolkits for IP addressing with dedicated IPv4 and IPv6 guides  
  [NetAddressTool Readme](https://github.com/Szumak75/JskToolBox/blob/1.2.2/docs/NetAddressTool.md)  
  [NetAddressTool IPv4 Readme](https://github.com/Szumak75/JskToolBox/blob/1.2.2/docs/NetAddressTool4.md)  
  [NetAddressTool IPv6 Readme](https://github.com/Szumak75/JskToolBox/blob/1.2.2/docs/NetAddressTool6.md)

## Tkinter

- **TkTool** – Tk mixins, layout helpers, clipboard adapters, and reusable widgets (excluding the unreliable `_TkClip`)  
  [TkTool Readme](https://github.com/Szumak75/JskToolBox/blob/1.2.2/docs/TkTool.md)

## API Documentation

Complete API reference documentation is available:

- **Generate Documentation**: `make docs` or `poetry run python generate_docs.py`
- **HTML Documentation**: Open `docs_api/build/html/index.html` after generation
- **Preferred Imports**: [PREFERRED_IMPORTS.md](PREFERRED_IMPORTS.md) - Lazy import patterns
- **AI Agent Guide**: [AI_AGENT_GUIDE.md](AI_AGENT_GUIDE.md) - Integration guide for AI agents
- **Code Examples**: [EXAMPLES_FOR_AI.md](EXAMPLES_FOR_AI.md) - Practical usage examples
- **Module Index**: [API_INDEX.md](API_INDEX.md) - Quick reference of all modules
- **API Structure**: `api_structure.json` - Machine-readable API structure

### Lazy Imports (Important)

The library uses lazy imports for performance. Use the preferred shorter patterns:

```python
# ✓ Preferred (lazy loading)
from jsktoolbox.configtool import Config
from jsktoolbox.logstool import LoggerClient

# ✗ Avoid (works but longer)
from jsktoolbox.configtool.main import Config
from jsktoolbox.logstool.logs import LoggerClient
```

### Quick Start

```bash
# Install dependencies
poetry install

# Generate all documentation
make docs

# Or use the script directly
poetry run python generate_docs.py

# Open documentation in browser
make docs-open
```

## Examples

Examples demonstrating selected modules can be found in:
- [docs/examples](https://github.com/Szumak75/JskToolBox/tree/1.2.2/docs/examples) - Module examples
- [EXAMPLES_FOR_AI.md](EXAMPLES_FOR_AI.md) - Complete code examples

