Merge pull request #128 from SaezChristopher/feat/fixture-doc

Feat/fixture doc
This commit is contained in:
Tanner 2017-03-18 13:17:24 +01:00 committed by GitHub
commit 5ada0ae80e
1 changed files with 39 additions and 0 deletions

39
fluent/fixtures.md Normal file
View File

@ -0,0 +1,39 @@
---
currentMenu: fluent-fixtures
---
# Fixtures
When you want to prepopulate a database with existing data, you will need to create one or several fixtures. For example, in your table `users`, it's very common to create admin account and a test account just after the creation of the table. The following snippets of code show you how to deal with it.
In a separate file (Database+Fixture.swift):
```swift
extension Database {
func insertFixtures<T: Entity, S: Sequence>(_ data: S) throws where S.Iterator.Element == T {
let context = DatabaseContext(self)
try data.forEach { model in
let query = Query<T>(self)
query.action = .create
query.data = try model.makeNode(context: context)
try driver.query(query)
}
}
}
```
In your model User.swift file:
```swift
static func prepare(_ database: Database) throws {
try database.create("users") { users in
users.id()
users.string("email")
users.string("password")
}
let seedData: [AppUser] = [
try User(email: "admin@admin.com", rawPassword: "Def4ultPassword?!"),
try User(email: "test@test.com", rawPassword: "Def4ultPassword?!")
]
try database.insertFixtures(seedData)
}
```