From cde27f022356cda5be06f97f4b4dc82898514ea4 Mon Sep 17 00:00:00 2001 From: Gleb Kanterov Date: Fri, 29 Aug 2025 14:28:33 +0200 Subject: [PATCH] [Python] Clarify approach for namespacing --- experimental/python/codegen/codegen/packages.py | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/experimental/python/codegen/codegen/packages.py b/experimental/python/codegen/codegen/packages.py index ef4e607ed0..e3272fe4c3 100644 --- a/experimental/python/codegen/codegen/packages.py +++ b/experimental/python/codegen/codegen/packages.py @@ -1,7 +1,14 @@ import re from typing import Optional -# All supported resource types and their namespace +# All supported resource types and their namespace. +# +# We put each resource type into own package and don't do cross-package imports, +# each package is self-contained. If two resources share the same datatype, it's +# duplicated to allow independent evolution. +# +# The convention is that each resource type uses a plural name as package name, +# e.g., "resources.Job" -> "jobs", "resources.Pipeline" -> "pipelines". RESOURCE_NAMESPACE = { "resources.Job": "jobs", "resources.Pipeline": "pipelines",