improve path resolution

Author: jasonzh0

README.md

@@ -11,6 +11,7 @@ A Python library for rendering Helm charts and Kubernetes resources with optiona
 - `KubernetesResource` class for raw Kubernetes resources (no Helm required)
 - `TemplateRegistry` for managing multiple templates (charts and resources)
 - Command-line interface (CLI) for rendering and applying manifests
+- Resource visualization with Graphviz DOT diagrams showing resource relationships
 - Automatic Docker image build and load steps (executed sequentially during template registration)
 - Git operations for manifest repository management
 - Docker image build and push utilities with custom Dockerfile support
@@ -363,6 +364,49 @@ for template_class in templates:
 
 **For HelmChart:** Renders to `manifests/{chart-name}/{chart-name}-manifests.yaml`, writes extra manifests to `manifests/{chart-name}/`, and generates ArgoCD Application to `manifests/apps/{chart-name}-application.yaml` (if enabled).
 
+### Visualizing Resource Relationships
+
+Generate Graphviz DOT diagrams to visualize Kubernetes resources and their relationships:
+
+```bash
+# Generate visualization and save to file
+kubeman visualize --file kubeman.py --output diagram.dot
+
+# Output to stdout
+kubeman visualize --file kubeman.py
+
+# Include CustomResourceDefinitions in visualization
+kubeman visualize --file kubeman.py --output diagram.dot --show-crds
+
+# Use custom manifests directory
+kubeman visualize --file kubeman.py --output-dir ./custom-manifests --output diagram.dot
+```
+
+The visualization command:
+1. Renders templates to generate manifests (build steps are automatically skipped)
+2. Analyzes rendered manifests to detect relationships (ConfigMap references, Service selectors, network connections, etc.)
+3. Generates a Graphviz DOT diagram showing resource hierarchy and relationships
+4. Outputs to a file or stdout
+
+**Rendering the diagram:**
+
+After generating the DOT file, render it to an image using Graphviz:
+
+```bash
+# Generate PNG image
+dot -Tpng diagram.dot -o diagram.png
+
+# Generate SVG image
+dot -Tsvg diagram.dot -o diagram.svg
+```
+
+**Visualization features:**
+- Shows resources grouped by namespace
+- Displays relationships between resources (uses, selects, connects-to)
+- Includes connection addresses (e.g., database URLs from ConfigMaps)
+- Filters to only show resources from templates in your `kubeman.py` file
+- Optionally includes CustomResourceDefinitions (hidden by default)
+
 **For KubernetesResource:** Writes each manifest to `manifests/{name}/{manifest-name}-{kind}.yaml` and generates ArgoCD Application to `manifests/apps/{name}-application.yaml` (if enabled).
 
 ### Advanced Chart Configuration

examples/fullstack/templates/backend.py

@@ -5,7 +5,6 @@
 for the fullstack TODO application.
 """
 
-from pathlib import Path
 from kubeman import KubernetesResource, TemplateRegistry
 
 
@@ -98,11 +97,11 @@ def build(self) -> None:
         """Build Docker image for backend API"""
         from kubeman import DockerManager
 
-        backend_dir = Path(__file__).parent.parent / "backend"
+        context_path = self.resolve_path("../backend")
         docker = DockerManager()
         docker.build_image(
             component="backend-api",
-            context_path=str(backend_dir),
+            context_path=context_path,
             tag="latest",
             dockerfile="Dockerfile",
         )

examples/fullstack/templates/frontend.py

@@ -5,7 +5,6 @@
 for the fullstack TODO application.
 """
 
-from pathlib import Path
 from kubeman import KubernetesResource, TemplateRegistry
 
 
@@ -117,11 +116,11 @@ def build(self) -> None:
         """Build Docker image for frontend app"""
         from kubeman import DockerManager
 
-        frontend_dir = Path(__file__).parent.parent / "frontend"
+        context_path = self.resolve_path("../frontend")
         docker = DockerManager()
         docker.build_image(
             component="frontend-app",
-            context_path=str(frontend_dir),
+            context_path=context_path,
             tag="latest",
             dockerfile="Dockerfile",
         )

examples/fullstack/templates/postgres_db.py

@@ -133,9 +133,7 @@ def __init__(self):
 
     def extra_manifests(self) -> list[dict]:
         """Add ConfigMap with init.sql for database initialization"""
-        from pathlib import Path
-
-        init_sql_path = Path(__file__).parent.parent / "init.sql"
+        init_sql_path = self.resolve_path("../init.sql")
         init_sql_content = init_sql_path.read_text()
 
         return [

examples/kafka/templates/stock_price_consumer.py

@@ -77,14 +77,13 @@ def __init__(self):
 
     def build(self) -> None:
         """Build Docker image for stock price consumer"""
-        from pathlib import Path
         from kubeman import DockerManager
 
-        kafka_dir = Path(__file__).parent.parent
+        context_path = self.resolve_path("..")
         docker = DockerManager()
         docker.build_image(
             component="stock-price-consumer",
-            context_path=str(kafka_dir),
+            context_path=context_path,
             tag="latest",
             dockerfile="Dockerfile.consumer",
         )

examples/kafka/templates/stock_price_producer.py

@@ -91,14 +91,13 @@ def __init__(self):
 
     def build(self) -> None:
         """Build Docker image for stock price producer"""
-        from pathlib import Path
         from kubeman import DockerManager
 
-        kafka_dir = Path(__file__).parent.parent
+        context_path = self.resolve_path("..")
         docker = DockerManager()
         docker.build_image(
             component="stock-price-producer",
-            context_path=str(kafka_dir),
+            context_path=context_path,
             tag="latest",
             dockerfile="Dockerfile.producer",
         )

examples/spark/README.md

@@ -106,14 +106,13 @@ To modify the build or load behavior, edit `custom_pyspark_job.py`:
 ```python
 def build(self) -> None:
     """Build Docker image for custom PySpark job"""
-    from pathlib import Path
     from kubeman import DockerManager
 
-    spark_dir = Path(__file__).parent
+    context_path = self.resolve_path("..")
     docker = DockerManager()
     docker.build_image(
         component="custom-pyspark-job",
-        context_path=str(spark_dir),
+        context_path=context_path,
         tag="latest",
         dockerfile="Dockerfile.pyspark",
     )

examples/spark/templates/custom_pyspark_job.py

@@ -89,14 +89,13 @@ def extra_manifests(self) -> list[dict]:
 
     def build(self) -> None:
         """Build Docker image for custom PySpark job"""
-        from pathlib import Path
         from kubeman import DockerManager
 
-        spark_dir = Path(__file__).parent.parent
+        context_path = self.resolve_path("..")
         docker = DockerManager()
         docker.build_image(
             component="custom-pyspark-job",
-            context_path=str(spark_dir),
+            context_path=context_path,
             tag="latest",
             dockerfile="Dockerfile.pyspark",
         )

kubeman/__init__.py

@@ -29,4 +29,4 @@
     "apply_manifests",
 ]
 
-__version__ = "0.5.3"
+__version__ = "0.5.4"

kubeman/docker.py

@@ -1,5 +1,5 @@
 from pathlib import Path
-from typing import Optional
+from typing import Optional, Union
 from kubeman.config import Config
 from kubeman.executor import CommandExecutor, get_executor
 
@@ -41,15 +41,15 @@ def __init__(
     def build_image(
         self,
         component: str,
-        context_path: str,
+        context_path: Union[str, Path],
         tag: Optional[str] = None,
         dockerfile: Optional[str] = None,
     ) -> str:
         """Build a Docker image for a component.
 
         Args:
             component: The name of the component (e.g., 'frontend')
-            context_path: Path to the Docker context
+            context_path: Path to the Docker context (str or Path)
             tag: Optional specific tag, defaults to 'latest'
             dockerfile: Optional Dockerfile name (defaults to 'Dockerfile')
 
@@ -59,7 +59,7 @@ def build_image(
         tag = tag or "latest"
         image_name = f"{self.registry}/{component}:{tag}"
 
-        context = Path(context_path)
+        context = Path(context_path).resolve()
         dockerfile_path = context / (dockerfile or "Dockerfile")
 
         cmd = [
@@ -95,15 +95,15 @@ def push_image(self, component: str, tag: Optional[str] = None) -> str:
     def build_and_push(
         self,
         component: str,
-        context_path: str,
+        context_path: Union[str, Path],
         tag: Optional[str] = None,
         dockerfile: Optional[str] = None,
     ) -> str:
         """Build and push a Docker image in one go.
 
         Args:
             component: The name of the component
-            context_path: Path to the Docker context
+            context_path: Path to the Docker context (str or Path)
             tag: Optional specific tag
             dockerfile: Optional Dockerfile name (defaults to 'Dockerfile')
         """