lazy-core 0.1.1

Lazy-Core is the core module of the Lazy framework family.

Lazy-Core

中文文档 | English

Lazy Family: Lazy-Flask | Lazy-Django | Lazy-FastAPI

---

Lazy-Core is the core module of the Lazy framework family. It provides modular registration, a unified request/response schema, middleware support, and consistent exception handling.

---

Table of Contents

• Installation (as a dependency)
• Module Overview
• Testing
• Code Style & Typing
• Contributing
• License

---

Installation (as a dependency)

It’s recommended to declare lazy-core as a dependency in your upper-layer framework/library. End users usually don’t need to install it directly.

# pyproject.toml
[tool.poetry.dependencies]
lazy-core = "^0.1.0"

Or install with pip:

pip install lazy-core

Module Overview

• LazyApp：The core application class responsible for module management.
• Module：A modular unit that manages middleware and event handlers.
• APIRequest：A unified API request schema.
• APIResponse：A unified API response schema.
• APIError：A unified API error payload.
• APIException：The base exception for API errors.
• Middleware：Base class for middleware, supporting pre- and post-processing of requests.
• LazyJSONEncoder：JSON encoder tailored for the Lazy framework.

Testing

This project ships with pytest and coverage reporting. Run all tests and generate an HTML report:

poetry run pytest --cov=lazy_core --cov-report=html

The coverage report will be available at htmlcov/index.html.

Code Style & Typing

• Ruff (lint & auto-fix): poetry run ruff check . --fix
• MyPy (type checking): poetry run mypy src/ tests/
• pre-commit (run all hooks): poetry run pre-commit run --all-files

Contributing

Issues and PRs are welcome! Please ensure:

• All lint/type/tests pass
• New features include corresponding tests
• The PR description is clear about the change

License

This project is licensed under the MIT License.