Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/matthuhiggins/foreigner

Adds foreign key helpers to migrations and correctly dumps foreign keys to schema.rb
https://github.com/matthuhiggins/foreigner

Last synced: 1 day ago
JSON representation

Adds foreign key helpers to migrations and correctly dumps foreign keys to schema.rb

Host: GitHub
URL: https://github.com/matthuhiggins/foreigner
Owner: matthuhiggins
License: mit
Created: 2009-04-16T05:50:41.000Z (over 15 years ago)
Default Branch: master
Last Pushed: 2019-02-06T16:22:54.000Z (almost 6 years ago)
Last Synced: 2024-12-05T07:05:40.286Z (8 days ago)
Language: Ruby
Homepage: www.strictlyuntyped.com
Size: 386 KB
Stars: 1,325
Watchers: 23
Forks: 124
Open Issues: 4
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: MIT-LICENSE

Awesome Lists containing this project

awesome-ruby - Foreigner - Adds foreign key helpers to migrations and correctly dumps foreign keys to schema.rb. (Database Tools)

README

# Foreigner
[![Build Status](https://travis-ci.org/matthuhiggins/foreigner.svg)](https://travis-ci.org/matthuhiggins/foreigner) [![Code Climate](https://codeclimate.com/github/matthuhiggins/foreigner.svg)](https://codeclimate.com/github/matthuhiggins/foreigner)

Foreigner introduces a few methods to your migrations for adding and removing foreign key constraints. It also dumps foreign keys to `schema.rb`.

The following adapters are supported:

* mysql2
* postgres
* sqlite (foreign key methods are a no-op)

**Foreigner was rendered obsolete in Rails 4.2**. The migration DSL [supports foreign keys out of the box](http://edgeguides.rubyonrails.org/4_2_release_notes.html#foreign-key-support) via `add_foreign_key` and `remove_foreign_key`.

## Installation

Add the following to your Gemfile:
```ruby
gem 'foreigner'
```
## API Examples

Foreigner adds two methods to migrations.

* `add_foreign_key(from_table, to_table, options)`
* `remove_foreign_key(from_table, to_table, options)`

(Options are documented in `connection_adapters/abstract/schema_statements.rb`):

For example, given the following model:
```ruby
class Comment < ActiveRecord::Base
belongs_to :post
end

class Post < ActiveRecord::Base
has_many :comments, dependent: :delete_all
end
```
You should add a foreign key in your migration:
```ruby
add_foreign_key(:comments, :posts)
```
The `:dependent` option can be moved from the `has_many` definition to the foreign key:
```ruby
add_foreign_key(:comments, :posts, dependent: :delete)
```
If the column is named `article_id` instead of `post_id`, use the `:column` option:
```ruby
add_foreign_key(:comments, :posts, column: 'article_id')
```
A name can be specified for the foreign key constraint:
```ruby
add_foreign_key(:comments, :posts, name: 'comment_article_foreign_key')
```
The `:column` and `:name` options create a foreign key with a custom name. In order to remove it you need to specify `:name`:
```ruby
remove_foreign_key(:comments, name: 'comment_article_foreign_key')
```
## Change Table Methods

Foreigner adds extra methods to `create_table` and `change_table`.

Create a new table with a foreign key:
```ruby
create_table :products do |t|
t.string :name
t.integer :factory_id
t.foreign_key :factories
end
```
Add a missing foreign key to comments:
```ruby
change_table :comments do |t|
t.foreign_key :posts, dependent: :delete
end
```
Remove an unwanted foreign key:
```ruby
change_table :comments do |t|
t.remove_foreign_key :users
end
```
## Database-specific options

Database-specific options will never be supported by foreigner. You can add them using `:options`:
```ruby
add_foreign_key(:comments, :posts, options: 'ON UPDATE DEFERRED')
```
## Foreigner Add-ons

* [immigrant](https://github.com/jenseng/immigrant) - generate a migration that includes all missing foreign keys.
* [sqlserver-foreigner](https://github.com/cleblanc87/sqlserver-foreigner) - A plugin for SQL Server.

## License