Database Seeders vs. Factories about tripaltestsuite

[almasaeed2010]

Hi!

Here are a few things factories provide:

• simple per table syntax
• an easy way to generate multiple records by provide a second argument
• however, they can’t be used to define complex operations such as using user_save() or entity_save()

Seeders:

• usually used to run complex operations
• can be run using the command line using “tripaltest db:seed”
• the most important feature is that seeders can be used to populate the database with persistent data. So you’d run the seeder once to add the data and be able to use and test the GUI

BTW, both the seeder class and the tripal test case class provide a “$this->publish($chado_table_name, $record_id)” method to convert chado records into entities in case you wanted to run tests on entities

[almasaeed2010]

Precisely!

[almasaeed2010]

Seeders don't run automatically. You have to use MySeeder::seed() in the test method (which you can run within a transaction) or by running them through the command line which is not revertible.

[laceysanderson]

Oh, I think I see! :-) Thanks!

Just to check my understanding:

• I would create a database seeder for creating fake "BlastDB" nodes used for testing the blast form or job since it should be done with node_save()?
• I could use a factory for creating fake dbxrefs when testing "BlastDB" node CRUD and for use in the database seeder above?

[bradfordcondon]

@almasaeed2010 do seeders do inserts only or updates? I'm thinking about seeders running multiple times and getting db errors because of it.

@laceysanderson i think if you are using seeders in the context of testing, then you'll want to a) run the seeders in the Travis container before running your tests and b) document that you need to run them for tests to pass for contributors. Factories on the other hand are meant to be lightweight, run once per test.

[bradfordcondon]

oh thats neat, so running within test, with transactions, is do-able. So in that case its for "complex operations" as you say. Cool.