https://github.com/paulmelnikow/objcmongodb

Mac OS and iOS library for MongoDB and BSON
https://github.com/paulmelnikow/objcmongodb

bson client driver mongodb

Last synced: 6 days ago
JSON representation

Mac OS and iOS library for MongoDB and BSON

• Host: GitHub
• URL: https://github.com/paulmelnikow/objcmongodb
• Owner: paulmelnikow
• License: apache-2.0
• Created: 2012-03-01T18:14:18.000Z (almost 13 years ago)
• Default Branch: master
• Last Pushed: 2023-02-09T15:55:51.000Z (almost 2 years ago)
• Last Synced: 2025-01-02T07:09:23.752Z (20 days ago)
• Topics: bson, client, driver, mongodb
• Language: Objective-C
• Homepage:
• Size: 730 KB
• Stars: 162
• Watchers: 21
• Forks: 27
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • Changelog: HISTORY.md
  • License: LICENSE

Awesome Lists containing this project

README

        
ObjCMongoDB is a Mac OS and iOS library for [MongoDB][] and [BSON][] based on

the [10gen legacy C driver][mongo-c-driver].

[![Build Status](https://travis-ci.org/paulmelnikow/ObjCMongoDB.png)](https://travis-ci.org/paulmelnikow/ObjCMongoDB)

## Latest release

The latest release is v0.12.0.

 -   Supports [CocoaPods][]

 -   Based on version 0.8.1 of the legacy C driver

 -   Works under OS X 10.6+ and iOS 5+

 -   Works both with and without support for ARC

 

```sh

git checkout v0.12.0

git submodule update --init

```

See what's changed in [History][].

## Getting started

Refer to the installation instructions and sample code on the [wiki][]:

 -   [Getting started using ObjCMongoDB in your Mac OS project][GettingStarted]

 -   [The basics of using ObjCMongoDB][TheBasics]

## Features

 -   Simple BSON encoding and decoding, using dictionaries.

 -   Built-in support for arrays, dictionaries, embedded objects, strings,

     numbers, dates, object IDs, and the miscellaneous MongoDB types.

 -   More complex encoding and decoding based on NSCoder's keyed coding

     scheme. A robust delegate interface lets you implement encoding and

     decoding entirely outside the model classes if necessary.

   

 -   Automatically encodes and decodes Core Data entities. Using the coder's

     delegate interface you can customize the default behavior, or simply

     implement alternate behavior it in the entity class.

 -   Aims to feel Cocoa-like, not Mongo-like. For example, method names in

     MongoKeyedPredicate and MongoUpdateRequest are natural in Cocoa, though

     they don't conform to the underlying Mongo keywords.

## License

Sources copyright Paul Melnikow, 10gen, Matthew Gallagher, and other

contributors.

Unless otherwise specified in a source file, sources in this repository are

published under the terms of the Apache License version 2.0, a copy of which is

in this repository as APACHE-2.0.txt.

## Acknowledgements

 -  Originally based on [NuMongoDB][] by Tim Burks: Copyright 2010 Neon Design Technology, Inc.

 -  Includes enhancements by [Diederik Hoogenboom][] and [Rob Elkin][]

 -  [Official MongoDB C driver][mongo-c-driver]: Copyright 2009, 2010 10gen Inc.

 -  [OrderedDictionary][] by Matt Gallagher: Copyright 2008 Matt Gallagher

[BSON]: http://bsonspec.org/

[MongoDB]: http://www.mongodb.org/

[mongo-c-driver]: https://github.com/mongodb/mongo-c-driver-legacy

[History]: HISTORY.md

[Wiki]: https://github.com/paulmelnikow/ObjCMongoDB/wiki

[GettingStarted]: https://github.com/paulmelnikow/ObjCMongoDB/wiki/GettingStarted

[TheBasics]: https://github.com/paulmelnikow/ObjCMongoDB/wiki/TheBasics

[NuMongoDB]: https://github.com/timburks/NuMongoDB

[Diederik Hoogenboom]: https://github.com/dhoogenb/NuMongoDB

[Rob Elkin]: https://github.com/robelkin/NuMongoDB

[OrderedDictionary]: http://cocoawithlove.com/2008/12/ordereddictionary-subclassing-cocoa.html

[CocoaPods]: http://cocoapods.org/