thothctl 0.13.6__tar.gz → 0.14.2__tar.gz

{thothctl-0.13.6 → thothctl-0.14.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: thothctl
-Version: 0.13.6
+Version: 0.14.2
 Summary: A CLI for Developer Control Plane. Accelerate your cloud IaC deployments.
 Project-URL: Homepage, https://github.com/thothforge/thothctl
 Author-email: Alejandro Velez <velez94@pm.me>

thothctl-0.14.2/docs/template_engine/github_templates.md

@@ -0,0 +1,145 @@
+# GitHub Template Integration
+
+ThothCTL automatically loads project templates from GitHub public repositories based on the project type. This provides standardized, up-to-date project scaffolding for different infrastructure frameworks.
+
+## Default Behavior
+
+When you run `thothctl init project`, the system will:
+
+1. **Load from GitHub first**: Automatically clone the appropriate template repository based on project type
+2. **Fallback to local templates**: If GitHub loading fails, use local hardcoded templates
+3. **Apply template processing**: Replace placeholders and configure the project
+
+## Supported Project Types and Templates
+
+### Terraform / Terragrunt / OpenTofu
+
+| Project Type | Default Repository |
+|-------------|-------------------|
+| `terragrunt` | https://github.com/thothforge/terragrunt_project_scaffold.git |
+| `terraform` | https://github.com/thothforge/terraform_project_scaffold.git |
+| `terraform-terragrunt` | https://github.com/thothforge/terraform_terragrunt_scaffold_project.git |
+| `terraform_module` | https://github.com/thothforge/terraform_module_scaffold.git |
+| `tofu` | https://github.com/thothforge/tofu_project_scaffold.git |
+
+### AWS CDK v2
+
+CDK projects support language selection. When `--project-type cdkv2` is used, thothctl prompts for the programming language (or defaults to TypeScript in batch mode).
+
+| Project Type | Language | Default Repository |
+|-------------|----------|-------------------|
+| `cdkv2-typescript` | TypeScript | https://github.com/thothforge/cdkv2_typescript_scaffold.git |
+| `cdkv2-python` | Python | https://github.com/thothforge/cdkv2_python_scaffold.git |
+| `cdkv2-java` | Java | https://github.com/thothforge/cdkv2_java_scaffold.git |
+| `cdkv2-csharp` | C# | https://github.com/thothforge/cdkv2_csharp_scaffold.git |
+| `cdkv2-go` | Go | https://github.com/thothforge/cdkv2_go_scaffold.git |
+| `cdkv2` | Generic (defaults to TypeScript) | https://github.com/thothforge/cdkv2_typescript_scaffold.git |
+
+All CDK scaffolds include:
+
+- **cdk-nag** AwsSolutions pack enabled by default
+- Multi-environment support via YAML configuration
+- Layered stack architecture (foundation / platform / application)
+- `.kiro/` steering docs, skills, and agent configuration
+- Backstage catalog integration
+- `#{...}#` template placeholders for thothctl processing
+
+## Usage Examples
+
+### Terraform Projects
+```bash
+# Terraform + Terragrunt project
+thothctl init project --project-name my-infrastructure --project-type terraform-terragrunt
+
+# Terraform project
+thothctl init project --project-name my-terraform --project-type terraform
+```
+
+### CDK Projects
+```bash
+# Interactive — prompts for language selection
+thothctl init project --project-name my-app --project-type cdkv2
+
+# Explicit language
+thothctl init project --project-name my-app --project-type cdkv2 --language typescript
+thothctl init project --project-name my-api --project-type cdkv2 -l python
+
+# Batch mode — defaults to TypeScript
+thothctl init project --project-name my-app --project-type cdkv2 --batch
+```
+
+### Managing Template Configurations
+
+#### List Available Templates
+```bash
+# Show default GitHub templates
+thothctl list templates
+
+# Show templates from a specific space (VCS-based)
+thothctl list templates --space my-space
+```
+
+#### Set Custom Template Repository
+```bash
+# Override default template for any project type
+thothctl init template --project-type cdkv2-typescript --template-url https://github.com/myorg/custom-cdk-ts.git
+thothctl init template --project-type terragrunt --template-url https://github.com/myorg/custom-terragrunt.git
+```
+
+## Configuration
+
+Template URLs are stored in `~/.thothcf/.thothctl_templates.toml`:
+
+```toml
+[templates]
+terragrunt = "https://github.com/myorg/custom-terragrunt-template.git"
+cdkv2-typescript = "https://github.com/myorg/custom-cdk-ts-template.git"
+cdkv2-python = "https://github.com/myorg/custom-cdk-python-template.git"
+```
+
+## CDK Scaffold Structure
+
+Each CDK scaffold follows the ThothForge enterprise pattern:
+
+```
+project/
+├── bin/                        # CDK app entry point
+├── lib/
+│   ├── stacks/                 # Stack definitions by domain
+│   │   ├── foundation/         # VPC, IAM, S3
+│   │   ├── platform/           # EKS, RDS, ElastiCache
+│   │   └── application/        # Lambda, API Gateway
+│   └── constructs/             # Reusable constructs
+├── app/functions/              # Lambda source code
+├── project_configs/
+│   ├── environment_options.yaml  # Multi-env config (#{...}# placeholders)
+│   └── config-loader.*          # Config loader
+├── test/                       # Jest / pytest tests
+├── .thothcf.toml               # ThothForge template config
+├── .kiro/                      # Kiro steering, skills, agents, MCP settings
+├── .pre-commit-config.yaml
+└── docs/catalog/               # Backstage integration
+```
+
+## Benefits
+
+- **Always Up-to-Date**: Templates are fetched from the latest version in the repository
+- **Language-Aware**: CDK projects automatically select the right scaffold per language
+- **Standardized**: Consistent project structure across teams and organizations
+- **Customizable**: Organizations can override default templates with their own
+- **Fallback Safety**: Local templates ensure functionality even without internet access
+- **Zero Configuration**: Works out of the box with sensible defaults
+
+## Requirements
+
+- Internet access for GitHub template loading
+- Git installed on the system
+- GitPython dependency (automatically installed with thothctl)
+
+## Troubleshooting
+
+If template loading fails:
+1. Check internet connectivity
+2. Verify the repository URL is accessible
+3. The system will automatically fall back to local templates
+4. Check logs with `--debug` flag for detailed error information

{thothctl-0.13.6 → thothctl-0.14.2}/src/thothctl/commands/init/commands/project.py

@@ -88,12 +88,34 @@ class ProjectInitCommand(ClickCommand):
         space: Optional[str] = None,
         batch: bool = False,
         context: str = None,
+        language: str = None,
         **kwargs,
     ) -> None:
         """Execute project initialization"""
         project_name = project_name.strip()
         project_path = Path(f"./{project_name}")
 
+        # Handle CDK language selection
+        if project_type == "cdkv2":
+            if not language:
+                if batch:
+                    language = "typescript"
+                else:
+                    import inquirer
+                    from colorama import Fore
+                    questions = [
+                        inquirer.List(
+                            "language",
+                            message=f"{Fore.GREEN}Select CDK language",
+                            choices=["typescript", "python", "java", "csharp", "go"],
+                            default="typescript",
+                        ),
+                    ]
+                    answer = inquirer.prompt(questions)
+                    language = answer["language"] if answer else "typescript"
+            self.ui.print_info(f"🔤 CDK language: {language}")
+            project_type = f"cdkv2-{language}"
+
         self.ui.print_info(f"🚀 Initializing project: {project_name}")
         
         # If space is provided, show info and get VCS provider
@@ -595,4 +617,14 @@ cli = ProjectInitCommand.as_click_command(help="Initialize a new project")(
         type=click.Path(exists=True),
         default=None,
     ),
+    click.option(
+        "-l",
+        "--language",
+        default=None,
+        type=click.Choice(
+            ["typescript", "python", "java", "csharp", "go"],
+            case_sensitive=True,
+        ),
+        help="Programming language for CDK projects (only used with --project-type cdkv2)",
+    ),
 )

{thothctl-0.13.6 → thothctl-0.14.2}/src/thothctl/core/integrations/azure_devops/get_azure_devops.py

@@ -148,6 +148,7 @@ def clone_repo(
     repo_meta = {
         "repo_name": repository["Name"],
         "repo_url": repository["RemoteUrl"],
+        "template_url": repository["RemoteUrl"],
         "commit": f"{sha}".replace('"', "'"),
         "tag": tag,
     }

{thothctl-0.13.6 → thothctl-0.14.2}/src/thothctl/core/integrations/github/get_github.py

@@ -169,6 +169,7 @@ def clone_repo(
     repo_meta = {
         "repo_name": repository["Name"],
         "repo_url": repository["RemoteUrl"],
+        "template_url": repository["RemoteUrl"],
         "commit": f"{sha}".replace('"', "'"),
         "tag": tag,
     }

{thothctl-0.13.6 → thothctl-0.14.2}/src/thothctl/services/generate/create_template/create_template.py

@@ -38,6 +38,8 @@ def init_thothcf_content(project_type="terraform-terragrunt"):
         template = thothcf_toml_module_content
     elif project_type in ["terragrunt", "terraform-terragrunt"]:
         template = thothcf_toml_content  # Use same content as terraform for now
+    elif project_type.startswith("cdkv2"):
+        template = thothcf_toml_content  # Use same content as terraform for now
     else:
         logging.error(f"Project type {project_type} not supported")
         raise ValueError(f"Project type {project_type} not supported")
@@ -100,6 +102,8 @@ def create_project(
     elif project_type == "terraform-module":
         template = terraform_module_template
     elif project_type in ["terragrunt", "terraform-terragrunt"]:
+        template = thothcf_toml_content  # Use same content as terraform for now
+    elif project_type.startswith("cdkv2"):
         template = terragrunt_template
     else:
         template = terraform_template  # Default fallback

{thothctl-0.13.6 → thothctl-0.14.2}/src/thothctl/services/generate/create_template/github_template_loader.py

@@ -23,7 +23,12 @@ class GitHubTemplateLoader:
         "terraform": "https://github.com/thothforge/terraform_project_scaffold.git",
         "terraform-module": "https://github.com/thothforge/terraform_module_scaffold.git",
         "tofu": "https://github.com/thothforge/tofu_project_scaffold.git",
-        "cdkv2": "https://github.com/thothforge/cdkv2_project_scaffold.git",
+        "cdkv2": "https://github.com/thothforge/cdkv2_typescript_scaffold.git",
+        "cdkv2-typescript": "https://github.com/thothforge/cdkv2_typescript_scaffold.git",
+        "cdkv2-python": "https://github.com/thothforge/cdkv2_python_scaffold.git",
+        "cdkv2-java": "https://github.com/thothforge/cdkv2_java_scaffold.git",
+        "cdkv2-csharp": "https://github.com/thothforge/cdkv2_csharp_scaffold.git",
+        "cdkv2-go": "https://github.com/thothforge/cdkv2_go_scaffold.git",
     }
     
     def __init__(self, logger=None):

{thothctl-0.13.6 → thothctl-0.14.2}/src/thothctl/services/init/project/project.py

@@ -268,6 +268,7 @@ class ProjectService:
             repo_meta = {
                 "repo_name": selected_template["repo_name"],
                 "repo_url": clean_url,
+                "template_url": clean_url,
                 "commit": f"{sha}".replace('"', "'"),
                 "tag": tag if tag else "",
             }
@@ -443,6 +444,7 @@ class ProjectService:
             repo_meta = {
                 "repo_name": selected_template["repo_name"],
                 "repo_url": clean_url,
+                "template_url": clean_url,
                 "commit": f"{sha}".replace('"', "'"),
                 "tag": tag if tag else "",
             }

{thothctl-0.13.6 → thothctl-0.14.2}/src/thothctl/services/mcp/amazon_q_server.py

@@ -68,7 +68,8 @@ async def serve_amazon_q():
                     "properties": {
                         "project_name": {"type": "string", "description": "Name of the project"},
                         "project_type": {"type": "string", "description": "Type of project", "default": "terraform-terragrunt", "enum": ["terraform", "terraform-terragrunt", "tofu", "cdkv2", "terraform_module", "terragrunt", "custom"]},
-                        "space": {"type": "string", "description": "Space name (optional)"}
+                        "space": {"type": "string", "description": "Space name (optional)"},
+                        "language": {"type": "string", "description": "CDK language (only for cdkv2)", "enum": ["typescript", "python", "java", "csharp", "go"]}
                     },
                     "required": ["project_name"],
                     "additionalProperties": False

{thothctl-0.13.6 → thothctl-0.14.2}/src/thothctl/services/project/upgrade/upgrade_service.py

@@ -47,7 +47,7 @@ class ProjectUpgradeService:
                 return {"success": False, "error": "No project metadata found in .thothcf.toml"}
 
             # Get remote template info
-            template_url = metadata.get("template_url")
+            template_url = metadata.get("template_url") or metadata.get("repo_url")
             if not template_url:
                 return {"success": False, "error": "No template_url found in project metadata"}
 

thothctl-0.14.2/src/thothctl/version.py

@@ -0,0 +1,2 @@
+"""Version module."""
+__version__ = "0.14.2"

thothctl-0.14.2/tests/test_cdk_language_selection.py

@@ -0,0 +1,159 @@
+"""Unit tests for CDK language selection in project init workflow."""
+
+import pytest
+from pathlib import Path
+from unittest.mock import MagicMock, patch
+
+from thothctl.services.generate.create_template.github_template_loader import GitHubTemplateLoader
+
+
+class TestGitHubTemplateLoaderCdkLanguages:
+    """Test that CDK language variants are registered in the template loader."""
+
+    def test_cdkv2_generic_template_exists(self):
+        loader = GitHubTemplateLoader()
+        assert "cdkv2" in loader.DEFAULT_TEMPLATES
+
+    @pytest.mark.parametrize("language", ["typescript", "python", "java", "csharp", "go"])
+    def test_cdkv2_language_template_exists(self, language):
+        loader = GitHubTemplateLoader()
+        key = f"cdkv2-{language}"
+        assert key in loader.DEFAULT_TEMPLATES
+        assert "thothforge" in loader.DEFAULT_TEMPLATES[key]
+        assert language in loader.DEFAULT_TEMPLATES[key]
+
+    def test_cdkv2_language_urls_are_unique(self):
+        loader = GitHubTemplateLoader()
+        cdk_urls = [v for k, v in loader.DEFAULT_TEMPLATES.items() if k.startswith("cdkv2-")]
+        assert len(cdk_urls) == len(set(cdk_urls))
+
+    def test_is_template_available_for_cdk_languages(self):
+        loader = GitHubTemplateLoader()
+        for lang in ["typescript", "python", "java", "csharp", "go"]:
+            assert loader.is_template_available(f"cdkv2-{lang}")
+
+    def test_non_existent_language_not_available(self):
+        loader = GitHubTemplateLoader()
+        assert not loader.is_template_available("cdkv2-rust")
+
+    @pytest.mark.parametrize("language", ["typescript", "python", "java", "csharp", "go"])
+    def test_load_template_resolves_correct_url(self, language):
+        """Verify load_template picks the right URL for each CDK language."""
+        loader = GitHubTemplateLoader()
+        loader.config = MagicMock()
+        loader.config.get_template_url.return_value = None  # No user override
+
+        with patch.object(loader, '_clone_and_copy_template', return_value={"ok": True}) as mock_clone:
+            loader.load_template("my-app", f"cdkv2-{language}")
+            mock_clone.assert_called_once_with(
+                loader.DEFAULT_TEMPLATES[f"cdkv2-{language}"],
+                "my-app",
+                f"cdkv2-{language}",
+            )
+
+
+class TestProjectInitCdkLanguageSelection:
+    """Test the CLI command handles --language flag correctly."""
+
+    def test_cli_has_language_option(self):
+        from thothctl.commands.init.commands.project import cli
+        param_names = [p.name for p in cli.params]
+        assert "language" in param_names
+
+    def test_language_choices(self):
+        from thothctl.commands.init.commands.project import cli
+        lang_param = next(p for p in cli.params if p.name == "language")
+        assert hasattr(lang_param.type, "choices")
+        assert set(lang_param.type.choices) == {"typescript", "python", "java", "csharp", "go"}
+
+    def test_cdkv2_language_rewrite_logic(self):
+        """Test the core logic: cdkv2 + python → cdkv2-python."""
+        # Simulate what _execute does
+        project_type = "cdkv2"
+        language = "python"
+        if project_type == "cdkv2" and language:
+            project_type = f"cdkv2-{language}"
+        assert project_type == "cdkv2-python"
+
+    def test_cdkv2_batch_defaults_to_typescript(self):
+        """In batch mode without --language, cdkv2 defaults to typescript."""
+        project_type = "cdkv2"
+        language = None
+        batch = True
+        if project_type == "cdkv2":
+            if not language:
+                if batch:
+                    language = "typescript"
+            project_type = f"cdkv2-{language}"
+        assert project_type == "cdkv2-typescript"
+
+    def test_terraform_ignores_language(self):
+        """Language rewrite only applies to cdkv2."""
+        project_type = "terraform"
+        language = "python"
+        if project_type == "cdkv2" and language:
+            project_type = f"cdkv2-{language}"
+        assert project_type == "terraform"
+
+    @pytest.mark.parametrize("language", ["typescript", "python", "java", "csharp", "go"])
+    def test_all_languages_produce_valid_project_type(self, language):
+        project_type = "cdkv2"
+        project_type = f"cdkv2-{language}"
+        loader = GitHubTemplateLoader()
+        assert project_type in loader.DEFAULT_TEMPLATES
+
+
+class TestTemplatePlaceholdersCdk:
+    """Test that CDK scaffold files have correct template placeholders."""
+
+    def test_environment_yaml_has_placeholders(self):
+        yaml_path = Path(__file__).parent.parent.parent / \
+            "iac-scaffold/cdkv2_scaffold_project/project_configs/environment_options.yaml"
+        if not yaml_path.exists():
+            pytest.skip("CDK scaffold not found at expected path")
+        content = yaml_path.read_text()
+        assert "#{project_name}#" in content
+        assert "#{deployment_region}#" in content
+        assert "#{owner}#" in content
+
+    def test_catalog_yaml_has_placeholders(self):
+        catalog_path = Path(__file__).parent.parent.parent / \
+            "iac-scaffold/cdkv2_scaffold_project/docs/catalog/catalog-info.yaml"
+        if not catalog_path.exists():
+            pytest.skip("CDK scaffold not found at expected path")
+        content = catalog_path.read_text()
+        assert "#{project_name}#" in content
+        assert "#{owner}#" in content
+
+    def test_typescript_files_have_no_placeholders(self):
+        """TS files should NOT have #{...}# — config is externalized to YAML."""
+        lib_path = Path(__file__).parent.parent.parent / \
+            "iac-scaffold/cdkv2_scaffold_project/lib"
+        if not lib_path.exists():
+            pytest.skip("CDK scaffold not found at expected path")
+        for ts_file in lib_path.rglob("*.ts"):
+            content = ts_file.read_text()
+            assert "#{" not in content, f"Found placeholder in TS file: {ts_file}"
+
+    def test_thothcf_toml_keys_match_placeholders(self):
+        """All #{...}# placeholders in scaffold files must have a matching .thothcf.toml key."""
+        import re
+        base = Path(__file__).parent.parent.parent / "iac-scaffold/cdkv2_scaffold_project"
+        if not base.exists():
+            pytest.skip("CDK scaffold not found")
+
+        toml_content = (base / ".thothcf.toml").read_text()
+        toml_keys = set(re.findall(r'\[template_input_parameters\.(\w+)\]', toml_content))
+
+        # Collect all placeholders from scaffold files
+        placeholders = set()
+        for f in base.rglob("*"):
+            if f.is_file() and f.suffix in (".yaml", ".yml", ".md") and ".git" not in str(f):
+                try:
+                    content = f.read_text()
+                    placeholders.update(re.findall(r'#\{(\w+)\}#', content))
+                except UnicodeDecodeError:
+                    pass
+
+        missing = placeholders - toml_keys
+        assert not missing, f"Placeholders {missing} have no matching .thothcf.toml key"

thothctl-0.14.2/tests/test_template_url_fix.py

@@ -0,0 +1,109 @@
+"""Unit tests for template_url fix in upgrade service and metadata creation."""
+
+import pytest
+from pathlib import Path
+from unittest.mock import patch, MagicMock
+import toml
+
+from thothctl.services.project.upgrade.upgrade_service import ProjectUpgradeService
+
+
+@pytest.fixture
+def upgrade_service():
+    return ProjectUpgradeService()
+
+
+@pytest.fixture
+def project_with_metadata(tmp_path):
+    """Create a project dir with .thothcf.toml containing origin_metadata."""
+    def _create(metadata: dict):
+        toml_path = tmp_path / ".thothcf.toml"
+        toml_path.write_text(toml.dumps({"origin_metadata": metadata}))
+        return tmp_path
+    return _create
+
+
+class TestUpgradeServiceTemplateUrl:
+    """Test that upgrade service resolves template_url from metadata correctly."""
+
+    def test_reads_template_url_when_present(self, upgrade_service, project_with_metadata):
+        """upgrade should use template_url if it exists."""
+        project_path = project_with_metadata({
+            "repo_name": "my-template",
+            "repo_url": "https://dev.azure.com/org/proj/_git/my-template",
+            "template_url": "https://dev.azure.com/org/proj/_git/my-template",
+            "commit": "abc123",
+            "tag": "v1.0.0",
+        })
+
+        with patch.object(upgrade_service, '_clone_template', side_effect=Exception("stop")):
+            result = upgrade_service.upgrade_project(project_path)
+
+        # It should have attempted to clone (meaning template_url was found)
+        assert result["error"] != "No template_url found in project metadata"
+
+    def test_falls_back_to_repo_url(self, upgrade_service, project_with_metadata):
+        """upgrade should fall back to repo_url when template_url is missing."""
+        project_path = project_with_metadata({
+            "repo_name": "terraform_azdo_mangement_blueprint",
+            "repo_url": "https://dev.azure.com/GFT-SE/KE-054129-001/_git/terraform_azdo_mangement_blueprint",
+            "commit": "cb29795b95f4ac476baf3955561ab1999b1eb4ae",
+            "tag": "",
+        })
+
+        with patch.object(upgrade_service, '_clone_template', side_effect=Exception("stop")):
+            result = upgrade_service.upgrade_project(project_path)
+
+        # Should NOT fail with "No template_url found"
+        assert "No template_url found" not in result.get("error", "")
+
+    def test_fails_when_neither_url_present(self, upgrade_service, project_with_metadata):
+        """upgrade should fail if neither template_url nor repo_url exists."""
+        project_path = project_with_metadata({
+            "repo_name": "some-repo",
+            "commit": "abc123",
+            "tag": "",
+        })
+
+        result = upgrade_service.upgrade_project(project_path)
+
+        assert result["success"] is False
+        assert "No template_url found" in result["error"]
+
+    def test_no_metadata_file(self, upgrade_service, tmp_path):
+        """upgrade should fail gracefully if .thothcf.toml doesn't exist."""
+        result = upgrade_service.upgrade_project(tmp_path)
+
+        assert result["success"] is False
+        assert "No project metadata found" in result["error"]
+
+
+class TestRepoMetaIncludesTemplateUrl:
+    """Test that init paths include template_url in repo_meta."""
+
+    def test_azure_clone_repo_includes_template_url(self):
+        """clone_repo in get_azure_devops should include template_url."""
+        from unittest.mock import patch, MagicMock
+        import thothctl.core.integrations.azure_devops.get_azure_devops as azdo
+
+        mock_repo = MagicMock()
+        mock_repo.tags = []
+        mock_repo.rev_parse.return_value = MagicMock(hexsha="abc123")
+
+        fake_repos = [{"Name": "my-template", "RemoteUrl": "https://dev.azure.com/org/proj/_git/my-template"}]
+
+        with patch.object(azdo, 'get_repos_patterns', return_value=fake_repos), \
+             patch.object(azdo.inquirer, 'prompt', return_value={"repository": "my-template"}), \
+             patch.object(azdo.git.Repo, 'clone_from', return_value=mock_repo), \
+             patch.object(azdo.git.Repo, 'init'), \
+             patch.object(azdo.shutil, 'rmtree'), \
+             patch.object(azdo.os.path, 'join', return_value="/tmp/.git"):
+
+            result = azdo.clone_repo(
+                git_client=MagicMock(),
+                project_name="proj",
+                path="/tmp/test",
+            )
+
+        assert "template_url" in result
+        assert result["template_url"] == result["repo_url"]

thothctl-0.13.6/docs/template_engine/github_templates.md

@@ -1,88 +0,0 @@
-# GitHub Template Integration
-
-ThothCTL now automatically loads project templates from GitHub public repositories based on the project type. This provides standardized, up-to-date project scaffolding for different infrastructure frameworks.
-
-## Default Behavior
-
-When you run `thothctl init project`, the system will:
-
-1. **Load from GitHub first**: Automatically clone the appropriate template repository based on project type
-2. **Fallback to local templates**: If GitHub loading fails, use local hardcoded templates
-3. **Apply template processing**: Replace placeholders and configure the project
-
-## Supported Project Types and Templates
-
-| Project Type | Default Repository |
-|-------------|-------------------|
-| `terragrunt` | https://github.com/thothforge/terragrunt_project_scaffold.git |
-| `terraform` | https://github.com/thothforge/terraform_project_scaffold.git |
-| `terraform_module` | https://github.com/thothforge/terraform_module_scaffold.git |
-| `tofu` | https://github.com/thothforge/tofu_project_scaffold.git |
-| `cdkv2` | https://github.com/thothforge/cdkv2_project_scaffold.git |
-
-## Usage Examples
-
-### Basic Project Creation
-```bash
-# Creates a terragrunt project using the GitHub template
-thothctl init project --project-name my-infrastructure --project-type terragrunt
-
-# Creates a terraform project using the GitHub template  
-thothctl init project --project-name my-terraform --project-type terraform
-```
-
-### Managing Template Configurations
-
-#### List Available Templates
-```bash
-# Show default GitHub templates
-thothctl list templates
-
-# Show templates from a specific space (VCS-based)
-thothctl list templates --space my-space
-
-# Show both default and VCS templates
-thothctl list templates --space my-space --defaults
-```
-
-#### Set Custom Template Repository
-```bash
-thothctl init template --project-type terragrunt --template-url https://github.com/myorg/custom-terragrunt-template.git
-```
-
-#### View Current Template URL
-```bash
-thothctl init template --project-type terragrunt
-```
-
-## Configuration
-
-Template URLs are stored in `~/.thothcf/.thothctl_templates.toml`:
-
-```toml
-[templates]
-terragrunt = "https://github.com/myorg/custom-terragrunt-template.git"
-terraform = "https://github.com/myorg/custom-terraform-template.git"
-```
-
-## Benefits
-
-- **Always Up-to-Date**: Templates are fetched from the latest version in the repository
-- **Standardized**: Consistent project structure across teams and organizations
-- **Customizable**: Organizations can override default templates with their own
-- **Fallback Safety**: Local templates ensure functionality even without internet access
-- **Zero Configuration**: Works out of the box with sensible defaults
-
-## Requirements
-
-- Internet access for GitHub template loading
-- Git installed on the system
-- GitPython dependency (automatically installed with thothctl)
-
-## Troubleshooting
-
-If template loading fails:
-1. Check internet connectivity
-2. Verify the repository URL is accessible
-3. The system will automatically fall back to local templates
-4. Check logs with `--debug` flag for detailed error information

thothctl-0.13.6/src/thothctl/version.py

@@ -1,2 +0,0 @@
-"""Version module."""
-__version__ = "0.13.6"