alms-cli 0.1.0__tar.gz

alms_cli-0.1.0/.gitignore

@@ -0,0 +1,35 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv/
+env/
+venv/
+ENV/
+
+# Configuration
+.env
+.python-version
+
+# Logs
+logs/
+*.log
+src/logs/
+
+# Pytest
+.pytest_cache/
+.coverage
+htmlcov/
+
+# IDEs
+.vscode/
+.idea/
+.trae/
+
+# Docker
+.docker/

alms_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ALMS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

alms_cli-0.1.0/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: alms-cli
+Version: 0.1.0
+Summary: ALMS CLI - Beautiful project scaffolding tool for AI-first backends
+Project-URL: Homepage, https://github.com/KJ-AIML/alms
+Project-URL: Repository, https://github.com/KJ-AIML/alms
+Project-URL: Documentation, https://github.com/KJ-AIML/alms#readme
+Project-URL: Bug Tracker, https://github.com/KJ-AIML/alms/issues
+Author-email: Your Name <your.email@example.com>
+License: MIT
+License-File: LICENSE
+Keywords: ai,alms,backend,cli,fastapi,scaffolding,starter-kit
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.13
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: typer>=0.12.0
+Description-Content-Type: text/markdown
+
+# ALMS CLI
+
+> **Beautiful project scaffolding tool for AI-first backends.**
+
+## Installation
+
+### Install via pip (Global)
+
+```bash
+pip install alms-cli
+```
+
+### Install via uv (Recommended)
+
+```bash
+uv pip install alms-cli
+```
+
+### Run without installing (like uvx)
+
+```bash
+uvx alms-cli
+```
+
+## Usage
+
+### Create a new project
+
+```bash
+alms init my-project
+```
+
+### Create a project non-interactively
+
+```bash
+alms init my-project --no-interactive
+```
+
+### Show project information
+
+```bash
+alms info
+```
+
+## Features
+
+- Beautiful terminal UI with Rich
+- Interactive prompts with Questionary
+- Complete ALMS project scaffolding
+- Feature selection (Database, Redis, AI Agents, Observability, Docker, CI/CD)
+- Progress indicators and status updates
+
+## Development
+
+### Local development
+
+```bash
+cd cli
+uv sync
+uv run alms
+```
+
+### Build package
+
+```bash
+cd cli
+uv pip install build
+uv run python -m build
+```
+
+### Publish to PyPI
+
+```bash
+# Install twine
+uv pip install twine
+
+# Upload to PyPI
+twine upload dist/*
+```
+
+## License
+
+MIT

alms_cli-0.1.0/README.md

@@ -0,0 +1,83 @@
+# ALMS CLI
+
+> **Beautiful project scaffolding tool for AI-first backends.**
+
+## Installation
+
+### Install via pip (Global)
+
+```bash
+pip install alms-cli
+```
+
+### Install via uv (Recommended)
+
+```bash
+uv pip install alms-cli
+```
+
+### Run without installing (like uvx)
+
+```bash
+uvx alms-cli
+```
+
+## Usage
+
+### Create a new project
+
+```bash
+alms init my-project
+```
+
+### Create a project non-interactively
+
+```bash
+alms init my-project --no-interactive
+```
+
+### Show project information
+
+```bash
+alms info
+```
+
+## Features
+
+- Beautiful terminal UI with Rich
+- Interactive prompts with Questionary
+- Complete ALMS project scaffolding
+- Feature selection (Database, Redis, AI Agents, Observability, Docker, CI/CD)
+- Progress indicators and status updates
+
+## Development
+
+### Local development
+
+```bash
+cd cli
+uv sync
+uv run alms
+```
+
+### Build package
+
+```bash
+cd cli
+uv pip install build
+uv run python -m build
+```
+
+### Publish to PyPI
+
+```bash
+# Install twine
+uv pip install twine
+
+# Upload to PyPI
+twine upload dist/*
+```
+
+## License
+
+MIT

alms_cli-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[project]
+name = "alms-cli"
+version = "0.1.0"
+description = "ALMS CLI - Beautiful project scaffolding tool for AI-first backends"
+readme = "README.md"
+requires-python = ">=3.13"
+license = {text = "MIT"}
+authors = [
+    {name = "Your Name", email = "your.email@example.com"}
+]
+keywords = ["cli", "scaffolding", "fastapi", "ai", "backend", "starter-kit", "alms"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Code Generators",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+dependencies = [
+    "typer>=0.12.0",
+    "rich>=13.7.0",
+    "questionary>=2.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/KJ-AIML/alms"
+Repository = "https://github.com/KJ-AIML/alms"
+Documentation = "https://github.com/KJ-AIML/alms#readme"
+"Bug Tracker" = "https://github.com/KJ-AIML/alms/issues"
+
+[project.scripts]
+alms = "alms_cli.main:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/alms_cli"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/README.md",
+    "/LICENSE",
+]

alms_cli-0.1.0/src/alms_cli/__init__.py

@@ -0,0 +1,3 @@
+"""ALMS CLI - Beautiful project scaffolding tool."""
+
+__version__ = "0.1.0"

alms_cli-0.1.0/src/alms_cli/__main__.py

@@ -0,0 +1,5 @@
+"""Entry point for running CLI as module."""
+
+from alms_cli.main import app
+
+app()

alms_cli-0.1.0/src/alms_cli/commands/__init__.py

@@ -0,0 +1,6 @@
+"""CLI commands."""
+
+from alms_cli.commands.init import init_command
+from alms_cli.commands.info import info_app
+
+__all__ = ["init_command", "info_app"]

alms_cli-0.1.0/src/alms_cli/commands/info.py

@@ -0,0 +1,73 @@
+"""Info command - Show project information."""
+
+import typer
+from pathlib import Path
+from rich.console import Console
+from rich.table import Table
+from rich import box
+from rich.panel import Panel
+
+from alms_cli.ui.components import print_tree, print_error, print_info
+from alms_cli import __version__
+
+info_app = typer.Typer(
+    name="info",
+    help="Show project information",
+    add_completion=False,
+    rich_markup_mode="rich",
+)
+
+console = Console()
+
+
+@info_app.command()
+def project():
+    """Show information about the current ALMS project."""
+    
+    project_root = Path.cwd()
+    
+    pyproject = project_root / "pyproject.toml"
+    if not pyproject.exists():
+        print_error("Not an ALMS project (pyproject.toml not found)")
+        console.print()
+        print_info("Run 'alms init <name>' to create a new project")
+        console.print()
+        raise typer.Exit(1)
+    
+    console.print()
+    console.print(
+        Panel(
+            f"[bold white]ALMS Project Info[/bold white]\n"
+            f"[dim]CLI Version: {__version__}[/dim]",
+            box=box.ROUNDED,
+            border_style="blue",
+        )
+    )
+    console.print()
+    
+    table = Table(
+        box=box.ROUNDED,
+        border_style="blue",
+        title="[bold]Project Details[/bold]",
+    )
+    
+    table.add_column("Property", style="bold blue")
+    table.add_column("Value", style="white")
+    
+    table.add_row("Name", project_root.name)
+    table.add_row("Location", str(project_root))
+    table.add_row("Has pyproject.toml", "Yes")
+    table.add_row("Has src/", str((project_root / "src").exists()))
+    table.add_row("Has tests/", str((project_root / "src" / "tests").exists()))
+    table.add_row("Has alembic/", str((project_root / "alembic").exists()))
+    
+    console.print(table)
+    console.print()
+    
+    console.print("[bold]Project Structure:[/bold]")
+    console.print()
+    
+    if (project_root / "src").exists():
+        print_tree(project_root / "src")
+    
+    console.print()

alms_cli-0.1.0/src/alms_cli/commands/init.py

@@ -0,0 +1,129 @@
+"""Init command - Create a new ALMS project."""
+
+import typer
+from pathlib import Path
+from rich.console import Console
+from rich.panel import Panel
+from rich import box
+import questionary
+
+from alms_cli.ui.components import (
+    print_header,
+    print_step,
+    print_success,
+    print_error,
+    print_info,
+    print_warning,
+    create_progress,
+    print_project_summary,
+)
+from alms_cli.templates import TemplateGenerator
+
+console = Console()
+
+
+def init_command(
+    name: str = typer.Argument(None, help="Project name"),
+    path: str = typer.Option(None, "--path", "-p", help="Path to create project"),
+    interactive: bool = typer.Option(True, "--interactive/--no-interactive", "-i", help="Interactive mode"),
+):
+    """Create a new ALMS project with beautiful scaffolding."""
+    
+    print_header("ALMS Project Generator", "AI-First Backend Starter Kit")
+    
+    if not name:
+        if interactive:
+            name = questionary.text(
+                "Project name:",
+                default="my-alms-project",
+                validate=lambda x: len(x) > 0 and x.replace("-", "").replace("_", "").isalnum(),
+            ).ask()
+            
+            if not name:
+                print_error("Project name is required")
+                raise typer.Exit(1)
+        else:
+            print_error("Project name is required")
+            raise typer.Exit(1)
+    
+    project_path = Path(path) / name if path else Path(name)
+    
+    if project_path.exists():
+        if interactive:
+            overwrite = questionary.confirm(
+                f"Directory '{name}' already exists. Overwrite?",
+                default=False,
+            ).ask()
+            
+            if not overwrite:
+                print_warning("Project creation cancelled")
+                raise typer.Exit(0)
+        else:
+            print_error(f"Directory '{name}' already exists")
+            raise typer.Exit(1)
+    
+    features = []
+    
+    if interactive:
+        print_info("Select features to include:")
+        console.print()
+        
+        answers = questionary.checkbox(
+            "Features:",
+            choices=[
+                questionary.Choice("Database (PostgreSQL)", checked=True),
+                questionary.Choice("Redis Cache", checked=True),
+                questionary.Choice("AI Agents (LangChain)", checked=True),
+                questionary.Choice("Observability (OpenTelemetry)", checked=True),
+                questionary.Choice("Docker Support", checked=True),
+                questionary.Choice("CI/CD (GitHub Actions)", checked=True),
+            ],
+        ).ask()
+        
+        features = [a for a in (answers or [])]
+    
+    console.print()
+    print_step(1, 4, f"Creating project structure in {project_path}")
+    
+    with create_progress() as progress:
+        task = progress.add_task("Generating files...", total=100)
+        
+        generator = TemplateGenerator(name, project_path)
+        files_created = generator.generate(features)
+        
+        progress.update(task, completed=100)
+    
+    print_success(f"Created {files_created} files")
+    console.print()
+    
+    print_step(2, 4, "Setting up configuration")
+    print_success("Environment template created (.env.example)")
+    print_success("Git ignore created (.gitignore)")
+    print_success("Docker configuration created")
+    console.print()
+    
+    print_step(3, 4, "Initializing project structure")
+    print_success("API layer created")
+    print_success("Execution layer created")
+    print_success("Agent layer created")
+    print_success("Database layer created")
+    print_success("Observability layer created")
+    console.print()
+    
+    print_step(4, 4, "Finalizing setup")
+    print_success("Tests scaffolded")
+    print_success("Documentation created")
+    print_success("GitHub workflows configured")
+    console.print()
+    
+    print_project_summary(project_path, files_created, features or ["All features"])
+    
+    console.print(
+        Panel(
+            "[bold green]Your ALMS project is ready![/bold green]\n\n"
+            "[dim]Run the commands above to get started[/dim]",
+            box=box.ROUNDED,
+            border_style="green",
+        )
+    )
+    console.print()

alms_cli-0.1.0/src/alms_cli/main.py

@@ -0,0 +1,41 @@
+"""Main CLI application entry point."""
+
+import typer
+from typer import Typer
+from rich.console import Console
+from alms_cli import __version__
+from alms_cli.commands.init import init_command
+from alms_cli.commands.info import info_app
+
+app = Typer(
+    name="alms",
+    help="ALMS CLI - Beautiful project scaffolding tool",
+    add_completion=False,
+    rich_markup_mode="rich",
+)
+
+console = Console()
+
+app.command(name="init")(init_command)
+app.add_typer(info_app, name="info")
+
+@app.callback(invoke_without_command=True)
+def main(ctx: typer.Context):
+    """ALMS CLI - AI-First Backend Project Scaffolding"""
+    if ctx.invoked_subcommand:
+        return
+    
+    console.print()
+    console.print("[bold blue]╔══════════════════════════════════════════╗[/bold blue]")
+    console.print("[bold blue]║[/bold blue] [bold white]ALMS CLI[/bold white]                          [bold blue]║[/bold blue]")
+    console.print("[bold blue]║[/bold blue] [dim]AI-First Backend Project Scaffolding[/dim]  [bold blue]║[/bold blue]")
+    console.print("[bold blue]╚══════════════════════════════════════════╝[/bold blue]")
+    console.print()
+    console.print(f"[dim]Version: {__version__}[/dim]")
+    console.print()
+    console.print("[bold]Commands:[/bold]")
+    console.print("  [green]init[/green]     Create a new ALMS project")
+    console.print("  [green]info[/green]     Show project information")
+    console.print()
+    console.print("[dim]Run 'alms <command> --help' for more information[/dim]")
+    console.print()