Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

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