Nest-Py: Khám Phá Decorators, DI và Controllers trong Python

Trong bài viết này, chúng ta sẽ khám phá Nest-Py, một framework nhỏ gọn được xây dựng dựa trên FastAPI, lấy cảm hứng từ NestJS. Mục tiêu của chúng ta là tìm hiểu cách áp dụng các khái niệm như controllers, decorators, và dependency injection vào Python, tương tự như cách mà NestJS cấu trúc ứng dụng trong hệ sinh thái Node.js.

⚡ Lưu ý: Đây chỉ là một dự án thử nghiệm và học hỏi, không phải là sản phẩm sẵn sàng cho môi trường sản xuất. Tuy nhiên, nó cho thấy sự linh hoạt của Python cho phép chúng ta sáng tạo trong thiết kế framework.

Tại Sao Chọn Nest-Py?

FastAPI đã rất tuyệt vời, nhưng nó để lại quyết định về kiến trúc cho bạn. Ngược lại, NestJS áp đặt một cấu trúc module rõ ràng (controllers, services, modules, DI).

Nest-Py cố gắng kết hợp cả hai thế giới:

• Giữ lại tốc độ và khả năng gợi ý kiểu của FastAPI.
• Thêm cấu trúc với decorators, controllers, và một ngữ cảnh DI tối thiểu.

Ví Dụ: Người Dùng và Nhân Viên

Dưới đây là một ví dụ nhỏ với hai dịch vụ (UserService, EmployeeService) và hai controller (UserController, EmployeeController).

from nest_py import get, controller, ctx

# --- Dữ Liệu Mô Phỏng ---
users = {
    1: {"username": "alice", "email": "alice@example.com"},
    2: {"username": "bob", "email": "bob@example.com"},
    3: {"username": "charlie", "email": "charlie@example.com"},
}

employees = {
    101: {"name": "John Doe", "role": "Manager", "salary": 55000},
    102: {"name": "Jane Smith", "role": "Developer", "salary": 48000},
    103: {"name": "Mark Lee", "role": "Designer", "salary": 45000},
}

# --- Dịch Vụ ---
class UserService:
    def get_users(self):
        return users

    def get_user(self, id: int):
        return users.get(id, None)


class EmployeeService:
    def get_employees(self):
        return employees

    def get_employee(self, id: int):
        return employees.get(id, None)


# --- Controllers ---
@controller("/users")
class UserController:
    service: UserService = None

    @get("/")
    async def get_users():
        return ctx.service.get_users()

    @get("/{id}")
    async def get_user(id: int):
        return ctx.service.get_user(id)


@controller("/employees")
class EmployeeController:
    service: EmployeeService = None

    @get("/")
    async def get_employees():
        return ctx.service.get_employees()

    @get("/{id}")
    async def get_employee(id: int):
        return ctx.service.get_employee(id)


from nest_py.core import factory  # khởi tạo tối thiểu

Best Practices

• Tổ Chức Mã Nguồn: Đảm bảo mã nguồn được tổ chức rõ ràng và dễ duy trì.
• Sử Dụng Decorators: Tận dụng decorators để tăng tính tái sử dụng và giảm sự lặp lại trong mã.
• Dependency Injection: Áp dụng DI để quản lý các phụ thuộc một cách hiệu quả.

Common Pitfalls

• Thiếu Kiểm Tra Lỗi: Đảm bảo kiểm tra lỗi cho tất cả các API để tránh lỗi không mong muốn khi sử dụng.
• Quản Lý State Không Hiệu Quả: Cẩn thận với việc quản lý trạng thái giữa các request.

Performance Tips

• Tối Ưu Hóa Truy Vấn: Sử dụng caching cho các truy vấn thường xuyên để giảm tải cho server.
• Giảm Thiểu Thời Gian Phản Hồi: Sử dụng async/await để cải thiện thời gian phản hồi của API.

Troubleshooting

• Nếu bạn gặp lỗi 404 khi gọi API, kiểm tra lại đường dẫn và các phương thức đã được định nghĩa.
• Đối với lỗi 500, xem xét log để tìm hiểu nguyên nhân gốc rễ.

Kết Luận

Nest-Py là một dự án thú vị cho những ai yêu thích sự sáng tạo trong lập trình Python. Hy vọng bài viết này giúp bạn hiểu rõ hơn về cách tích hợp các khái niệm từ NestJS vào Python. Hãy thử nghiệm và chia sẻ những kinh nghiệm của bạn với cộng đồng!

Câu Hỏi Thường Gặp (FAQ)

1. Nest-Py có thể sử dụng trong môi trường sản xuất không?
   Không, hiện tại Nest-Py chỉ là một dự án thử nghiệm.
2. Có tài liệu nào về Nest-Py không?
   Tài liệu chính thức đang được phát triển, theo dõi để biết thêm thông tin.

Tài Nguyên Liên Quan

• FastAPI Documentation
• NestJS Documentation

Hãy bắt đầu khám phá và phát triển ứng dụng của bạn với Nest-Py ngay hôm nay!