SchemaPlus::Tables
SchemaPlus::Tables adds useful features to ActiveSupport's handling of tables. (Actually, only one for now)
SchemaPlus::Tables is part of the SchemaPlus family of Ruby on Rails extension gems.
Installation
As usual:
gem "schema_plus_tables" # in a Gemfile
gem.add_dependency "schema_plus_tables" # in a .gemspec
Usage
drop_table if exists
SchemaPlus::Tables adds the if_exists:
option:
ActiveRecord::Migration.drop_table "table_name", if_exists: true
Deprecations
SchemaPlus 1.8.x provided some options and accessors that are now available in ActiveRecord 4.2, but in slightly different form. SchemaPlus::Tables still supports the SchemaPlus 1.8.x form but issues deprecation warnings in favor of the rails form:
-
Migration.drop_table
deprecates option-
cascade: true
=>force: :cascade
-
Compatibility
SchemaPlus::Tables is tested on:
- ruby 2.1.5 with activerecord 4.2, using mysql2, sqlite3 or postgresql
History
- 0.1.1 - Update schema_plus_core and schema_dev dependencies
- 0.1.0 - Initial release, extracted from SchemaPlus 1.x
Development & Testing
Are you interested in contributing to SchemaPlus::Tables? Thanks! Please follow the standard protocol: fork, feature branch, develop, push, and issue pull request.
Some things to know about to help you develop and test:
-
schema_dev: SchemaPlus::Tables uses schema_dev to facilitate running rspec tests on the matrix of ruby, activerecord, and database versions that the gem supports, both locally and on travis-ci
To to run rspec locally on the full matrix, do:
$ schema_dev bundle install $ schema_dev rspec
You can also run on just one configuration at a time; For info, see
schema_dev --help
or the schema_dev README.The matrix of configurations is specified in
schema_dev.yml
in the project root.
- schema_plus_core: SchemaPlus::Tables uses the SchemaPlus::Core API that provides middleware callback stacks to make it easy to extend ActiveRecord's behavior. If that API is missing something you need for your contribution, please head over to schema_plus_core and open an issue or pull request.
- schema_monkey: SchemaPlus::Tables is implemented as a schema_monkey client, using schema_monkey's convention-based protocols for extending ActiveRecord and using middleware stacks.