2010-03-28 08:15:02 -04:00
|
|
|
require 'active_support/core_ext/object/blank'
|
|
|
|
|
2005-09-23 09:29:33 -04:00
|
|
|
module ActiveRecord
|
2010-06-16 13:47:05 -04:00
|
|
|
# = Active Record Schema
|
2010-08-05 11:15:07 -04:00
|
|
|
#
|
2005-10-16 12:00:16 -04:00
|
|
|
# Allows programmers to programmatically define a schema in a portable
|
|
|
|
# DSL. This means you can define tables, indexes, etc. without using SQL
|
|
|
|
# directly, so your applications can more easily support multiple
|
|
|
|
# databases.
|
|
|
|
#
|
|
|
|
# Usage:
|
|
|
|
#
|
|
|
|
# ActiveRecord::Schema.define do
|
|
|
|
# create_table :authors do |t|
|
2007-11-06 13:26:54 -05:00
|
|
|
# t.string :name, :null => false
|
2005-10-16 12:00:16 -04:00
|
|
|
# end
|
|
|
|
#
|
|
|
|
# add_index :authors, :name, :unique
|
|
|
|
#
|
|
|
|
# create_table :posts do |t|
|
2007-11-06 13:26:54 -05:00
|
|
|
# t.integer :author_id, :null => false
|
|
|
|
# t.string :subject
|
|
|
|
# t.text :body
|
|
|
|
# t.boolean :private, :default => false
|
2005-10-16 12:00:16 -04:00
|
|
|
# end
|
|
|
|
#
|
|
|
|
# add_index :posts, :author_id
|
|
|
|
# end
|
|
|
|
#
|
|
|
|
# ActiveRecord::Schema is only supported by database adapters that also
|
|
|
|
# support migrations, the two features being very similar.
|
2005-09-25 13:56:03 -04:00
|
|
|
class Schema < Migration
|
2010-12-03 07:12:59 -05:00
|
|
|
def migrations_paths
|
|
|
|
ActiveRecord::Migrator.migrations_paths
|
2010-01-08 12:38:32 -05:00
|
|
|
end
|
|
|
|
|
2005-10-16 12:00:16 -04:00
|
|
|
# Eval the given block. All methods available to the current connection
|
|
|
|
# adapter are available within the block, so you can easily use the
|
2008-05-25 07:29:00 -04:00
|
|
|
# database definition DSL to build up your schema (+create_table+,
|
|
|
|
# +add_index+, etc.).
|
2005-10-16 12:00:16 -04:00
|
|
|
#
|
|
|
|
# The +info+ hash is optional, and if given is used to define metadata
|
2008-04-09 12:20:15 -04:00
|
|
|
# about the current schema (currently, only the schema's version):
|
2005-10-16 12:00:16 -04:00
|
|
|
#
|
2008-04-09 12:20:15 -04:00
|
|
|
# ActiveRecord::Schema.define(:version => 20380119000001) do
|
2005-10-16 12:00:16 -04:00
|
|
|
# ...
|
|
|
|
# end
|
2005-09-23 09:29:33 -04:00
|
|
|
def self.define(info={}, &block)
|
2010-11-17 16:31:43 -05:00
|
|
|
schema = new
|
|
|
|
schema.instance_eval(&block)
|
2005-09-23 09:29:33 -04:00
|
|
|
|
2010-12-01 20:08:01 -05:00
|
|
|
unless info[:version].blank?
|
|
|
|
initialize_schema_migrations_table
|
2010-12-03 07:12:59 -05:00
|
|
|
assume_migrated_upto_version(info[:version], schema.migrations_paths)
|
2010-12-01 20:08:01 -05:00
|
|
|
end
|
2005-09-23 09:29:33 -04:00
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|