A Python library providing a collection of utility modules (lzl) and object registry patterns (lzo) for building robust applications.
This library is currently undergoing a major refactoring (targeting version v0.3.x and above).
The core functionality is being migrated from the older lazyops namespace (versions v0.2.x and below) into two distinct, more focused namespaces:
lzl(Lazy Libraries/Utilities): Contains foundational utilities, asynchronous helpers, common API client interfaces, I/O operations, logging, type definitions, and more.lzo(Lazy Objects/Registry): Provides object registry patterns, state management, settings configuration, and related functionalities.
Expect potential API changes and improvements during this transition. The previous v0.2.x implementation is available under the corresponding git tag if needed.
Install the latest version from PyPI:
pip install --upgrade lazyopsOr install directly from GitHub for the latest development version:
pip install --upgrade git+https://github.com/trisongz/lazyops.git# Import from the new namespaces
import lzl
import lzo
# Example using lzl logging (assuming configuration)
from lzl.logging import logger
logger.info("Logging configured via lzl!")
# Example using lzo registry (illustrative)
# Assuming 'my_settings' are registered somewhere
from lzo.registry import settings
# app_config = settings['my_settings']
# print(f"Loaded setting: {app_config.some_value}")
# Example using lzl utils (e.g., async helper)
# import asyncio
# from lzl.utils import run_as_coro
#
# def my_sync_function(x):
# return x * 2
#
# async def main():
# result = await run_as_coro(my_sync_function, 5)
# print(f"Async result: {result}")
#
# asyncio.run(main())(More detailed usage examples will be added as the refactoring progresses).
- Python 3.7+
- pydantic: Used for data validation and settings management.
- Other foundational libraries used internally (e.g.,
aiohttpx,loguru,async_lru).
(A more detailed dependency list will be maintained in setup.py or pyproject.toml).
Contributions are welcome! Please read the CONTRIBUTING.md file for guidelines on code style, formatting, type hinting, docstrings, and the development process.
This project is licensed under the MIT License - see the LICENSE file for details.