mongodb0.1.17
swift-mongodb is a pure-Swift BSON library and MongoDB driver. All of the constituent products in this package are Foundation-free.
getting started
TODO: add more snippets
import NIOCore
import NIOPosix
import MongoDB
let executors:MultiThreadedEventLoopGroup = .init(numberOfThreads: 2)
let bootstrap:Mongo.DriverBootstrap = MongoDB / ["mongo-0", "mongo-1"] /?
{
$0.executors = .shared(executors)
$0.appname = "example app"
}
let configuration:Mongo.ReplicaSetConfiguration = try await bootstrap.withSessionPool
{
try await $0.run(
command: Mongo.ReplicaSetGetConfiguration.init(),
against: .admin)
}
print(configuration)
// ...external dependencies
I have verified that all products depended-upon by this package are Foundation-free when compiled for a linux target. Note that some package dependencies do vend products that import Foundation, but swift links binaries at the product level, and this library does not depend on any such products.
My packages:
-
Rationale: this package provides the
TraceableErrorsmodule which the driver uses to provide rich diagnostics. The driver does not depend on any parser targets. -
Rationale: this package implements cryptographic algorithms the driver uses to complete authentication with
mongod/mongosservers.
Other packages:
-
Rationale: this package provides atomic types that improve the performance of the driver’s various concurrent data structures.
-
Rationale: this package provides data structures that improve the runtime complexity of several algorithms the driver uses internally. Moreover, the driver’s
swift-niodependency already depends on one of this package’s modules (DequeModule) anyway. -
Rationale: networking.
-
Rationale: networking.
Note: This library depends on the
NIOSSLproduct fromswift-nio-ssl, which imports Foundation on Apple platforms only.NIOSSLis Foundation-free on all other platforms.
toolchain requirement
This package requires swift 5.7 or greater. Compiling with a swift 5.9 toolchain is not recommended, due to known compiler bugs.
acknowledgements
This library originally started out as a re-write of Orlandos’s MongoKitten; accordingly the MongoDriver module retains MongoKitten’s original MIT-license.
The official MongoDB C driver also served as prior art for this module.
license
The MongoDriver module is MIT-licensed.
The other modules are available under the MPL 2.0 license. This license was chosen as an organizational default, and is not ideological. Please reach out if you have a use-case that requires a more-permissive license!