dcc 0.2.0 → 0.2.1

data/lib/dcc/validate/schematron/rules/used_methods_placement.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-
 module Dcc
   module Validate
     module Schematron
@@ -10,20 +9,24 @@ module Dcc
         class UsedMethodsPlacement < Base
           def check_on(dcc)
             issues = []
-            return issues unless Dcc::TypeGuards.has_attribute?(dcc, :measurement_results)
+            return issues unless Dcc::TypeGuards.has_attribute?(dcc,
+                                                                :measurement_results)
 
             mr_list = safe_attr(dcc.measurement_results, :measurement_result)
             return issues if mr_list.empty?
 
             any_used = mr_list.any? do |mr|
-              Dcc::TypeGuards.has_attribute?(mr, :used_methods) && !mr.used_methods.nil? ||
+              (Dcc::TypeGuards.has_attribute?(mr,
+                                              :used_methods) && !mr.used_methods.nil?) ||
                 mr_has_descendant?(mr, :used_methods)
             end
 
-            issues << issue(
-              severity: :error,
-              message: "dcc:usedMethods is missing in every measurementResult and its descendants",
-            ) unless any_used
+            unless any_used
+              issues << issue(
+                severity: :error,
+                message: "dcc:usedMethods is missing in every measurementResult and its descendants",
+              )
+            end
 
             issues
           end
@@ -31,7 +34,8 @@ module Dcc
           private
 
           def mr_has_descendant?(mr, attr_name)
-            return false unless Dcc::TypeGuards.has_attribute?(mr, :results) && mr.results
+            return false unless Dcc::TypeGuards.has_attribute?(mr,
+                                                               :results) && mr.results
 
             result = safe_attr(mr.results, :result)
             result.any? { |r| descendant_has?(r, attr_name) }
@@ -40,7 +44,8 @@ module Dcc
           def descendant_has?(node, attr_name)
             return false unless node.is_a?(::Lutaml::Model::Serializable)
 
-            if Dcc::TypeGuards.has_attribute?(node, attr_name) && !node.public_send(attr_name).nil?
+            if Dcc::TypeGuards.has_attribute?(node,
+                                              attr_name) && !node.public_send(attr_name).nil?
               return true
             end
 
@@ -62,4 +67,4 @@ module Dcc
       end
     end
   end
-end
+end

data/lib/dcc/validate/schematron/rules/used_software_placement.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-
 module Dcc
   module Validate
     module Schematron
@@ -12,21 +11,27 @@ module Dcc
           end
 
           def check_on(dcc)
-            return [] unless Dcc::TypeGuards.has_attribute?(dcc, :measurement_results)
+            return [] unless Dcc::TypeGuards.has_attribute?(dcc,
+                                                            :measurement_results)
 
             mr_list = safe_attr(dcc.measurement_results, :measurement_result)
             return [] if mr_list.empty?
 
             present = mr_list.any? do |mr|
-              Dcc::TypeGuards.has_attribute?(mr, :used_software) && !mr.used_software.nil?
+              Dcc::TypeGuards.has_attribute?(mr,
+                                             :used_software) && !mr.used_software.nil?
             end
 
-            present ? [] : [
-              issue(
-                severity: :warning,
-                message: "dcc:usedSoftware is missing on every measurementResult",
-              ),
-            ]
+            if present
+              []
+            else
+              [
+                issue(
+                  severity: :warning,
+                  message: "dcc:usedSoftware is missing on every measurementResult",
+                ),
+              ]
+            end
           end
 
           private
@@ -40,4 +45,4 @@ module Dcc
       end
     end
   end
-end
+end

data/lib/dcc/validate/schematron/rules/xml_list_spacing.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-
 module Dcc
   module Validate
     module Schematron
@@ -32,11 +31,13 @@ module Dcc
 
             node.class.attributes.each_key do |a|
               v = node.public_send(a)
-              Array(v).each { |child| check_string_list_attribute(child, issues, attr, label) }
+              Array(v).each do |child|
+                check_string_list_attribute(child, issues, attr, label)
+              end
             end
           end
         end
       end
     end
   end
-end
+end

data/lib/dcc/validate/schematron/rules.rb

@@ -10,20 +10,34 @@ module Dcc
     module Schematron
       module Rules
         autoload :Base, "dcc/validate/schematron/rules/base"
-        autoload :UsedMethodsPlacement, "dcc/validate/schematron/rules/used_methods_placement"
-        autoload :UsedSoftwarePlacement, "dcc/validate/schematron/rules/used_software_placement"
-        autoload :InfluenceConditionsPlacement, "dcc/validate/schematron/rules/influence_conditions_placement"
-        autoload :SchemaVersionCheck, "dcc/validate/schematron/rules/schema_version_check"
-        autoload :IdRefIdLinking, "dcc/validate/schematron/rules/id_refid_linking"
-        autoload :IsoCodeValidation, "dcc/validate/schematron/rules/iso_code_validation"
-        autoload :DateRangeCheck, "dcc/validate/schematron/rules/date_range_check"
-        autoload :ReleaseFormatCheck, "dcc/validate/schematron/rules/release_format_check"
-        autoload :UncertaintyConsistency, "dcc/validate/schematron/rules/uncertainty_consistency"
-        autoload :UnitFormatCheck, "dcc/validate/schematron/rules/unit_format_check"
-        autoload :NonSiDeclaration, "dcc/validate/schematron/rules/non_si_declaration"
-        autoload :LanguageCodeDedup, "dcc/validate/schematron/rules/language_code_dedup"
-        autoload :XmlListSpacing, "dcc/validate/schematron/rules/xml_list_spacing"
-        autoload :AdministrativeDataCompleteness, "dcc/validate/schematron/rules/administrative_data_completeness"
+        autoload :UsedMethodsPlacement,
+                 "dcc/validate/schematron/rules/used_methods_placement"
+        autoload :UsedSoftwarePlacement,
+                 "dcc/validate/schematron/rules/used_software_placement"
+        autoload :InfluenceConditionsPlacement,
+                 "dcc/validate/schematron/rules/influence_conditions_placement"
+        autoload :SchemaVersionCheck,
+                 "dcc/validate/schematron/rules/schema_version_check"
+        autoload :IdRefIdLinking,
+                 "dcc/validate/schematron/rules/id_refid_linking"
+        autoload :IsoCodeValidation,
+                 "dcc/validate/schematron/rules/iso_code_validation"
+        autoload :DateRangeCheck,
+                 "dcc/validate/schematron/rules/date_range_check"
+        autoload :ReleaseFormatCheck,
+                 "dcc/validate/schematron/rules/release_format_check"
+        autoload :UncertaintyConsistency,
+                 "dcc/validate/schematron/rules/uncertainty_consistency"
+        autoload :UnitFormatCheck,
+                 "dcc/validate/schematron/rules/unit_format_check"
+        autoload :NonSiDeclaration,
+                 "dcc/validate/schematron/rules/non_si_declaration"
+        autoload :LanguageCodeDedup,
+                 "dcc/validate/schematron/rules/language_code_dedup"
+        autoload :XmlListSpacing,
+                 "dcc/validate/schematron/rules/xml_list_spacing"
+        autoload :AdministrativeDataCompleteness,
+                 "dcc/validate/schematron/rules/administrative_data_completeness"
       end
     end
   end

data/lib/dcc/validate/schematron.rb

@@ -19,4 +19,4 @@ module Dcc
       end
     end
   end
-end
+end

data/lib/dcc/validate/xsd.rb

@@ -27,7 +27,9 @@ module Dcc
           resolved = ::Dcc::Schema::Version.resolve_dcc(version, xml: xml)
           schema = schema_for(resolved)
           doc = parse_xml(xml)
-          errors = schema.validate(doc).map { |e| issue_from_nokogiri(e, resolved) }
+          errors = schema.validate(doc).map do |e|
+            issue_from_nokogiri(e, resolved)
+          end
 
           ::Dcc::Validate::Result.new(
             issues: errors,
@@ -60,10 +62,14 @@ module Dcc
           content = ::File.read(xsd_path)
           content.gsub(/schemaLocation\s*=\s*"([^"]+)"/) do |_match|
             relative = ::Regexp.last_match(1)
-            next %{schemaLocation="#{relative}"} if relative.start_with?("http", "file://")
+            next %{schemaLocation="#{relative}"} if relative.start_with?(
+              "http", "file://"
+            )
 
             absolute = ::File.expand_path(relative, base_dir)
-            %{schemaLocation="file://#{absolute}"}
+            uri_path = absolute.gsub(::File::ALT_SEPARATOR || "\\", "/")
+            uri_path = "/#{uri_path}" unless uri_path.start_with?("/")
+            %{schemaLocation="file://#{uri_path}"}
           end
         end
 

data/lib/dcc/validate.rb

@@ -12,4 +12,4 @@ module Dcc
     autoload :Schematron, "dcc/validate/schematron"
     autoload :BusinessRules, "dcc/validate/business_rules"
   end
-end
+end

data/lib/dcc/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Dcc
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

data/lib/dcc/versioned_parser.rb

@@ -42,7 +42,7 @@ module Dcc
     end
 
     def root_element_symbol
-      self.const_get(:ROOT_ELEMENT_TAG).to_sym
+      const_get(:ROOT_ELEMENT_TAG).to_sym
     end
   end
 end

data/lib/dcc.rb

@@ -74,16 +74,63 @@ module Dcc
     # Build a new DCC programmatically using the builder DSL.
     # @yield [Dcc::Builder::Session] builder session
     # @param version [Integer, nil] major DCC version (default: 3).
-    def build(version: 3, &block)
-      Builder.call(version: version, &block)
+    def build(version: 3, &)
+      Builder.call(version: version, &)
     end
 
-    # Migrate a parsed DCC object from one schema version to another.
-    # @param dcc [Dcc::V2::DigitalCalibrationCertificate, Dcc::V3::DigitalCalibrationCertificate]
+    # Load plugin gems by name.
+    #
+    # A gem name maps to its entry file the usual way: "dcc-audit" loads
+    # "dcc/audit". A slash-separated path is accepted unchanged.
+    #
+    # @param names [Array<String, Symbol>] plugin gem names.
+    # @raise [Dcc::PluginError] if a plugin's entry file cannot be loaded.
+    # @return [Array<String>] the entry-file path for each name given.
+    #   A plugin already loaded is left alone and its path still returned.
+    #
+    # A plugin whose own `require` fails raises from inside a file we did
+    # find. Reporting that as a missing entry file points the author at the
+    # wrong problem, so only the entry path's own LoadError is wrapped.
+    def load_plugins(*names)
+      names.flatten.map do |name|
+        path = plugin_path(name)
+        require path
+        path
+      rescue ::LoadError => e
+        raise unless e.path == path
+
+        raise PluginError, "could not load plugin #{name}: tried " \
+                           "require #{path.inspect} (#{e.message})"
+      end
+    end
+
+    # "dcc-audit" is a gem name and maps to "dcc/audit". Anything already
+    # carrying a slash is a require path and is left alone, hyphens included.
+    def plugin_path(name)
+      text = name.to_s
+      text.include?("/") ? text : text.tr("-", "/")
+    end
+    private :plugin_path
+
+    # Migrate a DCC from one schema version to another.
+    #
+    # Prefer passing the source XML. A parsed model has to be serialized back
+    # to XML before the transform runs, so anything the model could not
+    # round-trip is already gone and cannot be migrated or reported.
+    #
+    # @param input [String, IO, Dcc::V2::DigitalCalibrationCertificate,
+    #   Dcc::V3::DigitalCalibrationCertificate] DCC source XML, or a parsed DCC.
     # @param from [String] source version, e.g. "2.3.0".
     # @param to [String] target version, e.g. "3.3.0".
-    def migrate(dcc, from:, to:)
-      Migrate.call(dcc, from: from, to: to)
+    # @param on_loss [#call, nil] callable receiving each message describing a
+    #   construct the migration changed or discarded (a String per loss).
+    #   When given, the messages go to the callable and nothing is sent to
+    #   `Kernel.warn`; when nil (the default), each loss report is warned to
+    #   stderr as before.
+    # @return [Dcc::V2::DigitalCalibrationCertificate,
+    #   Dcc::V3::DigitalCalibrationCertificate] always a parsed DCC.
+    def migrate(input, from:, to:, on_loss: nil)
+      Migrate.call(input, from: from, to: to, on_loss: on_loss)
     end
 
     # Return the parser module for the given major version.
@@ -94,7 +141,8 @@ module Dcc
       when 2 then V2
       when 3 then V3
       else
-        raise UnknownVersionError, "Unsupported DCC version: #{version.inspect} (expected 2 or 3)"
+        raise UnknownVersionError,
+              "Unsupported DCC version: #{version.inspect} (expected 2 or 3)"
       end
     end
 

data/sample_dcc.xml

@@ -0,0 +1,140 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<dcc:digitalCalibrationCertificate
+    xmlns:dcc="https://ptb.de/dcc"
+    xmlns:si="https://ptb.de/si"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="https://ptb.de/dcc https://ptb.de/dcc/v3.3.0/dcc.xsd"
+    schemaVersion="3.3.0">
+
+  <dcc:administrativeData>
+    <dcc:dccSoftware>
+      <dcc:software>
+        <dcc:name><dcc:content lang="en">DCC Validator Builder</dcc:content></dcc:name>
+        <dcc:release>0.1.0</dcc:release>
+      </dcc:software>
+    </dcc:dccSoftware>
+
+    <dcc:coreData>
+      <dcc:countryCodeISO3166_1>DE</dcc:countryCodeISO3166_1>
+      <dcc:usedLangCodeISO639_1>en</dcc:usedLangCodeISO639_1>
+      <dcc:usedLangCodeISO639_1>de</dcc:usedLangCodeISO639_1>
+      <dcc:mandatoryLangCodeISO639_1>en</dcc:mandatoryLangCodeISO639_1>
+      <dcc:uniqueIdentifier>PTB-A0123-2026</dcc:uniqueIdentifier>
+      <dcc:beginPerformanceDate>2026-07-23</dcc:beginPerformanceDate>
+      <dcc:endPerformanceDate>2026-07-23</dcc:endPerformanceDate>
+    </dcc:coreData>
+
+    <dcc:items>
+      <dcc:item>
+        <dcc:name><dcc:content lang="en">Precision Resistance Decade 10 kΩ</dcc:content></dcc:name>
+        <dcc:manufacturer><dcc:name><dcc:content lang="en">Burster Präzisionsmesstechnik GmbH</dcc:content></dcc:name></dcc:manufacturer>
+        <dcc:model>BURSTER 1424</dcc:model>
+      </dcc:item>
+    </dcc:items>
+
+    <dcc:calibrationLaboratory>
+      <dcc:calibrationLaboratoryCode>DE1</dcc:calibrationLaboratoryCode>
+      <dcc:contact>
+        <dcc:name><dcc:content lang="en">Physikalisch-Technische Bundesanstalt</dcc:content></dcc:name>
+        <dcc:eMail>calibration@ptb.de</dcc:eMail>
+      </dcc:contact>
+    </dcc:calibrationLaboratory>
+
+    <dcc:respPersons>
+      <dcc:respPerson>
+        <dcc:person>
+          <dcc:name><dcc:content lang="en">Dr. Klaus-Dieter Sommer</dcc:content></dcc:name>
+          <dcc:eMail>k.sommer@ptb.de</dcc:eMail>
+        </dcc:person>
+        <dcc:mainSigner>true</dcc:mainSigner>
+      </dcc:respPerson>
+    </dcc:respPersons>
+
+    <dcc:customer>
+      <dcc:name><dcc:content lang="en">Burster Präzisionsmesstechnik GmbH</dcc:content></dcc:name>
+    </dcc:customer>
+  </dcc:administrativeData>
+
+  <dcc:measurementResults>
+    <dcc:measurementResult>
+      <dcc:name><dcc:content lang="en">Calibration Results</dcc:content></dcc:name>
+      <dcc:results>
+        <dcc:result>
+          <dcc:name><dcc:content lang="en">Resistance calibration at 1 kΩ</dcc:content></dcc:name>
+          <dcc:data>
+          <dcc:quantity>
+            <dcc:name><dcc:content lang="en">Actual resistance</dcc:content></dcc:name>
+            <si:real>
+              <si:value>999.982</si:value>
+              <si:unit>\ohm</si:unit>
+                  <si:expandedMU>
+                    <si:valueExpandedMU>0.012</si:valueExpandedMU>
+                    <si:coverageFactor>2</si:coverageFactor>
+                    <si:coverageProbability>0.95</si:coverageProbability>
+                  </si:expandedMU>
+            </si:real>
+          </dcc:quantity>
+          <dcc:quantity>
+            <dcc:name><dcc:content lang="en">Temperature coefficient</dcc:content></dcc:name>
+            <si:real>
+              <si:value>5.2e-6</si:value>
+              <si:unit>\per\kelvin</si:unit>
+                  <si:expandedMU>
+                    <si:valueExpandedMU>0.3e-6</si:valueExpandedMU>
+                    <si:coverageFactor>2</si:coverageFactor>
+                    <si:coverageProbability>0.95</si:coverageProbability>
+                  </si:expandedMU>
+            </si:real>
+          </dcc:quantity>
+          </dcc:data>
+        </dcc:result>
+        <dcc:result>
+          <dcc:name><dcc:content lang="en">Resistance calibration at 10 kΩ</dcc:content></dcc:name>
+          <dcc:data>
+          <dcc:quantity>
+            <dcc:name><dcc:content lang="en">Actual resistance</dcc:content></dcc:name>
+            <si:real>
+              <si:value>10000.04</si:value>
+              <si:unit>\kilo\ohm</si:unit>
+                  <si:expandedMU>
+                    <si:valueExpandedMU>0.03</si:valueExpandedMU>
+                    <si:coverageFactor>2</si:coverageFactor>
+                    <si:coverageProbability>0.95</si:coverageProbability>
+                  </si:expandedMU>
+            </si:real>
+          </dcc:quantity>
+          </dcc:data>
+        </dcc:result>
+        <dcc:result>
+          <dcc:name><dcc:content lang="en">Environmental conditions</dcc:content></dcc:name>
+          <dcc:data>
+          <dcc:quantity>
+            <dcc:name><dcc:content lang="en">Ambient temperature</dcc:content></dcc:name>
+            <si:real>
+              <si:value>23.0</si:value>
+              <si:unit>\degreeCelsius</si:unit>
+                  <si:expandedMU>
+                    <si:valueExpandedMU>0.2</si:valueExpandedMU>
+                    <si:coverageFactor>2</si:coverageFactor>
+                    <si:coverageProbability>0.95</si:coverageProbability>
+                  </si:expandedMU>
+            </si:real>
+          </dcc:quantity>
+          <dcc:quantity>
+            <dcc:name><dcc:content lang="en">Relative humidity</dcc:content></dcc:name>
+            <si:real>
+              <si:value>48</si:value>
+              <si:unit>\percent</si:unit>
+                  <si:expandedMU>
+                    <si:valueExpandedMU>2</si:valueExpandedMU>
+                    <si:coverageFactor>2</si:coverageFactor>
+                    <si:coverageProbability>0.95</si:coverageProbability>
+                  </si:expandedMU>
+            </si:real>
+          </dcc:quantity>
+          </dcc:data>
+        </dcc:result>
+      </dcc:results>
+    </dcc:measurementResult>
+  </dcc:measurementResults>
+</dcc:digitalCalibrationCertificate>

data/web/index.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width,initial-scale=1.0" />
+<title>DCC Validator</title>
+</head>
+<body>
+<div id="app"></div>
+<script type="module" src="/src/main.ts"></script>
+</body>
+</html>