dcc 0.2.0

data/lib/dcc/server.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# `Dcc::Server` provides an optional Rack/Sinatra REST API mirroring PTB's
+# dcclib REST endpoints. Soft-depends on `sinatra`; raises
+# `Dcc::MissingDependencyError` if not installed.
+module Dcc
+  module Server
+    autoload :App, "dcc/server/app"
+    autoload :Storage, "dcc/server/storage"
+
+    # Attempt to load sinatra to detect availability.
+    def self.available?
+      return @available unless @available.nil?
+
+      begin
+        require "sinatra/base"
+        @available = true
+      rescue ::LoadError
+        @available = false
+      end
+      @available
+    end
+
+    # Raise a friendly error if Sinatra is missing.
+    def self.ensure_available!
+      return if available?
+
+      raise ::Dcc::MissingDependencyError.new(gem_name: "sinatra",
+                                              feature: "Dcc::Server REST API"),
+            "sinatra is required for the REST API"
+    end
+  end
+end

data/lib/dcc/si/base/complex.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    module Base
+      # `si:complexQuantityType` — complex number in Cartesian or polar form.
+      module Complex
+        def self.included(klass)
+          klass.class_eval do
+            attribute :id, :string
+            attribute :ref_type, :string
+            attribute :label, :string
+            attribute :value_real, :string
+            attribute :value_imag, :string
+            attribute :value_magnitude, :string
+            attribute :value_phase, :string
+            attribute :unit, ::Dcc::Type::SiUnit
+            attribute :unit_phase, :string
+            attribute :significant_digit, :integer
+            attribute :date_time, :date_time
+
+            xml do
+              namespace ::Dcc::Namespace::Si
+              element "complex"
+              ordered
+              map_attribute "id", to: :id
+              map_attribute "refType", to: :ref_type
+              map_element "label", to: :label
+              map_element "valueReal", to: :value_real
+              map_element "valueImag", to: :value_imag
+              map_element "valueMagnitude", to: :value_magnitude
+              map_element "valuePhase", to: :value_phase
+              map_element "unit", to: :unit
+              map_element "unitPhase", to: :unit_phase
+              map_element "significantDigit", to: :significant_digit
+              map_element "dateTime", to: :date_time
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/si/base/complex_list_xml_list.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    module Base
+      # `si:complexListXMLListType` — compact list of complex quantities.
+      module ComplexListXmlList
+        def self.included(klass)
+          klass.class_eval do
+            attribute :id, :string
+            attribute :ref_type, :string
+            attribute :label_xml_list, :string
+            attribute :value_real_xml_list, ::Dcc::Type::DecimalXmlList
+            attribute :value_imag_xml_list, ::Dcc::Type::DecimalXmlList
+            attribute :value_magnitude_xml_list, ::Dcc::Type::DecimalXmlList
+            attribute :value_phase_xml_list, ::Dcc::Type::DecimalXmlList
+            attribute :unit_xml_list, :string
+            attribute :unit_phase_xml_list, :string
+
+            xml do
+              namespace ::Dcc::Namespace::Si
+              element "complexListXMLList"
+              ordered
+              map_attribute "id", to: :id
+              map_attribute "refType", to: :ref_type
+              map_element "labelXMLList", to: :label_xml_list
+              map_element "valueRealXMLList", to: :value_real_xml_list
+              map_element "valueImagXMLList", to: :value_imag_xml_list
+              map_element "valueMagnitudeXMLList", to: :value_magnitude_xml_list
+              map_element "valuePhaseXMLList", to: :value_phase_xml_list
+              map_element "unitXMLList", to: :unit_xml_list
+              map_element "unitPhaseXMLList", to: :unit_phase_xml_list
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/si/base/constant.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    module Base
+      # `si:constantQuantityType` — physical or mathematical constant.
+      module Constant
+        def self.included(klass)
+          klass.class_eval do
+            attribute :id, :string
+            attribute :ref_type, :string
+            attribute :label, :string
+            attribute :value, :string
+            attribute :unit, ::Dcc::Type::SiUnit
+            attribute :significant_digit, :integer
+            attribute :date_time, :date_time
+            attribute :value_standard_mu, :string
+            attribute :distribution, :string
+
+            xml do
+              namespace ::Dcc::Namespace::Si
+              element "constant"
+              ordered
+              map_attribute "id", to: :id
+              map_attribute "refType", to: :ref_type
+              map_element "label", to: :label
+              map_element "value", to: :value
+              map_element "unit", to: :unit
+              map_element "significantDigit", to: :significant_digit
+              map_element "dateTime", to: :date_time
+              map_element "valueStandardMU", to: :value_standard_mu
+              map_element "distribution", to: :distribution
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/si/base/coverage_interval_mu.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    module Base
+      # `si:coverageIntervalMUType` — coverage interval uncertainty.
+      module CoverageIntervalMU
+        def self.included(klass)
+          klass.class_eval do
+            attribute :value_standard_mu, :string
+            attribute :interval_min, :string
+            attribute :interval_max, :string
+            attribute :coverage_probability, :string
+            attribute :distribution, :string
+
+            xml do
+              namespace ::Dcc::Namespace::Si
+              element "coverageIntervalMU"
+              ordered
+              map_element "valueStandardMU", to: :value_standard_mu
+              map_element "intervalMin", to: :interval_min
+              map_element "intervalMax", to: :interval_max
+              map_element "coverageProbability", to: :coverage_probability
+              map_element "distribution", to: :distribution
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/si/base/expanded_mu.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    module Base
+      # `si:expandedMUType` — expanded measurement uncertainty (k × σ).
+      module ExpandedMU
+        def self.included(klass)
+          klass.class_eval do
+            attribute :value_expanded_mu, :string
+            attribute :coverage_factor, :string
+            attribute :coverage_probability, :string
+            attribute :distribution, :string
+
+            xml do
+              namespace ::Dcc::Namespace::Si
+              element "expandedMU"
+              ordered
+              map_element "valueExpandedMU", to: :value_expanded_mu
+              map_element "coverageFactor", to: :coverage_factor
+              map_element "coverageProbability", to: :coverage_probability
+              map_element "distribution", to: :distribution
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/si/base/expanded_unc_xml_list.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    module Base
+      # `si:expandedUncXMLListType` — compact expanded uncertainty paired
+      # with a `realListXMLList`. Used in PTB's valid.xml.
+      module ExpandedUncXmlList
+        def self.included(klass)
+          klass.class_eval do
+            attribute :uncertainty_xml_list, ::Dcc::Type::DecimalXmlList
+            attribute :coverage_factor_xml_list, :string
+            attribute :coverage_probability_xml_list, :string
+            attribute :distribution_xml_list, :string
+
+            xml do
+              namespace ::Dcc::Namespace::Si
+              element "expandedUncXMLList"
+              ordered
+              map_element "uncertaintyXMLList", to: :uncertainty_xml_list
+              map_element "coverageFactorXMLList", to: :coverage_factor_xml_list
+              map_element "coverageProbabilityXMLList", to: :coverage_probability_xml_list
+              map_element "distributionXMLList", to: :distribution_xml_list
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/si/base/hybrid.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    module Base
+      # `si:hybridType` — multi-unit adapter. Wraps one or more quantity
+      # representations (real, realListXMLList, complex, etc.) that express
+      # the same measurand in different units. At least one SI unit is
+      # required per the XSD.
+      module Hybrid
+        def self.included(klass)
+          klass.class_eval do
+            attribute :id, :string
+            attribute :ref_type, :string
+            attribute :label, :string
+            attribute :quantity_type, :string
+            attribute :real, :real, collection: true
+            attribute :complex, :complex, collection: true
+            attribute :constant, :constant, collection: true
+            attribute :real_list_xml_list, :realListXMLList, collection: true
+            attribute :complex_list_xml_list, :complexListXMLList, collection: true
+
+            xml do
+              namespace ::Dcc::Namespace::Si
+              element "hybrid"
+              ordered
+              map_attribute "id", to: :id
+              map_attribute "refType", to: :ref_type
+              map_element "label", to: :label
+              map_element "quantityType", to: :quantity_type
+              map_element "real", to: :real
+              map_element "complex", to: :complex
+              map_element "constant", to: :constant
+              map_element "realListXMLList", to: :real_list_xml_list
+              map_element "complexListXMLList", to: :complex_list_xml_list
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/si/base/measurement_uncertainty_univariate.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    module Base
+      # `si:measurementUncertaintyUnivariateType` — choice of standardMU /
+      # expandedMU / coverageIntervalMU. Modeled as three optional attributes.
+      module MeasurementUncertaintyUnivariate
+        def self.included(klass)
+          klass.class_eval do
+            attribute :standard_mu, :standardMU
+            attribute :expanded_mu, :expandedMU
+            attribute :coverage_interval_mu, :coverageIntervalMU
+
+            xml do
+              namespace ::Dcc::Namespace::Si
+              element "measurementUncertaintyUnivariate"
+              ordered
+              map_element "standardMU", to: :standard_mu
+              map_element "expandedMU", to: :expanded_mu
+              map_element "coverageIntervalMU", to: :coverage_interval_mu
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/si/base/real.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    module Base
+      # `si:realQuantityType` — single real measurement quantity with
+      # optional univariate uncertainty.
+      #
+      # Wire format:
+      #   <si:real>
+      #     <si:label>...</si:label>
+      #     <si:value>42.0</si:value>
+      #     <si:unit>\kelvin</si:unit>
+      #     <si:measurementUncertaintyUnivariate>
+      #       <si:expandedMU>...</si:expandedMU>
+      #     </si:measurementUncertaintyUnivariate>
+      #   </si:real>
+      module Real
+        def self.included(klass)
+          klass.class_eval do
+            attribute :id, :string
+            attribute :ref_type, :string
+            attribute :label, :string
+            attribute :value, :string
+            attribute :unit, ::Dcc::Type::SiUnit
+            attribute :significant_digit, :integer
+            attribute :date_time, :date_time
+            attribute :measurement_uncertainty_univariate, :measurementUncertaintyUnivariate
+
+            xml do
+              namespace ::Dcc::Namespace::Si
+              element "real"
+              ordered
+              map_attribute "id", to: :id
+              map_attribute "refType", to: :ref_type
+              map_element "label", to: :label
+              map_element "value", to: :value
+              map_element "unit", to: :unit
+              map_element "significantDigit", to: :significant_digit
+              map_element "dateTime", to: :date_time
+              map_element "measurementUncertaintyUnivariate", to: :measurement_uncertainty_univariate
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/si/base/real_list_xml_list.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    module Base
+      # `si:realListXMLListType` — compact space-separated list of real
+      # measurement quantities. Each component (values, units, uncertainty)
+      # is itself a space-separated XML list.
+      module RealListXmlList
+        def self.included(klass)
+          klass.class_eval do
+            attribute :id, :string
+            attribute :ref_type, :string
+            attribute :label_xml_list, :string
+            attribute :quantity_type_xml_list, :string
+            attribute :value_xml_list, ::Dcc::Type::DecimalXmlList
+            attribute :unit_xml_list, :string
+            attribute :significant_digit_xml_list, :string
+            attribute :date_time_xml_list, :string
+            attribute :expanded_unc_xml_list, :expandedUncXMLList
+            attribute :standard_mu_xml_list, :standardMUXMLList
+            attribute :coverage_interval_mu_xml_list, :coverageIntervalMUXMLList
+
+            xml do
+              namespace ::Dcc::Namespace::Si
+              element "realListXMLList"
+              ordered
+              map_attribute "id", to: :id
+              map_attribute "refType", to: :ref_type
+              map_element "labelXMLList", to: :label_xml_list
+              map_element "quantityTypeXMLList", to: :quantity_type_xml_list
+              map_element "valueXMLList", to: :value_xml_list
+              map_element "unitXMLList", to: :unit_xml_list
+              map_element "significantDigitXMLList", to: :significant_digit_xml_list
+              map_element "dateTimeXMLList", to: :date_time_xml_list
+              map_element "expandedUncXMLList", to: :expanded_unc_xml_list
+              map_element "standardMUXMLList", to: :standard_mu_xml_list
+              map_element "coverageIntervalMUXMLList", to: :coverage_interval_mu_xml_list
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/si/base/si_list.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    module Base
+      # `si:listType` — recursive list container for nested quantity lists.
+      module SiList
+        def self.included(klass)
+          klass.class_eval do
+            attribute :id, :string
+            attribute :ref_type, :string
+            attribute :label, :string
+            attribute :date_time, :date_time
+            attribute :real_list, :real, collection: true
+            attribute :real_list_xml_list, :realListXMLList, collection: true
+            attribute :complex_list_xml_list, :complexListXMLList, collection: true
+            attribute :list, :list, collection: true
+
+            xml do
+              namespace ::Dcc::Namespace::Si
+              element "list"
+              ordered
+              map_attribute "id", to: :id
+              map_attribute "refType", to: :ref_type
+              map_element "label", to: :label
+              map_element "dateTime", to: :date_time
+              map_element "realList", to: :real_list
+              map_element "realListXMLList", to: :real_list_xml_list
+              map_element "complexListXMLList", to: :complex_list_xml_list
+              map_element "list", to: :list
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/si/base/standard_mu.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    module Base
+      # `si:standardMUType` — standard measurement uncertainty (1σ).
+      module StandardMU
+        def self.included(klass)
+          klass.class_eval do
+            attribute :value_standard_mu, :string
+            attribute :distribution, :string
+
+            xml do
+              namespace ::Dcc::Namespace::Si
+              element "standardMU"
+              ordered
+              map_element "valueStandardMU", to: :value_standard_mu
+              map_element "distribution", to: :distribution
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/si/base.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+# `Dcc::Si::Base` hosts version-agnostic XML mapping modules for every D-SI
+# element type. Mirrors the `Dcc::Base` pattern: each module uses
+# `self.included(klass)` with `klass.class_eval` to inject attributes and
+# the `xml do ... end` mapping block.
+module Dcc
+  module Si
+    module Base
+      autoload :Real, "dcc/si/base/real"
+      autoload :Complex, "dcc/si/base/complex"
+      autoload :Constant, "dcc/si/base/constant"
+      autoload :RealListXmlList, "dcc/si/base/real_list_xml_list"
+      autoload :ComplexListXmlList, "dcc/si/base/complex_list_xml_list"
+      autoload :Hybrid, "dcc/si/base/hybrid"
+      autoload :SiList, "dcc/si/base/si_list"
+      autoload :StandardMU, "dcc/si/base/standard_mu"
+      autoload :ExpandedMU, "dcc/si/base/expanded_mu"
+      autoload :CoverageIntervalMU, "dcc/si/base/coverage_interval_mu"
+      autoload :ExpandedUncXmlList, "dcc/si/base/expanded_unc_xml_list"
+      autoload :MeasurementUncertaintyUnivariate, "dcc/si/base/measurement_uncertainty_univariate"
+    end
+  end
+end

data/lib/dcc/si/common_elements.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    # Base class for D-SI element wrappers. Subclassed per version with the
+    # appropriate `lutaml_default_register`.
+    class CommonElements < Lutaml::Model::Serializable
+      def self.lutaml_default_register
+        :dsi_v2
+      end
+    end
+  end
+end

data/lib/dcc/si/namespace.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    Namespace = ::Dcc::Namespace::Si
+  end
+end

data/lib/dcc/si/v1/common_elements.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    module V1
+      class CommonElements < ::Dcc::Si::CommonElements
+        def self.lutaml_default_register
+          :dsi_v1
+        end
+      end
+    end
+  end
+end

data/lib/dcc/si/v1/complex.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Dcc::Si::V1
+  class Complex < CommonElements
+    include ::Dcc::Si::Base::Complex
+  end
+  Configuration.register_model(Complex, id: :complex)
+end

data/lib/dcc/si/v1/complex_list_xml_list.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Dcc::Si::V1
+  class ComplexListXmlList < CommonElements
+    include ::Dcc::Si::Base::ComplexListXmlList
+  end
+  Configuration.register_model(ComplexListXmlList, id: :complexListXMLList)
+end

data/lib/dcc/si/v1/configuration.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    module V1
+      module Configuration
+        extend ::Dcc::ContextConfiguration
+
+        CONTEXT_ID = :dsi_v1
+      end
+    end
+  end
+end

data/lib/dcc/si/v1/constant.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Dcc::Si::V1
+  class Constant < CommonElements
+    include ::Dcc::Si::Base::Constant
+  end
+  Configuration.register_model(Constant, id: :constant)
+end

data/lib/dcc/si/v1/coverage_interval_mu.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Dcc::Si::V1
+  class CoverageIntervalMU < CommonElements
+    include ::Dcc::Si::Base::CoverageIntervalMU
+  end
+  Configuration.register_model(CoverageIntervalMU, id: :coverageIntervalMU)
+end

data/lib/dcc/si/v1/expanded_mu.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Dcc::Si::V1
+  class ExpandedMU < CommonElements
+    include ::Dcc::Si::Base::ExpandedMU
+  end
+  Configuration.register_model(ExpandedMU, id: :expandedMU)
+end

data/lib/dcc/si/v1/expanded_unc.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Dcc::Si::V1
+  # Deprecated v1 expandedUnc type — superseded by expandedMU in v2.
+  # Kept so old fixtures parse without losing data.
+  class ExpandedUnc < CommonElements
+    attribute :uncertainty, :string
+    attribute :coverage_factor, :string
+    attribute :coverage_probability, :string
+    attribute :distribution, :string
+
+    xml do
+      namespace ::Dcc::Namespace::Si
+      element "expandedUnc"
+      ordered
+      map_element "uncertainty", to: :uncertainty
+      map_element "coverageFactor", to: :coverage_factor
+      map_element "coverageProbability", to: :coverage_probability
+      map_element "distribution", to: :distribution
+    end
+  end
+  Configuration.register_model(ExpandedUnc, id: :expandedUnc)
+end

data/lib/dcc/si/v1/expanded_unc_xml_list.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Dcc::Si::V1
+  class ExpandedUncXmlList < CommonElements
+    include ::Dcc::Si::Base::ExpandedUncXmlList
+  end
+  Configuration.register_model(ExpandedUncXmlList, id: :expandedUncXMLList)
+end

data/lib/dcc/si/v1/hybrid.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Dcc::Si::V1
+  class Hybrid < CommonElements
+    include ::Dcc::Si::Base::Hybrid
+  end
+  Configuration.register_model(Hybrid, id: :hybrid)
+end

data/lib/dcc/si/v1/measurement_uncertainty_univariate.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Dcc::Si::V1
+  class MeasurementUncertaintyUnivariate < CommonElements
+    include ::Dcc::Si::Base::MeasurementUncertaintyUnivariate
+  end
+  Configuration.register_model(MeasurementUncertaintyUnivariate, id: :measurementUncertaintyUnivariate)
+end

data/lib/dcc/si/v1/namespace.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Si
+    module V1
+      Namespace = ::Dcc::Namespace::Si
+    end
+  end
+end