BSON 8 is a fast BSON library. It's compliant to the whole BSON specification test suite. The library parses the binary data on-demand, delaying copies until the last second.
BSON is parsed and generated as specified for version 1.1 of the BSON specification.
Be sure to read our full documentation and API reference.
BSON uses the Swift Package Manager. Add BSON to your dependencies in your Package.swift file:
.package(url: "https://github.com/OpenKitten/BSON.git", from: "8.0.0")Also, don't forget to add "BSON" as a dependency for your target.
Create Documents using Dictionary Literals:
var userDocument: Document = [
"username": "Joannis",
"online": true,
"age": 20,
"pi_constant": 3.14,
"profile": [
"firstName": "Joannis",
"lastName": "Orlandos"
]
]
let favouriteNumbers: Document = [1, 3, 7, 14, 21, 24, 34]
userDocument["favouriteNumbers"] = favouriteNumbersAccess values in an array like you would in Swift Arrays and values in an object like a Dictionary.
let favouriteNumber = favouriteNumbers[0]
let usernameValue = userDocument["username"]Extract types with simplicity:
let username = String(userDocument["username"]) // "Joannis"
let isOnline = Bool(userDocument["online"]) // true
let age = Int(userDocument["age"]) // 20
let pi = Double(userDocument["pi_constant"]) // 3.14Chain subscripts easily to find results without a hassle as shown underneath using this JSON structure (assuming this is represented in BSON):
{
"users": [
{
"username": "Joannis",
"profile": {
"firstName": "Joannis",
"lastName": "Orlandos"
}
},
{
"username": "Obbut",
"profile": {
"firstName": "Robbert",
"lastName": "Brandsma"
}
}
]
}let obbutLastName = String(object["users"][1]["profile"]["lastName"]) // "Brandsma"Complex array and dictionary literals may confuse the Swift type system. If this happens to you, make the literal explicitly a Document type:
var userDocument: Document = [
"username": "Joannis",
"online": true,
"age": 20,
"pi_constant": 3.14,
"profile": [
"firstName": "Joannis",
"lastName": "Orlandos",
"pets": [
[
"name": "Noodles",
"type": "Parrot"
] as Document,
[
"name": "Witje",
"type": "Rabbit"
]
] as Document
] as Document
]Document can be instantiated from SwiftNIO's ByteBuffer or Foundation.Data.
You can validate the formatting of this document manually using the .validate() function. This will also specify where the data was found corrupt.
If you pass a Document or Primitive into the BSONDecoder you can decode any Decodable type if the formats match. Likewise, BSONEncoder can encode your Swift types into a Document.
All non-deprecated BSON 1.1 types are supported.
- Double
- String
- Document
- Array
- ObjectId
- Bool
- DateTime
- 32-bit integer
- 64-bit integer
- Null value
- Binary
- Regular Expression
- Min Key
- Max Key
- Timestamp
- Javascript Code
- Javascript Code with Scope
- Decimal128