vial 0.2026.1.15.0 → 0.2026.8.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 680dac32bdbceb116ecfec2b9619833bb45f18caed07aa499b1fc47e2a80c02e
-  data.tar.gz: b08b502390918d7ee4f91abb33573c2528fa2b6b1d65b9b70896c077b5269420
+  metadata.gz: a7c47154ae0355e8591c6a673f3d3be7ec35157f5c283fe0e19a5d7e16de8264
+  data.tar.gz: f91144b61b12600d6c5d5b8d59eba6e8a83c28a99e212e702bc4a253f6d6b76b
 SHA512:
-  metadata.gz: '08d206381eafcff51a9b7b678388c2200d270999d8002f18769b18cd226abd7cc3dca77d49024ebb0f63637bbc46668fecf38fe4fbca7cb8c0e66a0f4b1b8212'
-  data.tar.gz: 4f06a9a9ff59325f4506b5485d587f69cc2b2ec12f53543abda96e3bca414c03ebde7e7d80dd0070660f057a8083378dd9a0c7cd9d1a51002c9638d4685e972c
+  metadata.gz: 41a2fe162d2082ccfcc1a972f9d1bd45ddb8359a9ba4b171d2a5549709f286bfadc0b4d67150cfcc836be62921d3ff3fb40f4b13574c3b5557fc266adaea4a6c
+  data.tar.gz: 75e803f3ac0a2d8c94a598960b320a20e85d33c034837d14d43cb3a6a141b997585d541b8a0cffb3edf78a27a71da6444052e103922d8711126224192b813449

data/README.md

@@ -67,7 +67,10 @@ Example `test/vials/users.vial.rb`:
 
 ```ruby
 vial :users do
+  sequence(:email) { |i| "user#{i}@test.local" }
+
   base do
+    email sequence(:email)
     active true
     country "MA"
   end
@@ -81,8 +84,6 @@ vial :users do
     active false
   end
 
-  sequence(:email) { |i| "user#{i}@test.local" }
-
   generate 10, :admin
   generate 50, :guest
 end
@@ -90,10 +91,18 @@ end
 
 Output: `test/fixtures/users.yml` with deterministic IDs and explicit records.
 
+Note: `sequence(:name) { ... }` only defines a sequence. It applies to records
+when an attribute references it — `email sequence(:email)` inside `base` or a
+variant. The compiler warns about sequences that are defined but never referenced.
+
 ### Global Validation
 
 `vial:compile` validates the entire dataset before writing any fixtures. Any collision or duplicate label fails the compile with a precise error.
 
+IDs are namespaced per `record_type` (one namespace per table): fixtures for
+different tables may share numeric IDs, and collisions are only errors within
+the same record type.
+
 ### Composition
 
 ```ruby
@@ -149,6 +158,10 @@ vial :users do
 end
 ```
 
+Explicit and derived IDs share one namespace per `record_type`, so two vials
+targeting the same table cannot collide, while vials for different tables can
+reuse the same numbers freely.
+
 Explain a derived ID:
 
 ```bash

data/lib/vial/compiler.rb

@@ -29,6 +29,8 @@ module Vial
         return CompileResult.new(status: :no_definitions, files: [], output_path: @output_path.to_s)
       end
 
+      warn_about_unused_sequences(definitions)
+
       records_by_definition = definitions.each_with_object([]) do |definition, entries|
         next if definition.abstract?
         entries << { definition: definition, records: definition.build_records }
@@ -91,6 +93,15 @@ module Vial
 
     private
 
+    def warn_about_unused_sequences(definitions)
+      definitions.each do |definition|
+        definition.unused_sequence_names.each do |name|
+          warn "Vial: sequence :#{name} in vial :#{definition.name} is defined but never referenced " \
+               "(use `#{name} sequence(:#{name})` inside base or a variant)"
+        end
+      end
+    end
+
     def write_fixture(definition, records)
       file_path = File.join(@output_path.to_s, "#{definition.name}.yml")
       FileUtils.mkdir_p(File.dirname(file_path))

data/lib/vial/config.rb

@@ -20,14 +20,22 @@ module Vial
     private
 
     def default_source_paths
-      [Rails.root.join('test/vials')]
+      [app_root.join('test/vials')]
     end
 
     def default_output_path
       fixture_paths = Array(ActiveSupport::TestCase.fixture_paths).compact
       return fixture_paths.first if fixture_paths.any?
 
-      Rails.root.join('test/fixtures')
+      app_root.join('test/fixtures')
+    end
+
+    # Rails is optional for the core compiler; fall back to the working
+    # directory in plain Ruby projects.
+    def app_root
+      return Rails.root if defined?(Rails) && Rails.respond_to?(:root) && Rails.root
+
+      Pathname.new(Dir.pwd)
     end
   end
 end

data/lib/vial/definition.rb

@@ -140,8 +140,25 @@ module Vial
       @sequence_defs
     end
 
+    # Sequences defined with a block but never consumed via
+    # `attr sequence(:name)` in base or a variant. Defining one without
+    # referencing it is a silent no-op, so the compiler warns about these.
+    def unused_sequence_names
+      return [] if abstract?
+
+      referenced = sequence_refs_in(resolved_base_attributes)
+      @variant_attributes.each_value do |attrs|
+        referenced |= sequence_refs_in(attrs)
+      end
+      @sequence_defs.keys - referenced
+    end
+
     private
 
+    def sequence_refs_in(attributes)
+      attributes.values.filter_map { |value| value.name if value.is_a?(SequenceRef) }
+    end
+
     def parse_generation_args(*args, **kwargs)
       if args.length == 0
         raise ArgumentError, 'generate requires a count or variant'

data/lib/vial/validator.rb

@@ -67,17 +67,21 @@ module Vial
     end
 
     def assign_and_validate_ids!
+      # IDs are namespaced per record_type: fixtures for different tables can
+      # share numeric IDs, collisions only matter within one record type.
       used_ids = {}
       all_records.each do |record|
         explicit = explicit_id_for(record)
         next unless explicit
 
         id_value = explicit[:value]
-        if (existing = used_ids[id_value])
+        id_key = id_key_for(record, id_value)
+        if (existing = used_ids[id_key])
           raise ValidationError.new(
             'ExplicitIDCollision',
             [
               "ID: #{id_value.inspect}",
+              "record_type: #{record.definition.record_type}",
               record_descriptor(existing[:record], existing[:source_file], existing[:source_line]),
               record_descriptor(record, explicit[:source_file], explicit[:source_line])
             ]
@@ -85,7 +89,7 @@ module Vial
         end
 
         record.attributes[record.definition.primary_key] = id_value
-        used_ids[id_value] = { explicit: true, record: record, source_file: explicit[:source_file], source_line: explicit[:source_line] }
+        used_ids[id_key] = { explicit: true, record: record, source_file: explicit[:source_file], source_line: explicit[:source_line] }
       end
 
       derived_records = all_records.reject { |record| record.attributes.key?(record.definition.primary_key) }
@@ -106,10 +110,11 @@ module Vial
           salt: attempts
         )
 
-        existing = used_ids[id_value]
+        id_key = id_key_for(record, id_value)
+        existing = used_ids[id_key]
         if existing.nil?
           record.attributes[record.definition.primary_key] = id_value
-          used_ids[id_value] = { explicit: false, record: record }
+          used_ids[id_key] = { explicit: false, record: record }
           return
         end
 
@@ -141,6 +146,10 @@ module Vial
       )
     end
 
+    def id_key_for(record, id_value)
+      [record.definition.record_type, id_value]
+    end
+
     def explicit_id_for(record)
       primary_key = record.definition.primary_key
       return nil unless record.attributes.key?(primary_key)

data/lib/vial/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Vial
-  VERSION = "0.2026.1.15.0"
+  VERSION = "0.2026.8.6.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vial
 version: !ruby/object:Gem::Version
-  version: 0.2026.1.15.0
+  version: 0.2026.8.6.0
 platform: ruby
 authors:
 - Abdelkader Boudih
@@ -104,7 +104,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.10
 specification_version: 4
 summary: 'Vial: Fixtures, Reinvented'
 test_files: []