kube_schema 1.10.0 → 1.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95c2a3f8aa906bd8a40d43eedf4b209a4cdc83754c0ffe6a1b74a5c4aeab14c0
-  data.tar.gz: 0f14d9a60d65d003dd11b0f0f0f344f5f1ac9e3b8c5bf44fde3b489b8828bebc
+  metadata.gz: 7b5c93b3a4aa288687e6b1248f9a56040da8a1818668de9a4a6d6dd220ffd561
+  data.tar.gz: c9a224adc2270ae7551244939e9ce65ede7f96001fe0622e34bba0c3346b7d76
 SHA512:
-  metadata.gz: 1ae77de844bff9919b8a429202648f85c97ac6ad2c2f522be9602008cf2cec518bd1544bd6ab4de98f29dc7a76262293138286a33ec89e4a4d2063fbdcb769cf
-  data.tar.gz: 1ba74962b756416d428b793c3afb51847b1e3ce1b5366e4a089f0eac4614949fd1a1c8976c219b1e0adccda5ed3ae9da364b5d3848a7ca51bf27a68645fc6332
+  metadata.gz: f8a4978a52e7c7ecfba7de840202976a79359a319b9001bf1a1786ecf790533fc6c8ef5c047fd95e03b4b5523e57019960089ee9fa3f81becb85b221c1cb73cf
+  data.tar.gz: c5cc5671b5d85777f18140a7e71561e3d9a2e9ea82a21b9544578e1adaec3dc04277695eb6b8caf3ac624b8a4888126a7b1d0e28cbcf5acbe87846df35564b6e

data/CHANGELOG.md

@@ -4,6 +4,35 @@ All notable changes to this project are documented here.
 
 This file starts at 1.10.0; for earlier releases see the git history.
 
+## [1.12.0]
+
+### Added
+
+- Ruby pattern matching support. `Resource#deconstruct_keys` exposes `to_h`,
+  so resources match against hash patterns all the way down; `Manifest#deconstruct`
+  exposes the resource array, so manifests match against array patterns.
+
+      resource => {metadata: {name:}}
+
+      Deployment = Kube::Schema["Deployment"]
+      manifest => [Deployment => dep, *rest]
+
+  Note that `Kube::Schema["Deployment"]` cannot be written inline in a pattern:
+  Ruby parses `Const[...]` as array-pattern syntax, not a method call. Assign
+  the class to a constant, or use a pin expression —
+  `^(Kube::Schema["Deployment"])`.
+
+## [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.12.0)
       json_schemer (~> 2.5.0)
       rubyshell (~> 1.5.0)
 

data/flake.lock

@@ -1,23 +1,45 @@
 {
   "nodes": {
+    "mine": {
+      "inputs": {
+        "nixpkgs": [
+          "nixpkgs"
+        ],
+        "systems": "systems"
+      },
+      "locked": {
+        "lastModified": 1790556091,
+        "narHash": "sha256-+kgvg6vuaxjEUUad6pL+pxa3LZFveq3XvWGSZ+Z9gOA=",
+        "owner": "n-at-han-k",
+        "repo": "flake.nix",
+        "rev": "d023f40398596a5d80bf03e429c678a99b3f259a",
+        "type": "github"
+      },
+      "original": {
+        "owner": "n-at-han-k",
+        "repo": "flake.nix",
+        "type": "github"
+      }
+    },
     "nixpkgs": {
       "locked": {
-        "lastModified": 1776169885,
-        "narHash": "sha256-l/iNYDZ4bGOAFQY2q8y5OAfBBtrDAaPuRQqWaFHVRXM=",
+        "lastModified": 1780902259,
+        "narHash": "sha256-q8yYEC5f1mFlQO9RGna4LTc9QrcvWunX6FYp83munkQ=",
         "owner": "NixOS",
         "repo": "nixpkgs",
-        "rev": "4bd9165a9165d7b5e33ae57f3eecbcb28fb231c9",
+        "rev": "bd0ff2d3eac24699c3664d5966b9ef36f388e2ca",
         "type": "github"
       },
       "original": {
         "owner": "NixOS",
-        "ref": "nixos-unstable",
         "repo": "nixpkgs",
+        "rev": "bd0ff2d3eac24699c3664d5966b9ef36f388e2ca",
         "type": "github"
       }
     },
     "root": {
       "inputs": {
+        "mine": "mine",
         "nixpkgs": "nixpkgs",
         "utils": "utils"
       }
@@ -37,9 +59,24 @@
         "type": "github"
       }
     },
+    "systems_2": {
+      "locked": {
+        "lastModified": 1681028828,
+        "narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=",
+        "owner": "nix-systems",
+        "repo": "default",
+        "rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nix-systems",
+        "repo": "default",
+        "type": "github"
+      }
+    },
     "utils": {
       "inputs": {
-        "systems": "systems"
+        "systems": "systems_2"
       },
       "locked": {
         "lastModified": 1731533236,

data/flake.nix

@@ -2,38 +2,38 @@
   description = "Ruby gem flake";
 
   inputs = {
-    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
+    nixpkgs.url = "github:NixOS/nixpkgs/bd0ff2d3eac24699c3664d5966b9ef36f388e2ca"; # == this machine's system nixpkgs
     utils.url = "github:numtide/flake-utils";
+    mine.url = "github:n-at-han-k/flake.nix";
+    mine.inputs.nixpkgs.follows = "nixpkgs";
   };
-  outputs = { self, nixpkgs, utils }:
+  outputs = { self, nixpkgs, utils, mine }:
     utils.lib.eachDefaultSystem (system:
       let
+        # No mine.overlays.default: it overrides pkg-config, which stdenv
+        # splices, so the overlay rebuilds stdenv and all of nixpkgs from
+        # source. mine.inputs.nixpkgs.follows makes it redundant anyway.
         pkgs = nixpkgs.legacyPackages.${system};
-        ruby = pkgs.ruby_3_4; # Specify version
+        ruby = pkgs.ruby_3_4;
       in
       {
-        devShells.default = pkgs.mkShell {
-          nativeBuildInputs = [
-            pkgs.pkg-config # native extension discovery
-          ];
-
+        # pkg-config, bundix, libyaml, openssl, overmind, tmux and `bundix -l`
+        # come from mkRubyShell.
+        devShells.default = mine.lib.${system}.mkRubyShell {
           buildInputs = [
             pkgs.trufflehog
             ruby
-            pkgs.libyaml # psych gem
-            pkgs.openssl # openssl gem
           ];
 
           shellHook = ''
-          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"
-        '';
+            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/gemset.nix

@@ -0,0 +1,914 @@
+{
+  async = {
+    dependencies = ["console" "fiber-annotation" "io-event" "metrics" "traces"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1ah038cvb5k7vr29z5jkjhdwqpinrchglz87i1bv9fzjfc07666z";
+      type = "gem";
+    };
+    version = "2.39.0";
+  };
+  async-container = {
+    dependencies = ["async"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1g9lcawa16wjgq131ngczx54vdy4qqda3lqlh8iijlncnh5rapch";
+      type = "gem";
+    };
+    version = "0.34.5";
+  };
+  async-http = {
+    dependencies = ["async" "async-pool" "io-endpoint" "io-stream" "metrics" "protocol-http" "protocol-http1" "protocol-http2" "protocol-url" "traces"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1ajlaxwssid5lczzmfl8gk2z20d0pnfglsw53qfy8j2s4nmqq4h8";
+      type = "gem";
+    };
+    version = "0.95.0";
+  };
+  async-http-cache = {
+    dependencies = ["async-http"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1mnzzlq0bnya0hlzrz0bl66r7qw5a3173cjd1fsicbqqjgqd2f10";
+      type = "gem";
+    };
+    version = "0.4.6";
+  };
+  async-ollama = {
+    dependencies = ["async" "async-rest"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1myl413dynl0z0rwmf3sswly9yamz5ysk8nwb3wm2230ljdlqp0h";
+      type = "gem";
+    };
+    version = "0.10.3";
+  };
+  async-pool = {
+    dependencies = ["async"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1vg3lwb3yhq0rad3dm00vp35vrahkbxgl4kx3d2rqkdh09xs2hqa";
+      type = "gem";
+    };
+    version = "0.11.2";
+  };
+  async-rest = {
+    dependencies = ["async-http" "protocol-url"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1swmgq79knydk05ylkhv43x4l6yqyclbh4pwchxaasajyrkx9c3j";
+      type = "gem";
+    };
+    version = "0.20.0";
+  };
+  async-service = {
+    dependencies = ["async" "async-container" "string-format"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0q9vwq9iidm7426s23dz90as44cqygp9f82ck4px8m2n2j468qc4";
+      type = "gem";
+    };
+    version = "0.22.0";
+  };
+  async-utilization = {
+    dependencies = ["console"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1d7k3nrmzi3gwlv1z9g3pb72f3j2bszfr8019b0kzqlgjkh2f6i0";
+      type = "gem";
+    };
+    version = "0.3.2";
+  };
+  bake = {
+    dependencies = ["bigdecimal" "samovar"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1izlqnz0828mgdq04s1w291ky912w6jzcg5iwch7gc8l2pkcgylb";
+      type = "gem";
+    };
+    version = "0.24.1";
+  };
+  bake-gem = {
+    dependencies = ["console"];
+    groups = ["maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "14qvrxrcy1g6as6nbcs7di20kvzx46yw0bwczjaa3v6p8dil2p27";
+      type = "gem";
+    };
+    version = "0.13.1";
+  };
+  bake-modernize = {
+    dependencies = ["async-http" "async-ollama" "bake" "build-files" "markly" "rugged"];
+    groups = ["maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "069gic0y7klh0wixf9q3gpqg0xhf2s1i6qx005pwfyha8daccbbb";
+      type = "gem";
+    };
+    version = "0.54.1";
+  };
+  bake-releases = {
+    dependencies = ["bake" "markly"];
+    groups = ["maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1q1kwrxfv9z4l7c94kid52z15jiqvg1snmr9qdrh7p91l5qwm4pn";
+      type = "gem";
+    };
+    version = "0.5.4";
+  };
+  bigdecimal = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1g9zi8c4i7g8zz0c3hxrw6mblrjvgn7akys60clb9si7c1k1gljk";
+      type = "gem";
+    };
+    version = "4.1.2";
+  };
+  build-files = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1g9p6dhnycc2649fd2pi5jzklyqn2cjbvggccqkjqgalajf971hh";
+      type = "gem";
+    };
+    version = "1.10.2";
+  };
+  concurrent-ruby = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1aymcakhzl83k77g2f2krz07bg1cbafbcd2ghvwr4lky3rz86mkb";
+      type = "gem";
+    };
+    version = "1.3.6";
+  };
+  console = {
+    dependencies = ["fiber-annotation" "fiber-local" "json"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1k0dxi072mz8j72r32kkzpky825hn092hb8hdxh4rz3yd5sbv7w6";
+      type = "gem";
+    };
+    version = "1.34.3";
+  };
+  date = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1h0db8r2v5llxdbzkzyllkfniqw9gm092qn7cbaib73v9lw0c3bm";
+      type = "gem";
+    };
+    version = "3.5.1";
+  };
+  decode = {
+    dependencies = ["prism" "rbs"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0mp1ha7sg6l6f5dqwidxwnpm7lj7my5vsxwz7nlnpg7lqsj0fnvb";
+      type = "gem";
+    };
+    version = "0.27.0";
+  };
+  diff-lcs = {
+    groups = ["default" "development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0qlrj2qyysc9avzlr4zs1py3x684hqm61n4czrsk1pyllz5x5q4s";
+      type = "gem";
+    };
+    version = "1.6.2";
+  };
+  erb = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1ncmbdjf2bwmk0jf5cxywns9zbxyfiy4h4p3pzi7yddyjhv81qrq";
+      type = "gem";
+    };
+    version = "6.0.4";
+  };
+  falcon = {
+    dependencies = ["async" "async-container" "async-http" "async-http-cache" "async-service" "async-utilization" "localhost" "openssl" "protocol-http" "protocol-rack" "samovar"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0fwp7i3f9gvsg0qyn33i522fvj0gh1w25byq1plv4jsmwfnbv1q2";
+      type = "gem";
+    };
+    version = "0.55.3";
+  };
+  fiber-annotation = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "00vcmynyvhny8n4p799rrhcx0m033hivy0s1gn30ix8rs7qsvgvs";
+      type = "gem";
+    };
+    version = "0.2.0";
+  };
+  fiber-local = {
+    dependencies = ["fiber-storage"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "01lz929qf3xa90vra1ai1kh059kf2c8xarfy6xbv1f8g457zk1f8";
+      type = "gem";
+    };
+    version = "1.1.0";
+  };
+  fiber-storage = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1qa0j9qjwav9xb0n3isx0rbh0942xrfback392n6vs8bidnmp3pl";
+      type = "gem";
+    };
+    version = "1.0.1";
+  };
+  hana = {
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "03cvrv2wl25j9n4n509hjvqnmwa60k92j741b64a1zjisr1dn9al";
+      type = "gem";
+    };
+    version = "1.3.7";
+  };
+  http-accept = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "03shmn4nn1cwqwhjfii2ad7gz7s4481b5ipmalsy90pp43nisj7q";
+      type = "gem";
+    };
+    version = "2.2.1";
+  };
+  io-console = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1k0lk3pwadm2myvpg893n8jshmrf2sigrd4ki15lymy7gixaxqyn";
+      type = "gem";
+    };
+    version = "0.8.2";
+  };
+  io-endpoint = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0f1kzf4d5qgqgfjh52a8pf3pii5dmav6ib0zq4wmicqnq5kggsiz";
+      type = "gem";
+    };
+    version = "0.17.2";
+  };
+  io-event = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1k1hkgjjnxa9xa023904n9diyirm5x4z92sm7zb1ah15937wsi66";
+      type = "gem";
+    };
+    version = "1.15.1";
+  };
+  io-stream = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0dhnkjf59ayw5xi873a939i63d47lrlqcpphvv73xprb635vq96f";
+      type = "gem";
+    };
+    version = "0.13.0";
+  };
+  irb = {
+    dependencies = ["pp" "prism" "rdoc" "reline"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1qs8a9vprg7s8krgq4s0pygr91hclqqyz98ik15p0m1sf2h5956y";
+      type = "gem";
+    };
+    version = "1.18.0";
+  };
+  json = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0il6qxkxqql7n7sgrws5bi5a36v51dswqcxb6j6gm8aj62shp6r8";
+      type = "gem";
+    };
+    version = "2.19.3";
+  };
+  json_schemer = {
+    dependencies = ["bigdecimal" "hana" "regexp_parser" "simpleidn"];
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "15p31bq932bfpsi1wgrkgwm71l7z1h1w53q6vl44w6kjrr6gn09g";
+      type = "gem";
+    };
+    version = "2.5.0";
+  };
+  kube_schema = {
+    dependencies = ["json_schemer" "rubyshell"];
+    groups = ["default"];
+    platforms = [];
+    source = {
+      path = ./.;
+      type = "path";
+    };
+    version = "1.11.0";
+  };
+  lefthook = {
+    groups = ["development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0r8vwq96i3wfsb3c2q0qjl3nssadwmlrgavf06wfi2d6isyhd76c";
+      type = "gem";
+    };
+    version = "2.1.10";
+  };
+  localhost = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0zslqi1xj21pzlm4lr7gnq0p8lb2n7x9bid7y36lr4bzaccjicq9";
+      type = "gem";
+    };
+    version = "1.7.0";
+  };
+  logger = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "00q2zznygpbls8asz5knjvvj2brr3ghmqxgr83xnrdj4rk3xwvhr";
+      type = "gem";
+    };
+    version = "1.7.0";
+  };
+  mail = {
+    dependencies = ["logger" "mini_mime" "net-imap" "net-pop" "net-smtp"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0ha9sgkfqna62c1basc17dkx91yk7ppgjq32k4nhrikirlz6g9kg";
+      type = "gem";
+    };
+    version = "2.9.0";
+  };
+  mapping = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "18jdbz3x6cvprhsw7jiv44xi6wklric0rq6iznm6xm7c40fr6x12";
+      type = "gem";
+    };
+    version = "1.1.3";
+  };
+  markly = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "04ammhfwf91r7kh7iiz6kw1mjql250bchx0z2yggq7jv72gdfw3g";
+      type = "gem";
+    };
+    version = "0.16.0";
+  };
+  metrics = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0wlh0g4xmfqa41dsh4m3514q3jcvy6jx97mwn6ayj62ir6xdbpk1";
+      type = "gem";
+    };
+    version = "0.15.0";
+  };
+  mime-types = {
+    dependencies = ["logger" "mime-types-data"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0mjyxl7c0xzyqdqa8r45hqg7jcw2prp3hkp39mdf223g4hfgdsyw";
+      type = "gem";
+    };
+    version = "3.7.0";
+  };
+  mime-types-data = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1k28j6ww8rf43r5i8278jvm2cq3pnzsvqm7yqpb4p93kadjlq726";
+      type = "gem";
+    };
+    version = "3.2026.0414";
+  };
+  mini_mime = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1vycif7pjzkr29mfk4dlqv3disc5dn0va04lkwajlpr1wkibg0c6";
+      type = "gem";
+    };
+    version = "1.1.5";
+  };
+  msgpack = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0cnpnbn2yivj9gxkh8mjklbgnpx6nf7b8j2hky01dl0040hy0k76";
+      type = "gem";
+    };
+    version = "1.8.0";
+  };
+  net-imap = {
+    dependencies = ["date" "net-protocol"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0ax0f0r97jm83q462vsrcbdxprs894fyyc44v62c48ihgb39hmcs";
+      type = "gem";
+    };
+    version = "0.6.4";
+  };
+  net-pop = {
+    dependencies = ["net-protocol"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1wyz41jd4zpjn0v1xsf9j778qx1vfrl24yc20cpmph8k42c4x2w4";
+      type = "gem";
+    };
+    version = "0.1.2";
+  };
+  net-protocol = {
+    dependencies = ["timeout"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1a32l4x73hz200cm587bc29q8q9az278syw3x6fkc9d1lv5y0wxa";
+      type = "gem";
+    };
+    version = "0.2.2";
+  };
+  net-smtp = {
+    dependencies = ["net-protocol"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0dh7nzjp0fiaqq1jz90nv4nxhc2w359d7c199gmzq965cfps15pd";
+      type = "gem";
+    };
+    version = "0.5.1";
+  };
+  openssl = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0zazkk5q3p2ldd23ka04wypsz2g8gqwwainf3d58j0kvdc9p8yg2";
+      type = "gem";
+    };
+    version = "4.0.1";
+  };
+  pp = {
+    dependencies = ["prettyprint"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1xlxmg86k5kifci1xvlmgw56x88dmqf04zfzn7zcr4qb8ladal99";
+      type = "gem";
+    };
+    version = "0.6.3";
+  };
+  prettyprint = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "14zicq3plqi217w6xahv7b8f7aj5kpxv1j1w98344ix9h5ay3j9b";
+      type = "gem";
+    };
+    version = "0.2.0";
+  };
+  prism = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "11ggfikcs1lv17nhmhqyyp6z8nq5pkfcj6a904047hljkxm0qlvv";
+      type = "gem";
+    };
+    version = "1.9.0";
+  };
+  protocol-hpack = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "14ddqg5mcs9ysd1hdzkm5pwil0660vrxcxsn576s3387p0wa5v3g";
+      type = "gem";
+    };
+    version = "1.5.1";
+  };
+  protocol-http = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0fvpza7nnbyd3nfxkn5gych6diwns386g2ib9s6azh99c3sz5hg1";
+      type = "gem";
+    };
+    version = "0.62.2";
+  };
+  protocol-http1 = {
+    dependencies = ["protocol-http"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1syqgaklsn9rf11xmll2s3ms7jvpd5zjng9jdb3r8pbgv963z6z4";
+      type = "gem";
+    };
+    version = "0.39.0";
+  };
+  protocol-http2 = {
+    dependencies = ["protocol-hpack" "protocol-http"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "11kl6768hpzgvvvlpyvmr74v0jqf2vslcwngs3643cl2h3brrj5s";
+      type = "gem";
+    };
+    version = "0.26.0";
+  };
+  protocol-rack = {
+    dependencies = ["io-stream" "protocol-http" "rack"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1hwz5bb3wcx4lkprigsgfa4vqlx33jcxc01pc2d89ybyj92x518i";
+      type = "gem";
+    };
+    version = "0.22.1";
+  };
+  protocol-url = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1qd9vsn9sif58swfqsyj429aynqyv6hpgbzxqrd83baidcxw1m34";
+      type = "gem";
+    };
+    version = "0.4.0";
+  };
+  psych = {
+    dependencies = ["date" "stringio"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0x0r3gc66abv8i4dw0x0370b5hrshjfp6kpp7wbp178cy775fypb";
+      type = "gem";
+    };
+    version = "5.3.1";
+  };
+  rack = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1hhjy9gcp52dzij05gmidqac8g28ski5xm67prwmdqmjfcgqxmsy";
+      type = "gem";
+    };
+    version = "3.2.6";
+  };
+  rackula = {
+    dependencies = ["falcon" "samovar" "variant"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0qdv10k36c3qmfpv6321in5k7x9xgpm55h25d0q8hbb5ph74p0j6";
+      type = "gem";
+    };
+    version = "1.4.1";
+  };
+  rake = {
+    groups = ["development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "009p524zl0p0kfa65nii8wdmaigkmawv9pbvlcffky7islmmp0nb";
+      type = "gem";
+    };
+    version = "13.4.2";
+  };
+  rbs = {
+    dependencies = ["logger" "prism" "tsort"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "09ggg2zk0qrh0mc3fa23xjbn2gzqxd0jfqj6qm6460ydcqg6fxdg";
+      type = "gem";
+    };
+    version = "4.0.2";
+  };
+  rdoc = {
+    dependencies = ["erb" "psych" "tsort"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "14iiyb4yi1chdzrynrk74xbhmikml3ixgdayjma3p700singfl46";
+      type = "gem";
+    };
+    version = "7.2.0";
+  };
+  regexp_parser = {
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1fwfw26a32rps78920nn29shqg2zmqv72i89j1fap41isshida9m";
+      type = "gem";
+    };
+    version = "2.12.0";
+  };
+  reline = {
+    dependencies = ["io-console"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0d8q5c4nh2g9pp758kizh8sfrvngynrjlm0i1zn3cnsnfd4v160i";
+      type = "gem";
+    };
+    version = "0.6.3";
+  };
+  rspec = {
+    dependencies = ["rspec-core" "rspec-expectations" "rspec-mocks"];
+    groups = ["development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "11q5hagj6vr694innqj4r45jrm8qcwvkxjnphqgyd66piah88qi0";
+      type = "gem";
+    };
+    version = "3.13.2";
+  };
+  rspec-core = {
+    dependencies = ["rspec-support"];
+    groups = ["default" "development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0bcbh9yv6cs6pv299zs4bvalr8yxa51kcdd1pjl60yv625j3r0m8";
+      type = "gem";
+    };
+    version = "3.13.6";
+  };
+  rspec-expectations = {
+    dependencies = ["diff-lcs" "rspec-support"];
+    groups = ["default" "development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0dl8npj0jfpy31bxi6syc7jymyd861q277sfr6jawq2hv6hx791k";
+      type = "gem";
+    };
+    version = "3.13.5";
+  };
+  rspec-mocks = {
+    dependencies = ["diff-lcs" "rspec-support"];
+    groups = ["default" "development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0iqxmw0knjiz5nf6pgr8ihs6cjzh89f0ppj3fqiz8cvms79x6sh8";
+      type = "gem";
+    };
+    version = "3.13.8";
+  };
+  rspec-support = {
+    groups = ["default" "development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0z64h5rznm2zv21vjdjshz4v0h7bxvg02yc6g7yzxakj11byah06";
+      type = "gem";
+    };
+    version = "3.13.7";
+  };
+  rubyshell = {
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1dkaj6a038m23r2xph0k2jc03i6aq8xzqmf17qpjprb2b50jimgz";
+      type = "gem";
+    };
+    version = "1.5.0";
+  };
+  rugged = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1b7gcf6pxg4x607bica68dbz22b4kch33yi0ils6x3c8ql9akakz";
+      type = "gem";
+    };
+    version = "1.9.0";
+  };
+  samovar = {
+    dependencies = ["console" "mapping"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "104y60zqn1mznv1smbzzvhljam193w8w2886c2yf6w87b381vff3";
+      type = "gem";
+    };
+    version = "2.4.1";
+  };
+  simpleidn = {
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0a9c1mdy12y81ck7mcn9f9i2s2wwzjh1nr92ps354q517zq9dkh8";
+      type = "gem";
+    };
+    version = "0.2.3";
+  };
+  string-format = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1xlsg0m748bcb4vgvmjxlfsif6nnl8pz6ja52c91y1kb24a1r65w";
+      type = "gem";
+    };
+    version = "0.2.0";
+  };
+  stringio = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1q92y9627yisykyscv0bdsrrgyaajc2qr56dwlzx7ysgigjv4z63";
+      type = "gem";
+    };
+    version = "3.2.0";
+  };
+  thread-local = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1ryjgfwcsbkxph1l24x87p1yabnnbqy958s57w37iwhf3z9nid9g";
+      type = "gem";
+    };
+    version = "1.1.0";
+  };
+  timeout = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1jxcji88mh6xsqz0mfzwnxczpg7cyniph7wpavnavfz7lxl77xbq";
+      type = "gem";
+    };
+    version = "0.6.1";
+  };
+  traces = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "05722prvh34n96irnxa762wz0yj2nyrz70ab2zby3b6snjf69wc0";
+      type = "gem";
+    };
+    version = "0.18.2";
+  };
+  tsort = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "17q8h020dw73wjmql50lqw5ddsngg67jfw8ncjv476l5ys9sfl4n";
+      type = "gem";
+    };
+    version = "0.2.0";
+  };
+  utopia = {
+    dependencies = ["bake" "concurrent-ruby" "console" "http-accept" "irb" "mail" "mime-types" "msgpack" "net-smtp" "protocol-url" "rack" "samovar" "traces" "variant" "xrb"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0d6njl2lw3j68nd34wm6szr7yk8h2xq6a15b1sv8r49rpcddi3l8";
+      type = "gem";
+    };
+    version = "2.32.1";
+  };
+  utopia-project = {
+    dependencies = ["decode" "falcon" "markly" "rackula" "thread-local" "utopia"];
+    groups = ["maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0j4jq3b9y6mly85s16yy6alrlyydzinylh4zly9v7y2bwd2y5604";
+      type = "gem";
+    };
+    version = "0.40.0";
+  };
+  variant = {
+    dependencies = ["thread-local"];
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0mizrq6819baz3s0zqwb5qz2dx21k3d0kav6alrcn14kvkfqzssk";
+      type = "gem";
+    };
+    version = "0.1.1";
+  };
+  xrb = {
+    groups = ["default" "maintenance"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0w08kwxw9yll1p2sn2fhczzwgnx6q79ybl1xvkivnn3vig6jls0y";
+      type = "gem";
+    };
+    version = "0.11.2";
+  };
+}

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/manifest.rb

@@ -86,6 +86,9 @@ module Kube
         @resources.dup
       end
 
+      # Ruby pattern matching: `manifest => [Kube::Cluster["Deployment"], *]`.
+      def deconstruct = to_a
+
       # -------------------------------------------------------------------
       # File I/O
       # -------------------------------------------------------------------
@@ -298,6 +301,21 @@ if __FILE__ == $0
       end
     end
 
+    describe "pattern matching" do
+      it "destructures into an array of resources" do
+        manifest = described_class.new(resource_a, resource_b)
+        manifest => [Kube::Schema::Resource => first, *rest]
+
+        expect(first).to eq(resource_a)
+        expect(rest).to eq([resource_b])
+      end
+
+      it "enforces arity" do
+        manifest = described_class.new(resource_a, resource_b)
+        expect { manifest => [Kube::Schema::Resource] }.to raise_error(NoMatchingPatternError)
+      end
+    end
+
     describe "#to_a" do
       it "returns a copy of the internal resources array" do
         manifest = described_class.new(resource_a, resource_b)

data/lib/kube/schema/resource.rb

@@ -101,6 +101,11 @@ module Kube
         other.is_a?(Resource) && to_h == other.to_h
       end
 
+      # Ruby pattern matching: `resource => {metadata: {name:}}`.
+      # to_h is already plain nested symbol-keyed Hashes, so nested
+      # patterns work all the way down for free.
+      def deconstruct_keys(keys) = to_h
+
       private
 
         def deep_compact(obj)
@@ -219,6 +224,20 @@ if __FILE__ == $0
       end
     end
 
+    describe "pattern matching" do
+      it "destructures nested keys" do
+        resource = Kube::Schema["Deployment"].new { metadata.name = "web" }
+        resource => {kind: "Deployment", metadata: {name: String => name}}
+
+        expect(name).to eq("web")
+      end
+
+      it "does not match when a nested value differs" do
+        resource = Kube::Schema["Deployment"].new { metadata.name = "web" }
+        expect { resource => {metadata: {name: "other"}} }.to raise_error(NoMatchingPatternError)
+      end
+    end
+
     describe "#==" do
       it "considers two resources equal when their data matches" do
         a = Kube::Schema["Pod"].new
@@ -522,6 +541,28 @@ if __FILE__ == $0
       end
     end
 
+    describe "pattern matching" do
+      let(:deployment) do
+        Kube::Schema["Deployment"].new {
+          metadata.name = "some-resource"
+          metadata.namespace = "prod"
+        }
+      end
+
+      it "destructures with a nested hash pattern" do
+        deployment => {kind: String => kind, metadata: {name:, namespace:}}
+        expect([kind, name, namespace]).to eq(["Deployment", "some-resource", "prod"])
+      end
+
+      it "matches in a case/in" do
+        matched = case deployment
+                  in {metadata: {name: "some-resource"}} then true
+                  else false
+                  end
+        expect(matched).to be true
+      end
+    end
+
     describe "instantiation via Instance lookup" do
       let(:klass) { Kube::Schema["Deployment"] }
 

data/lib/kube/schema/version.rb

@@ -2,6 +2,6 @@
 
 module Kube
   module Schema
-    VERSION = "1.10.0"
+    VERSION = "1.12.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.12.0
 platform: ruby
 authors:
 - Nathan K
@@ -120,6 +120,7 @@ files:
 - examples/vcluster.rb
 - flake.lock
 - flake.nix
+- gemset.nix
 - guides/block-dsl/readme.md
 - guides/getting-started/readme.md
 - guides/links.yaml