feat: add schema_version key to groups for calculated yaml definitions

Gemfile.lock

@@ -33,6 +33,7 @@ GEM
     crack (1.0.0)
       bigdecimal
       rexml
+    date (3.4.1)
     debug (1.8.0)
       irb (>= 1.5.0)
       reline (>= 0.3.1)
@@ -67,7 +68,8 @@ GEM
     parser (3.3.1.0)
       ast (~> 2.4.1)
       racc
-    psych (5.1.2)
+    psych (5.2.3)
+      date
       stringio
     public_suffix (5.0.5)
     racc (1.8.0)
@@ -131,7 +133,7 @@ GEM
       simplecov (< 1.0)
     simplecov-html (0.12.3)
     simplecov_json_formatter (0.1.4)
-    stringio (3.1.0)
+    stringio (3.1.4)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     unicode-display_width (2.5.0)

lib/entitlements/data/groups/calculated/yaml.rb

@@ -34,6 +34,28 @@ def description
             parsed_data.fetch("description", "")
           end
 
+          # Standard interface: Get the schema version of this group.
+          #
+          # Takes no arguments.
+          # Examples: "entitlements/v1", "entitlements/v1.2.3", "entitlements/1.2.3"
+          # Format: namespace/major.minor.patch
+          #
+          # Returns a String with the schema version (k8s-style), or "entitlements/v1" if undefined.
+          Contract C::None => String
+          def schema_version
+            schema_version = parsed_data.fetch("schema_version", "entitlements/v1").to_s
+
+            namespace, version = schema_version.split("/")
+
+            unless namespace.match?(/\A[a-zA-Z0-9]+\z/) && version.match?(/\A(v?\d+(\.\d+){0,2})\z/)
+              raise "Invalid schema version format: #{schema_version} - Expected format is '<namespace>/<version>' " \
+                    "- Examples: entitlements/v1, entitlements/v1.2.3, entitlements/1.2.3"
+            end
+
+            # rebuild the schema version string to ensure it's in the correct format and return it
+            return "#{namespace}/#{version}"
+          end
+
           # Files can support modifiers that act independently of rules.
           # This returns the modifiers from the file as a hash.
           #

spec/unit/entitlements/data/groups/calculated/yaml_spec.rb

@@ -35,6 +35,44 @@
     end
   end
 
+  describe "#schema_version" do
+    it "returns the version string when one is set" do
+      filename = fixture("ldap-config/filters/no-filters-with-schema-version.yaml")
+      subject = described_class.new(filename: filename)
+      expect(subject.schema_version).to eq("entitlements/1.2.3")
+    end
+
+    it "returns the version string when one is set without the patch" do
+      filename = fixture("ldap-config/filters/no-filters-with-schema-version-no-patch.yaml")
+      subject = described_class.new(filename: filename)
+      expect(subject.schema_version).to eq("entitlements/1.2")
+    end
+
+    it "returns the version string when one is set (with v prefix)" do
+      filename = fixture("ldap-config/filters/no-filters-with-schema-version-with-v.yaml")
+      subject = described_class.new(filename: filename)
+      expect(subject.schema_version).to eq("entitlements/v1.2.3")
+    end
+
+    it "returns the default version when schema_version is undefined" do
+      filename = fixture("ldap-config/filters/no-filters-description.yaml")
+      subject = described_class.new(filename: filename)
+      expect(subject.schema_version).to eq("entitlements/v1")
+    end
+
+    it "throws an error when an invalid schema_version string is provided" do
+      filename = fixture("ldap-config/filters/no-filters-with-bad-schema-version.yaml")
+      subject = described_class.new(filename: filename)
+      expect { subject.schema_version }.to raise_error(RuntimeError, /Invalid schema version format/)
+    end
+
+    it "throws an error when the version string is missing the namespace" do
+      filename = fixture("ldap-config/filters/no-filters-with-missing-version-namespace.yaml")
+      subject = described_class.new(filename: filename)
+      expect { subject.schema_version }.to raise_error(RuntimeError, /Invalid schema version format/)
+    end
+  end
+
   describe "#initialize_filters" do
     it "returns the default filter hash when no filters are defined" do
       filename = fixture("ldap-config/filters/no-filters.yaml")

spec/unit/fixtures/ldap-config/filters/no-filters-with-bad-schema-version.yaml

@@ -0,0 +1,6 @@
+description: Yo kittens
+schema_version: entitlements/1.abc2.3
+rules:
+  or:
+    - username: russianblue
+    - username: BlackManx

spec/unit/fixtures/ldap-config/filters/no-filters-with-missing-version-namespace.yaml

@@ -0,0 +1,6 @@
+description: Yo kittens
+schema_version: 1.2.3
+rules:
+  or:
+    - username: russianblue
+    - username: BlackManx

spec/unit/fixtures/ldap-config/filters/no-filters-with-schema-version-no-patch.yaml

@@ -0,0 +1,6 @@
+description: Yo kittens
+schema_version: entitlements/1.2
+rules:
+  or:
+    - username: russianblue
+    - username: BlackManx

spec/unit/fixtures/ldap-config/filters/no-filters-with-schema-version-with-v.yaml

@@ -0,0 +1,6 @@
+description: Yo kittens
+schema_version: entitlements/v1.2.3
+rules:
+  or:
+    - username: russianblue
+    - username: BlackManx

spec/unit/fixtures/ldap-config/filters/no-filters-with-schema-version.yaml

@@ -0,0 +1,6 @@
+description: Yo kittens
+schema_version: entitlements/1.2.3
+rules:
+  or:
+    - username: russianblue
+    - username: BlackManx