About

testing.elasticsearch automatically setups a elasticsearch instance in a temporary directory, and destroys it after testing.

Install

Use pip:

$ pip install testing.elasticsearch6

And testing.elasticsearch6 requires Elasticsearch server in your PATH.

Usage

Create Elasticsearch instance using testing.elasticsearch.Elasticsearch:

import testing.elasticsearch
from sqlalchemy import create_engine

# Lanuch new Elasticsearch server
with testing.elasticsearch.Elasticsearch() as elasticsearch:
    # connect to Elasticsearch (using elasticsearch-py)
    es = Elasticsearch(**elasticsearch.dsn())

    #
    # do any tests using Elasticsearch...
    #

# Elasticsearch server is terminated here

testing.elasticsearch.Elasticsearch generates temporary config files and data directories. On deleting Elasticsearch object, it terminates Elasticsearch instance and removes temporary files and directories.

If you want a database including indexes and any fixtures for your apps, use copy_data_from keyword:

# uses a copy of specified data directory of Elasticsearch.
elasticsearch = testing.elasticsearch.Elasticsearch(copy_data_from='/path/to/your/index')

For example, you can setup new Elasticsearch server for each testcases on setUp() method:

import unittest
import testing.elasticsearch

class MyTestCase(unittest.TestCase):
    def setUp(self):
        self.elasticsearch = testing.elasticsearch.Elasticsearch()

    def tearDown(self):
        self.elasticsearch.stop()

Requirements

• Python 2.7, 3.6

License

Apache License 2.0

History

1.0.0 (2016-08-20)

• Drop python 2.6, 3.2 support
• Depend on testing.common.database >= 2.0.0
• Set booting timeout to 20sec
• Fix bugs:
  • #1: find_elasticsearch_yaml_path() does not refer elasticsearch_home argument
  • #2: Make ES_PATH absolute

0.9.1 (2016-02-04)

• Depend on testing.common.database package

0.9.0 (2015-12-13)

• First release