Building Python Applications with Microservices Architecture

title: Building Python Applications with Microservices Architecture
description: Best practices for developing Python applications using microservices architecture, focusing on modularity and scalability.
category: Python Cursor Rules
rules:
  - id: python-microservices-architecture
    description: >
      Ensure Python microservices are designed with clear boundaries, focusing on modularity and scalability.
    severity: warning
    patterns:
      - pattern: >
          class $CLASS_NAME:
            ...
        conditions:
          - not: >
              class $CLASS_NAME:
                def __init__(self, ...):
                  ...
                def $METHOD_NAME(self, ...):
                  ...
    message: >
      Classes should adhere to the Single Responsibility Principle, focusing on a single business capability to enhance modularity and scalability.
    references:
      - https://www.geeksforgeeks.org/best-practices-for-microservices-architecture/

  - id: python-microservices-api
    description: >
      Define clear and consistent APIs for communication between microservices.
    severity: warning
    patterns:
      - pattern: >
          def $FUNCTION_NAME(request):
            ...
        conditions:
          - not: >
              def $FUNCTION_NAME(request: $REQUEST_TYPE) -> $RESPONSE_TYPE:
                ...
    message: >
      API functions should have well-defined input and output types to ensure clear communication between microservices.
    references:
      - https://www.restack.io/p/python-microservices-best-practices-answer

  - id: python-microservices-ci-cd
    description: >
      Implement Continuous Integration and Continuous Deployment (CI/CD) pipelines for microservices.
    severity: warning
    patterns:
      - pattern: >
          # No CI/CD configuration found
        conditions:
          - not: >
              # CI/CD configuration present
    message: >
      Implement CI/CD pipelines to automate testing and deployment, ensuring rapid and reliable updates to microservices.
    references:
      - https://www.imaginarycloud.com/blog/microservices-best-practices

  - id: python-microservices-monitoring
    description: >
      Integrate centralized monitoring and logging for microservices.
    severity: warning
    patterns:
      - pattern: >
          # No monitoring or logging setup found
        conditions:
          - not: >
              # Monitoring and logging setup present
    message: >
      Implement centralized monitoring and logging to track system behavior and detect issues promptly.
    references:
      - https://itcgroup.io/our-blogs/microservices-architecture-trends-best-practices-in-2025/

  - id: python-microservices-security
    description: >
      Apply security best practices in microservices development.
    severity: warning
    patterns:
      - pattern: >
          # No security measures found
        conditions:
          - not: >
              # Security measures implemented
    message: >
      Implement security best practices, including secure coding, network policies, and service meshes, to protect microservices.
    references:
      - https://www.meritdata-tech.com/resources/blog/code-ai/microservices-architecture-practices-2025/