metal_archives 0.4.0 → 0.5.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (18) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +3 -1
  3. data/lib/metal_archives.rb +1 -1
  4. data/lib/metal_archives/configuration.rb +2 -1
  5. data/lib/metal_archives/http_client.rb +6 -1
  6. data/lib/metal_archives/models/artist.rb +48 -30
  7. data/lib/metal_archives/models/band.rb +65 -41
  8. data/lib/metal_archives/models/base_model.rb +29 -18
  9. data/lib/metal_archives/parsers/artist.rb +40 -19
  10. data/lib/metal_archives/parsers/band.rb +56 -20
  11. data/lib/metal_archives/parsers/{parser_helper.rb → parser.rb} +12 -3
  12. data/lib/metal_archives/version.rb +1 -1
  13. data/metal_archives.gemspec +10 -10
  14. data/test/parser_test.rb +37 -0
  15. data/test/query/artist_query_test.rb +1 -1
  16. data/test/query/band_query_test.rb +1 -1
  17. metadata +19 -79
  18. data/test/parser_helper_test.rb +0 -37
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 5e5c9e464d998ad27ebce937a23a7b9924ccf871
4
- data.tar.gz: 758ebce5c4bb742680622b18c0fb5b3138a077c3
3
+ metadata.gz: 28427a784c317b61bcf01f503f193773f7ab8854
4
+ data.tar.gz: 1fdafac6af5df82d1cd1de9c02a9e3357297a160
5
5
  SHA512:
6
- metadata.gz: b5c26112b01a3de24352096e0f3dc2b6a7394cd7a9ae0bf4f7607f8ec057668ca6cc5bd30dda216547128dff8c38f141463472645b2623b1507c13b9bf8fd5e2
7
- data.tar.gz: 1848ff7bef54f75f913e7212b7c18b9e97c216ec3e8ce86f5b3b90e8c632614d9408b5cf43089b76de045e2591e472264b9d9bc9aa99e00f0f7c94f661dd5f69
6
+ metadata.gz: 41f50843c789d298d6b123c2571bae112d2f656d420d1db36bff4c9d4d64437800ff58d0332e207a605c9c07954881eec4faaa06a58454a0ef7325ecbc00fc13
7
+ data.tar.gz: 581f8c2e7ebc7bacc8d687b9a7a69db25ac2e579518aa3c66c5fa4ff3c22a739f8b89d17b31ce70b4f949f13aae9b5b51a64257955b14346a067f6769a8c8d56
data/README.md CHANGED
@@ -73,7 +73,9 @@ Refer to the model's [RDoc documentation](https://floriandejonckheere.github.io/
73
73
 
74
74
  ## Lazy loading
75
75
 
76
- By default when an model (Artist, Band, ...) is created, no data is fetched. This leads to instantiation of a model with an invalid ID not throwing any errors. Calling any attribute other than `id` will cause all data to be fetched and any errors to be thrown. Refer to the respective methods to find out what errors are thrown in what circumstances.
76
+ By default when an model (Artist, Band, ...) is created, no data is fetched. This leads to instantiation of a model with an invalid ID not throwing any errors. Calling any attribute other than `id` will cause all data to be fetched and any errors to be thrown. Refer to the respective methods to find out what errors are thrown in what circumstances.
77
+
78
+ Models can be forced to load all data by calling the `:load!` method.
77
79
 
78
80
  ## Testing
79
81
  ```
data/lib/metal_archives.rb CHANGED
@@ -10,7 +10,7 @@ require 'metal_archives/models/label'
10
10
  require 'metal_archives/models/artist'
11
11
  require 'metal_archives/models/band'
12
12
 
13
- require 'metal_archives/parsers/parser_helper'
13
+ require 'metal_archives/parsers/parser'
14
14
  require 'metal_archives/parsers/label'
15
15
  require 'metal_archives/parsers/artist'
16
16
  require 'metal_archives/parsers/band'
data/lib/metal_archives/configuration.rb CHANGED
@@ -13,7 +13,8 @@ module MetalArchives
13
13
  # A block must be specified, to which a
14
14
  # rdoc-ref:MetalArchives::Configuration parameter will be passed.
15
15
  #
16
- # Raises rdoc-ref:InvalidConfigurationException
16
+ # [Raises]
17
+ # - rdoc-ref:InvalidConfigurationException
17
18
  #
18
19
  def configure
19
20
  raise MetalArchives::Errors::InvalidConfigurationError, 'No configuration block given' unless block_given?
data/lib/metal_archives/http_client.rb CHANGED
@@ -12,8 +12,12 @@ module MetalArchives
12
12
  ##
13
13
  # Retrieve a HTTP resource
14
14
  #
15
+ # [Raises]
16
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when receiving a status code == 404n
17
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
18
+ #
15
19
  def get(*params)
16
- response = client.get *params
20
+ response = client.get(*params)
17
21
 
18
22
  raise Errors::InvalidIDError, response.status if response.status == 404
19
23
  raise Errors::APIError, response.status if response.status >= 400
@@ -27,6 +31,7 @@ module MetalArchives
27
31
  ##
28
32
  # Retrieve a HTTP client
29
33
  #
34
+ #
30
35
  def client
31
36
  raise Errors::InvalidConfigurationError, 'Not configured yet' unless MetalArchives.config
32
37
 
data/lib/metal_archives/models/artist.rb CHANGED
@@ -6,7 +6,7 @@ module MetalArchives
6
6
  ##
7
7
  # Represents a single performer (but not a solo artist)
8
8
  #
9
- class Artist < BaseModel
9
+ class Artist < MetalArchives::BaseModel
10
10
  ##
11
11
  # :attr_reader: id
12
12
  #
@@ -19,8 +19,9 @@ module MetalArchives
19
19
  #
20
20
  # Returns +String+
21
21
  #
22
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
23
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
22
+ # [Raises]
23
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
24
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
24
25
  #
25
26
  property :name
26
27
 
@@ -29,8 +30,9 @@ module MetalArchives
29
30
  #
30
31
  # Returns +Array+ of +String+
31
32
  #
32
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
33
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
33
+ # [Raises]
34
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
35
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
34
36
  #
35
37
  property :aliases, :multiple => true
36
38
 
@@ -39,8 +41,9 @@ module MetalArchives
39
41
  #
40
42
  # Returns +ISO3166::Country+
41
43
  #
42
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
43
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
44
+ # [Raises]
45
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
46
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
44
47
  #
45
48
  property :country, :type => ISO3166::Country
46
49
 
@@ -49,8 +52,9 @@ module MetalArchives
49
52
  #
50
53
  # Returns +String+
51
54
  #
52
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
53
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
55
+ # [Raises]
56
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
57
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
54
58
  #
55
59
  property :location
56
60
 
@@ -59,8 +63,9 @@ module MetalArchives
59
63
  #
60
64
  # Returns +Date+
61
65
  #
62
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
63
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
66
+ # [Raises]
67
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
68
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
64
69
  #
65
70
  property :date_of_birth, :type => Date
66
71
 
@@ -69,8 +74,9 @@ module MetalArchives
69
74
  #
70
75
  # Returns +Date+
71
76
  #
72
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
73
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
77
+ # [Raises]
78
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
79
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
74
80
  #
75
81
  property :date_of_death, :type => Date
76
82
 
@@ -79,8 +85,9 @@ module MetalArchives
79
85
  #
80
86
  # Returns +String+
81
87
  #
82
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
83
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
88
+ # [Raises]
89
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
90
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
84
91
  #
85
92
  property :cause_of_death
86
93
 
@@ -89,8 +96,9 @@ module MetalArchives
89
96
  #
90
97
  # Returns +Symbol+, either +:male+ or +:female+
91
98
  #
92
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
93
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
99
+ # [Raises]
100
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
101
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
94
102
  #
95
103
  enum :gender, :values => [:male, :female]
96
104
 
@@ -99,8 +107,9 @@ module MetalArchives
99
107
  #
100
108
  # Returns raw HTML +String+
101
109
  #
102
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
103
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
110
+ # [Raises]
111
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
112
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
104
113
  #
105
114
  property :biography
106
115
 
@@ -109,8 +118,9 @@ module MetalArchives
109
118
  #
110
119
  # Returns raw HTML +String+
111
120
  #
112
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
113
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
121
+ # [Raises]
122
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
123
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
114
124
  #
115
125
  property :trivia
116
126
 
@@ -119,8 +129,9 @@ module MetalArchives
119
129
  #
120
130
  # Returns +Array+ of +Hash+ containing the following keys
121
131
  #
122
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
123
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
132
+ # [Raises]
133
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
134
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
124
135
  #
125
136
  # [+similar+]
126
137
  # - +:url+: +String+
@@ -138,8 +149,9 @@ module MetalArchives
138
149
  ##
139
150
  # Fetch the data and assemble the model
140
151
  #
141
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when receiving a status code == 404
142
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
152
+ # [Raises]
153
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
154
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
143
155
  #
144
156
  def assemble # :nodoc:
145
157
  ## Base attributes
@@ -187,15 +199,17 @@ module MetalArchives
187
199
  #
188
200
  # Returns rdoc-ref:Band
189
201
  #
190
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
191
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
202
+ # [Raises]
203
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
204
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
205
+ # - rdoc-ref:MetalArchives::Errors::ParserError when parsing failed. Please report this error.
192
206
  #
193
207
  # [+id+]
194
208
  # +Integer+
195
209
  #
196
210
  def find!(id)
197
211
  obj = find id
198
- obj.send :fetch
212
+ obj.load!
199
213
 
200
214
  obj
201
215
  end
@@ -205,7 +219,9 @@ module MetalArchives
205
219
  #
206
220
  # Returns rdoc-ref:Artist or nil when no results
207
221
  #
208
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400
222
+ # [Raises]
223
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400
224
+ # - rdoc-ref:MetalArchives::Errors::ParserError when parsing failed. Please report this error.
209
225
  #
210
226
  # [+query+]
211
227
  # Hash containing one or more of the following keys:
@@ -231,7 +247,9 @@ module MetalArchives
231
247
  #
232
248
  # Returns rdoc-ref:Collection of rdoc-ref:Artist
233
249
  #
234
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400
250
+ # [Raises]
251
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400
252
+ # - rdoc-ref:MetalArchives::Errors::ParserError when parsing failed. Please report this error.
235
253
  #
236
254
  # [+name+]
237
255
  # +String+
data/lib/metal_archives/models/band.rb CHANGED
@@ -6,7 +6,7 @@ module MetalArchives
6
6
  ##
7
7
  # Represents an band (person or group)
8
8
  #
9
- class Band < BaseModel
9
+ class Band < MetalArchives::BaseModel
10
10
  ##
11
11
  # :attr_reader: id
12
12
  #
@@ -19,8 +19,9 @@ module MetalArchives
19
19
  #
20
20
  # Returns +String+
21
21
  #
22
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
23
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
22
+ # [Raises]
23
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
24
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
24
25
  #
25
26
  property :name
26
27
 
@@ -29,8 +30,9 @@ module MetalArchives
29
30
  #
30
31
  # Returns +Array+ of +String+
31
32
  #
32
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
33
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
33
+ # [Raises]
34
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
35
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
34
36
  #
35
37
  property :aliases, :multiple => true
36
38
 
@@ -39,8 +41,9 @@ module MetalArchives
39
41
  #
40
42
  # Returns +ISO3166::Country+
41
43
  #
42
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
43
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
44
+ # [Raises]
45
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
46
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
44
47
  #
45
48
  property :country, :type => ISO3166::Country
46
49
 
@@ -49,8 +52,9 @@ module MetalArchives
49
52
  #
50
53
  # Returns +String+
51
54
  #
52
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
53
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
55
+ # [Raises]
56
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
57
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
54
58
  #
55
59
  property :location
56
60
 
@@ -59,8 +63,9 @@ module MetalArchives
59
63
  #
60
64
  # Returns +Date+
61
65
  #
62
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
63
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
66
+ # [Raises]
67
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
68
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
64
69
  #
65
70
  property :date_formed, :type => Date
66
71
 
@@ -69,8 +74,9 @@ module MetalArchives
69
74
  #
70
75
  # Returns +Array+ of rdoc-ref:Range
71
76
  #
72
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
73
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
77
+ # [Raises]
78
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
79
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
74
80
  #
75
81
  property :date_active, :type => MetalArchives::Range, :multiple => true
76
82
 
@@ -79,8 +85,9 @@ module MetalArchives
79
85
  #
80
86
  # Returns +Array+ of +String+
81
87
  #
82
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
83
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
88
+ # [Raises]
89
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
90
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
84
91
  #
85
92
  property :genres, :multiple => true
86
93
 
@@ -89,8 +96,9 @@ module MetalArchives
89
96
  #
90
97
  # Returns +Array+ of +String+
91
98
  #
92
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
93
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
99
+ # [Raises]
100
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
101
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
94
102
  #
95
103
  property :lyrical_themes, :multiple => true
96
104
 
@@ -99,8 +107,9 @@ module MetalArchives
99
107
  #
100
108
  # Returns rdoc-ref:Label
101
109
  #
102
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
103
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
110
+ # [Raises]
111
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
112
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
104
113
  #
105
114
  property :label, :type => MetalArchives::Label
106
115
 
@@ -109,8 +118,9 @@ module MetalArchives
109
118
  #
110
119
  # Returns boolean
111
120
  #
112
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
113
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
121
+ # [Raises]
122
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
123
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
114
124
  #
115
125
  enum :independent, :values => [true, false]
116
126
 
@@ -119,8 +129,9 @@ module MetalArchives
119
129
  #
120
130
  # Returns raw HTML +String+
121
131
  #
122
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
123
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
132
+ # [Raises]
133
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
134
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
124
135
  #
125
136
  property :comment
126
137
 
@@ -129,8 +140,9 @@ module MetalArchives
129
140
  #
130
141
  # Returns +:active+, +:split_up+, +:on_hold+, +:unknown+, +:changed_name+ or +:disputed+
131
142
  #
132
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
133
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
143
+ # [Raises]
144
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
145
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
134
146
  #
135
147
  enum :status, :values => [:active, :split_up, :on_hold, :unknown, :changed_name, :disputed]
136
148
 
@@ -142,8 +154,9 @@ module MetalArchives
142
154
  #
143
155
  # Returns +Array+ of +Hash+ containing the following keys
144
156
  #
145
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
146
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
157
+ # [Raises]
158
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
159
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
147
160
  #
148
161
  # [+similar+]
149
162
  # - +:band+: rdoc-ref:Band
@@ -156,8 +169,9 @@ module MetalArchives
156
169
  #
157
170
  # Returns +String+
158
171
  #
159
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
160
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
172
+ # [Raises]
173
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
174
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
161
175
  #
162
176
  property :logo
163
177
 
@@ -166,8 +180,9 @@ module MetalArchives
166
180
  #
167
181
  # Returns +String+
168
182
  #
169
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
170
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
183
+ # [Raises]
184
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
185
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
171
186
  #
172
187
  property :photo
173
188
 
@@ -176,8 +191,9 @@ module MetalArchives
176
191
  #
177
192
  # Returns +Array+ of +Hash+ containing the following keys
178
193
  #
179
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
180
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
194
+ # [Raises]
195
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
196
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
181
197
  #
182
198
  # [+similar+]
183
199
  # - +:url+: +String+
@@ -190,8 +206,9 @@ module MetalArchives
190
206
  ##
191
207
  # Fetch the data and assemble the model
192
208
  #
193
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when receiving a status code == 404
194
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
209
+ # [Raises]
210
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when receiving a status code == 404
211
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
195
212
  #
196
213
  def assemble # :nodoc:
197
214
  ## Base attributes
@@ -239,15 +256,17 @@ module MetalArchives
239
256
  #
240
257
  # Returns rdoc-ref:Band
241
258
  #
242
- # Raises rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
243
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
259
+ # [Raises]
260
+ # - rdoc-ref:MetalArchives::Errors::InvalidIDError when no or invalid id
261
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400 (except 404)
262
+ # - rdoc-ref:MetalArchives::Errors::ParserError when parsing failed. Please report this error.
244
263
  #
245
264
  # [+id+]
246
265
  # +Integer+
247
266
  #
248
267
  def find!(id)
249
268
  obj = find id
250
- obj.send :fetch
269
+ obj.load!
251
270
 
252
271
  obj
253
272
  end
@@ -259,7 +278,9 @@ module MetalArchives
259
278
  #
260
279
  # Returns rdoc-ref:Band or nil when no results
261
280
  #
262
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400
281
+ # [Raises]
282
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400
283
+ # - rdoc-ref:MetalArchives::Errors::ParserError when parsing failed. Please report this error.
263
284
  #
264
285
  # [+query+]
265
286
  # Hash containing one or more of the following keys:
@@ -299,7 +320,9 @@ module MetalArchives
299
320
  #
300
321
  # Returns rdoc-ref:Collection of rdoc-ref:Band
301
322
  #
302
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400
323
+ # [Raises]
324
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400
325
+ # - rdoc-ref:MetalArchives::Errors::ParserError when parsing failed. Please report this error.
303
326
  #
304
327
  # [+query+]
305
328
  # Hash containing one or more of the following keys:
@@ -353,7 +376,8 @@ module MetalArchives
353
376
  #
354
377
  # Returns (possibly empty) +Array+ of rdoc-ref:Band
355
378
  #
356
- # Raises rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400
379
+ # [Raises]
380
+ # - rdoc-ref:MetalArchives::Errors::APIError when receiving a status code >= 400
357
381
  #
358
382
  # [+name+]
359
383
  # +String+