feat!: add common resource paths; expose client transport; rename type attributes to type_ to avoid name collisions (#64)

Renamed attributes:
* TagTemplateField.type -> TagTemplatedField.type_
* ColumnSchema.type -> ColumnSchema.type_
* Entry.type -> Entry.type_

Author: yoshi-automation

datacatalog/snippets/README.rst

@@ -1,3 +1,4 @@
+
 .. This file is automatically generated. Do not edit this file directly.
 
 Google Cloud Data Catalog Python Samples
@@ -15,13 +16,11 @@ This directory contains samples for Google Cloud Data Catalog. `Google Cloud Dat
 .. _Google Cloud Data Catalog: https://cloud.google.com/data-catalog/docs
 
 
-
-
-
 Setup
 -------------------------------------------------------------------------------
 
 
+
 Authentication
 ++++++++++++++
 
@@ -32,6 +31,9 @@ credentials for applications.
 .. _Authentication Getting Started Guide:
     https://cloud.google.com/docs/authentication/getting-started
 
+
+
+
 Install Dependencies
 ++++++++++++++++++++
 
@@ -46,7 +48,7 @@ Install Dependencies
    .. _Python Development Environment Setup Guide:
        https://cloud.google.com/python/setup
 
-#. Create a virtualenv. Samples are compatible with Python 2.7 and 3.4+.
+#. Create a virtualenv. Samples are compatible with Python 3.6+.
 
     .. code-block:: bash
 
@@ -62,9 +64,15 @@ Install Dependencies
 .. _pip: https://pip.pypa.io/
 .. _virtualenv: https://virtualenv.pypa.io/
 
+
+
+
+
+
 Samples
 -------------------------------------------------------------------------------
 
+
 Lookup entry
 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
@@ -80,6 +88,7 @@ To run this sample:
 
     $ python lookup_entry.py
 
+
     usage: lookup_entry.py [-h]
                            project_id
                            {bigquery-dataset,bigquery-table,pubsub-topic} ...
@@ -107,6 +116,10 @@ To run this sample:
 
 
 
+
+
+
+
 The client library
 -------------------------------------------------------------------------------
 
@@ -122,4 +135,5 @@ to `browse the source`_ and  `report issues`_.
     https://github.com/GoogleCloudPlatform/google-cloud-python/issues
 
 
-.. _Google Cloud SDK: https://cloud.google.com/sdk/
+
+.. _Google Cloud SDK: https://cloud.google.com/sdk/

datacatalog/snippets/noxfile.py

@@ -39,6 +39,10 @@
     # You can opt out from the test for specific Python versions.
     'ignored_versions': ["2.7"],
 
+    # Old samples are opted out of enforcing Python type hints
+    # All new samples should feature them
+    'enforce_type_hints': False,
+
     # An envvar key for determining the project id to use. Change it
     # to 'BUILD_SPECIFIC_GCLOUD_PROJECT' if you want to opt in using a
     # build specific Cloud project. You can also use your own string
@@ -132,7 +136,10 @@ def _determine_local_import_names(start_dir):
 
 @nox.session
 def lint(session):
-    session.install("flake8", "flake8-import-order")
+    if not TEST_CONFIG['enforce_type_hints']:
+        session.install("flake8", "flake8-import-order")
+    else:
+        session.install("flake8", "flake8-import-order", "flake8-annotations")
 
     local_names = _determine_local_import_names(".")
     args = FLAKE8_COMMON_ARGS + [
@@ -141,8 +148,18 @@ def lint(session):
         "."
     ]
     session.run("flake8", *args)
+#
+# Black
+#
 
 
+@nox.session
+def blacken(session):
+    session.install("black")
+    python_files = [path for path in os.listdir(".") if path.endswith(".py")]
+
+    session.run("black", *python_files)
+
 #
 # Sample Tests
 #
@@ -201,6 +218,11 @@ def _get_repo_root():
             break
         if Path(p / ".git").exists():
             return str(p)
+        # .git is not available in repos cloned via Cloud Build
+        # setup.py is always in the library's root, so use that instead
+        # https://github.com/googleapis/synthtool/issues/792
+        if Path(p / "setup.py").exists():
+            return str(p)
         p = p.parent
     raise Exception("Unable to detect repository root.")