Welcome to the repo containing all things Python for the Azure Cosmos DB API which is published with name azure-cosmos. For documentation please see the Microsoft Azure link.
Python 2.7, Python 3.3, Python 3.4, or Python 3.5 https://www.python.org/downloads/
If you use Microsoft Visual Studio as IDE (we use 2015), please install the following extension for Python. http://microsoft.github.io/PTVS/
Install Cosmos DB emulator Follow instruction at https://docs.microsoft.com/en-us/azure/cosmos-db/local-emulator
$ python setup.py install
or
$ pip install azure-cosmos
Clone the repo
git clone https://github.com/Azure/azure-cosmos-python.git
cd azure-cosmos-python
Most of the test files under test sub-folder require you to enter your Azure Cosmos master key and host endpoint:
masterKey = '[YOUR_KEY_HERE]'
host = '[YOUR_ENDPOINT_HERE]'
To run the tests:
$ python -m unittest discover -s .\test -p "*.py"
If you use Microsoft Visual Studio, open the project file python.pyproj,
and run all the tests in Test Explorer.
Note:
Most of the test cases create containers in your Cosmos account. Containers are billing entities. By running these test cases, you may incur monetary costs on your account.
Install Sphinx: http://sphinx-doc.org/install.html
$ cd doc
$ sphinx-apidoc -f -e -o api ..\azure\cosmos
$ make.bat html