lutaml-store 0.2.4 → 0.3.0

data/lib/lutaml/store/source.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Lutaml
+  module Store
+    # Read-only views over a LutaML data repository.
+    #
+    # A source answers four questions about a remote or local collection of
+    # LutaML records: does a key exist, what are its bytes, which keys exist,
+    # and what does the repository's manifest declare. Sources never write.
+    #
+    # Selection is explicit: `Source.for(type, options)` raises
+    # `ConfigurationError` for a missing option — there is no discovery,
+    # no environment guessing and no fallback between sources. Consumers
+    # compose sources with {Repository} for caching policies.
+    module Source
+      autoload :Base, "lutaml/store/source/base"
+      autoload :Directory, "lutaml/store/source/directory"
+      autoload :Zip, "lutaml/store/source/zip"
+      autoload :Https, "lutaml/store/source/https"
+      autoload :Rest, "lutaml/store/source/rest"
+
+      TYPES = {
+        directory: "Directory",
+        zip: "Zip",
+        https: "Https",
+        rest: "Rest"
+      }.freeze
+
+      class << self
+        # Builds an explicitly configured source.
+        #
+        # @param type [Symbol] one of {TYPES}
+        # @param options [Hash] passed to the source class
+        # @return [Source::Base]
+        def for(type, **options)
+          name = TYPES[type.to_sym]
+          raise ConfigurationError, "unknown source type: #{type.inspect}" unless name
+
+          Source.const_get(name).new(**options)
+        end
+
+        # A key is percent-encoded into exactly one path segment, so storage
+        # keys like "RFC 3986" or "ISO/IEC DIR 1" map to one file each on
+        # every platform. The manifest keeps the real key.
+        def encode_key(key)
+          CGI.escape(key.to_s)
+        end
+
+        def decode_key(segment)
+          CGI.unescape(segment.to_s)
+        end
+      end
+    end
+  end
+end

data/lib/lutaml/store/version.rb

@@ -2,6 +2,6 @@
 
 module Lutaml
   module Store
-    VERSION = "0.2.4"
+    VERSION = "0.3.0"
   end
 end

data/lib/lutaml/store.rb

@@ -5,6 +5,7 @@ module Lutaml
     class Error < StandardError; end
     class ConfigurationError < Error; end
     class BackendError < Error; end
+    class NotFoundError < Error; end
     class ModelNotRegisteredError < Error; end
     class InvalidKeyError < Error; end
     class PolymorphicUpdateError < Error; end
@@ -39,6 +40,10 @@ module Lutaml
     autoload :HttpCacheConfig, "lutaml/store/http_cache_config"
     autoload :HttpCacheEntry, "lutaml/store/http_cache_entry"
     autoload :HttpHeaderProcessor, "lutaml/store/http_header_processor"
+    autoload :Manifest, "lutaml/store/manifest"
+    autoload :Mirror, "lutaml/store/mirror"
+    autoload :Repository, "lutaml/store/repository"
+    autoload :Source, "lutaml/store/source"
 
     def self.new(adapter:, models: [], **options)
       DatabaseStore.new(adapter: adapter, models: models, **options)

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: lutaml-store
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.3.0
 platform: ruby
 authors:
 - Ronald Tse
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-17 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lutaml-model
@@ -61,6 +60,24 @@ files:
 - CODE_OF_CONDUCT.md
 - README.adoc
 - Rakefile
+- docs/astro.config.mjs
+- docs/package-lock.json
+- docs/package.json
+- docs/public/favicon.svg
+- docs/public/lutaml-logo_logo-full-dark.svg
+- docs/public/lutaml-logo_logo-full-light.svg
+- docs/src/layouts/Base.astro
+- docs/src/layouts/Docs.astro
+- docs/src/pages/adapters.md
+- docs/src/pages/architecture.md
+- docs/src/pages/cloud-contract.md
+- docs/src/pages/formats.md
+- docs/src/pages/http-cache.md
+- docs/src/pages/index.md
+- docs/src/pages/quick-start.md
+- docs/src/pages/sources.md
+- docs/src/pages/stores.md
+- docs/src/styles/global.css
 - lib/lutaml/store.rb
 - lib/lutaml/store/adapter.rb
 - lib/lutaml/store/adapter/base.rb
@@ -90,6 +107,8 @@ files:
 - lib/lutaml/store/http_cache_entry.rb
 - lib/lutaml/store/http_header_processor.rb
 - lib/lutaml/store/integrity.rb
+- lib/lutaml/store/manifest.rb
+- lib/lutaml/store/mirror.rb
 - lib/lutaml/store/model_registration.rb
 - lib/lutaml/store/model_registry.rb
 - lib/lutaml/store/model_serializer.rb
@@ -102,6 +121,13 @@ files:
 - lib/lutaml/store/package_transport/zip_transport.rb
 - lib/lutaml/store/predicate.rb
 - lib/lutaml/store/query.rb
+- lib/lutaml/store/repository.rb
+- lib/lutaml/store/source.rb
+- lib/lutaml/store/source/base.rb
+- lib/lutaml/store/source/directory.rb
+- lib/lutaml/store/source/https.rb
+- lib/lutaml/store/source/rest.rb
+- lib/lutaml/store/source/zip.rb
 - lib/lutaml/store/storage_key.rb
 - lib/lutaml/store/version.rb
 - sig/lutaml/store.rbs
@@ -113,7 +139,6 @@ metadata:
   source_code_uri: https://github.com/lutaml/lutaml-store
   changelog_uri: https://github.com/lutaml/lutaml-store
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -128,8 +153,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Store-centric database-style API for Lutaml::Model with multi-backend persistence.
 test_files: []