fixtury 0.4.1 → 1.0.0.beta2

data/lib/fixtury.rb

@@ -1,14 +1,33 @@
 # frozen_string_literal: true
 
 require "active_support/concern"
+require "active_support/core_ext/array/extract_options"
 require "active_support/core_ext/module/attribute_accessors"
 require "active_support/core_ext/module/delegation"
+require "active_support/core_ext/object/acts_like"
+require "active_support/core_ext/object/blank"
+
 require "fixtury/version"
-require "fixtury/schema"
+
+require "fixtury/configuration"
+require "fixtury/definition_executor"
+require "fixtury/dependency"
+require "fixtury/dependency_store"
+require "fixtury/errors"
+require "fixtury/hooks"
 require "fixtury/locator"
+require "fixtury/path_resolver"
+require "fixtury/reference"
 require "fixtury/store"
 
-# Top level namespace of the gem
+require "fixtury/schema_node"
+require "fixtury/definition"
+require "fixtury/schema"
+
+
+# Top level namespace of the gem. The accessors provided on the Fixtury namespace are meant to be shared
+# across the entire application. The Fixtury::Schema instance is the primary interface for defining and
+# accessing fixtures and can be accessed via Fixtury.schema.
 module Fixtury
 
   LOG_LEVELS = {
@@ -20,29 +39,79 @@ module Fixtury
 
   DEFAULT_LOG_LEVEL = LOG_LEVEL_INFO
 
+  def self.configuration
+    @configuration ||= ::Fixtury::Configuration.new
+    yield @configuration if block_given?
+    @configuration
+  end
+
+  def self.configure(&block)
+    self.configuration(&block)
+  end
+
+
   # Shortcut for opening the top level schema.
   def self.define(&block)
     schema.define(&block)
     schema
   end
 
+  # Global hooks accessor. Fixtury will call these hooks at various points in the lifecycle of a fixture or setup.
+  def self.hooks
+    @hooks ||= ::Fixtury::Hooks.new
+  end
+
   # The default top level schema. Fixtury::Schema instances can be completely self-contained but most
   # usage would be through this shared definition.
   def self.schema
-    @schema ||= ::Fixtury::Schema.new(parent: nil, name: "")
+    @schema ||= ::Fixtury::Schema.new
   end
 
-  def self.log_level
-    return @log_level if @log_level
+  def self.schema=(schema)
+    @schema = schema
+  end
+
+  # Default store for fixtures. This is a shared store that can be used across the application.
+  def self.store
+    @store ||= ::Fixtury::Store.new
+  end
+
+  def self.store=(store)
+    @store = store
+  end
+
+  # Require each schema file to ensure that all definitions are loaded.
+  def self.load_all_schemas
+    configuration.fixture_files.each do |filepath|
+      require filepath
+    end
+  end
 
-    @log_level = ENV["FIXTURY_LOG_LEVEL"]
-    @log_level ||= DEFAULT_LOG_LEVEL
-    @log_level = @log_level.to_s.to_sym
-    @log_level
+  # Ensure all definitions are loaded and then load all known fixtures.
+  def self.load_all_fixtures
+    load_all_schemas
+    Fixtury.store.load_all
   end
 
-  def self.log(text = nil, level: LOG_LEVEL_DEBUG, name: nil)
-    desired_level = LOG_LEVELS.fetch(log_level) { DEFAULT_LOG_LEVEL }
+  # Remove all references from the active store and reset the dependency file
+  def self.reset
+    log("resetting", level: LOG_LEVEL_INFO)
+
+    configuration.reset
+    store.reset
+  end
+
+  # Perform a reset if any of the tracked files have changed.
+  def self.reset_if_changed
+    if configuration.files_changed?
+      reset
+    else
+      log("no changes, skipping reset", level: LOG_LEVEL_INFO)
+    end
+  end
+
+  def self.log(text = nil, level: LOG_LEVEL_DEBUG, name: nil, newline: true)
+    desired_level = LOG_LEVELS.fetch(configuration.log_level) { DEFAULT_LOG_LEVEL }
     return if desired_level == LOG_LEVEL_NONE
 
     message_level = LOG_LEVELS.fetch(level) { LOG_LEVEL_DEBUG }
@@ -53,7 +122,10 @@ module Fixtury
     msg << "]"
     msg << " #{text}" if text
     msg << " #{yield}" if block_given?
-    puts msg
+    msg << "\n" if newline
+
+    print msg
+    msg
   end
 
 end

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: fixtury
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 1.0.0.beta2
 platform: ruby
 authors:
 - Mike Nelson
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-11-05 00:00:00.000000000 Z
+date: 2024-03-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: autotest
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -25,21 +25,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: byebug
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: byebug
+  name: globalid
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -53,7 +53,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: globalid
+  name: activerecord
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -67,21 +67,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: minitest
+  name: m
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: minitest-reporters
+  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -112,18 +112,18 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: sqlite
+  name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -136,7 +136,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: 
+description:
 email:
 - mike@guideline.com
 executables: []
@@ -154,24 +154,24 @@ files:
 - bin/setup
 - fixtury.gemspec
 - lib/fixtury.rb
+- lib/fixtury/configuration.rb
 - lib/fixtury/definition.rb
 - lib/fixtury/definition_executor.rb
-- lib/fixtury/errors/already_defined_error.rb
-- lib/fixtury/errors/circular_dependency_error.rb
-- lib/fixtury/errors/fixture_not_defined_error.rb
-- lib/fixtury/errors/option_collision_error.rb
-- lib/fixtury/errors/schema_frozen_error.rb
-- lib/fixtury/errors/unrecognizable_locator_error.rb
+- lib/fixtury/dependency.rb
+- lib/fixtury/dependency_store.rb
+- lib/fixtury/errors.rb
+- lib/fixtury/hooks.rb
 - lib/fixtury/locator.rb
 - lib/fixtury/locator_backend/common.rb
-- lib/fixtury/locator_backend/globalid.rb
+- lib/fixtury/locator_backend/global_id.rb
 - lib/fixtury/locator_backend/memory.rb
-- lib/fixtury/path.rb
+- lib/fixtury/mutation_observer.rb
+- lib/fixtury/path_resolver.rb
 - lib/fixtury/railtie.rb
 - lib/fixtury/reference.rb
 - lib/fixtury/schema.rb
+- lib/fixtury/schema_node.rb
 - lib/fixtury/store.rb
-- lib/fixtury/tasks.rake
 - lib/fixtury/test_hooks.rb
 - lib/fixtury/version.rb
 homepage: https://github.com/guideline-tech/fixtury
@@ -181,7 +181,7 @@ metadata:
   homepage_uri: https://github.com/guideline-tech/fixtury
   source_code_uri: https://github.com/guideline-tech/fixtury
   changelog_uri: https://github.com/guideline-tech/fixtury
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -196,8 +196,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
-signing_key: 
+rubygems_version: 3.5.6
+signing_key:
 specification_version: 4
 summary: Treat fixtures like factories and factories like fixtures
 test_files: []

data/lib/fixtury/errors/already_defined_error.rb

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-module Fixtury
-  module Errors
-    class AlreadyDefinedError < ::StandardError
-
-      def initialize(name)
-        super("An element identified by `#{name}` already exists.")
-      end
-
-    end
-  end
-end

data/lib/fixtury/errors/circular_dependency_error.rb

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-module Fixtury
-  module Errors
-    class CircularDependencyError < ::StandardError
-
-      def initialize(name)
-        super("One of the dependencies of #{name} is dependent on #{name}.")
-      end
-
-    end
-  end
-end

data/lib/fixtury/errors/fixture_not_defined_error.rb

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-module Fixtury
-  module Errors
-    class FixtureNotDefinedError < ::StandardError
-
-      def initialize(name)
-        super("A fixture identified by `#{name}` does not exist.")
-      end
-
-    end
-  end
-end

data/lib/fixtury/errors/option_collision_error.rb

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-module Fixtury
-  module Errors
-    class OptionCollisionError < ::StandardError
-
-      def initialize(schema_name, option_key, old_value, new_value)
-        super("The #{schema_name.inspect} schema #{option_key.inspect} option value of #{old_value.inspect} conflicts with the new value #{new_value.inspect}.")
-      end
-
-    end
-  end
-end

data/lib/fixtury/errors/schema_frozen_error.rb

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-module Fixtury
-  module Errors
-    class SchemaFrozenError < ::StandardError
-
-      def initialize
-        super("Schema is frozen. New namespaces, definitions, and enhancements are not allowed.")
-      end
-
-    end
-  end
-end

data/lib/fixtury/errors/unrecognizable_locator_error.rb

@@ -1,11 +0,0 @@
-module Fixtury
-  module Errors
-    class UnrecognizableLocatorError < ::StandardError
-
-      def initialize(action, thing)
-        super("Locator did not reognize #{thing} during #{action}")
-      end
-
-    end
-  end
-end

data/lib/fixtury/locator_backend/globalid.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "./common"
-require "globalid"
-
-module Fixtury
-  module LocatorBackend
-    class GlobalID
-
-      include ::Fixtury::LocatorBackend::Common
-
-      MATCHER = %r{^gid://}.freeze
-
-      def recognized_reference?(ref)
-        ref.is_a?(String) && MATCHER.match?(ref)
-      end
-
-      def recognized_value?(val)
-        val.respond_to?(:to_global_id)
-      end
-
-      def load_recognized_reference(ref)
-        ::GlobalID::Locator.locate ref
-      end
-
-      def dump_recognized_value(value)
-        value.to_global_id.to_s
-      end
-
-    end
-  end
-end

data/lib/fixtury/path.rb

@@ -1,36 +0,0 @@
-# frozen_string_literal: true
-
-module Fixtury
-  class Path
-
-    def initialize(namespace:, path:)
-      @namespace = namespace.to_s
-      @path = path.to_s
-      @full_path = (
-        @path.start_with?("/") ?
-        @path :
-        File.expand_path(::File.join(@namespace, @path), "/")
-      )
-      @segments = @full_path.split("/")
-    end
-
-    def top_level_namespace
-      return "" if @segments.size == 1
-
-      @segments.first
-    end
-
-    def relative?
-      @path.start_with?(".")
-    end
-
-    def possible_absolute_paths
-      @possible_absolute_paths ||= begin
-        out = [@full_path]
-        out << @path unless relative?
-        out
-      end
-    end
-
-  end
-end

data/lib/fixtury/tasks.rake

@@ -1,10 +0,0 @@
-# frozen_string_literal: true
-
-namespace :fixtury do
-  task :setup
-
-  desc "Clear fixtures from your cache. Accepts a pattern or fixture name such as foo/bar or /foo/*. Default pattern is /*"
-  task :clear_cache, [:pattern] => :setup do |_t, args|
-    ::Fixtury::Store.instance.clear_cache!(pattern: args[:pattern])
-  end
-end