opencdd 0.1.1 → 0.2.1

data/lib/opencdd/parcel/versioned_reader.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module Opencdd
+  module Parcel
+    # Reads historical versions of entities from a sharded
+    # per-version Parcel layout.
+    #
+    # The sharded layout stores every version of an entity in a
+    # per-UNID subfolder: +<entity_dir>/<UNID>/export_*.xls+. The
+    # +_entity.json+ sidecar lists every version and which UNID is
+    # current. ShardedDirReader reads only the current version;
+    # VersionedReader exposes the full history.
+    #
+    # Delegates to:
+    #   - +Opencdd::Parcel::EntityManifest+ for version metadata.
+    #   - +Opencdd::Parcel::FlatDirReader+ for xls parsing of one
+    #     version's subfolder.
+    #
+    # Example:
+    #   reader = Opencdd::Parcel::VersionedReader.new("downloads/iec63213")
+    #   reader.versions_for("KEA012")    # => 3 VersionHistory::Entry
+    #   reader.load_version("KEA012", "ABC123...") # => Database with v002 content
+    class VersionedReader
+      attr_reader :path
+
+      def initialize(path)
+        @path = path
+      end
+
+      # All versions recorded for +code+, as
+      # +Opencdd::Entity::VersionHistory::Entry+ instances.
+      # Empty +VersionHistory+ if +code+ has no manifest.
+      def versions_for(code)
+        manifest = manifest_for(code)
+        return Opencdd::Entity::VersionHistory.new unless manifest
+        manifest.version_history
+      end
+
+      # Load a single historical version's content as a standalone
+      # Database. The +unid+ identifies which version's subfolder
+      # to read.
+      #
+      # Returns +nil+ if the version subfolder doesn't exist or has
+      # no +.xls+ files. The returned database is finalized but not
+      # cross-linked to other entities (historical context only).
+      def load_version(code, unid)
+        version_dir = version_dir_for(code, unid)
+        return nil unless version_dir && File.directory?(version_dir)
+        return nil unless Dir.children(version_dir).any? { |f| Opencdd::Parcel::LayoutDetector.legacy_export?(f) }
+
+        workbook = Opencdd::Parcel::FlatDirReader.new(version_dir).read_workbook
+        database = Opencdd::Database.new
+        database.add_workbook(workbook)
+        attach_version_history(database, code)
+        database.finalize!
+        database
+      end
+
+      # The entity subdirectory for +code+. Tries both the legacy
+      # +<path>/<code>+ layout and the manifest-driven
+      # +<path>/_entities/<code>+ layout.
+      def entity_dir_for(code)
+        flat = File.join(@path, code)
+        return flat if File.directory?(flat)
+        sharded = File.join(@path, "_entities", code)
+        return sharded if File.directory?(sharded)
+        nil
+      end
+
+      private
+
+      def manifest_for(code)
+        dir = entity_dir_for(code)
+        return nil unless dir
+        Opencdd::Parcel::EntityManifest.read(dir)
+      end
+
+      def version_dir_for(code, unid)
+        dir = entity_dir_for(code)
+        return nil unless dir
+        candidate = File.join(dir, unid)
+        return candidate if File.directory?(candidate)
+        nil
+      end
+
+      def attach_version_history(database, code)
+        manifest = manifest_for(code)
+        return unless manifest
+        return if manifest.versions_empty?
+        manifest.version_history.entries.each do |entry|
+          next unless entry.unid
+          target = database.find_by_code(code)
+          target&.attach_version_history(manifest.version_history)
+          break
+        end
+      end
+    end
+  end
+end

data/lib/opencdd/parcel.rb

@@ -12,6 +12,7 @@ module Opencdd
     autoload :WorkbookReader,  "opencdd/parcel/workbook_reader"
     autoload :FlatDirReader,   "opencdd/parcel/flat_dir_reader"
     autoload :ShardedDirReader, "opencdd/parcel/sharded_dir_reader"
+    autoload :VersionedReader,  "opencdd/parcel/versioned_reader"
     autoload :LayoutDetector,  "opencdd/parcel/layout_detector"
     autoload :EntityManifest,  "opencdd/parcel/entity_manifest"
     autoload :ReferencedIrdis,  "opencdd/parcel/referenced_irdis"

data/lib/opencdd/validator/runner.rb

@@ -77,7 +77,7 @@ module Opencdd
         base = column_iri.to_s.split(".").first
         entry = Opencdd::PropertyIds::REGISTRY[base]
         kind = entry&.value_kind
-        column_schema = schema&.column_for(base)
+        column_schema = schema&.find_by_property_id(base)
         RuleContext.new(
           database: database,
           entity: entity,

data/lib/opencdd/version.rb

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

data/lib/opencdd.rb

@@ -36,6 +36,7 @@ module Opencdd
   autoload :Reader,              "opencdd/reader"
   autoload :ClassTree,           "opencdd/class_tree"
   autoload :Visitor,             "opencdd/visitor"
+  autoload :EntityDiff,          "opencdd/entity_diff"
 
   autoload :Parcel, "opencdd/parcel"
 

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: opencdd
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.1
 platform: ruby
 authors:
 - OpenCDD contributors
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-07-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: roo
@@ -229,11 +230,18 @@ files:
 - lib/opencdd/condition.rb
 - lib/opencdd/data_type.rb
 - lib/opencdd/database.rb
+- lib/opencdd/database/finalization.rb
+- lib/opencdd/database/mutations.rb
+- lib/opencdd/database/parcel_integration.rb
+- lib/opencdd/database/persistence.rb
+- lib/opencdd/database/queries.rb
 - lib/opencdd/effective_properties.rb
 - lib/opencdd/entity.rb
 - lib/opencdd/entity/field_reader.rb
 - lib/opencdd/entity/field_registry.rb
 - lib/opencdd/entity/version_history.rb
+- lib/opencdd/entity/yaml.rb
+- lib/opencdd/entity_diff.rb
 - lib/opencdd/exporters.rb
 - lib/opencdd/exporters/json.rb
 - lib/opencdd/exporters/mermaid.rb
@@ -247,7 +255,6 @@ files:
 - lib/opencdd/model.rb
 - lib/opencdd/model/entity_store.rb
 - lib/opencdd/model/yaml_database.rb
-- lib/opencdd/model/yaml_entity.rb
 - lib/opencdd/parcel.rb
 - lib/opencdd/parcel/csv_reader.rb
 - lib/opencdd/parcel/csv_writer.rb
@@ -262,6 +269,7 @@ files:
 - lib/opencdd/parcel/sheet.rb
 - lib/opencdd/parcel/sheet_emitter.rb
 - lib/opencdd/parcel/sheet_schema.rb
+- lib/opencdd/parcel/versioned_reader.rb
 - lib/opencdd/parcel/workbook.rb
 - lib/opencdd/parcel/workbook_reader.rb
 - lib/opencdd/parcel/writer.rb
@@ -305,6 +313,7 @@ metadata:
   homepage_uri: https://github.com/opencdd/opencdd-ruby
   source_code_uri: https://github.com/opencdd/opencdd-ruby
   changelog_uri: https://github.com/opencdd/opencdd-ruby/releases
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -319,7 +328,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Ruby model and Parcel-format importer for the IEC Common Data Dictionary
 test_files: []