rails_ops 1.7.2 → 1.7.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c17daad4e6d8e1d04943b73574b3fc6cbe3beed71c6d698a25f112431d9eece2
-  data.tar.gz: a569daf8bb6737cbba7cb1c4b8402595be565532757939f560ab5eea8f2b06ce
+  metadata.gz: 169b4c4d321feeff0cbde6cadc19a2cc09f07477105bc5fccb646cc625941fab
+  data.tar.gz: 6ca7942b59db7b7afbff04d7f27ee914615251280b7e9c62c1959e2a3f445cee
 SHA512:
-  metadata.gz: 7808e266d338deed54af3a8111b0dbf3c4364d6885bd09100898e629df57f0b1fb07dc5759d57fb5847770660ac050d39ebdc4e53bef6140131d68d8098360f9
-  data.tar.gz: 4c7c95588ec9b664e71d4a5dba6f3c74425db902eb0b20d7060ce72c9a4b3dc462e2fead2f0158f13178d58f29c936a3e2c422f8a748d71b7610504e3199194e
+  metadata.gz: e078b5b60ab4fb49014d020795fb1bf6d9cd62dc76335182ce2c68b90ea9b694e3b13dff3e73f3ff0c4deaca55d704c35ac519c95bcab0f036011097df7c8e46
+  data.tar.gz: 2c7fc723a11dc321e096566180b7a6b73ed8d71e612167cce58bfe9f8f65f66f48cb7c5a0f711d806624035bb63a70acaf49cd1752d6c9e36811816d8ea27390

data/.github/workflows/ruby.yml

@@ -29,8 +29,6 @@ jobs:
             ruby-version: '3.2.0'
           - rails-version: '7.1'
             ruby-version: '2.7.8'
-          - rails-version: '7.1'
-            ruby-version: '3.0.1'
           - rails-version: '7.1'
             ruby-version: '3.1.0'
           - rails-version: '7.1'
@@ -41,8 +39,6 @@ jobs:
             ruby-version: '3.2.0'
           - rails-version: '8.0'
             ruby-version: '3.3.0'
-          - rails-version: '8.0'
-            ruby-version: '3.4.0'
     name: Test against Ruby ${{ matrix.ruby-version }} / Rails ${{ matrix.rails-version }}
     env:
       BUNDLE_GEMFILE: ${{ github.workspace }}/gemfiles/rails_${{ matrix.rails-version }}.gemfile

data/Appraisals

@@ -13,12 +13,15 @@ end
 
 appraise 'rails-7.0' do
   gem 'rails', '~> 7.0.1'
+  gem 'active_type', '< 2.7.0'
 end
 
 appraise 'rails-6.1' do
   gem 'rails', '~> 6.1.4'
+  gem 'active_type', '< 2.7.0'
 end
 
 appraise 'rails-6.0' do
   gem 'rails', '~> 6.0.4'
+  gem 'active_type', '< 2.7.0'
 end

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 1.7.4 (2026-02-18)
+
+* Add `:before_model_validation` policy chain for model operations that runs
+  right before `model.validate!`, suitable for attribute cleanup and
+  sanitization.
+* Improve README documentation for transactions section: clarify that RailsOps
+  model operations do not automatically start transactions
+* Fix STI example in README to correctly show `op.model.class` instead of
+  `op_bird.class`
+* Fix incorrect `nest_model_op` example in nested operations documentation
+
+## 1.7.3 (2025-05-21)
+
+* Allow defining empty schemas via `schema2` method
+
 ## 1.7.2 (2025-04-14)
 
 * Add lazy load hooks

data/CLAUDE.md

@@ -0,0 +1,83 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+### Build and test
+- `bundle exec rake test` - Run the complete test suite
+- `bundle exec rake test TEST=test/unit/path/to/test.rb` - Run a specific test file
+- `bundle exec rake test TEST=test/unit/path/to/test.rb TESTOPTS="--name=test_name"` - Run a single test
+- `bundle exec rubocop` - Run code linting with RuboCop
+- `bundle exec rubocop -a` - Auto-fix RuboCop violations where possible
+- `bundle install` - Install dependencies
+- `bundle exec appraisal install` - Install dependencies for all Rails versions
+- `bundle exec appraisal rails_X.Y rake test` - Test against specific Rails version (e.g., rails_7.1)
+
+## Architecture Overview
+
+RailsOps is a service layer gem for Rails applications that implements the Operation pattern. It provides a consistent way to encapsulate business logic in testable, reusable classes.
+
+### Core Components
+
+1. **Operations** (`lib/rails_ops/operation.rb`)
+   - Base class for all operations
+   - Handles params validation via Schemacop
+   - Includes authorization, policies, and sub-operations
+   - Key methods: `run`, `run!`, `perform`
+
+2. **Model Operations** (`lib/rails_ops/operation/model/`)
+   - `Load` - Loads a model by ID with optional locking
+   - `Create` - Creates new model instances
+   - `Update` - Updates existing models
+   - `Destroy` - Destroys models
+   - Supports nested model operations and STI
+
+3. **Context** (`lib/rails_ops/context.rb`)
+   - Carries request-specific data (user, session, ability, etc.)
+   - Automatically passed to sub-operations
+   - Used for authorization and access control
+
+4. **Controller Integration** (`lib/rails_ops/controller_mixin.rb`)
+   - Provides `op` and `run`/`run!` helpers
+   - Automatic context creation
+   - Authorization checking in after_action
+
+5. **Authorization** (`lib/rails_ops/mixins/authorization.rb`)
+   - Backend-agnostic authorization
+   - Supports CanCanCan out of the box
+   - Per-operation and per-param authorization
+
+6. **Hooks** (`lib/rails_ops/hookup.rb`)
+   - Allows operations to trigger other operations
+   - Configured in `config/hookup.rb`
+   - Useful for decoupled side effects
+
+### Operation Structure
+
+Operations should:
+- Live in `app/operations/` (or custom namespace)
+- Have a schemacop schema
+- Be named after actions (e.g., `Create`, not `Creator`)
+- Use proper namespacing (e.g., `Operations::User::Create`)
+- Define schemas for param validation
+- Override `perform` method for business logic
+- Use policies for pre/post checks
+
+### Testing Patterns
+
+- Test files mirror operation structure in `test/unit/`
+- Use minitest framework
+- Test coverage tracked with SimpleCov
+- CI tests against Ruby 2.7-3.4 and Rails 6.0-8.0
+
+### Development Guidelines
+
+- Follow RuboCop rules in `.rubocop.yml`
+- Keep operations focused on single responsibilities
+- Use sub-operations for complex workflows
+- Document authorization requirements
+- Ensure thread-safety (avoid runtime model definitions)
+- Wrap lines in markdown files to 80 characters whenever possible
+- Remove any trailing whitespace from any lines (ruby, markdown and javascript),
+  also from otherwise empty lines

data/Gemfile

@@ -7,6 +7,7 @@ gemspec
 gem 'appraisal'
 gem 'bundler'
 gem 'cancancan'
+gem 'minitest', '~> 5.25'
 gem 'pry'
 gem 'rake'
 gem 'rubocop', '1.70.0'

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    rails_ops (1.7.2)
+    rails_ops (1.7.4)
       active_type (>= 1.3.0)
       minitest
       rails (> 4)
@@ -125,7 +125,7 @@ GEM
     marcel (1.0.4)
     method_source (1.0.0)
     mini_mime (1.1.5)
-    minitest (5.23.1)
+    minitest (5.27.0)
     mutex_m (0.2.0)
     net-imap (0.4.10)
       date
@@ -137,6 +137,8 @@ GEM
     net-smtp (0.4.0.1)
       net-protocol
     nio4r (2.7.0)
+    nokogiri (1.16.5-arm64-darwin)
+      racc (~> 1.4)
     nokogiri (1.16.5-x86_64-darwin)
       racc (~> 1.4)
     nokogiri (1.16.5-x86_64-linux)
@@ -227,6 +229,7 @@ GEM
       actionpack (>= 5.2)
       activesupport (>= 5.2)
       sprockets (>= 3.0.0)
+    sqlite3 (1.6.2-arm64-darwin)
     sqlite3 (1.6.2-x86_64-darwin)
     sqlite3 (1.6.2-x86_64-linux)
     stringio (3.1.0)
@@ -244,6 +247,7 @@ GEM
     zeitwerk (2.6.13)
 
 PLATFORMS
+  arm64-darwin-24
   x86_64-darwin-20
   x86_64-darwin-21
   x86_64-darwin-22
@@ -254,6 +258,7 @@ DEPENDENCIES
   appraisal
   bundler
   cancancan
+  minitest (~> 5.25)
   pry
   rails_ops!
   rake

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright © 2017-2025 Sitrox
+Copyright © 2017-2026 Sitrox
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal