Skip to content

mongodb-labs/drivers-atlas-testing

Repository files navigation

astrolabe

Documentation Status

Developer tools for testing Drivers against MongoDB Atlas. See GitHub for the latest source.

About

The Astrolabe distribution contains tools for automating Atlas operations and running Atlas Planned Maintenance tests. The atlasclient package provides programmatic access to the MongoDB Atlas API via a fluent interface. The astrolabe package provides a convenient, command-line interface to the atlasclient and also contains the test harnesses necessary to run Atlas Planned Maintenance specification tests.

Astrolabe supports Python 3.8+.

Installation

Astrolabe can be installed with pip:

python -m pip install astrolabe

You can also download the project source and do:

python -m pip install .

Dependencies

Astrolabe supports CPython 3.8+.

Astrolabe requires Click, requests, PyMongo, dnspython, PyYAML, and junitparser.

Documentation

Documentation is available on ReadtheDocs.

To build the documentation, you will need to install mkdocs.

Run mkdocs serve to see a live view of the docs.

Linting and Formatting

This repo uses pre-commit for managing linting. pre-commit performs various checks on the files and uses tools that help follow a consistent style within the repo.

To set up pre-commit locally, run:

brew install pre-commit
pre-commit install

To run pre-commit manually, run pre-commit run --all-files.

To run a manual hook like shellcheck manually, run:

pre-commit run --all-files --hook-stage manual shellcheck