fixtury 0.2.0 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 43cad01d0dda49953fb41782235cb0786d60a0b84eb3d8e9f4145d6fa4268f04
-  data.tar.gz: 5f4347bcf7a8ef5b7c72d42802e260f7ecc1b0e8d3772f4681bbef2aa7e9a963
+  metadata.gz: 11c65dc0db10367bf67f7d421ccc76e7b647a5bf73357431bc85dbd788667b00
+  data.tar.gz: 7042ed9b891e4fd0e2bdcade6cc0145160e5fb1dd6394d2bcd8de612ecceb1f8
 SHA512:
-  metadata.gz: adc92b02ad90ae0afd4f4b10d146e26663d3dfd0d428f9739d9cfcf147dde7d2e09b05f84e956f116af62123477bc453f343ca3bda0a3bf17ae6d7edf61d7f35
-  data.tar.gz: 4a5720793e764bc4f366512b8d172b31d64b68c89abd86862d2d199f68bd36b590e706bba56c8fa5471d071c5d84e370c30de0b7bf93109df3476d75caf22dca
+  metadata.gz: ed2b328ac82a6506a9c0d4fb26e049ee249cae994dd4406d2896c0b4be8e270dc54fef1a5f94a887077abc5a9a964a6412bea23bccce7ead21c600c70c2f4374
+  data.tar.gz: 18888bd37fdd508552353f5aa4d076f5bedd4ccf4420d7fc914450dcbaf5ea0c1cb29b428af3c94c3c617fd64359831f43594f65e3e9d300166329e0155e3b11

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    fixtury (0.1.0)
+    fixtury (0.3.2)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -1,11 +1,14 @@
 # Fixtury
 
-The goal of this library is to provide an interface for accessing fixture data on-demand rather than having to manage all resources up front. By centralizing and wrapping the definitions of data generation, we can preload and optimize how we load data, yet allow deferred behaviors when desired.
+Fixtury aims to provide an interface for creating, managing, and accessing test data in a simple and efficient way. It has no opinion on how you generate the data, it simply provides efficient ways to access it.
 
-For example, if a developer is running a test locally, there's no reason to build all fixtures for your suite.
+Often, fixture frameworks require you to either heavily maintain static fixtures or generate all your fixtures at runtime. Fixtury attempts to find a middle ground that enables a faster and more effecient development process.
 
-```
-class MyTest < ::Test
+For example, if a developer is running a test locally in their development environment there's no reason to build all fixtures for your suite of 30k tests. Instead, if we're able to track the fixture dependencies of the tests that are running we can build (and cache) the data relevant for the specific tests that are run.
+
+```ruby
+class MyTest < ::ActiveSupport::TestCase
+  include ::Fixtury::TestHooks
 
   fixtury "users.fresh"
   let(:user) { fixtury("users.fresh") }
@@ -15,7 +18,6 @@ class MyTest < ::Test
   end
 
 end
-
 ```
 
 Loading this file would ensure `users.fresh` is loaded into the fixture set before the suite is run. In the context of ActiveSupport::TestCase, the Fixtury::Hooks file will ensure the database records are present prior to your suite running. Setting `use_transactional_fixtures` ensures all records are rolled back prior to running another test.

data/lib/fixtury.rb

@@ -10,11 +10,14 @@ require "fixtury/store"
 
 module Fixtury
 
+  # Shortcut for opening the top level schema.
   def self.define(&block)
     schema.define(&block)
     schema
   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
     @top_level_schema ||= ::Fixtury::Schema.new(parent: nil, name: "")
   end

data/lib/fixtury/definition.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "fixtury/definition_executor"
+
 module Fixtury
   class Definition
 
@@ -24,55 +26,23 @@ module Fixtury
       @enhancements.any?
     end
 
-    def call(store: nil, execution_context: nil)
-      maybe_set_store_context(store: store) do
-        value = run_callable(store: store, callable: callable, execution_context: execution_context, value: nil)
-        enhancements.each do |e|
-          value = run_callable(store: store, callable: e, execution_context: execution_context, value: value)
-        end
-        value
-      end
+    def info
+      {
+        name: name,
+        loc: location_from_callable(callable),
+        enhancements: enhancements.map { |e| location_from_callable(e) },
+      }
     end
 
-    protected
-
-    def maybe_set_store_context(store:)
-      return yield unless store
-
-      store.with_relative_schema(schema) do
-        yield
-      end
-    end
-
-    def run_callable(store:, callable:, execution_context: nil, value:)
-      args = []
-      args << value unless value.nil?
-      if callable.arity > args.length
-        raise ArgumentError, "A store store must be provided if the definition expects it." unless store
-
-        args << store
-      end
-
-      provide_execution_context_hooks(execution_context) do |ctxt|
-        if args.length.positive?
-          ctxt.instance_exec(*args, &callable)
-        else
-          ctxt.instance_eval(&callable)
-        end
-      end
+    def call(store: nil, execution_context: nil)
+      executor = ::Fixtury::DefinitionExecutor.new(store: store, definition: self, execution_context: execution_context)
+      executor.__call
     end
 
-    def provide_execution_context_hooks(execution_context)
-      return yield self unless execution_context
+    def location_from_callable(callable)
+      return nil unless callable.respond_to?(:source_location)
 
-      execution_context.before_fixture(self) if execution_context.respond_to?(:before_fixture)
-      value = if execution_context.respond_to?(:around_fixture)
-        execution_context.around_fixture(self) { yield execution_context }
-      else
-        yield execution_context
-      end
-      execution_context.after_fixture(self, value) if execution_context.respond_to?(:after_fixture)
-      value
+      callable.source_location.join(":")
     end
 
   end

data/lib/fixtury/definition_executor.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Fixtury
+  class DefinitionExecutor
+
+    attr_reader :value, :execution_type, :definition, :store, :execution_context
+
+    def initialize(store: nil, execution_context: nil, definition:)
+      @store = store
+      @definition = definition
+      @execution_context = execution_context
+      @execution_type = nil
+      @value = nil
+    end
+
+    def __call
+      maybe_set_store_context do
+        provide_schema_hooks do
+          run_callable(callable: definition.callable, type: :definition)
+          definition.enhancements.each do |e|
+            run_callable(callable: e, type: :enhancement)
+          end
+        end
+      end
+
+      value
+    end
+
+    def get(name)
+      raise ArgumentError, "A store is required for #{definition.name}" unless store
+
+      store.get(name, execution_context: execution_context)
+    end
+    alias [] get
+
+    def method_missing(method_name, *args, &block)
+      return super unless execution_context
+
+      execution_context.send(method_name, *args, &block)
+    end
+
+    def respond_to_missing?(method_name)
+      return super unless execution_context
+
+      execution_context.respond_to?(method_name, true)
+    end
+
+    private
+
+    def run_callable(callable:, type:)
+      @execution_type = type
+
+      @value = if callable.arity.positive?
+        instance_exec(self, &callable)
+      else
+        instance_eval(&callable)
+      end
+    end
+
+    def maybe_set_store_context
+      return yield unless store
+
+      store.with_relative_schema(definition.schema) do
+        yield
+      end
+    end
+
+    def provide_schema_hooks
+      return yield unless definition.schema
+
+      @value = definition.schema.around_fixture_hook(self) do
+        yield
+        value
+      end
+    end
+
+  end
+end

data/lib/fixtury/schema.rb

@@ -9,16 +9,37 @@ require "fixtury/errors/schema_frozen_error"
 module Fixtury
   class Schema
 
-    attr_reader :definitions, :children, :name, :parent, :relative_name
+    attr_reader :definitions, :children, :name, :parent, :relative_name, :around_fixture_definition
 
     def initialize(parent:, name:)
       @name = name
       @parent = parent
       @relative_name = @name.split("/").last
+      @around_fixture_definition = nil
       @frozen = false
       reset!
     end
 
+    def around_fixture(&block)
+      @around_fixture_definition = block
+    end
+
+    def around_fixture_hook(executor, &definition)
+      maybe_invoke_parent_around_fixture_hook(executor) do
+        if around_fixture_definition.nil?
+          yield
+        else
+          around_fixture_definition.call(executor, definition)
+        end
+      end
+    end
+
+    def maybe_invoke_parent_around_fixture_hook(executor, &block)
+      return yield unless parent
+
+      parent.around_fixture_hook(executor, &block)
+    end
+
     def reset!
       @children = {}
       @definitions = {}
@@ -99,6 +120,8 @@ module Fixtury
         end
       end
 
+      around_fixture(&other_ns.around_fixture_definition) if other_ns.around_fixture_definition
+
       self
     end
 
@@ -172,6 +195,7 @@ module Fixtury
           self.class.new(name: child_name, parent: self)
         end
       end
+      child
     end
 
     def find_child_definition(name:)
@@ -187,7 +211,7 @@ module Fixtury
     def build_child_name(name:)
       name = name&.to_s
       raise ArgumentError, "`name` must be provided" if name.nil?
-      raise ArgumentError, "#{name} is invalid. `name` must contain only a-z, A-Z, 0-9, and _." unless name.match(/^[a-zA-Z_0-9]+$/)
+      raise ArgumentError, "#{name} is invalid. `name` must contain only a-z, A-Z, 0-9, and _." unless /^[a-zA-Z_0-9]+$/.match?(name)
 
       arr = ["", self.name, name]
       arr.join("/").gsub(%r{/{2,}}, "/")

data/lib/fixtury/store.rb

@@ -21,7 +21,6 @@ module Fixtury
     attr_reader :filepath, :references, :ttl, :auto_refresh_expired
     attr_reader :schema, :locator
     attr_reader :log_level
-    attr_reader :execution_context
 
     def initialize(
       filepath: nil,
@@ -29,7 +28,6 @@ module Fixtury
       log_level: nil,
       ttl: nil,
       schema: nil,
-      execution_context: nil,
       auto_refresh_expired: false
     )
       @schema = schema || ::Fixtury.schema
@@ -39,7 +37,6 @@ module Fixtury
       @locator = locator
       @filepath = filepath
       @references = @filepath && ::File.file?(@filepath) ? ::YAML.load_file(@filepath) : {}
-      @execution_context = execution_context
       @ttl = ttl ? ttl.to_i : ttl
       @auto_refresh_expired = !!auto_refresh_expired
       self.class.instance ||= self
@@ -80,7 +77,7 @@ module Fixtury
     def clear_cache!(pattern: nil)
       pattern ||= "*"
       pattern = "/" + pattern unless pattern.start_with?("/")
-      glob = pattern.ends_with?("*")
+      glob = pattern.end_with?("*")
       pattern = pattern[0...-1] if glob
       references.delete_if do |key, _value|
         hit = glob ? key.start_with?(pattern) : key == pattern
@@ -107,7 +104,7 @@ module Fixtury
       result
     end
 
-    def get(name)
+    def get(name, execution_context: nil)
       dfn = schema.get_definition!(name)
       full_name = dfn.name
       ref = references[full_name]

data/lib/fixtury/test_hooks.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "fixtury/store"
+require "active_support/core_ext/class/attribute"
 
 module Fixtury
   module TestHooks
@@ -10,54 +11,93 @@ module Fixtury
     included do
       class_attribute :fixtury_dependencies
       self.fixtury_dependencies = Set.new
+
+      class_attribute :local_fixtury_dependencies
+      self.local_fixtury_dependencies = Set.new
     end
 
     module ClassMethods
 
-      def fixtury(*names)
-        self.fixtury_dependencies += names.flatten.compact.map(&:to_s)
-      end
+      def fixtury(*names, &definition)
+        opts = names.extract_options!
+
+        # define fixtures if blocks are given
+        if block_given?
+          raise ArgumentError, "A fixture cannot be defined in an anonymous class" if name.nil?
+
+          namespace = fixtury_namespace
 
-      def define_fixture(name, &block)
-        fixture_name = name
-        namespace_names = self.name.underscore.split("/")
+          ns = ::Fixtury.schema
 
-        ns = ::Fixtury.schema
+          namespace.split("/").each do |ns_name|
+            ns = ns.namespace(ns_name){}
+          end
 
-        namespace_names.each do |ns_name|
-          ns = ns.namespace(ns_name){}
+          names.each do |fixture_name|
+            ns.fixture(fixture_name, &definition)
+            self.local_fixtury_dependencies += ["/#{namespace}/#{fixture_name}"]
+          end
+
+        # otherwise, just record the dependency
+        else
+          self.fixtury_dependencies += names.flatten.compact.map(&:to_s)
         end
 
-        ns.fixture(fixture_name, &block)
+        accessor_option = opts.key?(:accessor) ? opts[:accessor] : true
+
+        if accessor_option
+
+          if accessor_option != true && names.length > 1
+            raise ArgumentError, "A named :accessor option is only available when providing one fixture"
+          end
+
+          names.each do |fixture_name|
+            method_name = accessor_option == true ? fixture_name.split("/").last : accessor_option
+            ivar = :"@#{method_name}"
 
-        fixtury("#{namespace_names.join("/")}/#{fixture_name}")
+            class_eval <<-EV, __FILE__, __LINE__ + 1
+              def #{method_name}
+                return #{ivar} if defined?(#{ivar})
+
+                value = fixtury("#{fixture_name}")
+                #{ivar} = value
+              end
+            EV
+          end
+        end
+      end
+
+      def fixtury_namespace
+        name.underscore
       end
 
     end
 
     def fixtury(name)
-      return nil unless ::Fixtury::Store.instance
+      return nil unless fixtury_store
 
       name = name.to_s
 
-      unless name.include?("/")
-        local_name = "#{self.class.name.underscore}/#{name}"
-        if self.fixtury_dependencies.include?(local_name)
-          return ::Fixtury::Store.instance.get(local_name)
-        end
+      local_alias = "/#{self.class.fixtury_namespace}/#{name}"
+      if self.local_fixtury_dependencies.include?(local_alias)
+        return fixtury_store.get(local_alias, execution_context: self)
       end
 
       unless self.fixtury_dependencies.include?(name)
         raise ArgumentError, "Unrecognized fixtury dependency `#{name}` for #{self.class}"
       end
 
-      ::Fixtury::Store.instance.get(name)
+      fixtury_store.get(name, execution_context: self)
+    end
+
+    def fixtury_store
+      ::Fixtury::Store.instance
     end
 
     def fixtury_loaded?(name)
-      return false unless ::Fixtury::Store.instance
+      return false unless fixtury_store
 
-      ::Fixtury::Store.instance.loaded?(name)
+      fixtury_store.loaded?(name)
     end
 
     def fixtury_database_connections
@@ -66,7 +106,7 @@ module Fixtury
 
     # piggybacking activerecord fixture setup for now.
     def setup_fixtures(*args)
-      if fixtury_dependencies.any?
+      if fixtury_dependencies.any? || local_fixtury_dependencies.any?
         setup_fixtury_fixtures
       else
         super
@@ -75,7 +115,7 @@ module Fixtury
 
     # piggybacking activerecord fixture setup for now.
     def teardown_fixtures(*args)
-      if fixtury_dependencies.any?
+      if fixtury_dependencies.any? || local_fixtury_dependencies.any?
         teardown_fixtury_fixtures
       else
         super
@@ -100,13 +140,13 @@ module Fixtury
     end
 
     def clear_expired_fixtury_fixtures!
-      return unless ::Fixtury::Store.instance
+      return unless fixtury_store
 
-      ::Fixtury::Store.instance.clear_expired_references!
+      fixtury_store.clear_expired_references!
     end
 
     def load_all_fixtury_fixtures!
-      fixtury_dependencies.each do |name|
+      (fixtury_dependencies | local_fixtury_dependencies).each do |name|
         fixtury(name) unless fixtury_loaded?(name)
       end
     end

data/lib/fixtury/version.rb

@@ -2,6 +2,6 @@
 
 module Fixtury
 
-  VERSION = "0.2.0"
+  VERSION = "0.3.2"
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fixtury
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.2
 platform: ruby
 authors:
 - Mike Nelson
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-10-08 00:00:00.000000000 Z
+date: 2020-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: autotest
@@ -155,6 +155,7 @@ files:
 - fixtury.gemspec
 - lib/fixtury.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