Changelog for Oban Pro v1.0.0

The v1.0 release contains absolutely no features or bug fixes, purely some deprecation cleanup and a renamed Smart engine.

upgrading

❤️‍🩹🌟 Upgrading

Firstly, if your Pro version is behind v0.14, then the best method is to upgrade to Pro v0.14 and address any lingering deprecation warnings. You're ready to move on once you've handled older deprecation warnings!

All renamed or removed modules are also outlined below in deprecation cleanup.

smart-engine

Smart Engine

The SmartEngine moved into an Engines namespace for parity with Oban's engines. Rename any SmartEngine instances in your configuration:

- engine: Oban.Pro.Queue.SmartEngine
+ engine: Oban.Pro.Engines.Smart

Reference the Smart engine docs in their new home under the modules tab.

structured-worker

Structured Worker

The structured: ... option for defining the expected argument structure was replaced with args_schema in Pro v0.14. The translation mechanism that converted structured options into the corresponding args_schema is removed in v1.0, and you must update any structured workers:

- use Oban.Pro.Worker, structured: [keys: [:id, :account_id], required: [:id]]
+ use Oban.Pro.Worker
+
+ args_schema do
+   field :id, :id, required: true
+   field :account_id, :id
+ end

The args_schema syntax is far more robust than the old structured: ... keyword mechanism, so take some time to explore the Structured Jobs docs.

v1-0-0-2023-06-30

v1.0.0 — 2023-06-30

breaking-changes

Breaking Changes

  • [Oban.Pro.Queue.SmartEngine] Renamed to Oban.Pro.Engines.Smart.

  • [Oban.Pro.Worker] No longer supports :structured opts, use args_schema instead.

deprecation-cleanup

Deprecation Cleanup