Skip to content
This repository has been archived by the owner. It is now read-only.
Go to file

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time


Carthage compatible Join the chat at Travis CI Platforms

#This library is no longer under active development. I highly recommend using the robust, pure-swift alternative MongoKitten.

A Swift MongoDB driver. Wraps around the MongoDB C Driver 1.2.0 (supports MongoDB version 2.4 and later).

Supports the 03-24 snapshot with 0.5, and 02-28 with 0.4. Earlier versions should not be used.


The simplest and linux-compatible way to use SwiftMongoDB is through the official Swift package manager. Simply add it to your Package.swift like so:

import PackageDescription
let package = Package(
  name: "foo",
  dependencies: [
    .Package(url: "", majorVersion: 0, minor: 5)

As a second step you need to ensure that the mongo-c driver is installed on your system.

OSX (via brew)

brew install mongo-c

If you also need to install MongoDB run the following

brew install mongodb

The rest of the universe

How to install MongoDB C driver.


This example assumes that you have setup the project and have MongoDB running.


At the top of any file where you use SwiftMongoDB, you need to import it:

import MongoDB

First, you need to establish a connection to the MongoDB server.

let client = try Client(host: "localhost", port: 27017)

You can connect to a MongoDB instance (local or not) this way.

Then you need to create a database.

let testDatabase = Database(client: client, name: "test")

Then you need to create a collection. The collection doesn't have to exist (it will be created automatically if it isn't).

let subjects = Collection(database: testDatabase, name: "subjects")

Insertion and BSON

An important aspect of SwiftMongoDB is how it handles inserting documents. Most of the work will be done through a medium defined in BinaryJSON called BSON.Document. Creating it is very simple and type-safe, and the translation to MongoDB's lower-level type known as BSON is (fortunately) done behind the scenes for you.

For example, say you wanted to create a human named Dan. This is how it would look in JSON:

  "name" : "Dan",
  "age" : 15,
  "lovesSwift" : true,
  "location" : {
    "state" : "California"
  "favoriteNumbers" : [1, 2, 3, 4, 5]

It looks pretty similar in Swift:

let subject: BSON.Document = [
    "name": "Dan",
    "age": 15,
    "lovesSwift" : true,
    "location": [
        "state": "California"
    "favoriteNumbers" : [1,2,3,4,5]

You can then insert the newly created document(s) into the collection.

try subjects.insert(subject)

If you want to create a BSON.Document from JSON, it's just as simple:

let document = try BSON.fromJSONString(jsonString)

That's it for inserting documents - pretty neat, right?


Now, lets do some querying!

Here's the most basic query you can possibly perform:

let cursor = try subjects.find()
let testSubjects = try cursor.all()

The first line, as you can see, returns a cursor. The Cursor type gives you more control over how you process the results of the query. For most use cases, the methods Cursor.nextDocument and Cursor.all will be enough. However, Cursor also conforms to GeneratorType and SequenceType, meaning that you can take advantage of a lot of neat Swift features. For example, you can iterate directly over it using a for loop:

let results = try subjects.find()
for subject in results {

Now, say we inserted a few more test subjects and wanted to query for all of them whose age is exactly 15. This is pretty simple:

let result = try subjects.find(query: ["age" : 15])

The query parameter operates just as it would in most other MongoDB implementations. For instance, in the MongoDB shell, this would be the equivalent of db.subjects.find( {"age" : 15} ).


If you wanted to change all test subjects who loved Swift to Chris Lattner, you could simply do:

let newDocument: BSON.Document = [
    "name": "Chris Lattner" // we can ignore the other keys for this example
try subjects.update(query: ["lovesSwift": true], newValue: newDocument)


Removing documents works the same way - if you want to remove all of the test subjects named Dan, you simply do:

try subjects.remove(query: ["name" : "Dan"])

Those are the basics - it's really a very small simple library. You can take a look at the test suite and/or source which should show you some of the methods not shown here. Otherwise, feel free to jump right into the deep end and start using SwiftMongoDB!


Any and all help is very welcome! Feel free to fork and submit a pull request - I will almost certainly merge it.

You should start by taking a look at the current issues and see if there's anything you want to implement/fix there.


MIT - more information is in the LICENSE file.




Swift 3 support



Minor api fixes


A large refactor with a cleaner API and better internal code.



SPM and Linux support



Update dependencies, fix a few bugs.


Update dependencies.


Set up proper dependency management through Carthage, among other fixes.


Migrate to MongoDB C Driver 1.2.0 from 0.8, comes with a complete rewrite



Migrate to Swift 2 error handling model


Add documentation, clean up a lot of code, add examples for schemas using inheritance, protocols, and protocol extensions.



Add support for very simple mongoose-esque schemas by conforming to protocol MongoObject.


Implement (untested) login, fix major issue with querying where objects would either get ignored or query would loop indefinitely.


Fix BSON encoder and decoder to support boolean values, bugfixes.


Implement BSON -> Swift, bugfixes.


Make SwiftMongoDB multiplatform.

0.0.4 - 0.0.2

Getting Cocoapods to work, bugfixes.


Core operations implemented (insert, find, remove).


A MongoDB interface for Swift [Not under active development]




No packages published


You can’t perform that action at this time.