dcc 0.2.0

data/examples/quantity_math_demo.rb

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Demonstrate BigDecimal-based quantity math with uncertainty propagation.
+#
+# Usage:
+#   bundle exec examples/quantity_math_demo.rb
+
+require "dcc"
+require "bigdecimal"
+
+ten_k   = Dcc::QuantityMath::Real.new(value: BigDecimal("10"),
+                                       unit: "\\kelvin",
+                                       uncertainty: BigDecimal("0.1"))
+twenty_k = Dcc::QuantityMath::Real.new(value: BigDecimal("20"),
+                                        unit: "\\kelvin",
+                                        uncertainty: BigDecimal("0.2"))
+
+puts "ten:      #{ten_k}"
+puts "twenty:   #{twenty_k}"
+puts "sum:      #{ten_k + twenty_k}"
+puts "product:  #{ten_k * twenty_k}"
+puts "ratio:    #{twenty_k / ten_k}"
+
+# Pretty-print with SmartCom-style formats.
+fmt = Dcc::QuantityFormat::Formatter.new(value: BigDecimal("42.00"),
+                                          uncertainty: BigDecimal("0.05"),
+                                          unit: "\\kelvin")
+puts
+puts "Short:    #{fmt.to_short}"
+puts "Long:     #{fmt.to_long}"
+puts "LaTeX:    #{fmt.to_latex}"

data/examples/validate_full.rb

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Validate a DCC against XSD, Schematron, and business rules in one shot.
+#
+# Usage:
+#   bundle exec examples/validate_full.rb path/to/dcc.xml
+
+require "dcc"
+
+path = ARGV[0] || File.expand_path("../spec/fixtures/dcclib/valid.xml", __dir__)
+xml = File.read(path)
+
+dcc = Dcc.parse(xml)
+
+[Dcc::Validate::Xsd,
+ Dcc::Validate::Schematron,
+ Dcc::Validate::BusinessRules].each do |service|
+  result =
+    case service.name
+    when "Dcc::Validate::Xsd" then service.call(xml)
+    else service.call(dcc)
+    end
+  puts "== #{service.name} =="
+  puts result.to_s
+  puts
+end

data/exe/dcc

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "dcc"
+require "dcc/cli/cli"
+
+Dcc::Cli::Cli.start(ARGV)

data/lib/dcc/base/administrative_data.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Base
+    # `dcc:administrativeDataType` — top-level admin section. Uses `xs:all`
+    # ordering (children may appear in any order) so we keep the explicit
+    # `ordered` for serialization determinism.
+    module AdministrativeData
+      def self.included(klass)
+        klass.class_eval do
+          attribute :id, :string
+          attribute :ref_id, :string
+          attribute :ref_type, :string
+          attribute :dcc_software, :softwareList
+          attribute :ref_type_definitions, :refTypeDefinitions
+          attribute :core_data, :coreData
+          attribute :items, :items
+          attribute :calibration_laboratory, :calibrationLaboratory
+          attribute :resp_persons, :respPersons
+          attribute :customer, :contact
+          attribute :statements, :statements
+
+          xml do
+            namespace ::Dcc::Namespace::Dcc
+            element "administrativeData"
+            ordered
+            map_attribute "id", to: :id
+            map_attribute "refId", to: :ref_id
+            map_attribute "refType", to: :ref_type
+            map_element "dccSoftware", to: :dcc_software
+            map_element "refTypeDefinitions", to: :ref_type_definitions
+            map_element "coreData", to: :core_data
+            map_element "items", to: :items
+            map_element "calibrationLaboratory", to: :calibration_laboratory
+            map_element "respPersons", to: :resp_persons
+            map_element "customer", to: :customer
+            map_element "statements", to: :statements
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/base/byte_data.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Base
+    # `dcc:byteDataType` — embedded binary file with name/description/filename/
+    # mime-type/base64 data.
+    module ByteData
+      def self.included(klass)
+        klass.class_eval do
+          attribute :id, :string
+          attribute :ref_id, :string
+          attribute :ref_type, :string
+          attribute :name, :text
+          attribute :description, :text
+          attribute :file_name, :string
+          attribute :mime_type, :string
+          attribute :data_base64, ::Dcc::Type::Base64Binary
+
+          xml do
+            namespace ::Dcc::Namespace::Dcc
+            element "byteData"
+            ordered
+            map_attribute "id", to: :id
+            map_attribute "refId", to: :ref_id
+            map_attribute "refType", to: :ref_type
+            map_element "name", to: :name
+            map_element "description", to: :description
+            map_element "fileName", to: :file_name
+            map_element "mimeType", to: :mime_type
+            map_element "dataBase64", to: :data_base64
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/base/calibration_laboratory.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Base
+    # `dcc:calibrationLaboratoryType` — lab code plus contact info.
+    module CalibrationLaboratory
+      def self.included(klass)
+        klass.class_eval do
+          attribute :id, :string
+          attribute :ref_id, :string
+          attribute :ref_type, :string
+          attribute :calibration_laboratory_code, :string
+          attribute :contact, :contact, collection: true
+
+          xml do
+            namespace ::Dcc::Namespace::Dcc
+            element "calibrationLaboratory"
+            ordered
+            map_attribute "id", to: :id
+            map_attribute "refId", to: :ref_id
+            map_attribute "refType", to: :ref_type
+            map_element "calibrationLaboratoryCode", to: :calibration_laboratory_code
+            map_element "contact", to: :contact
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/base/comment.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Base
+    # `dcc:comment` — wildcard (`xs:any namespace="##any"`) wrapper around
+    # arbitrary XML. The contents are preserved as a raw XML string; lutaml-model
+    # requires `map_all` to be the only mapping in a class, so the comment
+    # element lives in its own class referenced by `DigitalCalibrationCertificate`.
+    module Comment
+      def self.included(klass)
+        klass.class_eval do
+          attribute :raw, :string
+
+          xml do
+            namespace ::Dcc::Namespace::Dcc
+            element "comment"
+            map_all to: :raw
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/base/condition.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Base
+    # `dcc:conditionType` — single influence condition: name + description +
+    # optional state enum (beforeAdjustment, etc.) + data.
+    module Condition
+      def self.included(klass)
+        klass.class_eval do
+          attribute :id, :string
+          attribute :ref_id, :string
+          attribute :ref_type, :string
+          attribute :name, :text
+          attribute :description, :text
+          attribute :status, :string
+          attribute :data, :data, collection: true
+
+          xml do
+            namespace ::Dcc::Namespace::Dcc
+            element "influenceCondition"
+            ordered
+            map_attribute "id", to: :id
+            map_attribute "refId", to: :ref_id
+            map_attribute "refType", to: :ref_type
+            map_element "name", to: :name
+            map_element "description", to: :description
+            map_element "state", to: :status
+            map_element "data", to: :data
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/base/contact.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Base
+    # `dcc:contactType` — strict contact (location required). Used for
+    # calibrationLaboratory and customer.
+    module Contact
+      def self.included(klass)
+        klass.class_eval do
+          attribute :id, :string
+          attribute :ref_id, :string
+          attribute :ref_type, :string
+          attribute :name, :text
+          attribute :e_mail, :string
+          attribute :phone, :string
+          attribute :fax, :string
+          attribute :location, :location
+          attribute :description_data, :text
+
+          xml do
+            namespace ::Dcc::Namespace::Dcc
+            element "contact"
+            ordered
+            map_attribute "id", to: :id
+            map_attribute "refId", to: :ref_id
+            map_attribute "refType", to: :ref_type
+            map_element "name", to: :name
+            map_element "eMail", to: :e_mail
+            map_element "phone", to: :phone
+            map_element "fax", to: :fax
+            map_element "location", to: :location
+            map_element "descriptionData", to: :description_data
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/base/contact_not_strict.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Base
+    # `dcc:contactNotStrictType` — loose contact (location optional). Used for
+    # manufacturers and owners.
+    module ContactNotStrict
+      def self.included(klass)
+        klass.class_eval do
+          attribute :id, :string
+          attribute :ref_id, :string
+          attribute :ref_type, :string
+          attribute :name, :text
+          attribute :e_mail, :string
+          attribute :phone, :string
+          attribute :fax, :string
+          attribute :location, :location
+          attribute :description_data, :text
+
+          xml do
+            namespace ::Dcc::Namespace::Dcc
+            element "contactNotStrict"
+            ordered
+            map_attribute "id", to: :id
+            map_attribute "refId", to: :ref_id
+            map_attribute "refType", to: :ref_type
+            map_element "name", to: :name
+            map_element "eMail", to: :e_mail
+            map_element "phone", to: :phone
+            map_element "fax", to: :fax
+            map_element "location", to: :location
+            map_element "descriptionData", to: :description_data
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/base/core_data.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Base
+    # `dcc:coreDataType` — core administrative metadata: country, languages,
+    # unique identifier, dates, previous report, identifications.
+    module CoreData
+      def self.included(klass)
+        klass.class_eval do
+          attribute :id, :string
+          attribute :ref_id, :string
+          attribute :ref_type, :string
+          attribute :country_code_iso_3166_1, ::Dcc::Type::IsoCountryCode
+          attribute :used_lang_code_iso_639_1, ::Dcc::Type::IsoLanguageCode, collection: true
+          attribute :mandatory_lang_code_iso_639_1, ::Dcc::Type::IsoLanguageCode, collection: true
+          attribute :unique_identifier, :string
+          attribute :identifications, :identifications
+          attribute :receipt_date, :date
+          attribute :begin_performance_date, :date
+          attribute :end_performance_date, :date
+          attribute :previous_report, :previousReport
+
+          xml do
+            namespace ::Dcc::Namespace::Dcc
+            element "coreData"
+            ordered
+            map_attribute "id", to: :id
+            map_attribute "refId", to: :ref_id
+            map_attribute "refType", to: :ref_type
+            map_element "countryCodeISO3166_1", to: :country_code_iso_3166_1
+            map_element "usedLangCodeISO639_1", to: :used_lang_code_iso_639_1
+            map_element "mandatoryLangCodeISO639_1", to: :mandatory_lang_code_iso_639_1
+            map_element "uniqueIdentifier", to: :unique_identifier
+            map_element "identifications", to: :identifications
+            map_element "receiptDate", to: :receipt_date
+            map_element "beginPerformanceDate", to: :begin_performance_date
+            map_element "endPerformanceDate", to: :end_performance_date
+            map_element "previousReport", to: :previous_report
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/base/data.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Base
+    # `dcc:dataType` — the central xs:choice container. May hold any of:
+    # `text`, `formula`, `byteData`, `xml`, `quantity`, `list`. The XSD allows
+    # `maxOccurs="unbounded"` so any of the alternatives may repeat.
+    #
+    # We model each branch as a collection attribute; the version wrapper
+    # resolves `quantity` to the version-appropriate D-SI-aware type.
+    module Data
+      def self.included(klass)
+        klass.class_eval do
+          attribute :id, :string
+          attribute :ref_id, :string
+          attribute :ref_type, :string
+          attribute :text, :text, collection: true
+          attribute :formula, :formula, collection: true
+          attribute :byte_data, :byteData, collection: true
+          attribute :xml, :xml, collection: true
+          attribute :quantity, :quantity, collection: true
+          attribute :list, :list, collection: true
+
+          xml do
+            namespace ::Dcc::Namespace::Dcc
+            element "data"
+            ordered
+            map_attribute "id", to: :id
+            map_attribute "refId", to: :ref_id
+            map_attribute "refType", to: :ref_type
+            map_element "text", to: :text
+            map_element "formula", to: :formula
+            map_element "byteData", to: :byte_data
+            map_element "xml", to: :xml
+            map_element "quantity", to: :quantity
+            map_element "list", to: :list
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/base/digital_calibration_certificate.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Base
+    # `dcc:digitalCalibrationCertificateType` — the root element of every DCC
+    # document. Carries `schemaVersion` attribute plus four "rings":
+    # administrativeData, measurementResults, optional comment, optional
+    # document. From v3.4 also optional `ds:Signature` collection.
+    module DigitalCalibrationCertificate
+      def self.included(klass)
+        klass.class_eval do
+          attribute :schema_version, ::Dcc::Type::SchemaVersion
+          attribute :administrative_data, :administrativeData
+          attribute :measurement_results, :measurementResults
+          attribute :comment, :comment
+          attribute :document, :byteData
+
+          xml do
+            namespace ::Dcc::Namespace::Dcc
+            element "digitalCalibrationCertificate"
+            ordered
+            map_attribute "schemaVersion", to: :schema_version
+            map_element "administrativeData", to: :administrative_data
+            map_element "measurementResults", to: :measurement_results
+            map_element "comment", to: :comment
+            map_element "document", to: :document
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/base/equipment_class.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Base
+    # `dcc:equipmentClassType` — classification reference for measuring
+    # equipment. Carries a reference (URI) and a classID.
+    module EquipmentClass
+      def self.included(klass)
+        klass.class_eval do
+          attribute :reference, :string
+          attribute :class_id, :string
+
+          xml do
+            namespace ::Dcc::Namespace::Dcc
+            element "equipmentClass"
+            ordered
+            map_element "reference", to: :reference
+            map_element "classID", to: :class_id
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/base/formula.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "mml"
+
+module Dcc
+  module Base
+    # `dcc:formulaType` — formula expression. Contains `latex` string,
+    # `mathml` (a typed `Mml::V3::Math` model), or legacy `siunitx`.
+    module Formula
+      def self.included(klass)
+        klass.class_eval do
+          attribute :id, :string
+          attribute :ref_id, :string
+          attribute :ref_type, :string
+          attribute :latex, :string
+          attribute :mathml, ::Mml::V3::Math
+          attribute :siunitx, :string
+
+          xml do
+            namespace ::Dcc::Namespace::Dcc
+            element "formula"
+            map_attribute "id", to: :id
+            map_attribute "refId", to: :ref_id
+            map_attribute "refType", to: :ref_type
+            map_element "latex", to: :latex
+            map_element "mathml", to: :mathml
+            map_element "siunitx", to: :siunitx
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/base/hash_type.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Base
+    # `dcc:hashType` — reference to a previous report. Used by `previousReport`
+    # in `coreData`.
+    module HashType
+      def self.included(klass)
+        klass.class_eval do
+          attribute :referral, :string
+          attribute :referral_id, :string
+          attribute :procedure, :string
+          attribute :value, :string
+          attribute :description, :text
+          attribute :traceable, :boolean
+          attribute :in_validity_range, :boolean
+
+          xml do
+            namespace ::Dcc::Namespace::Dcc
+            element "previousReport"
+            ordered
+            map_element "referral", to: :referral
+            map_element "referralID", to: :referral_id
+            map_element "procedure", to: :procedure
+            map_element "value", to: :value
+            map_element "description", to: :description
+            map_element "traceable", to: :traceable
+            map_element "inValidityRange", to: :in_validity_range
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/base/identification.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Base
+    # `dcc:identificationType` — single identifier (issuer, value, optional
+    # description). Issuer enum: manufacturer, calibrationLaboratory, customer,
+    # owner, other.
+    module Identification
+      def self.included(klass)
+        klass.class_eval do
+          attribute :issuer, :string
+          attribute :value, :string
+          attribute :description, :text
+
+          xml do
+            namespace ::Dcc::Namespace::Dcc
+            element "identification"
+            ordered
+            map_element "issuer", to: :issuer
+            map_element "value", to: :value
+            map_element "description", to: :description
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/base/identifications.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Base
+    # `dcc:identificationListType` — collection of identifications.
+    module Identifications
+      def self.included(klass)
+        klass.class_eval do
+          attribute :id, :string
+          attribute :ref_id, :string
+          attribute :ref_type, :string
+          attribute :identification, :identification, collection: true
+
+          xml do
+            namespace ::Dcc::Namespace::Dcc
+            element "identifications"
+            ordered
+            map_attribute "id", to: :id
+            map_attribute "refId", to: :ref_id
+            map_attribute "refType", to: :ref_type
+            map_element "identification", to: :identification
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dcc/base/influence_condition.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Base
+    # Alias: an individual `dcc:influenceCondition` element IS a Condition.
+    # The XSD uses `conditionType` for the inner element. We expose both names
+    # for readability at the call site.
+    module InfluenceCondition
+      def self.included(klass)
+        klass.class_eval do
+          include ::Dcc::Base::Condition
+        end
+      end
+    end
+  end
+end

data/lib/dcc/base/influence_condition_list.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Base
+    # `dcc:influenceConditionListType` — collection of `dcc:influenceCondition`
+    # plus shared name/description/methods/software/equipment.
+    module InfluenceConditionList
+      def self.included(klass)
+        klass.class_eval do
+          attribute :id, :string
+          attribute :ref_id, :string
+          attribute :ref_type, :string
+          attribute :name, :text
+          attribute :description, :text
+          attribute :used_methods, :usedMethods
+          attribute :used_software, :softwareList
+          attribute :measuring_equipments, :measuringEquipments
+          attribute :influence_condition, :influenceCondition, collection: true
+          attribute :data, :data, collection: true
+
+          xml do
+            namespace ::Dcc::Namespace::Dcc
+            element "influenceConditions"
+            ordered
+            map_attribute "id", to: :id
+            map_attribute "refId", to: :ref_id
+            map_attribute "refType", to: :ref_type
+            map_element "name", to: :name
+            map_element "description", to: :description
+            map_element "usedMethods", to: :used_methods
+            map_element "usedSoftware", to: :used_software
+            map_element "measuringEquipments", to: :measuring_equipments
+            map_element "influenceCondition", to: :influence_condition
+            map_element "data", to: :data
+          end
+        end
+      end
+    end
+  end
+end