quickscale-cli 0.62.0__tar.gz → 0.63.0__tar.gz

{quickscale_cli-0.62.0 → quickscale_cli-0.63.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: quickscale-cli
-Version: 0.62.0
+Version: 0.63.0
 Summary: Command-line interface for QuickScale Django project generator
 Home-page: https://github.com/Experto-AI/quickscale
 License: Apache-2.0
@@ -19,6 +19,6 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Dist: click (>=8.1.0,<9.0.0)
-Requires-Dist: quickscale-core (>=0.62.0,<0.63.0)
+Requires-Dist: quickscale-core (>=0.63.0,<0.64.0)
 Project-URL: Documentation, https://github.com/Experto-AI/quickscale/tree/main/docs
 Project-URL: Repository, https://github.com/Experto-AI/quickscale

{quickscale_cli-0.62.0 → quickscale_cli-0.63.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "quickscale-cli"
-version = "0.62.0"
+version = "0.63.0"
 description = "Command-line interface for QuickScale Django project generator"
 authors = ["Experto AI <victor@experto.ai>"]
 license = "Apache-2.0"
@@ -25,7 +25,7 @@ packages = [{include = "quickscale_cli", from = "src"}]
 [tool.poetry.dependencies]
 python = "^3.10"
 click = "^8.1.0"
-quickscale-core = "^0.62.0"
+quickscale-core = "^0.63.0"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^7.4.0"
@@ -108,5 +108,3 @@ check_untyped_defs = false
 [[tool.mypy.overrides]]
 module = "quickscale_core.*"
 ignore_missing_imports = true
-
-

{quickscale_cli-0.62.0 → quickscale_cli-0.63.0}/src/quickscale_cli/_version.py

@@ -1,2 +1,2 @@
 # Auto-generated by scripts/version_tool.sh
-__version__ = "0.62.0"
+__version__ = "0.63.0"

{quickscale_cli-0.62.0 → quickscale_cli-0.63.0}/src/quickscale_cli/commands/module_commands.py

@@ -1,6 +1,7 @@
 """Module management commands for QuickScale CLI."""
 
 from pathlib import Path
+from typing import Any
 
 import click
 
@@ -15,10 +16,141 @@ from quickscale_core.utils.git_utils import (
     run_git_subtree_push,
 )
 
-# Available modules (placeholders in v0.62.0)
+# Available modules
 AVAILABLE_MODULES = ["auth", "billing", "teams"]
 
 
+def configure_auth_module() -> dict[str, Any]:
+    """Interactive configuration for auth module"""
+    click.echo("\n⚙️  Configuring auth module...")
+    click.echo("Answer these questions to customize the authentication setup:\n")
+
+    config = {
+        "allow_registration": click.confirm("Enable user registration?", default=True),
+        "email_verification": click.prompt(
+            "Email verification",
+            type=click.Choice(["none", "optional", "mandatory"], case_sensitive=False),
+            default="none",
+            show_choices=True,
+        ),
+        "authentication_method": click.prompt(
+            "Authentication method",
+            type=click.Choice(["email", "username", "both"], case_sensitive=False),
+            default="email",
+            show_choices=True,
+        ),
+    }
+
+    return config
+
+
+def apply_auth_configuration(project_path: Path, config: dict[str, Any]) -> None:
+    """Apply auth module configuration to project settings"""
+    settings_path = project_path / "settings.py"
+    urls_path = project_path / "urls.py"
+
+    if not settings_path.exists():
+        click.secho("⚠️  Warning: settings.py not found, skipping auto-configuration", fg="yellow")
+        return
+
+    # Read settings.py
+    with open(settings_path) as f:
+        settings_content = f.read()
+
+    # Check if already configured
+    if "quickscale_modules_auth" in settings_content:
+        click.echo("ℹ️  Auth module already configured in settings.py")
+        return
+
+    # Add required apps to INSTALLED_APPS
+    installed_apps_addition = """
+# QuickScale Auth Module - Added by quickscale embed
+INSTALLED_APPS += [
+    "django.contrib.sites",  # Required by allauth
+    "allauth",
+    "allauth.account",
+    "quickscale_modules_auth",
+]
+
+# Authentication Configuration
+AUTHENTICATION_BACKENDS = [
+    "django.contrib.auth.backends.ModelBackend",
+    "allauth.account.auth_backends.AuthenticationBackend",
+]
+
+# Custom User Model
+AUTH_USER_MODEL = "quickscale_modules_auth.User"
+
+# Site ID (required by django.contrib.sites)
+SITE_ID = 1
+
+# Allauth Settings
+"""
+
+    # Add configuration based on user choices
+    if config["authentication_method"] == "email":
+        installed_apps_addition += 'ACCOUNT_AUTHENTICATION_METHOD = "email"\n'
+        installed_apps_addition += "ACCOUNT_USERNAME_REQUIRED = False\n"
+        installed_apps_addition += "ACCOUNT_EMAIL_REQUIRED = True\n"
+    elif config["authentication_method"] == "username":
+        installed_apps_addition += 'ACCOUNT_AUTHENTICATION_METHOD = "username"\n'
+        installed_apps_addition += "ACCOUNT_USERNAME_REQUIRED = True\n"
+        installed_apps_addition += "ACCOUNT_EMAIL_REQUIRED = False\n"
+    else:  # both
+        installed_apps_addition += 'ACCOUNT_AUTHENTICATION_METHOD = "email"\n'
+        installed_apps_addition += "ACCOUNT_USERNAME_REQUIRED = True\n"
+        installed_apps_addition += "ACCOUNT_EMAIL_REQUIRED = True\n"
+
+    installed_apps_addition += f'ACCOUNT_EMAIL_VERIFICATION = "{config["email_verification"]}"\n'
+    installed_apps_addition += f'ACCOUNT_ALLOW_REGISTRATION = {config["allow_registration"]}\n'
+    installed_apps_addition += (
+        'ACCOUNT_ADAPTER = "quickscale_modules_auth.adapters.QuickscaleAccountAdapter"\n'
+    )
+    installed_apps_addition += (
+        'ACCOUNT_SIGNUP_FORM_CLASS = "quickscale_modules_auth.forms.SignupForm"\n'
+    )
+    installed_apps_addition += 'LOGIN_REDIRECT_URL = "/accounts/profile/"\n'
+    installed_apps_addition += 'LOGOUT_REDIRECT_URL = "/"\n'
+    installed_apps_addition += "SESSION_COOKIE_AGE = 1209600  # 2 weeks\n"
+
+    # Append to settings.py
+    with open(settings_path, "a") as f:
+        f.write("\n" + installed_apps_addition)
+
+    click.secho("  ✅ Updated settings.py with auth configuration", fg="green")
+
+    # Update urls.py
+    if urls_path.exists():
+        with open(urls_path) as f:
+            urls_content = f.read()
+
+        if "quickscale_modules_auth" not in urls_content:
+            # Find urlpatterns and add auth URLs
+            if "urlpatterns = [" in urls_content:
+                urls_addition = (
+                    '    path("accounts/", include("quickscale_modules_auth.urls")),  # Auth URLs\n'
+                )
+                urls_content = urls_content.replace(
+                    "urlpatterns = [", "urlpatterns = [\n" + urls_addition
+                )
+
+                with open(urls_path, "w") as f:
+                    f.write(urls_content)
+
+                click.secho("  ✅ Updated urls.py with auth URLs", fg="green")
+
+    # Show configuration summary
+    click.echo("\n📋 Configuration applied:")
+    click.echo(f"  • Registration: {'Enabled' if config['allow_registration'] else 'Disabled'}")
+    click.echo(f"  • Email verification: {config['email_verification']}")
+    click.echo(f"  • Authentication: {config['authentication_method']}")
+
+
+MODULE_CONFIGURATORS = {
+    "auth": (configure_auth_module, apply_auth_configuration),
+}
+
+
 @click.command()
 @click.option(
     "--module",
@@ -91,31 +223,49 @@ def embed(module: str, remote: str) -> None:
             click.echo(f"\n📖 Branch '{branch}' does not exist on remote: {remote}", err=True)
             raise click.Abort()
 
+        # Interactive module configuration (v0.63.0+)
+        config = {}
+        if module in MODULE_CONFIGURATORS:
+            configurator, applier = MODULE_CONFIGURATORS[module]
+            config = configurator()
+
         # Embed module via git subtree
         prefix = f"modules/{module}"
         click.echo(f"\n📦 Embedding {module} module from {branch}...")
 
         run_git_subtree_add(prefix=prefix, remote=remote, branch=branch, squash=True)
 
-        # Update configuration
+        # Update configuration tracking
         add_module(
             module_name=module,
             prefix=prefix,
             branch=branch,
-            version="v0.62.0",  # Placeholder version
+            version="v0.63.0",
         )
 
+        # Apply module-specific configuration
+        if module in MODULE_CONFIGURATORS and config:
+            _, applier = MODULE_CONFIGURATORS[module]
+            project_root = Path.cwd()
+            applier(project_root, config)
+
         # Success message
         click.secho(f"\n✅ Module '{module}' embedded successfully!", fg="green", bold=True)
         click.echo(f"   Location: {module_path}")
         click.echo(f"   Branch: {branch}")
 
-        # Next steps
+        # Module-specific next steps
         click.echo("\n📋 Next steps:")
-        click.echo(f"  1. Review the module code in modules/{module}/")
-        click.echo(f"  2. Add to INSTALLED_APPS in settings: 'modules.{module}'")
-        click.echo("  3. Run migrations: python manage.py migrate")
-        click.echo("\n💡 Note: This is a v0.62.0 placeholder. Full implementation coming soon!")
+        if module == "auth":
+            click.echo(f"  1. Review module code in modules/{module}/")
+            click.echo("  2. Run migrations: python manage.py migrate")
+            click.echo("  3. Create superuser (optional): python manage.py createsuperuser")
+            click.echo("  4. Visit http://localhost:8000/accounts/login/")
+            click.echo("\n� Documentation: modules/auth/README.md")
+        else:
+            click.echo(f"  1. Review the module code in modules/{module}/")
+            click.echo(f"  2. Follow setup instructions in modules/{module}/README.md")
+            click.echo("  3. Run migrations: python manage.py migrate")
 
     except GitError as e:
         click.secho(f"❌ Git error: {e}", fg="red", err=True)

{quickscale_cli-0.62.0 → quickscale_cli-0.63.0}/src/quickscale_cli/utils/railway_utils.py

@@ -24,7 +24,8 @@ def get_railway_cli_version() -> str | None:
     """
     Get the current Railway CLI version string.
 
-    Returns:
+    Returns
+    -------
         Version string (e.g., "4.0.0") or None if not installed or error
 
     """
@@ -51,7 +52,8 @@ def install_railway_cli() -> bool:
     """
     Install Railway CLI via npm.
 
-    Returns:
+    Returns
+    -------
         True if installation successful, False otherwise
 
     """
@@ -71,7 +73,8 @@ def upgrade_railway_cli() -> bool:
     """
     Upgrade Railway CLI to the latest version via npm.
 
-    Returns:
+    Returns
+    -------
         True if upgrade successful, False otherwise
 
     """
@@ -93,7 +96,8 @@ def login_railway_cli_browserless() -> bool:
 
     This will prompt the user to visit a URL and enter a pairing code.
 
-    Returns:
+    Returns
+    -------
         True if login successful, False otherwise
 
     """
@@ -207,11 +211,13 @@ def run_railway_command(
     Execute Railway CLI command with error handling.
 
     Args:
+    ----
         args: Command arguments to pass to railway CLI
         timeout: Command timeout in seconds
         interactive: If True, run command interactively without capturing output
 
     Returns:
+    -------
         CompletedProcess result
 
     """
@@ -247,6 +253,7 @@ def set_railway_variable(key: str, value: str, service: str | None = None) -> bo
     Set Railway environment variable.
 
     Args:
+    ----
         key: Environment variable name
         value: Environment variable value
         service: Service name to set variable for (optional)
@@ -272,10 +279,12 @@ def set_railway_variables_batch(
     triggering a deployment for each variable.
 
     Args:
+    ----
         variables: Dictionary of environment variable names and values
         service: Service name to set variables for (optional)
 
     Returns:
+    -------
         Tuple of (success, failed_keys)
         - success: True if all variables were set successfully
         - failed_keys: List of variable keys that failed to set
@@ -327,9 +336,11 @@ def get_deployment_url(service: str | None = None) -> str | None:
     Get deployment URL from Railway project.
 
     Args:
+    ----
         service: Service name (unused - kept for compatibility)
 
     Note:
+    ----
         Railway CLI v4's `status` command does not accept --service flag.
         This function returns the first deployment URL found.
 
@@ -356,9 +367,11 @@ def get_app_service_name(project_name: str | None = None) -> str:
     Determine the app service name for Railway deployment.
 
     Args:
+    ----
         project_name: Project name (defaults to current directory name)
 
     Returns:
+    -------
         Service name to use for the app
 
     """
@@ -376,9 +389,11 @@ def generate_railway_domain(service: str) -> str | None:
     Generate Railway public domain for a service.
 
     Args:
+    ----
         service: Service name to generate domain for
 
     Returns:
+    -------
         Generated domain URL or None if failed
 
     """
@@ -412,7 +427,8 @@ def check_uncommitted_changes() -> tuple[bool, str]:
     """
     Check if there are uncommitted changes in the Git repository.
 
-    Returns:
+    Returns
+    -------
         Tuple of (has_changes, status_output)
         - has_changes: True if there are uncommitted changes
         - status_output: Git status output string
@@ -438,7 +454,8 @@ def verify_railway_json() -> tuple[bool, str]:
     """
     Verify that railway.json exists and is valid JSON.
 
-    Returns:
+    Returns
+    -------
         Tuple of (is_valid, error_message)
         - is_valid: True if file exists and is valid JSON
         - error_message: Error description if validation fails, empty string otherwise
@@ -463,7 +480,8 @@ def verify_dockerfile() -> tuple[bool, str]:
     """
     Verify that Dockerfile exists in the project root.
 
-    Returns:
+    Returns
+    -------
         Tuple of (exists, error_message)
         - exists: True if Dockerfile exists
         - error_message: Error description if check fails, empty string otherwise
@@ -487,7 +505,8 @@ def verify_railway_dependencies() -> tuple[bool, list[str]]:
     - dj-database-url (Database URL parsing)
     - whitenoise (Static file serving)
 
-    Returns:
+    Returns
+    -------
         Tuple of (all_present, missing_deps)
         - all_present: True if all required dependencies are present
         - missing_deps: List of missing dependency names
@@ -520,7 +539,8 @@ def check_poetry_lock_consistency() -> tuple[bool, str]:
     """
     Check if poetry.lock is consistent with pyproject.toml.
 
-    Returns:
+    Returns
+    -------
         Tuple of (is_consistent, message)
         - is_consistent: True if poetry.lock is consistent with pyproject.toml
         - message: Status message
@@ -557,7 +577,8 @@ def fix_poetry_lock() -> tuple[bool, str]:
     """
     Fix poetry.lock by running poetry lock --no-update.
 
-    Returns:
+    Returns
+    -------
         Tuple of (success, message)
         - success: True if lock file was fixed successfully
         - message: Status message
@@ -586,9 +607,11 @@ def get_railway_variables(service: str | None = None) -> dict[str, str] | None:
     Get all environment variables for a Railway service.
 
     Args:
+    ----
         service: Service name (optional)
 
     Returns:
+    -------
         Dictionary of variable names and values, or None if failed
 
     """
@@ -625,9 +648,11 @@ def link_database_to_service(service: str) -> tuple[bool, str]:
     This creates a DATABASE_URL reference variable that points to the PostgreSQL service.
 
     Args:
+    ----
         service: App service name to link database to
 
     Returns:
+    -------
         Tuple of (success, message)
         - success: True if link was created successfully
         - message: Status or error message