quickscale-cli 0.57.1__tar.gz

quickscale_cli-0.57.1/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.1
+Name: quickscale-cli
+Version: 0.57.1
+Summary: Command-line interface for QuickScale Django project generator
+Home-page: https://github.com/Experto-AI/quickscale
+License: Apache-2.0
+Keywords: django,cli,project-generator,saas
+Author: Experto AI
+Author-email: victor@experto.ai
+Requires-Python: >=3.10,<4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+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.57.1,<0.58.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.57.1/pyproject.toml

@@ -0,0 +1,107 @@
+[tool.poetry]
+name = "quickscale-cli"
+version = "0.57.1"
+description = "Command-line interface for QuickScale Django project generator"
+authors = ["Experto AI <victor@experto.ai>"]
+license = "Apache-2.0"
+keywords = ["django", "cli", "project-generator", "saas"]
+homepage = "https://github.com/Experto-AI/quickscale"
+repository = "https://github.com/Experto-AI/quickscale"
+documentation = "https://github.com/Experto-AI/quickscale/tree/main/docs"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Framework :: Django",
+    "Framework :: Django :: 4.2",
+    "Framework :: Django :: 5.0",
+]
+packages = [{include = "quickscale_cli", from = "src"}]
+
+[tool.poetry.dependencies]
+python = "^3.10"
+click = "^8.1.0"
+quickscale-core = "^0.57.1"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^7.4.0"
+pytest-cov = "^4.1.0"
+ruff = "^0.6.0"
+mypy = "^1.8.0"
+
+[tool.poetry.scripts]
+quickscale = "quickscale_cli.main:cli"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "--strict-markers",
+    "--strict-config",
+    "--cov=quickscale_cli",
+    "--cov-report=term-missing",
+    "--cov-report=html",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = [
+    "E",  # pycodestyle errors
+    "W",  # pycodestyle warnings
+    "F",  # pyflakes
+    "I",  # isort
+    "N",  # pep8-naming
+    "UP", # pyupgrade
+    "D",  # docstring rules
+]
+ignore = [
+    "D100",  # Missing docstring in public module
+    "D101",  # Missing docstring in public class
+    "D102",  # Missing docstring in public method
+    "D103",  # Missing docstring in public function
+    "D105",  # Missing docstring in magic method
+    "D107",  # Missing docstring in __init__
+    "D203",  # 1 blank line required before class docstring (incompatible with D211)
+    "D212",  # Multi-line docstring summary should start at the first line (incompatible with D213)
+    "D400",  # First line should end with a period
+    "D415",  # First line should end with a period, question mark, or exclamation point
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["quickscale_cli", "quickscale_core"]
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+disallow_untyped_decorators = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+warn_unreachable = true
+strict_equality = true
+show_error_codes = true
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+check_untyped_defs = false
+
+

quickscale_cli-0.57.1/src/quickscale_cli/__init__.py

@@ -0,0 +1,34 @@
+"""QuickScale CLI package.
+
+Reads the canonical version from the repository-level `VERSION` file so the CLI
+stays in sync with other packages when the release is bumped in one place.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Tuple
+
+__author__ = "Experto AI"
+__email__ = "victor@experto.ai"
+
+# Prefer an embedded package-level `_version.py` if it exists (build step).
+try:
+    from ._version import __version__  # type: ignore
+except Exception:
+    _root = Path(__file__).resolve().parents[3]
+    _version_file = _root / "VERSION"
+    if _version_file.exists():
+        __version__ = _version_file.read_text(encoding="utf8").strip()
+    else:
+        __version__ = "0.0.0"
+
+# Version tuple for programmatic access
+parts = __version__.split("-")[0].split(".")
+VERSION: Tuple[int, int, int] = (
+    int(parts[0]) if len(parts) > 0 else 0,
+    int(parts[1]) if len(parts) > 1 else 0,
+    int(parts[2]) if len(parts) > 2 else 0,
+)
+
+__all__ = ["__version__", "VERSION"]

quickscale_cli-0.57.1/src/quickscale_cli/_version.py

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

quickscale_cli-0.57.1/src/quickscale_cli/main.py

@@ -0,0 +1,81 @@
+"""QuickScale CLI - Main entry point for project generation commands."""
+
+from pathlib import Path
+
+import click
+
+import quickscale_cli
+import quickscale_core
+from quickscale_core.generator import ProjectGenerator
+
+
+@click.group()
+@click.version_option(version=quickscale_cli.__version__, prog_name="quickscale")
+def cli() -> None:
+    """QuickScale - Compose your Django SaaS."""
+    pass
+
+
+@cli.command()
+def version() -> None:
+    """Show version information for CLI and core packages."""
+    click.echo(f"QuickScale CLI v{quickscale_cli.__version__}")
+    click.echo(f"QuickScale Core v{quickscale_core.__version__}")
+
+
+@cli.command()
+@click.argument("project_name")
+def init(project_name: str) -> None:
+    """Generate a new Django project with production-ready configurations."""
+    try:
+        # Initialize generator
+        generator = ProjectGenerator()
+
+        # Generate project in current directory
+        output_path = Path.cwd() / project_name
+
+        click.echo(f"🚀 Generating project: {project_name}")
+        generator.generate(project_name, output_path)
+
+        # Success message
+        click.secho(f"\n✅ Created project: {project_name}", fg="green", bold=True)
+
+        # Next steps instructions
+        click.echo("\n📋 Next steps:")
+        click.echo(f"  cd {project_name}")
+        click.echo("  # Recommended: use Poetry for dependency management")
+        click.echo("  poetry install")
+        click.echo("  poetry run python manage.py migrate")
+        click.echo("  poetry run python manage.py runserver")
+        click.echo("\n📖 See README.md for more details")
+
+    except ValueError as e:
+        # Invalid project name
+        click.secho(f"❌ Error: {e}", fg="red", err=True)
+        click.echo("\n💡 Tip: Project name must be a valid Python identifier", err=True)
+        click.echo("   - Use only letters, numbers, and underscores", err=True)
+        click.echo("   - Cannot start with a number", err=True)
+        click.echo("   - Cannot use Python reserved keywords", err=True)
+        raise click.Abort()
+    except FileExistsError as e:
+        # Directory already exists
+        click.secho(f"❌ Error: {e}", fg="red", err=True)
+        click.echo(
+            "\n💡 Tip: Choose a different project name or remove the existing directory", err=True
+        )
+        raise click.Abort()
+    except PermissionError as e:
+        # Permission issues
+        click.secho(f"❌ Error: {e}", fg="red", err=True)
+        click.echo("\n💡 Tip: Check directory permissions or try a different location", err=True)
+        raise click.Abort()
+    except Exception as e:
+        # Unexpected errors
+        click.secho(f"❌ Unexpected error: {e}", fg="red", err=True)
+        click.echo("\n🐛 This is a bug. Please report it at:", err=True)
+        click.echo("   https://github.com/Experto-AI/quickscale/issues", err=True)
+        raise
+
+
+if __name__ == "__main__":
+    cli()