metatron 0.11.2 → 0.11.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 172d36a4cdb46cbfce74e2f31002c3b6706b1ff9a328d6b44dc919c444d8bed3
-  data.tar.gz: 8ebd13c4d65b6b2f07eab819a3ba7ed2d50dbfc63f2b83fcaafe642bdf51b7cd
+  metadata.gz: a46bbee8fe39f8373f5ec65dd4142bd490117024d18190db8092a10f2da64072
+  data.tar.gz: 3959470b07cf923a6df1fe5060b86bc8378016a9ce43590d07e3e9c7e691ba38
 SHA512:
-  metadata.gz: bca6a3fbe34796dfbf322222f0f10b02cd31a33a99940a6e11789ea01066df8ea1f13701a91a2bae6918b3e5cb8f89ba3d0e768d711fb9dba7205a46b905b8b9
-  data.tar.gz: 62e5d5740817bf1767d2eab44309cf5ced41380dcd8ad1015ff89ce3ebc1bf9d7dc5debd3ffba15d5fa5f312edebddb6f979203954bb22eee8f93b87cbfc746c
+  metadata.gz: 873d6df9d70638d47ccd3564ec8b56da41d7fefe3fdb72e99b806c27645f91321d34840c98c805584f2e257bf4bbedae4ab38d1c28a8c7b022ef09fe89e74768
+  data.tar.gz: 42a596702fdf60d0db2514f02b85681ea542fbe5899284e59899954ccce06751501397e4e99b960396697f1f1b1cbeec48f86bf8abeead91d3c77bbfb923feb0

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.11.2"
+  ".": "0.11.3"
 }

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.11.3](https://github.com/jgnagy/metatron/compare/metatron/v0.11.2...metatron/v0.11.3) (2026-02-27)
+
+
+### Features
+
+* add Gateway API resource templates (closes [#92](https://github.com/jgnagy/metatron/issues/92)) ([9820f78](https://github.com/jgnagy/metatron/commit/9820f786dfeff6148d6e5c81e46c628d8f5ca697))
+
 ## [0.11.2](https://github.com/jgnagy/metatron/compare/metatron/v0.11.1...metatron/v0.11.2) (2025-06-18)
 
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    metatron (0.11.2)
+    metatron (0.11.3)
       base64
       json (~> 2.6)
       rack (>= 2.2.8, < 4)
@@ -25,9 +25,9 @@ GEM
     language_server-protocol (3.17.0.4)
     lint_roller (1.1.0)
     logger (1.6.6)
-    nokogiri (1.18.8-arm64-darwin)
+    nokogiri (1.18.9-arm64-darwin)
       racc (~> 1.4)
-    nokogiri (1.18.8-x86_64-linux-gnu)
+    nokogiri (1.18.9-x86_64-linux-gnu)
       racc (~> 1.4)
     observer (0.1.2)
     ostruct (0.6.1)
@@ -36,7 +36,7 @@ GEM
       ast (~> 2.4.1)
       racc
     racc (1.8.1)
-    rack (3.1.16)
+    rack (3.1.18)
     rack-test (2.2.0)
       rack (>= 1.3)
     rainbow (3.1.1)
@@ -46,7 +46,7 @@ GEM
     regexp_parser (2.10.0)
     reverse_markdown (3.0.0)
       nokogiri
-    rexml (3.4.1)
+    rexml (3.4.2)
     rspec (3.13.0)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)

data/lib/metatron/templates/concerns/route_resource.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Metatron
+  module Templates
+    module Concerns
+      # Provides common parent reference functionality for Gateway API route resources
+      module RouteResource
+        def self.included(base)
+          base.class_eval do
+            attr_reader :parent_refs
+
+            initializer :route_resource_initialize
+          end
+        end
+
+        def route_resource_initialize
+          @parent_refs = []
+        end
+
+        def add_parent_ref(name:, namespace: nil, kind: "Gateway", section_name: nil, port: nil)
+          ref = { name:, kind: }
+          ref[:namespace] = namespace if namespace
+          ref[:sectionName] = section_name if section_name
+          ref[:port] = port if port
+          @parent_refs << ref
+        end
+
+        def formatted_parent_refs
+          parent_refs.empty? ? {} : { parentRefs: parent_refs }
+        end
+      end
+    end
+  end
+end

data/lib/metatron/templates/gateway/listener.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Metatron
+  module Templates
+    class Gateway
+      # Internal model for a Gateway listener
+      class Listener
+        attr_accessor :name, :port, :protocol, :hostname, :tls, :allowed_routes
+
+        def initialize(name, port:, protocol:, hostname: nil, tls: nil, allowed_routes: nil)
+          @name = name
+          @port = port
+          @protocol = protocol
+          @hostname = hostname
+          @tls = tls
+          @allowed_routes = allowed_routes
+        end
+
+        def render
+          { name:, port:, protocol: }
+            .merge(hostname ? { hostname: } : {})
+            .merge(tls ? { tls: } : {})
+            .merge(allowed_routes ? { allowedRoutes: allowed_routes } : {})
+        end
+      end
+    end
+  end
+end

data/lib/metatron/templates/gateway.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Metatron
+  module Templates
+    # Template for Gateway k8s resource (Gateway API)
+    class Gateway < Template
+      include Concerns::Annotated
+      include Concerns::Namespaced
+
+      attr_accessor :gateway_class_name, :additional_labels
+      attr_reader :listeners
+
+      def initialize(name, gateway_class_name:)
+        super(name)
+        @gateway_class_name = gateway_class_name
+        @api_version = "gateway.networking.k8s.io/v1"
+        @additional_labels = {}
+        @listeners = []
+      end
+
+      def add_listener(listener = nil, **attrs)
+        @listeners << if listener.is_a?(Listener)
+                        listener
+                      else
+                        Listener.new(attrs.delete(:name), **attrs)
+                      end
+      end
+
+      def render
+        {
+          apiVersion:,
+          kind:,
+          metadata: {
+            name:,
+            labels: base_labels.merge(additional_labels)
+          }.merge(formatted_annotations).merge(formatted_namespace),
+          spec: {
+            gatewayClassName: gateway_class_name,
+            listeners: listeners.map(&:render)
+          }
+        }
+      end
+    end
+  end
+end

data/lib/metatron/templates/grpc_route/filter.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Metatron
+  module Templates
+    class GRPCRoute
+      # Internal model for a GRPCRoute filter.
+      # The +type+ must be the canonical CamelCase name (e.g.
+      # "RequestHeaderModifier", "ResponseHeaderModifier", "RequestMirror",
+      # "ExtensionRef"). All remaining keyword arguments become the type-specific
+      # configuration nested under the auto-derived camelCase key.
+      #
+      # Example:
+      #   Filter.new(
+      #     type: "RequestHeaderModifier",
+      #     add: [{ name: "X-Custom-Header", value: "custom-value" }]
+      #   )
+      #   # => { type: "RequestHeaderModifier",
+      #   #      requestHeaderModifier: { add: [{ ... }] } }
+      class Filter
+        attr_accessor :type, :config
+
+        def initialize(type:, **config)
+          @type = type
+          @config = config
+        end
+
+        def render
+          { type: }.merge(config.empty? ? {} : { type_key => config })
+        end
+
+        private
+
+        def type_key
+          # PascalCase → lowerCamelCase, handling acronym prefixes:
+          #   "RequestHeaderModifier" → :requestHeaderModifier
+          #   "ExtensionRef"          → :extensionRef
+          type
+            .sub(/\A([A-Z]+)(?=[A-Z][a-z])/, &:downcase)
+            .sub(/\A[A-Z]/, &:downcase)
+            .to_sym
+        end
+      end
+    end
+  end
+end

data/lib/metatron/templates/grpc_route/rule.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Metatron
+  module Templates
+    class GRPCRoute
+      # Internal model for a GRPCRoute rule
+      class Rule
+        attr_accessor :backend_refs, :matches
+        attr_reader :filters
+
+        def initialize(backend_refs:, matches: nil)
+          @backend_refs = backend_refs
+          @matches = matches
+          @filters = []
+        end
+
+        def add_filter(filter = nil, **attrs)
+          @filters << if filter.is_a?(Filter)
+                        filter
+                      else
+                        Filter.new(**attrs)
+                      end
+        end
+
+        def render
+          { backendRefs: backend_refs }
+            .merge(matches ? { matches: } : {})
+            .merge(filters.empty? ? {} : { filters: filters.map(&:render) })
+        end
+      end
+    end
+  end
+end

data/lib/metatron/templates/grpc_route.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Metatron
+  module Templates
+    # Template for GRPCRoute k8s resource (Gateway API)
+    class GRPCRoute < Template
+      include Concerns::Annotated
+      include Concerns::Namespaced
+      include Concerns::RouteResource
+
+      attr_accessor :additional_labels
+      attr_reader :hostnames, :rules
+
+      def initialize(name)
+        super
+        @api_version = "gateway.networking.k8s.io/v1"
+        @additional_labels = {}
+        @hostnames = []
+        @rules = []
+      end
+
+      def add_hostname(hostname)
+        @hostnames << hostname
+      end
+
+      def add_rule(rule = nil, **attrs)
+        @rules << if rule.is_a?(Rule)
+                    rule
+                  else
+                    Rule.new(**attrs)
+                  end
+      end
+
+      def formatted_hostnames
+        hostnames.empty? ? {} : { hostnames: }
+      end
+
+      def render
+        {
+          apiVersion:,
+          kind:,
+          metadata: {
+            name:,
+            labels: base_labels.merge(additional_labels)
+          }.merge(formatted_annotations).merge(formatted_namespace),
+          spec: formatted_parent_refs
+            .merge(formatted_hostnames)
+            .merge(rules.empty? ? {} : { rules: rules.map(&:render) })
+        }
+      end
+    end
+  end
+end

data/lib/metatron/templates/http_route/filter.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Metatron
+  module Templates
+    class HTTPRoute
+      # Internal model for an HTTPRoute filter.
+      # The +type+ must be the canonical CamelCase name (e.g. "URLRewrite",
+      # "RequestHeaderModifier"). All remaining keyword arguments become the
+      # type-specific configuration nested under the auto-derived camelCase key.
+      #
+      # Example:
+      #   Filter.new(
+      #     type: "URLRewrite",
+      #     hostname: "example.net",
+      #     path: { type: "ReplacePrefixMatch", replacePrefixMatch: "/new-prefix" }
+      #   )
+      #   # => { type: "URLRewrite", urlRewrite: { hostname: "example.net", path: { ... } } }
+      class Filter
+        attr_accessor :type, :config
+
+        def initialize(type:, **config)
+          @type = type
+          @config = config
+        end
+
+        def render
+          { type: }.merge(config.empty? ? {} : { type_key => config })
+        end
+
+        private
+
+        def type_key
+          # PascalCase → lowerCamelCase, handling acronym prefixes:
+          #   "URLRewrite"             → :urlRewrite
+          #   "RequestHeaderModifier"  → :requestHeaderModifier
+          type
+            .sub(/\A([A-Z]+)(?=[A-Z][a-z])/, &:downcase)
+            .sub(/\A[A-Z]/, &:downcase)
+            .to_sym
+        end
+      end
+    end
+  end
+end

data/lib/metatron/templates/http_route/rule.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Metatron
+  module Templates
+    class HTTPRoute
+      # Internal model for an HTTPRoute rule
+      class Rule
+        attr_accessor :backend_refs, :matches
+        attr_reader :filters
+
+        def initialize(backend_refs:, matches: nil)
+          @backend_refs = backend_refs
+          @matches = matches
+          @filters = []
+        end
+
+        def add_filter(filter = nil, **attrs)
+          @filters << if filter.is_a?(Filter)
+                        filter
+                      else
+                        Filter.new(**attrs)
+                      end
+        end
+
+        def render
+          { backendRefs: backend_refs }
+            .merge(matches ? { matches: } : {})
+            .merge(filters.empty? ? {} : { filters: filters.map(&:render) })
+        end
+      end
+    end
+  end
+end

data/lib/metatron/templates/http_route.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Metatron
+  module Templates
+    # Template for HTTPRoute k8s resource (Gateway API)
+    class HTTPRoute < Template
+      include Concerns::Annotated
+      include Concerns::Namespaced
+      include Concerns::RouteResource
+
+      attr_accessor :additional_labels
+      attr_reader :hostnames, :rules
+
+      def initialize(name)
+        super
+        @api_version = "gateway.networking.k8s.io/v1"
+        @additional_labels = {}
+        @hostnames = []
+        @rules = []
+      end
+
+      def add_hostname(hostname)
+        @hostnames << hostname
+      end
+
+      def add_rule(rule = nil, **attrs)
+        @rules << if rule.is_a?(Rule)
+                    rule
+                  else
+                    Rule.new(**attrs)
+                  end
+      end
+
+      def formatted_hostnames
+        hostnames.empty? ? {} : { hostnames: }
+      end
+
+      def render
+        {
+          apiVersion:,
+          kind:,
+          metadata: {
+            name:,
+            labels: base_labels.merge(additional_labels)
+          }.merge(formatted_annotations).merge(formatted_namespace),
+          spec: formatted_parent_refs
+            .merge(formatted_hostnames)
+            .merge(rules.empty? ? {} : { rules: rules.map(&:render) })
+        }
+      end
+    end
+  end
+end

data/lib/metatron/templates/tcp_route/rule.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Metatron
+  module Templates
+    class TCPRoute
+      # Internal model for a TCPRoute rule
+      class Rule
+        attr_accessor :backend_refs
+
+        def initialize(backend_refs:)
+          @backend_refs = backend_refs
+        end
+
+        def render
+          { backendRefs: backend_refs }
+        end
+      end
+    end
+  end
+end

data/lib/metatron/templates/tcp_route.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Metatron
+  module Templates
+    # Template for TCPRoute k8s resource (Gateway API)
+    class TCPRoute < Template
+      include Concerns::Annotated
+      include Concerns::Namespaced
+      include Concerns::RouteResource
+
+      attr_accessor :additional_labels
+      attr_reader :rules
+
+      def initialize(name)
+        super
+        @api_version = "gateway.networking.k8s.io/v1alpha2"
+        @additional_labels = {}
+        @rules = []
+      end
+
+      def add_rule(rule = nil, **attrs)
+        @rules << if rule.is_a?(Rule)
+                    rule
+                  else
+                    Rule.new(**attrs)
+                  end
+      end
+
+      def render
+        {
+          apiVersion:,
+          kind:,
+          metadata: {
+            name:,
+            labels: base_labels.merge(additional_labels)
+          }.merge(formatted_annotations).merge(formatted_namespace),
+          spec: formatted_parent_refs
+            .merge(rules.empty? ? {} : { rules: rules.map(&:render) })
+        }
+      end
+    end
+  end
+end

data/lib/metatron/templates/tls_route/rule.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Metatron
+  module Templates
+    class TLSRoute
+      # Internal model for a TLSRoute rule
+      class Rule
+        attr_accessor :backend_refs
+
+        def initialize(backend_refs:)
+          @backend_refs = backend_refs
+        end
+
+        def render
+          { backendRefs: backend_refs }
+        end
+      end
+    end
+  end
+end

data/lib/metatron/templates/tls_route.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Metatron
+  module Templates
+    # Template for TLSRoute k8s resource (Gateway API)
+    class TLSRoute < Template
+      include Concerns::Annotated
+      include Concerns::Namespaced
+      include Concerns::RouteResource
+
+      attr_accessor :additional_labels
+      attr_reader :hostnames, :rules
+
+      def initialize(name)
+        super
+        @api_version = "gateway.networking.k8s.io/v1"
+        @additional_labels = {}
+        @hostnames = []
+        @rules = []
+      end
+
+      def add_hostname(hostname)
+        @hostnames << hostname
+      end
+
+      def add_rule(rule = nil, **attrs)
+        @rules << if rule.is_a?(Rule)
+                    rule
+                  else
+                    Rule.new(**attrs)
+                  end
+      end
+
+      def formatted_hostnames
+        hostnames.empty? ? {} : { hostnames: }
+      end
+
+      def render
+        {
+          apiVersion:,
+          kind:,
+          metadata: {
+            name:,
+            labels: base_labels.merge(additional_labels)
+          }.merge(formatted_annotations).merge(formatted_namespace),
+          spec: formatted_parent_refs
+            .merge(formatted_hostnames)
+            .merge(rules.empty? ? {} : { rules: rules.map(&:render) })
+        }
+      end
+    end
+  end
+end

data/lib/metatron/templates/udp_route/rule.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Metatron
+  module Templates
+    class UDPRoute
+      # Internal model for a UDPRoute rule
+      class Rule
+        attr_accessor :backend_refs
+
+        def initialize(backend_refs:)
+          @backend_refs = backend_refs
+        end
+
+        def render
+          { backendRefs: backend_refs }
+        end
+      end
+    end
+  end
+end

data/lib/metatron/templates/udp_route.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Metatron
+  module Templates
+    # Template for UDPRoute k8s resource (Gateway API)
+    class UDPRoute < Template
+      include Concerns::Annotated
+      include Concerns::Namespaced
+      include Concerns::RouteResource
+
+      attr_accessor :additional_labels
+      attr_reader :rules
+
+      def initialize(name)
+        super
+        @api_version = "gateway.networking.k8s.io/v1alpha2"
+        @additional_labels = {}
+        @rules = []
+      end
+
+      def add_rule(rule = nil, **attrs)
+        @rules << if rule.is_a?(Rule)
+                    rule
+                  else
+                    Rule.new(**attrs)
+                  end
+      end
+
+      def render
+        {
+          apiVersion:,
+          kind:,
+          metadata: {
+            name:,
+            labels: base_labels.merge(additional_labels)
+          }.merge(formatted_annotations).merge(formatted_namespace),
+          spec: formatted_parent_refs
+            .merge(rules.empty? ? {} : { rules: rules.map(&:render) })
+        }
+      end
+    end
+  end
+end

data/lib/metatron/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Metatron
-  VERSION = "0.11.2"
+  VERSION = "0.11.3"
 end

data/lib/metatron.rb

@@ -24,6 +24,7 @@ require "metatron/template"
 require "metatron/templates/concerns/annotated"
 require "metatron/templates/concerns/namespaced"
 require "metatron/templates/concerns/pod_producer"
+require "metatron/templates/concerns/route_resource"
 require "metatron/templates/container"
 require "metatron/templates/pod"
 require "metatron/templates/job"
@@ -33,7 +34,21 @@ require "metatron/templates/cluster_role_binding"
 require "metatron/templates/cron_job"
 require "metatron/templates/daemon_set"
 require "metatron/templates/deployment"
+require "metatron/templates/gateway"
+require "metatron/templates/gateway/listener"
+require "metatron/templates/grpc_route"
+require "metatron/templates/grpc_route/rule"
+require "metatron/templates/grpc_route/filter"
+require "metatron/templates/http_route"
+require "metatron/templates/http_route/rule"
+require "metatron/templates/http_route/filter"
 require "metatron/templates/ingress"
+require "metatron/templates/tcp_route"
+require "metatron/templates/tcp_route/rule"
+require "metatron/templates/tls_route"
+require "metatron/templates/tls_route/rule"
+require "metatron/templates/udp_route"
+require "metatron/templates/udp_route/rule"
 require "metatron/templates/limit_range"
 require "metatron/templates/namespace"
 require "metatron/templates/network_policy"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: metatron
 version: !ruby/object:Gem::Version
-  version: 0.11.2
+  version: 0.11.3
 platform: ruby
 authors:
 - Jonathan Gnagy
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-06-18 00:00:00.000000000 Z
+date: 2026-02-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -260,11 +260,20 @@ files:
 - lib/metatron/templates/concerns/annotated.rb
 - lib/metatron/templates/concerns/namespaced.rb
 - lib/metatron/templates/concerns/pod_producer.rb
+- lib/metatron/templates/concerns/route_resource.rb
 - lib/metatron/templates/config_map.rb
 - lib/metatron/templates/container.rb
 - lib/metatron/templates/cron_job.rb
 - lib/metatron/templates/daemon_set.rb
 - lib/metatron/templates/deployment.rb
+- lib/metatron/templates/gateway.rb
+- lib/metatron/templates/gateway/listener.rb
+- lib/metatron/templates/grpc_route.rb
+- lib/metatron/templates/grpc_route/filter.rb
+- lib/metatron/templates/grpc_route/rule.rb
+- lib/metatron/templates/http_route.rb
+- lib/metatron/templates/http_route/filter.rb
+- lib/metatron/templates/http_route/rule.rb
 - lib/metatron/templates/ingress.rb
 - lib/metatron/templates/job.rb
 - lib/metatron/templates/limit_range.rb
@@ -281,6 +290,12 @@ files:
 - lib/metatron/templates/service.rb
 - lib/metatron/templates/service_account.rb
 - lib/metatron/templates/stateful_set.rb
+- lib/metatron/templates/tcp_route.rb
+- lib/metatron/templates/tcp_route/rule.rb
+- lib/metatron/templates/tls_route.rb
+- lib/metatron/templates/tls_route/rule.rb
+- lib/metatron/templates/udp_route.rb
+- lib/metatron/templates/udp_route/rule.rb
 - lib/metatron/templates/volume_snapshot.rb
 - lib/metatron/templates/volume_snapshot_content.rb
 - lib/metatron/version.rb