thothctl 0.18.1__tar.gz → 0.18.3__tar.gz

{thothctl-0.18.1 → thothctl-0.18.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: thothctl
-Version: 0.18.1
+Version: 0.18.3
 Summary: A CLI for Developer Control Plane. Accelerate your cloud IaC deployments.
 Project-URL: SourceCode, https://github.com/thothforge/thothctl
 Project-URL: HomePage, https://github.com/thothforge/thothctl

{thothctl-0.18.1 → thothctl-0.18.3}/docs/framework/space_configuration.md

@@ -80,6 +80,47 @@ You can list all available spaces using the `thothctl list spaces` command:
 thothctl list spaces
 ```
 
+### Showing Space Details
+
+View the full configuration summary of a space:
+
+```bash
+thothctl space show my-space
+```
+
+This displays:
+- Space name, description, status (active/inactive), and creation date
+- Version control provider
+- Terraform registry and authentication method
+- Orchestration tool
+- Governance policy repository (if configured)
+- Associated projects
+- Credentials status
+
+### Activating a Space
+
+Set a space as the active context (used as default for new projects):
+
+```bash
+thothctl space activate my-space
+```
+
+### Updating a Space
+
+Update an existing space's configuration:
+
+```bash
+thothctl space update my-space --vcs-provider github --orchestration-tool terragrunt
+thothctl space update my-space --policy-repo https://github.com/myorg/iac-policies.git
+```
+
+Available options:
+- `-d, --description` — New description
+- `-vcs, --vcs-provider` — Version control provider (`azure_repos`, `github`, `gitlab`)
+- `-ot, --orchestration-tool` — Orchestration tool (`terragrunt`, `terramate`, `none`)
+- `-tr, --terraform-registry` — Terraform registry URL
+- `-pr, --policy-repo` — Git repository URL or local path for organization-level IaC policies
+
 ### Deleting a Space
 
 You can delete a space using the `thothctl remove space` command:

{thothctl-0.18.1 → thothctl-0.18.3}/docs/framework/use_cases/space_management.md

@@ -60,6 +60,37 @@ Usage: thothctl list spaces
   List all spaces managed by thothctl
 ```
 
+### Show Space Configuration
+
+```
+Usage: thothctl space show SPACE_NAME
+
+  Show space configuration summary
+```
+
+### Update Space Configuration
+
+```
+Usage: thothctl space update SPACE_NAME [OPTIONS]
+
+  Update an existing space's configuration
+
+Options:
+  -d, --description TEXT          New description for the space
+  -vcs, --vcs-provider [azure_repos|github|gitlab]
+  -ot, --orchestration-tool [terragrunt|terramate|none]
+  -tr, --terraform-registry TEXT  Terraform registry URL
+  -pr, --policy-repo TEXT         Git URL or path for IaC policies
+```
+
+### Activate a Space
+
+```
+Usage: thothctl space activate SPACE_NAME
+
+  Set a space as the active context
+```
+
 ### List Projects with Space Information
 
 ```
@@ -97,6 +128,14 @@ thothctl list spaces
 
 This displays a list of all spaces with their project counts.
 
+### Showing Space Configuration
+
+```bash
+thothctl space show platform-team
+```
+
+This displays a full summary of the space including VCS provider, Terraform registry, orchestration tool, governance policies, associated projects, and credentials status.
+
 ### Listing Projects with Space Information
 
 ```bash

{thothctl-0.18.1 → thothctl-0.18.3}/src/thothctl/commands/check/commands/project/iac.py

@@ -188,7 +188,7 @@ class CheckProjectIaCCommand(ClickCommand):
         
         try:
             # Run org policy check if source is provided
-            org_violations = self._check_org_policy(directory, project_type, org_policy)
+            org_violations = self._check_org_policy(directory, project_type, org_policy, skip_org=kwargs.get('skip_org_policy', False))
 
             # Capture stdout to format it nicely
             captured_output = io.StringIO()
@@ -245,8 +245,12 @@ class CheckProjectIaCCommand(ClickCommand):
             self.logger.error(f"Failed to execute IaC project check: {str(e)}")
             raise
 
-    def _check_org_policy(self, directory: str, project_type: str, org_policy=None):
+    def _check_org_policy(self, directory: str, project_type: str, org_policy=None, skip_org: bool = False):
         """Check project against organizational policy if available."""
+        if skip_org:
+            self.console.print("[dim]📜 Org policy check skipped (--skip-org-policy)[/dim]")
+            return None
+
         from .....services.check.org_policy_loader import get_org_policy_path, resolve_rules_dir
         from .....services.check.rule_merger import load_org_rules, merge_with_project, evaluate
 
@@ -355,4 +359,10 @@ cli = CheckProjectIaCCommand.as_click_command(
         type=click.Choice(["soft", "hard"], case_sensitive=False),
         default="soft",
     ),
+    click.option(
+        "--skip-org-policy",
+        is_flag=True,
+        default=False,
+        help="Skip organizational policy check (use when project has explicit exceptions)",
+    ),
 )

{thothctl-0.18.1 → thothctl-0.18.3}/src/thothctl/commands/space/commands/update.py

@@ -17,15 +17,15 @@ class UpdateSpaceCommand(ClickCommand):
         super().__init__()
         self.ui = CliUI()
 
-    def validate(self, space_name: str, description, vcs_provider, orchestration_tool, terraform_registry, **kwargs) -> bool:
+    def validate(self, space_name: str, description, vcs_provider, orchestration_tool, terraform_registry, policy_repo, **kwargs) -> bool:
         spaces = list_spaces()
         if space_name not in spaces:
             raise ValueError(f"Space '{space_name}' does not exist")
-        if not any([description, vcs_provider, orchestration_tool, terraform_registry]):
-            raise ValueError("Provide at least one option to update (--description, --vcs-provider, --orchestration-tool, --terraform-registry)")
+        if not any([description, vcs_provider, orchestration_tool, terraform_registry, policy_repo]):
+            raise ValueError("Provide at least one option to update (--description, --vcs-provider, --orchestration-tool, --terraform-registry, --policy-repo)")
         return True
 
-    def _execute(self, space_name: str, description, vcs_provider, orchestration_tool, terraform_registry, **kwargs) -> None:
+    def _execute(self, space_name: str, description, vcs_provider, orchestration_tool, terraform_registry, policy_repo, **kwargs) -> None:
         config_path = Path.home() / ".thothcf" / "spaces.toml"
         with open(config_path, mode="rt", encoding="utf-8") as fp:
             config = toml.load(fp)
@@ -40,6 +40,8 @@ class UpdateSpaceCommand(ClickCommand):
             space.setdefault("orchestration", {})["tool"] = orchestration_tool
         if terraform_registry is not None:
             space.setdefault("terraform", {})["registry"] = terraform_registry
+        if policy_repo is not None:
+            space.setdefault("governance", {})["policy_repo"] = policy_repo
 
         space["updated_at"] = datetime.now().isoformat()
 
@@ -69,4 +71,9 @@ cli = UpdateSpaceCommand.as_click_command(help="Update an existing space's confi
         help="Terraform registry URL",
         default=None,
     ),
+    click.option(
+        "-pr", "--policy-repo",
+        help="Git repository URL or local path for organization-level IaC policies",
+        default=None,
+    ),
 )

{thothctl-0.18.1 → thothctl-0.18.3}/src/thothctl/services/check/org_policy_loader.py

@@ -16,12 +16,17 @@ def get_org_policy_path(org_policy: Optional[str] = None) -> Optional[str]:
     Resolution:
         1. Explicit --org-policy argument
         2. THOTH_ORG_POLICY env var
-        3. None (no org policy)
+        3. Active space's governance.policy_repo
+        4. None (no org policy)
 
     Returns:
         Absolute path to cached org policy repo, or None.
     """
     source = org_policy or os.environ.get("THOTH_ORG_POLICY")
+
+    if not source:
+        source = _get_active_space_policy_repo()
+
     if not source:
         return None
 
@@ -36,6 +41,33 @@ def get_org_policy_path(org_policy: Optional[str] = None) -> Optional[str]:
     return None
 
 
+def _get_active_space_policy_repo() -> Optional[str]:
+    """Load policy_repo from the active space configuration."""
+    try:
+        import toml
+
+        active_file = Path.home() / ".thothcf" / "active_space"
+        if not active_file.exists():
+            return None
+
+        space_name = active_file.read_text(encoding="utf-8").strip()
+        if not space_name:
+            return None
+
+        config_path = Path.home() / ".thothcf" / "spaces.toml"
+        if not config_path.exists():
+            return None
+
+        config = toml.load(config_path)
+        space = config.get("spaces", {}).get(space_name, {})
+        policy_repo = space.get("governance", {}).get("policy_repo", "")
+
+        return policy_repo if policy_repo else None
+    except Exception as e:
+        logger.debug(f"Failed to load active space policy repo: {e}")
+        return None
+
+
 def resolve_rules_dir(org_path: str) -> Optional[str]:
     """Get the rules/ directory from an org policy repo."""
     rules_dir = os.path.join(org_path, "rules")

thothctl-0.18.3/src/thothctl/version.py

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

thothctl-0.18.1/src/thothctl/version.py

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