kotovalexarian-likes-github/database_cleaner
1
0
Fork 0
mirror of https://github.com/DatabaseCleaner/database_cleaner synced 2023-03-27 23:22:03 -04:00
Code Releases Activity

Update ADAPTERS.md.

Browse source
This commit is contained in:
Micah Geisel 2020-04-10 09:25:22 -07:00
parent 70dee154f5
commit 2628b3c36c
1 changed files with 21 additions and 27 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

48
ADAPTERS.md
View file

@ -32,7 +32,6 @@ You need to add a couple of dependecies to `.gemspec`:
Inside the `lib/database_cleaner/orm_name` directory, you will need to create a few files: Inside the `lib/database_cleaner/orm_name` directory, you will need to create a few files:
* `base.rb`
* Separate files for each strategy you have * Separate files for each strategy you have
The file structure you end up with will look something like this The file structure you end up with will look something like this
@ -41,7 +40,6 @@ The file structure you end up with will look something like this
\-lib \-lib
\-database_cleaner \-database_cleaner
\- orm_name \- orm_name
\- base.rb
\- truncation.rb \- truncation.rb
\- deletion.rb \- deletion.rb
\- transaction.rb \- transaction.rb
@ -49,19 +47,23 @@ The file structure you end up with will look something like this
\- orm_name.rb \- orm_name.rb
``` ```
#### base.rb #### orm_name.rb
File `base.rb` **must** have do the following: File `orm_name.rb` **must** do the following:
* define module methods `.default_strategy` and `.available_strategies` on DatabaseCleaner::OrmName. * define module methods `.default_strategy` and `.available_strategies` on DatabaseCleaner::OrmName.
* define instance methods `#db=`, `#db`, `#cleaning` within DatabaseCleaner::OrmName::Base. * require all the gems strategies
* configure DatabaseCleaner with the default strategy for the ORM. * configure DatabaseCleaner with the default strategy for the ORM.
`DatabaseCleaner::Generic::Base` will add some of those don't forget to include it. So, in the end you will end up with a file that might look something like this:
So, in the end you may end up with the class that will look something like this
```ruby ```ruby
require 'database_cleaner/generic/base' # lib/database_cleaner/orm_name.rb
require 'database_cleaner/orm_name/version'
require 'database_cleaner/core'
require 'database_cleaner/orm_name/transaction'
require 'database_cleaner/orm_name/truncation'
require 'database_cleaner/orm_name/deletion'
module DatabaseCleaner module DatabaseCleaner
module OrmName module OrmName
@ -70,19 +72,7 @@ module DatabaseCleaner
end end
def self.default_strategy def self.default_strategy
:truncation :transaction
end
module Base
include ::DatabaseCleaner::Generic::Base
def db=(desired_db)
@db = desired_db
end
def db
@db || :default
end
end end
end end
end end
@ -92,21 +82,25 @@ DatabaseCleaner[:orm_name].strategy = :transaction
### Strategy classes ### Strategy classes
Each strategy class can inherit from DatabaseCleaner::Strategy to get it most of the way there. If you do, you only need to define one method!
Each strategy **must** have the following instance methods Each strategy **must** have the following instance methods
* `#clean` -- where the cleaning happens * `#clean` -- where the cleaning happens
Optionally, depending on how your strategy works you may define Optionally, depending on how your strategy works you may define
* `#start` -- if your strategy is transactional, this is where you would start the database transaction that `#clean` later rolls back. This method might be included with `::DatabaseCleaner::Generic::Truncation` or `::DatabaseCleaner::Generic::Transaction` * `#start` -- if your strategy is transactional, this is where you would start the database transaction that `#clean` later rolls back.
Given that we're creating a strategy for truncation, you may end up with something like the following class: Given that we're creating a strategy for truncation, you may end up with something like the following class:
```ruby ```ruby
# lib/database_cleaner/orm_name/truncation.rb
require 'database_cleaner/strategy'
require 'orm'
module DatabaseCleaner module DatabaseCleaner
module OrmName module OrmName
class Truncation class Truncation < Strategy
include ::DatabaseCleaner::OrmName::Base
include ::DatabaseCleaner::Generic::Truncation
def clean def clean
# actual database cleaning code goes here # actual database cleaning code goes here
ORM.truncate_all_tables! ORM.truncate_all_tables!