kube_schema 1.9.2 → 1.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff3fedb44c520fb2db66f16b3ae12b6b4fbe3d8a947e636da9c196fa9e80c529
-  data.tar.gz: ca30582966d7fa750b14ef69d935a24ea2532d1b9b5eb330df9b611d1894a675
+  metadata.gz: a6007594b371eeb36c26edde49a50c9ad8f4a2024784f4ef1add3eee59afaa8d
+  data.tar.gz: abb0766ced76224828aa5356bc52bcaffe738ce99a4bd6369458a1555b2f3579
 SHA512:
-  metadata.gz: 199d71dcee2dc211d5bc06a5d748e1019a2df409d7dbfc086d9b3c397c8f7c72ddc4143739e8418d366799e5ec3c5dafa46e693f09722aaf0c7ca8138633f588
-  data.tar.gz: cf5ed7f39324cdd202585edc0aa5b52825c746daee4776d2900d9dc4b2b4f353dd854d986100b61b2815c9949f3cedbfaa74696296f320ff07a08c3e7a8c86f4
+  metadata.gz: 61eb43c26cf34db4c66b078169f8b23d36db383b80eb337cd39f4b61c69c36604f6bcec08606d90496ca825b70c50875deb99105db198f81532d055501baf310
+  data.tar.gz: 05316b1722bb83a2e182ba39afe1c109b50e92fe0fcc5839d12aaa80649241e533c98d731a956181475799e57b9a30714f1e146eb01ce3207b785f889c1fcb10

data/CHANGELOG.md

@@ -0,0 +1,42 @@
+# Changelog
+
+All notable changes to this project are documented here.
+
+This file starts at 1.10.0; for earlier releases see the git history.
+
+## [1.11.0]
+
+### Added
+
+- `Kube::Schema.api_groups` and `Instance#api_groups` — every API group known
+  to the schema (built-in types, the merged CRD bundles, and schemas
+  registered via `.register`), sorted and deduplicated, with the core group
+  as `""`. Intended for consumers that need to distinguish group/resource
+  from core resource/subresource strings — e.g. building RBAC rules — without
+  hardcoding a group list.
+
+## [1.10.0]
+
+### Added
+
+- JuiceFS Operator schemas (`juicefs.io/v1`), from
+  [juicedata/juicefs-operator](https://github.com/juicedata/juicefs-operator)
+  v0.8.5: `CacheGroup`, `CronSync`, `Sync`, `WarmUp`.
+- Agent Sandbox schemas, picked up from upstream drift on an already-tracked
+  source: `Sandbox` (`agents.x-k8s.io/v1alpha1`), plus `SandboxClaim`,
+  `SandboxTemplate` and `SandboxWarmPool`
+  (`extensions.agents.x-k8s.io/v1alpha1`).
+- VictoriaMetrics `VLDistributed` (`operator.victoriametrics.com/v1alpha1`),
+  also from upstream drift.
+
+### Fixed
+
+- Pinned the Gateway API Inference CRD sources to v1.5.0. Upstream removed
+  `inferenceobjectives.yaml` and `inferencemodelrewrites.yaml` from `main`,
+  which broke schema generation and would otherwise have dropped those kinds.
+- Preserved the `metrics.k8s.io/v1beta1` definitions (`PodMetrics`,
+  `NodeMetrics`, their list types and `ContainerMetrics`) along with
+  `meta.v1.Duration`. Newer k3s images no longer surface the metrics-server
+  types in `/openapi/v2`, so regenerating the schemas silently dropped them.
+
+No definitions were removed in this release.

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    kube_schema (1.9.2)
+    kube_schema (1.11.0)
       json_schemer (~> 2.5.0)
       rubyshell (~> 1.5.0)
 
@@ -105,6 +105,7 @@ GEM
       hana (~> 1.3)
       regexp_parser (~> 2.0)
       simpleidn (~> 0.2)
+    lefthook (2.1.10)
     localhost (1.7.0)
     logger (1.7.0)
     mail (2.9.0)
@@ -229,6 +230,7 @@ DEPENDENCIES
   bake-modernize
   bake-releases
   kube_schema!
+  lefthook (~> 2.1)
   rake (~> 13.0)
   rspec (~> 3.13)
   utopia-project

data/flake.nix

@@ -18,18 +18,20 @@
           ];
 
           buildInputs = [
+            pkgs.trufflehog
             ruby
             pkgs.libyaml # psych gem
             pkgs.openssl # openssl gem
           ];
 
           shellHook = ''
-            export GEM_HOME="$HOME/.gem"
-            export GEM_PATH="$GEM_HOME"
-            export PATH="$GEM_HOME/bin:$PATH"
-            export BUNDLE_PATH="$GEM_HOME"
-            export BUNDLE_BIN="$GEM_HOME/bin"
-          '';
+          export GEM_HOME="$HOME/.gem-${ruby.version}"
+          export GEM_PATH="$GEM_HOME"
+          export PATH="$GEM_HOME/bin:$PATH"
+          export BUNDLE_GEMFILE="$PWD/Gemfile"
+          export BUNDLE_PATH="$GEM_HOME"
+          export BUNDLE_BIN="$GEM_HOME/bin"
+        '';
         };
       }
     );

data/kube_schema.gemspec

@@ -30,6 +30,7 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency "rspec", "~> 3.13"
   spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "lefthook", "~> 2.1"
 
   spec.add_dependency "rubyshell", "~> 1.5.0"
   spec.add_dependency "json_schemer", "~> 2.5.0"

data/lefthook.yml

@@ -0,0 +1,11 @@
+# Git hooks (managed by lefthook). Install with `bundle exec lefthook install`.
+#
+# pre-commit: scan for secrets (trufflehog) and run the test suite (bin/test).
+# Both are wrapped in `nix develop --command` because the hook fires outside the
+# flake devshell, so trufflehog / bundler / scampi wouldn't otherwise be on PATH.
+pre-commit:
+  commands:
+    secrets:
+      run: nix develop --command trufflehog git file://. --since-commit HEAD --only-verified --fail
+    tests:
+      run: nix develop --command bin/test

data/lib/kube/schema/instance.rb

@@ -102,6 +102,21 @@ module Kube
         (gvk_index.keys + custom_kinds).uniq.sort
       end
 
+      # All API groups known to this version, including any custom schemas
+      # registered via Kube::Schema.register. The core API group is the
+      # empty string.
+      #
+      #   instance.api_groups # => ["", "apps", "argoproj.io", "batch", ...]
+      #
+      # @return [Array<String>] sorted, deduplicated group names
+      def api_groups
+        custom_groups = Schema.custom_schemas.keys.filter_map do |key|
+          parts = key.split("/")
+          parts.first if parts.size == 3
+        end
+        (gvk_index.values.flatten.map { |entry| entry[:group] } + custom_groups).uniq.sort
+      end
+
       # Look up a sub-spec definition by short name (e.g. "Container",
       # "ContainerPort", "Volume", "Probe"). Returns a class that
       # inherits from Kube::Schema::SubSpec.
@@ -489,6 +504,32 @@ if __FILE__ == $0
       end
     end
 
+    describe "#api_groups" do
+      it "returns a sorted array of group names including the core group" do
+        groups = instance.api_groups
+        expect(groups).to be_an(Array)
+        expect(groups).to eq(groups.sort)
+        expect(groups).to include("")
+      end
+
+      it "includes built-in groups, including ones without dots" do
+        expect(instance.api_groups).to include("apps", "batch", "rbac.authorization.k8s.io")
+      end
+
+      it "includes groups from the merged CRD definition bundles" do
+        expect(instance.api_groups).to include("kubevirt.io", "argoproj.io")
+      end
+
+      it "includes groups from registered custom schemas" do
+        Kube::Schema.register("TenantVmClaim",
+          schema: { "type" => "object" },
+          api_version: "tradeportal.ai/v1")
+        expect(instance.api_groups).to include("tradeportal.ai")
+      ensure
+        Kube::Schema.reset_custom_schemas!
+      end
+    end
+
     describe "KubeVirt schemas" do
       it "resolves VirtualMachine" do
         klass = instance["VirtualMachine"]

data/lib/kube/schema/version.rb

@@ -2,6 +2,6 @@
 
 module Kube
   module Schema
-    VERSION = "1.9.2"
+    VERSION = "1.11.0"
   end
 end

data/lib/kube/schema.rb

@@ -160,6 +160,16 @@ module Kube
         schema_versions.last
       end
 
+      # All API groups known to the default schema version, including any
+      # custom schemas registered via .register. The core group is "".
+      #
+      #   Kube::Schema.api_groups # => ["", "apps", "argoproj.io", "batch", ...]
+      #
+      # @return [Array<String>] sorted, deduplicated group names
+      def api_groups
+        self[schema_version || DEFAULT_VERSION].api_groups
+      end
+
       def has_version?(version)
         schema_versions.include?(version)
       end
@@ -314,5 +324,15 @@ if __FILE__ == $0
         expect(Kube::Schema.has_version?("0.0.1")).to be false
       end
     end
+
+    describe ".api_groups" do
+      it "delegates to the default version's instance" do
+        expect(Kube::Schema.api_groups).to eq(Kube::Schema[Kube::Schema::DEFAULT_VERSION].api_groups)
+      end
+
+      it "includes core and built-in groups" do
+        expect(Kube::Schema.api_groups).to include("", "apps", "batch")
+      end
+    end
   end
 end