Skip to content
Newer
Older
100644 6629 lines (3853 sloc) 330 KB
5f27545 @pimeys If the table behind has no primary key, do not ask again and just ret…
pimeys authored
1 ## Rails 3.1.4 (unreleased) ##
2
63293d1 @jonleighton Fix #3890. (Calling proxy_association in scope chain.)
jonleighton authored
3 * Fix accessing `proxy_association` method from an association extension
4 where the calls are chained. *GH #3890*
5
6 (E.g. `post.comments.where(bla).my_proxy_method`)
7
8 *Jon Leighton*
9
8d55a6d @kennyj Use show create table.
kennyj authored
10 * Perf fix: MySQL primary key lookup was still slow for very large
11 tables. *GH 3678*
12
13 *Kenny J*
14
5f27545 @pimeys If the table behind has no primary key, do not ask again and just ret…
pimeys authored
15 * Perf fix: If a table has no primary key, don't repeatedly ask the database for it.
16
17 *Julius de Bruijn*
18
c5197d4 @jonleighton Verify that #3690 has been closed by previous changes to the mysql
jonleighton authored
19 ## Rails 3.1.3 (unreleased) ##
20
cb0c3e4 @jonleighton Perf fix
jonleighton authored
21 * Perf fix: If we're deleting all records in an association, don't add a IN(..) clause
22 to the query. *GH 3672*
23
24 *Jon Leighton*
25
c5197d4 @jonleighton Verify that #3690 has been closed by previous changes to the mysql
jonleighton authored
26 * Fix bug with referencing other mysql databases in set_table_name. *GH 3690*
27
da327fc @jonleighton Add missing CHANGELOG entry for #3678. Closes #3678.
jonleighton authored
28 * Fix performance bug with mysql databases on a server with lots of other databses. *GH 3678*
29
30 *Christos Zisopoulos and Kenny J*
31
43486e0 @jonleighton Convert CHANGELOGs to Markdown format.
jonleighton authored
32 ## Rails 3.1.2 (unreleased) ##
33
b02daec @Juanmcuello Backport #3232 to 3-1-stable.
Juanmcuello authored
34 * Fix problem with prepared statements and PostgreSQL when multiple schemas are used.
35 *GH #3232*
36
37 *Juan M. Cuello*
38
e6d8ed5 @jonleighton Add missing CHANGELOG entries
jonleighton authored
39 * Fix bug with PostgreSQLAdapter#indexes. When the search path has multiple schemas, spaces
40 were not being stripped from the schema names after the first.
41
42 *Sean Kirby*
43
44 * Preserve SELECT columns on the COUNT for finder_sql when possible. *GH 3503*
45
46 *Justin Mazzi*
47
48 * Reset prepared statement cache when schema changes impact statement results. *GH 3335*
49
50 *Aaron Patterson*
51
52 * Postgres: Do not attempt to deallocate a statement if the connection is no longer active.
53
54 *Ian Leitch*
55
56 * Prevent QueryCache leaking database connections. *GH 3243*
57
58 *Mark J. Titorenko*
59
43486e0 @jonleighton Convert CHANGELOGs to Markdown format.
jonleighton authored
60 * Fix bug where building the conditions of a nested through association could potentially
61 modify the conditions of the through and/or source association. If you have experienced
62 bugs with conditions appearing in the wrong queries when using nested through associations,
63 this probably solves your problems. *GH #3271*
64
65 *Jon Leighton*
66
67 * If a record is removed from a has_many :through, all of the join records relating to that
68 record should also be removed from the through association's target.
69
70 *Jon Leighton*
71
72 * Fix adding multiple instances of the same record to a has_many :through. *GH #3425*
73
74 *Jon Leighton*
75
76 * Fix creating records in a through association with a polymorphic source type. *GH #3247*
77
78 *Jon Leighton*
79
fb73423 @kennyj Barckport to 3-1-stable: fixed an issue id false option is ignored on…
kennyj authored
80 * MySQL: use the information_schema than the describe command when we look for a primary key. *GH #3440*
81 *Kenny J*
82
43486e0 @jonleighton Convert CHANGELOGs to Markdown format.
jonleighton authored
83 ## Rails 3.1.1 (October 7, 2011) ##
84
85 * Raise an exception if the primary key of a model in an association is needed
86 but unknown. Fixes #3207.
87
88 *Jon Leighton*
89
90 * Add deprecation for the preload_associations method. Fixes #3022.
91
92 *Jon Leighton*
93
94 * Don't require a DB connection when loading a model that uses set_primary_key. GH #2807.
95
96 *Jon Leighton*
97
98 * Fix using select() with a habtm association, e.g. Person.friends.select(:name). GH #3030 and
99 \#2923.
100
101 *Hendy Tanata*
102
103 * Fix belongs_to polymorphic with custom primary key on target. GH #3104.
104
105 *Jon Leighton*
106
107 * CollectionProxy#replace should change the DB records rather than just mutating the array.
108 Fixes #3020.
109
110 *Jon Leighton*
111
112 * LRU cache in mysql and sqlite are now per-process caches.
113
114 * lib/active_record/connection_adapters/mysql_adapter.rb: LRU cache
115 keys are per process id.
116 * lib/active_record/connection_adapters/sqlite_adapter.rb: ditto
117
118 *Aaron Patterson*
119
120 * Database adapters use a statement pool for limiting the number of open
121 prepared statments on the database. The limit defaults to 1000, but can
122 be adjusted in your database config by changing 'statement_limit'.
123
124 * Fix clash between using 'preload', 'joins' or 'eager_load' in a default scope and including the
125 default scoped model in a nested through association. (GH #2834.) *Jon Leighton*
126
127 * Ensure we are not comparing a string with a symbol in HasManyAssociation#inverse_updates_counter_cache?.
128 Fixes GH #2755, where a counter cache could be decremented twice as far as it was supposed to be.
129
130 *Jon Leighton*
131
132 * Don't send any queries to the database when the foreign key of a belongs_to is nil. Fixes
133 GH #2828. *Georg Friedrich*
134
135 * Fixed find_in_batches method to not include order from default_scope. See GH #2832 *Arun Agrawal*
136
137 * Don't compute table name for abstract classes. Fixes problem with setting the primary key
138 in an abstract class. See GH #2791. *Akira Matsuda*
139
140 * Psych errors with poor yaml formatting are proxied. Fixes GH #2645 and
141 GH #2731
142
143 * Use the LIMIT word with the methods #last and #first. Fixes GH #2783 *Damien Mathieu*
144
145 ## Rails 3.1.0 (August 30, 2011) ##
146
147 * Add a proxy_association method to association proxies, which can be called by association
148 extensions to access information about the association. This replaces proxy_owner etc with
149 proxy_association.owner.
150
151 *Jon Leighton*
152
153 * Active Record's dynamic finder will now show a deprecation warning if you passing in less number of arguments than what you call in method signature. This behavior will raise ArgumentError in the next version of Rails *Prem Sichanugrist*
154
155 * Deprecated the AssociationCollection constant. CollectionProxy is now the appropriate constant
156 to use, though be warned that this is not really a public API.
157
158 This should solve upgrade problems with the will_paginate plugin (and perhaps others). Thanks
159 Paul Battley for reporting.
160
161 *Jon Leighton*
162
163 * ActiveRecord::MacroReflection::AssociationReflection#build_record has a new method signature.
164
165 Before: def build_association(*options)
166 After: def build_association(*options, &block)
167
168 Users who are redefining this method to extend functionality should ensure that the block is
169 passed through to ActiveRecord::Base#new.
170
171 This change is necessary to fix https://github.com/rails/rails/issues/1842.
172
173 A deprecation warning and workaround has been added to 3.1, but authors will need to update
174 their code for it to work correctly in 3.2.
175
176 *Jon Leighton*
177
178 * AR#pluralize_table_names can be used to singularize/pluralize table name of an individual model:
179
180 class User < ActiveRecord::Base
181 self.pluralize_table_names = false
182 end
183
184 Previously this could only be set globally for all models through ActiveRecord::Base.pluralize_table_names. *Guillermo Iguaran*
185
186 * Add block setting of attributes to singular associations:
187
188 class User < ActiveRecord::Base
189 has_one :account
190 end
191
192 user.build_account{ |a| a.credit_limit => 100.0 }
193
194 The block is called after the instance has been initialized. *Andrew White*
195
196 * Add ActiveRecord::Base.attribute_names to return a list of attribute names. This will return an empty array if the model is abstract or table does not exists. *Prem Sichanugrist*
197
198 * CSV Fixtures are deprecated and support will be removed in Rails 3.2.0
199
200 * AR#new, AR#create, AR#create!, AR#update_attributes and AR#update_attributes! all accept a second hash as option that allows you
201 to specify which role to consider when assigning attributes. This is built on top of ActiveModel's
202 new mass assignment capabilities:
203
204 class Post < ActiveRecord::Base
205 attr_accessible :title
206 attr_accessible :title, :published_at, :as => :admin
207 end
208
209 Post.new(params[:post], :as => :admin)
210
211 assign_attributes() with similar API was also added and attributes=(params, guard) was deprecated.
212
213 Please note that this changes the method signatures for AR#new, AR#create, AR#create!, AR#update_attributes and AR#update_attributes!. If you have overwritten these methods you should update them accordingly.
214
215 *Josh Kalderimis*
216
217 * default_scope can take a block, lambda, or any other object which responds to `call` for lazy
218 evaluation:
219
220 default_scope { ... }
221 default_scope lambda { ... }
222 default_scope method(:foo)
223
224 This feature was originally implemented by Tim Morgan, but was then removed in favour of
225 defining a 'default_scope' class method, but has now been added back in by Jon Leighton.
226 The relevant lighthouse ticket is #1812.
227
228 * Default scopes are now evaluated at the latest possible moment, to avoid problems where
229 scopes would be created which would implicitly contain the default scope, which would then
230 be impossible to get rid of via Model.unscoped.
231
232 Note that this means that if you are inspecting the internal structure of an
233 ActiveRecord::Relation, it will *not* contain the default scope, though the resulting
234 query will do. You can get a relation containing the default scope by calling
235 ActiveRecord#with_default_scope, though this is not part of the public API.
236
237 *Jon Leighton*
238
239 * If you wish to merge default scopes in special ways, it is recommended to define your default
240 scope as a class method and use the standard techniques for sharing code (inheritance, mixins,
241 etc.):
242
243 class Post < ActiveRecord::Base
244 def self.default_scope
245 where(:published => true).where(:hidden => false)
246 end
247 end
248
249 *Jon Leighton*
250
251 * PostgreSQL adapter only supports PostgreSQL version 8.2 and higher.
252
253 * ConnectionManagement middleware is changed to clean up the connection pool
254 after the rack body has been flushed.
255
256 * Added an update_column method on ActiveRecord. This new method updates a given attribute on an object, skipping validations and callbacks.
257 It is recommended to use #update_attribute unless you are sure you do not want to execute any callback, including the modification of
258 the updated_at column. It should not be called on new records.
259 Example:
260
261 User.first.update_column(:name, "sebastian") # => true
262
263 *Sebastian Martinez*
264
265 * Associations with a :through option can now use *any* association as the
266 through or source association, including other associations which have a
267 :through option and has_and_belongs_to_many associations
268
269 *Jon Leighton*
270
271 * The configuration for the current database connection is now accessible via
272 ActiveRecord::Base.connection_config. *fxn*
273
274 * limits and offsets are removed from COUNT queries unless both are supplied.
275 For example:
276
277 People.limit(1).count # => 'SELECT COUNT(*) FROM people'
278 People.offset(1).count # => 'SELECT COUNT(*) FROM people'
279 People.limit(1).offset(1).count # => 'SELECT COUNT(*) FROM people LIMIT 1 OFFSET 1'
280
281 *lighthouse #6262*
282
283 * ActiveRecord::Associations::AssociationProxy has been split. There is now an Association class
284 (and subclasses) which are responsible for operating on associations, and then a separate,
285 thin wrapper called CollectionProxy, which proxies collection associations.
286
287 This prevents namespace pollution, separates concerns, and will allow further refactorings.
288
289 Singular associations (has_one, belongs_to) no longer have a proxy at all. They simply return
290 the associated record or nil. This means that you should not use undocumented methods such
291 as bob.mother.create - use bob.create_mother instead.
292
293 *Jon Leighton*
294
295 * Make has_many :through associations work correctly when you build a record and then save it. This
296 requires you to set the :inverse_of option on the source reflection on the join model, like so:
297
298 class Post < ActiveRecord::Base
299 has_many :taggings
300 has_many :tags, :through => :taggings
301 end
302
303 class Tagging < ActiveRecord::Base
304 belongs_to :post
305 belongs_to :tag, :inverse_of => :tagging # :inverse_of must be set!
306 end
307
308 class Tag < ActiveRecord::Base
309 has_many :taggings
310 has_many :posts, :through => :taggings
311 end
312
313 post = Post.first
314 tag = post.tags.build :name => "ruby"
315 tag.save # will save a Taggable linking to the post
316
317 *Jon Leighton*
318
319 * Support the :dependent option on has_many :through associations. For historical and practical
320 reasons, :delete_all is the default deletion strategy employed by association.delete(*records),
321 despite the fact that the default strategy is :nullify for regular has_many. Also, this only
322 works at all if the source reflection is a belongs_to. For other situations, you should directly
323 modify the through association.
324
325 *Jon Leighton*
326
327 * Changed the behaviour of association.destroy for has_and_belongs_to_many and has_many :through.
328 From now on, 'destroy' or 'delete' on an association will be taken to mean 'get rid of the link',
329 not (necessarily) 'get rid of the associated records'.
330
331 Previously, has_and_belongs_to_many.destroy(*records) would destroy the records themselves. It
332 would not delete any records in the join table. Now, it deletes the records in the join table.
333
334 Previously, has_many_through.destroy(*records) would destroy the records themselves, and the
335 records in the join table. [Note: This has not always been the case; previous version of Rails
336 only deleted the records themselves.] Now, it destroys only the records in the join table.
337
338 Note that this change is backwards-incompatible to an extent, but there is unfortunately no
339 way to 'deprecate' it before changing it. The change is being made in order to have
340 consistency as to the meaning of 'destroy' or 'delete' across the different types of associations.
341
342 If you wish to destroy the records themselves, you can do records.association.each(&:destroy)
343
344 *Jon Leighton*
345
346 * Add :bulk => true option to change_table to make all the schema changes defined in change_table block using a single ALTER statement. *Pratik Naik*
347
348 Example:
349
350 change_table(:users, :bulk => true) do |t|
351 t.string :company_name
352 t.change :birthdate, :datetime
353 end
354
355 This will now result in:
356
357 ALTER TABLE `users` ADD COLUMN `company_name` varchar(255), CHANGE `updated_at` `updated_at` datetime DEFAULT NULL
358
359 * Removed support for accessing attributes on a has_and_belongs_to_many join table. This has been
360 documented as deprecated behaviour since April 2006. Please use has_many :through instead.
361 *Jon Leighton*
362
363 * Added a create_association! method for has_one and belongs_to associations. *Jon Leighton*
364
365 * Migration files generated from model and constructive migration generators
366 (for example, add_name_to_users) use the reversible migration's `change`
367 method instead of the ordinary `up` and `down` methods. *Prem Sichanugrist*
368
369 * Removed support for interpolating string SQL conditions on associations. Instead, you should
370 use a proc, like so:
371
372 Before:
373
374 has_many :things, :conditions => 'foo = #{bar}'
375
376 After:
377
378 has_many :things, :conditions => proc { "foo = #{bar}" }
379
380 Inside the proc, 'self' is the object which is the owner of the association, unless you are
381 eager loading the association, in which case 'self' is the class which the association is within.
382
383 You can have any "normal" conditions inside the proc, so the following will work too:
384
385 has_many :things, :conditions => proc { ["foo = ?", bar] }
386
387 Previously :insert_sql and :delete_sql on has_and_belongs_to_many association allowed you to call
388 'record' to get the record being inserted or deleted. This is now passed as an argument to
389 the proc.
390
391 * Added ActiveRecord::Base#has_secure_password (via ActiveModel::SecurePassword) to encapsulate dead-simple password usage with BCrypt encryption and salting [DHH]. Example:
392
393 # Schema: User(name:string, password_digest:string, password_salt:string)
394 class User < ActiveRecord::Base
395 has_secure_password
396 end
397
398 user = User.new(:name => "david", :password => "", :password_confirmation => "nomatch")
399 user.save # => false, password required
400 user.password = "mUc3m00RsqyRe"
401 user.save # => false, confirmation doesn't match
402 user.password_confirmation = "mUc3m00RsqyRe"
403 user.save # => true
404 user.authenticate("notright") # => false
405 user.authenticate("mUc3m00RsqyRe") # => user
406 User.find_by_name("david").try(:authenticate, "notright") # => nil
407 User.find_by_name("david").try(:authenticate, "mUc3m00RsqyRe") # => user
408
409
410 * When a model is generated add_index is added by default for belongs_to or references columns
411
412 rails g model post user:belongs_to will generate the following:
413
414 class CreatePosts < ActiveRecord::Migration
415 def change
416 create_table :posts do |t|
417 t.belongs_to :user
418 t.timestamps
419 end
420 add_index :posts, :user_id
421 end
422 end
423
424 *Santiago Pastorino*
425
426 * Setting the id of a belongs_to object will update the reference to the
427 object. *#2989 state:resolved*
428
429 * ActiveRecord::Base#dup and ActiveRecord::Base#clone semantics have changed
430 to closer match normal Ruby dup and clone semantics.
431
432 * Calling ActiveRecord::Base#clone will result in a shallow copy of the record,
433 including copying the frozen state. No callbacks will be called.
434
435 * Calling ActiveRecord::Base#dup will duplicate the record, including calling
436 after initialize hooks. Frozen state will not be copied, and all associations
437 will be cleared. A duped record will return true for new_record?, have a nil
438 id field, and is saveable.
439
440 * Migrations can be defined as reversible, meaning that the migration system
441 will figure out how to reverse your migration. To use reversible migrations,
442 just define the "change" method. For example:
443
444 class MyMigration < ActiveRecord::Migration
445 def change
446 create_table(:horses) do
447 t.column :content, :text
448 t.column :remind_at, :datetime
449 end
450 end
451 end
452
453 Some things cannot be automatically reversed for you. If you know how to
454 reverse those things, you should define 'up' and 'down' in your migration. If
455 you define something in `change` that cannot be reversed, an
456 IrreversibleMigration exception will be raised when going down.
457
458 * Migrations should use instance methods rather than class methods:
459 class FooMigration < ActiveRecord::Migration
460 def up
461 ...
462 end
463 end
464
465 *Aaron Patterson*
466
467 * has_one maintains the association with separate after_create/after_update instead
468 of a single after_save. *fxn*
469
470 * The following code:
471
472 Model.limit(10).scoping { Model.count }
473
474 now generates the following SQL:
475
476 SELECT COUNT(*) FROM models LIMIT 10
477
478 This may not return what you want. Instead, you may with to do something
479 like this:
480
481 Model.limit(10).scoping { Model.all.size }
482
483 *Aaron Patterson*
484
485
486 ## Rails 3.0.7 (April 18, 2011) ##
487
488 * Destroying records via nested attributes works independent of reject_if LH #6006 *Durran Jordan*
489
490 * Delegate any? and many? to Model.scoped for consistency *Andrew White*
491
492 * Quote the ORDER BY clause in batched finds - fixes #6620 *Andrew White*
493
494 * Change exists? so records are not instantiated - fixes #6127. This prevents after_find
495 and after_initialize callbacks being triggered when checking for record existence.
496 *Andrew White*
497
498 * Fix performance bug with attribute accessors which only occurred on Ruby 1.8.7, and ensure we
499 cache type-casted values when the column returned from the db contains non-standard chars.
500 *Jon Leighton*
501
502 * Fix a performance regression introduced here 86acbf1cc050c8fa8c74a10c735e467fb6fd7df8
503 related to read_attribute method *Stian Grytøyr*
504
505
506 ## Rails 3.0.6 (April 5, 2011) ##
507
508 * Un-deprecate reorder method *Sebastian Martinez*
509
510 * Extensions are applied when calling +except+ or +only+ on relations.
511 Thanks to Iain Hecker.
512
513 * Schemas set in set_table_name are respected by the mysql adapter. LH #5322
514
515 * Fixed a bug when empty? was called on a grouped Relation that wasn't loaded.
516 LH #5829
517
518 * Reapply extensions when using except and only. Thanks Iain Hecker.
519
520 * Binary data is escaped when being inserted to SQLite3 Databases. Thanks
521 Naruse!
522
523
524 ## Rails 3.0.5 (February 26, 2011) ##
525
526 * Model.where(:column => 1).where(:column => 2) will always produce an AND
527 query.
528
529 *Aaron Patterson*
530
531 * Deprecated support for interpolated association conditions in the form of :conditions => 'foo = #{bar}'.
532
533 Instead, you should use a proc, like so:
534
535 Before:
536
537 has_many :things, :conditions => 'foo = #{bar}'
538
539 After:
540
541 has_many :things, :conditions => proc { "foo = #{bar}" }
542
543 Inside the proc, 'self' is the object which is the owner of the association, unless you are
544 eager loading the association, in which case 'self' is the class which the association is within.
545
546 You can have any "normal" conditions inside the proc, so the following will work too:
547
548 has_many :things, :conditions => proc { ["foo = ?", bar] }
549
550 Previously :insert_sql and :delete_sql on has_and_belongs_to_many association allowed you to call
551 'record' to get the record being inserted or deleted. This is now passed as an argument to
552 the proc.
553
554 *Jon Leighton*
555
556
557 ## Rails 3.0.4 (February 8, 2011) ##
558
559 * Added deprecation warning for has_and_belongs_to_many associations where the join table has
560 additional attributes other than the keys. Access to these attributes is removed in 3.1.
561 Please use has_many :through instead. *Jon Leighton*
562
563
564 ## Rails 3.0.3 (November 16, 2010) ##
565
566 * Support find by class like this: Post.where(:name => Post)
567
568
569 ## Rails 3.0.2 (November 15, 2010) ##
570
571 * Dramatic speed increase (see: http://engineering.attinteractive.com/2010/10/arel-two-point-ohhhhh-yaaaaaa/) *Aaron Patterson*
572
573 * reorder is deprecated in favor of except(:order).order(...) *Santiago Pastorino*
574
575 * except is now AR public API
576
577 Model.order('name').except(:order).order('salary')
578
579 generates:
580
581 SELECT * FROM models ORDER BY salary
582
583 *Santiago Pastorino*
584
585 * The following code:
586
587 Model.limit(10).scoping { Model.count }
588
589 now generates the following SQL:
590
591 SELECT COUNT(*) FROM models LIMIT 10
592
593 This may not return what you want. Instead, you may with to do something
594 like this:
595
596 Model.limit(10).scoping { Model.all.size }
597
598 *Aaron Patterson*
599
600
601 ## Rails 3.0.1 (October 15, 2010) ##
602
603 * Introduce a fix for CVE-2010-3993
604
605
606 ## Rails 3.0.0 (August 29, 2010) ##
607
608 * Changed update_attribute to not run callbacks and update the record directly in the database *Neeraj Singh*
609
610 * Add scoping and unscoped as the syntax to replace the old with_scope and with_exclusive_scope *José Valim*
611
612 * New rake task, db:migrate:status, displays status of migrations #4947 *Kevin Skoglund*
613
614 * select and order for ActiveRecord now always concatenate nested calls. Use reorder if you want the original order to be overwritten *Santiago Pastorino*
615
616 * PostgreSQL: ensure the database time zone matches Ruby's time zone #4895 *Aaron Patterson*
617
618 * Fixed that ActiveRecord::Base.compute_type would swallow NoMethodError #4751 *Andrew Bloomgarden, Andrew White*
619
620 * Add index length support for MySQL. #1852 *Emili Parreno, Pratik Naik*
621
622 Example:
623
624 add_index(:accounts, :name, :name => 'by_name', :length => 10)
625 => CREATE INDEX by_name ON accounts(name(10))
626
627 add_index(:accounts, [:name, :surname], :name => 'by_name_surname', :length => {:name => 10, :surname => 15})
628 => CREATE INDEX by_name_surname ON accounts(name(10), surname(15))
629
630 * find_or_create_by_attr(value, ...) works when attr is protected. #4457 *Santiago Pastorino, Marc-André Lafortune*
631
632 * New callbacks: after_commit and after_rollback. Do expensive operations like image thumbnailing after_commit instead of after_save. #2991 *Brian Durand*
633
634 * Serialized attributes are not converted to YAML if they are any of the formats that can be serialized to XML (like Hash, Array and Strings). *José Valim*
635
636 * Destroy uses optimistic locking. If lock_version on the record you're destroying doesn't match lock_version in the database, a StaleObjectError is raised. #1966 *Curtis Hawthorne*
637
638 * PostgreSQL: drop support for old postgres driver. Use pg 0.9.0 or later. *Jeremy Kemper*
639
640 * Observers can prevent records from saving by returning false, just like before_save and friends. #4087 *Mislav Marohnić*
641
642 * Add Relation extensions. *Pratik Naik*
643
644 users = User.where(:admin => true).extending(User::AdminPowers)
645
646 latest_users = User.order('created_at DESC') do
647 def posts_count
648 Post.count(:user_id => to_a.map(&:id))
649 end
650 end
651
652 * To prefix the table names of all models in a module, define self.table_name_prefix on the module. #4032 *Andrew White*
653
654 * Silenced "SHOW FIELDS" and "SET SQL_AUTO_IS_NULL=0" statements from the MySQL driver to improve log signal to noise ration in development *DHH*
655
656 * PostgreSQLAdapter: set time_zone to UTC when Base.default_timezone == :utc so that Postgres doesn't incorrectly offset-adjust values inserted into TIMESTAMP WITH TIME ZONE columns. #3777 *Jack Christensen*
657
658 * Allow relations to be used as scope.
659
660 class Item
661 scope :red, where(:colour => 'red')
662 end
663
664 Item.red.limit(10) # Ten red items
665
666 * Rename named_scope to scope. *Pratik Naik*
667
668 * Changed ActiveRecord::Base.store_full_sti_class to be true by default reflecting the previously announced Rails 3 default *DHH*
669
670 * Add Relation#except. *Pratik Naik*
671
672 one_red_item = Item.where(:colour => 'red').limit(1)
673 all_items = one_red_item.except(:where, :limit)
674
675 * Add Relation#delete_all. *Pratik Naik*
676
677 Item.where(:colour => 'red').delete_all
678
679 * Add Model.having and Relation#having. *Pratik Naik*
680
681 Developer.group("salary").having("sum(salary) > 10000").select("salary")
682
683 * Add Relation#count. *Pratik Naik*
684
685 legends = People.where("age > 100")
686 legends.count
687 legends.count(:age, :distinct => true)
688 legends.select('id').count
689
690 * Add Model.readonly and association_collection#readonly finder method. *Pratik Naik*
691
692 Post.readonly.to_a # Load all posts in readonly mode
693 @user.items.readonly(false).to_a # Load all the user items in writable mode
694
695 * Add .lock finder method *Pratik Naik*
696
697 User.lock.where(:name => 'lifo').to_a
698
699 old_items = Item.where("age > 100")
700 old_items.lock.each {|i| .. }
701
702 * Add Model.from and association_collection#from finder methods *Pratik Naik*
703
704 user = User.scoped
705 user.select('*').from('users, items')
706
707 * Add relation.destroy_all *Pratik Naik*
708
709 old_items = Item.where("age > 100")
710 old_items.destroy_all
711
712 * Add relation.exists? *Pratik Naik*
713
714 red_items = Item.where(:colours => 'red')
715 red_items.exists?
716 red_items.exists?(1)
717
718 * Add find(ids) to relations. *Pratik Naik*
719
720 old_users = User.order("age DESC")
721 old_users.find(1)
722 old_users.find(1, 2, 3)
723
724 * Add new finder methods to association collection. *Pratik Naik*
725
726 class User < ActiveRecord::Base
727 has_many :items
728 end
729
730 user = User.first
731 user.items.where(:items => {:colour => 'red'})
732 user.items.select('items.id')
733
734 * Add relation.reload to force reloading the records. *Pratik Naik*
735
736 topics = Topic.scoped
737 topics.to_a # force load
738 topics.first # returns a cached record
739 topics.reload
740 topics.first # Fetches a new record from the database
741
742 * Rename Model.conditions and relation.conditions to .where. *Pratik Naik*
743
744 Before :
745 User.conditions(:name => 'lifo')
746 User.select('id').conditions(["age > ?", 21])
747
748 Now :
749 User.where(:name => 'lifo')
750 User.select('id').where(["age > ?", 21])
751
752 * Add Model.select/group/order/limit/joins/conditions/preload/eager_load class methods returning a lazy relation. *Pratik Naik*
753
754 Examples :
755
756 posts = Post.select('id).order('name') # Returns a lazy relation
757 posts.each {|p| puts p.id } # Fires "select id from posts order by name"
758
759 * Model.scoped now returns a relation if invoked without any arguments. *Pratik Naik*
760
761 Example :
762
763 posts = Post.scoped
764 posts.size # Fires "select count(*) from posts" and returns the count
765 posts.each {|p| puts p.name } # Fires "select * from posts" and loads post objects
766
767 * Association inverses for belongs_to, has_one, and has_many. Optimization to reduce database queries. #3533 *Murray Steele*
768
769 # post.comments sets each comment's post without needing to :include
770 class Post < ActiveRecord::Base
771 has_many :comments, :inverse_of => :post
772 end
773
774 * MySQL: add_ and change_column support positioning. #3286 *Ben Marini*
775
776 * Reset your Active Record counter caches with the reset_counter_cache class method. #1211 *Mike Breen, Gabe da Silveira*
777
778 * Remove support for SQLite 2. Please upgrade to SQLite 3+ or install the plugin from git://github.com/rails/sqlite2_adapter.git *Pratik Naik*
779
780 * PostgreSQL: XML datatype support. #1874 *Leonardo Borges*
781
782 * quoted_date converts time-like objects to ActiveRecord::Base.default_timezone before serialization. This allows you to use Time.now in find conditions and have it correctly be serialized as the current time in UTC when default_timezone == :utc. #2946 *Geoff Buesing*
783
784 * SQLite: drop support for 'dbfile' option in favor of 'database.' #2363 *Paul Hinze, Jeremy Kemper*
785
786 * Added :primary_key option to belongs_to associations. #765 *Szymon Nowak, Philip Hallstrom, Noel Rocha*
787 # employees.company_name references companies.name
788 Employee.belongs_to :company, :primary_key => 'name', :foreign_key => 'company_name'
789
790 * Implement #many? for NamedScope and AssociationCollection using #size. #1500 *Chris Kampmeier*
791
792 * Added :touch option to belongs_to associations that will touch the parent record when the current record is saved or destroyed *DHH*
793
794 * Added ActiveRecord::Base#touch to update the updated_at/on attributes (or another specified timestamp) with the current time *DHH*
795
796
797 ## 2.3.2 Final (March 15, 2009) ##
798
799 * Added ActiveRecord::Base.find_each and ActiveRecord::Base.find_in_batches for batch processing *DHH/Jamis Buck*
800
801 * Added that ActiveRecord::Base.exists? can be called with no arguments #1817 *Scott Taylor*
802
803 * Add Support for updating deeply nested models from a single form. #1202 *Eloy Duran*
804
805 class Book < ActiveRecord::Base
806 has_one :author
807 has_many :pages
808
809 accepts_nested_attributes_for :author, :pages
810 end
811
812 * Make after_save callbacks fire only if the record was successfully saved. #1735 *Michael Lovitt*
813
814 Previously the callbacks would fire if a before_save cancelled saving.
815
816 * Support nested transactions using database savepoints. #383 *Jonathan Viney, Hongli Lai*
817
818 * Added dynamic scopes ala dynamic finders #1648 *Yaroslav Markin*
819
820 * Fixed that ActiveRecord::Base#new_record? should return false (not nil) for existing records #1219 *Yaroslav Markin*
821
822 * I18n the word separator for error messages. Introduces the activerecord.errors.format.separator translation key. #1294 *Akira Matsuda*
823
824 * Add :having as a key to find and the relevant associations. *Emilio Tagua*
825
826 * Added default_scope to Base #1381 [Paweł Kondzior]. Example:
827
828 class Person < ActiveRecord::Base
829 default_scope :order => 'last_name, first_name'
830 end
831
832 class Company < ActiveRecord::Base
833 has_many :people
834 end
835
836 Person.all # => Person.find(:all, :order => 'last_name, first_name')
837 Company.find(1).people # => Person.find(:all, :order => 'last_name, first_name', :conditions => { :company_id => 1 })
838
839
840 ## 2.2.1 RC2 (November 14th, 2008) ##
841
842 * Ensure indices don't flip order in schema.rb #1266 *Jordi Bunster*
843
844 * Fixed that serialized strings should never be type-casted (i.e. turning "Yes" to a boolean) #857 *Andreas Korth*
845
846
847 ## 2.2.0 RC1 (October 24th, 2008) ##
848
849 * Skip collection ids reader optimization if using :finder_sql *Jeremy Kemper*
850
851 * Add Model#delete instance method, similar to Model.delete class method. #1086 *Hongli Lai (Phusion)*
852
853 * MySQL: cope with quirky default values for not-null text columns. #1043 *Frederick Cheung*
854
855 * Multiparameter attributes skip time zone conversion for time-only columns [#1030 state:resolved] *Geoff Buesing*
856
857 * Base.skip_time_zone_conversion_for_attributes uses class_inheritable_accessor, so that subclasses don't overwrite Base [#346 state:resolved] *Emilio Tagua*
858
859 * Added find_last_by dynamic finder #762 *Emilio Tagua*
860
861 * Internal API: configurable association options and build_association method for reflections so plugins may extend and override. #985 *Hongli Lai (Phusion)*
862
863 * Changed benchmarks to be reported in milliseconds *David Heinemeier Hansson*
864
865 * Connection pooling. #936 *Nick Sieger*
866
867 * Merge scoped :joins together instead of overwriting them. May expose scoping bugs in your code! #501 *Andrew White*
868
869 * before_save, before_validation and before_destroy callbacks that return false will now ROLLBACK the transaction. Previously this would have been committed before the processing was aborted. #891 *Xavier Noria*
870
871 * Transactional migrations for databases which support them. #834 *divoxx, Adam Wiggins, Tarmo Tänav*
872
873 * Set config.active_record.timestamped_migrations = false to have migrations with numeric prefix instead of UTC timestamp. #446. *Andrew Stone, Nik Wakelin*
874
875 * change_column_default preserves the not-null constraint. #617 *Tarmo Tänav*
876
877 * Fixed that create database statements would always include "DEFAULT NULL" (Nick Sieger) *#334*
878
879 * Add :tokenizer option to validates_length_of to specify how to split up the attribute string. #507. [David Lowenfels] Example :
880
881 \# Ensure essay contains at least 100 words.
882 validates_length_of :essay, :minimum => 100, :too_short => "Your essay must be at least %d words."), :tokenizer => lambda {|str| str.scan(/\w+/) }
883
884 * Allow conditions on multiple tables to be specified using hash. [Pratik Naik]. Example:
885
886 User.all :joins => :items, :conditions => { :age => 10, :items => { :color => 'black' } }
887 Item.first :conditions => { :items => { :color => 'red' } }
888
889 * Always treat integer :limit as byte length. #420 *Tarmo Tänav*
890
891 * Partial updates don't update lock_version if nothing changed. #426 *Daniel Morrison*
892
893 * Fix column collision with named_scope and :joins. #46 *Duncan Beevers, Mark Catley*
894
895 * db:migrate:down and :up update schema_migrations. #369 *Michael Raidel, RaceCondition*
896
897 * PostgreSQL: support :conditions => [':foo::integer', { :foo => 1 }] without treating the ::integer typecast as a bind variable. *Tarmo Tänav*
898
899 * MySQL: rename_column preserves column defaults. #466 *Diego Algorta*
900
901 * Add :from option to calculations. #397 *Ben Munat*
902
903 * Add :validate option to associations to enable/disable the automatic validation of associated models. Resolves #301. *Jan De Poorter*
904
905 * PostgreSQL: use 'INSERT ... RETURNING id' for 8.2 and later. *Jeremy Kemper*
906
907 * Added SQL escaping for :limit and :offset in MySQL *Jonathan Wiess*
908
909
910 ## 2.1.0 (May 31st, 2008) ##
911
912 * Add ActiveRecord::Base.sti_name that checks ActiveRecord::Base#store_full_sti_class? and returns either the full or demodulized name. *Rick Olson*
913
914 * Add first/last methods to associations/named_scope. Resolved #226. *Ryan Bates*
915
916 * Added SQL escaping for :limit and :offset #288 *Aaron Bedra, Steven Bristol, Jonathan Wiess*
917
918 * Added first/last methods to associations/named_scope. Resolved #226. *Ryan Bates*
919
920 * Ensure hm:t preloading honours reflection options. Resolves #137. *Frederick Cheung*
921
922 * Added protection against duplicate migration names (Aslak Hellesøy) *#112*
923
924 * Base#instantiate_time_object: eliminate check for Time.zone, since we can assume this is set if time_zone_aware_attributes is set to true *Geoff Buesing*
925
926 * Time zone aware attribute methods use Time.zone.parse instead of #to_time for String arguments, so that offset information in String is respected. Resolves #105. *Scott Fleckenstein, Geoff Buesing*
927
928 * Added change_table for migrations (Jeff Dean) [#71]. Example:
929
930 change_table :videos do |t|
931 t.timestamps # adds created_at, updated_at
932 t.belongs_to :goat # adds goat_id integer
933 t.string :name, :email, :limit => 20 # adds name and email both with a 20 char limit
934 t.remove :name, :email # removes the name and email columns
935 end
936
937 * Fixed has_many :through .create with no parameters caused a "can't dup NilClass" error (Steven Soroka) *#85*
938
939 * Added block-setting of attributes for Base.create like Base.new already has (Adam Meehan) *#39*
940
941 * Fixed that pessimistic locking you reference the quoted table name (Josh Susser) *#67*
942
943 * Fixed that change_column should be able to use :null => true on a field that formerly had false [Nate Wiger] *#26*
944
945 * Added that the MySQL adapter should map integer to either smallint, int, or bigint depending on the :limit just like PostgreSQL *David Heinemeier Hansson*
946
947 * Change validates_uniqueness_of :case_sensitive option default back to true (from [9160]). Love your database columns, don't LOWER them. *Rick Olson*
948
949 * Add support for interleaving migrations by storing which migrations have run in the new schema_migrations table. Closes #11493 *Jordi Bunster*
950
951 * ActiveRecord::Base#sum defaults to 0 if no rows are returned. Closes #11550 *Kamal Fariz Mahyuddin*
952
953 * Ensure that respond_to? considers dynamic finder methods. Closes #11538. *James Mead*
954
955 * Ensure that save on parent object fails for invalid has_one association. Closes #10518. *Pratik Naik*
956
957 * Remove duplicate code from associations. *Pratik Naik*
958
959 * Refactor HasManyThroughAssociation to inherit from HasManyAssociation. Association callbacks and <association>_ids= now work with hm:t. #11516 *Ruy Asan*
960
961 * Ensure HABTM#create and HABTM#build do not load entire association. *Pratik Naik*
962
963 * Improve documentation. *Xavier Noria, Jack Danger Canty, leethal*
964
965 * Tweak ActiveRecord::Base#to_json to include a root value in the returned hash: {"post": {"title": ...}} *Rick Olson*
966
967 Post.find(1).to_json # => {"title": ...}
968 config.active_record.include_root_in_json = true
969 Post.find(1).to_json # => {"post": {"title": ...}}
970
971 * Add efficient #include? to AssociationCollection (for has_many/has_many :through/habtm). *stopdropandrew*
972
973 * PostgreSQL: create_ and drop_database support. #9042 *ez, pedz, Nick Sieger*
974
975 * Ensure that validates_uniqueness_of works with with_scope. Closes #9235. *Nik Wakelin, cavalle*
976
977 * Partial updates include only unsaved attributes. Off by default; set YourClass.partial_updates = true to enable. *Jeremy Kemper*
978
979 * Removing unnecessary uses_tzinfo helper from tests, given that TZInfo is now bundled *Geoff Buesing*
980
981 * Fixed that validates_size_of :within works in associations #11295, #10019 *cavalle*
982
983 * Track changes to unsaved attributes. *Jeremy Kemper*
984
985 * Switched to UTC-timebased version numbers for migrations and the schema. This will as good as eliminate the problem of multiple migrations getting the same version assigned in different branches. Also added rake db:migrate:up/down to apply individual migrations that may need to be run when you merge branches #11458 *John Barnette*
986
987 * Fixed that has_many :through would ignore the hash conditions #11447 *Emilio Tagua*
988
989 * Fix issue where the :uniq option of a has_many :through association is ignored when find(:all) is called. Closes #9407 *cavalle*
990
991 * Fix duplicate table alias error when including an association with a has_many :through association on the same join table. Closes #7310 *cavalle*
992
993 * More efficient association preloading code that compacts a through_records array in a central location. Closes #11427 *Jack Danger Canty*
994
995 * Improve documentation. *Ryan Bigg, Jan De Poorter, Cheah Chu Yeow, Xavier Shay, Jack Danger Canty, Emilio Tagua, Xavier Noria, Sunny Ripert*
996
997 * Fixed that ActiveRecord#Base.find_or_create/initialize would not honor attr_protected/accessible when used with a hash #11422 *Emilio Tagua*
998
999 * Added ActiveRecord#Base.all/first/last as aliases for find(:all/:first/:last) #11413 *nkallen, Chris O'Sullivan*
1000
1001 * Merge the has_finder gem, renamed as 'named_scope'. #11404 *nkallen*
1002
1003 class Article < ActiveRecord::Base
1004 named_scope :published, :conditions => {:published => true}
1005 named_scope :popular, :conditions => ...
1006 end
1007
1008 Article.published.paginate(:page => 1)
1009 Article.published.popular.count
1010 Article.popular.find(:first)
1011 Article.popular.find(:all, :conditions => {...})
1012
1013 See http://pivots.pivotallabs.com/users/nick/blog/articles/284-hasfinder-it-s-now-easier-than-ever-to-create-complex-re-usable-sql-queries
1014
1015 * Add has_one :through support. #4756 *Chris O'Sullivan*
1016
1017 * Migrations: create_table supports primary_key_prefix_type. #10314 *student, Chris O'Sullivan*
1018
1019 * Added logging for dependency load errors with fixtures #11056 *stuthulhu*
1020
1021 * Time zone aware attributes use Time#in_time_zone *Geoff Buesing*
1022
1023 * Fixed that scoped joins would not always be respected #6821 *Theory/Jack Danger Canty*
1024
1025 * Ensure that ActiveRecord::Calculations disambiguates field names with the table name. #11027 *cavalle*
1026
1027 * Added add/remove_timestamps to the schema statements for adding the created_at/updated_at columns on existing tables #11129 *jramirez*
1028
1029 * Added ActiveRecord::Base.find(:last) #11338 *Emilio Tagua*
1030
1031 * test_native_types expects DateTime.local_offset instead of DateTime.now.offset; fixes test breakage due to dst transition *Geoff Buesing*
1032
1033 * Add :readonly option to HasManyThrough associations. #11156 *Emilio Tagua*
1034
1035 * Improve performance on :include/:conditions/:limit queries by selectively joining in the pre-query. #9560 *dasil003*
1036
1037 * Perf fix: Avoid the use of named block arguments. Closes #11109 *adymo*
1038
1039 * PostgreSQL: support server versions 7.4 through 8.0 and the ruby-pg driver. #11127 *jdavis*
1040
1041 * Ensure association preloading doesn't break when an association returns nil. ##11145 *GMFlash*
1042
1043 * Make dynamic finders respect the :include on HasManyThrough associations. #10998. *cpytel*
1044
1045 * Base#instantiate_time_object only uses Time.zone when Base.time_zone_aware_attributes is true; leverages Time#time_with_datetime_fallback for readability *Geoff Buesing*
1046
1047 * Refactor ConnectionAdapters::Column.new_time: leverage DateTime failover behavior of Time#time_with_datetime_fallback *Geoff Buesing*
1048
1049 * Improve associations performance by using symbol callbacks instead of string callbacks. #11108 *adymo*
1050
1051 * Optimise the BigDecimal conversion code. #11110 *adymo*
1052
1053 * Introduce the :readonly option to all associations. Records from the association cannot be saved. #11084 *Emilio Tagua*
1054
1055 * Multiparameter attributes for time columns fail over to DateTime when out of range of Time *Geoff Buesing*
1056
1057 * Base#instantiate_time_object uses Time.zone.local() *Geoff Buesing*
1058
1059 * Add timezone-aware attribute readers and writers. #10982 *Geoff Buesing*
1060
1061 * Instantiating time objects in multiparameter attributes uses Time.zone if available. #10982 *Rick Olson*
1062
1063 * Add note about how ActiveRecord::Observer classes are initialized in a Rails app. #10980 *Xavier Noria*
1064
1065 * MySQL: omit text/blob defaults from the schema instead of using an empty string. #10963 *mdeiters*
1066
1067 * belongs_to supports :dependent => :destroy and :delete. #10592 *Jonathan Viney*
1068
1069 * Introduce preload query strategy for eager :includes. #9640 *Frederick Cheung, Aliaksey Kandratsenka, codafoo*
1070
1071 * Support aggregations in finder conditions. #10572 *Ryan Kinderman*
1072
1073 * Organize and clean up the Active Record test suite. #10742 *John Barnette*
1074
1075 * Ensure that modifying has_and_belongs_to_many actions clear the query cache. Closes #10840 *john.andrews*
1076
1077 * Fix issue where Table#references doesn't pass a :null option to a *_type attribute for polymorphic associations. Closes #10753 *railsjitsu*
1078
1079 * Fixtures: removed support for the ancient pre-YAML file format. #10736 *John Barnette*
1080
1081 * More thoroughly quote table names. #10698 *dimdenis, lotswholetime, Jeremy Kemper*
1082
1083 * update_all ignores scoped :order and :limit, so post.comments.update_all doesn't try to include the comment order in the update statement. #10686 *Brendan Ribera*
1084
1085 * Added ActiveRecord::Base.cache_key to make it easier to cache Active Records in combination with the new ActiveSupport::Cache::* libraries *David Heinemeier Hansson*
1086
1087 * Make sure CSV fixtures are compatible with ruby 1.9's new csv implementation. *JEG2*
1088
1089 * Added by parameter to increment, decrement, and their bang varieties so you can do player1.increment!(:points, 5) #10542 *Sam*
1090
1091 * Optimize ActiveRecord::Base#exists? to use #select_all instead of #find. Closes #10605 *jamesh, Frederick Cheung, protocool*
1092
1093 * Don't unnecessarily load has_many associations in after_update callbacks. Closes #6822 *stopdropandrew, canadaduane*
1094
1095 * Eager belongs_to :include infers the foreign key from the association name rather than the class name. #10517 *Jonathan Viney*
1096
1097 * SQLite: fix rename_ and remove_column for columns with unique indexes. #10576 *Brandon Keepers*
1098
1099 * Ruby 1.9 compatibility. #10655 *Jeremy Kemper, Dirkjan Bussink*
1100
1101
1102 ## 2.0.2 (December 16th, 2007) ##
1103
1104 * Ensure optimistic locking handles nil #lock_version values properly. Closes #10510 *Rick Olson*
1105
1106 * Make the Fixtures Test::Unit enhancements more supporting for double-loaded test cases. Closes #10379 *brynary*
1107
1108 * Fix that validates_acceptance_of still works for non-existent tables (useful for bootstrapping new databases). Closes #10474 *Josh Susser*
1109
1110 * Ensure that the :uniq option for has_many :through associations retains the order. #10463 *remvee*
1111
1112 * Base.exists? doesn't rescue exceptions to avoid hiding SQL errors. #10458 *Michael Klishin*
1113
1114 * Documentation: Active Record exceptions, destroy_all and delete_all. #10444, #10447 *Michael Klishin*
1115
1116
1117 ## 2.0.1 (December 7th, 2007) ##
1118
1119 * Removed query cache rescue as it could cause code to be run twice (closes #10408) *David Heinemeier Hansson*
1120
1121
1122 ## 2.0.0 (December 6th, 2007) ##
1123
1124 * Anchor DateTimeTest to fixed DateTime instead of a variable value based on Time.now#advance#to_datetime, so that this test passes on 64-bit platforms running Ruby 1.8.6+ *Geoff Buesing*
1125
1126 * Fixed that the Query Cache should just be ignored if the database is misconfigured (so that the "About your applications environment" works even before the database has been created) *David Heinemeier Hansson*
1127
1128 * Fixed that the truncation of strings longer than 50 chars should use inspect
1129 so newlines etc are escaped #10385 *Norbert Crombach*
1130
1131 * Fixed that habtm associations should be able to set :select as part of their definition and have that honored *David Heinemeier Hansson*
1132
1133 * Document how the :include option can be used in Calculations::calculate. Closes #7446 *adamwiggins, ultimoamore*
1134
1135 * Fix typo in documentation for polymorphic associations w/STI. Closes #7461 *johnjosephbachir*
1136
1137 * Reveal that the type option in migrations can be any supported column type for your database but also include caveat about agnosticism. Closes #7531 *adamwiggins, mikong*
1138
1139 * More complete documentation for find_by_sql. Closes #7912 *fearoffish*
1140
1141 * Added ActiveRecord::Base#becomes to turn a record into one of another class (mostly relevant for STIs) [David Heinemeier Hansson]. Example:
1142
1143 render :partial => @client.becomes(Company) # renders companies/company instead of clients/client
1144
1145 * Fixed that to_xml should not automatically pass :procs to associations included with :include #10162 *Cheah Chu Yeow*
1146
1147 * Fix documentation typo introduced in [8250]. Closes #10339 *Henrik N*
1148
1149 * Foxy fixtures: support single-table inheritance. #10234 *tom*
1150
1151 * Foxy fixtures: allow mixed usage to make migration easier and more attractive. #10004 *lotswholetime*
1152
1153 * Make the record_timestamps class-inheritable so it can be set per model. #10004 *tmacedo*
1154
1155 * Allow validates_acceptance_of to use a real attribute instead of only virtual (so you can record that the acceptance occured) #7457 *ambethia*
1156
1157 * DateTimes use Ruby's default calendar reform setting. #10201 *Geoff Buesing*
1158
1159 * Dynamic finders on association collections respect association :order and :limit. #10211, #10227 *Patrick Joyce, Rick Olson, Jack Danger Canty*
1160
1161 * Add 'foxy' support for fixtures of polymorphic associations. #10183 *John Barnette, David Lowenfels*
1162
1163 * validates_inclusion_of and validates_exclusion_of allow formatted :message strings. #8132 *devrieda, Mike Naberezny*
1164
1165 * attr_readonly behaves well with optimistic locking. #10188 *Nick Bugajski*
1166
1167 * Base#to_xml supports the nil="true" attribute like Hash#to_xml. #8268 *Jonathan del Strother*
1168
1169 * Change plings to the more conventional quotes in the documentation. Closes #10104 *Jack Danger Canty*
1170
1171 * Fix HasManyThrough Association so it uses :conditions on the HasMany Association. Closes #9729 *Jack Danger Canty*
1172
1173 * Ensure that column names are quoted. Closes #10134 *wesley.moxam*
1174
1175 * Smattering of grammatical fixes to documentation. Closes #10083 *Bob Silva*
1176
1177 * Enhance explanation with more examples for attr_accessible macro. Closes #8095 *fearoffish, Marcel Molina Jr.*
1178
1179 * Update association/method mapping table to refected latest collection methods for has_many :through. Closes #8772 *Pratik Naik*
1180
1181 * Explain semantics of having several different AR instances in a transaction block. Closes #9036 *jacobat, Marcel Molina Jr.*
1182
1183 * Update Schema documentation to use updated sexy migration notation. Closes #10086 *Sam Granieri*
1184
1185 * Make fixtures work with the new test subclasses. *Tarmo Tänav, Michael Koziarski*
1186
1187 * Introduce finder :joins with associations. Same :include syntax but with inner rather than outer joins. #10012 *RubyRedRick*
1188 # Find users with an avatar
1189 User.find(:all, :joins => :avatar)
1190
1191 # Find posts with a high-rated comment.
1192 Post.find(:all, :joins => :comments, :conditions => 'comments.rating > 3')
1193
1194 * Associations: speedup duplicate record check. #10011 *Pratik Naik*
1195
1196 * Make sure that << works on has_many associations on unsaved records. Closes #9989 *Josh Susser*
1197
1198 * Allow association redefinition in subclasses. #9346 *wildchild*
1199
1200 * Fix has_many :through delete with custom foreign keys. #6466 *naffis*
1201
1202 * Foxy fixtures, from rathole (http://svn.geeksomnia.com/rathole/trunk/README)
1203 - stable, autogenerated IDs
1204 - specify associations (belongs_to, has_one, has_many) by label, not ID
1205 - specify HABTM associations as inline lists
1206 - autofill timestamp columns
1207 - support YAML defaults
1208 - fixture label interpolation
1209 Enabled for fixtures that correspond to a model class and don't specify a primary key value. #9981 *John Barnette*
1210
1211 * Add docs explaining how to protect all attributes using attr_accessible with no arguments. Closes #9631 *boone, rmm5t*
1212
1213 * Update add_index documentation to use new options api. Closes #9787 *Kamal Fariz Mahyuddin*
1214
1215 * Allow find on a has_many association defined with :finder_sql to accept id arguments as strings like regular find does. Closes #9916 *krishna*
1216
1217 * Use VALID_FIND_OPTIONS when resolving :find scoping rather than hard coding the list of valid find options. Closes #9443 *sur*
1218
1219 * Limited eager loading no longer ignores scoped :order. Closes #9561 *Jack Danger Canty, Josh Peek*
1220
1221 * Assigning an instance of a foreign class to a composed_of aggregate calls an optional conversion block. Refactor and simplify composed_of implementation. #6322 *brandon, Chris Cruft*
1222
1223 * Assigning nil to a composed_of aggregate also sets its immediate value to nil. #9843 *Chris Cruft*
1224
1225 * Ensure that mysql quotes table names with database names correctly. Closes #9911 *crayz*
1226
1227 "foo.bar" => "`foo`.`bar`"
1228
1229 * Complete the assimilation of Sexy Migrations from ErrFree *Chris Wanstrath, PJ Hyett*
1230 http://errtheblog.com/post/2381
1231
1232 * Qualified column names work in hash conditions, like :conditions => { 'comments.created_at' => ... }. #9733 *Jack Danger Canty*
1233
1234 * Fix regression where the association would not construct new finder SQL on save causing bogus queries for "WHERE owner_id = NULL" even after owner was saved. #8713 *Bryan Helmkamp*
1235
1236 * Refactor association create and build so before & after callbacks behave consistently. #8854 *Pratik Naik, mortent*
1237
1238 * Quote table names. Defaults to column quoting. #4593 *Justin Lynn, gwcoffey, eadz, Dmitry V. Sabanin, Jeremy Kemper*
1239
1240 * Alias association #build to #new so it behaves predictably. #8787 *Pratik Naik*
1241
1242 * Add notes to documentation regarding attr_readonly behavior with counter caches and polymorphic associations. Closes #9835 *saimonmoore, Rick Olson*
1243
1244 * Observers can observe model names as symbols properly now. Closes #9869 *queso*
1245
1246 * find_and_(initialize|create)_by methods can now properly initialize protected attributes *Tobias Lütke*
1247
1248 * belongs_to infers the foreign key from the association name instead of from the class name. *Jeremy Kemper*
1249
1250 * PostgreSQL: support multiline default values. #7533 *Carl Lerche, aguynamedryan, Rein Henrichs, Tarmo Tänav*
1251
1252 * MySQL: fix change_column on not-null columns that don't accept dfeault values of ''. #6663 *Jonathan Viney, Tarmo Tänav*
1253
1254 * validates_uniqueness_of behaves well with abstract superclasses and
1255 single-table inheritance. #3833, #9886 *Gabriel Gironda, rramdas, François Beausoleil, Josh Peek, Tarmo Tänav, pat*
1256
1257 * Warn about protected attribute assigments in development and test environments when mass-assigning to an attr_protected attribute. #9802 *Henrik N*
1258
1259 * Speedup database date/time parsing. *Jeremy Kemper, Tarmo Tänav*
1260
1261 * Fix calling .clear on a has_many :dependent=>:delete_all association. *Tarmo Tänav*
1262
1263 * Allow change_column to set NOT NULL in the PostgreSQL adapter *Tarmo Tänav*
1264
1265 * Fix that ActiveRecord would create attribute methods and override custom attribute getters if the method is also defined in Kernel.methods. *Rick Olson*
1266
1267 * Don't call attr_readonly on polymorphic belongs_to associations, in case it matches the name of some other non-ActiveRecord class/module. *Rick Olson*
1268
1269 * Try loading activerecord-<adaptername>-adapter gem before trying a plain require so you can use custom gems for the bundled adapters. Also stops gems from requiring an adapter from an old Active Record gem. *Jeremy Kemper, Derrick Spell*
1270
1271
1272 ## 2.0.0 Preview Release (September 29th, 2007) Includes duplicates of changes from 1.14.2 - 1.15.3 ##
1273
1274 * Add attr_readonly to specify columns that are skipped during a normal ActiveRecord #save operation. Closes #6896 *Dan Manges*
1275
1276 class Comment < ActiveRecord::Base
1277 # Automatically sets Article#comments_count as readonly.
1278 belongs_to :article, :counter_cache => :comments_count
1279 end
1280
1281 class Article < ActiveRecord::Base
1282 attr_readonly :approved_comments_count
1283 end
1284
1285 * Make size for has_many :through use counter cache if it exists. Closes #9734 *Xavier Shay*
1286
1287 * Remove DB2 adapter since IBM chooses to maintain their own adapter instead. *Jeremy Kemper*
1288
1289 * Extract Oracle, SQLServer, and Sybase adapters into gems. *Jeremy Kemper*
1290
1291 * Added fixture caching that'll speed up a normal fixture-powered test suite between 50% and 100% #9682 *Frederick Cheung*
1292
1293 * Correctly quote id list for limited eager loading. #7482 *tmacedo*
1294
1295 * Fixed that using version-targetted migrates would fail on loggers other than the default one #7430 *valeksenko*
1296
1297 * Fixed rename_column for SQLite when using symbols for the column names #8616 *drodriguez*
1298
1299 * Added the possibility of using symbols in addition to concrete classes with ActiveRecord::Observer#observe. #3998 *Robby Russell, Tarmo Tänav*
1300
1301 * Added ActiveRecord::Base#to_json/from_json *David Heinemeier Hansson, Cheah Chu Yeow*
1302
1303 * Added ActiveRecord::Base#from_xml [David Heinemeier Hansson]. Example:
1304
1305 xml = "<person><name>David</name></person>"
1306 Person.new.from_xml(xml).name # => "David"
1307
1308 * Define dynamic finders as real methods after first usage. *bscofield*
1309
1310 * Deprecation: remove deprecated threaded_connections methods. Use allow_concurrency instead. *Jeremy Kemper*
1311
1312 * Associations macros accept extension blocks alongside modules. #9346 *Josh Peek*
1313
1314 * Speed up and simplify query caching. *Jeremy Kemper*
1315
1316 * connection.select_rows 'sql' returns an array (rows) of arrays (field values). #2329 *Michael Schuerig*
1317
1318 * Eager loading respects explicit :joins. #9496 *dasil003*
1319
1320 * Extract Firebird, FrontBase, and OpenBase adapters into gems. #9508, #9509, #9510 *Jeremy Kemper*
1321
1322 * RubyGem database adapters: expects a gem named activerecord-<database>-adapter with active_record/connection_adapters/<database>_adapter.rb in its load path. *Jeremy Kemper*
1323
1324 * Fixed that altering join tables in migrations would fail w/ sqlite3 #7453 *TimoMihaljov/brandon*
1325
1326 * Fix association writer with :dependent => :nullify. #7314 *Jonathan Viney*
1327
1328 * OpenBase: update for new lib and latest Rails. Support migrations. #8748 *dcsesq*
1329
1330 * Moved acts_as_tree into a plugin of the same name on the official Rails svn. #9514 *Pratik Naik*
1331
1332 * Moved acts_as_nested_set into a plugin of the same name on the official Rails svn. #9516 *Josh Peek*
1333
1334 * Moved acts_as_list into a plugin of the same name on the official Rails svn. *Josh Peek*
1335
1336 * Explicitly require active_record/query_cache before using it. *Jeremy Kemper*
1337
1338 * Fix bug where unserializing an attribute attempts to modify a frozen @attributes hash for a deleted record. *Rick Olson, marclove*
1339
1340 * Performance: absorb instantiate and initialize_with_callbacks into the Base methods. *Jeremy Kemper*
1341
1342 * Fixed that eager loading queries and with_scope should respect the :group option *David Heinemeier Hansson*
1343
1344 * Improve performance and functionality of the postgresql adapter. Closes #8049 *roderickvd*
1345
1346 For more information see: http://dev.rubyonrails.org/ticket/8049
1347
1348 * Don't clobber includes passed to has_many.count *Jack Danger Canty*
1349
1350 * Make sure has_many uses :include when counting *Jack Danger Canty*
1351
1352 * Change the implementation of ActiveRecord's attribute reader and writer methods *Michael Koziarski*
1353 - Generate Reader and Writer methods which cache attribute values in hashes. This is to avoid repeatedly parsing the same date or integer columns.
1354 - Change exception raised when users use find with :select then try to access a skipped column. Plugins could override missing_attribute() to lazily load the columns.
1355 - Move method definition to the class, instead of the instance
1356 - Always generate the readers, writers and predicate methods.
1357
1358 * Perform a deep #dup on query cache results so that modifying activerecord attributes does not modify the cached attributes. *Rick Olson*
1359
1360 \# Ensure that has_many :through associations use a count query instead of loading the target when #size is called. Closes #8800 *Pratik Naik*
1361
1362 * Added :unless clause to validations #8003 [monki]. Example:
1363
1364 def using_open_id?
1365 !identity_url.blank?
1366 end
1367
1368 validates_presence_of :identity_url, :if => using_open_id?
1369 validates_presence_of :username, :unless => using_open_id?
1370 validates_presence_of :password, :unless => using_open_id?
1371
1372 * Fix #count on a has_many :through association so that it recognizes the :uniq option. Closes #8801 *Pratik Naik*
1373
1374 * Fix and properly document/test count(column_name) usage. Closes #8999 *Pratik Naik*
1375
1376 * Remove deprecated count(conditions=nil, joins=nil) usage. Closes #8993 *Pratik Naik*
1377
1378 * Change belongs_to so that the foreign_key assumption is taken from the association name, not the class name. Closes #8992 *Josh Susser*
1379
1380 OLD
1381 belongs_to :visitor, :class_name => 'User' # => inferred foreign_key is user_id
1382
1383 NEW
1384 belongs_to :visitor, :class_name => 'User' # => inferred foreign_key is visitor_id
1385
1386 * Remove spurious tests from deprecated_associations_test, most of these aren't deprecated, and are duplicated in associations_test. Closes #8987 *Pratik Naik*
1387
1388 * Make create! on a has_many :through association return the association object. Not the collection. Closes #8786 *Pratik Naik*
1389
1390 * Move from select * to select tablename.* to avoid clobbering IDs. Closes #8889 *dasil003*
1391
1392 * Don't call unsupported methods on associated objects when using :include, :method with to_xml #7307, *Manfred Stienstra, jwilger*
1393
1394 * Define collection singular ids method for has_many :through associations. #8763 *Pratik Naik*
1395
1396 * Array attribute conditions work with proxied association collections. #8318 *Kamal Fariz Mahyuddin, theamazingrando*
1397
1398 * Fix polymorphic has_one associations declared in an abstract class. #8638 *Pratik Naik, Dax Huiberts*
1399
1400 * Fixed validates_associated should not stop on the first error. #4276 *mrj, Manfred Stienstra, Josh Peek*
1401
1402 * Rollback if commit raises an exception. #8642 *kik, Jeremy Kemper*
1403
1404 * Update tests' use of fixtures for the new collections api. #8726 *Kamal Fariz Mahyuddin*
1405
1406 * Save associated records only if the association is already loaded. #8713 *Blaine*
1407
1408 * MySQL: fix show_variable. #8448 *matt, Jeremy Kemper*
1409
1410 * Fixtures: correctly delete and insert fixtures in a single transaction. #8553 *Michael Schuerig*
1411
1412 * Fixtures: people(:technomancy, :josh) returns both fixtures. #7880 *technomancy, Josh Peek*
1413
1414 * Calculations support non-numeric foreign keys. #8154 *Kamal Fariz Mahyuddin*
1415
1416 * with_scope is protected. #8524 *Josh Peek*
1417
1418 * Quickref for association methods. #7723 *marclove, Mindsweeper*
1419
1420 * Calculations: return nil average instead of 0 when there are no rows to average. #8298 *davidw*
1421
1422 * acts_as_nested_set: direct_children is sorted correctly. #4761 *Josh Peek, rails@33lc0.net*
1423
1424 * Raise an exception if both attr_protected and attr_accessible are declared. #8507 *stellsmi*
1425
1426 * SQLite, MySQL, PostgreSQL, Oracle: quote column names in column migration SQL statements. #8466 *marclove, lorenjohnson*
1427
1428 * Allow nil serialized attributes with a set class constraint. #7293 *sandofsky*
1429
1430 * Oracle: support binary fixtures. #7987 *Michael Schoen*
1431
1432 * Fixtures: pull fixture insertion into the database adapters. #7987 *Michael Schoen*
1433
1434 * Announce migration versions as they're performed. *Jeremy Kemper*
1435
1436 * find gracefully copes with blank :conditions. #7599 *Dan Manges, johnnyb*
1437
1438 * validates_numericality_of takes :greater_than, :greater_than_or_equal_to, :equal_to, :less_than, :less_than_or_equal_to, :odd, and :even options. #3952 *Bob Silva, Dan Kubb, Josh Peek*
1439
1440 * MySQL: create_database takes :charset and :collation options. Charset defaults to utf8. #8448 *matt*
1441
1442 * Find with a list of ids supports limit/offset. #8437 *hrudududu*
1443
1444 * Optimistic locking: revert the lock version when an update fails. #7840 *plang*
1445
1446 * Migrations: add_column supports custom column types. #7742 *jsgarvin, Theory*
1447
1448 * Load database adapters on demand. Eliminates config.connection_adapters and RAILS_CONNECTION_ADAPTERS. Add your lib directory to the $LOAD_PATH and put your custom adapter in lib/active_record/connection_adapters/adaptername_adapter.rb. This way you can provide custom adapters as plugins or gems without modifying Rails. *Jeremy Kemper*
1449
1450 * Ensure that associations with :dependent => :delete_all respect :conditions option. Closes #8034 *Jack Danger Canty, Josh Peek, Rick Olson*
1451
1452 * belongs_to assignment creates a new proxy rather than modifying its target in-place. #8412 *mmangino@elevatedrails.com*
1453
1454 * Fix column type detection while loading fixtures. Closes #7987 *roderickvd*
1455
1456 * Document deep eager includes. #6267 *Josh Susser, Dan Manges*
1457
1458 * Document warning that associations names shouldn't be reserved words. #4378 *murphy@cYcnus.de, Josh Susser*
1459
1460 * Sanitize Base#inspect. #8392, #8623 *Nik Wakelin, jnoon*
1461
1462 * Replace the transaction {|transaction|..} semantics with a new Exception ActiveRecord::Rollback. *Michael Koziarski*
1463
1464 * Oracle: extract column length for CHAR also. #7866 *ymendel*
1465
1466 * Document :allow_nil option for validates_acceptance_of since it defaults to true. *tzaharia*
1467
1468 * Update documentation for :dependent declaration so that it explicitly uses the non-deprecated API. *Jack Danger Canty*
1469
1470 * Add documentation caveat about when to use count_by_sql. *fearoffish*
1471
1472 * Enhance documentation for increment_counter and decrement_counter. *fearoffish*
1473
1474 * Provide brief introduction to what optimistic locking is. *fearoffish*
1475
1476 * Add documentation for :encoding option to mysql adapter. *marclove*
1477
1478 * Added short-hand declaration style to migrations (inspiration from Sexy Migrations, http://errtheblog.com/post/2381) [David Heinemeier Hansson]. Example:
1479
1480 create_table "products" do |t|
1481 t.column "shop_id", :integer
1482 t.column "creator_id", :integer
1483 t.column "name", :string, :default => "Untitled"
1484 t.column "value", :string, :default => "Untitled"
1485 t.column "created_at", :datetime
1486 t.column "updated_at", :datetime
1487 end
1488
1489 ...can now be written as:
1490
1491 create_table :products do |t|
1492 t.integer :shop_id, :creator_id
1493 t.string :name, :value, :default => "Untitled"
1494 t.timestamps
1495 end
1496
1497 * Use association name for the wrapper element when using .to_xml. Previous behavior lead to non-deterministic situations with STI and polymorphic associations. *Michael Koziarski, jstrachan*
1498
1499 * Improve performance of calling .create on has_many :through associations. *evan*
1500
1501 * Improved cloning performance by relying less on exception raising #8159 *Blaine*
1502
1503 * Added ActiveRecord::Base.inspect to return a column-view like #<Post id:integer, title:string, body:text> *David Heinemeier Hansson*
1504
1505 * Added yielding of Builder instance for ActiveRecord::Base#to_xml calls *David Heinemeier Hansson*
1506
1507 * Small additions and fixes for ActiveRecord documentation. Closes #7342 *Jeremy McAnally*
1508
1509 * Add helpful debugging info to the ActiveRecord::StatementInvalid exception in ActiveRecord::ConnectionAdapters::SqliteAdapter#table_structure. Closes #7925. *court3nay*
1510
1511 * SQLite: binary escaping works with $KCODE='u'. #7862 *tsuka*
1512
1513 * Base#to_xml supports serialized attributes. #7502 *jonathan*
1514
1515 * Base.update_all :order and :limit options. Useful for MySQL updates that must be ordered to avoid violating unique constraints. *Jeremy Kemper*
1516
1517 * Remove deprecated object transactions. People relying on this functionality should install the object_transactions plugin at http://code.bitsweat.net/svn/object_transactions. Closes #5637 *Michael Koziarski, Jeremy Kemper*
1518
1519 * PostgreSQL: remove DateTime -> Time downcast. Warning: do not enable translate_results for the C bindings if you have timestamps outside Time's domain. *Jeremy Kemper*
1520
1521 * find_or_create_by_* takes a hash so you can create with more attributes than are in the method name. For example, Person.find_or_create_by_name(:name => 'Henry', :comments => 'Hi new user!') is equivalent to Person.find_by_name('Henry') || Person.create(:name => 'Henry', :comments => 'Hi new user!'). #7368 *Josh Susser*
1522
1523 * Make sure with_scope takes both :select and :joins into account when setting :readonly. Allows you to save records you retrieve using method_missing on a has_many :through associations. *Michael Koziarski*
1524
1525 * Allow a polymorphic :source for has_many :through associations. Closes #7143 *protocool*
1526
1527 * Consistent public/protected/private visibility for chained methods. #7813 *Dan Manges*
1528
1529 * Oracle: fix quoted primary keys and datetime overflow. #7798 *Michael Schoen*
1530
1531 * Consistently quote primary key column names. #7763 *toolmantim*
1532
1533 * Fixtures: fix YAML ordered map support. #2665 *Manuel Holtgrewe, nfbuckley*
1534
1535 * DateTimes assume the default timezone. #7764 *Geoff Buesing*
1536
1537 * Sybase: hide timestamp columns since they're inherently read-only. #7716 *Mike Joyce*
1538
1539 * Oracle: overflow Time to DateTime. #7718 *Michael Schoen*
1540
1541 * PostgreSQL: don't use async_exec and async_query with postgres-pr. #7727, #7762 *flowdelic, toolmantim*
1542
1543 * Fix has_many :through << with custom foreign keys. #6466, #7153 *naffis, Rich Collins*
1544
1545 * Test DateTime native type in migrations, including an edge case with dates
1546 during calendar reform. #7649, #7724 *fedot, Geoff Buesing*
1547
1548 * SQLServer: correctly schema-dump tables with no indexes or descending indexes. #7333, #7703 *Jakob Skjerning, Tom Ward*
1549
1550 * SQLServer: recognize real column type as Ruby float. #7057 *sethladd, Tom Ward*
1551
1552 * Added fixtures :all as a way of loading all fixtures in the fixture directory at once #7214 *Manfred Stienstra*
1553
1554 * Added database connection as a yield parameter to ActiveRecord::Base.transaction so you can manually rollback [David Heinemeier Hansson]. Example:
1555
1556 transaction do |transaction|
1557 david.withdrawal(100)
1558 mary.deposit(100)
1559 transaction.rollback! # rolls back the transaction that was otherwise going to be successful
1560 end
1561
1562 * Made increment_counter/decrement_counter play nicely with optimistic locking, and added a more general update_counters method *Jamis Buck*
1563
1564 * Reworked David's query cache to be available as Model.cache {...}. For the duration of the block no select query should be run more then once. Any inserts/deletes/executes will flush the whole cache however *Tobias Lütke*
1565 Task.cache { Task.find(1); Task.find(1) } # => 1 query
1566
1567 * When dealing with SQLite3, use the table_info pragma helper, so that the bindings can do some translation for when sqlite3 breaks incompatibly between point releases. *Jamis Buck*
1568
1569 * Oracle: fix lob and text default handling. #7344 *gfriedrich, Michael Schoen*
1570
1571 * SQLServer: don't choke on strings containing 'null'. #7083 *Jakob Skjerning*
1572
1573 * MySQL: blob and text columns may not have defaults in 5.x. Update fixtures schema for strict mode. #6695 *Dan Kubb*
1574
1575 * update_all can take a Hash argument. sanitize_sql splits into two methods for conditions and assignment since NULL values and delimiters are handled differently. #6583, #7365 *sandofsky, Assaf*
1576
1577 * MySQL: SET SQL_AUTO_IS_NULL=0 so 'where id is null' doesn't select the last inserted id. #6778 *Jonathan Viney, timc*
1578
1579 * Use Date#to_s(:db) for quoted dates. #7411 *Michael Schoen*
1580
1581 * Don't create instance writer methods for class attributes. Closes #7401 *Rick Olson*
1582
1583 * Docs: validations examples. #7343 *zackchandler*
1584
1585 * Add missing tests ensuring callbacks work with class inheritance. Closes #7339 *sandofsky*
1586
1587 * Fixtures use the table name and connection from set_fixture_class. #7330 *Anthony Eden*
1588
1589 * Remove useless code in #attribute_present? since 0 != blank?. Closes #7249 *Josh Susser*
1590
1591 * Fix minor doc typos. Closes #7157 *Josh Susser*
1592
1593 * Fix incorrect usage of #classify when creating the eager loading join statement. Closes #7044 *Josh Susser*
1594
1595 * SQLServer: quote table name in indexes query. #2928 *keithm@infused.org*
1596
1597 * Subclasses of an abstract class work with single-table inheritance. #5704, #7284 *BertG, nick+rails@ag.arizona.edu*
1598
1599 * Make sure sqlite3 driver closes open connections on disconnect *Rob Rasmussen*
1600
1601 * [DOC] clear up some ambiguity with the way has_and_belongs_to_many creates the default join table name. #7072 *Jeremy McAnally*
1602
1603 * change_column accepts :default => nil. Skip column options for primary keys. #6956, #7048 *Dan Manges, Jeremy Kemper*
1604
1605 * MySQL, PostgreSQL: change_column_default quotes the default value and doesn't lose column type information. #3987, #6664 *Jonathan Viney, Manfred Stienstra, altano@bigfoot.com*
1606
1607 * Oracle: create_table takes a :sequence_name option to override the 'tablename_seq' default. #7000 *Michael Schoen*
1608
1609 * MySQL: retain SSL settings on reconnect. #6976 *randyv2*
1610
1611 * Apply scoping during initialize instead of create. Fixes setting of foreign key when using find_or_initialize_by with scoping. *Cody Fauser*
1612
1613 * SQLServer: handle [quoted] table names. #6635 *rrich*
1614
1615 * acts_as_nested_set works with single-table inheritance. #6030 *Josh Susser*
1616
1617 * PostgreSQL, Oracle: correctly perform eager finds with :limit and :order. #4668, #7021 *eventualbuddha, Michael Schoen*
1618
1619 * Pass a range in :conditions to use the SQL BETWEEN operator. #6974 *Dan Manges*
1620 Student.find(:all, :conditions => { :grade => 9..12 })
1621
1622 * Fix the Oracle adapter for serialized attributes stored in CLOBs. Closes #6825 *mschoen, tdfowler*
1623
1624 * [DOCS] Apply more documentation for ActiveRecord Reflection. Closes #4055 *Robby Russell*
1625
1626 * [DOCS] Document :allow_nil option of #validate_uniqueness_of. Closes #3143 *Caio Chassot*
1627
1628 * Bring the sybase adapter up to scratch for 1.2 release. *jsheets*
1629
1630 * Rollback new_record? and id when an exception is raised in a save callback. #6910 *Ben Curren, outerim*
1631
1632 * Pushing a record on an association collection doesn't unnecessarily load all the associated records. *Obie Fernandez, Jeremy Kemper*
1633
1634 * Oracle: fix connection reset failure. #6846 *leonlleslie*
1635
1636 * Subclass instantiation doesn't try to explicitly require the corresponding subclass. #6840 *leei, Jeremy Kemper*
1637
1638 * fix faulty inheritance tests and that eager loading grabs the wrong inheritance column when the class of your association is an STI subclass. Closes #6859 *protocool*
1639
1640 * Consolidated different create and create! versions to call through to the base class with scope. This fixes inconsistencies, especially related to protected attribtues. Closes #5847 *Alexander Dymo, Tobias Lütke*
1641
1642 * find supports :lock with :include. Check whether your database allows SELECT ... FOR UPDATE with outer joins before using. #6764 *vitaly, Jeremy Kemper*
1643
1644 * Add AssociationCollection#create! to be consistent with AssociationCollection#create when dealing with a foreign key that is a protected attribute *Cody Fauser*
1645
1646 * Added counter optimization for AssociationCollection#any? so person.friends.any? won't actually load the full association if we have the count in a cheaper form *David Heinemeier Hansson*
1647
1648 * Change fixture_path to a class inheritable accessor allowing test cases to have their own custom set of fixtures. #6672 *Zach Dennis*
1649
1650 * Quote ActiveSupport::Multibyte::Chars. #6653 *Julian Tarkhanov*
1651
1652 * Simplify query_attribute by typecasting the attribute value and checking whether it's nil, false, zero or blank. #6659 *Jonathan Viney*
1653
1654 * validates_numericality_of uses \A \Z to ensure the entire string matches rather than ^ $ which may match one valid line of a multiline string. #5716 *Andreas Schwarz*
1655
1656 * Run validations in the order they were declared. #6657 *obrie*
1657
1658 * MySQL: detect when a NOT NULL column without a default value is misreported as default ''. Can't detect for string, text, and binary columns since '' is a legitimate default. #6156 *simon@redhillconsulting.com.au, obrie, Jonathan Viney, Jeremy Kemper*
1659
1660 * Simplify association proxy implementation by factoring construct_scope out of method_missing. #6643 *martin*
1661
1662 * Oracle: automatically detect the primary key. #6594 *vesaria, Michael Schoen*
1663
1664 * Oracle: to increase performance, prefetch 100 rows and enable similar cursor sharing. Both are configurable in database.yml. #6607 *philbogle@gmail.com, ray.fortna@jobster.com, Michael Schoen*
1665
1666 * Don't inspect unloaded associations. #2905 *lmarlow*
1667
1668 * SQLite: use AUTOINCREMENT primary key in >= 3.1.0. #6588, #6616 *careo, lukfugl*
1669
1670 * Cache inheritance_column. #6592 *Stefan Kaes*
1671
1672 * Firebird: decimal/numeric support. #6408 *macrnic*
1673
1674 * make add_order a tad faster. #6567 *Stefan Kaes*
1675
1676 * Find with :include respects scoped :order. #5850
1677
1678 * Support nil and Array in :conditions => { attr => value } hashes. #6548 *Assaf, Jeremy Kemper*
1679 find(:all, :conditions => { :topic_id => [1, 2, 3], :last_read => nil }
1680
1681 * Consistently use LOWER() for uniqueness validations (rather than mixing with UPPER()) so the database can always use a functional index on the lowercased column. #6495 *Si*
1682
1683 * SQLite: fix calculations workaround, remove count(distinct) query rewrite, cleanup test connection scripts. *Jeremy Kemper*
1684
1685 * SQLite: count(distinct) queries supported in >= 3.2.6. #6544 *Bob Silva*
1686
1687 * Dynamically generate reader methods for serialized attributes. #6362 *Stefan Kaes*
1688
1689 * Deprecation: object transactions warning. *Jeremy Kemper*
1690
1691 * has_one :dependent => :nullify ignores nil associates. #4848, #6528 *bellis@deepthought.org, janovetz, Jeremy Kemper*
1692
1693 * Oracle: resolve test failures, use prefetched primary key for inserts, check for null defaults, fix limited id selection for eager loading. Factor out some common methods from all adapters. #6515 *Michael Schoen*
1694
1695 * Make add_column use the options hash with the Sqlite Adapter. Closes #6464 *obrie*
1696
1697 * Document other options available to migration's add_column. #6419 *grg*
1698
1699 * MySQL: all_hashes compatibility with old MysqlRes class. #6429, #6601 *Jeremy Kemper*
1700
1701 * Fix has_many :through to add the appropriate conditions when going through an association using STI. Closes #5783. *Jonathan Viney*
1702
1703 * fix select_limited_ids_list issues in postgresql, retain current behavior in other adapters *Rick Olson*
1704
1705 * Restore eager condition interpolation, document it's differences *Rick Olson*
1706
1707 * Don't rollback in teardown unless a transaction was started. Don't start a transaction in create_fixtures if a transaction is started. #6282 *Jacob Fugal, Jeremy Kemper*
1708
1709 * Add #delete support to has_many :through associations. Closes #6049 *Martin Landers*
1710
1711 * Reverted old select_limited_ids_list postgresql fix that caused issues in mysql. Closes #5851 *Rick Olson*
1712
1713 * Removes the ability for eager loaded conditions to be interpolated, since there is no model instance to use as a context for interpolation. #5553 *turnip@turnipspatch.com*
1714
1715 * Added timeout option to SQLite3 configurations to deal more gracefully with SQLite3::BusyException, now the connection can instead retry for x seconds to see if the db clears up before throwing that exception #6126 *wreese@gmail.com*
1716
1717 * Added update_attributes! which uses save! to raise an exception if a validation error prevents saving #6192 *jonathan*
1718
1719 * Deprecated add_on_boundary_breaking (use validates_length_of instead) #6292 *Bob Silva*
1720
1721 * The has_many create method works with polymorphic associations. #6361 *Dan Peterson*
1722
1723 * MySQL: introduce Mysql::Result#all_hashes to support further optimization. #5581 *Stefan Kaes*
1724
1725 * save! shouldn't validate twice. #6324 *maiha, Bob Silva*
1726
1727 * Association collections have an _ids reader method to match the existing writer for collection_select convenience (e.g. employee.task_ids). The writer method skips blank ids so you can safely do @employee.task_ids = params[:tasks] without checking every time for an empty list or blank values. #1887, #5780 *Michael Schuerig*
1728
1729 * Add an attribute reader method for ActiveRecord::Base.observers *Rick Olson*
1730
1731 * Deprecation: count class method should be called with an options hash rather than two args for conditions and joins. #6287 *Bob Silva*
1732
1733 * has_one associations with a nil target may be safely marshaled. #6279 *norbauer, Jeremy Kemper*
1734
1735 * Duplicate the hash provided to AR::Base#to_xml to prevent unexpected side effects *Michael Koziarski*
1736
1737 * Add a :namespace option to AR::Base#to_xml *Michael Koziarski*
1738
1739 * Deprecation tests. Remove warnings for dynamic finders and for the foo_count method if it's also an attribute. *Jeremy Kemper*
1740
1741 * Mock Time.now for more accurate Touch mixin tests. #6213 *Dan Peterson*
1742
1743 * Improve yaml fixtures error reporting. #6205 *Bruce Williams*
1744
1745 * Rename AR::Base#quote so people can use that name in their models. #3628 *Michael Koziarski*
1746
1747 * Add deprecation warning for inferred foreign key. #6029 *Josh Susser*
1748
1749 * Fixed the Ruby/MySQL adapter we ship with Active Record to work with the new authentication handshake that was introduced in MySQL 4.1, along with the other protocol changes made at that time #5723 *jimw@mysql.com*
1750
1751 * Deprecation: use :dependent => :delete_all rather than :exclusively_dependent => true. #6024 *Josh Susser*
1752
1753 * Document validates_presences_of behavior with booleans: you probably want validates_inclusion_of :attr, :in => [true, false]. #2253 *Bob Silva*
1754
1755 * Optimistic locking: gracefully handle nil versions, treat as zero. #5908 *Tom Ward*
1756
1757 * to_xml: the :methods option works on arrays of records. #5845 *Josh Starcher*
1758
1759 * Deprecation: update docs. #5998 *Jakob Skjerning, Kevin Clark*
1760
1761 * Add some XmlSerialization tests for ActiveRecord *Rick Olson*
1762
1763 * has_many :through conditions are sanitized by the associating class. #5971 *martin.emde@gmail.com*
1764
1765 * Tighten rescue clauses. #5985 *james@grayproductions.net*
1766
1767 * Fix spurious newlines and spaces in AR::Base#to_xml output *Jamis Buck*
1768
1769 * has_one supports the :dependent => :delete option which skips the typical callback chain and deletes the associated object directly from the database. #5927 *Chris Mear, Jonathan Viney*
1770
1771 * Nested subclasses are not prefixed with the parent class' table_name since they should always use the base class' table_name. #5911 *Jonathan Viney*
1772
1773 * SQLServer: work around bug where some unambiguous date formats are not correctly identified if the session language is set to german. #5894 *Tom Ward, kruth@bfpi*
1774
1775 * SQLServer: fix eager association test. #5901 *Tom Ward*
1776
1777 * Clashing type columns due to a sloppy join shouldn't wreck single-table inheritance. #5838 *Kevin Clark*
1778
1779 * Fixtures: correct escaping of \n and \r. #5859 *evgeny.zislis@gmail.com*
1780
1781 * Migrations: gracefully handle missing migration files. #5857 *eli.gordon@gmail.com*
1782
1783 * MySQL: update test schema for MySQL 5 strict mode. #5861 *Tom Ward*
1784
1785 * to_xml: correct naming of included associations. #5831 *Josh Starcher*
1786
1787 * Pushing a record onto a has_many :through sets the association's foreign key to the associate's primary key and adds it to the correct association. #5815, #5829 *Josh Susser*
1788
1789 * Add records to has_many :through using <<, push, and concat by creating the association record. Raise if base or associate are new records since both ids are required to create the association. #build raises since you can't associate an unsaved record. #create! takes an attributes hash and creates the associated record and its association in a transaction. *Jeremy Kemper*
1790
1791 # Create a tagging to associate the post and tag.
1792 post.tags << Tag.find_by_name('old')
1793 post.tags.create! :name => 'general'
1794
1795 # Would have been:
1796 post.taggings.create!(:tag => Tag.find_by_name('finally')
1797 transaction do
1798 post.taggings.create!(:tag => Tag.create!(:name => 'general'))
1799 end
1800
1801 * Cache nil results for :included has_one associations also. #5787 *Michael Schoen*
1802
1803 * Fixed a bug which would cause .save to fail after trying to access a empty has_one association on a unsaved record. *Tobias Lütke*
1804
1805 * Nested classes are given table names prefixed by the singular form of the parent's table name. *Jeremy Kemper*
1806 Example: Invoice::Lineitem is given table name invoice_lineitems
1807
1808 * Migrations: uniquely name multicolumn indexes so you don't have to. *Jeremy Kemper*
1809 # people_active_last_name_index, people_active_deactivated_at_index
1810 add_index :people, [:active, :last_name]
1811 add_index :people, [:active, :deactivated_at]
1812 remove_index :people, [:active, :last_name]
1813 remove_index :people, [:active, :deactivated_at]
1814
1815 WARNING: backward-incompatibility. Multicolumn indexes created before this
1816 revision were named using the first column name only. Now they're uniquely
1817 named using all indexed columns.
1818
1819 To remove an old multicolumn index, remove_index :table_name, :first_column
1820
1821 * Fix for deep includes on the same association. *richcollins@gmail.com*
1822
1823 * Tweak fixtures so they don't try to use a non-ActiveRecord class. *Kevin Clark*
1824
1825 * Remove ActiveRecord::Base.reset since Dispatcher doesn't use it anymore. *Rick Olson*
1826
1827 * Document find's :from option. Closes #5762. *andrew@redlinesoftware.com*
1828
1829 * PostgreSQL: autodetected sequences work correctly with multiple schemas. Rely on the schema search_path instead of explicitly qualifying the sequence name with its schema. #5280 *guy.naor@famundo.com*
1830
1831 * Replace Reloadable with Reloadable::Deprecated. *Nicholas Seckar*
1832
1833 * Cache nil results for has_one associations so multiple calls don't call the database. Closes #5757. *Michael Schoen*
1834
1835 * Add documentation for how to disable timestamps on a per model basis. Closes #5684. *matt@mattmargolis.net Marcel Molina Jr.*
1836
1837 * Don't save has_one associations unnecessarily. #5735 *Jonathan Viney*
1838
1839 * Refactor ActiveRecord::Base.reset_subclasses to #reset, and add global observer resetting. *Rick Olson*
1840
1841 * Formally deprecate the deprecated finders. *Michael Koziarski*
1842
1843 * Formally deprecate rich associations. *Michael Koziarski*
1844
1845 * Fixed that default timezones for new / initialize should uphold utc setting #5709 *daniluk@yahoo.com*
1846
1847 * Fix announcement of very long migration names. #5722 *blake@near-time.com*
1848
1849 * The exists? class method should treat a string argument as an id rather than as conditions. #5698 *jeremy@planetargon.com*
1850
1851 * Fixed to_xml with :include misbehaviors when invoked on array of model instances #5690 *alexkwolfe@gmail.com*
1852
1853 * Added support for conditions on Base.exists? #5689 [Josh Peek]. Examples:
1854
1855 assert (Topic.exists?(:author_name => "David"))
1856 assert (Topic.exists?(:author_name => "Mary", :approved => true))
1857 assert (Topic.exists?(["parent_id = ?", 1]))
1858
1859 * Schema dumper quotes date :default values. *Dave Thomas*
1860
1861 * Calculate sum with SQL, not Enumerable on HasManyThrough Associations. *Dan Peterson*
1862
1863 * Factor the attribute#{suffix} methods out of method_missing for easier extension. *Jeremy Kemper*
1864
1865 * Patch sql injection vulnerability when using integer or float columns. *Jamis Buck*
1866
1867 * Allow #count through a has_many association to accept :include. *Dan Peterson*
1868
1869 * create_table rdoc: suggest :id => false for habtm join tables. *Zed Shaw*
1870
1871 * PostgreSQL: return array fields as strings. #4664 *Robby Russell*
1872
1873 * SQLServer: added tests to ensure all database statements are closed, refactored identity_insert management code to use blocks, removed update/delete rowcount code out of execute and into update/delete, changed insert to go through execute method, removed unused quoting methods, disabled pessimistic locking tests as feature is currently unsupported, fixed RakeFile to load sqlserver specific tests whether running in ado or odbc mode, fixed support for recently added decimal types, added support for limits on integer types. #5670 *Tom Ward*
1874
1875 * SQLServer: fix db:schema:dump case-sensitivity. #4684 *Will Rogers*
1876
1877 * Oracle: BigDecimal support. #5667 *Michael Schoen*
1878
1879 * Numeric and decimal columns map to BigDecimal instead of Float. Those with scale 0 map to Integer. #5454 *robbat2@gentoo.org, work@ashleymoran.me.uk*
1880
1881 * Firebird migrations support. #5337 *Ken Kunz <kennethkunz@gmail.com>*
1882
1883 * PostgreSQL: create/drop as postgres user. #4790 *mail@matthewpainter.co.uk, mlaster@metavillage.com*
1884
1885 * Update callbacks documentation. #3970 *Robby Russell <robby@planetargon.com>*
1886
1887 * PostgreSQL: correctly quote the ' in pk_and_sequence_for. #5462 *tietew@tietew.net*
1888
1889 * PostgreSQL: correctly quote microseconds in timestamps. #5641 *rick@rickbradley.com*
1890
1891 * Clearer has_one/belongs_to model names (account has_one :user). #5632 *matt@mattmargolis.net*
1892
1893 * Oracle: use nonblocking queries if allow_concurrency is set, fix pessimistic locking, don't guess date vs. time by default (set OracleAdapter.emulate_dates = true for the old behavior), adapter cleanup. #5635 *Michael Schoen*
1894
1895 * Fixed a few Oracle issues: Allows Oracle's odd date handling to still work consistently within #to_xml, Passes test that hardcode insert statement by dropping the :id column, Updated RUNNING_UNIT_TESTS with Oracle instructions, Corrects method signature for #exec #5294 *Michael Schoen*
1896
1897 * Added :group to available options for finds done on associations #5516 *mike@michaeldewey.org*
1898
1899 * Minor tweak to improve performance of ActiveRecord::Base#to_param.
1900
1901 * Observers also watch subclasses created after they are declared. #5535 *daniels@pronto.com.au*
1902
1903 * Removed deprecated timestamps_gmt class methods. *Jeremy Kemper*
1904
1905 * rake build_mysql_database grants permissions to rails@localhost. #5501 *brianegge@yahoo.com*
1906
1907 * PostgreSQL: support microsecond time resolution. #5492 *alex@msgpad.com*
1908
1909 * Add AssociationCollection#sum since the method_missing invokation has been shadowed by Enumerable#sum.
1910
1911 * Added find_or_initialize_by_X which works like find_or_create_by_X but doesn't save the newly instantiated record. *Sam Stephenson*
1912
1913 * Row locking. Provide a locking clause with the :lock finder option or true for the default "FOR UPDATE". Use the #lock! method to obtain a row lock on a single record (reloads the record with :lock => true). *Shugo Maeda*
1914 # Obtain an exclusive lock on person 1 so we can safely increment visits.
1915 Person.transaction do
1916 # select * from people where id=1 for update
1917 person = Person.find(1, :lock => true)
1918 person.visits += 1
1919 person.save!
1920 end
1921
1922 * PostgreSQL: introduce allow_concurrency option which determines whether to use blocking or asynchronous #execute. Adapters with blocking #execute will deadlock Ruby threads. The default value is ActiveRecord::Base.allow_concurrency. *Jeremy Kemper*
1923
1924 * Use a per-thread (rather than global) transaction mutex so you may execute concurrent transactions on separate connections. *Jeremy Kemper*
1925
1926 * Change AR::Base#to_param to return a String instead of a Fixnum. Closes #5320. *Nicholas Seckar*
1927
1928 * Use explicit delegation instead of method aliasing for AR::Base.to_param -> AR::Base.id. #5299 (skaes@web.de)
1929
1930 * Refactored ActiveRecord::Base.to_xml to become a delegate for XmlSerializer, which restores sanity to the mega method. This refactoring also reinstates the opinions that type="string" is redundant and ugly and nil-differentiation is not a concern of serialization *David Heinemeier Hansson*
1931
1932 * Added simple hash conditions to find that'll just convert hash to an AND-based condition string #5143 [Hampton Catlin]. Example:
1933
1934 Person.find(:all, :conditions => { :last_name => "Catlin", :status => 1 }, :limit => 2)
1935
1936 ...is the same as:
1937
1938 Person.find(:all, :conditions => [ "last_name = ? and status = ?", "Catlin", 1 ], :limit => 2)
1939
1940 This makes it easier to pass in the options from a form or otherwise outside.
1941
1942
1943 * Fixed issues with BLOB limits, charsets, and booleans for Firebird #5194, #5191, #5189 *kennethkunz@gmail.com*
1944
1945 * Fixed usage of :limit and with_scope when the association in scope is a 1:m #5208 *alex@purefiction.net*
1946
1947 * Fixed migration trouble with SQLite when NOT NULL is used in the new definition #5215 *greg@lapcominc.com*
1948
1949 * Fixed problems with eager loading and counting on SQL Server #5212 *kajism@yahoo.com*
1950
1951 * Fixed that count distinct should use the selected column even when using :include #5251 *anna@wota.jp*
1952
1953 * Fixed that :includes merged from with_scope won't cause the same association to be loaded more than once if repetition occurs in the clauses #5253 *alex@purefiction.net*
1954
1955 * Allow models to override to_xml. #4989 *Blair Zajac <blair@orcaware.com>*
1956
1957 * PostgreSQL: don't ignore port when host is nil since it's often used to label the domain socket. #5247 *shimbo@is.naist.jp*
1958
1959 * Records and arrays of records are bound as quoted ids. *Jeremy Kemper*
1960 Foo.find(:all, :conditions => ['bar_id IN (?)', bars])
1961 Foo.find(:first, :conditions => ['bar_id = ?', bar])
1962
1963 * Fixed that Base.find :all, :conditions => [ "id IN (?)", collection ] would fail if collection was empty *David Heinemeier Hansson*
1964
1965 * Add a list of regexes assert_queries skips in the ActiveRecord test suite. *Rick Olson*
1966
1967 * Fix the has_and_belongs_to_many #create doesn't populate the join for new records. Closes #3692 *Josh Susser*
1968
1969 * Provide Association Extensions access to the instance that the association is being accessed from.
1970 Closes #4433 *Josh Susser*
1971
1972 * Update OpenBase adaterp's maintainer's email address. Closes #5176. *Derrick Spell*
1973
1974 * Add a quick note about :select and eagerly included associations. *Rick Olson*
1975
1976 * Add docs for the :as option in has_one associations. Closes #5144 *cdcarter@gmail.com*
1977
1978 * Fixed that has_many collections shouldn't load the entire association to do build or create *David Heinemeier Hansson*
1979
1980 * Added :allow_nil option for aggregations #5091 *Ian White*
1981
1982 * Fix Oracle boolean support and tests. Closes #5139. *Michael Schoen*
1983
1984 * create! no longer blows up when no attributes are passed and a :create scope is in effect (e.g. foo.bars.create! failed whereas foo.bars.create!({}) didn't.) *Jeremy Kemper*
1985
1986 * Call Inflector#demodulize on the class name when eagerly including an STI model. Closes #5077 *info@loobmedia.com*
1987
1988 * Preserve MySQL boolean column defaults when changing a column in a migration. Closes #5015. *pdcawley@bofh.org.uk*
1989
1990 * PostgreSQL: migrations support :limit with :integer columns by mapping limit < 4 to smallint, > 4 to bigint, and anything else to integer. #2900 *keegan@thebasement.org*
1991
1992 * Dates and times interpret empty strings as nil rather than 2000-01-01. #4830 *kajism@yahoo.com*
1993
1994 * Allow :uniq => true with has_many :through associations. *Jeremy Kemper*
1995
1996 * Ensure that StringIO is always available for the Schema dumper. *Marcel Molina Jr.*
1997
1998 * Allow AR::Base#to_xml to include methods too. Closes #4921. *johan@textdrive.com*
1999
2000 * Replace superfluous name_to_class_name variant with camelize. *Marcel Molina Jr.*
2001
2002 * Replace alias method chaining with Module#alias_method_chain. *Marcel Molina Jr.*
2003
2004 * Replace Ruby's deprecated append_features in favor of included. *Marcel Molina Jr.*
2005
2006 * Remove duplicate fixture entry in comments.yml. Closes #4923. *Blair Zajac <blair@orcaware.com>*
2007
2008 * Update FrontBase adapter to check binding version. Closes #4920. *mlaster@metavillage.com*
2009
2010 * New Frontbase connections don't start in auto-commit mode. Closes #4922. *mlaster@metavillage.com*
2011
2012 * When grouping, use the appropriate option key. *Marcel Molina Jr.*
2013
2014 * Only modify the sequence name in the FrontBase adapter if the FrontBase adapter is actually being used. *Marcel Molina Jr.*
2015
2016 * Add support for FrontBase (http://www.frontbase.com/) with a new adapter thanks to the hard work of one Mike Laster. Closes #4093. *mlaster@metavillage.com*
2017
2018 * Add warning about the proper way to validate the presence of a foreign key. Closes #4147. *Francois Beausoleil <francois.beausoleil@gmail.com>*
2019
2020 * Fix syntax error in documentation. Closes #4679. *Mislav Marohnić*
2021
2022 * Add Oracle support for CLOB inserts. Closes #4748. *schoenm@earthlink.net sandra.metz@duke.edu*
2023
2024 * Various fixes for sqlserver_adapter (odbc statement finishing, ado schema dumper, drop index). Closes #4831. *kajism@yahoo.com*
2025
2026 * Add support for :order option to with_scope. Closes #3887. *eric.daspet@survol.net*
2027
2028 * Prettify output of schema_dumper by making things line up. Closes #4241 *Caio Chassot <caio@v2studio.com>*
2029
2030 * Make build_postgresql_databases task make databases owned by the postgres user. Closes #4790. *mlaster@metavillage.com*
2031
2032 * Sybase Adapter type conversion cleanup. Closes #4736. *dev@metacasa.net*
2033
2034 * Fix bug where calculations with long alias names return null. *Rick Olson*
2035
2036 * Raise error when trying to add to a has_many :through association. Use the Join Model instead. *Rick Olson*
2037
2038 @post.tags << @tag # BAD
2039 @post.taggings.create(:tag => @tag) # GOOD
2040
2041 * Allow all calculations to take the :include option, not just COUNT (closes #4840) *Rick Olson*
2042
2043 * Update inconsistent migrations documentation. #4683 *machomagna@gmail.com*
2044
2045 * Add ActiveRecord::Errors#to_xml *Jamis Buck*
2046
2047 * Properly quote index names in migrations (closes #4764) *John Long*
2048
2049 * Fix the HasManyAssociation#count method so it uses the new ActiveRecord::Base#count syntax, while maintaining backwards compatibility. *Rick Olson*
2050
2051 * Ensure that Associations#include_eager_conditions? checks both scoped and explicit conditions *Rick Olson*
2052
2053 * Associations#select_limited_ids_list adds the ORDER BY columns to the SELECT DISTINCT List for postgresql. *Rick Olson*
2054
2055 * DRY up association collection reader method generation. *Marcel Molina Jr.*
2056
2057 * DRY up and tweak style of the validation error object. *Marcel Molina Jr.*
2058
2059 * Add :case_sensitive option to validates_uniqueness_of (closes #3090) *Rick Olson*
2060
2061 class Account < ActiveRecord::Base
2062 validates_uniqueness_of :email, :case_sensitive => false
2063 end
2064
2065 * Allow multiple association extensions with :extend option (closes #4666) *Josh Susser*
2066
2067 class Account < ActiveRecord::Base
2068 has_many :people, :extend => [FindOrCreateByNameExtension, FindRecentExtension]
2069 end
2070
2071 *1.15.3* (March 12th, 2007)
2072
2073 * Allow a polymorphic :source for has_many :through associations. Closes #7143 [protocool]
2074
2075 * Consistently quote primary key column names. #7763 [toolmantim]
2076
2077 * Fixtures: fix YAML ordered map support. #2665 [Manuel Holtgrewe, nfbuckley]
2078
2079 * Fix has_many :through << with custom foreign keys. #6466, #7153 [naffis, Rich Collins]
2080
2081
2082 ## 1.15.2 (February 5th, 2007) ##
2083
2084 * Pass a range in :conditions to use the SQL BETWEEN operator. #6974 *Dan Manges*
2085 Student.find(:all, :conditions => { :grade => 9..12 })
2086
2087 * Don't create instance writer methods for class attributes. *Rick Olson*
2088
2089 * When dealing with SQLite3, use the table_info pragma helper, so that the bindings can do some translation for when sqlite3 breaks incompatibly between point releases. *Jamis Buck*
2090
2091 * SQLServer: don't choke on strings containing 'null'. #7083 *Jakob Skjerning*
2092
2093 * Consistently use LOWER() for uniqueness validations (rather than mixing with UPPER()) so the database can always use a functional index on the lowercased column. #6495 *Si*
2094
2095 * MySQL: SET SQL_AUTO_IS_NULL=0 so 'where id is null' doesn't select the last inserted id. #6778 *Jonathan Viney, timc*
2096
2097 * Fixtures use the table name and connection from set_fixture_class. #7330 *Anthony Eden*
2098
2099 * SQLServer: quote table name in indexes query. #2928 *keithm@infused.org*
2100
2101
2102 ## 1.15.1 (January 17th, 2007) ##
2103
2104 * Fix nodoc breaking of adapters
2105
2106
2107 ## 1.15.0 (January 16th, 2007) ##
2108
2109 * [DOC] clear up some ambiguity with the way has_and_belongs_to_many creates the default join table name. #7072 *Jeremy McAnally*
2110
2111 * change_column accepts :default => nil. Skip column options for primary keys. #6956, #7048 *Dan Manges, Jeremy Kemper*
2112
2113 * MySQL, PostgreSQL: change_column_default quotes the default value and doesn't lose column type information. #3987, #6664 *Jonathan Viney, Manfred Stienstra, altano@bigfoot.com*
2114
2115 * Oracle: create_table takes a :sequence_name option to override the 'tablename_seq' default. #7000 *Michael Schoen*
2116
2117 * MySQL: retain SSL settings on reconnect. #6976 *randyv2*
2118
2119 * SQLServer: handle [quoted] table names. #6635 *rrich*
2120
2121 * acts_as_nested_set works with single-table inheritance. #6030 *Josh Susser*
2122
2123 * PostgreSQL, Oracle: correctly perform eager finds with :limit and :order. #4668, #7021 *eventualbuddha, Michael Schoen*
2124
2125 * Fix the Oracle adapter for serialized attributes stored in CLOBs. Closes #6825 *mschoen, tdfowler*
2126
2127 * [DOCS] Apply more documentation for ActiveRecord Reflection. Closes #4055 *Robby Russell*
2128
2129 * [DOCS] Document :allow_nil option of #validate_uniqueness_of. Closes #3143 *Caio Chassot*
2130
2131 * Bring the sybase adapter up to scratch for 1.2 release. *jsheets*
2132
2133 * Oracle: fix connection reset failure. #6846 *leonlleslie*
2134
2135 * Subclass instantiation doesn't try to explicitly require the corresponding subclass. #6840 *leei, Jeremy Kemper*
2136
2137 * fix faulty inheritance tests and that eager loading grabs the wrong inheritance column when the class of your association is an STI subclass. Closes #6859 *protocool*
2138
2139 * find supports :lock with :include. Check whether your database allows SELECT ... FOR UPDATE with outer joins before using. #6764 *vitaly, Jeremy Kemper*
2140
2141 * Support nil and Array in :conditions => { attr => value } hashes. #6548 *Assaf, Jeremy Kemper*
2142 find(:all, :conditions => { :topic_id => [1, 2, 3], :last_read => nil }
2143
2144 * Quote ActiveSupport::Multibyte::Chars. #6653 *Julian Tarkhanov*
2145
2146 * MySQL: detect when a NOT NULL column without a default value is misreported as default ''. Can't detect for string, text, and binary columns since '' is a legitimate default. #6156 *simon@redhillconsulting.com.au, obrie, Jonathan Viney, Jeremy Kemper*
2147
2148 * validates_numericality_of uses \A \Z to ensure the entire string matches rather than ^ $ which may match one valid line of a multiline string. #5716 *Andreas Schwarz*
2149
2150 * Oracle: automatically detect the primary key. #6594 *vesaria, Michael Schoen*
2151
2152 * Oracle: to increase performance, prefetch 100 rows and enable similar cursor sharing. Both are configurable in database.yml. #6607 *philbogle@gmail.com, ray.fortna@jobster.com, Michael Schoen*
2153
2154 * Firebird: decimal/numeric support. #6408 *macrnic*
2155
2156 * Find with :include respects scoped :order. #5850
2157
2158 * Dynamically generate reader methods for serialized attributes. #6362 *Stefan Kaes*
2159
2160 * Deprecation: object transactions warning. *Jeremy Kemper*
2161
2162 * has_one :dependent => :nullify ignores nil associates. #6528 *janovetz, Jeremy Kemper*
2163
2164 * Oracle: resolve test failures, use prefetched primary key for inserts, check for null defaults, fix limited id selection for eager loading. Factor out some common methods from all adapters. #6515 *Michael Schoen*
2165
2166 * Make add_column use the options hash with the Sqlite Adapter. Closes #6464 *obrie*
2167
2168 * Document other options available to migration's add_column. #6419 *grg*
2169
2170 * MySQL: all_hashes compatibility with old MysqlRes class. #6429, #6601 *Jeremy Kemper*
2171
2172 * Fix has_many :through to add the appropriate conditions when going through an association using STI. Closes #5783. *Jonathan Viney*
2173
2174 * fix select_limited_ids_list issues in postgresql, retain current behavior in other adapters *Rick Olson*
2175
2176 * Restore eager condition interpolation, document it's differences *Rick Olson*
2177
2178 * Don't rollback in teardown unless a transaction was started. Don't start a transaction in create_fixtures if a transaction is started. #6282 *Jacob Fugal, Jeremy Kemper*
2179
2180 * Add #delete support to has_many :through associations. Closes #6049 *Martin Landers*
2181
2182 * Reverted old select_limited_ids_list postgresql fix that caused issues in mysql. Closes #5851 *Rick Olson*
2183
2184 * Removes the ability for eager loaded conditions to be interpolated, since there is no model instance to use as a context for interpolation. #5553 *turnip@turnipspatch.com*
2185
2186 * Added timeout option to SQLite3 configurations to deal more gracefully with SQLite3::BusyException, now the connection can instead retry for x seconds to see if the db clears up before throwing that exception #6126 *wreese@gmail.com*
2187
2188 * Added update_attributes! which uses save! to raise an exception if a validation error prevents saving #6192 *jonathan*
2189
2190 * Deprecated add_on_boundary_breaking (use validates_length_of instead) #6292 *Bob Silva*
2191
2192 * The has_many create method works with polymorphic associations. #6361 *Dan Peterson*
2193
2194 * MySQL: introduce Mysql::Result#all_hashes to support further optimization. #5581 *Stefan Kaes*
2195
2196 * save! shouldn't validate twice. #6324 *maiha, Bob Silva*
2197
2198 * Association collections have an _ids reader method to match the existing writer for collection_select convenience (e.g. employee.task_ids). The writer method skips blank ids so you can safely do @employee.task_ids = params[:tasks] without checking every time for an empty list or blank values. #1887, #5780 *Michael Schuerig*
2199
2200 * Add an attribute reader method for ActiveRecord::Base.observers *Rick Olson*
2201
2202 * Deprecation: count class method should be called with an options hash rather than two args for conditions and joins. #6287 *Bob Silva*
2203
2204 * has_one associations with a nil target may be safely marshaled. #6279 *norbauer, Jeremy Kemper*
2205
2206 * Duplicate the hash provided to AR::Base#to_xml to prevent unexpected side effects *Michael Koziarski*
2207
2208 * Add a :namespace option to AR::Base#to_xml *Michael Koziarski*
2209
2210 * Deprecation tests. Remove warnings for dynamic finders and for the foo_count method if it's also an attribute. *Jeremy Kemper*
2211
2212 * Mock Time.now for more accurate Touch mixin tests. #6213 *Dan Peterson*
2213
2214 * Improve yaml fixtures error reporting. #6205 *Bruce Williams*
2215
2216 * Rename AR::Base#quote so people can use that name in their models. #3628 *Michael Koziarski*
2217
2218 * Add deprecation warning for inferred foreign key. #6029 *Josh Susser*
2219
2220 * Fixed the Ruby/MySQL adapter we ship with Active Record to work with the new authentication handshake that was introduced in MySQL 4.1, along with the other protocol changes made at that time #5723 *jimw@mysql.com*
2221
2222 * Deprecation: use :dependent => :delete_all rather than :exclusively_dependent => true. #6024 *Josh Susser*
2223
2224 * Optimistic locking: gracefully handle nil versions, treat as zero. #5908 *Tom Ward*
2225
2226 * to_xml: the :methods option works on arrays of records. #5845 *Josh Starcher*
2227
2228 * has_many :through conditions are sanitized by the associating class. #5971 *martin.emde@gmail.com*
2229
2230 * Fix spurious newlines and spaces in AR::Base#to_xml output *Jamis Buck*
2231
2232 * has_one supports the :dependent => :delete option which skips the typical callback chain and deletes the associated object directly from the database. #5927 *Chris Mear, Jonathan Viney*
2233
2234 * Nested subclasses are not prefixed with the parent class' table_name since they should always use the base class' table_name. #5911 *Jonathan Viney*
2235
2236 * SQLServer: work around bug where some unambiguous date formats are not correctly identified if the session language is set to german. #5894 *Tom Ward, kruth@bfpi*
2237
2238 * Clashing type columns due to a sloppy join shouldn't wreck single-table inheritance. #5838 *Kevin Clark*
2239
2240 * Fixtures: correct escaping of \n and \r. #5859 *evgeny.zislis@gmail.com*
2241
2242 * Migrations: gracefully handle missing migration files. #5857 *eli.gordon@gmail.com*
2243
2244 * MySQL: update test schema for MySQL 5 strict mode. #5861 *Tom Ward*
2245
2246 * to_xml: correct naming of included associations. #5831 *Josh Starcher*
2247
2248 * Pushing a record onto a has_many :through sets the association's foreign key to the associate's primary key and adds it to the correct association. #5815, #5829 *Josh Susser*
2249
2250 * Add records to has_many :through using <<, push, and concat by creating the association record. Raise if base or associate are new records since both ids are required to create the association. #build raises since you can't associate an unsaved record. #create! takes an attributes hash and creates the associated record and its association in a transaction. *Jeremy Kemper*
2251
2252 # Create a tagging to associate the post and tag.
2253 post.tags << Tag.find_by_name('old')
2254 post.tags.create! :name => 'general'
2255
2256 # Would have been:
2257 post.taggings.create!(:tag => Tag.find_by_name('finally')
2258 transaction do
2259 post.taggings.create!(:tag => Tag.create!(:name => 'general'))
2260 end
2261
2262 * Cache nil results for :included has_one associations also. #5787 *Michael Schoen*
2263
2264 * Fixed a bug which would cause .save to fail after trying to access a empty has_one association on a unsaved record. *Tobias Lütke*
2265
2266 * Nested classes are given table names prefixed by the singular form of the parent's table name. *Jeremy Kemper*
2267 Example: Invoice::Lineitem is given table name invoice_lineitems
2268
2269 * Migrations: uniquely name multicolumn indexes so you don't have to. *Jeremy Kemper*
2270 # people_active_last_name_index, people_active_deactivated_at_index
2271 add_index :people, [:active, :last_name]
2272 add_index :people, [:active, :deactivated_at]
2273 remove_index :people, [:active, :last_name]
2274 remove_index :people, [:active, :deactivated_at]
2275
2276 WARNING: backward-incompatibility. Multicolumn indexes created before this
2277 revision were named using the first column name only. Now they're uniquely
2278 named using all indexed columns.
2279
2280 To remove an old multicolumn index, remove_index :table_name, :first_column
2281
2282 * Fix for deep includes on the same association. *richcollins@gmail.com*
2283
2284 * Tweak fixtures so they don't try to use a non-ActiveRecord class. *Kevin Clark*
2285
2286 * Remove ActiveRecord::Base.reset since Dispatcher doesn't use it anymore. *Rick Olson*
2287
2288 * PostgreSQL: autodetected sequences work correctly with multiple schemas. Rely on the schema search_path instead of explicitly qualifying the sequence name with its schema. #5280 *guy.naor@famundo.com*
2289
2290 * Replace Reloadable with Reloadable::Deprecated. *Nicholas Seckar*
2291
2292 * Cache nil results for has_one associations so multiple calls don't call the database. Closes #5757. *Michael Schoen*
2293
2294 * Don't save has_one associations unnecessarily. #5735 *Jonathan Viney*
2295
2296 * Refactor ActiveRecord::Base.reset_subclasses to #reset, and add global observer resetting. *Rick Olson*
2297
2298 * Formally deprecate the deprecated finders. *Michael Koziarski*
2299
2300 * Formally deprecate rich associations. *Michael Koziarski*
2301
2302 * Fixed that default timezones for new / initialize should uphold utc setting #5709 *daniluk@yahoo.com*
2303
2304 * Fix announcement of very long migration names. #5722 *blake@near-time.com*
2305
2306 * The exists? class method should treat a string argument as an id rather than as conditions. #5698 *jeremy@planetargon.com*
2307
2308 * Fixed to_xml with :include misbehaviors when invoked on array of model instances #5690 *alexkwolfe@gmail.com*
2309
2310 * Added support for conditions on Base.exists? #5689 [Josh Peek]. Examples:
2311
2312 assert (Topic.exists?(:author_name => "David"))
2313 assert (Topic.exists?(:author_name => "Mary", :approved => true))
2314 assert (Topic.exists?(["parent_id = ?", 1]))
2315
2316 * Schema dumper quotes date :default values. *Dave Thomas*
2317
2318 * Calculate sum with SQL, not Enumerable on HasManyThrough Associations. *Dan Peterson*
2319
2320 * Factor the attribute#{suffix} methods out of method_missing for easier extension. *Jeremy Kemper*
2321
2322 * Patch sql injection vulnerability when using integer or float columns. *Jamis Buck*
2323
2324 * Allow #count through a has_many association to accept :include. *Dan Peterson*
2325
2326 * create_table rdoc: suggest :id => false for habtm join tables. *Zed Shaw*
2327
2328 * PostgreSQL: return array fields as strings. #4664 *Robby Russell*
2329
2330 * SQLServer: added tests to ensure all database statements are closed, refactored identity_insert management code to use blocks, removed update/delete rowcount code out of execute and into update/delete, changed insert to go through execute method, removed unused quoting methods, disabled pessimistic locking tests as feature is currently unsupported, fixed RakeFile to load sqlserver specific tests whether running in ado or odbc mode, fixed support for recently added decimal types, added support for limits on integer types. #5670 *Tom Ward*
2331
2332 * SQLServer: fix db:schema:dump case-sensitivity. #4684 *Will Rogers*
2333
2334 * Oracle: BigDecimal support. #5667 *Michael Schoen*
2335
2336 * Numeric and decimal columns map to BigDecimal instead of Float. Those with scale 0 map to Integer. #5454 *robbat2@gentoo.org, work@ashleymoran.me.uk*
2337
2338 * Firebird migrations support. #5337 *Ken Kunz <kennethkunz@gmail.com>*
2339
2340 * PostgreSQL: create/drop as postgres user. #4790 *mail@matthewpainter.co.uk, mlaster@metavillage.com*
2341
2342 * PostgreSQL: correctly quote the ' in pk_and_sequence_for. #5462 *tietew@tietew.net*
2343
2344 * PostgreSQL: correctly quote microseconds in timestamps. #5641 *rick@rickbradley.com*
2345
2346 * Clearer has_one/belongs_to model names (account has_one :user). #5632 *matt@mattmargolis.net*
2347
2348 * Oracle: use nonblocking queries if allow_concurrency is set, fix pessimistic locking, don't guess date vs. time by default (set OracleAdapter.emulate_dates = true for the old behavior), adapter cleanup. #5635 *Michael Schoen*
2349
2350 * Fixed a few Oracle issues: Allows Oracle's odd date handling to still work consistently within #to_xml, Passes test that hardcode insert statement by dropping the :id column, Updated RUNNING_UNIT_TESTS with Oracle instructions, Corrects method signature for #exec #5294 *Michael Schoen*
2351
2352 * Added :group to available options for finds done on associations #5516 *mike@michaeldewey.org*
2353
2354 * Observers also watch subclasses created after they are declared. #5535 *daniels@pronto.com.au*
2355
2356 * Removed deprecated timestamps_gmt class methods. *Jeremy Kemper*
2357
2358 * rake build_mysql_database grants permissions to rails@localhost. #5501 *brianegge@yahoo.com*
2359
2360 * PostgreSQL: support microsecond time resolution. #5492 *alex@msgpad.com*
2361
2362 * Add AssociationCollection#sum since the method_missing invokation has been shadowed by Enumerable#sum.
2363
2364 * Added find_or_initialize_by_X which works like find_or_create_by_X but doesn't save the newly instantiated record. *Sam Stephenson*
2365
2366 * Row locking. Provide a locking clause with the :lock finder option or true for the default "FOR UPDATE". Use the #lock! method to obtain a row lock on a single record (reloads the record with :lock => true). *Shugo Maeda*
2367 # Obtain an exclusive lock on person 1 so we can safely increment visits.
2368 Person.transaction do
2369 # select * from people where id=1 for update
2370 person = Person.find(1, :lock => true)
2371 person.visits += 1
2372 person.save!
2373 end
2374
2375 * PostgreSQL: introduce allow_concurrency option which determines whether to use blocking or asynchronous #execute. Adapters with blocking #execute will deadlock Ruby threads. The default value is ActiveRecord::Base.allow_concurrency. *Jeremy Kemper*
2376
2377 * Use a per-thread (rather than global) transaction mutex so you may execute concurrent transactions on separate connections. *Jeremy Kemper*
2378
2379 * Change AR::Base#to_param to return a String instead of a Fixnum. Closes #5320. *Nicholas Seckar*
2380
2381 * Use explicit delegation instead of method aliasing for AR::Base.to_param -> AR::Base.id. #5299 (skaes@web.de)
2382
2383 * Refactored ActiveRecord::Base.to_xml to become a delegate for XmlSerializer, which restores sanity to the mega method. This refactoring also reinstates the opinions that type="string" is redundant and ugly and nil-differentiation is not a concern of serialization *David Heinemeier Hansson*
2384
2385 * Added simple hash conditions to find that'll just convert hash to an AND-based condition string #5143 [Hampton Catlin]. Example:
2386
2387 Person.find(:all, :conditions => { :last_name => "Catlin", :status => 1 }, :limit => 2)
2388
2389 ...is the same as:
2390
2391 Person.find(:all, :conditions => [ "last_name = ? and status = ?", "Catlin", 1 ], :limit => 2)
2392
2393 This makes it easier to pass in the options from a form or otherwise outside.
2394
2395
2396 * Fixed issues with BLOB limits, charsets, and booleans for Firebird #5194, #5191, #5189 *kennethkunz@gmail.com*
2397
2398 * Fixed usage of :limit and with_scope when the association in scope is a 1:m #5208 *alex@purefiction.net*
2399
2400 * Fixed migration trouble with SQLite when NOT NULL is used in the new definition #5215 *greg@lapcominc.com*
2401
2402 * Fixed problems with eager loading and counting on SQL Server #5212 *kajism@yahoo.com*
2403
2404 * Fixed that count distinct should use the selected column even when using :include #5251 *anna@wota.jp*
2405
2406 * Fixed that :includes merged from with_scope won't cause the same association to be loaded more than once if repetition occurs in the clauses #5253 *alex@purefiction.net*
2407
2408 * Allow models to override to_xml. #4989 *Blair Zajac <blair@orcaware.com>*
2409
2410 * PostgreSQL: don't ignore port when host is nil since it's often used to label the domain socket. #5247 *shimbo@is.naist.jp*
2411
2412 * Records and arrays of records are bound as quoted ids. *Jeremy Kemper*
2413 Foo.find(:all, :conditions => ['bar_id IN (?)', bars])
2414 Foo.find(:first, :conditions => ['bar_id = ?', bar])
2415
2416 * Fixed that Base.find :all, :conditions => [ "id IN (?)", collection ] would fail if collection was empty *David Heinemeier Hansson*
2417
2418 * Add a list of regexes assert_queries skips in the ActiveRecord test suite. *Rick Olson*
2419
2420 * Fix the has_and_belongs_to_many #create doesn't populate the join for new records. Closes #3692 *Josh Susser*
2421
2422 * Provide Association Extensions access to the instance that the association is being accessed from.
2423 Closes #4433 *Josh Susser*
2424
2425 * Update OpenBase adaterp's maintainer's email address. Closes #5176. *Derrick Spell*
2426
2427 * Add a quick note about :select and eagerly included associations. *Rick Olson*
2428
2429 * Add docs for the :as option in has_one associations. Closes #5144 *cdcarter@gmail.com*
2430
2431 * Fixed that has_many collections shouldn't load the entire association to do build or create *David Heinemeier Hansson*
2432
2433 * Added :allow_nil option for aggregations #5091 *Ian White*
2434
2435 * Fix Oracle boolean support and tests. Closes #5139. *Michael Schoen*
2436
2437 * create! no longer blows up when no attributes are passed and a :create scope is in effect (e.g. foo.bars.create! failed whereas foo.bars.create!({}) didn't.) *Jeremy Kemper*
2438
2439 * Call Inflector#demodulize on the class name when eagerly including an STI model. Closes #5077 *info@loobmedia.com*
2440
2441 * Preserve MySQL boolean column defaults when changing a column in a migration. Closes #5015. *pdcawley@bofh.org.uk*
2442
2443 * PostgreSQL: migrations support :limit with :integer columns by mapping limit < 4 to smallint, > 4 to bigint, and anything else to integer. #2900 *keegan@thebasement.org*
2444
2445 * Dates and times interpret empty strings as nil rather than 2000-01-01. #4830 *kajism@yahoo.com*
2446
2447 * Allow :uniq => true with has_many :through associations. *Jeremy Kemper*
2448
2449 * Ensure that StringIO is always available for the Schema dumper. *Marcel Molina Jr.*
2450
2451 * Allow AR::Base#to_xml to include methods too. Closes #4921. *johan@textdrive.com*
2452
2453 * Remove duplicate fixture entry in comments.yml. Closes #4923. *Blair Zajac <blair@orcaware.com>*
2454
2455 * When grouping, use the appropriate option key. *Marcel Molina Jr.*
2456
2457 * Add support for FrontBase (http://www.frontbase.com/) with a new adapter thanks to the hard work of one Mike Laster. Closes #4093. *mlaster@metavillage.com*
2458
2459 * Add warning about the proper way to validate the presence of a foreign key. Closes #4147. *Francois Beausoleil <francois.beausoleil@gmail.com>*
2460
2461 * Fix syntax error in documentation. Closes #4679. *Mislav Marohnić*
2462
2463 * Add Oracle support for CLOB inserts. Closes #4748. *schoenm@earthlink.net sandra.metz@duke.edu*
2464
2465 * Various fixes for sqlserver_adapter (odbc statement finishing, ado schema dumper, drop index). Closes #4831. *kajism@yahoo.com*
2466
2467 * Add support for :order option to with_scope. Closes #3887. *eric.daspet@survol.net*
2468
2469 * Prettify output of schema_dumper by making things line up. Closes #4241 *Caio Chassot <caio@v2studio.com>*
2470
2471 * Make build_postgresql_databases task make databases owned by the postgres user. Closes #4790. *mlaster@metavillage.com*
2472
2473 * Sybase Adapter type conversion cleanup. Closes #4736. *dev@metacasa.net*
2474
2475 * Fix bug where calculations with long alias names return null. *Rick Olson*
2476
2477 * Raise error when trying to add to a has_many :through association. Use the Join Model instead. *Rick Olson*
2478
2479 @post.tags << @tag # BAD
2480 @post.taggings.create(:tag => @tag) # GOOD
2481
2482 * Allow all calculations to take the :include option, not just COUNT (closes #4840) *Rick Olson*
2483
2484 * Add ActiveRecord::Errors#to_xml *Jamis Buck*
2485
2486 * Properly quote index names in migrations (closes #4764) *John Long*
2487
2488 * Fix the HasManyAssociation#count method so it uses the new ActiveRecord::Base#count syntax, while maintaining backwards compatibility. *Rick Olson*
2489
2490 * Ensure that Associations#include_eager_conditions? checks both scoped and explicit conditions *Rick Olson*
2491
2492 * Associations#select_limited_ids_list adds the ORDER BY columns to the SELECT DISTINCT List for postgresql. *Rick Olson*
2493
2494 * Add :case_sensitive option to validates_uniqueness_of (closes #3090) *Rick Olson*
2495
2496 class Account < ActiveRecord::Base
2497 validates_uniqueness_of :email, :case_sensitive => false
2498 end
2499
2500 * Allow multiple association extensions with :extend option (closes #4666) *Josh Susser*
2501
2502 class Account < ActiveRecord::Base
2503 has_many :people, :extend => [FindOrCreateByNameExtension, FindRecentExtension]
2504 end
2505
2506
2507 ## 1.14.4 (August 8th, 2006) ##
2508
2509 * Add warning about the proper way to validate the presence of a foreign key. #4147 *Francois Beausoleil <francois.beausoleil@gmail.com>*
2510
2511 * Fix syntax error in documentation. #4679 *Mislav Marohnić*
2512
2513 * Update inconsistent migrations documentation. #4683 *machomagna@gmail.com*
2514
2515
2516 ## 1.14.3 (June 27th, 2006) ##
2517
2518 * Fix announcement of very long migration names. #5722 *blake@near-time.com*
2519
2520 * Update callbacks documentation. #3970 *Robby Russell <robby@planetargon.com>*
2521
2522 * Properly quote index names in migrations (closes #4764) *John Long*
2523
2524 * Ensure that Associations#include_eager_conditions? checks both scoped and explicit conditions *Rick Olson*
2525
2526 * Associations#select_limited_ids_list adds the ORDER BY columns to the SELECT DISTINCT List for postgresql. *Rick Olson*
2527
2528
2529 ## 1.14.2 (April 9th, 2006) ##
2530
2531 * Fixed calculations for the Oracle Adapter (closes #4626) *Michael Schoen*
2532
2533
2534 ## 1.14.1 (April 6th, 2006) ##
2535
2536 * Fix type_name_with_module to handle type names that begin with '::'. Closes #4614. *Nicholas Seckar*
2537
2538 * Fixed that that multiparameter assignment doesn't work with aggregations (closes #4620) *Lars Pind*
2539
2540 * Enable Limit/Offset in Calculations (closes #4558) *lmarlow*
2541
2542 * Fixed that loading including associations returns all results if Load IDs For Limited Eager Loading returns none (closes #4528) *Rick Olson*
2543
2544 * Fixed HasManyAssociation#find bugs when :finder_sql is set #4600 *lagroue@free.fr*
2545
2546 * Allow AR::Base#respond_to? to behave when @attributes is nil *Ryan Davis*
2547
2548 * Support eager includes when going through a polymorphic has_many association. *Rick Olson*
2549
2550 * Added support for eagerly including polymorphic has_one associations. (closes #4525) *Rick Olson*
2551
2552 class Post < ActiveRecord::Base
2553 has_one :tagging, :as => :taggable
2554 end
2555
2556 Post.find :all, :include => :tagging
2557
2558 * Added descriptive error messages for invalid has_many :through associations: going through :has_one or :has_and_belongs_to_many *Rick Olson*
2559
2560 * Added support for going through a polymorphic has_many association: (closes #4401) *Rick Olson*
2561
2562 class PhotoCollection < ActiveRecord::Base
2563 has_many :photos, :as => :photographic
2564 belongs_to :firm
2565 end
2566
2567 class Firm < ActiveRecord::Base
2568 has_many :photo_collections
2569 has_many :photos, :through => :photo_collections
2570 end
2571
2572 * Multiple fixes and optimizations in PostgreSQL adapter, allowing ruby-postgres gem to work properly. *ruben.nine@gmail.com*
2573
2574 * Fixed that AssociationCollection#delete_all should work even if the records of the association are not loaded yet. *Florian Weber*
2575
2576 * Changed those private ActiveRecord methods to take optional third argument :auto instead of nil for performance optimizations. (closes #4456) *Stefan*
2577
2578 * Private ActiveRecord methods add_limit!, add_joins!, and add_conditions! take an OPTIONAL third argument 'scope' (closes #4456) *Rick Olson*
2579
2580 * DEPRECATED: Using additional attributes on has_and_belongs_to_many associations. Instead upgrade your association to be a real join model *David Heinemeier Hansson*
2581
2582 * Fixed that records returned from has_and_belongs_to_many associations with additional attributes should be marked as read only (fixes #4512) *David Heinemeier Hansson*
2583
2584 * Do not implicitly mark recordss of has_many :through as readonly but do mark habtm records as readonly (eventually only on join tables without rich attributes). *Marcel Mollina Jr.*
2585
2586 * Fixed broken OCIAdapter #4457 *Michael Schoen*
2587
2588
2589 ## 1.14.0 (March 27th, 2006) ##
2590
2591 * Replace 'rescue Object' with a finer grained rescue. Closes #4431. *Nicholas Seckar*
2592
2593 * Fixed eager loading so that an aliased table cannot clash with a has_and_belongs_to_many join table *Rick Olson*
2594
2595 * Add support for :include to with_scope *andrew@redlinesoftware.com*
2596
2597 * Support the use of public synonyms with the Oracle adapter; required ruby-oci8 v0.1.14 #4390 *Michael Schoen*
2598
2599 * Change periods (.) in table aliases to _'s. Closes #4251 *jeff@ministrycentered.com*
2600
2601 * Changed has_and_belongs_to_many join to INNER JOIN for Mysql 3.23.x. Closes #4348 *Rick Olson*
2602
2603 * Fixed issue that kept :select options from being scoped *Rick Olson*
2604
2605 * Fixed db_schema_import when binary types are present #3101 *David Heinemeier Hansson*
2606
2607 * Fixed that MySQL enums should always be returned as strings #3501 *David Heinemeier Hansson*
2608
2609 * Change has_many :through to use the :source option to specify the source association. :class_name is now ignored. *Rick Olson*
2610
2611 class Connection < ActiveRecord::Base
2612 belongs_to :user
2613 belongs_to :channel
2614 end
2615
2616 class Channel < ActiveRecord::Base
2617 has_many :connections
2618 has_many :contacts, :through => :connections, :class_name => 'User' # OLD
2619 has_many :contacts, :through => :connections, :source => :user # NEW
2620 end
2621
2622 * Fixed DB2 adapter so nullable columns will be determines correctly now and quotes from column default values will be removed #4350 *contact@maik-schmidt.de*
2623
2624 * Allow overriding of find parameters in scoped has_many :through calls *Rick Olson*
2625
2626 In this example, :include => false disables the default eager association from loading. :select changes the standard
2627 select clause. :joins specifies a join that is added to the end of the has_many :through query.
2628
2629 class Post < ActiveRecord::Base
2630 has_many :tags, :through => :taggings, :include => :tagging do
2631 def add_joins_and_select
2632 find :all, :select => 'tags.*, authors.id as author_id', :include => false,
2633 :joins => 'left outer join posts on taggings.taggable_id = posts.id left outer join authors on posts.author_id = authors.id'
2634 end
2635 end
2636 end
2637
2638 * Fixed that schema changes while the database was open would break any connections to an SQLite database (now we reconnect if that error is throw) *David Heinemeier Hansson*
2639
2640 * Don't classify the has_one class when eager loading, it is already singular. Add tests. (closes #4117) *Jonathan Viney*
2641
2642 * Quit ignoring default :include options in has_many :through calls *Mark James*
2643
2644 * Allow has_many :through associations to find the source association by setting a custom class (closes #4307) *Jonathan Viney*
2645
2646 * Eager Loading support added for has_many :through => :has_many associations (see below). *Rick Olson*
2647
2648 * Allow has_many :through to work on has_many associations (closes #3864) [sco@scottraymond.net] Example:
2649
2650 class Firm < ActiveRecord::Base
2651 has_many :clients
2652 has_many :invoices, :through => :clients
2653 end
2654
2655 class Client < ActiveRecord::Base
2656 belongs_to :firm
2657 has_many :invoices
2658 end
2659
2660 class Invoice < ActiveRecord::Base
2661 belongs_to :client
2662 end
2663
2664 * Raise error when trying to select many polymorphic objects with has_many :through or :include (closes #4226) *Josh Susser*
2665
2666 * Fixed has_many :through to include :conditions set on the :through association. closes #4020 *Jonathan Viney*
2667
2668 * Fix that has_many :through honors the foreign key set by the belongs_to association in the join model (closes #4259) *andylien@gmail.com / Rick Olson*
2669
2670 * SQL Server adapter gets some love #4298 *Ryan Tomayko*
2671
2672 * Added OpenBase database adapter that builds on top of the http://www.spice-of-life.net/ruby-openbase/ driver. All functionality except LIMIT/OFFSET is supported #3528 *derrickspell@cdmplus.com*
2673
2674 * Rework table aliasing to account for truncated table aliases. Add smarter table aliasing when doing eager loading of STI associations. This allows you to use the association name in the order/where clause. [Jonathan Viney / Rick Olson] #4108 Example (SpecialComment is using STI):
2675
2676 Author.find(:all, :include => { :posts => :special_comments }, :order => 'special_comments.body')
2677
2678 * Add AbstractAdapter#table_alias_for to create table aliases according to the rules of the current adapter. *Rick Olson*
2679
2680 * Provide access to the underlying database connection through Adapter#raw_connection. Enables the use of db-specific methods without complicating the adapters. #2090 *Michael Koziarski*
2681
2682 * Remove broken attempts at handling columns with a default of 'now()' in the postgresql adapter. #2257 *Michael Koziarski*
2683
2684 * Added connection#current_database that'll return of the current database (only works in MySQL, SQL Server, and Oracle so far -- please help implement for the rest of the adapters) #3663 *Tom Ward*
2685
2686 * Fixed that Migration#execute would have the table name prefix appended to its query #4110 *mark.imbriaco@pobox.com*
2687
2688 * Make all tinyint(1) variants act like boolean in mysql (tinyint(1) unsigned, etc.) *Jamis Buck*
2689
2690 * Use association's :conditions when eager loading. [Jeremy Evans] #4144
2691
2692 * Alias the has_and_belongs_to_many join table on eager includes. #4106 *Jeremy Evans*
2693
2694 This statement would normally error because the projects_developers table is joined twice, and therefore joined_on would be ambiguous.
2695
2696 Developer.find(:all, :include => {:projects => :developers}, :conditions => 'join_project_developers.joined_on IS NOT NULL')
2697
2698 * Oracle adapter gets some love #4230 *Michael Schoen*
2699
2700 * Changes :text to CLOB rather than BLOB [Moses Hohman]
2701 * Fixes an issue with nil numeric length/scales (several)
2702 * Implements support for XMLTYPE columns [wilig / Kubo Takehiro]
2703 * Tweaks a unit test to get it all green again
2704 * Adds support for #current_database
2705
2706 * Added Base.abstract_class? that marks which classes are not part of the Active Record hierarchy #3704 *Rick Olson*
2707
2708 class CachedModel < ActiveRecord::Base
2709 self.abstract_class = true
2710 end
2711
2712 class Post < CachedModel
2713 end
2714
2715 CachedModel.abstract_class?
2716 => true
2717
2718 Post.abstract_class?
2719 => false
2720
2721 Post.base_class
2722 => Post
2723
2724 Post.table_name
2725 => 'posts'
2726
2727 * Allow :dependent options to be used with polymorphic joins. #3820 *Rick Olson*
2728
2729 class Foo < ActiveRecord::Base
2730 has_many :attachments, :as => :attachable, :dependent => :delete_all
2731 end
2732
2733 * Nicer error message on has_many :through when :through reflection can not be found. #4042 *court3nay*
2734
2735 * Upgrade to Transaction::Simple 1.3 *Jamis Buck*
2736
2737 * Catch FixtureClassNotFound when using instantiated fixtures on a fixture that has no ActiveRecord model *Rick Olson*
2738
2739 * Allow ordering of calculated results and/or grouped fields in calculations *solo@gatelys.com*
2740
2741 * Make ActiveRecord::Base#save! return true instead of nil on success. #4173 *johan@johansorensen.com*
2742
2743 * Dynamically set allow_concurrency. #4044 *Stefan Kaes*
2744
2745 * Added Base#to_xml that'll turn the current record into a XML representation [David Heinemeier Hansson]. Example:
2746
2747 topic.to_xml
2748
2749 ...returns:
2750
2751 <?xml version="1.0" encoding="UTF-8"?>
2752 <topic>
2753 <title>The First Topic</title>
2754 <author-name>David</author-name>
2755 <id type="integer">1</id>
2756 <approved type="boolean">false</approved>
2757 <replies-count type="integer">0</replies-count>
2758 <bonus-time type="datetime">2000-01-01 08:28:00</bonus-time>
2759 <written-on type="datetime">2003-07-16 09:28:00</written-on>
2760 <content>Have a nice day</content>
2761 <author-email-address>david@loudthinking.com</author-email-address>
2762 <parent-id></parent-id>
2763 <last-read type="date">2004-04-15</last-read>
2764 </topic>
2765
2766 ...and you can configure with:
2767
2768 topic.to_xml(:skip_instruct => true, :except => [ :id, bonus_time, :written_on, replies_count ])
2769
2770 ...that'll return:
2771
2772 <topic>
2773 <title>The First Topic</title>
2774 <author-name>David</author-name>
2775 <approved type="boolean">false</approved>
2776 <content>Have a nice day</content>
2777 <author-email-address>david@loudthinking.com</author-email-address>
2778 <parent-id></parent-id>
2779 <last-read type="date">2004-04-15</last-read>
2780 </topic>
2781
2782 You can even do load first-level associations as part of the document:
2783
2784 firm.to_xml :include => [ :account, :clients ]
2785
2786 ...that'll return something like:
2787
2788 <?xml version="1.0" encoding="UTF-8"?>
2789 <firm>
2790 <id type="integer">1</id>
2791 <rating type="integer">1</rating>
2792 <name>37signals</name>
2793 <clients>
2794 <client>
2795 <rating type="integer">1</rating>
2796 <name>Summit</name>
2797 </client>
2798 <client>
2799 <rating type="integer">1</rating>
2800 <name>Microsoft</name>
2801 </client>
2802 </clients>
2803 <account>
2804 <id type="integer">1</id>
2805 <credit-limit type="integer">50</credit-limit>
2806 </account>
2807 </firm>
2808
2809 * Allow :counter_cache to take a column name for custom counter cache columns *Jamis Buck*
2810
2811 * Documentation fixes for :dependent *robby@planetargon.com*
2812
2813 * Stop the MySQL adapter crashing when views are present. #3782 *Jonathan Viney*
2814
2815 * Don't classify the belongs_to class, it is already singular #4117 *keithm@infused.org*
2816
2817 * Allow set_fixture_class to take Classes instead of strings for a class in a module. Raise FixtureClassNotFound if a fixture can't load. *Rick Olson*
2818
2819 * Fix quoting of inheritance column for STI eager loading #4098 *Jonathan Viney <jonathan@bluewire.net.nz>*
2820
2821 * Added smarter table aliasing for eager associations for multiple self joins #3580 *Rick Olson*
2822
2823 * The first time a table is referenced in a join, no alias is used.
2824 * After that, the parent class name and the reflection name are used.
2825
2826 Tree.find(:all, :include => :children) # LEFT OUTER JOIN trees AS tree_children ...
2827
2828 * Any additional join references get a numerical suffix like '_2', '_3', etc.
2829
2830 * Fixed eager loading problems with single-table inheritance #3580 [Rick Olson]. Post.find(:all, :include => :special_comments) now returns all posts, and any special comments that the posts may have. And made STI work with has_many :through and polymorphic belongs_to.
2831
2832 * Added cascading eager loading that allows for queries like Author.find(:all, :include=> { :posts=> :comments }), which will fetch all authors, their posts, and the comments belonging to those posts in a single query (using LEFT OUTER JOIN) #3913 [anna@wota.jp]. Examples:
2833
2834 # cascaded in two levels
2835 >> Author.find(:all, :include=>{:posts=>:comments})
2836 => authors
2837 +- posts
2838 +- comments
2839
2840 # cascaded in two levels and normal association
2841 >> Author.find(:all, :include=>[{:posts=>:comments}, :categorizations])
2842 => authors
2843 +- posts
2844 +- comments
2845 +- categorizations
2846
2847 # cascaded in two levels with two has_many associations
2848 >> Author.find(:all, :include=>{:posts=>[:comments, :categorizations]})
2849 => authors
2850 +- posts
2851 +- comments
2852 +- categorizations
2853
2854 # cascaded in three levels
2855 >> Company.find(:all, :include=>{:groups=>{:members=>{:favorites}}})
2856 => companies
2857 +- groups
2858 +- members
2859 +- favorites
2860
2861 * Make counter cache work when replacing an association #3245 *eugenol@gmail.com*
2862
2863 * Make migrations verbose *Jamis Buck*
2864
2865 * Make counter_cache work with polymorphic belongs_to *Jamis Buck*
2866
2867 * Fixed that calling HasOneProxy#build_model repeatedly would cause saving to happen #4058 *anna@wota.jp*
2868
2869 * Added Sybase database adapter that relies on the Sybase Open Client bindings (see http://raa.ruby-lang.org/project/sybase-ctlib) #3765 [John Sheets]. It's almost completely Active Record compliant (including migrations), but has the following caveats:
2870
2871 * Does not support DATE SQL column types; use DATETIME instead.
2872 * Date columns on HABTM join tables are returned as String, not Time.
2873 * Insertions are potentially broken for :polymorphic join tables
2874 * BLOB column access not yet fully supported
2875
2876 * Clear stale, cached connections left behind by defunct threads. *Jeremy Kemper*
2877
2878 * CHANGED DEFAULT: set ActiveRecord::Base.allow_concurrency to false. Most AR usage is in single-threaded applications. *Jeremy Kemper*
2879
2880 * Renamed the "oci" adapter to "oracle", but kept the old name as an alias #4017 *Michael Schoen*
2881
2882 * Fixed that Base.save should always return false if the save didn't succeed, including if it has halted by before_save's #1861, #2477 *David Heinemeier Hansson*
2883
2884 * Speed up class -> connection caching and stale connection verification. #3979 *Stefan Kaes*
2885
2886 * Add set_fixture_class to allow the use of table name accessors with models which use set_table_name. *Kevin Clark*
2887
2888 * Added that fixtures to placed in subdirectories of the main fixture files are also loaded #3937 *dblack@wobblini.net*
2889
2890 * Define attribute query methods to avoid method_missing calls. #3677 *Jonathan Viney*
2891
2892 * ActiveRecord::Base.remove_connection explicitly closes database connections and doesn't corrupt the connection cache. Introducing the disconnect! instance method for the PostgreSQL, MySQL, and SQL Server adapters; implementations for the others are welcome. #3591 *Simon Stapleton, Tom Ward*
2893
2894 * Added support for nested scopes #3407 [anna@wota.jp]. Examples:
2895
2896 Developer.with_scope(:find => { :conditions => "salary > 10000", :limit => 10 }) do
2897 Developer.find(:all) # => SELECT * FROM developers WHERE (salary > 10000) LIMIT 10
2898
2899 # inner rule is used. (all previous parameters are ignored)
2900 Developer.with_exclusive_scope(:find => { :conditions => "name = 'Jamis'" }) do
2901 Developer.find(:all) # => SELECT * FROM developers WHERE (name = 'Jamis')
2902 end
2903
2904