Skip to content
Newer
Older
100644 284 lines (170 sloc) 10.4 KB
4c8af9b @dhh Update changelogs for release
dhh authored Apr 13, 2010
1 *Rails 3.0.0 [beta 3] (April 13th, 2010)*
2
3 * No changes
4
5
c1883e7 @wycats Updated changelogs to differentiate beta1 and beta2
wycats authored Apr 1, 2010
6 *Rails 3.0.0 [beta 1] (February 4, 2010)*
4d15528 @mwhuss HTTP proxy support
mwhuss authored May 18, 2009
7
7975885 @jakimowicz Add support for errors in JSON format.
jakimowicz authored Aug 9, 2009
8 * Add support for errors in JSON format. #1956 [Fabien Jakimowicz]
9
916b18a Active Resource recognizes 410 as Resource Gone now [#2316 state:reso…
Jordan Brough authored Aug 9, 2009
10 * Recognizes 410 as Resource Gone. #2316 [Jordan Brough, Jatinder Singh]
11
3e09516 @rnicholson Add ability to set SSL options on ARes connections.
rnicholson authored Aug 9, 2009
12 * More thorough SSL support. #2370 [Roy Nicholson]
13
4d15528 @mwhuss HTTP proxy support
mwhuss authored May 18, 2009
14 * HTTP proxy support. #2133 [Marshall Huss, Sébastien Dabet]
15
16
73fc42c @dhh Prepare for final 2.3 release
dhh authored Mar 15, 2009
17 *2.3.2 [Final] (March 15, 2009)*
77b0994 @dhh Prep for RC2 later today
dhh authored Feb 27, 2009
18
73fc42c @dhh Prepare for final 2.3 release
dhh authored Mar 16, 2009
19 * Nothing new, just included in 2.3.2
ed5fa2f @dhh Mark CHANGELOGs for release
dhh authored Feb 1, 2009
20
21
61e4370 @dhh Prepare for RC2
dhh authored Nov 14, 2008
22 *2.2.1 [RC2] (November 14th, 2008)*
dffc2e2 @dhh Fixed that ActiveResource#post would post an empty string when it sho…
dhh authored Oct 30, 2008
23
24 * Fixed that ActiveResource#post would post an empty string when it shouldn't be posting anything #525 [Paolo Angelini]
25
26
d224e6c @dhh Update CHANGELOGs with the last few fixes, set date for today
dhh authored Oct 24, 2008
27 *2.2.0 [RC1] (October 24th, 2008)*
e7a305f @dhh Fixed Base#exists? to check status code as integer [#299 state:resolv…
dhh authored Jun 2, 2008
28
f2c10f2 Add ActiveResource::Base#to_xml and ActiveResource::Base#to_json meth…
Cody Fauser authored Oct 7, 2008
29 * Add ActiveResource::Base#to_xml and ActiveResource::Base#to_json. #1011 [Rasik Pandey, Cody Fauser]
30
893fb5b @xymbol Add ActiveResource::Base.find(:last). [#754 state:resolved]
xymbol authored Aug 22, 2008
31 * Add ActiveResource::Base.find(:last). [#754 state:resolved] (Adrian Mugnolo)
32
aad7cac @dhh Fixed problems with the logger used if the logging string included %'s [
dhh authored Aug 15, 2008
33 * Fixed problems with the logger used if the logging string included %'s [#840 state:resolved] (Jamis Buck)
34
e7a305f @dhh Fixed Base#exists? to check status code as integer [#299 state:resolv…
dhh authored Jun 3, 2008
35 * Fixed Base#exists? to check status code as integer [#299 state:resolved] (Wes Oldenbeuving)
36
37
f9db769 @dhh Making ready for release of 2.1
dhh authored May 31, 2008
38 *2.1.0 (May 31st, 2008)*
a1ec3aa @jeremy Ruby 1.9 compatibility
jeremy authored Dec 21, 2007
39
869d731 Fixed response logging to use length instead of the entire thing (sea…
David Heinemeier Hansson authored Apr 29, 2008
40 * Fixed response logging to use length instead of the entire thing (seangeo) [#27]
41
9300ebd @dhh Fixed that to_param should be used and honored instead of hardcoding …
dhh authored Mar 28, 2008
42 * Fixed that to_param should be used and honored instead of hardcoding the id #11406 [gspiers]
43
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 10, 2008
44 * Improve documentation. [Ryan Bigg, Jan De Poorter, Cheah Chu Yeow, Xavier Shay, Jack Danger Canty, Emilio Tagua, Xavier Noria, Sunny Ripert]
ca94136 @lifo Improve documentation.
lifo authored Mar 26, 2008
45
5396b0f @NZKoz Use HEAD instead of GET inside exists? Closes #11062 [bscofield]
NZKoz authored Feb 9, 2008
46 * Use HEAD instead of GET in exists? [bscofield]
47
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
48 * Fix small documentation typo. Closes #10670 [Luca Guidi]
4261b83 @technoweenie Fix small documentation typo. Closes #10670 [l.guidi]
technoweenie authored Jan 2, 2008
49
9a97f9a @jeremy find_or_create_resource_for handles module nesting. Closes #10646.
jeremy authored Jan 2, 2008
50 * find_or_create_resource_for handles module nesting. #10646 [xavier]
51
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
52 * Allow setting ActiveResource::Base#format before #site. [Rick Olson]
e873071 @technoweenie Allow setting ActiveResource::Base#format before #site. [rick]
technoweenie authored Dec 28, 2007
53
c54b915 @technoweenie Support agnostic formats when calling custom methods. Closes #10635 […
technoweenie authored Dec 28, 2007
54 * Support agnostic formats when calling custom methods. Closes #10635 [joerichsen]
55
470fc02 @jeremy Document custom methods. Closes #10589.
jeremy authored Dec 21, 2007
56 * Document custom methods. #10589 [Cheah Chu Yeow]
57
a1ec3aa @jeremy Ruby 1.9 compatibility
jeremy authored Dec 21, 2007
58 * Ruby 1.9 compatibility. [Jeremy Kemper]
59
60
69edebf @dhh Prepare for 2.0.2 release
dhh authored Dec 16, 2007
61 *2.0.2* (December 16th, 2007)
c81fff2 @jeremy Correct empty response handling. Closes #10445.
jeremy authored Dec 10, 2007
62
1ceccde @dhh Added more specific exceptions for 400, 401, and 403 (all descending …
dhh authored Dec 14, 2007
63 * Added more specific exceptions for 400, 401, and 403 (all descending from ClientError so existing rescues will work) #10326 [trek]
64
c81fff2 @jeremy Correct empty response handling. Closes #10445.
jeremy authored Dec 10, 2007
65 * Correct empty response handling. #10445 [seangeo]
66
67
1acd54a @dhh Make ready for 2.0.1
dhh authored Dec 7, 2007
68 *2.0.1* (December 7th, 2007)
54a75de @dhh Prep for RC2
dhh authored Nov 29, 2007
69
24e6cbc @technoweenie Don't cache net/http object so that ActiveResource is more thread-saf…
technoweenie authored Nov 19, 2007
70 * Don't cache net/http object so that ActiveResource is more thread-safe. Closes #10142 [kou]
71
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
72 * Update XML documentation examples to include explicit type attributes. Closes #9754 [Josh Susser]
7863c4a Update XML documentation examples to include explicit type attributes…
Marcel Molina authored Nov 6, 2007
73
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
74 * Added one-off declarations of mock behavior [David Heinemeier Hansson]. Example:
dc399b9 @dhh Added ActiveResource.format= which defaults to :xml but can also be s…
dhh authored Sep 20, 2007
75
76 Before:
77 ActiveResource::HttpMock.respond_to do |mock|
78 mock.get "/people/1.xml", {}, "<person><name>David</name></person>"
79 end
80
81 Now:
82 ActiveResource::HttpMock.respond_to.get "/people/1.xml", {}, "<person><name>David</name></person>"
83
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
84 * Added ActiveResource.format= which defaults to :xml but can also be set to :json [David Heinemeier Hansson]. Example:
dc399b9 @dhh Added ActiveResource.format= which defaults to :xml but can also be s…
dhh authored Sep 20, 2007
85
86 class Person < ActiveResource::Base
87 self.site = "http://app/"
88 self.format = :json
89 end
90
91 person = Person.find(1) # => GET http://app/people/1.json
92 person.name = "David"
93 person.save # => PUT http://app/people/1.json {name: "David"}
94
95 Person.format = :xml
96 person.name = "Mary"
97 person.save # => PUT http://app/people/1.json <person><name>Mary</name></person>
98
e682fee @jeremy Fix reload error when path prefix is used. Closes #8727.
jeremy authored Jun 22, 2007
99 * Fix reload error when path prefix is used. #8727 [Ian Warshak]
100
fde3d9d @jeremy Remove ActiveResource::Struct because it hasn't proven very useful. C…
jeremy authored Jun 9, 2007
101 * Remove ActiveResource::Struct because it hasn't proven very useful. Creating a new ActiveResource::Base subclass is often less code and always clearer. #8612 [Josh Peek]
102
bfda4cd Fixed query methods on resources. [Cody Fauser]
Tobias Lütke authored Jun 8, 2007
103 * Fix query methods on resources. [Cody Fauser]
104
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
105 * pass the prefix_options to the instantiated record when using find without a specific id. Closes #8544 [Eloy Duran]
4d1c87a @technoweenie pass the prefix_options to the instantiated record when using find wi…
technoweenie authored Jun 1, 2007
106
849038e @jeremy Recognize and raise an exception on 405 Method Not Allowed responses.…
jeremy authored May 26, 2007
107 * Recognize and raise an exception on 405 Method Not Allowed responses. #7692 [Josh Peek]
108
0873678 @technoweenie Handle string and symbol param keys when splitting params into prefix…
technoweenie authored May 9, 2007
109 * Handle string and symbol param keys when splitting params into prefix params and query params.
110
111 Comment.find(:all, :params => { :article_id => 5, :page => 2 }) or Comment.find(:all, :params => { 'article_id' => 5, :page => 2 })
112
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
113 * Added find-one with symbol [David Heinemeier Hansson]. Example: Person.find(:one, :from => :leader) # => GET /people/leader.xml
04fd94d @dhh BACKWARDS INCOMPATIBLE: Changed the finder API to be more extensible …
dhh authored May 1, 2007
114
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
115 * BACKWARDS INCOMPATIBLE: Changed the finder API to be more extensible with :params and more strict usage of scopes [David Heinemeier Hansson]. Changes:
04fd94d @dhh BACKWARDS INCOMPATIBLE: Changed the finder API to be more extensible …
dhh authored May 1, 2007
116
117 Person.find(:all, :title => "CEO") ...becomes: Person.find(:all, :params => { :title => "CEO" })
118 Person.find(:managers) ...becomes: Person.find(:all, :from => :managers)
119 Person.find("/companies/1/manager.xml") ...becomes: Person.find(:one, :from => "/companies/1/manager.xml")
120
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
121 * Add support for setting custom headers per Active Resource model [Rick Olson]
bd50d82 @technoweenie Add support for setting custom headers per ActiveResource model [Rick]
technoweenie authored Apr 29, 2007
122
123 class Project
8e8fd99 @technoweenie change #custom_headers to just #headers [Rick]
technoweenie authored Apr 29, 2007
124 headers['X-Token'] = 'foo'
bd50d82 @technoweenie Add support for setting custom headers per ActiveResource model [Rick]
technoweenie authored Apr 29, 2007
125 end
126
127 # makes the GET request with the custom X-Token header
128 Project.find(:all)
129
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
130 * Added find-by-path options to ActiveResource::Base.find [David Heinemeier Hansson]. Examples:
1d5c34c @dhh Added find-by-path options to ActiveResource::Base.find [DHH]
dhh authored Apr 27, 2007
131
132 employees = Person.find(:all, :from => "/companies/1/people.xml") # => GET /companies/1/people.xml
133 manager = Person.find("/companies/1/manager.xml") # => GET /companies/1/manager.xml
134
135
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
136 * Added support for using classes from within a single nested module [David Heinemeier Hansson]. Example:
234b0b7 @dhh Added support for using classes from within a single nested module [DHH]
dhh authored Apr 26, 2007
137
138 module Highrise
139 class Note < ActiveResource::Base
140 self.site = "http://37s.sunrise.i:3000"
141 end
142
143 class Comment < ActiveResource::Base
144 self.site = "http://37s.sunrise.i:3000"
145 end
146 end
147
148 assert_kind_of Highrise::Comment, Note.find(1).comments.first
149
150
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
151 * Added load_attributes_from_response as a way of loading attributes from other responses than just create [David Heinemeier Hansson]
37e8e35 @dhh Added load_attributes_from_response as a way of loading attributes fr…
dhh authored Apr 26, 2007
152
153 class Highrise::Task < ActiveResource::Base
154 def complete
155 load_attributes_from_response(post(:complete))
156 end
157 end
158
159 ...will set "done_at" when complete is called.
160
161
9b8399f @dhh Added support for calling custom methods #6979 [rwdaigle]
dhh authored Apr 26, 2007
162 * Added support for calling custom methods #6979 [rwdaigle]
163
164 Person.find(:managers) # => GET /people/managers.xml
165 Kase.find(1).post(:close) # => POST /kases/1/close.xml
166
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
167 * Remove explicit prefix_options parameter for ActiveResource::Base#initialize. [Rick Olson]
208d12d @technoweenie Remove explicit prefix_options parameter for ActiveResource::Base#ini…
technoweenie authored Apr 24, 2007
168 ActiveResource splits the prefix_options from it automatically.
169
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
170 * Allow ActiveResource::Base.delete with custom prefix. [Rick Olson]
208d12d @technoweenie Remove explicit prefix_options parameter for ActiveResource::Base#ini…
technoweenie authored Apr 24, 2007
171
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
172 * Add ActiveResource::Base#dup [Rick Olson]
208d12d @technoweenie Remove explicit prefix_options parameter for ActiveResource::Base#ini…
technoweenie authored Apr 24, 2007
173
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
174 * Fixed constant warning when fetching the same object multiple times [David Heinemeier Hansson]
c97f329 @dhh Disregard namespaces from the default element name, so Highrise::Pers…
dhh authored Apr 19, 2007
175
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
176 * Added that saves which get a body response (and not just a 201) will use that response to update themselves [David Heinemeier Hansson]
c97f329 @dhh Disregard namespaces from the default element name, so Highrise::Pers…
dhh authored Apr 19, 2007
177
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
178 * Disregard namespaces from the default element name, so Highrise::Person will just try to fetch from "/people", not "/highrise/people" [David Heinemeier Hansson]
c97f329 @dhh Disregard namespaces from the default element name, so Highrise::Pers…
dhh authored Apr 19, 2007
179
d97456d @jeremy Allow array and hash query parameters. Closes #7756.
jeremy authored Mar 11, 2007
180 * Allow array and hash query parameters. #7756 [Greg Spurrier]
181
1b1ddf1 @jeremy Loading a resource preserves its prefix_options. Closes #7353. Silenc…
jeremy authored Jan 24, 2007
182 * Loading a resource preserves its prefix_options. #7353 [Ryan Daigle]
183
f49e449 @technoweenie Carry over the convenience of #create from ActiveRecord. Closes #7340.…
technoweenie authored Jan 24, 2007
184 * Carry over the convenience of #create from ActiveRecord. Closes #7340. [Ryan Daigle]
185
1bdb14b @technoweenie Increase ActiveResource::Base test coverage. Closes #7173, #7174 [Ric…
technoweenie authored Jan 23, 2007
186 * Increase ActiveResource::Base test coverage. Closes #7173, #7174 [Rich Collins]
187
e00e6a2 @jeremy Interpret 422 Unprocessable Entity as ResourceInvalid. Closes #7097.
jeremy authored Jan 17, 2007
188 * Interpret 422 Unprocessable Entity as ResourceInvalid. #7097 [dkubb]
189
932e7b0 @technoweenie Mega documentation patches. #7025, #7069 [rwdaigle]
technoweenie authored Jan 16, 2007
190 * Mega documentation patches. #7025, #7069 [rwdaigle]
191
2bb33bb @jeremy Base.exists?(id, options) and Base#exists? check whether the resource…
jeremy authored Jan 12, 2007
192 * Base.exists?(id, options) and Base#exists? check whether the resource is found. #6970 [rwdaigle]
193
4e57ac3 @jeremy Query string support. Closes #6855.
jeremy authored Dec 29, 2006
194 * Query string support. [untext, Jeremy Kemper]
195 # GET /forums/1/topics.xml?sort=created_at
196 Topic.find(:all, :forum_id => 1, :sort => 'created_at')
197
c172154 @jeremy Base#==, eql?, and hash methods. == returns true if its argument is i…
jeremy authored Dec 22, 2006
198 * Base#==, eql?, and hash methods. == returns true if its argument is identical to self or if it's an instance of the same class, is not new?, and has the same id. eql? is an alias for ==. hash delegates to id. [Jeremy Kemper]
199
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
200 * Allow subclassed resources to share the site info [Rick Olson, Jeremy Kemper]
2df386a @technoweenie why oh why do i always forget to save the changelog
technoweenie authored Apr 24, 2007
201 d
011f4e7 @technoweenie Allow subclassed resources to share the site info [Rick]
technoweenie authored Dec 13, 2006
202 class BeastResource < ActiveResource::Base
203 self.site = 'http://beast.caboo.se'
204 end
e6988ef @jeremy Subclasses share superclass site until explicitly set. This way you c…
jeremy authored Dec 21, 2006
205
011f4e7 @technoweenie Allow subclassed resources to share the site info [Rick]
technoweenie authored Dec 13, 2006
206 class Forum < BeastResource
207 # taken from BeastResource
208 # self.site = 'http://beast.caboo.se'
209 end
e6988ef @jeremy Subclasses share superclass site until explicitly set. This way you c…
jeremy authored Dec 21, 2006
210
011f4e7 @technoweenie Allow subclassed resources to share the site info [Rick]
technoweenie authored Dec 13, 2006
211 class Topic < BeastResource
e6988ef @jeremy Subclasses share superclass site until explicitly set. This way you c…
jeremy authored Dec 21, 2006
212 self.site += '/forums/:forum_id'
011f4e7 @technoweenie Allow subclassed resources to share the site info [Rick]
technoweenie authored Dec 13, 2006
213 end
214
55d4dbb @technoweenie Fix issues with ActiveResource collection handling. Closes #6291. [bm…
technoweenie authored Dec 12, 2006
215 * Fix issues with ActiveResource collection handling. Closes #6291. [bmilekic]
216
1d31a04 Use attr_accessor_with_default to dry up attribute initialization. Re…
Marcel Molina authored Nov 16, 2006
217 * Use attr_accessor_with_default to dry up attribute initialization. References #6538. [Stuart Halloway]
218
9c94438 @jamis Add basic logging support for logging outgoing requests.
jamis authored Oct 23, 2006
219 * Add basic logging support for logging outgoing requests. [Jamis Buck]
220
6c0609f @jamis Add Base.delete for deleting resources without having to instantiate …
jamis authored Oct 6, 2006
221 * Add Base.delete for deleting resources without having to instantiate them first. [Jamis Buck]
222
628838e @jamis Make #save behavior mimic AR::Base#save (true on success, false on fa…
jamis authored Oct 2, 2006
223 * Make #save behavior mimic AR::Base#save (true on success, false on failure). [Jamis Buck]
224
7ac6ed8 @technoweenie Add Basic HTTP Authentication to ActiveResource (closes #6305). [jona…
technoweenie authored Sep 29, 2006
225 * Add Basic HTTP Authentication to ActiveResource (closes #6305). [jonathan]
226
4d63e01 @technoweenie fixed failing tests now that non-GET requests are sent with .xml file…
technoweenie authored Sep 20, 2006
227 * Extracted #id_from_response as an entry point for customizing how a created resource gets its own ID.
228 By default, it extracts from the Location response header.
229
0a84624 @jeremy Optimistic locking: raise ActiveResource::ResourceConflict on 409 Con…
jeremy authored Sep 9, 2006
230 * Optimistic locking: raise ActiveResource::ResourceConflict on 409 Conflict response. [Jeremy Kemper]
231
232 # Example controller action
233 def update
234 @person.save!
235 rescue ActiveRecord::StaleObjectError
236 render :xml => @person.reload.to_xml, :status => '409 Conflict'
237 end
238
8d9e660 @technoweenie Basic validation support [Rick Olson]
technoweenie authored Sep 8, 2006
239 * Basic validation support [Rick Olson]
240
241 Parses the xml response of ActiveRecord::Errors#to_xml with a similar interface to ActiveRecord::Errors.
242
243 render :xml => @person.errors.to_xml, :status => '400 Validation Error'
244
c918fbf @jeremy Deep hashes are converted into collections of resources. Class attrib…
jeremy authored Sep 4, 2006
245 * Deep hashes are converted into collections of resources. [Jeremy Kemper]
246 Person.new :name => 'Bob',
247 :address => { :id => 1, :city => 'Portland' },
248 :contacts => [{ :id => 1 }, { :id => 2 }]
249 Looks for Address and Contact resources and creates them if unavailable.
250 So clients can fetch a complex resource in a single request if you e.g.
251 render :xml => @person.to_xml(:include => [:address, :contacts])
252 in your controller action.
253
7749c9c @technoweenie Major updates to ActiveResource, please see changelog and unit tests …
technoweenie authored Sep 1, 2006
254 * Major updates [Rick Olson]
255
256 * Add full support for find/create/update/destroy
257 * Add support for specifying prefixes.
258 * Allow overriding of element_name, collection_name, and primary key
259 * Provide simpler HTTP mock interface for testing
260
261 # rails routing code
262 map.resources :posts do |post|
263 post.resources :comments
264 end
265
266 # ActiveResources
267 class Post < ActiveResource::Base
268 self.site = "http://37s.sunrise.i:3000/"
269 end
270
271 class Comment < ActiveResource::Base
272 self.site = "http://37s.sunrise.i:3000/posts/:post_id/"
273 end
274
275 @post = Post.find 5
276 @comments = Comment.find :all, :post_id => @post.id
277
278 @comment = Comment.new({:body => 'hello world'}, {:post_id => @post.id})
279 @comment.save
280
f9b3694 @jeremy 200...400 are valid response codes. PUT and POST request bodies defau…
jeremy authored Aug 31, 2006
281 * Base.site= accepts URIs. 200...400 are valid response codes. PUT and POST request bodies default to ''. [Jeremy Kemper]
c1af2db @jeremy site= accepts URIs
jeremy authored Aug 31, 2006
282
46c7dd2 @fxn normalize author names in changelogs [#1495 state:committed]
fxn authored Dec 9, 2008
283 * Initial checkin: object-oriented client for restful HTTP resources which follow the Rails convention. [David Heinemeier Hansson]
Something went wrong with that request. Please try again.