[v1.3] Sort facets value by alphanumerical or count order

[brunoocasali]

⚠️ This issue is generated, it means the examples and the namings do not necessarily correspond to the language of this repository.
Also, if you are a maintainer, please add any clarification and instructions about this issue.

Sorry if this is already wholly/partially implemented. Feel free to let me know about the state of this issue in the repo.

Related to meilisearch/integration-guides#280

---

This issue is divided into two sections, first, you need to make the implementation, and second, you must update the code-samples (no one likes outdated docs, right?).

New implementation

Related to:

• issue: Sort facets value by alphanumerical or count order meilisearch#3612
• discussion: Retrieve facet values sorted by the number of corresponding documents product#519 (comment)
• spec: Faceting Setting API - sortFacetValuesBy  specifications#247

Adds the ability to sort facets by their value which could be by using alpha or count.

Ensure the SDKs can handle the new index faceting configuration attribute sortFacetValuesBy. This enum could only take count or alpha.

The faceting configuration now have two attributes:

maxValuesPerFacet: integer
sortFacetValuesBy: object 
  index_name: alpha|count
  *: alpha|count // when should be applied to all indexes

Code samples

Inside of this file: .code-samples.meilisearch.yml:

1. Create a new entry with this key facet_search_2 containing a call to the updateFaceting settings method.
   With this value: "sortFacetValuesBy":{"genres": "count"}

Use this as a reference if the previous description was not helpful:

facet_search_2: |-
  PATCH 'http://localhost:7700/indexes/books/settings/faceting' 
  with data: {
    "sortFacetValuesBy": {
      "genres": "count"
    }
  }

2. Update getting_started_faceting key to contain the new behavior sortFacetValuesBy

getting_started_faceting: |-
  PATCH 'http://localhost:7700/indexes/movies/settings/faceting' 
  with data: {
    "maxValuesPerFacet": 2,
    "sortFacetValuesBy": {
      "*": "count"
    }
  }

3. Update update_faceting_settings_1 key to contain the new behavior sortFacetValuesBy

update_faceting_settings_1: |-
  PATCH 'http://localhost:7700/indexes/books/settings/faceting' 
  with data: {
    "maxValuesPerFacet": 2,
    "sortFacetValuesBy": {
      "*": "alpha",
      "genres": "count"
    }
  }

TODO:

• Add the ability receive a new param in the updateFaceting settings method called sortFacetValuesBy.
• Update the code-samples accordingly
• Add integration tests

[curquiza]

@brunoocasali @sanders41
Let me know if I'm wrong, but the SDK is already compatible because not strongly typed and thanks to the update_faceting_settings method

meilisearch-python/meilisearch/index.py

Line 1538 in a4b6513

def update_faceting_settings(self, body: Union[Dict[str, Any], None]) -> TaskInfo:

We only need to update the code samples right?

[sanders41]

Updating the setting will work, but the Facet model needs to be updated to include the new value. Right now get_facetting_settings won't error, but it also won't contain the sort settings.

meilisearch-python/meilisearch/models/index.py

Lines 30 to 31 in a4b6513

	class Faceting(CamelBase):
	max_values_per_facet: int

[curquiza]

I updated code samples in this PR: #847