Skip to content

Latest commit

 

History

History
37 lines (27 loc) · 1.32 KB

DEVELOPER_GUIDE.md

File metadata and controls

37 lines (27 loc) · 1.32 KB
Raw

Developer Guide

Linter and Test Suite

Run the linter and test suite to ensure your changes do not break existing code:

# Install Nox for task management
$ python -m pip install nox

# Auto-format and lint your changes
$ nox -rs format

# Run the test suite
$ nox -rs test

Integration Tests

To run the integration tests locally, run:

./.ci/run-tests opensearch true

The first argument, opensearch tells the server type to run integration test against. Valid values are opensearch and opendistro. The second argument tells whether to run server with security plugin enabled or not.

Note that integration tests require docker to be installed and running, and downloads quite a bit of data from over the internet and hence take few minutes to complete.

Build the Documentation with Sphinx

This are the steps to build the documentation with Sphinx:

  1. change into the opensearch-py directory where setup.py is located
  2. install opensearch-py - we recommend [editable mode](https://pip.pypa.io/en/stable/cli/pip_install/#cmdoption-e
    • with bash: pip install -e .[docs]
    • with zsh: pip install -e .\[docs]
  3. change into the docs directory
  4. execute make html
  5. use your favorite web browser to open the file called opensearch-py/docs/build/html/index.html