Pytest helpers for testing projects using Meilisearch
Project description
pytest-meilisearch
pytest helpers for testing Python projects using Meilisearch.
Installation
Using a virtual environment is recommended for installing this package. Once the virtual environment is created and activated, install the package with:
pip install pytest-meilisearch
Usage
Note that to use any of the async options you also need to install an async test helper such as pytest-asyncio.
Configuration
Flags
--meilisearch-host
: Host where the Meilisearch test server is running. For examplehttp://localhost
. Default =http://127.0.0.1
(This is the same ashttp://localhost
).--meilisearch-port
: Port where the Meilisearch test server is running. For example7700
. Default =7700
.--meilisearch-master-key
: The master key for the Meilisearch test server. Default =None
.
Settings
meilisearch_client_scope
: Modify the scope of the async_meilisearch_client and meilisearch_client fixtures. Valid settings arefunction
,module
,package
, orsession
. Default =function
.meilisearch_clear
: Controls if either documents or indexes are deleted after each tests. This can be useful to ensure that tests don't interfer with each other. Valid options arenone
= documents and indexes are not deleted,async_document
= documents are asyncronously deleted after each test,async_index
= indexes are asyncronously deleted after each test,document
= documents are syncronously deleted after each test, orindex
= indexes are syncronously deleted between each test. Default =none
.
Examples
-
Testing that your function that adds documents to an index is successful:
-
async:
async def test_my_func(async_meilisearch_client): docs = [ {"id": 1, "title": "Ready Player One"}, {"id": 2, "title": "The Hitchhiker's Guide to the Galaxy"}, ] index_name = "books" await my_func(index_name, docs) index = async_meilisearch_client.index(index_name) result = await index.get_documents() assert result.results == docs
-
sync:
def test_my_func(meilisearch_client): docs = [ {"id": 1, "title": "Ready Player One"}, {"id": 2, "title": "The Hitchhiker's Guide to the Galaxy"}, ] index_name = "books" my_func(index_name, docs) index = meilisearch_client.index(index_name) result = index.get_documents() assert result.results == docs
-
-
Testing that your search is successful:
-
async:
async def test_my_func(async_index_with_documents): docs = [ {"id": 1, "title": "Ready Player One"}, {"id": 2, "title": "The Hitchhiker's Guide to the Galaxy"}, ] index_name = "books" index = await async_index_with_documents(docs, index_name) results = await my_func("Ready Player One") expected = "Ready Player One" # Whatever you expect to be returned assert result == expected
-
sync:
def test_my_func(index_with_documents): docs = [ {"id": 1, "title": "Ready Player One"}, {"id": 2, "title": "The Hitchhiker's Guide to the Galaxy"}, ] index_name = "books" index = index_with_documents(docs, index_name) results = my_func("Ready Player One") expected = "Ready Player One" # Whatever you expect to be returned assert result == expected
-
Contributing
If you are interested in contributing to this project please see our contributing guide.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pytest_meilisearch-0.6.0.tar.gz
(40.2 kB
view hashes)
Built Distribution
Close
Hashes for pytest_meilisearch-0.6.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5406afba7df29b51e1f678417f719425912c765ac218005b5039a3c6c5dafe5d |
|
MD5 | abd69e31a216739a1f4fbc78c1243471 |
|
BLAKE2b-256 | 20a240c3b8a6a82f38855b8fab0ca0065a758f3255ca4aed779a00b368ef6eb3 |