kube_schema 1.10.0 → 1.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95c2a3f8aa906bd8a40d43eedf4b209a4cdc83754c0ffe6a1b74a5c4aeab14c0
-  data.tar.gz: 0f14d9a60d65d003dd11b0f0f0f344f5f1ac9e3b8c5bf44fde3b489b8828bebc
+  metadata.gz: a6007594b371eeb36c26edde49a50c9ad8f4a2024784f4ef1add3eee59afaa8d
+  data.tar.gz: abb0766ced76224828aa5356bc52bcaffe738ce99a4bd6369458a1555b2f3579
 SHA512:
-  metadata.gz: 1ae77de844bff9919b8a429202648f85c97ac6ad2c2f522be9602008cf2cec518bd1544bd6ab4de98f29dc7a76262293138286a33ec89e4a4d2063fbdcb769cf
-  data.tar.gz: 1ba74962b756416d428b793c3afb51847b1e3ce1b5366e4a089f0eac4614949fd1a1c8976c219b1e0adccda5ed3ae9da364b5d3848a7ca51bf27a68645fc6332
+  metadata.gz: 61eb43c26cf34db4c66b078169f8b23d36db383b80eb337cd39f4b61c69c36604f6bcec08606d90496ca825b70c50875deb99105db198f81532d055501baf310
+  data.tar.gz: 05316b1722bb83a2e182ba39afe1c109b50e92fe0fcc5839d12aaa80649241e533c98d731a956181475799e57b9a30714f1e146eb01ce3207b785f889c1fcb10

data/CHANGELOG.md

@@ -4,6 +4,17 @@ 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

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    kube_schema (1.10.0)
+    kube_schema (1.11.0)
       json_schemer (~> 2.5.0)
       rubyshell (~> 1.5.0)
 

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.10.0"
+    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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kube_schema
 version: !ruby/object:Gem::Version
-  version: 1.10.0
+  version: 1.11.0
 platform: ruby
 authors:
 - Nathan K