djangx 1.5.5__py3-none-any.whl → 1.5.7__py3-none-any.whl

djangx/management/enums.py

@@ -0,0 +1,63 @@
+from enum import StrEnum
+
+from christianwhocodes.generators import FileGeneratorOption
+
+
+class FileOption(StrEnum):
+    PG_SERVICE = FileGeneratorOption.PG_SERVICE.value
+    PGPASS = FileGeneratorOption.PGPASS.value
+    SSH_CONFIG = FileGeneratorOption.SSH_CONFIG.value
+    ENV = "env"
+    SERVER = "server"
+    VERCEL = "vercel"
+
+
+class PresetType(StrEnum):
+    """Available project presets."""
+
+    DEFAULT = "default"
+    VERCEL = "vercel"
+
+
+class Apps(StrEnum):
+    """Django applications enumeration."""
+
+    ADMIN = "django.contrib.admin"
+    AUTH = "django.contrib.auth"
+    CONTENTTYPES = "django.contrib.contenttypes"
+    SESSIONS = "django.contrib.sessions"
+    MESSAGES = "django.contrib.messages"
+    STATICFILES = "django.contrib.staticfiles"
+    HTTP_COMPRESSION = "django_http_compression"
+    MINIFY_HTML = "django_minify_html"
+    BROWSER_RELOAD = "django_browser_reload"
+    WATCHFILES = "django_watchfiles"
+
+
+class ContextProcessors(StrEnum):
+    """Django template context processors enumeration."""
+
+    DEBUG = "django.template.context_processors.debug"
+    REQUEST = "django.template.context_processors.request"
+    AUTH = "django.contrib.auth.context_processors.auth"
+    MESSAGES = "django.contrib.messages.context_processors.messages"
+    CSP = "django.template.context_processors.csp"
+
+
+class Middlewares(StrEnum):
+    """Django middleware enumeration."""
+
+    SECURITY = "django.middleware.security.SecurityMiddleware"
+    SESSION = "django.contrib.sessions.middleware.SessionMiddleware"
+    COMMON = "django.middleware.common.CommonMiddleware"
+    CSRF = "django.middleware.csrf.CsrfViewMiddleware"
+    AUTH = "django.contrib.auth.middleware.AuthenticationMiddleware"
+    MESSAGES = "django.contrib.messages.middleware.MessageMiddleware"
+    CLICKJACKING = "django.middleware.clickjacking.XFrameOptionsMiddleware"
+    CSP = "django.middleware.csp.ContentSecurityPolicyMiddleware"
+    HTTP_COMPRESSION = "django_http_compression.middleware.HttpCompressionMiddleware"
+    MINIFY_HTML = "django_minify_html.middleware.MinifyHtmlMiddleware"
+    BROWSER_RELOAD = "django_browser_reload.middleware.BrowserReloadMiddleware"
+
+
+__all__: list[str] = ["FileOption", "PresetType", "Apps", "ContextProcessors", "Middlewares"]

djangx/management/settings/apps.py

@@ -1,9 +1,5 @@
-"""# DjangX settings: Installed apps, middleware, templates, context processors."""
-# TODO: Refactor so that the user can specify the order of apps, middleware, and context processors more flexibly.
-
-from enum import StrEnum
-
 from ... import (
+    INCLUDE_PROJECT_MAIN_APP,
     PKG_API_NAME,
     PKG_MANAGEMENT_NAME,
     PKG_NAME,
@@ -12,28 +8,16 @@ from ... import (
     Conf,
     ConfField,
 )
+from ..enums import Apps, ContextProcessors, Middlewares
 from ..types import TemplatesDict
 
+# TODO: Refactor so that the user can specify the order of apps, middleware, and context processors more flexibly.
+
 # ===============================================================
 # Apps
 # ===============================================================
 
 
-class _Apps(StrEnum):
-    """Django applications enumeration."""
-
-    ADMIN = "django.contrib.admin"
-    AUTH = "django.contrib.auth"
-    CONTENTTYPES = "django.contrib.contenttypes"
-    SESSIONS = "django.contrib.sessions"
-    MESSAGES = "django.contrib.messages"
-    STATICFILES = "django.contrib.staticfiles"
-    HTTP_COMPRESSION = "django_http_compression"
-    MINIFY_HTML = "django_minify_html"
-    BROWSER_RELOAD = "django_browser_reload"
-    WATCHFILES = "django_watchfiles"
-
-
 class AppsConf(Conf):
     """Apps configuration settings."""
 
@@ -62,26 +46,26 @@ def _get_installed_apps() -> list[str]:
     """
 
     base_apps: list[str] = [
-        PROJECT_MAIN_APP_NAME,
+        *([PROJECT_MAIN_APP_NAME] if INCLUDE_PROJECT_MAIN_APP else []),
         PKG_NAME,
         f"{PKG_NAME}.{PKG_API_NAME}",
         f"{PKG_NAME}.{PKG_UI_NAME}",
     ]
 
     third_party_apps: list[str] = [
-        _Apps.HTTP_COMPRESSION,
-        _Apps.MINIFY_HTML,
-        _Apps.BROWSER_RELOAD,
-        _Apps.WATCHFILES,
+        Apps.HTTP_COMPRESSION,
+        Apps.MINIFY_HTML,
+        Apps.BROWSER_RELOAD,
+        Apps.WATCHFILES,
     ]
 
     django_apps: list[str] = [
-        _Apps.ADMIN,
-        _Apps.AUTH,
-        _Apps.CONTENTTYPES,
-        _Apps.SESSIONS,
-        _Apps.MESSAGES,
-        _Apps.STATICFILES,
+        Apps.ADMIN,
+        Apps.AUTH,
+        Apps.CONTENTTYPES,
+        Apps.SESSIONS,
+        Apps.MESSAGES,
+        Apps.STATICFILES,
     ]
 
     # Collect apps that should be removed except for base apps
@@ -106,19 +90,9 @@ INSTALLED_APPS: list[str] = _get_installed_apps()
 # ===============================================================
 
 
-class _ContextProcessors(StrEnum):
-    """Django template context processors enumeration."""
-
-    DEBUG = "django.template.context_processors.debug"
-    REQUEST = "django.template.context_processors.request"
-    AUTH = "django.contrib.auth.context_processors.auth"
-    MESSAGES = "django.contrib.messages.context_processors.messages"
-    CSP = "django.template.context_processors.csp"
-
-
-_APP_CONTEXT_PROCESSOR_MAP: dict[_Apps, list[_ContextProcessors]] = {
-    _Apps.AUTH: [_ContextProcessors.AUTH],
-    _Apps.MESSAGES: [_ContextProcessors.MESSAGES],
+_APP_CONTEXT_PROCESSOR_MAP: dict[Apps, list[ContextProcessors]] = {
+    Apps.AUTH: [ContextProcessors.AUTH],
+    Apps.MESSAGES: [ContextProcessors.MESSAGES],
 }
 
 
@@ -150,11 +124,11 @@ def _get_context_processors(installed_apps: list[str]) -> list[str]:
     """
     # Django context processors in recommended order
     django_context_processors: list[str] = [
-        _ContextProcessors.DEBUG,  # Debug info (only in DEBUG mode)
-        _ContextProcessors.REQUEST,  # Adds request object to context
-        _ContextProcessors.AUTH,  # Adds user and perms to context
-        _ContextProcessors.MESSAGES,  # Adds messages to context
-        _ContextProcessors.CSP,  # Content Security Policy
+        ContextProcessors.DEBUG,  # Debug info (only in DEBUG mode)
+        ContextProcessors.REQUEST,  # Adds request object to context
+        ContextProcessors.AUTH,  # Adds user and perms to context
+        ContextProcessors.MESSAGES,  # Adds messages to context
+        ContextProcessors.CSP,  # Content Security Policy
     ]
 
     # Collect context processors that should be removed based on missing apps
@@ -192,29 +166,13 @@ TEMPLATES: TemplatesDict = [
 # ===============================================================
 
 
-class _Middlewares(StrEnum):
-    """Django middleware enumeration."""
-
-    SECURITY = "django.middleware.security.SecurityMiddleware"
-    SESSION = "django.contrib.sessions.middleware.SessionMiddleware"
-    COMMON = "django.middleware.common.CommonMiddleware"
-    CSRF = "django.middleware.csrf.CsrfViewMiddleware"
-    AUTH = "django.contrib.auth.middleware.AuthenticationMiddleware"
-    MESSAGES = "django.contrib.messages.middleware.MessageMiddleware"
-    CLICKJACKING = "django.middleware.clickjacking.XFrameOptionsMiddleware"
-    CSP = "django.middleware.csp.ContentSecurityPolicyMiddleware"
-    HTTP_COMPRESSION = "django_http_compression.middleware.HttpCompressionMiddleware"
-    MINIFY_HTML = "django_minify_html.middleware.MinifyHtmlMiddleware"
-    BROWSER_RELOAD = "django_browser_reload.middleware.BrowserReloadMiddleware"
-
-
-_APP_MIDDLEWARE_MAP: dict[_Apps, list[_Middlewares]] = {
-    _Apps.SESSIONS: [_Middlewares.SESSION],
-    _Apps.AUTH: [_Middlewares.AUTH],
-    _Apps.MESSAGES: [_Middlewares.MESSAGES],
-    _Apps.HTTP_COMPRESSION: [_Middlewares.HTTP_COMPRESSION],
-    _Apps.MINIFY_HTML: [_Middlewares.MINIFY_HTML],
-    _Apps.BROWSER_RELOAD: [_Middlewares.BROWSER_RELOAD],
+_APP_MIDDLEWARE_MAP: dict[Apps, list[Middlewares]] = {
+    Apps.SESSIONS: [Middlewares.SESSION],
+    Apps.AUTH: [Middlewares.AUTH],
+    Apps.MESSAGES: [Middlewares.MESSAGES],
+    Apps.HTTP_COMPRESSION: [Middlewares.HTTP_COMPRESSION],
+    Apps.MINIFY_HTML: [Middlewares.MINIFY_HTML],
+    Apps.BROWSER_RELOAD: [Middlewares.BROWSER_RELOAD],
 }
 
 
@@ -259,17 +217,17 @@ def _get_middleware(installed_apps: list[str]) -> list[str]:
     - ABOVE any middleware that modifies HTML (like BrowserReloadMiddleware)
     """
     django_middleware: list[str] = [
-        _Middlewares.SECURITY,  # FIRST - security headers, HTTPS redirect
-        _Middlewares.SESSION,  # Early - needed by auth & messages
-        _Middlewares.COMMON,  # Early - URL normalization
-        _Middlewares.CSRF,  # After session - needs session data
-        _Middlewares.AUTH,  # After session - stores user in session
-        _Middlewares.MESSAGES,  # After session & auth
-        _Middlewares.CLICKJACKING,  # Security headers (X-Frame-Options)
-        _Middlewares.CSP,  # Security headers (Content-Security-Policy)
-        _Middlewares.HTTP_COMPRESSION,  # Before minify - encodes responses (Zstandard, Brotli, Gzip)
-        _Middlewares.MINIFY_HTML,  # After compression, before HTML modifiers
-        _Middlewares.BROWSER_RELOAD,  # LAST - dev only, injects reload script into HTML
+        Middlewares.SECURITY,  # FIRST - security headers, HTTPS redirect
+        Middlewares.SESSION,  # Early - needed by auth & messages
+        Middlewares.COMMON,  # Early - URL normalization
+        Middlewares.CSRF,  # After session - needs session data
+        Middlewares.AUTH,  # After session - stores user in session
+        Middlewares.MESSAGES,  # After session & auth
+        Middlewares.CLICKJACKING,  # Security headers (X-Frame-Options)
+        Middlewares.CSP,  # Security headers (Content-Security-Policy)
+        Middlewares.HTTP_COMPRESSION,  # Before minify - encodes responses (Zstandard, Brotli, Gzip)
+        Middlewares.MINIFY_HTML,  # After compression, before HTML modifiers
+        Middlewares.BROWSER_RELOAD,  # LAST - dev only, injects reload script into HTML
     ]
 
     # Collect middleware that should be removed based on missing apps

djangx/management/urls.py

@@ -11,5 +11,9 @@ urlpatterns: list[URLPattern | URLResolver] = [
     ),
     path("api/", include(f"{PKG_NAME}.api.urls")),
     path("ui/", include(f"{PKG_NAME}.ui.urls")),
-    path("", include(f"{PROJECT_MAIN_APP_NAME}.urls")),
+    *(
+        [path("", include(f"{PROJECT_MAIN_APP_NAME}.urls"))]
+        if PROJECT_MAIN_APP_NAME in INSTALLED_APPS
+        else []
+    ),
 ]

{djangx-1.5.5.dist-info → djangx-1.5.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: djangx
-Version: 1.5.5
+Version: 1.5.7
 Summary: Build and deploy Django apps with confidence.
 Author: Kevin Wasike Wakhisi
 Author-email: Kevin Wasike Wakhisi <kevin@christianwhocodes.space>
@@ -34,6 +34,7 @@ Requires-Dist: django-phonenumber-field[phonenumberslite]>=8.4.0
 Requires-Dist: django-watchfiles>=1.4.0
 Requires-Dist: pyperclip>=1.11.0
 Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: rich>=14.3.2
 Requires-Python: >=3.12
 Project-URL: homepage, https://github.com/christianwhocodes/djangx#readme
 Project-URL: repository, https://github.com/christianwhocodes/djangx

{djangx-1.5.5.dist-info → djangx-1.5.7.dist-info}/RECORD

@@ -1,4 +1,4 @@
-djangx/__init__.py,sha256=jwKJYiHrStAWPLe8XdYpf2WeQgonrbNlEbeNLecn0R0,12006
+djangx/__init__.py,sha256=pQL6hUV-JZB182c8v2tg1o8znK2HM83NLi1Wcfwkdbo,12158
 djangx/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 djangx/api/backends/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 djangx/api/backends/auth.py,sha256=VhV1jsLhLc5vNxg_1zeHOGxTL1rlcTx186OX7kaVhUg,1306
@@ -6,9 +6,10 @@ djangx/api/backends/server/__init__.py,sha256=5kCbtOg7dwz22NYBB8dksaHH4G3qLJ_8KU
 djangx/api/backends/server/asgi.py,sha256=aMe3K0ow5ko5tHahnT4Ygux9O9eCf-WcPWP9iotEUYk,293
 djangx/api/backends/server/wsgi.py,sha256=AHMDe1sDhZ3Is98ZcWUs8cFEiuMHR5VzG7J3Hvz2do4,293
 djangx/api/backends/storages.py,sha256=zRQehQ7BEEamA9_1HS8WYIjOYRmGIZB4srlSaI6fbfQ,2726
+djangx/api/enums.py,sha256=J0q9JV9D8KdcV_XE9kDu7vTQEz2lmYsD6lePLGhZa8c,153
 djangx/api/settings/__init__.py,sha256=F2Qx0rqmUBNGdb6B6N8XLtJa73a44hq9DWxJgabSevs,147
 djangx/api/settings/auth.py,sha256=iwFMOxsNByUI-6hl5114HfHAuKnKVd40mK85CAMlvnI,788
-djangx/api/settings/databases.py,sha256=0Gkz_d2O2cEhWho0_4tAP6sXUVx_HE1wGzQ_lflN1WI,3350
+djangx/api/settings/databases.py,sha256=2gLQYFifM6kS8YPlgrU51YuNmJu2M0RP6OYKuvce18w,3494
 djangx/api/settings/server.py,sha256=pIz-OKy_M4xEVhnepDOS8xwHxFsDAOPodSO5fAK7cQc,550
 djangx/api/settings/storages.py,sha256=R_BV2rZ0kWVb1f-XsRtwhOtzJ7TDOWA8nHNJab8rm6o,2156
 djangx/api/types/__init__.py,sha256=v3jQUN6vGG5PxlUovE6ASkrVpmCIS9SEMQR17LHzd48,111
@@ -16,29 +17,29 @@ djangx/api/types/auth.py,sha256=UbOlzuqdnI23OUkD5EnVnA5i3hobD9MX2b7CsEZufNE,199
 djangx/api/types/databases.py,sha256=RWym2lqzYGlszdPaV3kjJDxqxBWNHyQzRXA1zyxvmHk,738
 djangx/api/types/storages.py,sha256=9_EFUS7NCnRF-5-zVDdrRod0mJM49HhhWSpIKGGvaSM,383
 djangx/api/urls.py,sha256=PgfEM7aN03L2wxYDzx8Cn5ive2URfY-6lX-qWZvvwnA,98
+djangx/enums.py,sha256=Z2fdGhX3ETR7oJ5n0Bx7yYjsdl1AfmqtV-Q_XFJ7zPQ,85
 djangx/management/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-djangx/management/cli.py,sha256=D-_S_LWPlhqSGeFXYhK6PMxn_FjTlsJOvIjwoIAgK8Y,1364
+djangx/management/cli.py,sha256=G-81uWzW8u8fvoCp8tOnmdFnB7iXRh48EkEAWzE_ZlQ,2005
 djangx/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 djangx/management/commands/collectstatic.py,sha256=vApmt5DNXhEfQkEBCypEkWePxKRk-FTJ756NnC21N3Q,1436
-djangx/management/commands/generate.py,sha256=Fj_iLlhpA6SPpOErHTeL_-KWI5Ad3q7A_z9vkurwvsQ,2075
-djangx/management/commands/generators/__init__.py,sha256=_jGKXC6ojwGHLir15PDbTTgcnszlMTwFokUooFiDqP8,34
-djangx/management/commands/generators/file.py,sha256=IB5QL1Ua_rjsHpO0dJapWgR9bHoku6GpAhVZ_mRX-QI,7456
+djangx/management/commands/generate.py,sha256=TE0coXKuuUu5l0hep7s3dNpkp8GRYCHboplh7WCGgnI,9021
 djangx/management/commands/helpers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 djangx/management/commands/helpers/art.py,sha256=SuIYMx-HYGIsPfGtH5Fw4uRqw7ldXxi0vdzuZZsLheo,10148
 djangx/management/commands/helpers/run.py,sha256=3GbtcIxQ5q1VwMR9S7H3ILaIQ0OB0yaTjzKGUDlZUAg,14624
 djangx/management/commands/runbuild.py,sha256=0vkkJ2Z6bYj8V76q6igDB_JfueGpsXt1SG0jFftE2rc,2054
 djangx/management/commands/runinstall.py,sha256=Jygt4EThDvvl6X0wsMw0o_WAacZllVVvLxPIykI7CRs,2082
 djangx/management/commands/runserver.py,sha256=ZCmRm9BE3Q8XjjXy_-S9BS1zZBwoDDk9rxMshF5nXlc,11584
-djangx/management/commands/startproject.py,sha256=DwiFViRLx43nPFNy2gA5rJ3oWjP0IUJ7ymf882eJ6xM,17606
+djangx/management/commands/startproject.py,sha256=A7mzyknRiDPkGhV7ZQPqCN3MS1tvkFExTkPTRaH-ahg,35739
 djangx/management/commands/tailwind.py,sha256=FNDLwz6pSLkArW9yovGx8RoSSIRO7hS02r8W45NpNgM,20706
+djangx/management/enums.py,sha256=7AJcuEWuAZsGYenaXF67JGN6gM_a3BImYWA2oXuOkKE,2242
 djangx/management/settings/__init__.py,sha256=sjXuGaL_zPVsUEV-mkykhrzSM28_sfr_FdMEZaIqrKg,151
-djangx/management/settings/apps.py,sha256=0hFTs1GDLgYVgdzZd1uPOPv95vjjQzDDsUs63wmLKzY,10794
+djangx/management/settings/apps.py,sha256=V230WpGzXEbMjHCnq1GRISCQ-hxvdYKlCsbogrQ2p-4,9060
 djangx/management/settings/runcommands.py,sha256=-zWhnrQY9ZuIPJB21gJvzkQtNzYFbdUX7afMKakjVLU,525
 djangx/management/settings/security.py,sha256=ut6Chv53PiPZp4aLy0sLH4SMiON3v4JfdWojj_R84Y4,2030
 djangx/management/settings/tailwind.py,sha256=cFYJvNUwege2xusvAt1McPckBKSchY8M6QwWoGBZb1Y,911
 djangx/management/types/__init__.py,sha256=qI99KOrK1GVcV4wvJyz8whH2eObuLhleZBCZHlkMlmc,34
 djangx/management/types/apps.py,sha256=yvzKQssr6B6pT4nAq9WSxZdE9eJkMZ8wxuzriQpNAkw,533
-djangx/management/urls.py,sha256=xTMRABLKsrwptntiGK_-VAXkqH_VLXuXRSY1__TCdvk,507
+djangx/management/urls.py,sha256=gR8N8D9qlg51eEr0YPt25D-ZGJp0WpR0W3V_gMrgxAo,593
 djangx/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 djangx/settings.py,sha256=rqEko9K7ZAPbAUmfN4lh-L9wugGRcHhZq5nRwMcETno,1151
 djangx/types.py,sha256=48ZQEjzN4lPMUlw453XdZ28CX6itErzwvYik2eL0LFE,123
@@ -76,7 +77,7 @@ djangx/ui/types/contactinfo.py,sha256=nHRfZK_BBYMVk7TTibgRODSrwGKLlkHb-u1KFuMfRY
 djangx/ui/types/org.py,sha256=nN2EFUu9tpdWguN7b2dmObVKHctuzkdS0c7Yfeh5MyI,215
 djangx/ui/types/social.py,sha256=YD-SmQOkgYHpTAsQE0WqMurWAZH2GmNdn8PxFSt6qAc,206
 djangx/ui/urls.py,sha256=PgfEM7aN03L2wxYDzx8Cn5ive2URfY-6lX-qWZvvwnA,98
-djangx-1.5.5.dist-info/WHEEL,sha256=iHtWm8nRfs0VRdCYVXocAWFW8ppjHL-uTJkAdZJKOBM,80
-djangx-1.5.5.dist-info/entry_points.txt,sha256=F7r_-JbHESYkJqpY3i7zvm1ejiLzKDFTfLWDlS_GMjc,88
-djangx-1.5.5.dist-info/METADATA,sha256=q8lxLxfHbaXzAj9Kp9qnN43tGd5m-xEo1Uch5-DwQMM,2204
-djangx-1.5.5.dist-info/RECORD,,
+djangx-1.5.7.dist-info/WHEEL,sha256=iHtWm8nRfs0VRdCYVXocAWFW8ppjHL-uTJkAdZJKOBM,80
+djangx-1.5.7.dist-info/entry_points.txt,sha256=F7r_-JbHESYkJqpY3i7zvm1ejiLzKDFTfLWDlS_GMjc,88
+djangx-1.5.7.dist-info/METADATA,sha256=rjThoKF2wEthsbEAVBnw4ROlUrdi5O9yBqFJoTHlSvs,2232
+djangx-1.5.7.dist-info/RECORD,,

djangx/management/commands/generators/__init__.py

@@ -1 +0,0 @@
-from .file import *  # noqa: F403

djangx/management/commands/generators/file.py

@@ -1,217 +0,0 @@
-import builtins
-import pathlib
-from typing import Any, Optional, cast
-
-from christianwhocodes.generators import FileGenerator
-
-from .... import PKG_DISPLAY_NAME, PKG_NAME, PROJECT_API_DIR, PROJECT_DIR, Conf
-
-
-class ServerFileGenerator(FileGenerator):
-    f"""
-    Generator for ASGI / WSGI configuration in api/server.py file.
-    
-    Creates an server.py file in the /api directory.
-    Required for running {PKG_DISPLAY_NAME} apps with ASGI or WSGI servers.
-    Note that the type of api gateway dependes on the SERVER_USE_ASGI setting.
-    """
-
-    @property
-    def file_path(self) -> pathlib.Path:
-        """Return the path for the api/server.py"""
-        return PROJECT_API_DIR / "server.py"
-
-    @property
-    def data(self) -> str:
-        """Return template content for api/server.py."""
-        return f"from {PKG_NAME}.api.backends.server import application\n\napp = application\n"
-
-
-class VercelFileGenerator(FileGenerator):
-    """
-    Generator for Vercel configuration file (vercel.json).
-
-    Creates a vercel.json file in the base directory.
-    Useful for deploying to Vercel with custom install/build commands.
-    """
-
-    @property
-    def file_path(self) -> pathlib.Path:
-        return PROJECT_DIR / "vercel.json"
-
-    @property
-    def data(self) -> str:
-        """Return template content for vercel.json."""
-        lines = [
-            "{",
-            '  "$schema": "https://openapi.vercel.sh/vercel.json",',
-            f'  "installCommand": "uv run {PKG_NAME} runinstall",',
-            f'  "buildCommand": "uv run {PKG_NAME} runbuild",',
-            '  "rewrites": [',
-            "    {",
-            '      "source": "/(.*)",',
-            '      "destination": "/api/server"',
-            "    }",
-            "  ]",
-            "}",
-        ]
-
-        return "\n".join(lines) + "\n"
-
-
-class EnvFileGenerator(FileGenerator):
-    """
-    Generator for environment configuration file (.env.example).
-
-    Creates a .env.example file in the base directory with all
-    possible environment variables from configuration classes.
-    All variables are commented out by default.
-    """
-
-    @property
-    def file_path(self) -> pathlib.Path:
-        """Return the path for the .env.example file."""
-        return PROJECT_DIR / ".env.example"
-
-    @property
-    def data(self) -> str:
-        """Generate .env file content based on all ConfFields from Conf subclasses."""
-
-        lines: list[str] = []
-
-        # Add header
-        lines.extend(self._add_header())
-
-        # Get all fields from Conf subclasses
-        env_fields = Conf.get_env_fields()
-
-        # Group fields by class
-        fields_by_class: dict[str, list[dict[str, Any]]] = {}
-        for field in env_fields:
-            class_name = cast(str, field["class"])
-            if class_name not in fields_by_class:
-                fields_by_class[class_name] = []
-            fields_by_class[class_name].append(field)
-
-        # Generate content for each class group
-        for class_name in sorted(fields_by_class.keys()):
-            fields = fields_by_class[class_name]
-
-            # Add section header
-            lines.extend(self._add_section_header(class_name))
-
-            # Process each field in this class
-            for field in fields:
-                env_var = field["env"]
-                toml_key = field["toml"]
-                choices_key = field["choices"]
-                default_value = field["default"]
-                field_type = field["type"]
-
-                # Add field documentation with proper format hints
-                lines.append(
-                    f"# Variable: {self._format_variable_hint(env_var, choices_key, field_type)}"
-                )
-                if toml_key:
-                    lines.append(f"# TOML Key: {toml_key}")
-
-                # Format default value for display
-                if default_value is not None:
-                    formatted_default = self._format_default_value(default_value, field_type)
-                    lines.append(f"# Default: {formatted_default}")
-                else:
-                    lines.append("# Default: (none)")
-
-                lines.append(f"# {env_var}=")
-
-                lines.append("")
-
-            lines.append("")
-
-        # Add footer
-        lines.extend(self._add_footer())
-
-        return "\n".join(lines)
-
-    def _add_header(self) -> list[str]:
-        """Add header to the .env.example file."""
-        lines: list[str] = []
-        lines.append("# " + "=" * 78)
-        lines.append(f"# {PKG_DISPLAY_NAME} Environment Configuration")
-        lines.append("# " + "=" * 78)
-        lines.append("#")
-        lines.append("# This file contains all available environment variables for configuration.")
-        lines.append("#")
-        lines.append("# Configuration Priority: ENV > TOML > Default")
-        lines.append("# " + "=" * 78)
-        lines.append("")
-        return lines
-
-    def _add_section_header(self, class_name: str) -> list[str]:
-        """Add section header for a configuration class."""
-        lines: list[str] = []
-        lines.append("# " + "-" * 78)
-        lines.append(f"# {class_name} Configuration")
-        lines.append("# " + "-" * 78)
-        lines.append("")
-        return lines
-
-    def _add_footer(self) -> list[str]:
-        """Add footer to the .env.example file."""
-        lines: list[str] = []
-        lines.append("# " + "=" * 78)
-        lines.append("# End of Configuration")
-        lines.append("# " + "=" * 78)
-        return lines
-
-    def _format_choices(self, choices: list[str]) -> str:
-        """Format choices as 'choice1' | 'choice2' | 'choice3'."""
-        return " | ".join(f'"{choice}"' for choice in choices)
-
-    def _get_type_example(self, field_type: type) -> str:
-        """Get example value for a field type."""
-        match field_type:
-            case builtins.bool:
-                return '"true" | "false"'
-            case builtins.int:
-                return '"123"'
-            case builtins.float:
-                return '"123.45"'
-            case builtins.list:
-                return '"value1,value2,value3"'
-            case pathlib.Path:
-                return '"/full/path/to/something"'
-            case _:
-                return '"value"'
-
-    def _format_variable_hint(
-        self, env_var: str, choices_key: Optional[list[str]], field_type: type
-    ) -> str:
-        """Format variable hint showing proper syntax based on type."""
-        if choices_key:
-            return f"{env_var}={self._format_choices(choices_key)}"
-        else:
-            return f"{env_var}={self._get_type_example(field_type)}"
-
-    def _format_default_value(self, value: Any, field_type: type) -> str:
-        """Format default value for display in comments."""
-        if value is None:
-            return "(none)"
-
-        match field_type:
-            case builtins.bool:
-                return "true" if value else "false"
-            case builtins.list:
-                if isinstance(value, list):
-                    list_items = cast(list[Any], value)
-                    if not list_items:
-                        return "(empty list)"
-                    return ",".join(str(v) for v in list_items)
-                return str(value)
-            case pathlib.Path:
-                return str(pathlib.PurePosixPath(value))
-            case _:
-                return str(value)
-
-
-__all__: list[str] = ["EnvFileGenerator", "ServerFileGenerator", "VercelFileGenerator"]