Skip to content

Commit 363345b

Browse files
committed
Rename Adapter.get to Adapter.lookup
Per #1017 (comment) comment by sandstrom in discussion of the inherited hook > I'm thinking that it would be better to register adapters manually, without using the hook, i.e. > have people call ActiveModel::Serializer::Adapter.register directly (perhaps in an initializer). > Possibly, some inspiration can be taken from how ActiveJob adapters are wired[1]. > [1] https://github.com/rails/rails/blob/a11571cec3213753d63ac3e6b4bb3b97fe2594a6/activejob/lib/active_job/queue_adapter.rb#L52-L56
1 parent af99c0d commit 363345b

File tree

4 files changed

+23
-23
lines changed

4 files changed

+23
-23
lines changed

docs/general/adapters.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -91,9 +91,9 @@ ActiveModel::Serializer::Adapter.register(:special_adapter, MyAdapter)
9191

9292
| `ActiveModel::Serializer::Adapter.adapter_map` | A Hash of all known adapters { adapter_name => adapter_class } |
9393
| `ActiveModel::Serializer::Adapter.adapters` | A (sorted) Array of all known adapter_names |
94-
| `ActiveModel::Serializer::Adapter.get(name_or_klass)` | The adapter_class, else raises an `ActiveModel::Serializer::Adapter::UnknownAdapter` error |
95-
| `ActiveModel::Serializer::Adapter.adapter_class(adapter)` | delegates to `ActiveModel::Serializer::Adapter.get(adapter)` |
96-
| `ActiveModel::Serializer.adapter` | a convenience method for `ActiveModel::Serializer::Adapter.get(config.adapter)` |
94+
| `ActiveModel::Serializer::Adapter.lookup(name_or_klass)` | The adapter_class, else raises an `ActiveModel::Serializer::Adapter::UnknownAdapter` error |
95+
| `ActiveModel::Serializer::Adapter.adapter_class(adapter)` | delegates to `ActiveModel::Serializer::Adapter.lookup(adapter)` |
96+
| `ActiveModel::Serializer.adapter` | a convenience method for `ActiveModel::Serializer::Adapter.lookup(config.adapter)` |
9797

9898
The registered adapter name is always a String, but may be looked up as a Symbol or String.
9999
Helpfully, the Symbol or String is underscored, so that `get(:my_adapter)` and `get("MyAdapter")`

lib/active_model/serializer.rb

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -94,9 +94,9 @@ def self.serializer_for(resource, options = {})
9494
end
9595
end
9696

97-
# @see ActiveModel::Serializer::Adapter.get
97+
# @see ActiveModel::Serializer::Adapter.lookup
9898
def self.adapter
99-
ActiveModel::Serializer::Adapter.get(config.adapter)
99+
ActiveModel::Serializer::Adapter.lookup(config.adapter)
100100
end
101101

102102
def self.root_name

lib/active_model/serializer/adapter.rb

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,9 +17,9 @@ def self.create(resource, options = {})
1717
klass.new(resource, options)
1818
end
1919

20-
# @see ActiveModel::Serializer::Adapter.get
20+
# @see ActiveModel::Serializer::Adapter.lookup
2121
def self.adapter_class(adapter)
22-
ActiveModel::Serializer::Adapter.get(adapter)
22+
ActiveModel::Serializer::Adapter.lookup(adapter)
2323
end
2424

2525
# Only the Adapter class has these methods.
@@ -49,7 +49,7 @@ def register(name, klass)
4949
# @param adapter [String, Symbol, Class] name to fetch adapter by
5050
# @return [ActiveModel::Serializer::Adapter] subclass of Adapter
5151
# @raise [UnknownAdapterError]
52-
def get(adapter)
52+
def lookup(adapter)
5353
# 1. return if is a class
5454
return adapter if adapter.is_a?(Class)
5555
adapter_name = adapter.to_s.underscore

test/serializers/adapter_for_test.rb

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -83,33 +83,33 @@ def test_adapters
8383
]
8484
end
8585

86-
def test_get_adapter_by_string_name
87-
assert_equal ActiveModel::Serializer::Adapter.get('json'.freeze), ActiveModel::Serializer::Adapter::Json
86+
def test_lookup_adapter_by_string_name
87+
assert_equal ActiveModel::Serializer::Adapter.lookup('json'.freeze), ActiveModel::Serializer::Adapter::Json
8888
end
8989

90-
def test_get_adapter_by_symbol_name
91-
assert_equal ActiveModel::Serializer::Adapter.get(:json), ActiveModel::Serializer::Adapter::Json
90+
def test_lookup_adapter_by_symbol_name
91+
assert_equal ActiveModel::Serializer::Adapter.lookup(:json), ActiveModel::Serializer::Adapter::Json
9292
end
9393

94-
def test_get_adapter_by_class
94+
def test_lookup_adapter_by_class
9595
klass = ActiveModel::Serializer::Adapter::Json
96-
assert_equal ActiveModel::Serializer::Adapter.get(klass), klass
96+
assert_equal ActiveModel::Serializer::Adapter.lookup(klass), klass
9797
end
9898

99-
def test_get_adapter_from_environment_registers_adapter
99+
def test_lookup_adapter_from_environment_registers_adapter
100100
ActiveModel::Serializer::Adapter.const_set(:AdapterFromEnvironment, Class.new)
101101
klass = ::ActiveModel::Serializer::Adapter::AdapterFromEnvironment
102102
name = 'adapter_from_environment'.freeze
103-
assert_equal ActiveModel::Serializer::Adapter.get(name), klass
103+
assert_equal ActiveModel::Serializer::Adapter.lookup(name), klass
104104
assert ActiveModel::Serializer::Adapter.adapters.include?(name)
105105
ensure
106106
ActiveModel::Serializer::Adapter.adapter_map.delete(name)
107107
ActiveModel::Serializer::Adapter.send(:remove_const, :AdapterFromEnvironment)
108108
end
109109

110-
def test_get_adapter_for_unknown_name
110+
def test_lookup_adapter_for_unknown_name
111111
assert_raises UnknownAdapterError do
112-
ActiveModel::Serializer::Adapter.get(:json_simple)
112+
ActiveModel::Serializer::Adapter.lookup(:json_simple)
113113
end
114114
end
115115

@@ -123,7 +123,7 @@ def test_register_adapter
123123
new_adapter_klass = Class.new
124124
ActiveModel::Serializer::Adapter.register(new_adapter_name, new_adapter_klass)
125125
assert ActiveModel::Serializer::Adapter.adapters.include?('foo'.freeze)
126-
assert ActiveModel::Serializer::Adapter.get(:foo), new_adapter_klass
126+
assert ActiveModel::Serializer::Adapter.lookup(:foo), new_adapter_klass
127127
ensure
128128
ActiveModel::Serializer::Adapter.adapter_map.delete(new_adapter_name.to_s)
129129
end
@@ -132,7 +132,7 @@ def test_inherited_adapter_hooks_register_adapter
132132
Object.const_set(:MyAdapter, Class.new)
133133
my_adapter = MyAdapter
134134
ActiveModel::Serializer::Adapter.inherited(my_adapter)
135-
assert_equal ActiveModel::Serializer::Adapter.get(:my_adapter), my_adapter
135+
assert_equal ActiveModel::Serializer::Adapter.lookup(:my_adapter), my_adapter
136136
ensure
137137
ActiveModel::Serializer::Adapter.adapter_map.delete('my_adapter'.freeze)
138138
Object.send(:remove_const, :MyAdapter)
@@ -143,7 +143,7 @@ def test_inherited_adapter_hooks_register_demodulized_adapter
143143
MyNamespace.const_set(:MyAdapter, Class.new)
144144
my_adapter = MyNamespace::MyAdapter
145145
ActiveModel::Serializer::Adapter.inherited(my_adapter)
146-
assert_equal ActiveModel::Serializer::Adapter.get(:my_adapter), my_adapter
146+
assert_equal ActiveModel::Serializer::Adapter.lookup(:my_adapter), my_adapter
147147
ensure
148148
ActiveModel::Serializer::Adapter.adapter_map.delete('my_adapter'.freeze)
149149
MyNamespace.send(:remove_const, :MyAdapter)
@@ -157,8 +157,8 @@ def test_inherited_adapter_hooks_register_subclass_of_registered_adapter
157157
my_subclassed_adapter = MySubclassedAdapter
158158
ActiveModel::Serializer::Adapter.inherited(my_adapter)
159159
ActiveModel::Serializer::Adapter.inherited(my_subclassed_adapter)
160-
assert_equal ActiveModel::Serializer::Adapter.get(:my_adapter), my_adapter
161-
assert_equal ActiveModel::Serializer::Adapter.get(:my_subclassed_adapter), my_subclassed_adapter
160+
assert_equal ActiveModel::Serializer::Adapter.lookup(:my_adapter), my_adapter
161+
assert_equal ActiveModel::Serializer::Adapter.lookup(:my_subclassed_adapter), my_subclassed_adapter
162162
ensure
163163
ActiveModel::Serializer::Adapter.adapter_map.delete('my_adapter'.freeze)
164164
ActiveModel::Serializer::Adapter.adapter_map.delete('my_subclassed_adapter'.freeze)

0 commit comments

Comments
 (0)