easyop 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e1949724cfdf1045f5b0ab6f013187b395f3baaf96b357a6367c894b251ce1e2
-  data.tar.gz: d22d453c480ce21caf923195c36f984135e488454bdb939131cc0e896088017d
+  metadata.gz: 9157dccd94c6847b4b83c01404b64d48ffe54f1f6f51a99e0263bb718a2acdc4
+  data.tar.gz: 62bbaa697722e2b0d1979bc5a20839fb9dc765ee22d989f404591129a8a72c01
 SHA512:
-  metadata.gz: b956452863277b0218420ee73ca45eb9e28b449441ac2bc4458dcb5880cb95630ff5a5395ced570c50df1e2f98523b782dc5f39befc574834d13d739daf917be
-  data.tar.gz: 700f88243a8ba2a3add1c394c97ffc2d3e09e5a10ca157a1c4fcd5256fefc327bc04480ee5ddda8c329d3ff787acfb0321b33b219ca9ba78cc858b8c7ab4ea67
+  metadata.gz: 52fc250d99c11808462344afb74603081aa2dd35ca4f4d16ec263d19b3c098bba77ddcdda7963793483a9bfc0b04bd2cf63a70700c9756e0fb6b4610229ecc9f
+  data.tar.gz: 778348d6dc863bdda5816a32738ae2262c3948eb3711090b0a4412bc0678a9dc9b7c87e48cd937c3f1842e492f5be787c252c42f8ae9955191794cc9200dfc1e

data/CHANGELOG.md

@@ -7,6 +7,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.2] — 2026-04-13
+
+### Added
+
+- **`Plugins::Async` — `queue` DSL** — a new `queue` class method for declaring the default queue directly on an operation class (or a shared base class). This lets subclasses override the queue set at plugin install time without re-declaring the plugin:
+
+  ```ruby
+  class Weather::BaseOperation < ApplicationOperation
+    queue :weather   # all Weather ops use the "weather" queue
+  end
+
+  class Weather::FetchForecast < Weather::BaseOperation
+    # inherits queue :weather automatically
+  end
+
+  class Weather::CleanupExpiredDays < Weather::BaseOperation
+    queue :low_priority   # override just for this class
+  end
+  ```
+
+  Accepts both `Symbol` and `String`. The setting is inherited by subclasses and can be overridden at any level of the hierarchy.
+
+## [0.1.1] — 2026-04-01
+
+### Fixed
+
+- **`Plugins::Recording`** — operations executed as steps inside a `Flow` were not recorded on failure. Flows run each step with `raise_on_failure: true`, causing `Ctx::Failure` to propagate and skip the `.tap` block used to persist the log entry. Fixed by moving the persistence call into an `ensure` block so every execution — successful or failed — is always recorded.
+
 ## [0.1.0] — 2026-04-01
 
 ### Added
@@ -37,5 +65,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `examples/easyop_test_app/` — full Rails 8 blog application demonstrating all features in real-world code
 - `examples/usage.rb` — 13 runnable plain-Ruby examples
 
-[Unreleased]: https://github.com/pniemczyk/easyop/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/pniemczyk/easyop/compare/v0.1.2...HEAD
+[0.1.2]: https://github.com/pniemczyk/easyop/compare/v0.1.1...v0.1.2
+[0.1.1]: https://github.com/pniemczyk/easyop/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/pniemczyk/easyop/releases/tag/v0.1.0

data/README.md

@@ -672,6 +672,20 @@ Newsletter::SendBroadcast.call_async(attrs, wait_until: Date.tomorrow.noon)
 Newsletter::SendBroadcast.call_async(attrs, queue: "low_priority")
 ```
 
+**`queue` DSL** — declare the default queue directly on a class (or a shared base class) instead of at plugin install time:
+
+```ruby
+class Weather::BaseOperation < ApplicationOperation
+  queue :weather   # all Weather ops use the "weather" queue by default
+end
+
+class Weather::CleanupExpiredDays < Weather::BaseOperation
+  queue :low_priority   # override just for this class
+end
+```
+
+The `queue` setting is inherited by subclasses and can be overridden at any level. Accepts `Symbol` or `String`. A per-call `queue:` argument to `.call_async` always takes precedence.
+
 **ActiveRecord objects** are serialized by `(class, id)` and re-fetched in the job:
 
 ```ruby
@@ -983,15 +997,13 @@ ProcessCheckout.prepare
 ruby examples/usage.rb
 ```
 
-## Example Rails App
+## Example Rails Apps
 
-A full Rails 8 blog application demonstrating every EasyOp feature in real-world code lives in `/examples/easyop_test_app/`. It is **not included in the gem** — only in the repository.
+Two full Rails 8 applications live in `/examples/`. Neither is included in the gem — repository only.
 
-```
-/examples/easyop_test_app/
-```
+### Blog App — `easyop_test_app`
 
-The app covers:
+A blog + newsletter app demonstrating the full EasyOp feature set.
 
 | Feature | Where to look |
 |---|---|
@@ -1006,10 +1018,8 @@ The app covers:
 | Transactional plugin | `ApplicationOperation` → all DB ops wrapped in transactions |
 | Rails controller integration | `app/controllers/articles_controller.rb`, `transfers_controller.rb` |
 
-**Running the example app:**
-
 ```bash
-cd /examples/easyop_test_app
+cd examples/easyop_test_app
 bundle install
 bin/rails db:create db:migrate db:seed
 bin/rails server -p 3002
@@ -1017,6 +1027,31 @@ bin/rails server -p 3002
 
 Seed accounts: `alice@example.com` / `password123` (500 credits), `bob`, `carol`, `dave` (0 credits — tests insufficient-funds error).
 
+### TicketFlow — `ticketflow`
+
+A full event ticket-selling platform with modern Tailwind UI and admin panel. Every operation is powered by EasyOp.
+
+| Feature | Where to look |
+|---|---|
+| Multi-step checkout Flow | `app/operations/flows/checkout.rb` — 6 chained operations |
+| `skip_if` (optional discount step) | `app/operations/orders/apply_discount.rb` |
+| Rollback on payment failure | `app/operations/orders/process_payment.rb#rollback` |
+| `prepare` + callbacks in controller | `app/controllers/checkouts_controller.rb` |
+| Recording plugin → operation logs | `app/operations/application_operation.rb` |
+| Admin metrics dashboard | `app/controllers/admin/dashboard_controller.rb` |
+| Admin order refund operation | `app/operations/admin/refund_order.rb` |
+| Virtual ticket generation | `app/operations/tickets/generate_tickets.rb` |
+
+```bash
+cd examples/ticketflow
+bundle install
+bin/rails db:create db:migrate db:seed
+bin/rails server -p 3001
+```
+
+Seed accounts: `admin@ticketflow.com` / `password123` (admin), `user@ticketflow.com` / `password123` (customer).
+Discount codes: `SAVE10` (10% off), `FLAT20` ($20 off), `VIP50` (50% off).
+
 ## Running Specs
 
 ```

data/lib/easyop/plugins/async.rb

@@ -27,6 +27,18 @@ module Easyop
       end
 
       module ClassMethods
+        # Declares a non-default queue for this operation class and its subclasses.
+        #
+        # @example
+        #   class Weather::BaseOperation < ApplicationOperation
+        #     queue :weather
+        #   end
+        #
+        # @param name [String, Symbol] queue name
+        def queue(name)
+          @_async_default_queue = name.to_s
+        end
+
         # Enqueue the operation as a background job.
         #
         #   MyOp.call_async(email: "x@y.com")

data/lib/easyop/plugins/recording.rb

@@ -71,7 +71,13 @@ module Easyop
           return super unless self.class.name # skip anonymous classes
 
           start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
-          super.tap do
+          super
+        ensure
+          # Always record — including when raise_on_failure: true raises Ctx::Failure
+          # (e.g. when this operation is a step inside a Flow). Without the ensure
+          # branch the tap block would be skipped and failures inside flows would
+          # never be persisted.
+          if start
             ms = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000).round(2)
             _recording_persist!(ctx, model, ms)
           end

data/lib/easyop/version.rb

@@ -1,3 +1,3 @@
 module Easyop
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: easyop
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Pawel Niemczyk