kiro-cli 1.0.0__tar.gz → 1.0.2__tar.gz

kiro_cli-1.0.2/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: kiro-cli
+Version: 1.0.2
+Summary: A CLI scaffolding tool for backend projects
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer
+Requires-Dist: questionary
+Requires-Dist: rich
+Dynamic: license-file
+
+# ⚡ Kiro
+
+> **Stop setting up. Start building.**
+
+Kiro is an intelligent CLI scaffolding tool that helps developers bootstrap backend applications in seconds. Instead of repeatedly creating folders, installing dependencies, configuring environments, and writing boilerplate, Kiro generates a production-ready project structure tailored to your stack.
+
+Whether you're starting a small API or the foundation of your next startup, Kiro removes the repetitive setup so you can focus on building features.
+
+---
+
+## ✨ Features
+
+### 🚀 Project Generation
+
+* Interactive CLI experience
+* Multiple runtime support
+
+  * Node.js
+  * Python
+  * Go
+* Automatic project structure generation
+
+### ⚙️ Framework Support
+
+#### Node.js
+
+* Express
+* Fastify
+* NestJS *(coming soon)*
+
+#### Python
+
+* FastAPI
+* Flask
+
+#### Go
+
+* Gin
+
+### 💻 Language Support
+
+* JavaScript
+* TypeScript
+
+### 🗄 Database Support
+
+* PostgreSQL
+* MySQL
+* SQLite
+* MongoDB
+* No database
+
+### 🧩 ORM Support
+
+* Prisma
+* Drizzle
+* SQLAlchemy
+* Peewee
+* MongoEngine
+* GORM
+
+### 📦 Automatic Setup
+
+Kiro automatically:
+
+* Generates your project structure
+* Creates configuration files
+* Generates a `.env` file
+* Installs project dependencies
+* Creates framework starter files
+* Generates a project README
+* Adds a LICENSE file
+
+---
+
+## 📁 Example Project
+
+Below is an example of a project generated with **Node.js + TypeScript + Express + PostgreSQL + Prisma**.
+
+```text
+hotelms/
+├── prisma/
+│   └── schema.prisma
+├── src/
+│   ├── index.ts
+│   └── routes/
+│       └── index.ts
+├── .env
+├── .gitignore
+├── package.json
+├── tsconfig.json
+├── README.md
+├── LICENSE
+└── node_modules/
+```
+
+Kiro automatically configures the project based on your selections, including the appropriate runtime, language, framework, database, ORM, configuration files, and required dependencies.
+
+
+---
+
+## 🛣 Roadmap
+
+### v1.x
+
+* Better project templates
+* Improved error handling
+* Smarter dependency detection
+* Template customization
+
+### v2
+
+* Git initialization
+* Docker support
+* Testing setup
+* Linting & formatting
+* Authentication templates
+* Plugin system
+* Redis support
+* Background jobs
+* CI/CD templates
+
+### Future
+
+* Global installation (`pipx`, `npm create`)
+* Official documentation
+* Web landing page
+* Community template marketplace
+* First-party plugins
+
+---
+
+## 🧠 Philosophy
+
+Starting a new backend project shouldn't require copying an old repository, searching for setup commands, or recreating the same files over and over.
+
+Kiro exists to eliminate that friction.
+
+Generate your project. Install your dependencies. Start writing business logic.
+
+**Stop setting up. Start building.**
+
+---
+
+## 👨‍💻 Author
+
+Built with ❤️ by **Jimoh Olamide Prince**
+
+---
+
+## 📄 License
+
+This project is licensed under the MIT License.

kiro_cli-1.0.2/README.md

@@ -0,0 +1,153 @@
+# ⚡ Kiro
+
+> **Stop setting up. Start building.**
+
+Kiro is an intelligent CLI scaffolding tool that helps developers bootstrap backend applications in seconds. Instead of repeatedly creating folders, installing dependencies, configuring environments, and writing boilerplate, Kiro generates a production-ready project structure tailored to your stack.
+
+Whether you're starting a small API or the foundation of your next startup, Kiro removes the repetitive setup so you can focus on building features.
+
+---
+
+## ✨ Features
+
+### 🚀 Project Generation
+
+* Interactive CLI experience
+* Multiple runtime support
+
+  * Node.js
+  * Python
+  * Go
+* Automatic project structure generation
+
+### ⚙️ Framework Support
+
+#### Node.js
+
+* Express
+* Fastify
+* NestJS *(coming soon)*
+
+#### Python
+
+* FastAPI
+* Flask
+
+#### Go
+
+* Gin
+
+### 💻 Language Support
+
+* JavaScript
+* TypeScript
+
+### 🗄 Database Support
+
+* PostgreSQL
+* MySQL
+* SQLite
+* MongoDB
+* No database
+
+### 🧩 ORM Support
+
+* Prisma
+* Drizzle
+* SQLAlchemy
+* Peewee
+* MongoEngine
+* GORM
+
+### 📦 Automatic Setup
+
+Kiro automatically:
+
+* Generates your project structure
+* Creates configuration files
+* Generates a `.env` file
+* Installs project dependencies
+* Creates framework starter files
+* Generates a project README
+* Adds a LICENSE file
+
+---
+
+## 📁 Example Project
+
+Below is an example of a project generated with **Node.js + TypeScript + Express + PostgreSQL + Prisma**.
+
+```text
+hotelms/
+├── prisma/
+│   └── schema.prisma
+├── src/
+│   ├── index.ts
+│   └── routes/
+│       └── index.ts
+├── .env
+├── .gitignore
+├── package.json
+├── tsconfig.json
+├── README.md
+├── LICENSE
+└── node_modules/
+```
+
+Kiro automatically configures the project based on your selections, including the appropriate runtime, language, framework, database, ORM, configuration files, and required dependencies.
+
+
+---
+
+## 🛣 Roadmap
+
+### v1.x
+
+* Better project templates
+* Improved error handling
+* Smarter dependency detection
+* Template customization
+
+### v2
+
+* Git initialization
+* Docker support
+* Testing setup
+* Linting & formatting
+* Authentication templates
+* Plugin system
+* Redis support
+* Background jobs
+* CI/CD templates
+
+### Future
+
+* Global installation (`pipx`, `npm create`)
+* Official documentation
+* Web landing page
+* Community template marketplace
+* First-party plugins
+
+---
+
+## 🧠 Philosophy
+
+Starting a new backend project shouldn't require copying an old repository, searching for setup commands, or recreating the same files over and over.
+
+Kiro exists to eliminate that friction.
+
+Generate your project. Install your dependencies. Start writing business logic.
+
+**Stop setting up. Start building.**
+
+---
+
+## 👨‍💻 Author
+
+Built with ❤️ by **Jimoh Olamide Prince**
+
+---
+
+## 📄 License
+
+This project is licensed under the MIT License.

kiro_cli-1.0.2/kiro/cli.py

@@ -0,0 +1,75 @@
+import shutil
+import sys
+from pathlib import Path
+
+from kiro.prompts import (
+    select_runtime,
+    select_framework,
+    ask_project_name,
+    ask_language,
+    select_database,
+    select_orm,
+)
+
+from kiro.state import KiroState
+from kiro.generators import create_project
+from kiro.database import setup_database
+from kiro.orm import setup_orm
+from kiro.installers import InstallError, install_dependencies
+from kiro.ui import show_success
+
+
+def run_cli():
+    if hasattr(sys.stdout, "reconfigure"):
+        sys.stdout.reconfigure(encoding="utf-8")
+
+    print("\n⚡ Welcome to Kiro\n")
+
+    state = KiroState()
+
+    state.runtime = select_runtime()
+    print(f"\n✔ Selected runtime: {state.runtime}")
+
+    if state.runtime == "Node.js":
+        state.language = ask_language()
+        print(f"\n✔ Language: {state.language}")
+
+    state.framework = select_framework(state.runtime)
+    print(f"\n✔ Selected framework: {state.framework}")
+
+    state.project_name = ask_project_name()
+    print(f"\n✔ Project name: {state.project_name}")
+
+    state.database = select_database()
+    print(f"\n✔ Database: {state.database}")
+
+    state.orm = select_orm(state.runtime, state.database)
+
+    if state.orm and state.orm != "None":
+        print(f"\n✔ ORM: {state.orm}")
+
+    project_path = Path(state.project_name)
+    already_existed = project_path.exists()
+
+    try:
+        create_project(state)
+        setup_database(state)
+        setup_orm(state)
+        try:
+            install_dependencies(state)
+        except InstallError as exc:
+            print(f"\n⚠ Could not install dependencies: {exc}")
+            print(f"Project files were generated at ./{state.project_name}")
+            print("Install dependencies manually, then start building.\n")
+            show_success(state)
+            sys.exit(1)
+
+        show_success(state)
+    except KeyboardInterrupt:
+        print("\nCancelled.")
+        sys.exit(130)
+    except Exception as exc:
+        print(f"\n✖ Failed to create project: {exc}")
+        if not already_existed and project_path.exists():
+            shutil.rmtree(project_path, ignore_errors=True)
+        sys.exit(1)

{kiro_cli-1.0.0 → kiro_cli-1.0.2}/kiro/database.py

@@ -1,5 +1,6 @@
 from pathlib import Path
 
+
 def setup_database(state):
     if state.database == "None":
         return
@@ -15,9 +16,12 @@ def setup_database(state):
     }
 
     database_url = database_urls.get(state.database)
+    project.mkdir(parents=True, exist_ok=True)
 
     if database_url:
-        with env.open("a") as f:
-            f.write(f"DATABASE_URL={database_url}\n")
+        existing = env.read_text(encoding="utf-8") if env.exists() else ""
+        if "DATABASE_URL=" not in existing:
+            with env.open("a", encoding="utf-8") as f:
+                f.write(f"DATABASE_URL={database_url}\n")
 
-    print(f"🗄 Setting up {state.database}...")
+    print(f"🗄 Setting up {state.database}...")

kiro_cli-1.0.2/kiro/generators.py

@@ -0,0 +1,100 @@
+from pathlib import Path
+import shutil
+
+from kiro.utils.files import replace_placeholders
+
+PACKAGE_DIR = Path(__file__).resolve().parent
+
+LICENSE_TEXT = """MIT License
+
+Copyright (c) 2026
+
+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.
+"""
+
+
+def create_project(state):
+    base_path = Path(state.project_name)
+    base_path.mkdir(parents=True, exist_ok=True)
+
+    template_path = get_template_path(state)
+
+    if not template_path or not template_path.exists():
+        raise FileNotFoundError(
+            f"No template found for {state.runtime} / {state.framework}"
+            + (f" / {state.language}" if state.language else "")
+            + f" (looked in {template_path})"
+        )
+
+    shutil.copytree(
+        template_path,
+        base_path,
+        dirs_exist_ok=True,
+    )
+
+    write_readme(base_path, state)
+    (base_path / "LICENSE").write_text(LICENSE_TEXT, encoding="utf-8")
+    replace_placeholders(base_path, state)
+
+
+def write_readme(base_path: Path, state):
+    language = f" ({state.language})" if state.language else ""
+    orm = f"\n- ORM: {state.orm}" if state.orm and state.orm != "None" else ""
+    database = f"\n- Database: {state.database}" if state.database and state.database != "None" else ""
+
+    if state.runtime == "Node.js":
+        run_block = "```bash\nnpm run dev\n```"
+    elif state.runtime == "Python" and state.framework == "FastAPI":
+        run_block = "```bash\nuvicorn app.main:app --reload\n```"
+    elif state.runtime == "Python":
+        run_block = "```bash\npython app.py\n```"
+    else:
+        run_block = "```bash\ngo run .\n```"
+
+    content = f"""# {state.project_name}
+
+Backend project generated by Kiro.
+
+- Runtime: {state.runtime}{language}
+- Framework: {state.framework}{database}{orm}
+
+## Run
+
+{run_block}
+"""
+    (base_path / "README.md").write_text(content, encoding="utf-8")
+
+
+def get_template_path(state):
+    base = PACKAGE_DIR / "templates"
+
+    if state.runtime == "Node.js":
+        framework = state.framework.lower()
+        language = state.language.lower()
+        return base / "node" / framework / language
+
+    if state.runtime == "Python":
+        framework = state.framework.lower()
+        return base / "python" / framework
+
+    if state.runtime == "Go":
+        framework = state.framework.lower()
+        return base / "go" / framework
+
+    return None

kiro_cli-1.0.2/kiro/installers.py

@@ -0,0 +1,98 @@
+"""Install dependencies for generated Kiro projects."""
+
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+from kiro.packages import get_packages
+
+
+class InstallError(Exception):
+    """Raised when a project dependency install step fails."""
+
+
+def install_dependencies(state):
+    """Install the dependencies implied by the user's project selections."""
+    project = Path(state.project_name).resolve()
+
+    if not project.is_dir():
+        raise InstallError(f"Generated project directory was not found: {project}")
+
+    packages, dev_packages = get_packages(state)
+
+    try:
+        if state.runtime == "Node.js":
+            _install_node_dependencies(project, packages, dev_packages, state)
+        elif state.runtime == "Python":
+            _install_python_dependencies(project, packages)
+        elif state.runtime == "Go":
+            _install_go_dependencies(project, packages)
+        else:
+            raise InstallError(f"Unsupported runtime: {state.runtime}")
+    except FileNotFoundError as exc:
+        raise InstallError(str(exc)) from exc
+    except subprocess.CalledProcessError as exc:
+        command = " ".join(str(part) for part in exc.cmd) if exc.cmd else "install"
+        raise InstallError(
+            f"`{command}` failed with exit code {exc.returncode}."
+        ) from exc
+
+    print("Dependencies installed successfully.")
+
+
+def _require_command(name: str) -> str:
+    command = shutil.which(name)
+    if not command:
+        raise InstallError(f"{name} was not found on PATH. Install it and try again.")
+    return command
+
+
+def _run(command: list[str], cwd: Path):
+    subprocess.run(command, cwd=cwd, check=True)
+
+
+def _install_node_dependencies(project: Path, packages: list[str], dev_packages: list[str], state):
+    npm = _require_command("npm")
+
+    _run([npm, "install"], project)
+
+    if packages:
+        _run([npm, "install", *packages], project)
+    if dev_packages:
+        _run([npm, "install", "--save-dev", *dev_packages], project)
+
+    if getattr(state, "orm", None) == "Prisma":
+        npx = _require_command("npx")
+        _run([npx, "prisma", "generate"], project)
+
+
+def _install_python_dependencies(project: Path, packages: list[str]):
+    pip = _create_python_venv(project)
+    requirements = project / "requirements.txt"
+
+    if requirements.is_file() and requirements.stat().st_size > 0:
+        _run([str(pip), "install", "-r", str(requirements)], project)
+    if packages:
+        _run([str(pip), "install", *packages], project)
+
+
+def _create_python_venv(project: Path) -> Path:
+    if sys.platform == "win32":
+        pip = project / ".venv" / "Scripts" / "pip.exe"
+    else:
+        pip = project / ".venv" / "bin" / "pip"
+
+    if not pip.is_file():
+        print("Creating virtual environment...")
+        _run([sys.executable, "-m", "venv", ".venv"], project)
+
+    return pip
+
+
+def _install_go_dependencies(project: Path, packages: list[str]):
+    go = _require_command("go")
+
+    for package in packages:
+        _run([go, "get", package], project)
+    _run([go, "mod", "tidy"], project)