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.11.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.11.0-py3-none-any.whl (20.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: es_client-8.11.0.tar.gz
  • Upload date:
  • Size: 18.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.12.0

File hashes

Hashes for es_client-8.11.0.tar.gz
Algorithm Hash digest
SHA256 1399c509d5d164710d6596e4817bbf06567d26e8cfaf84f9fb3ae8a4d631da6a
MD5 e9d01ebb09ec0c3e4daf1cd76034c077
BLAKE2b-256 98ed1c49af5722ee06f8286ee6e8df3951b8104e2c11d3d627c918bb841c8271

See more details on using hashes here.

File details

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

File metadata

  • Download URL: es_client-8.11.0-py3-none-any.whl
  • Upload date:
  • Size: 20.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.12.0

File hashes

Hashes for es_client-8.11.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4c2b23bd730d33c3545d88569de2922d959b327662bc0fbf639a13f99efc0f5a
MD5 84b953f26dfe2fe49bb5c412333c0fda
BLAKE2b-256 c25ff63f00b81b332f838c141ebee6a0781e414809999a44e8d7758eb5320530

See more details on using hashes here.

Release history Release notifications | RSS feed

9.0.1

2 files

9.0.0

2 files

8.19.5

2 files

8.19.4

2 files

8.19.3

2 files

8.19.2

2 files

8.18.2

2 files

8.18.1

2 files

8.18.0

2 files

8.17.5

2 files

8.17.4

2 files

8.17.3

2 files

8.17.2

2 files

8.17.1

2 files

8.15.2

2 files

8.15.1

2 files

8.15.0

2 files

8.14.2

2 files

8.14.1

2 files

8.14.0

2 files

8.13.5

2 files

8.13.4

2 files

8.13.3

2 files

8.13.2

2 files

8.13.1

2 files

8.13.0

2 files

8.12.9

2 files

8.12.8

2 files

8.12.6

2 files

8.12.5

2 files

8.12.4

2 files

8.12.3

2 files

8.12.2

2 files

8.12.1

2 files

8.12.0

2 files

This release

8.11.0 This release

2 files

8.10.3

2 files

8.10.2

2 files

8.10.1

2 files

8.10.0

2 files

8.9.0

2 files

8.8.2.post1

2 files

8.8.2

2 files

8.7.0

2 files

8.6.2.post1

2 files

8.6.2

2 files

8.6.1.post1

2 files

8.6.1

2 files

8.6.0.post6

2 files

8.6.0.post5

2 files

8.6.0.post4

2 files

8.6.0.post3

1 file

8.6.0.post2

1 file

8.6.0.post1

1 file

8.6.0

1 file

8.5.0

1 file

8.1.0

1 file

8.0.5

1 file

8.0.4

1 file

8.0.3

1 file

8.0.2

1 file

8.0.1

1 file

8.0.0

1 file

1.1.1

2 files

1.1.0

2 files

1.0.1

1 file

1.0.0

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page