def prepare_es():
"""
Prepare the ES index so we only have to manage indexing and searches in our
actual tests.
"""
# Delete any existing indices so we get a clean slate
ES_INDICES_CLIENT.delete(index="_all")
# Create the indices we'll use to test the ES features
for index in [
"richie_categories",
"richie_courses",
"richie_persons",
"richie_organizations",
]:
ES_INDICES_CLIENT.create(index=index)
ES_INDICES_CLIENT.close(index=index)
ES_INDICES_CLIENT.put_settings(body=ANALYSIS_SETTINGS, index=index)
ES_INDICES_CLIENT.open(index=index)
# Use the default courses mapping from the Indexer
ES_INDICES_CLIENT.put_mapping(body=CoursesIndexer.mapping,
index="richie_courses")
# Add the sorting script
ES_CLIENT.put_script(id="score", body=CoursesIndexer.scripts["score"])
ES_CLIENT.put_script(id="state_field",
body=CoursesIndexer.scripts["state_field"])
def test_partial_mappings_french_diacritics(self):
"""
Make sure words ending in "icité" are analyzed the same way whether or not there
is an accent.
"""
index_name = "stub_index"
mapping = {"dynamic_templates": MULTILINGUAL_TEXT}
# Create the index and set a mapping that includes the pattern we want to test
ES_INDICES_CLIENT.create(index=index_name)
ES_INDICES_CLIENT.put_mapping(index=index_name, body=mapping)
# The index needs to be closed before we set an analyzer
ES_INDICES_CLIENT.close(index=index_name)
ES_INDICES_CLIENT.put_settings(body=ANALYSIS_SETTINGS,
index=index_name)
ES_INDICES_CLIENT.open(index=index_name)
self.assertEqual(
ES_INDICES_CLIENT.analyze(
body='{"analyzer": "french", "text": "électricité"}',
index=index_name)["tokens"][0]["token"],
"electricit",
)
self.assertEqual(
ES_INDICES_CLIENT.analyze(
body='{"analyzer": "french", "text": "electricite"}',
index=index_name)["tokens"][0]["token"],
"electricit",
)
def prepare_index(self, courses, organizations=None):
"""
Not a test.
This method is doing the heavy lifting for the tests in this class:
preparing the Elasticsearch index so that individual tests just have to execute
the query.
"""
organizations = organizations or []
self.create_filter_pages()
# Delete any existing indices so we get a clean slate
ES_INDICES_CLIENT.delete(index="_all")
# Create an index for our organizations
ES_INDICES_CLIENT.create(index="richie_organizations")
ES_INDICES_CLIENT.close(index="richie_organizations")
ES_INDICES_CLIENT.put_settings(body=ANALYSIS_SETTINGS,
index="richie_organizations")
ES_INDICES_CLIENT.open(index="richie_organizations")
# Use the default organizations mapping from the Indexer
ES_INDICES_CLIENT.put_mapping(body=OrganizationsIndexer.mapping,
index="richie_organizations")
# Set up empty indices for categories & persons. They need to exist to avoid errors
# but we do not use results from them in our tests.
ES_INDICES_CLIENT.create(index="richie_categories")
ES_INDICES_CLIENT.create(index="richie_persons")
# Create an index we'll use to test the ES features
ES_INDICES_CLIENT.create(index="test_courses")
ES_INDICES_CLIENT.close(index="test_courses")
ES_INDICES_CLIENT.put_settings(body=ANALYSIS_SETTINGS,
index="test_courses")
ES_INDICES_CLIENT.open(index="test_courses")
# Use the default courses mapping from the Indexer
ES_INDICES_CLIENT.put_mapping(body=CoursesIndexer.mapping,
index="test_courses")
# Add the sorting script
ES_CLIENT.put_script(id="score", body=CoursesIndexer.scripts["score"])
ES_CLIENT.put_script(id="state_field",
body=CoursesIndexer.scripts["state_field"])
# Prepare actions to insert our courses and organizations in their indices
actions = [
OrganizationsIndexer.get_es_document_for_organization(
organization.public_extension)
for organization in organizations
] + [{
"_id": course["id"],
"_index": "test_courses",
"_op_type": "create",
**course,
} for course in courses]
bulk_compat(actions=actions, chunk_size=500, client=ES_CLIENT)
ES_INDICES_CLIENT.refresh()
def execute_query(self, courses, querystring="", **extra):
"""
Not a test.
Prepare the ElasticSearch index and execute the query in it.
"""
# Delete any existing indices so we get a clean slate
ES_INDICES_CLIENT.delete(index="_all")
# Create an index we'll use to test the ES features
ES_INDICES_CLIENT.create(index=COURSES_INDEX)
# The index needs to be closed before we set an analyzer
ES_INDICES_CLIENT.close(index=COURSES_INDEX)
ES_INDICES_CLIENT.put_settings(body=ANALYSIS_SETTINGS, index=COURSES_INDEX)
ES_INDICES_CLIENT.open(index=COURSES_INDEX)
# Use the default courses mapping from the Indexer
ES_INDICES_CLIENT.put_mapping(body=CoursesIndexer.mapping, index=COURSES_INDEX)
# Add the sorting script
ES_CLIENT.put_script(id="score", body=CoursesIndexer.scripts["score"])
ES_CLIENT.put_script(
id="state_field", body=CoursesIndexer.scripts["state_field"]
)
# Actually insert our courses in the index
actions = [
{
"_id": course["id"],
"_index": COURSES_INDEX,
"_op_type": "create",
"absolute_url": {"en": "en/url", "fr": "fr/url"},
"categories": ["1", "2", "3"],
"cover_image": {"en": "en/image", "fr": "fr/image"},
"is_meta": False,
"logo": {"en": "/en/some/img.png", "fr": "/fr/some/img.png"},
"nb_children": 0,
"organizations": ["11", "12", "13"],
**course,
}
for course in courses
]
bulk_compat(actions=actions, chunk_size=500, client=ES_CLIENT)
ES_INDICES_CLIENT.refresh()
results = self.client.get(
f"/api/v1.0/courses/autocomplete/?{querystring:s}", **extra
)
self.assertEqual(results.status_code, 200)
return json.loads(results.content)
def execute_query(self, kind, categories=None, querystring=""):
"""
Not a test.
This method is doing the heavy lifting for the tests in this class: create and fill the
index with our categories so we can run our queries and check the results.
It also executes the query and returns the result from the API.
"""
# Delete any existing indices so we get a clean slate
ES_INDICES_CLIENT.delete(index="_all")
# Create an index we'll use to test the ES features
ES_INDICES_CLIENT.create(index="test_categories")
ES_INDICES_CLIENT.close(index="test_categories")
ES_INDICES_CLIENT.put_settings(body=ANALYSIS_SETTINGS,
index="test_categories")
ES_INDICES_CLIENT.open(index="test_categories")
# Use the default categories mapping from the Indexer
ES_INDICES_CLIENT.put_mapping(body=CategoriesIndexer.mapping,
index="test_categories")
# Actually insert our categories in the index
actions = [{
"_id": category["id"],
"_index": "test_categories",
"_op_type": "create",
"absolute_url": {
"en": "en/url"
},
"description": {
"en": "en/description"
},
"icon": {
"en": "en/icon"
},
"is_meta": False,
"logo": {
"en": "en/logo"
},
"nb_children": 0,
"path": category["id"],
"title_raw": category["title"],
**category,
} for category in categories or CATEGORIES]
bulk_compat(actions=actions, chunk_size=500, client=ES_CLIENT)
ES_INDICES_CLIENT.refresh()
response = self.client.get(f"/api/v1.0/{kind:s}/?{querystring:s}")
self.assertEqual(response.status_code, 200)
return json.loads(response.content)
def execute_query(self, querystring="", **extra):
"""
Not a test.
Prepare the ElasticSearch index and execute the query in it.
"""
licences = [
{"id": "1", "title": {"en": "CC-BY-SA"}},
{"id": "2", "title": {"en": "CC-BY-NC"}},
{"id": "3", "title": {"en": "All Rights Résërvés"}},
]
# Delete any existing indices so we get a clean slate
ES_INDICES_CLIENT.delete(index="_all")
# Create an index we'll use to test the ES features
ES_INDICES_CLIENT.create(index=LICENCES_INDEX)
# The index needs to be closed before we set an analyzer
ES_INDICES_CLIENT.close(index=LICENCES_INDEX)
ES_INDICES_CLIENT.put_settings(body=ANALYSIS_SETTINGS, index=LICENCES_INDEX)
ES_INDICES_CLIENT.open(index=LICENCES_INDEX)
# Use the default licences mapping from the Indexer
ES_INDICES_CLIENT.put_mapping(
body=LicencesIndexer.mapping, index=LICENCES_INDEX
)
# Actually insert our licences in the index
actions = [
{
"_id": licence["id"],
"_index": LICENCES_INDEX,
"_op_type": "create",
"complete": {"en": slice_string_for_completion(licence["title"]["en"])},
**licence,
}
for licence in licences
]
bulk_compat(actions=actions, chunk_size=500, client=ES_CLIENT)
ES_INDICES_CLIENT.refresh()
response = self.client.get(
f"/api/v1.0/licences/autocomplete/?{querystring:s}", **extra
)
self.assertEqual(response.status_code, 200)
return licences, json.loads(response.content)
def execute_query(self, persons=None, querystring=""):
"""
Not a test.
This method is doing the heavy lifting for the tests in this class: create and fill the
index with our persons so we can run our queries and check the results.
It also executes the query and returns the result from the API.
"""
# Delete any existing indices so we get a clean slate
ES_INDICES_CLIENT.delete(index="_all")
# Create an index we'll use to test the ES features
ES_INDICES_CLIENT.create(index="test_persons")
ES_INDICES_CLIENT.close(index="test_persons")
ES_INDICES_CLIENT.put_settings(body=ANALYSIS_SETTINGS,
index="test_persons")
ES_INDICES_CLIENT.open(index="test_persons")
# Use the default persons mapping from the Indexer
ES_INDICES_CLIENT.put_mapping(body=PersonsIndexer.mapping,
index="test_persons")
# Actually insert our persons in the index
actions = [{
"_id": person["id"],
"_index": "test_persons",
"_op_type": "create",
"absolute_url": {
"en": "en/url"
},
"bio": {
"en": "en/bio"
},
"portrait": {
"en": "en/image"
},
"title_raw": person["title"],
**person,
} for person in persons or PERSONS]
bulk_compat(actions=actions, chunk_size=500, client=ES_CLIENT)
ES_INDICES_CLIENT.refresh()
response = self.client.get(f"/api/v1.0/persons/?{querystring:s}")
self.assertEqual(response.status_code, 200)
return json.loads(response.content)
def test_partial_mappings_code(self):
"""Make sure our code analyzer works as expected."""
index_name = "stub_index"
# Create the index and set a mapping that includes the pattern we want to test
ES_INDICES_CLIENT.create(index=index_name)
# The index needs to be closed before we set an analyzer
ES_INDICES_CLIENT.close(index=index_name)
ES_INDICES_CLIENT.put_settings(body=ANALYSIS_SETTINGS,
index=index_name)
ES_INDICES_CLIENT.open(index=index_name)
self.assertEqual(
[
t["token"] for t in ES_INDICES_CLIENT.analyze(
body='{"analyzer": "code_trigram", "text": "003rst"}',
index=index_name,
)["tokens"]
],
[
"003",
"003r",
"003rs",
"003rst",
"03r",
"03rs",
"03rst",
"3rs",
"3rst",
"rst",
],
)
self.assertEqual(
[
t["token"] for t in ES_INDICES_CLIENT.analyze(
body='{"analyzer": "code", "text": "003rst"}',
index=index_name)["tokens"]
],
["003rst"],
)
def execute_query(self, querystring="", **extra):
"""
Not a test.
Prepare the ElasticSearch index and execute the query in it.
"""
persons = [
{
"complete": {
"en": slice_string_for_completion("Éponine Thénardier")
},
"id": "25",
"title": {
"en": "Éponine Thénardier"
},
},
{
"complete": {
"en":
slice_string_for_completion("Monseigneur Bienvenu Myriel")
},
"id": "34",
"title": {
"en": "Monseigneur Bienvenu Myriel"
},
},
{
"complete": {
"en": slice_string_for_completion("Fantine")
},
"id": "52",
"title": {
"en": "Fantine"
},
},
]
# Delete any existing indices so we get a clean slate
ES_INDICES_CLIENT.delete(index="_all")
# Create an index we'll use to test the ES features
ES_INDICES_CLIENT.create(index=PERSONS_INDEX)
# The index needs to be closed before we set an analyzer
ES_INDICES_CLIENT.close(index=PERSONS_INDEX)
ES_INDICES_CLIENT.put_settings(body=ANALYSIS_SETTINGS,
index=PERSONS_INDEX)
ES_INDICES_CLIENT.open(index=PERSONS_INDEX)
# Use the default persons mapping from the Indexer
ES_INDICES_CLIENT.put_mapping(body=PersonsIndexer.mapping,
index=PERSONS_INDEX)
# Actually insert our persons in the index
actions = [{
"_id": person["id"],
"_index": PERSONS_INDEX,
"_op_type": "create",
"absolute_url": {
"en": "url"
},
"logo": {
"en": "/some/img.png"
},
**person,
} for person in persons]
bulk_compat(actions=actions, chunk_size=500, client=ES_CLIENT)
ES_INDICES_CLIENT.refresh()
response = self.client.get(
f"/api/v1.0/persons/autocomplete/?{querystring:s}", **extra)
self.assertEqual(response.status_code, 200)
return persons, json.loads(response.content)
def execute_query(self, querystring="", **extra):
"""
Not a test.
Prepare the ElasticSearch index and execute the query in it.
"""
categories = [
{
"complete": {
"en": slice_string_for_completion("Electric Birdwatching"),
"fr": slice_string_for_completion(
"Observation des oiseaux électriques"
),
},
"id": "24",
"kind": "subjects",
"path": "001000",
"title": {
"en": "Electric Birdwatching",
"fr": "Observation des oiseaux électriques",
},
},
{
"complete": {
"en": slice_string_for_completion("Ocean biking"),
"fr": slice_string_for_completion("Cyclisme océanique"),
},
"id": "33",
"kind": "subjects",
"path": "001001",
"title": {"en": "Ocean biking", "fr": "Cyclisme océanique"},
},
{
"complete": {
"en": slice_string_for_completion("Elegiac bikeshedding"),
"fr": slice_string_for_completion("Élégie de l'abri à vélos"),
},
"id": "51",
"kind": "subjects",
"path": "001002",
"title": {
"en": "Elegiac bikeshedding",
"fr": "Élégie de l'abri à vélos",
},
},
{
"complete": {
"en": slice_string_for_completion("Electric Decoys"),
"fr": slice_string_for_completion("Leurres électriques"),
},
"id": "44",
"kind": "not_subjects",
"path": "001003",
"title": {"en": "Electric Decoys", "fr": "Leurres électriques"},
},
]
# Delete any existing indices so we get a clean slate
ES_INDICES_CLIENT.delete(index="_all")
# Create an index we'll use to test the ES features
ES_INDICES_CLIENT.create(index=CATEGORIES_INDEX)
# The index needs to be closed before we set an analyzer
ES_INDICES_CLIENT.close(index=CATEGORIES_INDEX)
ES_INDICES_CLIENT.put_settings(body=ANALYSIS_SETTINGS, index=CATEGORIES_INDEX)
ES_INDICES_CLIENT.open(index=CATEGORIES_INDEX)
# Use the default categories mapping from the Indexer
ES_INDICES_CLIENT.put_mapping(
body=CategoriesIndexer.mapping, index=CATEGORIES_INDEX
)
# Actually insert our categories in the index
actions = [
{
"_id": category["id"],
"_index": CATEGORIES_INDEX,
"_op_type": "create",
"absolute_url": {"en": "en/url", "fr": "fr/url"},
"cover_image": {"en": "en/image", "fr": "fr/image"},
"is_meta": False,
"logo": {"en": "en/some/img.png", "fr": "fr/some/img.png"},
"nb_children": 0,
**category,
}
for category in categories
]
bulk_compat(actions=actions, chunk_size=500, client=ES_CLIENT)
ES_INDICES_CLIENT.refresh()
response = self.client.get(
f"/api/v1.0/subjects/autocomplete/?{querystring:s}", **extra
)
self.assertEqual(response.status_code, 200)
return categories, json.loads(response.content)
def test_partial_mappings_multilingual_text(self):
"""
Make sure our multilingual_text dynamic mapping results in the proper mappings being
generated when objects with the expected format are indexed
"""
index_name = "stub_index"
mapping = {"dynamic_templates": MULTILINGUAL_TEXT}
# Create the index and set a mapping that includes the pattern we want to test
ES_INDICES_CLIENT.create(index=index_name)
ES_INDICES_CLIENT.put_mapping(index=index_name, body=mapping)
# The index needs to be closed before we set an analyzer
ES_INDICES_CLIENT.close(index=index_name)
ES_INDICES_CLIENT.put_settings(body=ANALYSIS_SETTINGS,
index=index_name)
ES_INDICES_CLIENT.open(index=index_name)
# The stub mapping only contains our dynamic template
mapping = ES_INDICES_CLIENT.get_mapping(index=index_name)
self.assertEqual(
mapping[index_name]["mappings"],
{"dynamic_templates": MULTILINGUAL_TEXT},
)
# Index an object that should trigger a match for our dynamic template
ES_CLIENT.index(
index=index_name,
doc_type="_doc",
body={"title": {
"fr": "Un titre en français à titre d'exemple"
}},
)
# The stub mapping has been extended with a matching property for 'fr'
mapping = ES_INDICES_CLIENT.get_mapping(index=index_name)
self.assertEqual(
mapping[index_name]["mappings"],
{
"dynamic_templates": MULTILINGUAL_TEXT,
"properties": {
"title": {
"properties": {
"fr": {
"type": "text",
"fields": {
"language": {
"type": "text",
"analyzer": "french"
},
"trigram": {
"type": "text",
"analyzer": "french_trigram",
"search_analyzer": "french",
},
},
}
}
}
},
},
)
# Index an object that should trigger a different match for our dynamic template
ES_CLIENT.index(
index=index_name,
doc_type="_doc",
body={"title": {
"en": "An English title as an example"
}},
)
# The sub mapping has been extended with a matching property for 'en'
mapping = ES_INDICES_CLIENT.get_mapping(index=index_name)
self.assertEqual(
mapping[index_name]["mappings"],
{
"dynamic_templates": MULTILINGUAL_TEXT,
"properties": {
"title": {
"properties": {
"en": {
"type": "text",
"fields": {
"language": {
"type": "text",
"analyzer": "english"
},
"trigram": {
"type": "text",
"analyzer": "english_trigram",
"search_analyzer": "english",
},
},
},
"fr": {
"type": "text",
"fields": {
"language": {
"type": "text",
"analyzer": "french"
},
"trigram": {
"type": "text",
"analyzer": "french_trigram",
"search_analyzer": "french",
},
},
},
}
}
},
},
)