Prepare for release 7.17.0

Author: sethmlarson

Diff for: docs/guide/release-notes/7-16-0.asciidoc

@@ -0,0 +1,20 @@
+[[release-notes-7-16-0]]
+=== 7.16.0 Release Notes
+
+[discrete]
+==== General
+
+- Deprecated support for Python 2.7, 3.4, and 3.5. Support will be removed in v8.0.0.
+- Updated APIs to the 7.16 specification
+
+[discrete]
+==== App Search
+
+- Added the `get_adaptive_relevance_settings`, `put_adaptive_relevance_settings`, `get_adaptive_relevance_suggestions`, `list_adaptive_relevance_suggestions`, `put_adaptive_relevance_suggestions`
+- Fixed the pagination parameters for `list_crawler_crawl_requests` and `list_crawler_process_crawls` APIs to `current_page` and `page_size`, were previously `limit`.
+
+
+[discrete]
+==== Workplace Search
+
+- Added the `list_documents` API

Diff for: docs/guide/release-notes/7-17-0.asciidoc

@@ -0,0 +1,12 @@
+[[release-notes-7-17-0]]
+=== 7.17.0 Release Notes
+
+[discrete]
+==== General
+
+- Updated APIs to the 7.17 specification
+
+[discrete]
+==== App Search
+
+- Added the `current_page` and `page_size` parameters to the `list_crawler_crawl_requests` and `list_crawler_process_crawls` APIs

Diff for: docs/guide/release-notes/index.asciidoc

@@ -4,13 +4,17 @@
 [discrete]
 === 7.x
 
-* <<release-notes-7-14-0, 7.15.0 Release Notes>>
+* <<release-notes-7-16-0, 7.17.0 Release Notes>>
+* <<release-notes-7-16-0, 7.16.0 Release Notes>>
+* <<release-notes-7-15-0, 7.15.0 Release Notes>>
 * <<release-notes-7-14-0, 7.14.0 Release Notes>>
 * <<release-notes-7-13-0, 7.13.0 Release Notes>>
 * <<release-notes-7-12-0, 7.12.0 Release Notes>>
 * <<release-notes-7-11-0, 7.11.0 Release Notes>>
 * <<release-notes-7-10-0, 7.10.0-beta1 Release Notes>>
 
+include::7-17-0.asciidoc[]
+include::7-16-0.asciidoc[]
 include::7-15-0.asciidoc[]
 include::7-14-0.asciidoc[]
 include::7-13-0.asciidoc[]

Diff for: elastic_enterprise_search/client/_app_search.py

@@ -40,7 +40,7 @@ def get_health(
         Get information on the health of a deployment and basic statistics around
         resource usage
 
-        `<https://www.elastic.co/guide/en/enterprise-search/7.16/monitoring-apis.html#health-api-example>`_
+        `<https://www.elastic.co/guide/en/enterprise-search/7.17/monitoring-apis.html#health-api-example>`_
 
         :arg params: Additional query params to send with the request
         :arg headers: Additional headers to send with the request
@@ -74,7 +74,7 @@ def get_read_only(
         """
         Get the read-only flag's state
 
-        `<https://www.elastic.co/guide/en/enterprise-search/7.16/read-only-api.html#getting-read-only-state>`_
+        `<https://www.elastic.co/guide/en/enterprise-search/7.17/read-only-api.html#getting-read-only-state>`_
 
         :arg params: Additional query params to send with the request
         :arg headers: Additional headers to send with the request
@@ -109,7 +109,7 @@ def put_read_only(
         """
         Update the read-only flag's state
 
-        `<https://www.elastic.co/guide/en/enterprise-search/7.16/read-only-api.html#setting-read-only-state>`_
+        `<https://www.elastic.co/guide/en/enterprise-search/7.17/read-only-api.html#setting-read-only-state>`_
 
         :arg body: HTTP request body
         :arg params: Additional query params to send with the request
@@ -147,7 +147,7 @@ def get_stats(
         Get information about the resource usage of the application, the state of
         different internal queues, etc.
 
-        `<https://www.elastic.co/guide/en/enterprise-search/7.16/monitoring-apis.html#stats-api-example>`_
+        `<https://www.elastic.co/guide/en/enterprise-search/7.17/monitoring-apis.html#stats-api-example>`_
 
         :arg include: Comma-separated list of stats to return
         :arg params: Additional query params to send with the request
@@ -184,7 +184,7 @@ def get_version(
         """
         Get version information for this server
 
-        `<https://www.elastic.co/guide/en/enterprise-search/7.16/management-apis.html>`_
+        `<https://www.elastic.co/guide/en/enterprise-search/7.17/management-apis.html>`_
 
         :arg params: Additional query params to send with the request
         :arg headers: Additional headers to send with the request

Diff for: elastic_enterprise_search/client/_enterprise_search.py

@@ -78,7 +78,7 @@ def get_auto_query_refinement_details(
         """
         Retrieves a content source's automatic query refinement details
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-content-sources-api.html#get-automatic-query-refinement-details-api>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-content-sources-api.html#get-automatic-query-refinement-details-api>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -221,7 +221,7 @@ def create_content_source(
         """
         Create a content source
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-content-sources-api.html#create-content-source-api>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-content-sources-api.html#create-content-source-api>`_
 
         :arg body: HTTP request body
         :arg params: Additional query params to send with the request
@@ -260,7 +260,7 @@ def delete_content_source(
         """
         Deletes a content source by ID
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-content-sources-api.html#remove-content-source-api>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-content-sources-api.html#remove-content-source-api>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -307,7 +307,7 @@ def get_content_source(
         """
         Retrieves a content source by ID
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-content-sources-api.html#get-content-source-api>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-content-sources-api.html#get-content-source-api>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -354,7 +354,7 @@ def put_content_source_icons(
         """
         Upload content source icons
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-content-sources-api.html#upload-content-source-icon-api>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-content-sources-api.html#upload-content-source-icon-api>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -405,7 +405,7 @@ def put_content_source(
         """
         Update a content source
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-content-sources-api.html#update-content-source-api>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-content-sources-api.html#update-content-source-api>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -455,7 +455,7 @@ def list_content_sources(
         """
         Retrieves all content sources
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-content-sources-api.html#list-content-sources-api>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-content-sources-api.html#list-content-sources-api>`_
 
         :arg current_page: Which page of results to request
         :arg page_size: The number of results to return in a page
@@ -538,7 +538,7 @@ def get_document(
         """
         Retrieves a document by ID from the specified content source
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-content-sources-api.html#get-document-by-id-api>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-content-sources-api.html#get-document-by-id-api>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -593,7 +593,7 @@ def delete_documents_by_query(
         """
         Deletes documents by query in a custom content source
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-custom-sources-api.html#delete-documents-by-query>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-custom-sources-api.html#delete-documents-by-query>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -644,7 +644,7 @@ def delete_documents(
         """
         Deletes a list of documents from a custom content source
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-custom-sources-api.html#delete-by-id>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-custom-sources-api.html#delete-by-id>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -698,7 +698,7 @@ def index_documents(
         Indexes one or more new documents into a custom content source, or updates one
         or more existing documents
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-custom-sources-api.html#index-and-update>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-custom-sources-api.html#index-and-update>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -751,7 +751,7 @@ def list_documents(
         """
         Lists documents from a custom content source
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-custom-sources-api.html#list-documents>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-custom-sources-api.html#list-documents>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -802,7 +802,7 @@ def list_external_identities(
         """
         Retrieves all external identities
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-external-identities-api.html#list-external-identities>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-external-identities-api.html#list-external-identities>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -856,7 +856,7 @@ def create_external_identity(
         """
         Adds a new external identity
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-external-identities-api.html#add-external-identity>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-external-identities-api.html#add-external-identity>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -907,7 +907,7 @@ def delete_external_identity(
         """
         Deletes an external identity
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-external-identities-api.html#remove-external-identity>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-external-identities-api.html#remove-external-identity>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -961,7 +961,7 @@ def get_external_identity(
         """
         Retrieves an external identity
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-external-identities-api.html#show-external-identity>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-external-identities-api.html#show-external-identity>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -1016,7 +1016,7 @@ def put_external_identity(
         """
         Updates an external identity
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-external-identities-api.html#update-external-identity>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-external-identities-api.html#update-external-identity>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -1074,7 +1074,7 @@ def list_permissions(
         """
         Lists all permissions for all users
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-document-permissions-api.html#list>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-document-permissions-api.html#list>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -1131,7 +1131,7 @@ def remove_user_permissions(
         """
         Removes one or more permissions from an existing set of permissions
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-document-permissions-api.html#remove-one>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-document-permissions-api.html#remove-one>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -1189,7 +1189,7 @@ def search(
         """
         Search across available sources with various query tuning options
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-search-api.html>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-search-api.html>`_
 
         :arg body: HTTP request body
         :arg params: Additional query params to send with the request
@@ -1477,7 +1477,7 @@ def add_user_permissions(
         """
         Adds one or more new permissions atop existing permissions
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-document-permissions-api.html#add-one>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-document-permissions-api.html#add-one>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -1536,7 +1536,7 @@ def get_user_permissions(
         """
         Lists all permissions for one user
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-document-permissions-api.html#list-one>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-document-permissions-api.html#list-one>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source
@@ -1592,7 +1592,7 @@ def put_user_permissions(
         """
         Creates a new set of permissions or over-writes all existing permissions
 
-        `<https://www.elastic.co/guide/en/workplace-search/7.16/workplace-search-document-permissions-api.html#add-all>`_
+        `<https://www.elastic.co/guide/en/workplace-search/7.17/workplace-search-document-permissions-api.html#add-all>`_
 
         :arg content_source_id: Unique ID for a Custom API source, provided upon
             creation of a Custom API Source

Diff for: elastic_enterprise_search/client/_workplace_search.py

@@ -30,7 +30,7 @@
 
 @nox.session()
 def format(session):
-    session.install("black", "isort")
+    session.run("python", "-m", "pip", "install", "--pre", "black<22", "isort")
     session.run(
         "black", "--target-version=py27", "--target-version=py37", *SOURCE_FILES
     )
@@ -42,7 +42,9 @@ def format(session):
 
 @nox.session
 def lint(session):
-    session.install("flake8", "black", "isort")
+    session.run(
+        "python", "-m", "pip", "install", "--pre", "black<22", "isort", "flake8"
+    )
     session.run(
         "black",
         "--check",

Diff for: noxfile.py

@@ -26,7 +26,7 @@
 import urllib3
 
 http = urllib3.PoolManager()
-current_branch = "7.16"
+current_branch = "7.17"
 base_dir = pathlib.Path(__file__).absolute().parent.parent.parent
 schemas_dir = base_dir.parent / "ent-search/swagger/v1"
 templates_dir = str(pathlib.Path(__file__).absolute().parent / "templates")