Skip to main content

https://es-client.readthedocs.io/

You may wonder why this even exists, as at first glance it doesn’t seem to make anything any easier than just using the elasticsearch8 Python module to build a client connection. I needed to be able to reuse the more complex schema validation bits I was employing, namely:

  • master_only detection

  • Elasticsearch version checking and validation, and the option to skip this.

  • Configuration value validation, including file paths for SSL certificates, meaning:

    • No unknown keys or unacceptable parameter values are accepted

    • Acceptable values and ranges are established (where known)–and easy to amend, if necessary.

So, if you don’t need these, then this library probably isn’t what you’re looking for. If you want these features, then you’ve come to the right place.

Example Usage

from es_client import Builder

config = {
    'elasticsearch': {
        'client': {
            'hosts': 'https://10.0.0.123:9200',
            'ca_certs': '/etc/elasticsearch/certs/ca.crt',
            'request_timeout': 60,
        },
        'other_settings': {
            'master_only': false,
            'username': 'joe_user',
            'password': 'password',
        }
    }
}

builder = Builder(configdict=config)

try:
    builder.connect()
except:
    # Do exception handling here...

client = builder.client

Additionally, you can read from a YAML configuration file:

---
elasticsearch:
  client:
    hosts: https://10.0.0.123:9200
    ca_certs: /etc/elasticsearch/certs/ca.crt
    request_timeout: 60
  other_settings:
    master_only: false
    username: joe_user
    password: password
from es_client import Builder

builder = Builder(configfile='/path/to/es_client.yml')

try:
    builder.connect()
except:
    # Do exception handling here...

client = builder.client

The same schema validations apply here as well.

Download files

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

Source Distribution

es_client-8.7.0.tar.gz (18.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

es_client-8.7.0-py3-none-any.whl (19.1 kB view details)

Uploaded Python 3

File details

Details for the file es_client-8.7.0.tar.gz.

File metadata

  • Download URL: es_client-8.7.0.tar.gz
  • Upload date:
  • Size: 18.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.24.0

File hashes

Hashes for es_client-8.7.0.tar.gz
Algorithm Hash digest
SHA256 bb9a64cb6507f13389185e6da83df95bf3ee37b4380feb6433f1d95c6c9da96d
MD5 e7755ceb996084c2034234c8c78b9c4c
BLAKE2b-256 11da9045c8ed43cc829cd1b2a3bebfdd47237d53bac037d88ce3f6a07064182e

See more details on using hashes here.

File details

Details for the file es_client-8.7.0-py3-none-any.whl.

File metadata

  • Download URL: es_client-8.7.0-py3-none-any.whl
  • Upload date:
  • Size: 19.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.24.0

File hashes

Hashes for es_client-8.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fa68cba6f4cfc73b110875bc0c41860f2298a009bdc324b7806693e2a9e68327
MD5 54196846afcbf3f48e6f6b7d523b0642
BLAKE2b-256 44b7653718c5c2d6304af4683195f2c24095534905a775088df603c432195b46

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page