Skip to content
This repository has been archived by the owner on May 4, 2021. It is now read-only.

mongodb/bson-numpy

Repository files navigation

BSON-NumPy

MongoDB, Inc. has stopped development of BSON-NumPy and this project has been superseded by PyMongoArrow. In addition to NumPy arrays, PyMongoArrow also supports direct conversion of MongoDB query results to Pandas DataFrames and Apache Arrow Tables, amongst other features. See the project documentation to get started with PyMongoArrow.

Info

See the mongo site for more information. See GitHub for the latest source.

Author

Anna Herlihy

Maintainer

The MongoDB Python Team

Documentation

https://bson-numpy.readthedocs.io/en/latest/

About

A Python extension written in C that uses libbson to convert between NumPy arrays and BSON, the native data format of MongoDB.

This project is a prototype and not ready for production use.

Bugs / Feature Requests

Think you’ve found a bug? Want to see a new feature in BSON-NumPy? Please open a issue in github.

How To Ask For Help

Please include all of the following information when opening an issue:

  • Detailed steps to reproduce the problem, including full traceback, if possible.
  • The exact python version used, with patch level:

    $ python -c "import sys; print(sys.version)"
  • The exact version of bson-numpy used:

    $ python -c "import bsonnumpy; print(bsonnumpy.__version__)"
  • The operating system and version (e.g. Windows 7, OSX 10.8, ...)

Installation

Please see the instructions on readthedocs.

Dependencies

BSON-NumPy supports CPython 3.5+. BSON-NumPy requires NumPy 1.17.0+, and works with PyMongo 3.6+.

Examples

Please see the examples on readthedocs.

Documentation

Please see the documentation on readthedocs.

Testing

The easiest way to run the tests is to run python setup.py test in the root of the distribution.