https://github.com/tayloraswift/swift-mongodb

use BSON and MongoDB in pure Swift
https://github.com/tayloraswift/swift-mongodb

bson mongodb mongodb-driver scram-sha-256

Last synced: 3 months ago
JSON representation

use BSON and MongoDB in pure Swift

• Host: GitHub
• URL: https://github.com/tayloraswift/swift-mongodb
• Owner: tayloraswift
• License: apache-2.0
• Created: 2022-11-26T04:05:31.000Z (almost 3 years ago)
• Default Branch: master
• Last Pushed: 2025-03-21T01:09:58.000Z (7 months ago)
• Last Synced: 2025-06-12T04:56:06.341Z (4 months ago)
• Topics: bson, mongodb, mongodb-driver, scram-sha-256
• Language: Swift
• Homepage: https://swiftinit.org/docs/swift-mongodb
• Size: 1.76 MB
• Stars: 10
• Watchers: 2
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


***`mongodb`***

[![ci status](https://github.com/tayloraswift/swift-mongodb/actions/workflows/Tests.yml/badge.svg)](https://github.com/tayloraswift/swift-mongodb/actions/workflows/Tests.yml)

[![ci status](https://github.com/tayloraswift/swift-mongodb/actions/workflows/Documentation.yml/badge.svg)](https://github.com/tayloraswift/swift-mongodb/actions/workflows/Documentation.yml)

[![swift package index versions](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Ftayloraswift%2Fswift-mongodb%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/tayloraswift/swift-mongodb)

[![swift package index platforms](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Ftayloraswift%2Fswift-mongodb%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/tayloraswift/swift-mongodb)



*`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

```swift

import NIOCore

import NIOPosix

import MongoDB

let executors:MultiThreadedEventLoopGroup = .init(numberOfThreads: 2)

let bootstrap:Mongo.DriverBootstrap = MongoDB / ["mongo-0", "mongo-1"] /?

{

    $0.executors = MultiThreadedEventLoopGroup.singleton

    $0.appname = "example app"

}

let configuration:Mongo.ReplicaSetConfiguration = try await bootstrap.withSessionPool

{

    try await $0.run(

        command: Mongo.ReplicaSetGetConfiguration.init(),

        against: .admin)

}

print(configuration)

//  ...

```

## toolchain requirement

This package requires Swift 6.0 or greater.

## license and acknowledgements

This library is Apache 2.0 licensed. It originally began as a re-write of [*MongoKitten*](https://github.com/orlandos-nl/MongoKitten) by [Joannis Orlandos](https://github.com/Joannis) and [Robbert Brandsma](https://github.com/Obbut).

## 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:

1.  [`swift-grammar`](https://github.com/tayloraswift/swift-grammar)

    Rationale: this package provides the `TraceableErrors` module which the driver uses to provide rich diagnostics. The driver does not depend on any parser targets.

1.  [`swift-hash`](https://github.com/tayloraswift/swift-hash)

    Rationale: this package implements cryptographic algorithms the driver uses to complete authentication with `mongod`/`mongos` servers.

Other packages:

1.  [`apple/swift-atomics`](https://github.com/apple/swift-atomics)

    Rationale: this package provides atomic types that improve the performance of the driver’s various concurrent data structures.

1.  [`apple/swift-collections`](https://github.com/apple/swift-collections)

    Rationale: this package provides data structures that improve the runtime complexity of several algorithms the driver uses internally. Moreover, the driver’s `swift-nio` dependency already depends on one of this package’s modules (`DequeModule`) anyway.

1.  [`apple/swift-nio`](https://github.com/apple/swift-nio)

    Rationale: networking.

1.  [`apple/swift-nio-ssl`](https://github.com/apple/swift-nio-ssl)

    Rationale: networking.

> Note: This library depends on the `NIOSSL` product from `swift-nio-ssl`, which imports Foundation on Apple platforms only. `NIOSSL` is Foundation-free on all other platforms.