googleapis · busunkim96 · Mar 10, 2021 · Mar 9, 2021 · Mar 9, 2021 · Mar 9, 2021
diff --git a/.coveragerc b/.coveragerc
@@ -1,27 +1,11 @@
-# -*- coding: utf-8 -*-
-#
-# Copyright 2020 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-# Generated by synthtool. DO NOT EDIT!
 [run]
 branch = True
 
 [report]
 fail_under = 100
 show_missing = True
-omit = google/cloud/dialogflow/__init__.py
+omit =
+    google/cloud/dialogflow/__init__.py
 exclude_lines =
     # Re-enable the standard pragma
     pragma: NO COVER
@@ -31,4 +15,4 @@ exclude_lines =
     # This is added at the module level as a safeguard for if someone
     # generates the code and tries to run it without pip installing. This
     # makes it virtually impossible to test properly.
-    except pkg_resources.DistributionNotFound
+    except pkg_resources.DistributionNotFound
diff --git a/.kokoro/test-samples.sh b/.kokoro/test-samples.sh
@@ -87,11 +87,11 @@ for file in samples/**/requirements.txt; do
     python3.6 -m nox -s "$RUN_TESTS_SESSION"
     EXIT=$?
 
-    # If this is a periodic build, send the test log to the FlakyBot.
-    # See https://github.com/googleapis/repo-automation-bots/tree/master/packages/flakybot.
+    # If this is a periodic build, send the test log to the Build Cop Bot.
+    # See https://github.com/googleapis/repo-automation-bots/tree/master/packages/buildcop.
     if [[ $KOKORO_BUILD_ARTIFACTS_SUBDIR = *"periodic"* ]]; then
-      chmod +x $KOKORO_GFILE_DIR/linux_amd64/flakybot
-      $KOKORO_GFILE_DIR/linux_amd64/flakybot
+      chmod +x $KOKORO_GFILE_DIR/linux_amd64/buildcop
+      $KOKORO_GFILE_DIR/linux_amd64/buildcop
     fi
 
     if [[ $EXIT -ne 0 ]]; then

diff --git a/.kokoro/trampoline_v2.sh b/.kokoro/trampoline_v2.sh
@@ -159,7 +159,7 @@ if [[ -n "${KOKORO_BUILD_ID:-}" ]]; then
 	"KOKORO_GITHUB_COMMIT"
 	"KOKORO_GITHUB_PULL_REQUEST_NUMBER"
 	"KOKORO_GITHUB_PULL_REQUEST_COMMIT"
-	# For FlakyBot
+	# For Build Cop Bot
 	"KOKORO_GITHUB_COMMIT_URL"
 	"KOKORO_GITHUB_PULL_REQUEST_URL"
     )

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -2,7 +2,7 @@
 # See https://pre-commit.com/hooks.html for more hooks
 repos:
 -   repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v3.4.0
+    rev: v3.3.0
     hooks:
     -   id: trailing-whitespace
     -   id: end-of-file-fixer

diff --git a/README.rst b/README.rst
@@ -1,92 +1,49 @@
-Dialogflow: Python Client
-=========================
+Python Client for Google Cloud Dialogflow API
+=================================================
 
-|ga| |pypi| |versions| 
+Quick Start
+-----------
 
-    Python idiomatic client for `Dialogflow ES`_
+In order to use this library, you first need to go through the following steps:
 
-`Dialogflow ES`_ is an enterprise-grade NLU platform that makes it easy for
-developers to design and integrate conversational user interfaces into
-mobile apps, web applications, devices, and bots.
-
-* `Dialogflow ES Python Client API Reference <https://googleapis.dev/python/dialogflow/latest/index.html>`_
-* `Dialogflow ES Documentation <https://cloud.google.com/dialogflow/es/docs>`_
-
-Read more about the client libraries for Cloud APIs, including the older
-Google APIs Client Libraries, in
-`Client Libraries Explained <https://cloud.google.com/apis/docs/client-libraries-explained>`_.
-
-.. |ga| image:: https://img.shields.io/badge/support-ga-gold.svg
-   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#ga-support
-.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-dialogflow.svg
-   :target: https://pypi.org/project/google-cloud-dialogflow/
-.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-dialogflow.svg
-   :target: https://pypi.org/project/google-cloud-dialogflow/
-.. _Dialogflow ES: https://cloud.google.com/dialogflow/docs/
-
-
-Before you begin
-----------------
-
-#. Select or create a Cloud Platform `project`_.
-#. `Enable billing`_ for your project.
-#.  `Enable the Google Cloud Dialogflow API`_.
-#.  `Set up authentication`_ with a service account so you can access the
-    API from your local workstation.
-
-.. _project: https://console.cloud.google.com/project
-.. _Enable billing: https://support.google.com/cloud/answer/6293499#enable-billing
-.. _Enable the Google Cloud Dialogflow API: https://console.cloud.google.com/flows/enableapi?apiid=dialogflow.googleapis.com
-.. _Set up authentication: https://cloud.google.com/docs/authentication/getting-started
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. Enable the Google Cloud Dialogflow API.
+4. `Setup Authentication.`_
 
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
 
 Installation
-------------
-
-.. code-block:: shell
-
-    pip install google-cloud-dialogflow
-
-.. note::
-
-    We highly recommend that you install this library in a
-    `virtualenv <https://virtualenv.pypa.io/en/latest/>`_.
-
-
-Supported Python Versions
-^^^^^^^^^^^^^^^^^^^^^^^^^
-Python >= 3.6
-
-Unsupported Python Versions
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
-The last version of this library compatible with Python 2.7 is dialogflow==1.1.0.
-
-
-Usage
------
+~~~~~~~~~~~~
 
-View `usage documentation <https://googleapis.dev/python/dialogflow/latest/index.html>`_.
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
 
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
 
-Versioning
-----------
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
 
-This library follows `Semantic Versioning <http://semver.org/>`_.
 
-This library is considered to be stable. This means and that the code surface will not change in backwards-incompatible
-ways unless either absolutely necessary (e.g. because of critical security issues) or with an extensive deprecation
-period. Issues and requests against GA libraries are addressed with the highest priority.
+Mac/Linux
+^^^^^^^^^
 
-More Information: `Google Cloud Python Library Support <https://github.com/googleapis/google-cloud-python/blob/master/README.rst#general-availability>`_
+.. code-block:: console
 
-Contributing
-------------
+    python3 -m venv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install /path/to/library
 
-Contributions welcome! See the `Contributing Guide <https://github.com/googleapis/python-dialogflow/blob/master/.github/CONTRIBUTING.md>`_.
 
-License
--------
+Windows
+^^^^^^^
 
-Apache Version 2.0
+.. code-block:: console
 
-See `the LICENSE file <https://github.com/googleapis/python-dialogflow/blob/master/LICENSE>`_ for more information.
+    python3 -m venv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install \path\to\library
diff --git a/docs/dialogflow_v2/agents.rst b/docs/dialogflow_v2/agents.rst
@@ -0,0 +1,11 @@
+Agents
+------------------------
+
+.. automodule:: google.cloud.dialogflow_v2.services.agents
+    :members:
+    :inherited-members:
+
+
+.. automodule:: google.cloud.dialogflow_v2.services.agents.pagers
+    :members:
+    :inherited-members:
diff --git a/docs/dialogflow_v2/answer_records.rst b/docs/dialogflow_v2/answer_records.rst
@@ -0,0 +1,11 @@
+AnswerRecords
+-------------------------------
+
+.. automodule:: google.cloud.dialogflow_v2.services.answer_records
+    :members:
+    :inherited-members:
+
+
+.. automodule:: google.cloud.dialogflow_v2.services.answer_records.pagers
+    :members:
+    :inherited-members:
diff --git a/docs/dialogflow_v2/contexts.rst b/docs/dialogflow_v2/contexts.rst
@@ -0,0 +1,11 @@
+Contexts
+--------------------------
+
+.. automodule:: google.cloud.dialogflow_v2.services.contexts
+    :members:
+    :inherited-members:
+
+
+.. automodule:: google.cloud.dialogflow_v2.services.contexts.pagers
+    :members:
+    :inherited-members:
diff --git a/docs/dialogflow_v2/conversation_profiles.rst b/docs/dialogflow_v2/conversation_profiles.rst
@@ -0,0 +1,11 @@
+ConversationProfiles
+--------------------------------------
+
+.. automodule:: google.cloud.dialogflow_v2.services.conversation_profiles
+    :members:
+    :inherited-members:
+
+
+.. automodule:: google.cloud.dialogflow_v2.services.conversation_profiles.pagers
+    :members:
+    :inherited-members:
diff --git a/docs/dialogflow_v2/conversations.rst b/docs/dialogflow_v2/conversations.rst
@@ -0,0 +1,11 @@
+Conversations
+-------------------------------
+
+.. automodule:: google.cloud.dialogflow_v2.services.conversations
+    :members:
+    :inherited-members:
+
+
+.. automodule:: google.cloud.dialogflow_v2.services.conversations.pagers
+    :members:
+    :inherited-members:
diff --git a/docs/dialogflow_v2/documents.rst b/docs/dialogflow_v2/documents.rst
@@ -0,0 +1,11 @@
+Documents
+---------------------------
+
+.. automodule:: google.cloud.dialogflow_v2.services.documents
+    :members:
+    :inherited-members:
+
+
+.. automodule:: google.cloud.dialogflow_v2.services.documents.pagers
+    :members:
+    :inherited-members:
diff --git a/docs/dialogflow_v2/entity_types.rst b/docs/dialogflow_v2/entity_types.rst
@@ -0,0 +1,11 @@
+EntityTypes
+-----------------------------
+
+.. automodule:: google.cloud.dialogflow_v2.services.entity_types
+    :members:
+    :inherited-members:
+
+
+.. automodule:: google.cloud.dialogflow_v2.services.entity_types.pagers
+    :members:
+    :inherited-members:
diff --git a/docs/dialogflow_v2/environments.rst b/docs/dialogflow_v2/environments.rst
@@ -0,0 +1,11 @@
+Environments
+------------------------------
+
+.. automodule:: google.cloud.dialogflow_v2.services.environments
+    :members:
+    :inherited-members:
+
+
+.. automodule:: google.cloud.dialogflow_v2.services.environments.pagers
+    :members:
+    :inherited-members:
diff --git a/docs/dialogflow_v2/intents.rst b/docs/dialogflow_v2/intents.rst
@@ -0,0 +1,11 @@
+Intents
+-------------------------
+
+.. automodule:: google.cloud.dialogflow_v2.services.intents
+    :members:
+    :inherited-members:
+
+
+.. automodule:: google.cloud.dialogflow_v2.services.intents.pagers
+    :members:
+    :inherited-members:
diff --git a/docs/dialogflow_v2/knowledge_bases.rst b/docs/dialogflow_v2/knowledge_bases.rst
@@ -0,0 +1,11 @@
+KnowledgeBases
+--------------------------------
+
+.. automodule:: google.cloud.dialogflow_v2.services.knowledge_bases
+    :members:
+    :inherited-members:
+
+
+.. automodule:: google.cloud.dialogflow_v2.services.knowledge_bases.pagers
+    :members:
+    :inherited-members:
diff --git a/docs/dialogflow_v2/participants.rst b/docs/dialogflow_v2/participants.rst
@@ -0,0 +1,11 @@
+Participants
+------------------------------
+
+.. automodule:: google.cloud.dialogflow_v2.services.participants
+    :members:
+    :inherited-members:
+
+
+.. automodule:: google.cloud.dialogflow_v2.services.participants.pagers
+    :members:
+    :inherited-members:
diff --git a/docs/dialogflow_v2/services.rst b/docs/dialogflow_v2/services.rst
@@ -1,24 +1,18 @@
 Services for Google Cloud Dialogflow v2 API
 ===========================================
+.. toctree::
+    :maxdepth: 2
 
-.. automodule:: google.cloud.dialogflow_v2.services.agents
-    :members:
-    :inherited-members:
-.. automodule:: google.cloud.dialogflow_v2.services.contexts
-    :members:
-    :inherited-members:
-.. automodule:: google.cloud.dialogflow_v2.services.entity_types
-    :members:
-    :inherited-members:
-.. automodule:: google.cloud.dialogflow_v2.services.environments
-    :members:
-    :inherited-members:
-.. automodule:: google.cloud.dialogflow_v2.services.intents
-    :members:
-    :inherited-members:
-.. automodule:: google.cloud.dialogflow_v2.services.session_entity_types
-    :members:
-    :inherited-members:
-.. automodule:: google.cloud.dialogflow_v2.services.sessions
-    :members:
-    :inherited-members:
+    agents
+    answer_records
+    contexts
+    conversation_profiles
+    conversations
+    documents
+    entity_types
+    environments
+    intents
+    knowledge_bases
+    participants
+    session_entity_types
+    sessions
diff --git a/docs/dialogflow_v2/session_entity_types.rst b/docs/dialogflow_v2/session_entity_types.rst
@@ -0,0 +1,11 @@
+SessionEntityTypes
+------------------------------------
+
+.. automodule:: google.cloud.dialogflow_v2.services.session_entity_types
+    :members:
+    :inherited-members:
+
+
+.. automodule:: google.cloud.dialogflow_v2.services.session_entity_types.pagers
+    :members:
+    :inherited-members:
diff --git a/docs/dialogflow_v2/sessions.rst b/docs/dialogflow_v2/sessions.rst
@@ -0,0 +1,6 @@
+Sessions
+--------------------------
+
+.. automodule:: google.cloud.dialogflow_v2.services.sessions
+    :members:
+    :inherited-members:
diff --git a/docs/dialogflow_v2/types.rst b/docs/dialogflow_v2/types.rst
@@ -3,4 +3,5 @@ Types for Google Cloud Dialogflow v2 API
 
 .. automodule:: google.cloud.dialogflow_v2.types
     :members:
+    :undoc-members:
     :show-inheritance: