FastAPI-fastkit 1.1.5__tar.gz → 1.2.1__tar.gz

{fastapi_fastkit-1.1.5 → fastapi_fastkit-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: FastAPI-fastkit
-Version: 1.1.5
+Version: 1.2.1
 Summary: Fast, easy-to-use starter kit for new users of Python and FastAPI
 Author-Email: bnbong <bbbong9@gmail.com>
 License: MIT
@@ -12,12 +12,13 @@ Requires-Python: >=3.12
 Requires-Dist: click>=8.1.7
 Requires-Dist: rich>=13.9.2
 Provides-Extra: dev
-Requires-Dist: pytest>=8.3.3; extra == "dev"
+Requires-Dist: pytest>=9.0.3; extra == "dev"
 Requires-Dist: pytest-cov>=6.2.1; extra == "dev"
-Requires-Dist: black>=24.10.0; extra == "dev"
+Requires-Dist: black>=26.3.1; extra == "dev"
 Requires-Dist: pre-commit>=4.0.1; extra == "dev"
 Requires-Dist: mypy>=1.12.0; extra == "dev"
 Requires-Dist: isort>=5.13.2; extra == "dev"
+Requires-Dist: pygments>=2.20.0; extra == "dev"
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -33,26 +34,33 @@ Description-Content-Type: text/markdown
 <a href="https://github.com/bnbong/FastAPI-fastkit/releases" target="_blank">
     <img src="https://img.shields.io/github/v/release/bnbong/FastAPI-fastkit" alt="GitHub Release">
 </a>
+<a href="https://codecov.io/gh/bnbong/FastAPI-fastkit" >
+    <img src="https://codecov.io/gh/bnbong/FastAPI-fastkit/graph/badge.svg?token=WS0B6WWD8K"/>
+</a>
+<a href="https://pepy.tech/project/fastapi-fastkit">
+    <img src="https://static.pepy.tech/personalized-badge/fastapi-fastkit?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads" alt="PyPI Downloads">
+</a>
 </p>
 
 ---
 
 This project was created to speed up the configuration of the development environment needed to develop Python-based web apps for new users of Python and [FastAPI](https://github.com/fastapi/fastapi).
 
-This project was inspired by the `SpringBoot initializer` & Python Django's `django-admin` cli operation.
+This project was inspired by the `SpringBoot initializer` & Python Django's `django-admin` CLI operation.
 
 ## Key Features
 
 - **⚡ Immediate FastAPI project creation** : Super-fast FastAPI workspace & project creation via CLI, inspired by `django-admin` feature of [Python Django](https://github.com/django/django)
-- **🎨 Prettier CLI outputs** : Beautiful CLI experience powered by [rich library](https://github.com/Textualize/rich)
-- **📋 Standards-based FastAPI project templates** : All FastAPI-fastkit templates are based on Python standards and FastAPI's common use patterns
+- **✨ Interactive project builder**: Guided step-by-step feature selection for databases, authentication, caching, monitoring, and more with auto-generated code
+- **🎨 Prettier CLI output** : Beautiful CLI experience powered by [rich library](https://github.com/Textualize/rich)
+- **📋 Standards-based FastAPI project templates** : Templates follow Python standards and common FastAPI patterns.
 - **🔍 Automated template quality assurance** : Weekly automated testing ensures all templates remain functional and up-to-date
 - **🚀 Multiple project templates** : Choose from various pre-configured templates for different use cases (async CRUD, Docker, PostgreSQL, etc.)
 - **📦 Multiple package manager support** : Choose your preferred Python package manager (pip, uv, pdm, poetry) for dependency management
 
 ## Installation
 
-Install `FastAPI-fastkit` at your Python environment.
+Install `FastAPI-fastkit` in your Python environment.
 
 ```console
 $ pip install FastAPI-fastkit
@@ -76,6 +84,28 @@ fastkit init [OPTIONS]
   - `--package-manager` [pip|uv|pdm|poetry]
   - Stack selection: `minimal` | `standard` | `full` (interactive)
 
+### Create a project with interactive mode
+```console
+fastkit init --interactive
+```
+- What it does: Guided step-by-step project setup with intelligent feature selection
+- Features:
+  - **Database selection**: PostgreSQL, MySQL, MongoDB, Redis, SQLite
+  - **Authentication**: JWT, OAuth2, FastAPI-Users, Session-based
+  - **Background tasks**: Celery, Dramatiq
+  - **Caching**: Redis, fastapi-cache2
+  - **Monitoring**: Loguru, OpenTelemetry, Prometheus
+  - **Testing**: Basic (pytest), Coverage, Advanced (with faker, factory-boy)
+  - **Utilities**: CORS, Rate-Limiting, Pagination, WebSocket
+  - **Deployment**: Docker, docker-compose with auto-generated configs
+  - **Package manager**: pip, uv, pdm, poetry
+  - **Custom packages**: Add your own dependencies
+- Auto-generates:
+  - `main.py` with selected features integrated
+  - Database and authentication configuration files
+  - Docker deployment files (Dockerfile, docker-compose.yml)
+  - Test configuration (pytest with coverage)
+
 ### Create a project from a template
 ```console
 fastkit startdemo [TEMPLATE] [OPTIONS]
@@ -166,7 +196,7 @@ For detailed contribution guidelines, development setup, and project standards,
 
 FastAPI-fastkit aims to provide a fast and easy-to-use starter kit for new users of Python and FastAPI.
 
-This idea was initiated with the aim of helping FastAPI newcomers learn from the beginning, which aligns with the production significance of the FastAPI-cli package added with the [FastAPI 0.111.0 version update](https://github.com/fastapi/fastapi/releases/tag/0.111.0).
+This idea was initiated with the aim of helping FastAPI newcomers learn from the beginning, which aligns with the production significance of the FastAPI CLI package added with the [FastAPI 0.111.0 version update](https://github.com/fastapi/fastapi/releases/tag/0.111.0).
 
 As someone who has been using and loving FastAPI for a long time, I wanted to develop a project that could help fulfill [the wonderful motivation](https://github.com/fastapi/fastapi/pull/11522#issuecomment-2264639417) that FastAPI developer [tiangolo](https://github.com/tiangolo) has expressed.
 

{fastapi_fastkit-1.1.5 → fastapi_fastkit-1.2.1}/README.md

@@ -11,26 +11,33 @@
 <a href="https://github.com/bnbong/FastAPI-fastkit/releases" target="_blank">
     <img src="https://img.shields.io/github/v/release/bnbong/FastAPI-fastkit" alt="GitHub Release">
 </a>
+<a href="https://codecov.io/gh/bnbong/FastAPI-fastkit" >
+    <img src="https://codecov.io/gh/bnbong/FastAPI-fastkit/graph/badge.svg?token=WS0B6WWD8K"/>
+</a>
+<a href="https://pepy.tech/project/fastapi-fastkit">
+    <img src="https://static.pepy.tech/personalized-badge/fastapi-fastkit?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads" alt="PyPI Downloads">
+</a>
 </p>
 
 ---
 
 This project was created to speed up the configuration of the development environment needed to develop Python-based web apps for new users of Python and [FastAPI](https://github.com/fastapi/fastapi).
 
-This project was inspired by the `SpringBoot initializer` & Python Django's `django-admin` cli operation.
+This project was inspired by the `SpringBoot initializer` & Python Django's `django-admin` CLI operation.
 
 ## Key Features
 
 - **⚡ Immediate FastAPI project creation** : Super-fast FastAPI workspace & project creation via CLI, inspired by `django-admin` feature of [Python Django](https://github.com/django/django)
-- **🎨 Prettier CLI outputs** : Beautiful CLI experience powered by [rich library](https://github.com/Textualize/rich)
-- **📋 Standards-based FastAPI project templates** : All FastAPI-fastkit templates are based on Python standards and FastAPI's common use patterns
+- **✨ Interactive project builder**: Guided step-by-step feature selection for databases, authentication, caching, monitoring, and more with auto-generated code
+- **🎨 Prettier CLI output** : Beautiful CLI experience powered by [rich library](https://github.com/Textualize/rich)
+- **📋 Standards-based FastAPI project templates** : Templates follow Python standards and common FastAPI patterns.
 - **🔍 Automated template quality assurance** : Weekly automated testing ensures all templates remain functional and up-to-date
 - **🚀 Multiple project templates** : Choose from various pre-configured templates for different use cases (async CRUD, Docker, PostgreSQL, etc.)
 - **📦 Multiple package manager support** : Choose your preferred Python package manager (pip, uv, pdm, poetry) for dependency management
 
 ## Installation
 
-Install `FastAPI-fastkit` at your Python environment.
+Install `FastAPI-fastkit` in your Python environment.
 
 ```console
 $ pip install FastAPI-fastkit
@@ -54,6 +61,28 @@ fastkit init [OPTIONS]
   - `--package-manager` [pip|uv|pdm|poetry]
   - Stack selection: `minimal` | `standard` | `full` (interactive)
 
+### Create a project with interactive mode
+```console
+fastkit init --interactive
+```
+- What it does: Guided step-by-step project setup with intelligent feature selection
+- Features:
+  - **Database selection**: PostgreSQL, MySQL, MongoDB, Redis, SQLite
+  - **Authentication**: JWT, OAuth2, FastAPI-Users, Session-based
+  - **Background tasks**: Celery, Dramatiq
+  - **Caching**: Redis, fastapi-cache2
+  - **Monitoring**: Loguru, OpenTelemetry, Prometheus
+  - **Testing**: Basic (pytest), Coverage, Advanced (with faker, factory-boy)
+  - **Utilities**: CORS, Rate-Limiting, Pagination, WebSocket
+  - **Deployment**: Docker, docker-compose with auto-generated configs
+  - **Package manager**: pip, uv, pdm, poetry
+  - **Custom packages**: Add your own dependencies
+- Auto-generates:
+  - `main.py` with selected features integrated
+  - Database and authentication configuration files
+  - Docker deployment files (Dockerfile, docker-compose.yml)
+  - Test configuration (pytest with coverage)
+
 ### Create a project from a template
 ```console
 fastkit startdemo [TEMPLATE] [OPTIONS]
@@ -144,7 +173,7 @@ For detailed contribution guidelines, development setup, and project standards,
 
 FastAPI-fastkit aims to provide a fast and easy-to-use starter kit for new users of Python and FastAPI.
 
-This idea was initiated with the aim of helping FastAPI newcomers learn from the beginning, which aligns with the production significance of the FastAPI-cli package added with the [FastAPI 0.111.0 version update](https://github.com/fastapi/fastapi/releases/tag/0.111.0).
+This idea was initiated with the aim of helping FastAPI newcomers learn from the beginning, which aligns with the production significance of the FastAPI CLI package added with the [FastAPI 0.111.0 version update](https://github.com/fastapi/fastapi/releases/tag/0.111.0).
 
 As someone who has been using and loving FastAPI for a long time, I wanted to develop a project that could help fulfill [the wonderful motivation](https://github.com/fastapi/fastapi/pull/11522#issuecomment-2264639417) that FastAPI developer [tiangolo](https://github.com/tiangolo) has expressed.
 

{fastapi_fastkit-1.1.5 → fastapi_fastkit-1.2.1}/pyproject.toml

@@ -11,7 +11,7 @@ dependencies = [
 ]
 requires-python = ">=3.12"
 readme = "README.md"
-version = "1.1.5"
+version = "1.2.1"
 
 [project.license]
 text = "MIT"
@@ -24,12 +24,13 @@ Changelog = "https://bnbong.github.io/FastAPI-fastkit/changelog/"
 
 [project.optional-dependencies]
 dev = [
-    "pytest>=8.3.3",
+    "pytest>=9.0.3",
     "pytest-cov>=6.2.1",
-    "black>=24.10.0",
+    "black>=26.3.1",
     "pre-commit>=4.0.1",
     "mypy>=1.12.0",
     "isort>=5.13.2",
+    "pygments>=2.20.0",
 ]
 
 [project.scripts]
@@ -41,13 +42,6 @@ requires = [
 ]
 build-backend = "pdm.backend"
 
-[tool.pdm]
-distribution = true
-
-[tool.pdm.version]
-source = "file"
-path = "src/fastapi_fastkit/__init__.py"
-
 [tool.pytest.ini_options]
 testpaths = [
     "tests",
@@ -76,6 +70,13 @@ module = "fastapi_fastkit.core"
 ignore_missing_imports = true
 check_untyped_defs = false
 
+[tool.pdm]
+distribution = true
+
+[tool.pdm.version]
+source = "file"
+path = "src/fastapi_fastkit/__init__.py"
+
 [tool.coverage.run]
 source = [
     "src/fastapi_fastkit",
@@ -117,4 +118,14 @@ docs = [
     "mkdocs>=1.6.1",
     "mkdocs-material>=9.6.15",
     "mdx-include>=1.4.2",
+    "mkdocs-static-i18n>=1.3.0",
+    "pyyaml>=6.0.3",
+    "types-PyYAML>=6.0.12.20250915",
+    "pygments>=2.20.0",
+    "requests>=2.33.0",
+    "pymdown-extensions>=10.17.2",
+]
+translation = [
+    "openai>=2.8.1",
+    "anthropic>=0.74.0",
 ]

fastapi_fastkit-1.2.1/src/fastapi_fastkit/__init__.py

@@ -0,0 +1 @@
+__version__ = 'v1.2.1'

{fastapi_fastkit-1.1.5 → fastapi_fastkit-1.2.1}/src/fastapi_fastkit/backend/inspector.py

@@ -26,13 +26,12 @@ import sys
 from pathlib import Path
 from typing import Any, Callable, Dict, List, Optional, Tuple
 
-import yaml  # type: ignore
+import yaml
 
 from fastapi_fastkit.backend.main import (
     create_venv,
     find_template_core_modules,
     inject_project_metadata,
-    install_dependencies,
     install_dependencies_with_manager,
 )
 from fastapi_fastkit.backend.transducer import copy_and_convert_template
@@ -50,17 +49,38 @@ class TemplateInspector:
     Uses context manager protocol for proper resource cleanup.
     """
 
-    def __init__(self, template_path: str):
+    def __init__(self, template_path: str, temp_base_dir: Optional[str] = None):
         self.template_path = Path(template_path)
         self.errors: List[str] = []
         self.warnings: List[str] = []
-        self.temp_dir = os.path.join(os.path.dirname(__file__), "temp")
+        template_name = Path(template_path).name
+
+        # use temp_base_dir or fall back to backend directory (temp)
+        if temp_base_dir:
+            self.temp_dir = os.path.join(temp_base_dir, f"temp_{template_name}")
+        else:
+            self.temp_dir = os.path.join(
+                os.path.dirname(__file__), f"temp_{template_name}"
+            )
+
         self._cleanup_needed = False
         self.template_config: Optional[Dict[str, Any]] = None
 
     def __enter__(self) -> "TemplateInspector":
         """Enter context manager - create temp directory and copy template."""
         try:
+            # Clean up any existing temp directory for this template
+            if os.path.exists(self.temp_dir):
+                debug_log(
+                    f"Cleaning up existing temp directory: {self.temp_dir}", "info"
+                )
+                try:
+                    shutil.rmtree(self.temp_dir)
+                except OSError as e:
+                    debug_log(
+                        f"Failed to cleanup existing temp directory: {e}", "warning"
+                    )
+
             os.makedirs(self.temp_dir, exist_ok=True)
             copy_and_convert_template(str(self.template_path), self.temp_dir)
 
@@ -81,18 +101,142 @@ class TemplateInspector:
         self._cleanup()
 
     def _cleanup(self) -> None:
-        """Cleanup temp directory if it exists and cleanup is needed."""
+        """Cleanup temp directory."""
         if self._cleanup_needed and os.path.exists(self.temp_dir):
+            temp_dir_path = self.temp_dir
             try:
-                shutil.rmtree(self.temp_dir)
-                debug_log(f"Cleaned up temp directory {self.temp_dir}", "debug")
-            except OSError as e:
+                self._cleanup_docker_services()
+
+                import time
+
+                time.sleep(3)
+
+                self._force_cleanup_directory(temp_dir_path)
+
+            except Exception as e:
                 debug_log(
-                    f"Failed to cleanup temp directory {self.temp_dir}: {e}", "warning"
+                    f"Warning: Unexpected error during cleanup of {temp_dir_path}: {e}",
+                    "warning",
                 )
+                try:
+                    self._force_cleanup_directory(temp_dir_path)
+                except Exception:
+                    pass
             finally:
                 self._cleanup_needed = False
 
+    def _force_cleanup_directory(self, directory_path: str) -> None:
+        """Force cleanup of directory with multiple strategies."""
+        import stat
+        import time
+
+        max_retries = 5
+        for attempt in range(max_retries):
+            try:
+                shutil.rmtree(directory_path)
+                debug_log(
+                    f"Successfully cleaned up temp directory: {directory_path}", "info"
+                )
+                return
+            except (OSError, PermissionError) as e:
+                if attempt < max_retries - 1:
+                    debug_log(
+                        f"Attempt {attempt + 1} failed to cleanup {directory_path}: {e}",
+                        "warning",
+                    )
+
+                    try:
+                        self._fix_directory_permissions(directory_path)
+                        shutil.rmtree(directory_path)
+                        debug_log(
+                            f"Successfully cleaned up temp directory after permission fix: {directory_path}",
+                            "info",
+                        )
+                        return
+                    except Exception:
+                        pass
+
+                    try:
+                        self._remove_directory_contents(directory_path)
+                        os.rmdir(directory_path)
+                        debug_log(
+                            f"Successfully cleaned up temp directory by removing contents: {directory_path}",
+                            "info",
+                        )
+                        return
+                    except Exception:
+                        pass
+
+                    time.sleep(2)
+                else:
+                    debug_log(
+                        f"Failed to cleanup temp directory after {max_retries} attempts: {directory_path}",
+                        "warning",
+                    )
+                    try:
+                        import subprocess
+
+                        if os.name == "nt":  # Windows
+                            subprocess.run(
+                                ["rmdir", "/s", "/q", directory_path],
+                                check=False,
+                                shell=True,
+                            )
+                        else:  # Unix-like
+                            subprocess.run(["rm", "-rf", directory_path], check=False)
+                        debug_log(
+                            f"Force cleanup completed for: {directory_path}", "info"
+                        )
+                    except Exception:
+                        debug_log(
+                            f"All cleanup attempts failed for: {directory_path}",
+                            "warning",
+                        )
+
+    def _fix_directory_permissions(self, directory_path: str) -> None:
+        """Fix directory permissions to allow removal."""
+        import os
+        import stat
+
+        def fix_permissions(path: str) -> None:
+            try:
+                os.chmod(path, stat.S_IRWXU | stat.S_IRWXG | stat.S_IRWXO)
+            except Exception:
+                pass
+
+        # Fix permissions for directory and all contents
+        fix_permissions(directory_path)
+        for root, dirs, files in os.walk(directory_path):
+            fix_permissions(root)
+            for d in dirs:
+                fix_permissions(os.path.join(root, d))
+            for f in files:
+                fix_permissions(os.path.join(root, f))
+
+    def _remove_directory_contents(self, directory_path: str) -> None:
+        """Remove directory contents file by file."""
+        import os
+        import stat
+
+        for root, dirs, files in os.walk(directory_path, topdown=False):
+            # Remove files first
+            for file in files:
+                file_path = os.path.join(root, file)
+                try:
+                    os.chmod(file_path, stat.S_IRWXU | stat.S_IRWXG | stat.S_IRWXO)
+                    os.remove(file_path)
+                except Exception:
+                    pass
+
+            # Remove directories
+            for dir_name in dirs:
+                dir_path = os.path.join(root, dir_name)
+                try:
+                    os.chmod(dir_path, stat.S_IRWXU | stat.S_IRWXG | stat.S_IRWXO)
+                    os.rmdir(dir_path)
+                except Exception:
+                    pass
+
     def _load_template_config(self) -> Optional[Dict[str, Any]]:
         """Load template configuration from template-config.yml if available."""
         config_file = os.path.join(self.temp_dir, "template-config.yml")
@@ -1036,12 +1180,23 @@ class TemplateInspector:
         try:
             debug_log("Cleaning up Docker services", "info")
             subprocess.run(
-                ["docker-compose", "down", "-v"],
+                ["docker-compose", "down", "-v", "--remove-orphans"],
                 cwd=self.temp_dir,
                 capture_output=True,
                 text=True,
                 timeout=60,
             )
+
+            try:
+                subprocess.run(
+                    ["docker", "system", "prune", "-f"],
+                    capture_output=True,
+                    text=True,
+                    timeout=30,
+                )
+            except Exception:
+                pass
+
         except Exception as e:
             debug_log(f"Failed to cleanup Docker services: {e}", "warning")
 
@@ -1086,11 +1241,14 @@ class TemplateInspector:
         }
 
 
-def inspect_fastapi_template(template_path: str) -> Dict[str, Any]:
+def inspect_fastapi_template(
+    template_path: str, temp_base_dir: Optional[str] = None
+) -> Dict[str, Any]:
     """
     Convenience function to inspect a FastAPI template.
 
     :param template_path: Path to the template to inspect
+    :param temp_base_dir: Base directory for temporary files (defaults to backend directory)
     :return: Inspection report dictionary
     """
     template_name = Path(template_path).name
@@ -1098,7 +1256,7 @@ def inspect_fastapi_template(template_path: str) -> Dict[str, Any]:
         f"Starting template inspection for {template_name} at {template_path}", "info"
     )
 
-    with TemplateInspector(template_path) as inspector:
+    with TemplateInspector(template_path, temp_base_dir) as inspector:
         is_valid = inspector.inspect_template()
         report = inspector.get_report()
 

fastapi_fastkit-1.2.1/src/fastapi_fastkit/backend/interactive/__init__.py

@@ -0,0 +1,51 @@
+# --------------------------------------------------------------------------
+# Interactive module for FastAPI-fastkit
+#
+# Provides interactive prompts and configuration building for dynamic
+# project creation.
+#
+# @author bnbong bbbong9@gmail.com
+# --------------------------------------------------------------------------
+from .config_builder import InteractiveConfigBuilder
+from .prompts import (
+    prompt_additional_features,
+    prompt_authentication_selection,
+    prompt_basic_info,
+    prompt_caching_selection,
+    prompt_custom_packages,
+    prompt_database_selection,
+    prompt_deployment_options,
+    prompt_monitoring_selection,
+    prompt_package_manager_selection,
+    prompt_template_selection,
+    prompt_testing_selection,
+    prompt_utilities_selection,
+)
+from .selectors import confirm_selections, multi_select_prompt, render_selection_table
+from .validators import (
+    sanitize_custom_packages,
+    validate_feature_compatibility,
+    validate_package_name,
+)
+
+__all__ = [
+    "InteractiveConfigBuilder",
+    "prompt_basic_info",
+    "prompt_template_selection",
+    "prompt_database_selection",
+    "prompt_authentication_selection",
+    "prompt_additional_features",
+    "prompt_testing_selection",
+    "prompt_deployment_options",
+    "prompt_custom_packages",
+    "prompt_caching_selection",
+    "prompt_monitoring_selection",
+    "prompt_utilities_selection",
+    "prompt_package_manager_selection",
+    "render_selection_table",
+    "multi_select_prompt",
+    "confirm_selections",
+    "validate_package_name",
+    "validate_feature_compatibility",
+    "sanitize_custom_packages",
+]