kube_cluster 0.20.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b9f57ee079352d4d49d3a72b968e7f8e896ff98fd520f55e32572db096e48873
-  data.tar.gz: c30f1be092b7676bb653a289a1bd7f6616b7f6e6cc3f28037444adac0a800de5
+  metadata.gz: 462551e605fb3e1e675b9e6fbf15275b5e47e8d92182a1bb78e6a4bff5aa1ec2
+  data.tar.gz: 0cd151a210e51ffd9143b1a16686c7b4b01e865e5086d62492294f0f764cb1ba
 SHA512:
-  metadata.gz: 5e66eb5cdb16c4023d56de2191ec5c0203471c7104ac4a689d84fa7be9dc80379d69914eb38c5928a560a7e63e3ce9992694da5ee6f96a6fbcf8ffeb89837f7e
-  data.tar.gz: 1f6eed585979c1fb4e25b3812979e2ba11f1f6890ef9be94afd040e4723b990d7b4f65775a4befa98ff1362af24f231be4ce1910e2820b87307a906dd42575e1
+  metadata.gz: 16c8211e12773eb6ad277a73d9d3ff56c2111e82077a30dfa2ff527c4c2af9d1259bedef44c42f8528dc76c72f44d7c5aa6f6fa434984383f8ccf78d06551d2f
+  data.tar.gz: 10330e17dad9bf19a5e7f96d6dfb8fa007f6c584d21a53c2e4e143ea96e145911995c0be166c959d6007a23a9ca97642e82bc021868be802488ced36d7a3dc28

data/.gitignore

@@ -8,3 +8,4 @@
 /kubeconfig.yaml
 *.swo
 *.swp
+!flake.lock

data/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-07-13
+
+### Added
+- `Kube::Cluster.config` / `resolve` DSL backed by an internal resolve table
+  that `Kube::Cluster.[]` consults first, so a bare kind can be pinned to an
+  explicit `group/version/Kind` instead of whatever the schema registry lists
+  first.
+- Resolve-table pins for every bare kind referenced under
+  `kube/cluster/standard` — Perses (`v1alpha2`), Gateway API (`v1`), built-in
+  Kubernetes kinds, and the Metacontroller, CloudNativePG, External Secrets,
+  KubeVirt, k3s HelmChart, and VictoriaMetrics CRDs.
+- `config` warns when `Kube::Cluster::Standard` is already loaded, since those
+  classes have already bound their (now stale) superclasses.
+- Test guarding that every bare kind used in the standard tree is pinned in the
+  resolve table.
+
+### Changed
+- **Breaking:** the `kube/cluster/standard` tree is no longer auto-required by
+  `require "kube/cluster"`. Projects must require the specific standard classes
+  they use, so resolve overrides can be configured beforehand.
+
+### Fixed
+- `Standard::Perses::Perses` and `Standard::Perses::PersesDatasource` now resolve
+  to `perses.dev/v1alpha2` instead of the deprecated `v1alpha1` a bare-kind
+  lookup defaulted to.
+
+[1.0.0]: https://github.com/general-intelligence-systems/kube_cluster/releases/tag/v1.0.0

data/Gemfile.lock

@@ -1,11 +1,10 @@
 PATH
   remote: .
   specs:
-    kube_cluster (0.18.0)
+    kube_cluster (1.0.0)
       activesupport (~> 8.0)
       kube_kubectl (~> 2.0)
-      kube_schema (~> 1.7)
-      scampi (~> 0.1)
+      kube_schema (~> 1.9.2)
 
 GEM
   remote: https://rubygems.org/
@@ -23,7 +22,6 @@ GEM
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
       uri (>= 0.13.1)
-    ast (2.4.3)
     async (2.39.0)
       console (~> 1.29)
       fiber-annotation
@@ -77,9 +75,6 @@ GEM
     base64 (0.3.0)
     bigdecimal (4.1.2)
     build-files (1.10.2)
-    colorize (1.1.0)
-    colorize-extended (0.1.0)
-      colorize (~> 1.1)
     concurrent-ruby (1.3.6)
     connection_pool (3.0.2)
     console (1.34.3)
@@ -137,11 +132,9 @@ GEM
       rubyshell (~> 1.5)
       shellwords (~> 0.2.2)
       string_builder (~> 1.2.2)
-    kube_schema (1.7.0)
+    kube_schema (1.9.2)
       json_schemer (~> 2.5.0)
       rubyshell (~> 1.5.0)
-    language_server-protocol (3.17.0.5)
-    lint_roller (1.1.0)
     localhost (1.8.0)
       bake
     logger (1.7.0)
@@ -173,10 +166,6 @@ GEM
     net-smtp (0.5.1)
       net-protocol
     openssl (4.0.2)
-    parallel (2.1.0)
-    parser (3.3.11.1)
-      ast (~> 2.4.1)
-      racc
     pp (0.6.3)
       prettyprint
     prettyprint (0.2.0)
@@ -196,13 +185,11 @@ GEM
     psych (5.3.1)
       date
       stringio
-    racc (1.8.1)
     rack (3.2.6)
     rackula (1.4.1)
       falcon (~> 0.46)
       samovar (~> 2.1)
       variant
-    rainbow (3.1.1)
     rake (13.4.2)
     rbs (4.0.2)
       logger
@@ -215,28 +202,12 @@ GEM
     regexp_parser (2.12.0)
     reline (0.6.3)
       io-console (~> 0.5)
-    rubocop (1.86.2)
-      json (~> 2.3)
-      language_server-protocol (~> 3.17.0.2)
-      lint_roller (~> 1.1.0)
-      parallel (>= 1.10)
-      parser (>= 3.3.0.2)
-      rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.49.0, < 2.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.49.1)
-      parser (>= 3.3.7.2)
-      prism (~> 1.7)
-    ruby-progressbar (1.13.0)
     rubyshell (1.5.0)
     rugged (1.9.0)
     samovar (2.4.1)
       console (~> 1.0)
       mapping (~> 1.0)
-    scampi (0.1.7)
-      colorize-extended
+    scampi (1.0.0)
     securerandom (0.4.1)
     shellwords (0.2.2)
     simpleidn (0.2.3)
@@ -249,9 +220,6 @@ GEM
     tsort (0.2.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (3.2.0)
-      unicode-emoji (~> 4.1)
-    unicode-emoji (4.2.0)
     uri (1.1.1)
     utopia (2.32.1)
       bake (~> 0.20)
@@ -290,7 +258,7 @@ DEPENDENCIES
   bake-releases
   kube_cluster!
   rake (~> 13.0)
-  rubocop (~> 1.21)
+  scampi (~> 1.0)
   utopia-project
 
 BUNDLED WITH

data/flake.nix

@@ -29,10 +29,11 @@
           ];
 
           shellHook = ''
-            export GEM_HOME="$HOME/.gem"
+            export GEM_HOME="$HOME/.gem-${ruby.version}"
             export GEM_PATH="$GEM_HOME"
             export PATH="$GEM_HOME/bin:$PATH"
             export BUNDLE_PATH="$GEM_HOME"
+            export BUNDLE_GEMFILE="$PWD/Gemfile"
             export BUNDLE_BIN="$GEM_HOME/bin"
             export KUBECONFIG="$PWD/kubeconfig.yaml"
           '';

data/kube_cluster.gemspec

@@ -28,12 +28,10 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "scampi", "~> 0.1"
-
   spec.add_development_dependency "rake", "~> 13.0"
-  spec.add_development_dependency "rubocop", "~> 1.21"
+  spec.add_development_dependency "scampi", "~> 1.0"
 
-  spec.add_dependency "kube_schema", "~> 1.9.1"
+  spec.add_dependency "kube_schema", "~> 1.9.2"
   spec.add_dependency "kube_kubectl", "~> 2.0"
   spec.add_dependency "activesupport", "~> 8.0"
 end

data/lib/kube/cluster/container.rb

@@ -10,24 +10,24 @@ module Kube
   end
 end
 
-test do
-  it "creates a valid container" do
-    c = Kube::Cluster::Container.new(name: "app", image: "nginx:1.27")
-    c.valid?.should.be.true
-    c.name.should == "app"
-  end
+__END__
+
+it "creates a valid container" do
+  c = Kube::Cluster::Container.new(name: "app", image: "nginx:1.27")
+  c.valid?.should.be.true
+  c.name.should == "app"
+end
 
-  it "auto-coerces inside a Deployment" do
-    c = Kube::Cluster::Container.new(name: "app", image: "nginx:1.27")
+it "auto-coerces inside a Deployment" do
+  c = Kube::Cluster::Container.new(name: "app", image: "nginx:1.27")
 
-    deploy = Kube::Cluster["Deployment"].new {
-      metadata.name = "web"
-      spec.replicas = 1
-      spec.selector.matchLabels = { app: "web" }
-      spec.template.metadata.labels = { app: "web" }
-      spec.template.spec.containers = [c]
-    }
+  deploy = Kube::Cluster["Deployment"].new {
+    metadata.name = "web"
+    spec.replicas = 1
+    spec.selector.matchLabels = { app: "web" }
+    spec.template.metadata.labels = { app: "web" }
+    spec.template.spec.containers = [c]
+  }
 
-    deploy.to_h[:spec][:template][:spec][:containers].first[:name].should == "app"
-  end
+  deploy.to_h[:spec][:template][:spec][:containers].first[:name].should == "app"
 end

data/lib/kube/cluster/manifest.rb

@@ -52,204 +52,204 @@ module Kube
   end
 end
 
-test do
-  Middleware = Kube::Cluster::Middleware
+__END__
 
-  # ── Bare manifest ────────────────────────────────────────────────────────
+Middleware = Kube::Cluster::Middleware
 
-  it "bare_manifest_enumerates_resources_unchanged" do
-    m = Kube::Cluster::Manifest.new
-    m << Kube::Cluster["ConfigMap"].new {
-      metadata.name = "test"
-      self.data = { key: "value" }
-    }
+# ── Bare manifest ────────────────────────────────────────────────────────
 
-    resources = m.to_a
-    resources.size.should == 1
-  end
+it "bare_manifest_enumerates_resources_unchanged" do
+  m = Kube::Cluster::Manifest.new
+  m << Kube::Cluster["ConfigMap"].new {
+    metadata.name = "test"
+    self.data = { key: "value" }
+  }
 
-  # ── Stack transforms resources ───────────────────────────────────────────
+  resources = m.to_a
+  resources.size.should == 1
+end
 
-  it "stack_transforms_resources" do
-    m = Kube::Cluster::Manifest.new
-    m << Kube::Cluster["ConfigMap"].new {
-      metadata.name = "test"
-    }
+# ── Stack transforms resources ───────────────────────────────────────────
 
-    stack = Middleware::Stack.new do
-      use Middleware::SetNamespace, "production"
-    end
-    stack.call(m)
+it "stack_transforms_resources" do
+  m = Kube::Cluster::Manifest.new
+  m << Kube::Cluster["ConfigMap"].new {
+    metadata.name = "test"
+  }
 
-    resources = m.to_a
-    resources.first.to_h.dig(:metadata, :namespace).should == "production"
+  stack = Middleware::Stack.new do
+    use Middleware::SetNamespace, "production"
   end
+  stack.call(m)
 
-  it "to_yaml_reflects_middleware" do
-    m = Kube::Cluster::Manifest.new
-    m << Kube::Cluster["ConfigMap"].new {
-      metadata.name = "test"
-    }
+  resources = m.to_a
+  resources.first.to_h.dig(:metadata, :namespace).should == "production"
+end
 
-    Middleware::SetNamespace.new("production").call(m)
+it "to_yaml_reflects_middleware" do
+  m = Kube::Cluster::Manifest.new
+  m << Kube::Cluster["ConfigMap"].new {
+    metadata.name = "test"
+  }
 
-    yaml = m.to_yaml
-    yaml.should.include "namespace: production"
-  end
+  Middleware::SetNamespace.new("production").call(m)
 
-  it "enumerable_methods_work" do
-    m = Kube::Cluster::Manifest.new
-    m << Kube::Cluster["ConfigMap"].new { metadata.name = "a" }
-    m << Kube::Cluster["ConfigMap"].new { metadata.name = "b" }
+  yaml = m.to_yaml
+  yaml.should.include "namespace: production"
+end
 
-    Middleware::SetNamespace.new("production").call(m)
+it "enumerable_methods_work" do
+  m = Kube::Cluster::Manifest.new
+  m << Kube::Cluster["ConfigMap"].new { metadata.name = "a" }
+  m << Kube::Cluster["ConfigMap"].new { metadata.name = "b" }
 
-    names = m.map { |r| r.to_h.dig(:metadata, :name) }
-    names.should == %w[a b]
-  end
+  Middleware::SetNamespace.new("production").call(m)
 
-  # ── Multi-middleware stack ──────────────────────────────────────────────
+  names = m.map { |r| r.to_h.dig(:metadata, :name) }
+  names.should == %w[a b]
+end
 
-  it "multiple_middleware_compose_in_order" do
-    m = Kube::Cluster::Manifest.new
-    m << Kube::Cluster["ConfigMap"].new {
-      metadata.name = "test"
-    }
+# ── Multi-middleware stack ──────────────────────────────────────────────
 
-    stack = Middleware::Stack.new do
-      use Middleware::SetNamespace, "staging"
-      use Middleware::Labels, app: "myapp", managed_by: "kube_cluster"
-    end
-    stack.call(m)
+it "multiple_middleware_compose_in_order" do
+  m = Kube::Cluster::Manifest.new
+  m << Kube::Cluster["ConfigMap"].new {
+    metadata.name = "test"
+  }
 
-    r = m.first
-    h = r.to_h
-
-    h.dig(:metadata, :namespace).should == "staging"
+  stack = Middleware::Stack.new do
+    use Middleware::SetNamespace, "staging"
+    use Middleware::Labels, app: "myapp", managed_by: "kube_cluster"
   end
+  stack.call(m)
 
-  # ── size reflects resource count ─────────────────────────────────────────
+  r = m.first
+  h = r.to_h
 
-  it "size_reflects_resource_count" do
-    m = Kube::Cluster::Manifest.new
-    m << Kube::Cluster["ConfigMap"].new { metadata.name = "a" }
-    m << Kube::Cluster["ConfigMap"].new { metadata.name = "b" }
+  h.dig(:metadata, :namespace).should == "staging"
+end
 
-    m.size.should == 2
-  end
+# ── size reflects resource count ─────────────────────────────────────────
 
-  # ── each without block ──────────────────────────────────────────────────
+it "size_reflects_resource_count" do
+  m = Kube::Cluster::Manifest.new
+  m << Kube::Cluster["ConfigMap"].new { metadata.name = "a" }
+  m << Kube::Cluster["ConfigMap"].new { metadata.name = "b" }
 
-  it "each_without_block_returns_enumerator" do
-    m = Kube::Cluster::Manifest.new
-    m << Kube::Cluster["ConfigMap"].new { metadata.name = "test" }
+  m.size.should == 2
+end
 
-    Middleware::SetNamespace.new("production").call(m)
+# ── each without block ──────────────────────────────────────────────────
 
-    enum = m.each
-    enum.should.be.instance_of Enumerator
-  end
+it "each_without_block_returns_enumerator" do
+  m = Kube::Cluster::Manifest.new
+  m << Kube::Cluster["ConfigMap"].new { metadata.name = "test" }
 
-  # ── Generative middleware produces new resources ─────────────────────────
-
-  it "generative_middleware_adds_service" do
-    m = Kube::Cluster::Manifest.new
-    m << Kube::Cluster["Deployment"].new {
-      metadata.name = "web"
-      metadata.namespace = "default"
-      spec.selector.matchLabels = { app: "web" }
-      spec.template.metadata.labels = { app: "web" }
-      spec.template.spec.containers = [
-        { name: "web", image: "nginx", ports: [{ name: "http", containerPort: 8080 }] },
-      ]
-    }
+  Middleware::SetNamespace.new("production").call(m)
 
-    Middleware::ServiceForDeployment.new.call(m)
+  enum = m.each
+  enum.should.be.instance_of Enumerator
+end
 
-    kinds = m.map { |r| r.to_h[:kind] }
-    kinds.should == %w[Deployment Service]
-  end
+# ── Generative middleware produces new resources ─────────────────────────
 
-  it "generative_middleware_does_not_affect_non_matching_resources" do
-    m = Kube::Cluster::Manifest.new
-    m << Kube::Cluster["ConfigMap"].new {
-      metadata.name = "config"
-    }
+it "generative_middleware_adds_service" do
+  m = Kube::Cluster::Manifest.new
+  m << Kube::Cluster["Deployment"].new {
+    metadata.name = "web"
+    metadata.namespace = "default"
+    spec.selector.matchLabels = { app: "web" }
+    spec.template.metadata.labels = { app: "web" }
+    spec.template.spec.containers = [
+      { name: "web", image: "nginx", ports: [{ name: "http", containerPort: 8080 }] },
+    ]
+  }
 
-    Middleware::ServiceForDeployment.new.call(m)
-
-    resources = m.to_a
-    resources.size.should == 1
-  end
+  Middleware::ServiceForDeployment.new.call(m)
 
-  # ── Generated resources flow through subsequent middleware stages ────────
-
-  it "generated_resources_flow_through_subsequent_stages" do
-    m = Kube::Cluster::Manifest.new
-    m << Kube::Cluster["Deployment"].new {
-      metadata.name = "web"
-      spec.selector.matchLabels = { app: "web" }
-      spec.template.metadata.labels = { app: "web" }
-      spec.template.spec.containers = [
-        { name: "web", image: "nginx", ports: [{ name: "http", containerPort: 8080 }] },
-      ]
-    }
+  kinds = m.map { |r| r.to_h[:kind] }
+  kinds.should == %w[Deployment Service]
+end
 
-    stack = Middleware::Stack.new do
-      use Middleware::ServiceForDeployment           # generates Service
-      use Middleware::SetNamespace, "production"         # namespaces everything
-      use Middleware::Labels, managed_by: "middleware" # labels everything
-    end
-    stack.call(m)
+it "generative_middleware_does_not_affect_non_matching_resources" do
+  m = Kube::Cluster::Manifest.new
+  m << Kube::Cluster["ConfigMap"].new {
+    metadata.name = "config"
+  }
 
-    resources = m.to_a
-    resources.size.should == 2
-  end
+  Middleware::ServiceForDeployment.new.call(m)
 
-  # ── YAML serializes integers correctly ──────────────────────────────────
-
-  it "to_yaml_serializes_integers_as_plain_values" do
-    m = Kube::Cluster::Manifest.new
-    m << Kube::Cluster["Deployment"].new {
-      metadata.name = "web"
-      spec.selector.matchLabels = { app: "web" }
-      spec.template.metadata.labels = { app: "web" }
-      spec.template.spec.containers = [
-        { name: "web", image: "nginx", ports: [{ name: "http", containerPort: 8080 }] },
-      ]
-    }
+  resources = m.to_a
+  resources.size.should == 1
+end
 
-    yaml = m.to_yaml
-    yaml.should.include "containerPort: 8080"
+# ── Generated resources flow through subsequent middleware stages ────────
+
+it "generated_resources_flow_through_subsequent_stages" do
+  m = Kube::Cluster::Manifest.new
+  m << Kube::Cluster["Deployment"].new {
+    metadata.name = "web"
+    spec.selector.matchLabels = { app: "web" }
+    spec.template.metadata.labels = { app: "web" }
+    spec.template.spec.containers = [
+      { name: "web", image: "nginx", ports: [{ name: "http", containerPort: 8080 }] },
+    ]
+  }
+
+  stack = Middleware::Stack.new do
+    use Middleware::ServiceForDeployment           # generates Service
+    use Middleware::SetNamespace, "production"         # namespaces everything
+    use Middleware::Labels, managed_by: "middleware" # labels everything
   end
+  stack.call(m)
 
-  # ── Multi-generative: chained generation ────────────────────────────────
-
-  it "chained_generative_middleware" do
-    m = Kube::Cluster::Manifest.new
-    m << Kube::Cluster["Deployment"].new {
-      metadata.name = "web"
-      metadata.namespace = "default"
-      metadata.labels = {
-        "app.kubernetes.io/expose":    "app.example.com",
-        "app.kubernetes.io/autoscale": "2-10",
-      }
-      spec.selector.matchLabels = { app: "web" }
-      spec.template.metadata.labels = { app: "web" }
-      spec.template.spec.containers = [
-        { name: "web", image: "nginx", ports: [{ name: "http", containerPort: 8080 }] },
-      ]
-    }
+  resources = m.to_a
+  resources.size.should == 2
+end
 
-    stack = Middleware::Stack.new do
-      use Middleware::ServiceForDeployment   # Deployment → +Service
-      use Middleware::IngressForService       # Service with expose label → +Ingress
-      use Middleware::HPAForDeployment        # Deployment with autoscale label → +HPA
-    end
-    stack.call(m)
+# ── YAML serializes integers correctly ──────────────────────────────────
+
+it "to_yaml_serializes_integers_as_plain_values" do
+  m = Kube::Cluster::Manifest.new
+  m << Kube::Cluster["Deployment"].new {
+    metadata.name = "web"
+    spec.selector.matchLabels = { app: "web" }
+    spec.template.metadata.labels = { app: "web" }
+    spec.template.spec.containers = [
+      { name: "web", image: "nginx", ports: [{ name: "http", containerPort: 8080 }] },
+    ]
+  }
+
+  yaml = m.to_yaml
+  yaml.should.include "containerPort: 8080"
+end
 
-    kinds = m.map { |r| r.to_h[:kind] }
+# ── Multi-generative: chained generation ────────────────────────────────
 
-    m.to_a.size.should == 4
+it "chained_generative_middleware" do
+  m = Kube::Cluster::Manifest.new
+  m << Kube::Cluster["Deployment"].new {
+    metadata.name = "web"
+    metadata.namespace = "default"
+    metadata.labels = {
+      "app.kubernetes.io/expose":    "app.example.com",
+      "app.kubernetes.io/autoscale": "2-10",
+    }
+    spec.selector.matchLabels = { app: "web" }
+    spec.template.metadata.labels = { app: "web" }
+    spec.template.spec.containers = [
+      { name: "web", image: "nginx", ports: [{ name: "http", containerPort: 8080 }] },
+    ]
+  }
+
+  stack = Middleware::Stack.new do
+    use Middleware::ServiceForDeployment   # Deployment → +Service
+    use Middleware::IngressForService       # Service with expose label → +Ingress
+    use Middleware::HPAForDeployment        # Deployment with autoscale label → +HPA
   end
+  stack.call(m)
+
+  kinds = m.map { |r| r.to_h[:kind] }
+
+  m.to_a.size.should == 4
 end