Elasticsearch Clients Tests

This repository holds common tests for Elasticsearch Clients.

Yaml tests

The tests are specified using the Elasticsearch YAML format reported here.

All the tests are located in the tests folder. Each API endpoint has a folder containing the tests to be executed. All the files must be executed in order, they are enumerated with a digit prefix.

Test Sections

requires

This section should define if a test is available for the stack client, serverless client or both with the following format:

---
requires:
  serverless: true
  stack: true

This helps us differentiate tests for a particular client and define tests in common for both.

setup and teardown

Pre-requisites to run a test (e.g. creating an index, populating an index with data) are declared in a setup section. The list of commands in the setup section has to run before the test section.

Cleanup is declared in a teardown section. This list of commands will run after the tests. Please add a teardown section to your test to remove any created artifacts and data. This will keep our test clusters clean and our test suite sane.

APIs Report

This report contains information from each specification:

• Elasticsearch REST API JSON specification
• Elasticsearch API Specification

It also contains information on test coverage in this project for Serverless and Stack APIs. The report is automatically generated when code is pushed in a GitHub Action. It can also be triggered manually. The source code for the report is in the ./report/ directory.