seed_builder 1.2.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a607759220852d1d00fcfe17bce2c9d419446a3bfa066c446e85121a11e70f17
-  data.tar.gz: d02f1a778d953c5a48a6862a64b9bf4dd2dec73118c066865aec91399ff6b2e6
+  metadata.gz: 1b046651ce167e13d68341cda56bf75e8be727243532be8f30eafabd0e17fe63
+  data.tar.gz: 715f90fc2df771d026da70e2714001c34f516dd04a354c1bc8a62e61df7a17b1
 SHA512:
-  metadata.gz: 9c731f5ed5c7644f27a475122aedc0f48c32d17c27f3034473fc6b6a127808b25c5d016275ccdf4d36743414d7928706fad046e9d1704a6dc08de5a2dd8475c0
-  data.tar.gz: 90f6e27dd1bd7022f940261181a1308fe3ff8a2efd42b932914dd44419d438f2abafaf33650a68cd9b6ab8386235041add92ecc1126b6b74d39294139304adf3
+  metadata.gz: 3bc1a3b7455aa26097dae82b822cac3c6f6924bdb8bf8d83cf126932ab0042027dc14bb500f545bfe7a32c95abd5ada9b9e51ab600ec35b4a2e0d89798068ea4
+  data.tar.gz: f11835d4f4016c2217a0fcf468f436f68e97d031aaadfed043990f624aa64a428c60b27135c5a36968299754d10ccd64b064586ff74aaa7aee7eb2a60db4f272

data/.github/workflows/_trunk_check.yml

@@ -11,5 +11,5 @@ jobs:
       checks: write
       contents: read
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: trunk-io/trunk-action@v1

data/.github/workflows/test.yml

@@ -5,38 +5,94 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref_name }}
   cancel-in-progress: false
 jobs:
-  rspec:
+  test:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        ruby: [ruby, jruby, truffleruby]
+        include:
+          - rails_version: rails-6.1
+            ruby_version: "3.1"
+          - rails_version: rails-7.2
+            ruby_version: "3.2"
+          - rails_version: rails-8.1
+            ruby_version: "3.3"
     steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
+      - uses: actions/checkout@v5
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
         with:
-          ruby-version: ${{ matrix.ruby }}
-          bundler-cache: true
-      - run: bundle exec rspec
-  coverage:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
+          ruby-version: ${{ matrix.ruby_version }}
+          bundler-cache: false
+
+      - name: Install appraisal gem
+        run: gem install appraisal --no-document
+
+      - name: Generate appraisal gemfile
+        run: |
+          # Convert rails-6.1 to rails_6.1 format for gemfile name
+          GEMFILE_NAME=$(echo "${{ matrix.rails_version }}" | tr '-' '_')
+          appraisal install ${{ matrix.rails_version }} || true
+          # Verify gemfile was created
+          if [ ! -f "gemfiles/${GEMFILE_NAME}.gemfile" ]; then
+            echo "Error: gemfile not created at gemfiles/${GEMFILE_NAME}.gemfile"
+            exit 1
+          fi
+          # Set BUNDLE_GEMFILE for subsequent steps
+          echo "BUNDLE_GEMFILE=gemfiles/${GEMFILE_NAME}.gemfile" >> $GITHUB_ENV
+
+      - name: Update lockfile for platform and Ruby version
+        run: |
+          GEMFILE_NAME=$(echo "${{ matrix.rails_version }}" | tr '-' '_')
+          GEMFILE_PATH="gemfiles/${GEMFILE_NAME}.gemfile"
+          export BUNDLE_GEMFILE=${GEMFILE_PATH}
+          if [ -f "${GEMFILE_PATH}.lock" ]; then
+            # Add Linux platform if needed
+            bundle lock --add-platform x86_64-linux --gemfile ${GEMFILE_PATH} 2>/dev/null || true
+            # Try to install - if it fails due to incompatible versions, regenerate lockfile
+            if ! bundle install --gemfile ${GEMFILE_PATH} 2>/dev/null; then
+              echo "Lockfile has incompatible versions, regenerating..."
+              rm -f "${GEMFILE_PATH}.lock"
+              bundle install --gemfile ${GEMFILE_PATH}
+            fi
+          fi
+
+      - name: Install dependencies
+        uses: ruby/setup-ruby@v1
         with:
+          ruby-version: ${{ matrix.ruby_version }}
           bundler-cache: true
-      - run: bundle exec rspec
-      - uses: codecov/codecov-action@v5
+
+      - name: Run tests
+        run: bundle exec appraisal ${{ matrix.rails_version }} rspec
+
+      - name: Upload coverage reports to Codecov
+        if: matrix.rails_version == 'rails-8.1'
+        uses: codecov/codecov-action@v5
         continue-on-error: true
         env:
           CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
-      - uses: codecov/test-results-action@v1
-        if: ${{ !cancelled() }}
+
+      - name: Upload test results to Codecov
+        if: matrix.rails_version == 'rails-8.1'
+        uses: codecov/test-results-action@v1
         continue-on-error: true
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           files: coverage/junit-coverage.xml
-      - uses: codacy/codacy-coverage-reporter-action@v1.3.0
-        continue-on-error: true
-        with:
-          project-token: ${{ secrets.CODACY_PROJECT_TOKEN }}
-          coverage-reports: coverage/coverage.xml
+
+      - name: Run linter
+        if: matrix.rails_version == 'rails-8.1'
+        env:
+          BUNDLE_GEMFILE: Gemfile
+        run: |
+          bundle install
+          bundle exec standardrb --format simple
+
+      - name: Check type signatures
+        if: matrix.rails_version == 'rails-8.1'
+        env:
+          BUNDLE_GEMFILE: Gemfile
+        run: |
+          bundle install
+          bundle exec rbs validate

data/.gitignore

@@ -22,3 +22,4 @@
 
 *.local
 *.gem
+/gemfiles

data/.standard.yml

@@ -0,0 +1,22 @@
+# Standard Ruby configuration
+# See https://github.com/standardrb/standard for more options
+
+# Ignore specific files/directories
+ignore:
+  - "bin/**/*"
+  - "tmp/**/*"
+  - "vendor/**/*"
+  - "coverage/**/*"
+  - "*.gem"
+  - "*.gemspec"
+
+# Exclude certain rules if needed
+# For example, if you want to allow longer lines:
+# rubocop:
+#   AllCops:
+#     MaxLineLength: 120
+# Disable frozen_string_literal to allow removal of those comments
+rubocop:
+  Style/FrozenStringLiteralComment:
+    Enabled: false
+

data/Appraisals

@@ -0,0 +1,15 @@
+appraise "rails-6.1" do
+  gem "rails", "~> 6.1.0"
+  gem "activerecord", "~> 6.1.0"
+  gem "sqlite3", "~> 1.4"
+end
+
+appraise "rails-7.2" do
+  gem "rails", "~> 7.2.0"
+  gem "activerecord", "~> 7.2.0"
+end
+
+appraise "rails-8.1" do
+  gem "rails", "~> 8.1.0"
+  gem "activerecord", "~> 8.1.0"
+end

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # CHANGELOG
 
+## 1.3.0 (2025-11-04)
+
+- Replace `puts` statements with `Rails.logger` for proper logging integration
+- Add tagged logging with `seed` tag for all seed-related log messages
+- Add `logger` configuration option to allow custom logger setup via `SeedBuilder.config.logger = custom_logger`
+- Fix seed file loading to use `load` instead of `require` to ensure files are re-executed on each seed run
+- Logger automatically detects if `Rails.logger` already supports tagging to avoid double-wrapping
+- Add ability to run specific seed files on demand using `bin/rails seed:run[SEED_NAME]`
+- Add `load_seed_file` method to `SeedBuilder::Loader` for loading individual seeds
+- Add ambiguous match detection: when multiple seed files match the same name, the loader will show an error listing all matches and prompt the user to use the full name with timestamp
+- Patch `Rails.application.load_seed` to use SeedBuilder loader via Railtie integration
+
 ## 1.2.1
 
 - Fix seed files to be loaded as `.rb` files

data/Gemfile.lock

@@ -1,9 +1,9 @@
 PATH
   remote: .
   specs:
-    seed_builder (1.2.1)
-      activerecord (>= 6, < 8.1)
-      rails (>= 6, < 8.1)
+    seed_builder (1.3.0)
+      activerecord (>= 6.1, < 8.2)
+      rails (>= 6.1, < 8.2)
 
 GEM
   remote: https://rubygems.org/
@@ -79,6 +79,11 @@ GEM
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
       uri (>= 0.13.1)
+    appraisal (2.5.0)
+      bundler
+      rake
+      thor (>= 0.14.0)
+    ast (2.4.3)
     base64 (0.2.0)
     benchmark (0.4.0)
     bigdecimal (3.1.8)
@@ -103,6 +108,10 @@ GEM
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
     jar-dependencies (0.5.0)
+    json (2.15.2)
+    json (2.15.2-java)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
     logger (1.6.2)
     loofah (2.23.1)
       crass (~> 1.0.2)
@@ -141,6 +150,11 @@ GEM
       racc (~> 1.4)
     nokogiri (1.16.8-x86_64-linux)
       racc (~> 1.4)
+    parallel (1.27.0)
+    parser (3.3.10.0)
+      ast (~> 2.4.1)
+      racc
+    prism (1.6.0)
     psych (5.2.1)
       date
       stringio
@@ -185,9 +199,13 @@ GEM
       rake (>= 12.2)
       thor (~> 1.0, >= 1.2.2)
       zeitwerk (~> 2.6)
+    rainbow (3.1.1)
     rake (13.2.1)
+    rbs (3.9.5)
+      logger
     rdoc (6.8.1)
       psych (>= 4.0.0)
+    regexp_parser (2.11.3)
     reline (0.5.12)
       io-console (~> 0.5)
     rexml (3.3.9)
@@ -206,6 +224,25 @@ GEM
     rspec-support (3.13.2)
     rspec_junit_formatter (0.6.0)
       rspec-core (>= 2, < 4, != 2.12.0)
+    rubocop (1.80.2)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.46.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.47.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-performance (1.25.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    ruby-progressbar (1.13.0)
     securerandom (0.4.0)
     simplecov (0.22.0)
       docile (~> 1.1)
@@ -224,11 +261,26 @@ GEM
     sqlite3 (2.4.0-x86-linux-gnu)
     sqlite3 (2.4.0-x86_64-darwin)
     sqlite3 (2.4.0-x86_64-linux-gnu)
+    standard (1.51.1)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.80.2)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.8)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.8.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.25.0)
     stringio (3.1.2)
     thor (1.3.2)
     timeout (0.4.2)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.1.0)
     uri (1.0.2)
     useragent (0.16.11)
     websocket-driver (0.7.6)
@@ -248,13 +300,16 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
+  appraisal (~> 2.4)
   bundler (~> 2)
+  rbs (~> 3.0)
   rspec (~> 3)
   rspec_junit_formatter (~> 0.6)
   seed_builder!
   simplecov (~> 0.21)
   simplecov-cobertura (~> 2)
   sqlite3 (~> 2.4)
+  standard (~> 1.0)
 
 BUNDLED WITH
    2.5.20

data/README.md

@@ -30,10 +30,31 @@ gem "seed_builder"
 
 ### Run seeds
 
+Run all seeds:
+
 ```sh
 bin/rails db:seed
 ```
 
+Or in code:
+
+```ruby
+Rails.application.load_seed
+```
+
+Run a specific seed file:
+
+```sh
+bin/rails seed:run[create_users]
+```
+
+You can specify the seed name in different formats:
+- Class name: `create_users` (matches `20241206200111_create_users.rb`)
+- Full name: `20241206200111_create_users`
+- Timestamp: `20241206200111`
+
+**Note:** If multiple seed files match the same name, you'll be prompted to use the full name with timestamp to avoid ambiguity. For example, if both `20241206200111_create_users.rb` and `20241206200112_create_users.rb` exist, running `bin/rails seed:run[create_users]` will show an error listing all matches and ask you to be more specific.
+
 ### Generate seed file
 
 ```sh
@@ -72,12 +93,24 @@ SeedBuilder.config.generate_spec = false
 SeedBuilder.config.use_seed_loader = false
 ```
 
+### Set custom logger
+
+By default, SeedBuilder uses `Rails.logger` (or falls back to `Logger.new($stdout)` if Rails is not available). All seed-related log messages are tagged with `[seed]`.
+
+To use a custom logger:
+
+```ruby
+SeedBuilder.config.logger = MyCustomLogger.new
+```
+
+The logger will be automatically wrapped with `ActiveSupport::TaggedLogging` if it doesn't already support tagging, ensuring all seed messages are tagged with `[seed]`.
+
 ## Specification checklist
 
 - [x] User can generate seed file under `db/seeds` directory with common format
 - [x] User can generate seed file with test script included
 - [x] User can run all seeds
-- [ ] User can run specific seed file
+- [x] User can run specific seed file
 
 ## Limitations & explanations
 
@@ -86,15 +119,62 @@ SeedBuilder.config.use_seed_loader = false
 - Seeded data is not reversible, there is no point to implement it as logic can be complex and operations on data might lead to irreversible changes
 - Seed file is not a migration, although as good practice is to keep it idempotent, e.g. by checking uniqueness of seeded records
 
+## Development
+
+```bash
+# Install dependencies
+bundle install
+bundle exec appraisal install
+
+# Run tests for current Rails version
+bundle exec rspec
+
+# Run tests for all Rails versions (6.1, 7.2, 8.1)
+bin/appraisals
+
+# Run tests for specific Rails version
+bin/appraisals rails-7.2
+
+# Run tests for multiple versions
+bin/appraisals rails-7.2 rails-8.1
+
+# Or use appraisal directly
+bundle exec appraisal rails-7.2 rspec
+
+# Run linter
+bundle exec standardrb --fix
+
+# Check type signatures
+bundle exec rbs validate
+```
+
+### Development: Using from Local Repository
+
+When developing the gem or testing changes in your application, you can point your Gemfile to a local path:
+
+```ruby
+# In your application's Gemfile
+gem "seed_builder", path: "../seed_builder.rb"
+```
+
+Then run:
+
+```bash
+bundle install
+```
+
+**Note:** When using `path:` in your Gemfile, Bundler will use the local gem directly. Changes you make to the gem code will be immediately available in your application without needing to rebuild or reinstall the gem. This is ideal for development and testing.
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at <https://github.com/amkisko/seed_builder.rb>
 
 Contribution policy:
-
 - New features are not necessarily added to the gem
 - Pull request should have test coverage for affected parts
 - Pull request should have changelog entry
+
+Review policy:
 - It might take up to 2 calendar weeks to review and merge critical fixes
 - It might take up to 6 calendar months to review and merge pull request
 - It might take up to 1 calendar year to review an issue

data/bin/appraisals

@@ -0,0 +1,99 @@
+#!/usr/bin/env ruby
+
+# Run appraisal tests locally
+# Usage:
+#   bin/appraisals                    # Run tests for all Rails versions
+#   bin/appraisals rails-7.0          # Run tests for Rails 7.0
+#   bin/appraisals rails-7.0 rails-8.0 # Run tests for specific versions
+#   bin/appraisals rails-7.0 rspec    # Run rspec for Rails 7.0
+#   bin/appraisals rails-7.0 rake spec # Run rake spec for Rails 7.0
+
+require "bundler/setup"
+
+APPRAISALS_FILE = File.join(File.dirname(File.dirname(File.expand_path(__FILE__))), "Appraisals")
+
+unless File.exist?(APPRAISALS_FILE)
+  $stderr.puts "Error: Cannot find Appraisals file at #{APPRAISALS_FILE}"
+  exit 1
+end
+
+AVAILABLE_APPRAISALS = File.read(APPRAISALS_FILE, encoding: "UTF-8")
+  .scan(/appraise\s+"([^"]+)"/)
+  .flatten
+  .freeze
+
+def usage
+  puts <<~USAGE
+    Usage: bin/appraisals [appraisal_name...] [command]
+
+    Examples:
+      bin/appraisals                          # Run rspec for all Rails versions
+      bin/appraisals rails-7.0                # Run rspec for Rails 7.0
+      bin/appraisals rails-7.0 rails-8.0      # Run rspec for Rails 7.0 and 8.0
+      bin/appraisals rails-7.0 rspec          # Run rspec for Rails 7.0
+      bin/appraisals rails-7.0 rake spec      # Run rake spec for Rails 7.0
+
+    Available appraisals: #{AVAILABLE_APPRAISALS.join(', ')}
+  USAGE
+  exit 1
+end
+
+def parse_args
+  args = ARGV.dup
+  
+  # Handle help flags
+  if args.include?("--help") || args.include?("-h")
+    usage
+  end
+  
+  return [AVAILABLE_APPRAISALS, ["rspec"]] if args.empty?
+
+  appraisals = []
+  command = []
+
+  args.each do |arg|
+    if AVAILABLE_APPRAISALS.include?(arg)
+      appraisals << arg
+    else
+      command << arg
+    end
+  end
+
+  appraisals = AVAILABLE_APPRAISALS if appraisals.empty?
+  command = ["rspec"] if command.empty?
+
+  [appraisals, command]
+end
+
+def run_appraisal(appraisal, command)
+  puts "\n" + "=" * 80
+  puts "Running #{appraisal} with: #{command.join(' ')}"
+  puts "=" * 80
+
+  cmd = ["bundle", "exec", "appraisal", appraisal] + command
+  system(*cmd)
+end
+
+appraisals, command = parse_args
+
+unless appraisals.all? { |a| AVAILABLE_APPRAISALS.include?(a) }
+  puts "Error: Invalid appraisal(s)"
+  usage
+end
+
+results = {}
+appraisals.each do |appraisal|
+  results[appraisal] = run_appraisal(appraisal, command)
+end
+
+puts "\n" + "=" * 80
+puts "Summary"
+puts "=" * 80
+appraisals.each do |appraisal|
+  status = results[appraisal] ? "✓ PASSED" : "✗ FAILED"
+  puts "#{appraisal}: #{status}"
+end
+
+exit 0 if results.values.all?
+exit 1
+

data/bin/seed

@@ -0,0 +1,36 @@
+#!/usr/bin/env ruby
+
+# Load Rails environment
+require_relative "../config/environment" rescue nil
+
+unless defined?(Rails)
+  puts "Error: Rails environment not loaded. Please run this from a Rails application root."
+  puts "Alternatively, use: bin/rails seed:run[SEED_NAME]"
+  exit 1
+end
+
+require_relative "../lib/seed_builder"
+
+if ARGV.empty?
+  puts "Usage: bin/seed SEED_NAME"
+  puts ""
+  puts "Run a specific seed file by name."
+  puts ""
+  puts "Examples:"
+  puts "  bin/seed create_users"
+  puts "  bin/seed 20241206200111_create_users"
+  puts "  bin/seed 20241206200111"
+  puts ""
+  puts "Note: This script must be run from a Rails application root."
+  puts "      If multiple seed files match the name, use the full name with"
+  puts "      timestamp to avoid ambiguity (e.g., 20241206200111_create_users)."
+  puts ""
+  puts "Alternatively, use: bin/rails seed:run[SEED_NAME]"
+  exit 1
+end
+
+seed_name = ARGV[0]
+
+loader = SeedBuilder::Loader.new
+loader.load_seed_file(seed_name)
+

data/lib/seed_builder/config.rb

@@ -26,22 +26,24 @@ module SeedBuilder
 
     attr_writer :load_default_seeds
     def load_default_seeds?
-      @load_default_seeds.nil? ? true : @load_default_seeds
+      @load_default_seeds.nil? || @load_default_seeds
     end
 
     attr_writer :load_seeds
     def load_seeds?
-      @load_seeds.nil? ? true : @load_seeds
+      @load_seeds.nil? || @load_seeds
     end
 
     attr_writer :generate_spec
     def generate_spec?
-      @generate_spec.nil? ? true : @generate_spec
+      @generate_spec.nil? || @generate_spec
     end
 
     attr_writer :use_seed_loader
     def use_seed_loader?
-      @use_seed_loader.nil? ? true : @use_seed_loader
+      @use_seed_loader.nil? || @use_seed_loader
     end
+
+    attr_accessor :logger
   end
 end