lode 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18f3728eb2391285467b9dbdf6cda694bdf8ee167b9f84b8d9f60e4869938d67
-  data.tar.gz: cd5e03ccd6554d48c09e67514cd82c427cc636be527f351311089a6cbcdcfd93
+  metadata.gz: 53547ef20d061cc6875625c4a82430c5a7c6b6d1826b41b56f16446ec9202085
+  data.tar.gz: d22865856c792c76dee3e58b8106285683d0fc2e78f752c69bc7603bb3581eb8
 SHA512:
-  metadata.gz: 0da905f28b4ac347b4bebe53a0bb58c87f185fe2f948bbf3e3e13af8f6a3461fe768848f69351f4767f50a10e34914ae71290125ab6e4af03affd7fcc0f851b0
-  data.tar.gz: 63b9f264fd388402cfd00a5cfab3062c7bed11f49738ec3cae760b579d26a26d6a49b635482b8181b0a3b462b2f24dd693f7d764595a660c063eaadb585867e9
+  metadata.gz: b6cafe0d0ffdec73e06a76994bfdae4b9b4c9f3acb3e29a0415148ef6c00ea0163fef33afeef9224b2d1d468025385bc33fed160bc3b2708afbdab9f2433bd65
+  data.tar.gz: 590792995478977eb6e4abdf626a25e32d0c830154857f1fa6480d059acea8fdae0f6c968d6c655034e68c6ecbb642fed6208107e22c9d2e1595e25976b1702a

data/README.adoc

@@ -9,9 +9,9 @@
 
 = Lode
 
-Lode -- as in a geological deposit or a vein of minerals -- is a {pstore_link} of object data that can be mined for valuable information.
+Lode -- as in geological deposit or a vein of minerals -- is a {pstore_link} of object data that can be mined for valuable information.
 
-As noted in the {pstore_link} documentation all objects are marshaled which is not without caveats and dangers but, if you only need a simple object store, {pstore_link} is a solution. Lode takes this a step further by allowing you to have a pipeline workflow with a Domain Specific Language (DSL) for creating, updating, finding, and deleting records.
+As noted in the {pstore_link} documentation all objects are marshaled which is not without caveats and dangers but, if you only need a simple object store, {pstore_link} is a solution. Lode takes this a step further by allowing you to have a pipeline workflow along with a Domain Specific Language (DSL) for creating, updating, finding, and deleting records.
 
 toc::[]
 
@@ -141,6 +141,19 @@ Each key can be configured as follows:
 * `primary_key`: Defines the primary key used when interacting with your table of records (useful when finding or upserting records). Default: `:id`.
 * `registry`: Used for registering default settings for your tables. _This is not meant to be used directly_ but is documented for transparency.
 
+=== Paths
+
+Upon initialization, and when given a file, the file is only created once you start saving records. Although, when given a nested path, the full parent path will be created in anticipation of the file eventually being created. Example:
+
+[source,ruby]
+----
+# The file, "demo.store", is not created until data is saved.
+Lode.new "demo.store"
+
+# The path, "a/nested/path", will be created so `demo.store` can eventually be saved.
+Lode.new "a/nested/path/demo.store"
+----
+
 === Registry
 
 The registry is part of the configuration and directly accessible via a Lode instance. The registry allows you to customize individual table behavior as desired. For instance, you could have a `Hash` table or value table (i.e. `Data`, `Struct`, etc). Additionally, each table can have different primary keys too. The registry accepts three arguments in this format:

data/lib/lode/client.rb

@@ -1,12 +1,15 @@
 # frozen_string_literal: true
 
 require "forwardable"
+require "refinements/pathname"
 
 module Lode
   # Provides an enhanced PStore-based client.
   class Client
     extend Forwardable
 
+    using Refinements::Pathname
+
     attr_reader :path, :store
 
     delegate %i[register registry] => :configuration
@@ -14,7 +17,7 @@ module Lode
     def initialize path, configuration: Configuration.new
       yield configuration if block_given?
 
-      @path = path
+      @path = Pathname(path).make_ancestors
       @configuration = configuration
       @store = configuration.store_for path
     end

data/lib/lode/refines/persistent_store.rb

@@ -5,7 +5,7 @@ require "refinements/array"
 
 module Lode
   module Refines
-    # Refined and enhanced PStore functionality.
+    # Refines and enhances PStore functionality.
     module PersistentStore
       using Refinements::Array
 

data/lode.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "lode"
-  spec.version = "1.0.0"
+  spec.version = "1.0.1"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/lode"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lode
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -35,7 +35,7 @@ cert_chain:
   3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
   gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2024-01-01 00:00:00.000000000 Z
+date: 2024-01-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-monads
@@ -125,7 +125,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.5.4
 signing_key:
 specification_version: 4
 summary: A monadic store of marshaled objects.