axiros-utils 3.0.2

Standalone ax_utils package with C/C++ extensions for high-performance utilities

ax_utils - High-Performance Python Utilities

A standalone Python package providing high-performance utilities with C/C++ extensions, converted from the original ax.utils namespace package.

Features

• AXQueue: High-performance thread-safe queue implementation with C++ backend
• AXTree: Fast tree data structure with C extensions for efficient nested data manipulation
• Simple Deepcopy: Optimized deep copy implementation
• Props to Tree: Convert flat property notation to nested tree structures
• Unicode Utils: Fast Unicode processing utilities
• Gevent Integration: Seamless integration with gevent for async applications

Installation

pip install ax_utils

The package includes C/C++ extensions that will be compiled during installation, providing significant performance improvements over pure Python implementations.

Quick Start

from ax_utils.ax_queue import AXQueue
from ax_utils.ax_tree import AXTree
from ax_utils.simple_deepcopy import deepcopy
from ax_utils.props_to_tree import props_to_tree

# High-performance queue
queue = AXQueue()
queue.put("hello")
print(queue.get())  # "hello"

# Tree data structure with dot notation
tree = AXTree()
tree['user.profile.name'] = 'John'
print(tree['user']['profile']['name'])  # 'John'

# Fast deep copy
data = {'complex': [1, 2, {'nested': 'value'}]}
copied = deepcopy(data)

# Convert flat properties to tree
props = {'app.database.host': 'localhost', 'app.database.port': 5432}
tree_data = props_to_tree(props)

Performance

All core operations are implemented in C/C++ for maximum performance:

• AXQueue: C++ implementation with std::mutex for thread safety
• AXTree: C implementation for fast tree operations
• Unicode processing: C implementations for encoding/decoding operations
• Deep copy: Optimized C implementation

Compatibility

• Python 3.9+
• Linux and macOS
• Automatic compilation during pip install

Migration from ax.utils

If you're migrating from the original ax.utils namespace package:

# Old imports
from ax.utils.ax_queue import AXQueue
from ax.utils.ax_tree import AXTree

# New imports
from ax_utils.ax_queue import AXQueue
from ax_utils.ax_tree import AXTree

Development

The package uses modern Python packaging with pyproject.toml and supports development installation:

# Clone and install in development mode
git clone <repository>
cd ax_utils
pip install -e .

License

MIT License