Files
ess-helm/tests
dependabot[bot] 50648579c2 Bump the minor-and-patches group across 1 directory with 3 updates
Bumps the minor-and-patches group with 3 updates in the / directory: [pytz](https://github.com/stub42/pytz), [types-pytz](https://github.com/python/typeshed) and [lightkube](https://github.com/gtsystem/lightkube).


Updates `pytz` from 2026.2 to 2026.3.post1
- [Release notes](https://github.com/stub42/pytz/releases)
- [Commits](https://github.com/stub42/pytz/compare/release_2026.2...release_2026.3.post1)

Updates `types-pytz` from 2026.2.0.20260518 to 2026.3.1.20260727
- [Commits](https://github.com/python/typeshed/commits)

Updates `lightkube` from 0.21.0 to 0.22.0
- [Release notes](https://github.com/gtsystem/lightkube/releases)
- [Commits](https://github.com/gtsystem/lightkube/compare/v0.21.0...v0.22.0)

---
updated-dependencies:
- dependency-name: lightkube
  dependency-version: 0.22.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: minor-and-patches
- dependency-name: pytz
  dependency-version: 2026.3.post1
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: minor-and-patches
- dependency-name: types-pytz
  dependency-version: 2026.3.1.20260727
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: minor-and-patches
...

Signed-off-by: dependabot[bot] <[email protected]>
2026-08-05 07:39:17 +00:00
..
2026-08-04 16:41:47 +01:00
2026-03-30 11:34:06 +02:00

ESS Community Integration Tests

Overview

The ESS Community Integration Tests project is designed to facilitate the testing of components against Element Server Suite. It provides a command-line interface (CLI) to run ESS integration tests.

Features

  • Set up a Kubernetes cluster for testing.
  • Run integration tests for ESS using predefined test suites.
  • Customize test runs with additional values files.

Prerequisites

  • Python 3.11 or higher
  • Docker
  • k3d
  • Helm
  • Optional: uv to install from git

Installation

pipx install ess-community-integration-tests
uvx ess-community-integration-tests

You can also install it from the git repository :

# You can also use any ESS Community version
VERSION=main
uv tool install git+https://github.com/element-hq/ess-helm.git@$VERSION#subdirectory=tests

Example:

VERSION=main
uv tool install git+https://github.com/element-hq/ess-helm.git@$VERSION#subdirectory=tests
    Updated https://github.com/element-hq/ess-helm.git (d6d33a7f7051a0b6bbdcc609a059ae328feee269)
      Built ess-community-integration-tests @ git+https://github.com/element-hq/ess-helm.git@d6d33a7f7051a0b6bbdcc609a059ae328feee269#subdirectory=tests
...
Installed 3 executables: collect-ess-logs, pytest-ess, setup-ess-cluster

Usage

Setting Up a Cluster

To set up a Kubernetes cluster for testing, use the setup-ess-cluster command:

setup-ess-cluster

Running Tests

To run tests, use the run-tests command:

pytest-ess --test-suite <test-suite-name> [options]

Options

  • --test-suite: Name of the test suite to run. Available test suites are defined in the env directory as .rc files.
  • --pull-chart: Pull the Helm chart for testing.
  • --chart-version: Specify the chart version to pull. If not provided, the version is inferred from the package version.
  • --keep: Keep the Kubernetes cluster after tests complete.
  • --additional-test-values-file: Path to an additional values file for custom test configurations.

Test Suites

Test suites are defined in the env directory as .rc files. Each file corresponds to a different test environment configuration.