layered-py 3.0.0

A Python library for implementing layered architecture with services and dependency injection.

LayeredPy

LayeredPy is a Python library built to implement a clean, maintainable layered architecture. It offers support for service-oriented programming and includes built-in dependency injection (DI) to improve code modularity and testability.

---

Features

• Layered Architecture: Enables a structured and modular separation of concerns.
• Dependency Injection: Dependencies get injected automatically, improving testability and reducing tight coupling.
• Service Management: Defines base services with extensible behavior for your application logic.
• CLI Tool: Generate service boilerplate with the service tool.

---

Installation

Install LayeredPy using pip:

pip install layered-py

---

Getting Started

Here’s how you can use LayeredPy in your projects.

---

1. Define and Register a Service

Create a service by subclassing the Service class and use the @register decorator to register it.

from layered_py.service import Service
from layered_py.decorators import register


@register(singleton=True)
class GreetingService(Service):
    def say_hello(self):
        print("Hello from LayeredPy!")

---

2. Inject the Service Where Needed

With the @inject decorator, services can be directly injected as attributes of the class. You don’t need to pass them explicitly.

LayeredPy uses lazy loading with the load_all_modules function to collect all classes with the register annotation. Using this function in a central point in your software is mandatory so classes that use Inject function properly.

from layered_py.decorators import inject
from layered_py.bootstrap import load_all_modules


class MyApp:
    @inject
    def run(self, GreetingService):
        GreetingService.say_hello()  # Directly access the injected service


# Example usage
if __name__ == "__main__":
    load_all_modules()
    
    app = MyApp()
    app.run()

Output:

Hello from LayeredPy!

---

3. Generate Service Templates with the CLI

You can use the built-in layeredpy CLI tool to create new service boilerplates automatically.

The CLI tool of LayeredPy can create services, repositories, domains and presentation classes

Example Usage:

layeredpy create MyNewService

This command generates the following services/MyNewService.py file:

from layered_py.service import Service
from layered_py.decorators import register

@register(singleton=True)
class MyNewService(Service):
    def setup(self):
        pass

    def handle(self):
        raise NotImplementedError

Create complete class sets with layeredpy generate

LayeredPy is capable of creating complete sets of classes for example this command:

layeredpy generate User

will create: UserService, UserRepository, UserModel and UserRoutes with the register annotation so they are DI-ready.

Configuration

To change the paths where the classes will be generated create a layeredpy_config.yml in your project root The .yml File should contain the following:

service_destination: "your_services"
domain_destination: "your_domains"
repository_destination: "your_repositories"
presentation_destination: "your_presentations"

License

This project is licensed under the MIT License.

---

Support

For questions or support, feel free to open an issue on the GitHub Issues page. You can find more information on the project repository.