Add plugins system (#69)

Author: KaliszS

copier.yaml

@@ -11,6 +11,24 @@ project_type:
     - "mcp-server"
     - "agent"
 
+plugins:
+  type: str
+  help: Which plugins would you like to enable?
+  multiselect: true
+  default: |
+    {% if project_type in ["api-monolith", "api-microservice", "agent"] %}
+    - "sqladmin"
+    {% else %}
+    []
+    {% endif %}
+  choices: |
+    {% if project_type in ["api-monolith", "api-microservice", "agent"] %}
+    SQLAdmin [interface for database management]: sqladmin
+    {% else %}
+    {}
+    {% endif %}
+  when: "{{ project_type in ['api-monolith', 'api-microservice', 'agent'] }}"
+
 project_name:
   type: str
   help: What is your project name?
@@ -64,7 +82,6 @@ _exclude:
   - "{{ '*/app/database.py' if project_type not in ['api-monolith', 'api-microservice', 'agent'] else '' }}"
   - "{{ '*/app/mappings.py' if project_type not in ['api-monolith', 'api-microservice', 'agent'] else '' }}"
   - "{{ '*/app/utils/mappings_meta.py' if project_type not in ['api-monolith', 'api-microservice', 'agent'] else '' }}"
-  - "{{ '*/app/integrations/sqladmin' if project_type not in ['api-monolith', 'api-microservice', 'agent'] else '' }}"
 
   - "{{ '*/README_api.md' if project_type not in ['api-monolith', 'api-microservice'] else '' }}"
   - "{{ 'Dockerfile' if project_type not in ['api-monolith', 'api-microservice'] else '' }}"
@@ -75,13 +92,13 @@ _exclude:
   - "{{ '*/app/repositories.py' if project_type != 'api-monolith' else '' }}"
   - "{{ '*/app/services.py' if project_type != 'api-monolith' else '' }}"
 
-  - "{{ '*/app/models' if project_type != 'api-microservice' else '' }}"
   - "{{ '*/app/schemas/user.py' if project_type != 'api-microservice' else '' }}"
   - "{{ '*/app/services' if project_type != 'api-microservice' else '' }}"
   - "{{ '*/app/repositories' if project_type != 'api-microservice' else '' }}"
   - "{{ '*/app/api/routes/v1/user.py' if project_type != 'api-microservice' else '' }}"
 
   - "{{ '*/app/api' if project_type not in ['api-microservice', 'agent'] else '' }}"
+  - "{{ '*/app/models' if project_type not in ['api-microservice', 'agent'] else '' }}"
   - "{{ '*/app/schemas' if project_type not in ['api-microservice', 'agent'] else '' }}"
 
   - "{{ '*/examples' if project_type != 'agent' else '' }}"
@@ -94,6 +111,8 @@ _exclude:
   - "{{ '*/README_mcp-server.md' if project_type != 'mcp-server' else '' }}"
   - "{{ '*/app/mcp' if project_type != 'mcp-server' else '' }}"
 
+  - "{{ '*/app/integrations/sqladmin' if 'sqladmin' not in plugins else '' }}"
+
 _tasks:
   - command: uvx python -c "import shutil; shutil.move('{{project_name}}/README_{{project_type}}.md', '{{project_name}}/README.md')"
     when: "{{ project_type in ['agent', 'mcp-server'] }}"

{{project_name}}/app/integrations/sqladmin/views/user.py renamed to {{project_name}}/app/integrations/sqladmin/views/user.py.jinja

@@ -1,6 +1,11 @@
 from app.integrations.sqladmin.base_view import BaseAdminView
+{% if project_type == "api-monolith" %}
 from app.user.models import User
 from app.user.schemas import UserCreate, UserUpdate
+{% else %}
+from app.models.user import User
+from app.schemas.user import UserCreate, UserUpdate
+{% endif %}
 
 
 class UserAdminView(

{{project_name}}/app/main.py.jinja

@@ -3,31 +3,37 @@ from logging import INFO, basicConfig
 {% if project_type in ["api-monolith", "api-microservice"] %}
 from fastapi import FastAPI, Request
 from fastapi.exceptions import RequestValidationError
-from sqladmin import Admin
 {% elif project_type == "agent" %}
 from fastapi import FastAPI
 {% elif project_type == "mcp-server" %}
 from fastmcp import FastMCP
 {% endif %}
+{% if "sqladmin" in plugins %}
+from sqladmin import Admin
+{% endif %}
 
 from app.config import settings
 {% if project_type in ["api-monolith", "api-microservice"] %}
 from app.utils.exceptions import handle_exception
-from app.database import engine
-from app.integrations.sqladmin.views import add_admin_views
 {% endif %}
 {% if project_type in ["api-monolith", "api-microservice", "agent"] %}
 from app.api import head_router
 {% elif project_type == "mcp-server" %}
 from app.mcp import mcp_router
 {% endif %}
+{% if "sqladmin" in plugins %}
+from app.database import engine
+from app.integrations.sqladmin.views import add_admin_views
+{% endif %}
 
 basicConfig(level=INFO, format="[%(asctime)s - %(name)s] (%(levelname)s) %(message)s")
 
 {% if project_type in ["api-monolith", "api-microservice", "agent"] %}
 api = FastAPI(title=settings.api_name)
+{% if "sqladmin" in plugins %}
 admin = Admin(app=api, engine=engine)
 add_admin_views(admin)
+{% endif %}
 
 
 @api.get("/")

{{project_name}}/app/schemas/user.py

@@ -23,4 +23,4 @@ class UserRead(BaseModel):
 class UserUpdate(BaseModel):
     username: str | None = None
     email: EmailStr | None = None
-    updated_at: datetime | None = Field(default_factory=lambda: datetime.now(timezone.utc), init=False)
+    updated_at: datetime | None = Field(default_factory=lambda: datetime.now(timezone.utc))

{{project_name}}/pyproject.toml.jinja

@@ -22,6 +22,8 @@ dependencies = [
     {% if project_type in ["api-monolith", "api-microservice", "agent"] %}
     "fastapi>=0.116.1",
     "fastapi-cli>=0.0.8",
+    {% endif %}
+    {% if "sqladmin" in plugins %}
     "sqladmin[full]>=0.21.0",
     {% endif %}
 ]