Expose configuration via class-level method (#447)

Author: anthony0030

CHANGELOG.md

@@ -6,6 +6,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+- Expose configuration via class-level method (acts_as_list_options) [\#447](https://github.com/brendon/acts_as_list/pull/447) ([anthony0030])
+
 ## v1.2.5 - 2025-10-21
 
 - Fix crash when deleting an association with composite primary keys [\#450](https://github.com/brendon/acts_as_list/pull/450) ([smathieu])

lib/acts_as_list/active_record/acts/list.rb

@@ -27,6 +27,11 @@ def acts_as_list(options = {})
           configuration = { column: "position", scope: "1 = 1", top_of_list: 1, add_new_at: :bottom, touch_on_update: true }
           configuration.update(options) if options.is_a?(Hash)
 
+          # * Expose configuration via class-level method
+          define_singleton_method(:acts_as_list_options) do
+            configuration.dup.freeze
+          end
+
           caller_class = self
 
           ActiveRecord::Acts::List::PositionColumnMethodDefiner.call(caller_class, configuration[:column], configuration[:touch_on_update])

test/test_acts_as_list_options.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'helper'
+
+class ActsAsListOptionsTest
+  def setup
+    setup_db
+  end
+
+  def test_acts_as_list_options_returns_the_macro_configuration # rubocop:disable Metrics/MethodLength
+    klass = Class.new(ActiveRecord::Base) do
+      self.table_name = 'mixins'
+      acts_as_list(
+        column: :pos,
+        scope: %i[parent_id parent_type],
+        add_new_at: :top,
+        top_of_list: 0,
+        touch_on_update: false
+      )
+    end
+
+    opts = klass.acts_as_list_options
+
+    assert_equal %i[parent_id parent_type], opts[:scope]
+    assert_equal :pos,                       opts[:column]
+    assert_equal :top,                       opts[:add_new_at]
+    assert_equal 0,                          opts[:top_of_list]
+    assert_equal false,                      opts[:touch_on_update]
+    assert_equal true,                       opts.frozen?
+  end
+end