foobara 0.2.3 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8eba3fdf241f3d5a5d1d65eeefc6ccd39175e63c4c6d86ece37af0bfb1126d0
-  data.tar.gz: 3d398fc443f593da6c7e6348469e1d9fe500eb319e3e7859a57dc046b7b58009
+  metadata.gz: 7febf2c9b13ecbbbeb552dbfa7cf278805b60e808b01c64abcbd531264ff3486
+  data.tar.gz: 72386588ea5c433a61585c48cd904143baf9b04165a2c62328a87f089851c4d0
 SHA512:
-  metadata.gz: 01bf11b7499124317f6e941f0d0013eec1d0ccdc6132ed97e67b7b73a8a29b6820bb315fbc0c79dee7416cfe91ae7cb9c56c8b70ad197577981ec0288f39f64e
-  data.tar.gz: fff2fc836bada39c4302ad902462345bb7fcded4f2e74976ee862b24e1fbce66655fcc5f8171b3c2bf8b4d75564f772eb5afa50cdd90d452bb064002660c5753
+  metadata.gz: 746004fcedb4287688d6f333b02c50d1b083591837be43f762eb4916670c7c65640d0c9cbbc6a202aaff84a461a20dce5d59c7ba6bc46ce0c5ffa28754baa374
+  data.tar.gz: 1cae511fedd5916ec97c872eb07ffdae224f9cf76e6f2643de3138a4d146d1049bac68af3ed5ba60ec3b9778a779db051f067562ed64982e6bfeb16e4702e759

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+# [0.2.4] -2025-10-26
+
+- Remove all uses of .require_project_file and deprecate it
+- Replace custom WeakObjectHash with similar standard library ObjectSpace::WeakMap
+- Call #committed only after whole transaction has been fully committed
+- Add/fire a :persisted event for callbacks when an entity receives a primary key and is committed
+- Add Type#add_caster
+
 # [0.2.3] - 2025-10-22
 
 - Fix Persistence.register_base bug

data/README.md

@@ -2100,11 +2100,11 @@ TODO: give some code examples
 # Additional learning materials/Documentation
 
 * Overview and code demo videos:
-  * https://foobara.com/videos
+  * https://foobara.org/videos
   * https://www.youtube.com/@FoobaraFlix
 * YARD Docs
   * All docs combined: https://docs.foobara.com/all/
-  * Per-repository docs: https://foobara.com/docs
+  * Per-repository docs: https://foobara.org/docs
 
 # Help
 

data/projects/builtin_types/src/builtin_types.rb

@@ -1,7 +1,7 @@
 module Foobara
-  Foobara.require_project_file("builtin_types", "duck")
-  Foobara.require_project_file("builtin_types", "atomic_duck")
-  Foobara.require_project_file("builtin_types", "duckture")
+  require_relative "duck"
+  require_relative "atomic_duck"
+  require_relative "duckture"
 
   module BuiltinTypes
     class << self

data/projects/callback/src/registry/chained_multiple_action.rb

@@ -1,4 +1,4 @@
-Foobara.require_project_file("callback", "registry/multiple_action")
+require_relative "multiple_action"
 
 module Foobara
   module Callback

data/projects/callback/src/registry/conditioned.rb

@@ -1,4 +1,4 @@
-Foobara.require_project_file("callback", "registry/base")
+require_relative "base"
 
 module Foobara
   module Callback

data/projects/callback/src/registry/multiple_action.rb

@@ -1,4 +1,4 @@
-Foobara.require_project_file("callback", "registry/base")
+require_relative "base"
 
 module Foobara
   module Callback

data/projects/command_connectors/src/command_connector.rb

@@ -116,9 +116,10 @@ module Foobara
       end
     end
 
-    attr_accessor :command_registry, :authenticator, :capture_unknown_error
+    attr_accessor :command_registry, :authenticator, :capture_unknown_error, :name
 
-    def initialize(authenticator: nil,
+    def initialize(name: nil,
+                   authenticator: nil,
                    capture_unknown_error: nil,
                    default_serializers: nil,
                    default_pre_commit_transformers: nil)
@@ -127,6 +128,7 @@ module Foobara
       self.authenticator = authenticator
       self.command_registry = CommandRegistry.new(authenticator:)
       self.capture_unknown_error = capture_unknown_error
+      self.name = name
 
       Util.array(default_serializers).each do |serializer|
         add_default_serializer(serializer)

data/projects/command_connectors/src/serializers/errors_serializer.rb

@@ -1,5 +1,5 @@
 module Foobara
-  require_project_file("command_connectors", "serializer")
+  require_relative "../serializer"
 
   module CommandConnectors
     module Serializers

data/projects/command_connectors/src/serializers/success_serializer.rb

@@ -1,5 +1,5 @@
 module Foobara
-  require_project_file("command_connectors", "serializer")
+  require_relative "../serializer"
 
   module CommandConnectors
     module Serializers

data/projects/common/src/runtime_error.rb

@@ -1,4 +1,4 @@
-Foobara.require_project_file("common", "error")
+require_relative "error"
 
 module Foobara
   # NOTE: annoyingly this will clash with ::RuntimeError if not fully qualified when using

data/projects/foobara/lib/foobara/all.rb

@@ -16,7 +16,6 @@ module Foobara
   # could be independent projects
   projects "delegate", # Let's just kill delegate
            "concerns",
-           "weak_object_hash",
            "enumerated",
            "callback",
            "state_machine",

data/projects/foobara/src/foobara.rb

@@ -5,7 +5,10 @@ module Foobara
 
   class << self
     def require_project_file(project, path)
+      # :nocov:
+      warn "DEPRECATION WARNING: require_project_file is deprecated. Use require_relative instead."
       require_relative("../../#{project}/src/#{path}")
+      # :nocov:
     end
 
     attr_accessor :is_installed

data/projects/namespace/src/namespace.rb

@@ -51,7 +51,7 @@ module Foobara
       end
 
       def on_change(object, method_name)
-        @on_change ||= WeakObjectHash.new
+        @on_change ||= ObjectSpace::WeakMap.new
 
         @on_change[object] = method_name
       end

data/projects/persistence/src/entity_base/transaction/concerns/state_transitions.rb

@@ -60,6 +60,7 @@ module Foobara
               state_machine.commit! do
                 each_table(&:commit!)
                 entity_attributes_crud_driver.commit_transaction(raw_tx)
+                each_table(&:committed)
                 each_table(&:transaction_closed)
               end
             rescue => e

data/projects/persistence/src/entity_base/transaction_table/concerns/record_tracking.rb

@@ -86,6 +86,10 @@ module Foobara
             end
 
             def committed
+              marked_persisted.each do |record|
+                record.fire(:persisted)
+              end
+
               closed
             end
 
@@ -113,7 +117,8 @@ module Foobara
               :updated,
               :hard_deleted,
               :created,
-              :loading
+              :loading,
+              :persisted
             ]
 
             interesting_record_states.each do |state|

data/projects/persistence/src/entity_base/transaction_table.rb

@@ -656,6 +656,7 @@ module Foobara
             record.is_persisted = record.is_loaded = true
             record.is_created = false
             record.save_persisted_attributes
+            mark_persisted(record)
           end
 
           marked_created.clear
@@ -695,8 +696,6 @@ module Foobara
           validate!
           flush_created!
           flush_updated_and_hard_deleted!
-
-          committed
         end
 
         def revert!

data/projects/state_machine/src/state_machine.rb

@@ -1,8 +1,8 @@
 module Foobara
-  require_project_file("state_machine", "sugar")
-  require_project_file("state_machine", "callbacks")
-  require_project_file("state_machine", "validations")
-  require_project_file("state_machine", "transitions")
+  require_relative "sugar"
+  require_relative "callbacks"
+  require_relative "validations"
+  require_relative "transitions"
 
   # TODO: allow quick creation of a statemachine either through better options to #initialize or a
   # .for method.

data/projects/type_declarations/src/desugarizer.rb

@@ -1,4 +1,4 @@
-Foobara.require_project_file("type_declarations", "with_registries")
+require_relative "with_registries"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/handlers/extend_array_type_declaration/array_desugarizer.rb

@@ -1,5 +1,5 @@
-Foobara.require_project_file("type_declarations", "desugarizer")
-Foobara.require_project_file("type_declarations", "handlers/extend_associative_array_type_declaration")
+require_relative "../../desugarizer"
+require_relative "../extend_associative_array_type_declaration"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/handlers/extend_array_type_declaration/to_type_transformer.rb

@@ -1,5 +1,5 @@
-Foobara.require_project_file("type_declarations", "handlers/registered_type_declaration/to_type_transformer")
-Foobara.require_project_file("type_declarations", "handlers/extend_associative_array_type_declaration")
+require_relative "../registered_type_declaration/to_type_transformer"
+require_relative "../extend_associative_array_type_declaration"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/handlers/extend_associative_array_type_declaration/to_type_transformer.rb

@@ -1,7 +1,4 @@
-Foobara.require_project_file(
-  "type_declarations",
-  "handlers/extend_registered_type_declaration/to_type_transformer"
-)
+require_relative "../extend_registered_type_declaration/to_type_transformer"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/handlers/extend_associative_array_type_declaration.rb

@@ -1,4 +1,4 @@
-Foobara.require_project_file("type_declarations", "handlers/extend_registered_type_declaration")
+require_relative "extend_registered_type_declaration"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/handlers/extend_attributes_type_declaration/dsl_desugarizer.rb

@@ -1,4 +1,4 @@
-Foobara.require_project_file("type_declarations", "handlers/extend_attributes_type_declaration/hash_desugarizer")
+require_relative "hash_desugarizer"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/handlers/extend_attributes_type_declaration/element_type_declarations_desugarizer.rb

@@ -1,6 +1,6 @@
-Foobara.require_project_file("type_declarations", "desugarizer")
-Foobara.require_project_file("type_declarations", "handlers/extend_associative_array_type_declaration")
-Foobara.require_project_file("type_declarations", "handlers/extend_attributes_type_declaration/hash_desugarizer")
+require_relative "../../desugarizer"
+require_relative "../extend_associative_array_type_declaration"
+require_relative "hash_desugarizer"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/handlers/extend_attributes_type_declaration/hash_desugarizer.rb

@@ -1,5 +1,5 @@
-Foobara.require_project_file("type_declarations", "desugarizer")
-Foobara.require_project_file("type_declarations", "handlers/extend_associative_array_type_declaration")
+require_relative "../../desugarizer"
+require_relative "../extend_associative_array_type_declaration"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/handlers/extend_attributes_type_declaration/to_type_transformer.rb

@@ -1,5 +1,5 @@
-Foobara.require_project_file("type_declarations", "handlers/registered_type_declaration/to_type_transformer")
-Foobara.require_project_file("type_declarations", "handlers/extend_associative_array_type_declaration")
+require_relative "../registered_type_declaration/to_type_transformer"
+require_relative "../extend_associative_array_type_declaration"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/handlers/extend_registered_type_declaration/to_type_transformer.rb

@@ -1,5 +1,5 @@
-Foobara.require_project_file("type_declarations", "handlers/registered_type_declaration/to_type_transformer")
-Foobara.require_project_file("type_declarations", "handlers/extend_associative_array_type_declaration")
+require_relative "../registered_type_declaration/to_type_transformer"
+require_relative "../extend_associative_array_type_declaration"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/handlers/extend_registered_type_declaration.rb

@@ -1,4 +1,4 @@
-Foobara.require_project_file("type_declarations", "handlers/registered_type_declaration")
+require_relative "registered_type_declaration"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/handlers/extend_tuple_type_declaration/array_desugarizer.rb

@@ -1,5 +1,5 @@
-Foobara.require_project_file("type_declarations", "desugarizer")
-Foobara.require_project_file("type_declarations", "handlers/extend_associative_array_type_declaration")
+require_relative "../../desugarizer"
+require_relative "../extend_associative_array_type_declaration"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/handlers/extend_tuple_type_declaration/to_type_transformer.rb

@@ -1,5 +1,5 @@
-Foobara.require_project_file("type_declarations", "handlers/registered_type_declaration/to_type_transformer")
-Foobara.require_project_file("type_declarations", "handlers/extend_associative_array_type_declaration")
+require_relative "../registered_type_declaration/to_type_transformer"
+require_relative "../extend_associative_array_type_declaration"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/handlers/registered_type_declaration/to_type_transformer.rb

@@ -1,4 +1,4 @@
-Foobara.require_project_file("type_declarations", "to_type_transformer")
+require_relative "../../to_type_transformer"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/handlers/registered_type_declaration.rb

@@ -1,4 +1,4 @@
-Foobara.require_project_file("type_declarations", "type_declaration_handler")
+require_relative "../type_declaration_handler"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/to_type_transformer.rb

@@ -1,4 +1,4 @@
-Foobara.require_project_file("type_declarations", "transformer")
+require_relative "transformer"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/type_declaration_handler.rb

@@ -1,4 +1,4 @@
-Foobara.require_project_file("type_declarations", "with_registries")
+require_relative "with_registries"
 
 module Foobara
   module TypeDeclarations

data/projects/type_declarations/src/type_declarations.rb

@@ -1,8 +1,8 @@
 require "inheritable_thread_vars"
 
 module Foobara
-  require_project_file("type_declarations", "type_builder")
-  require_project_file("type_declarations", "error_extension")
+  require_relative "type_builder"
+  require_relative "error_extension"
 
   module TypeDeclarations
     module Mode

data/projects/types/src/type.rb

@@ -346,6 +346,11 @@ module Foobara
         @casters = processors
       end
 
+      def add_caster(processor)
+        casters << processor
+        clear_caches
+      end
+
       def transformers=(processors)
         clear_caches
         @transformers = processors

data/projects/value/lib/foobara/value.rb

@@ -3,5 +3,5 @@ module Foobara
     foobara_domain!
   end
 
-  Foobara.require_project_file("value", "processor")
+  require_relative "../../src/processor"
 end

data/projects/value/src/processor/casting.rb

@@ -1,4 +1,4 @@
-Foobara.require_project_file("value", "data_error")
+require_relative "../data_error"
 
 module Foobara
   module Value

data/projects/value/src/processor/pipeline.rb

@@ -1,4 +1,4 @@
-Foobara.require_project_file("value", "processor/multi")
+require_relative "multi"
 
 module Foobara
   module Value

data/projects/value/src/processor/selection.rb

@@ -1,5 +1,5 @@
-Foobara.require_project_file("value", "processor/multi")
-Foobara.require_project_file("value", "data_error")
+require_relative "multi"
+require_relative "../data_error"
 
 module Foobara
   module Value

data/projects/value/src/transformer.rb

@@ -1,6 +1,6 @@
 require "securerandom"
 
-Foobara.require_project_file("value", "processor/runner")
+require_relative "processor/runner"
 
 module Foobara
   module Value

data/version.rb

@@ -1,6 +1,6 @@
 module Foobara
   module Version
-    VERSION = "0.2.3".freeze
+    VERSION = "0.2.4".freeze
     MINIMUM_RUBY_VERSION = ">= 3.4.0".freeze
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: foobara
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.4
 platform: ruby
 authors:
 - Miles Georgi
@@ -491,16 +491,14 @@ files:
 - projects/value/src/processor/selection.rb
 - projects/value/src/transformer.rb
 - projects/value/src/validator.rb
-- projects/weak_object_hash/lib/foobara/weak_object_hash.rb
-- projects/weak_object_hash/src/weak_object_hash.rb
 - projects/weak_object_set/lib/foobara/weak_object_set.rb
 - projects/weak_object_set/src/weak_object_set.rb
 - version.rb
-homepage: https://foobara.com
+homepage: https://foobara.org
 licenses:
 - MPL-2.0
 metadata:
-  homepage_uri: https://foobara.com
+  homepage_uri: https://foobara.org
   source_code_uri: https://github.com/foobara/foobara
   changelog_uri: https://github.com/foobara/foobara/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
@@ -531,7 +529,6 @@ require_paths:
 - "./projects/type_declarations/lib"
 - "./projects/types/lib"
 - "./projects/value/lib"
-- "./projects/weak_object_hash/lib"
 - "./projects/weak_object_set/lib"
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:

data/projects/weak_object_hash/lib/foobara/weak_object_hash.rb

@@ -1,3 +0,0 @@
-require "weakref"
-
-class Foobara::WeakObjectHash; end

data/projects/weak_object_hash/src/weak_object_hash.rb

@@ -1,225 +0,0 @@
-require "monitor"
-
-module Foobara
-  # TODO: a possible optimization: have a certain number of records before the Weakref approach kicks in
-  # that way we don't just immediately clear out useful information without any actual memory burden
-  class WeakObjectHash
-    class ClosedError < StandardError; end
-
-    def initialize(skip_finalizer: false)
-      if skip_finalizer
-        self.skip_finalizer = true
-      end
-      self.monitor = Monitor.new
-      self.object_ids_to_weak_refs_and_values = {}
-    end
-
-    def []=(object, value)
-      object_id = object.object_id
-      weak_ref = WeakRef.new(object)
-
-      if closed?
-        raise ClosedError, "Cannot add objects to a closed WeakObjectHash"
-      end
-
-      monitor.synchronize do
-        delete(object)
-
-        object_ids_to_weak_refs_and_values[object_id] = [weak_ref, value]
-
-        unless skip_finalizer?
-          ObjectSpace.define_finalizer(object, finalizer_proc)
-        end
-
-        value
-      end
-    end
-
-    def [](object)
-      object_id = object.object_id
-
-      if closed?
-        raise ClosedError, "Cannot retrieve objects from a closed WeakObjectHash"
-      end
-
-      monitor.synchronize do
-        pair = object_ids_to_weak_refs_and_values[object_id]
-
-        return nil unless pair
-
-        weak_ref, value = pair
-
-        if weak_ref.weakref_alive?
-          if skip_finalizer?
-            if weak_ref.__getobj__ == object
-              value
-            else
-              # :nocov:
-              object_ids_to_weak_refs_and_values.delete(object_id)
-              nil
-              # :nocov:
-            end
-          else
-            value
-          end
-        else
-          # Seems unreachable... if it's been garbage collected how could we have a reference to the object
-          # to pass it in?
-          # :nocov:
-          object_ids_to_weak_refs_and_values.delete(object_id)
-          nil
-          # :nocov:
-        end
-      end
-    end
-
-    def delete(object)
-      object_id = object.object_id
-
-      monitor.synchronize do
-        pair = object_ids_to_weak_refs_and_values.delete(object_id)
-
-        return nil unless pair
-
-        weak_ref, value = pair
-
-        if weak_ref.weakref_alive?
-
-          if skip_finalizer?
-            if weak_ref.__getobj__ == object
-              value
-            end
-          else
-            # Hmmm, there's seemingly no safe way to remove the finalizer for the previous entry
-            # if it exists. This is because we can only remove all finalizers on object. Not only
-            # the ones we've created.
-            # We will just do this anyway with that caveat and maybe make this configuratble in the future.
-            unless skip_finalizer?
-              ObjectSpace.undefine_finalizer(object)
-            end
-
-            value
-          end
-        end
-      end
-    end
-
-    def each_pair
-      monitor.synchronize do
-        object_ids_to_weak_refs_and_values.each_pair do |object_id, pair|
-          weak_ref, value = pair
-
-          if weak_ref.weakref_alive?
-            yield weak_ref.__getobj__, value
-          else
-            object_ids_to_weak_refs_and_values.delete(object_id)
-          end
-        end
-      end
-
-      self
-    end
-
-    def values
-      values = []
-
-      monitor.synchronize do
-        each_pair do |_key, value|
-          values << value
-        end
-      end
-
-      values
-    end
-
-    def keys
-      keys = []
-
-      monitor.synchronize do
-        each_pair do |key, _value|
-          keys << key
-        end
-      end
-
-      keys
-    end
-
-    def size
-      size = 0
-      to_delete = nil
-
-      monitor.synchronize do
-        object_ids_to_weak_refs_and_values.each_pair do |object_id, pair|
-          weak_ref = pair.first
-
-          if weak_ref.weakref_alive?
-            size += 1
-          else
-            to_delete ||= []
-            to_delete << object_id
-          end
-        end
-
-        to_delete&.each do |object_id|
-          object_ids_to_weak_refs_and_values.delete(object_id)
-        end
-      end
-
-      size
-    end
-
-    def empty?
-      size == 0
-    end
-
-    def close!
-      if closed?
-        raise ClosedError, "Already closed"
-      end
-
-      monitor.synchronize do
-        self.closed = true
-        clear
-        @finalizer_proc = nil
-        self.object_ids_to_weak_refs_and_values = nil
-        self.monitor = nil
-      end
-    end
-
-    def clear
-      monitor.synchronize do
-        unless skip_finalizer?
-          object_ids_to_weak_refs_and_values.each_value do |pair|
-            weak_ref = pair.first
-
-            if weak_ref.weakref_alive?
-              ObjectSpace.undefine_finalizer(weak_ref.__getobj__)
-            end
-          end
-        end
-
-        object_ids_to_weak_refs_and_values.clear
-      end
-    end
-
-    def closed?
-      closed
-    end
-
-    def skip_finalizer?
-      @skip_finalizer
-    end
-
-    private
-
-    attr_accessor :object_ids_to_weak_refs_and_values, :monitor, :closed, :skip_finalizer
-
-    def finalizer_proc
-      @finalizer_proc ||= ->(object_id) do
-        unless closed?
-          object_ids_to_weak_refs_and_values.delete(object_id)
-        end
-      end
-    end
-  end
-end