[FIX] update package selection feature, enhance template testcases

Author: bnbong

CHANGELOG.md

@@ -1,5 +1,52 @@
 # Changelog
 
+## v1.1.0 (2025-01-15)
+
+### Features
+
+- **Package Manager Support**: Add comprehensive support for multiple Python package managers
+  - Support for UV (default), PDM, Poetry, and PIP package managers
+  - Interactive package manager selection in `fastkit init` and `fastkit startdemo` commands
+  - `--package-manager` CLI option for non-interactive usage
+  - Automatic generation of appropriate dependency files (`pyproject.toml` for UV/PDM/Poetry, `requirements.txt` for PIP)
+  - PEP 621 compliant project metadata for modern package managers
+
+- **Automated Template Testing System**: Revolutionary zero-configuration template testing
+  - Dynamic template discovery - new templates are automatically tested
+  - Comprehensive end-to-end testing with actual project creation
+  - Multi-package manager compatibility testing
+  - Virtual environment creation and dependency installation validation
+  - Project structure and FastAPI integration verification
+  - Parameterized testing with pytest for scalable test execution
+
+### Improvements
+
+- **Enhanced CLI Experience**: Package manager selection with interactive prompts and helpful descriptions
+- **Better Template Quality Assurance**: Multi-layer quality assurance with static inspection and dynamic testing
+- **Improved Developer Experience**: Zero boilerplate test configuration for template contributors
+- **Cross-Platform Compatibility**: Enhanced support for different package manager workflows
+
+### Documentation
+
+- Updated all user guides with package manager selection examples
+- Enhanced CLI reference with comprehensive package manager documentation
+- Updated contributing guidelines with new automated testing system
+- Improved template creation guide with zero-configuration testing instructions
+- Enhanced template quality assurance documentation
+
+### Technical
+
+- Implemented BasePackageManager abstract class with concrete implementations
+- Added PackageManagerFactory for dynamic package manager instantiation
+- Enhanced project metadata injection for all package managers
+- Improved test infrastructure with dynamic template discovery
+- Updated CI/CD pipelines for multi-package manager testing
+
+### Breaking Changes
+
+- **Default Package Manager**: Changed from PIP to UV for better performance
+- **CLI Prompts**: Added package manager selection step in interactive commands
+
 ## v1.0.2 (2025-07-02)
 
 ### Features

src/fastapi_fastkit/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "1.0.2"
+__version__ = "1.1.0"
 
 import os
 

src/fastapi_fastkit/backend/main.py

@@ -314,22 +314,34 @@ def install_dependencies(project_dir: str, venv_path: str) -> None:
 
 
 def generate_dependency_file_with_manager(
-    project_dir: str, dependencies: List[str], manager_type: str = "pip"
+    project_dir: str,
+    dependencies: List[str],
+    manager_type: str = "pip",
+    project_name: str = "",
+    author: str = "",
+    author_email: str = "",
+    description: str = "",
 ) -> None:
     """
     Generate a dependency file using the specified package manager.
 
     :param project_dir: Path to the project directory
     :param dependencies: List of dependency specifications
     :param manager_type: Type of package manager to use
+    :param project_name: Name of the project
+    :param author: Author name
+    :param author_email: Author email
+    :param description: Project description
     :return: None
     :raises: BackendExceptions if dependency file generation fails
     """
     try:
         package_manager = PackageManagerFactory.create_manager(
             manager_type, project_dir, auto_detect=True
         )
-        package_manager.generate_dependency_file(dependencies)
+        package_manager.generate_dependency_file(
+            dependencies, project_name, author, author_email, description
+        )
     except Exception as e:
         debug_log(f"Error generating dependency file with {manager_type}: {e}", "error")
         raise BackendExceptions(f"Failed to generate dependency file: {str(e)}")

src/fastapi_fastkit/backend/package_managers/base.py

@@ -65,11 +65,22 @@ def install_dependencies(self, venv_path: str) -> None:
         pass
 
     @abstractmethod
-    def generate_dependency_file(self, dependencies: List[str]) -> None:
+    def generate_dependency_file(
+        self,
+        dependencies: List[str],
+        project_name: str = "",
+        author: str = "",
+        author_email: str = "",
+        description: str = "",
+    ) -> None:
         """
-        Generate a dependency file with the given dependencies.
+        Generate a dependency file with the given dependencies and metadata.
 
         :param dependencies: List of dependency specifications
+        :param project_name: Name of the project
+        :param author: Author name
+        :param author_email: Author email
+        :param description: Project description
         """
         pass
 

src/fastapi_fastkit/backend/package_managers/pdm_manager.py

@@ -120,11 +120,22 @@ def install_dependencies(self, venv_path: str) -> None:
                 f"Failed to install dependencies with PDM: {str(e)}"
             )
 
-    def generate_dependency_file(self, dependencies: List[str]) -> None:
+    def generate_dependency_file(
+        self,
+        dependencies: List[str],
+        project_name: str = "",
+        author: str = "",
+        author_email: str = "",
+        description: str = "",
+    ) -> None:
         """
-        Generate a pyproject.toml file with the given dependencies.
+        Generate a pyproject.toml file with the given dependencies and metadata.
 
         :param dependencies: List of dependency specifications
+        :param project_name: Name of the project
+        :param author: Author name
+        :param author_email: Author email
+        :param description: Project description
         """
         pyproject_path = self.get_dependency_file_path()
 
@@ -137,11 +148,11 @@ def generate_dependency_file(self, dependencies: List[str]) -> None:
 
             # Create basic pyproject.toml content as string
             pyproject_content = f"""[project]
-name = ""
+name = "{project_name or 'fastapi-project'}"
 version = "0.1.0"
-description = ""
+description = "{description or 'A FastAPI project'}"
 authors = [
-    {{name = "", email = ""}},
+    {{name = "{author or 'Author'}", email = "{author_email or '[email protected]'}"}},
 ]
 dependencies = {deps_toml}
 requires-python = ">=3.8"
@@ -152,6 +163,9 @@ def generate_dependency_file(self, dependencies: List[str]) -> None:
 requires = ["pdm-backend"]
 build-backend = "pdm.backend"
 
+[tool.hatch.build.targets.wheel]
+packages = ["src"]
+
 [tool.pdm]
 """
 
@@ -242,6 +256,9 @@ def initialize_project(
 requires = ["pdm-backend"]
 build-backend = "pdm.backend"
 
+[tool.hatch.build.targets.wheel]
+packages = ["src"]
+
 [tool.pdm]
 """
 

src/fastapi_fastkit/backend/package_managers/pip_manager.py

@@ -129,11 +129,22 @@ def install_dependencies(self, venv_path: str) -> None:
             handle_exception(e, f"Error during dependency installation: {str(e)}")
             raise BackendExceptions(f"Failed to install dependencies: {str(e)}")
 
-    def generate_dependency_file(self, dependencies: List[str]) -> None:
+    def generate_dependency_file(
+        self,
+        dependencies: List[str],
+        project_name: str = "",
+        author: str = "",
+        author_email: str = "",
+        description: str = "",
+    ) -> None:
         """
         Generate a requirements.txt file with the given dependencies.
 
         :param dependencies: List of dependency specifications
+        :param project_name: Name of the project (not used for pip)
+        :param author: Author name (not used for pip)
+        :param author_email: Author email (not used for pip)
+        :param description: Project description (not used for pip)
         """
         requirements_path = self.get_dependency_file_path()
 

src/fastapi_fastkit/backend/package_managers/poetry_manager.py

@@ -158,11 +158,22 @@ def install_dependencies(self, venv_path: str) -> None:
                 f"Failed to install dependencies with Poetry: {str(e)}"
             )
 
-    def generate_dependency_file(self, dependencies: List[str]) -> None:
+    def generate_dependency_file(
+        self,
+        dependencies: List[str],
+        project_name: str = "",
+        author: str = "",
+        author_email: str = "",
+        description: str = "",
+    ) -> None:
         """
-        Generate a pyproject.toml file with the given dependencies.
+        Generate a pyproject.toml file with the given dependencies and metadata.
 
         :param dependencies: List of dependency specifications
+        :param project_name: Name of the project
+        :param author: Author name
+        :param author_email: Author email
+        :param description: Project description
         """
         pyproject_path = self.get_dependency_file_path()
 
@@ -179,12 +190,13 @@ def generate_dependency_file(self, dependencies: List[str]) -> None:
 
             # Create basic pyproject.toml content for Poetry
             pyproject_content = f"""[tool.poetry]
-name = ""
+name = "{project_name or 'fastapi-project'}"
 version = "0.1.0"
-description = ""
-authors = ["Author <[email protected]>"]
+description = "{description or 'A FastAPI project'}"
+authors = ["{author or 'Author'} <{author_email or '[email protected]'}>"]
 readme = "README.md"
 license = "MIT"
+packages = [{{include = "src"}}]
 
 [tool.poetry.dependencies]
 python = "^3.8"

src/fastapi_fastkit/backend/package_managers/uv_manager.py

@@ -117,11 +117,22 @@ def install_dependencies(self, venv_path: str) -> None:
             handle_exception(e, f"Error during dependency installation: {str(e)}")
             raise BackendExceptions(f"Failed to install dependencies with UV: {str(e)}")
 
-    def generate_dependency_file(self, dependencies: List[str]) -> None:
+    def generate_dependency_file(
+        self,
+        dependencies: List[str],
+        project_name: str = "",
+        author: str = "",
+        author_email: str = "",
+        description: str = "",
+    ) -> None:
         """
-        Generate a pyproject.toml file with the given dependencies.
+        Generate a pyproject.toml file with the given dependencies and metadata.
 
         :param dependencies: List of dependency specifications
+        :param project_name: Name of the project
+        :param author: Author name
+        :param author_email: Author email
+        :param description: Project description
         """
         pyproject_path = self.get_dependency_file_path()
 
@@ -134,11 +145,11 @@ def generate_dependency_file(self, dependencies: List[str]) -> None:
 
             # Create basic pyproject.toml content for UV
             pyproject_content = f"""[project]
-name = ""
+name = "{project_name or 'fastapi-project'}"
 version = "0.1.0"
-description = ""
+description = "{description or 'A FastAPI project'}"
 authors = [
-    {{name = "", email = ""}},
+    {{name = "{author or 'Author'}", email = "{author_email or '[email protected]'}"}},
 ]
 dependencies = {deps_toml}
 requires-python = ">=3.8"
@@ -149,6 +160,9 @@ def generate_dependency_file(self, dependencies: List[str]) -> None:
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
+[tool.hatch.build.targets.wheel]
+packages = ["src"]
+
 [tool.uv]
 dev-dependencies = []
 """
@@ -240,6 +254,9 @@ def initialize_project(
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
+[tool.hatch.build.targets.wheel]
+packages = ["src"]
+
 [tool.uv]
 dev-dependencies = []
 """