docs: raise DeprecationWarning when 'dialogflow' is installed (#257)

Author: busunkim96

README.rst

@@ -1,11 +1,25 @@
 Dialogflow: Python Client
 =========================
 
-|release level|
 
-    Python idiomatic client for `Dialogflow`_
+.. warning::
+    The package `dialogflow`_ has been renamed to `google-cloud-dialogflow`_.
+    `dialogflow`_ will no longer be updated.
 
-`Dialogflow`_ is an enterprise-grade NLU platform that makes it easy for
+    For help upgrading to ``google-cloud-dialogflow>=2.0.0``, see the `Migration Guide`_.
+
+    After **October 28, 2021**, importing code from the latest release of `dialogflow`_ will result in a ``RuntimeError``. If you need to continue to use `dialogflow`_ after this date, please pin to a specific version of `dialogflow`_ (e.g., ``dialogflow==1.1.1``). If you have questions, please `file an issue`_.
+
+.. _dialogflow: https://pypi.org/project/dialogflow
+.. _google-cloud-dialogflow: https://pypi.org/project/google-cloud-dialogflow
+.. _Migration Guide: https://github.com/googleapis/python-dialogflow/blob/master/UPGRADING.md
+.. _file an issue: https://github.com/googleapis/python-dialogflow/issues
+
+
+
+    Python idiomatic client for `Dialogflow <https://dialogflow.com/>`_
+
+`Dialogflow <https://dialogflow.com/>`_ 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.
 
@@ -17,8 +31,6 @@ 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>`_.
 
-.. _Dialogflow: https://dialogflow.com/
-
 
 Before you begin
 ----------------
@@ -88,4 +100,4 @@ See `the LICENSE file <https://github.com/googleapis/python-dialogflow/blob/mast
 
 
 .. |release level| image:: https://img.shields.io/badge/support-GA-gold.svg
-   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#general-availability
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#general-availability

dialogflow_v2/__init__.py

@@ -38,6 +38,23 @@
     )
     warnings.warn(message, DeprecationWarning)
 
+package_deprecation_message = (
+    "The package 'dialogflow' has been renamed to 'google-cloud-dialogflow'. "
+    "'dialogflow' will no longer be updated. "
+    "For help upgrading to google-cloud-dialogflow>=2.0.0, "
+    "see https://github.com/googleapis/python-dialogflow/blob/master/UPGRADING.md. "
+    "\n\nAfter October 28, 2021, importing code from the latest release of 'dialogflow' "
+    "will result in a RuntimeError. If you need to continue to use 'dialogflow' after this date, "
+    "please pin to a specific version of 'dialogflow' (e.g., dialogflow==1.1.1). "
+    "If you have questions, please file an issue: "
+    "https://github.com/googleapis/python-dialogflow/issues."
+)
+
+warnings.warn(
+    package_deprecation_message,
+    DeprecationWarning
+)
+
 
 class AgentsClient(agents_client.AgentsClient):
     __doc__ = agents_client.AgentsClient.__doc__

dialogflow_v2beta1/__init__.py

@@ -41,6 +41,22 @@
     warnings.warn(message, DeprecationWarning)
 
 
+package_deprecation_message = (
+    "The package 'dialogflow' has been renamed to 'google-cloud-dialogflow'. "
+    "'dialogflow' will no longer be updated. "
+    "For help upgrading to google-cloud-dialogflow>=2.0.0, "
+    "see https://github.com/googleapis/python-dialogflow/blob/master/UPGRADING.md. "
+    "\n\nAfter October 28, 2021, importing code from the latest release of 'dialogflow' "
+    "will result in a RuntimeError. If you need to continue to use 'dialogflow' after this date, "
+    "please pin to a specific version of 'dialogflow' (e.g., dialogflow==1.1.1). "
+    "If you have questions, please file an issue: "
+    "https://github.com/googleapis/python-dialogflow/issues."
+)
+
+warnings.warn(
+    package_deprecation_message,
+    DeprecationWarning
+)
 class EnvironmentsClient(environments_client.EnvironmentsClient):
     __doc__ = environments_client.EnvironmentsClient.__doc__
     enums = enums

setup.py

@@ -19,7 +19,7 @@
 
 name = "dialogflow"
 description = "Client library for the Dialogflow API"
-version = "1.1.0"
+version = "1.1.1"
 release_status = "Development Status :: 5 - Production/Stable"
 dependencies = ["google-api-core[grpc] >= 1.14.0, < 2.0.0dev"]