Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Python client for the Evergreen API

Project description

A client library for the Evergreen API written in python. Currently supports the V2 version of the API. For more details, see .

PyPI Coverage Status


>>> from evergreen.api import EvgAuth, EvergreenApi
>>> api = EvergreenApi.get_api(EvgAuth('david.bradford', '***'))
>>> project = api.project_by_id('mongodb-mongo-master')
>>> project.display_name
'MongoDB (master)'

Command Line Application

A command line application is included to explore the evergreen api data. It is called evg-api.

$ evg-api --json list-hosts
    "host_id": "host num 0",
    "host_url": "",
    "distro": {
        "distro_id": "ubuntu1804-build",
        "provider": "static",
        "image_id": ""
    "provisioned": true,
    "started_by": "mci",
    "host_type": "",
    "user": "mci-exec",
    "status": "running",
    "running_task": {
        "task_id": null,
        "name": null,
        "dispatch_time": null,
        "version_id": null,
        "build_id": null
    "user_host": false

Contributors Guide


Tox is being used for multiversion testing. Tests are run on python 2.7 and 3.6. You should have both of these installed locally. To run tests, install the requirements.txt and then run tox.

$ pip install -r requirements.txt
$ tox

To get code coverage information, you can run pytest directly.

$ pip install -r requirements.txt
$ pytest --cov=src --cov-report=html

This will generate an html coverage report in htmlcov/ directory.

There are a few tests that are slow running. These tests are not run by default, but can be included by setting the env variable RUN_SLOW_TESTS to any value.

$ RUN_SLOW_TEST=1 pytest

Versioning and Deploy

Before deploying a new version, please update the file with a description of what is being changed.

Deploys to PyPi are done automatically on merges to master. In order to avoid overwriting a previous deploy, the version should be updated on all changes. The semver versioning scheme should be used for determining the version number.

The version is found in the evergreen package at src/evergreen/

Note: There are evergreen checks to ensure the version does not match the latest version in PyPi.


Merges to master should be done by the evergreen commit queue. After a PR has been reviewed, add a comment with the text evergreen merge to merge the PR.

Updating the Freeze File

You will need to update requirements.txt.freeze if you change the dependencies of this project:

#!/usr/bin/env bash
set -e
rm ${current_directory}/requirements.txt.freeze
virtualenv -p python3 ${current_directory}/freeze_venv
source ${current_directory}/freeze_venv/bin/activate
pip install -r ${current_directory}/requirements.txt
pip freeze --local --requirement requirements.txt > requirements.txt.freeze
rm -rf ${current_directory}/freeze_venv

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for, version 0.6.13
Filename, size File type Python version Upload date Hashes
Filename, size (37.4 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size (26.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page