krickstart 1.2.0__tar.gz

krickstart-1.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nidhal Zitouni
+
+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.

krickstart-1.2.0/PKG-INFO

@@ -0,0 +1,249 @@
+Metadata-Version: 2.4
+Name: krickstart
+Version: 1.2.0
+Summary: Lightning-fast local dev environment manager powered by Docker Compose
+Author-email: Nidhal Zitouni <zitouninidhal@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ZitouniNidhal/Krickstart
+Project-URL: Documentation, https://github.com/ZitouniNidhal/Krickstart#readme
+Project-URL: Repository, https://github.com/ZitouniNidhal/Krickstart.git
+Project-URL: Issues, https://github.com/ZitouniNidhal/Krickstart/issues
+Project-URL: Changelog, https://github.com/ZitouniNidhal/Krickstart/blob/master/ROADMAP.md
+Keywords: developer-tools,docker,docker-compose,dev-environment,dx,local-development,krickstart
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: black>=24.0; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: pip-audit>=2.7; extra == "dev"
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0.12; extra == "dev"
+Dynamic: license-file
+
+# ⚡ Krickstart 
+
+**Spin up a reproducible local development environment in seconds.**
+
+[![Build](https://img.shields.io/github/actions/workflow/status/ZitouniNidhal/Krickstart/ci.yml?branch=master&label=build)](https://github.com/ZitouniNidhal/Krickstart/actions)
+[![PyPI](https://img.shields.io/pypi/v/krickstart.svg)](https://pypi.org/project/krickstart/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://pypi.org/project/krickstart/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+
+`krickstart` is an opinionated, high-performance CLI tool that turns a concise `krickstart.yaml` recipe into a fully operational, reproducible Docker Compose environment. It eliminates the "it works on my machine" struggle by automating starter templates, database wiring, environment contracts, and connection URL generation.
+
+**Stop debugging ports, volumes, and health checks. Start building.**
+
+```text
+krickstart.yaml  ➔  krickstart up  ➔  🚀 Ready-to-code Stack (App + Database + URLs)
+```
+
+---
+
+## 🏛️ Architecture Overview
+
+`krickstart`  sits as a declarative translation layer between your team's configuration contract and Docker Compose
+
+```mermaid
+flowchart TD
+    subgraph User Workspace
+        YAML["krickstart.yaml\n(Team Contract)"]
+        CLI["krickstart CLI\n(create / doctor / up / down)"]
+    end
+
+    subgraph Core Engine
+        REG["Plugin Registry\n(Built-in + Entry Points)"]
+        VAL["Schema & Port Validator\n(Conflict Detection)"]
+        GEN["Compose Generator\n(Atomic Writes & Locks)"]
+    end
+
+    subgraph Generated Outputs
+        DC["docker-compose.krickstart.yml\n(Services, Volumes, Healthchecks)"]
+        ENV[".env.krickstart\n(DATABASE_URL, REDIS_URL)"]
+        EX[".env.example\n(Masked Team Template)"]
+    end
+
+    subgraph Runtime
+        DOCKER["Docker Engine / Compose v2\n(127.0.0.1 Isolated Containers)"]
+    end
+
+    YAML --> CLI
+    CLI --> VAL
+    CLI --> REG
+    REG --> GEN
+    VAL --> GEN
+    GEN --> DC
+    GEN --> ENV
+    GEN --> EX
+    DC --> DOCKER
+```
+
+---
+
+## 📊 Krickstart vs. Alternatives
+
+| Capability | ⚡ Krickstart | Docker Compose | VS Code Dev Containers | Tilt | Nix / devenv |
+| :--- | :---: | :---: | :---: | :---: | :---: |
+| **Instant Starters** | ✅ Built-in Stacks | ❌ Manual Setup | ⚠️ Template repos | ❌ Manual Tiltfile | ⚠️ Custom flake |
+| **Configuration Complexity** | 🟢 Low (~15 lines YAML) | 🔴 High (verbose Compose) | 🟡 Medium (`devcontainer.json`) | 🔴 High (Starlark/Tiltfile) | 🔴 High (Nix language) |
+| **Auto-Wiring (`.env` / URLs)** | ✅ Automated | ❌ Manual `.env` | ⚠️ Partial | ❌ Manual | ⚠️ Environment vars only |
+| **Editor Agnostic** | ✅ Any editor/IDE | ✅ Any editor/IDE | ❌ Optimized for VS Code | ✅ Any editor/IDE | ✅ Any editor/IDE |
+| **Learning Curve** | 🚀 2 minutes | ⏳ Days | ⏳ Hours | ⏳ Days (K8s required) | ⏳ Weeks (Nix syntax) |
+| **Host Port Conflict Checks** | ✅ `doctor` pre-flight | ❌ Fails on startup | ❌ Manual | ⚠️ Port-forwarding | ❌ Fails on startup |
+| **Localhost Isolation (127.0.0.1)** | ✅ Default | ❌ Defaults to `0.0.0.0` | ⚠️ Container internal | ⚠️ Varies | N/A (Host processes) |
+
+---
+
+## 🚀 Quick Start
+
+### Prerequisites
+- **Python 3.10+**
+- **Docker Desktop** or Docker Engine with Docker Compose v2
+
+### Installation
+
+Install via your preferred Python tool manager:
+
+```bash
+# Recommended (isolated CLI application)
+pipx install krickstart
+# or with uv:
+uv tool install krickstart
+
+# Or with standard pip
+pip install krickstart
+```
+
+### 30-Second Setup
+
+```bash
+# 1. Interactively choose a stack (e.g. FastAPI + PostgreSQL)
+krickstart create
+
+# 2. Check local environment and port availability
+krickstart doctor
+
+# 3. Launch isolated environment
+krickstart up
+```
+
+### Scripted / CI Workflow
+
+```bash
+krickstart init fastapi-postgres --name billing-api
+krickstart doctor
+krickstart up
+```
+
+---
+
+## 📦 Maintained Stacks
+
+All maintained stacks feature health checks, volume persistence, and loopback security (`127.0.0.1` binding):
+
+| Stack | Description | Included Services |
+| :--- | :--- | :--- |
+| `fastapi-postgres` | Python FastAPI REST API | FastAPI (Python 3.12), PostgreSQL 16 |
+| `django-postgres` | Django Web Framework | Django (Python 3.12), PostgreSQL 16 |
+| `flask-postgres` | Flask Microframework | Flask, PostgreSQL 16 |
+| `node-postgres-redis` | Node.js Express API | Express (Node 22), PostgreSQL 16, Redis 7 |
+| `nextjs-postgres` | Next.js App Router | Next.js, PostgreSQL 16 |
+| `go-gin-postgres` | Go Gin REST API | Go Gin, PostgreSQL 16 |
+| `spring-boot-postgres` | Java Spring Boot | Spring Boot (JDK 21), PostgreSQL 16 |
+
+---
+
+## 🛠️ CLI Command Reference
+
+| Command | Description |
+| :--- | :--- |
+| `krickstart list` | Show all available stack templates and descriptions |
+| `krickstart init <stack>` | Generate `krickstart.yaml` and starter files for a chosen stack |
+| `krickstart create` | Interactive terminal wizard to pick and initialize a stack |
+| `krickstart validate` | Validate schema and ensure stack plugin can render without errors |
+| `krickstart doctor` | Health-check Docker, Compose v2, YAML syntax, and detect port conflicts |
+| `krickstart doctor --fix` | Automatically repair missing safe assets (e.g., regenerate `.env.example`) |
+| `krickstart up` | Render Compose files and start containers in detached mode |
+| `krickstart up --dry-run` | Preview generated YAML and `.env` files without writing or starting Docker |
+| `krickstart down` | Gracefully stop containers (preserves database volumes) |
+| `krickstart status` | Display container runtime health and port mappings (`docker compose ps`) |
+| `krickstart logs [service]` | View or follow service logs (`--follow` supported) |
+| `krickstart export` | Export standalone `docker-compose.yml` and `.env` for production or CI |
+| `krickstart cleanup` | Stop containers, remove named volumes, and clean up generated files |
+
+---
+
+## 🔒 Security Best Practices
+
+1. **Loopback Isolation (`127.0.0.1`)**: `krickstart` binds container ports to `127.0.0.1` by default rather than `0.0.0.0`, protecting databases and internal APIs from exposure on public Wi-Fi or local networks.
+2. **Masked Examples**: Generated `.env.example` templates automatically redact credentials so teammates can safely commit environment templates to git without leaking passwords.
+3. **Never Commit Generated Files**:
+   Add to your `.gitignore`:
+   ```gitignore
+   docker-compose.krickstart.yml
+   .env.krickstart
+   .env
+   ```
+
+---
+
+## 🔌 Plugin System & Extensibility
+
+`krickstart` provides an open plugin interface using Python entry points. Organizations can package internal corporate stacks and publish them as private or public packages.
+
+Third-party packages expose plugins via the `krickstart.stacks` entry point group in `pyproject.toml`:
+
+```toml
+[project.entry-points."krickstart.stacks"]
+company-microservice = "my_company_stacks.microservice:MicroservicePlugin"
+```
+
+Plugins implement the `StackPlugin` interface (`name`, `description`, `default_config`, `compose_yaml`, `env_file`, `post_up_hints`). See [docs/plugin-authoring.md](docs/plugin-authoring.md) for complete details.
+
+---
+
+## 🤝 Contributing
+
+We love contributions! Whether it's a new stack template, a bug fix, or documentation improvement, please check out our [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
+
+**Ways to help:**
+- 🌟 **Star the repo** to show your support.
+- 🐛 **Report bugs** or request features in the Issues tab.
+- 🛠️ **Build a plugin** and share your custom stack with the community.
+- 📝 **Improve docs** to help other developers get started faster.
+
+## 📖 Guides
+For detailed instructions, explore our documentation:
+- [🚀 Getting Started](./docs/getting-started.md) - From installation to your first stack.
+- [🛠️ Custom Stacks](./docs/custom-stacks.md) - How to extend devspeed with your own templates.
+- [🔍 Troubleshooting](./docs/troubleshooting.md) - Solving common Docker and config issues.
+
+
+```bash
+# Run local test suite and quality gates:
+python scripts/dev.py check
+```
+
+## 📄 License
+
+This project is licensed under the [MIT License](LICENSE).

krickstart-1.2.0/README.md

@@ -0,0 +1,209 @@
+# ⚡ Krickstart 
+
+**Spin up a reproducible local development environment in seconds.**
+
+[![Build](https://img.shields.io/github/actions/workflow/status/ZitouniNidhal/Krickstart/ci.yml?branch=master&label=build)](https://github.com/ZitouniNidhal/Krickstart/actions)
+[![PyPI](https://img.shields.io/pypi/v/krickstart.svg)](https://pypi.org/project/krickstart/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://pypi.org/project/krickstart/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+
+`krickstart` is an opinionated, high-performance CLI tool that turns a concise `krickstart.yaml` recipe into a fully operational, reproducible Docker Compose environment. It eliminates the "it works on my machine" struggle by automating starter templates, database wiring, environment contracts, and connection URL generation.
+
+**Stop debugging ports, volumes, and health checks. Start building.**
+
+```text
+krickstart.yaml  ➔  krickstart up  ➔  🚀 Ready-to-code Stack (App + Database + URLs)
+```
+
+---
+
+## 🏛️ Architecture Overview
+
+`krickstart`  sits as a declarative translation layer between your team's configuration contract and Docker Compose
+
+```mermaid
+flowchart TD
+    subgraph User Workspace
+        YAML["krickstart.yaml\n(Team Contract)"]
+        CLI["krickstart CLI\n(create / doctor / up / down)"]
+    end
+
+    subgraph Core Engine
+        REG["Plugin Registry\n(Built-in + Entry Points)"]
+        VAL["Schema & Port Validator\n(Conflict Detection)"]
+        GEN["Compose Generator\n(Atomic Writes & Locks)"]
+    end
+
+    subgraph Generated Outputs
+        DC["docker-compose.krickstart.yml\n(Services, Volumes, Healthchecks)"]
+        ENV[".env.krickstart\n(DATABASE_URL, REDIS_URL)"]
+        EX[".env.example\n(Masked Team Template)"]
+    end
+
+    subgraph Runtime
+        DOCKER["Docker Engine / Compose v2\n(127.0.0.1 Isolated Containers)"]
+    end
+
+    YAML --> CLI
+    CLI --> VAL
+    CLI --> REG
+    REG --> GEN
+    VAL --> GEN
+    GEN --> DC
+    GEN --> ENV
+    GEN --> EX
+    DC --> DOCKER
+```
+
+---
+
+## 📊 Krickstart vs. Alternatives
+
+| Capability | ⚡ Krickstart | Docker Compose | VS Code Dev Containers | Tilt | Nix / devenv |
+| :--- | :---: | :---: | :---: | :---: | :---: |
+| **Instant Starters** | ✅ Built-in Stacks | ❌ Manual Setup | ⚠️ Template repos | ❌ Manual Tiltfile | ⚠️ Custom flake |
+| **Configuration Complexity** | 🟢 Low (~15 lines YAML) | 🔴 High (verbose Compose) | 🟡 Medium (`devcontainer.json`) | 🔴 High (Starlark/Tiltfile) | 🔴 High (Nix language) |
+| **Auto-Wiring (`.env` / URLs)** | ✅ Automated | ❌ Manual `.env` | ⚠️ Partial | ❌ Manual | ⚠️ Environment vars only |
+| **Editor Agnostic** | ✅ Any editor/IDE | ✅ Any editor/IDE | ❌ Optimized for VS Code | ✅ Any editor/IDE | ✅ Any editor/IDE |
+| **Learning Curve** | 🚀 2 minutes | ⏳ Days | ⏳ Hours | ⏳ Days (K8s required) | ⏳ Weeks (Nix syntax) |
+| **Host Port Conflict Checks** | ✅ `doctor` pre-flight | ❌ Fails on startup | ❌ Manual | ⚠️ Port-forwarding | ❌ Fails on startup |
+| **Localhost Isolation (127.0.0.1)** | ✅ Default | ❌ Defaults to `0.0.0.0` | ⚠️ Container internal | ⚠️ Varies | N/A (Host processes) |
+
+---
+
+## 🚀 Quick Start
+
+### Prerequisites
+- **Python 3.10+**
+- **Docker Desktop** or Docker Engine with Docker Compose v2
+
+### Installation
+
+Install via your preferred Python tool manager:
+
+```bash
+# Recommended (isolated CLI application)
+pipx install krickstart
+# or with uv:
+uv tool install krickstart
+
+# Or with standard pip
+pip install krickstart
+```
+
+### 30-Second Setup
+
+```bash
+# 1. Interactively choose a stack (e.g. FastAPI + PostgreSQL)
+krickstart create
+
+# 2. Check local environment and port availability
+krickstart doctor
+
+# 3. Launch isolated environment
+krickstart up
+```
+
+### Scripted / CI Workflow
+
+```bash
+krickstart init fastapi-postgres --name billing-api
+krickstart doctor
+krickstart up
+```
+
+---
+
+## 📦 Maintained Stacks
+
+All maintained stacks feature health checks, volume persistence, and loopback security (`127.0.0.1` binding):
+
+| Stack | Description | Included Services |
+| :--- | :--- | :--- |
+| `fastapi-postgres` | Python FastAPI REST API | FastAPI (Python 3.12), PostgreSQL 16 |
+| `django-postgres` | Django Web Framework | Django (Python 3.12), PostgreSQL 16 |
+| `flask-postgres` | Flask Microframework | Flask, PostgreSQL 16 |
+| `node-postgres-redis` | Node.js Express API | Express (Node 22), PostgreSQL 16, Redis 7 |
+| `nextjs-postgres` | Next.js App Router | Next.js, PostgreSQL 16 |
+| `go-gin-postgres` | Go Gin REST API | Go Gin, PostgreSQL 16 |
+| `spring-boot-postgres` | Java Spring Boot | Spring Boot (JDK 21), PostgreSQL 16 |
+
+---
+
+## 🛠️ CLI Command Reference
+
+| Command | Description |
+| :--- | :--- |
+| `krickstart list` | Show all available stack templates and descriptions |
+| `krickstart init <stack>` | Generate `krickstart.yaml` and starter files for a chosen stack |
+| `krickstart create` | Interactive terminal wizard to pick and initialize a stack |
+| `krickstart validate` | Validate schema and ensure stack plugin can render without errors |
+| `krickstart doctor` | Health-check Docker, Compose v2, YAML syntax, and detect port conflicts |
+| `krickstart doctor --fix` | Automatically repair missing safe assets (e.g., regenerate `.env.example`) |
+| `krickstart up` | Render Compose files and start containers in detached mode |
+| `krickstart up --dry-run` | Preview generated YAML and `.env` files without writing or starting Docker |
+| `krickstart down` | Gracefully stop containers (preserves database volumes) |
+| `krickstart status` | Display container runtime health and port mappings (`docker compose ps`) |
+| `krickstart logs [service]` | View or follow service logs (`--follow` supported) |
+| `krickstart export` | Export standalone `docker-compose.yml` and `.env` for production or CI |
+| `krickstart cleanup` | Stop containers, remove named volumes, and clean up generated files |
+
+---
+
+## 🔒 Security Best Practices
+
+1. **Loopback Isolation (`127.0.0.1`)**: `krickstart` binds container ports to `127.0.0.1` by default rather than `0.0.0.0`, protecting databases and internal APIs from exposure on public Wi-Fi or local networks.
+2. **Masked Examples**: Generated `.env.example` templates automatically redact credentials so teammates can safely commit environment templates to git without leaking passwords.
+3. **Never Commit Generated Files**:
+   Add to your `.gitignore`:
+   ```gitignore
+   docker-compose.krickstart.yml
+   .env.krickstart
+   .env
+   ```
+
+---
+
+## 🔌 Plugin System & Extensibility
+
+`krickstart` provides an open plugin interface using Python entry points. Organizations can package internal corporate stacks and publish them as private or public packages.
+
+Third-party packages expose plugins via the `krickstart.stacks` entry point group in `pyproject.toml`:
+
+```toml
+[project.entry-points."krickstart.stacks"]
+company-microservice = "my_company_stacks.microservice:MicroservicePlugin"
+```
+
+Plugins implement the `StackPlugin` interface (`name`, `description`, `default_config`, `compose_yaml`, `env_file`, `post_up_hints`). See [docs/plugin-authoring.md](docs/plugin-authoring.md) for complete details.
+
+---
+
+## 🤝 Contributing
+
+We love contributions! Whether it's a new stack template, a bug fix, or documentation improvement, please check out our [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
+
+**Ways to help:**
+- 🌟 **Star the repo** to show your support.
+- 🐛 **Report bugs** or request features in the Issues tab.
+- 🛠️ **Build a plugin** and share your custom stack with the community.
+- 📝 **Improve docs** to help other developers get started faster.
+
+## 📖 Guides
+For detailed instructions, explore our documentation:
+- [🚀 Getting Started](./docs/getting-started.md) - From installation to your first stack.
+- [🛠️ Custom Stacks](./docs/custom-stacks.md) - How to extend devspeed with your own templates.
+- [🔍 Troubleshooting](./docs/troubleshooting.md) - Solving common Docker and config issues.
+
+
+```bash
+# Run local test suite and quality gates:
+python scripts/dev.py check
+```
+
+## 📄 License
+
+This project is licensed under the [MIT License](LICENSE).

krickstart-1.2.0/devspeed/__init__.py

@@ -0,0 +1,15 @@
+"""Legacy compatibility package alias for Slipway."""
+
+from __future__ import annotations
+
+import warnings
+
+from slipway import PLUGIN_API_VERSION, StackPlugin, __version__
+
+warnings.warn(
+    "'devspeed' has been renamed to 'slipway'. Please update imports to 'slipway'.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+__all__ = ["PLUGIN_API_VERSION", "StackPlugin", "__version__"]

krickstart-1.2.0/devspeed/cli.py

@@ -0,0 +1,21 @@
+"""Backward-compatibility aliases for devspeed.cli."""
+
+from __future__ import annotations
+
+from slipway.cli import (
+    GENERATED_COMPOSE,
+    GENERATED_ENV,
+    GENERATED_ENV_EXAMPLE,
+    build_parser,
+    deprecated_alias_main,
+)
+from slipway.cli import deprecated_alias_main as main
+
+__all__ = [
+    "GENERATED_COMPOSE",
+    "GENERATED_ENV",
+    "GENERATED_ENV_EXAMPLE",
+    "build_parser",
+    "deprecated_alias_main",
+    "main",
+]

krickstart-1.2.0/devspeed/config.py

@@ -0,0 +1,29 @@
+"""Backward-compatibility aliases for devspeed.config."""
+
+from __future__ import annotations
+
+from slipway.config import (
+    CONFIG_FILENAME,
+    LEGACY_CONFIG_FILENAME,
+    DevspeedConfig,
+    LifecycleConfig,
+    ServiceConfig,
+    SlipwayConfig,
+    config_path,
+    load_config,
+    save_config,
+    validate_config,
+)
+
+__all__ = [
+    "CONFIG_FILENAME",
+    "LEGACY_CONFIG_FILENAME",
+    "DevspeedConfig",
+    "LifecycleConfig",
+    "ServiceConfig",
+    "SlipwayConfig",
+    "config_path",
+    "load_config",
+    "save_config",
+    "validate_config",
+]

krickstart-1.2.0/devspeed/core/__init__.py

@@ -0,0 +1,29 @@
+"""Core generation services for DevSpeed (legacy alias)."""
+
+from slipway.core.compose_generator import (
+    DEFAULT_COMPOSE_FILENAME,
+    DEFAULT_ENV_FILENAME,
+    ComposeGenerationError,
+    ComposeGenerator,
+    ConfigValidationError,
+    GeneratedArtifacts,
+    GeneratorSettings,
+    OutputFileExistsError,
+    PluginResolutionError,
+    PortConflictError,
+    WriteResult,
+)
+
+__all__ = [
+    "DEFAULT_COMPOSE_FILENAME",
+    "DEFAULT_ENV_FILENAME",
+    "ComposeGenerationError",
+    "ComposeGenerator",
+    "ConfigValidationError",
+    "GeneratedArtifacts",
+    "GeneratorSettings",
+    "OutputFileExistsError",
+    "PluginResolutionError",
+    "PortConflictError",
+    "WriteResult",
+]

krickstart-1.2.0/devspeed/core/compose_generator.py

@@ -0,0 +1,3 @@
+"""Backward-compatibility aliases for devspeed.core.compose_generator."""
+
+from slipway.core.compose_generator import *  # noqa: F403

krickstart-1.2.0/devspeed/errors.py

@@ -0,0 +1,29 @@
+"""Backward-compatibility aliases for devspeed.errors."""
+
+from __future__ import annotations
+
+from slipway.errors import (
+    CommandFailedError,
+    ComposeNotFoundError,
+    ConfigNotFoundError,
+    ConfigValidationError,
+    DevspeedError,
+    DockerNotFoundError,
+    DockerNotRunningError,
+    PortConflictError,
+    SlipwayError,
+    UnknownStackError,
+)
+
+__all__ = [
+    "CommandFailedError",
+    "ComposeNotFoundError",
+    "ConfigNotFoundError",
+    "ConfigValidationError",
+    "DevspeedError",
+    "DockerNotFoundError",
+    "DockerNotRunningError",
+    "PortConflictError",
+    "SlipwayError",
+    "UnknownStackError",
+]

krickstart-1.2.0/devspeed/plugin.py

@@ -0,0 +1,25 @@
+"""Backward-compatibility aliases for devspeed.plugin."""
+
+from __future__ import annotations
+
+from slipway.plugin import (
+    ENTRY_POINT_GROUP,
+    PLUGIN_API_VERSION,
+    PluginError,
+    PluginRegistry,
+    StackPlugin,
+    builtin_registry,
+    discover_pypi_stack_packages,
+    pypi_package_metadata,
+)
+
+__all__ = [
+    "ENTRY_POINT_GROUP",
+    "PLUGIN_API_VERSION",
+    "PluginError",
+    "PluginRegistry",
+    "StackPlugin",
+    "builtin_registry",
+    "discover_pypi_stack_packages",
+    "pypi_package_metadata",
+]

krickstart-1.2.0/devspeed/plugins/__init__.py

@@ -0,0 +1,21 @@
+"""Public plugin API for DevSpeed."""
+
+from devspeed.plugins.base import PLUGIN_API_VERSION, PluginError, StackPlugin
+from devspeed.plugins.registry import (
+    ENTRY_POINT_GROUP,
+    PluginRegistry,
+    builtin_registry,
+    discover_pypi_stack_packages,
+    pypi_package_metadata,
+)
+
+__all__ = [
+    "ENTRY_POINT_GROUP",
+    "PLUGIN_API_VERSION",
+    "PluginError",
+    "PluginRegistry",
+    "StackPlugin",
+    "builtin_registry",
+    "discover_pypi_stack_packages",
+    "pypi_package_metadata",
+]

krickstart-1.2.0/devspeed/plugins/base.py

@@ -0,0 +1,7 @@
+"""Backward-compatibility aliases for devspeed.plugins.base."""
+
+from __future__ import annotations
+
+from slipway.plugins.base import PLUGIN_API_VERSION, PluginError, StackPlugin
+
+__all__ = ["PLUGIN_API_VERSION", "PluginError", "StackPlugin"]