Metadata-Version: 2.1
Name: pdmongo
Version: 0.0.2
Summary: Transfer data between pandas dataframes and MongoDB
Home-page: https://github.com/pakallis/python-pandas-mongo
Author: Pavlos Kallis
Author-email: pakallis@gmail.com
License: MIT
Project-URL: Documentation, https://python-pandas-mongo.readthedocs.io/
Project-URL: Changelog, https://python-pandas-mongo.readthedocs.io/en/latest/changelog.html
Project-URL: Issue Tracker, https://github.com/pakallis/python-pandas-mongo/issues
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Requires-Dist: pymongo (>=3.4)
Requires-Dist: pandas (>=0.20)
Provides-Extra: test
Requires-Dist: pytest (>=4.0.2) ; extra == 'test'
Requires-Dist: pytest-mock (>=1.10.0) ; extra == 'test'
Requires-Dist: hypothesis (>=3.58) ; extra == 'test'

========
Overview
========



This package allows you to read/write pandas dataframes in MongoDB in the simplest way possible.

* Free software: MIT license

===========
Quick Start
===========

Writing a pandas DataFrame to a MongoDB collection::

	import pdmongo as pdm
	import pandas as pd

	df = pd.DataFrame({'A': [1, 2], 'B': [3, 4]})
	df = pdm.read_mongo("MyCollection", [], "mongodb://localhost:27017/mydb")
	df.to_mongo(df, collection, uri)


Reading a MongoDB collection into a pandas DataFrame::

	import pdmongo as pdm
	df = pdm.read_mongo("MyCollection", [], "mongodb://localhost:27017/mydb")
	print(df)


============
Installation
============

::

    pip install pdmongo

You can also install the in-development version with::

    pip install https://github.com/pakallis/python-pandas-mongo/archive/master.zip


Documentation
=============


https://python-pandas-mongo.readthedocs.io/


Development
===========

To run the all tests run::

    tox

Note, to combine the coverage data from all the tox environments run:

.. list-table::
    :widths: 10 90
    :stub-columns: 1

    - - Windows
      - ::

            set PYTEST_ADDOPTS=--cov-append
            tox

    - - Other
      - ::

            PYTEST_ADDOPTS=--cov-append tox


Changelog
=========

0.0.2 (2020-05-04)
------------------

* Dropped support for pypy3

0.0.1 (2020-04-30)
------------------

* Added read_mongo and basic support for reading MongoDB collections into pandas dataframes
* Added to_mongo and basic support for writing pandas dataframes in MongoDB collections

0.0.0 (2020-03-22)
------------------

* First release on PyPI.

