Fluent 3.0 is here! 🎉
🖋 Swift ORM framework (queries, models, and relations) for building NoSQL and SQL database integrations.

See the updated documentation for more information:
docs.vapor.codes/3.0/fluent/getting-started/

And of course, check out the API docs for detailed information about the public API:
api.vapor.codes/fluent/latest/Fluent

Changes since latest RC:

Fixed:

• Children relation can now be created with let variable. (#532)
• KeyedCache set will now lookup existing entries first.
• Removed deprecated methods.

New:

• Upgraded to vapor/sql 2.0 protocols.
• Standardized FluentBenchmarker run method.
• Add new Fluent benchmarks for sorting, subset operations, and range.

Fixed:

• Fixed an issue where ranges would not be applied.
• Fixed an issue where ranges would be off-by-one.

Fixed:

• Fixes a typo in enableReferences on DatabasesConfig (#505).
• Adds deprecations for actions: overload when creating a reference (#506).

See 3.0.0 RC 3 for more information.

Fixed:

• Fixed a bug with OR/AND groups (#449, #466, #467).

Fixed:

• Small fixes in FluentBenchmarker

New:

• CSQLite and SQLite are now in vapor/sqlite repo.
• FluentSQLite is now in vapor/fluent-sqlite repo.

Fixed:

• Use non-blocking await during migrations.

New:

• #376 Referential actions are now supported for ReferenceSupporting databases.

try builder.addReference(from: \.ownerID, to: \User.id, actions: ReferentialActions(update: .update, delete: .prevent))

• #376 Auto migration is now available via a static method on Model where Database: SchemaSupporting. This will allow for easier customization of migrations.

extension Pet: Migration {
    /// See `Migration.prepare(on:)`
    public static func prepare(on connection: Database.Connection) -> Future<Void> {
        return Database.create(self, on: connection) { builder in
            try addProperties(to: builder)
            try builder.addReference(from: \.ownerID, to: \User.id)
        }
    }
}

• #371 Added CRUD operations for Future where T: Model

let user: Future<User> = ...
user.save(on: ...)

• #372 structs can now be conformed to Model

Fixes

• SoftDeletable models can now be saved
• Several missing overloads added to QueryBuilder operators and methods
• Several fixes to relations and joins

Milestone

Fixed:

• .distinct() now works correctly with aggregate queries.

Fixed:

• Allows usage of .in and .notIn filters on joined tables.

Fixed:

• Fetched row is properly stored on .all().
• Swift 4 warnings.

Milestone

Fixed:

• .save() now properly sends only modified rows.

Milestone

New:

• Swift 4 support.

Fixed:

• blob type publicized.

New:

• Easier support for [UInt8] (a.k.a Bytes) types using Fluent.Blob.

Fixed:

• SQLite now properly releases save points after transactions.
• exists is now properly set before didCreate and didDelete methods.
• Swift 3.2/4 warnings.

Milestone

New:

• Filters are now NodeConvertible.
• Subset filter overloads.
• Better .noDatabase suggested fixes.

Milestone

Fixed:

• Storable no longer requires class thanks to nonmutating keyword.

Milestone

Fixed:

• Parent, Children, and Siblings relations now properly use the supplied Executor.

Milestone

New:

• Static lifecycle callbacks on entity.
• Soft delete now works on SoftDeletable queries.
• Improved foreignKey method.

Fixed:

• Row context issues have been resolved.

Milestone

Fixed:

• .notIn now behaves properly for empty subsets

Milestone

Fixed:

• Issue in tester associated w/ databases that enforce uuid proper

#263

🎉