fixtury 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c8026933c72e6773550464325733bf9c31c7fc601c00aabcc6fa18dd384439d6
-  data.tar.gz: a96c566602765f01a949814362022d687e5b06e794d1c09ecbef8dd5fd254a34
+  metadata.gz: 28d8d17251e3c566a77365c589274b5f28f6cfac17c3b126a0047e6b696368ec
+  data.tar.gz: 8dab12b727161634b90ed49e56a025bfe72aade50c90509ee08ebfd4faac2d17
 SHA512:
-  metadata.gz: 7b95b7af4242c7e90f29f913be405a4a50163c66b8d363b2187ca04e4f71ff59b9cfdf88acbf6c4754c226321f8663c6d54b02472fe9c49342a49b9f98a1e2b2
-  data.tar.gz: 7b78291b5980f5dc3a854e31f15668ee6765a7173869d68b09a19d8e58cc06e60240c293fa7984afd7271c3d31e8977d5d1e0d96cf71bfd018ada973fe3cf75f
+  metadata.gz: fb5841b70b7ae8cac95e6f8cc6a1c32c47d71f356c3be0275dc463f1d6c1b5f88447e51807d48632bdb68b425e7bc9ead3293519085cc9416d45a027cf1c7abc
+  data.tar.gz: 662570f9d0adcea15b6198eed3deb5fb4aab0639d206941687ea9a230f121ab7d1c82da895ac7c39e6459262ad3c3562cbfcfcb6d3ba7839a90a6380549776ba

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/test_hooks.rb

@@ -22,7 +22,7 @@ module Fixtury
         if block_given?
           raise ArgumentError, "A fixture cannot be defined in an anonymous class" if name.nil?
 
-          namespace = name.underscore
+          namespace = fixtury_namespace
 
           ns = ::Fixtury.schema
 
@@ -32,7 +32,7 @@ module Fixtury
 
           names.each do |fixture_name|
             ns.fixture(fixture_name, &definition)
-            self.fixtury_dependencies += ["#{namespace}/#{fixture_name}"]
+            self.fixtury_dependencies += ["/#{namespace}/#{fixture_name}"]
           end
 
         # otherwise, just record the dependency
@@ -64,6 +64,10 @@ module Fixtury
         end
       end
 
+      def fixtury_namespace
+        name.underscore
+      end
+
     end
 
     def fixtury(name)
@@ -71,11 +75,9 @@ module Fixtury
 
       name = name.to_s
 
-      unless name.include?("/")
-        local_name = "#{self.class.name.underscore}/#{name}"
-        if self.fixtury_dependencies.include?(local_name)
-          return fixtury_store.get(local_name, execution_context: self)
-        end
+      local_alias = "/#{self.class.fixtury_namespace}/#{name}"
+      if self.fixtury_dependencies.include?(local_alias)
+        return fixtury_store.get(local_alias, execution_context: self)
       end
 
       unless self.fixtury_dependencies.include?(name)

data/lib/fixtury/version.rb

@@ -2,6 +2,6 @@
 
 module Fixtury
 
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fixtury
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Mike Nelson
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-10-20 00:00:00.000000000 Z
+date: 2020-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: autotest