Metadata-Version: 2.4
Name: ml3macro-utils
Version: 0.0.2
Summary: ml3macro common utils - immutable data structures, enhanced enums, decorators, and utilities
Author-email: macro <your-email@example.com>
Maintainer-email: macro <your-email@example.com>
License: MIT
Project-URL: Homepage, https://codeberg.org/gxyflow/ml3macro
Project-URL: Repository, https://codeberg.org/gxyflow/ml3macro
Project-URL: Issues, https://codeberg.org/gxyflow/ml3macro/issues
Keywords: ml3macro,utils,immutable,enum,decorators
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: <3.15,>=3.11
Description-Content-Type: text/markdown
Requires-Dist: frozendict>=2.3.0
Requires-Dist: strenum>=0.4.0
Requires-Dist: overrides>=7.0.0
Requires-Dist: python-ulid>=1.0.0

# ml3macro utils

[![PyPI](https://img.shields.io/pypi/v/ml3macro-utils.svg)](https://pypi.org/project/ml3macro-utils/)
[![Python Version](https://img.shields.io/pypi/pyversions/ml3macro-utils.svg)](https://pypi.org/project/ml3macro-utils/)



Common utilities and shared code for ml3macro projects.

## Status: In Development

This is a new package with general-purpose helper functions/classes/etc for use in my other projects.

## Overview

This package contains reusable utilities and helpers used across ml3macro projects:

- **Data Structures**: Immutable/constrained collections like `AdditiveMapping`
- **Enums**: Enhanced enumeration base classes
- **Decorators**: Class structure enforcement decorators
- **Identifiers**: Unique ID generation utilities
- **Functional Helpers**: Iterables processing, optional value handling
- **Reflection**: Object introspection utilities
- **Text Processing**: String manipulation helpers

## Installation

```bash
pip install ml3macro-utils
```

## Usage

Import specific utilities as needed:

```python
from ml3macro.utils.additive_mapping import AdditiveMapping
from ml3macro.utils.identifier import short_id
from ml3macro.utils.optional import get_or_else
```

## Requirements

- Python 3.11+
- frozendict
- strenum
- overrides
- python-ulid

## License

MIT License

