chore: update templates

Author: plamut

.github/CODEOWNERS

@@ -0,0 +1,9 @@
+# Code owners file.
+# This file controls who is tagged for review for any given pull request.
+#
+# For syntax help see:
+# https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-code-owners#codeowners-syntax
+
+
+/samples/   @shollyman @googleapis/python-samples-owners
+

samples/AUTHORING_GUIDE.md

@@ -0,0 +1 @@
+See https://github.com/GoogleCloudPlatform/python-docs-samples/blob/master/AUTHORING_GUIDE.md

samples/CONTRIBUTING.md

@@ -0,0 +1 @@
+See https://github.com/GoogleCloudPlatform/python-docs-samples/blob/master/CONTRIBUTING.md

samples/snippets/README.rst

@@ -1,3 +1,4 @@
+
 .. This file is automatically generated. Do not edit this file directly.
 
 Google BigQuery Python Samples
@@ -15,14 +16,11 @@ This directory contains samples for Google BigQuery. `Google BigQuery`_ is Googl
 .. _Google BigQuery: https://cloud.google.com/bigquery/docs
 
 
-To run the sample, you need to have `BigQuery Admin` role.
-
-
-
 Setup
 -------------------------------------------------------------------------------
 
 
+
 Authentication
 ++++++++++++++
 
@@ -33,6 +31,9 @@ credentials for applications.
 .. _Authentication Getting Started Guide:
     https://cloud.google.com/docs/authentication/getting-started
 
+
+
+
 Install Dependencies
 ++++++++++++++++++++
 
@@ -47,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
 
@@ -63,9 +64,15 @@ Install Dependencies
 .. _pip: https://pip.pypa.io/
 .. _virtualenv: https://virtualenv.pypa.io/
 
+
+
+
+
+
 Samples
 -------------------------------------------------------------------------------
 
+
 Quickstart
 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
@@ -82,6 +89,8 @@ To run this sample:
     $ python quickstart.py
 
 
+
+
 Simple Application
 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
@@ -98,6 +107,8 @@ To run this sample:
     $ python simple_app.py
 
 
+
+
 User Credentials
 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
@@ -113,6 +124,7 @@ To run this sample:
 
     $ python user_credentials.py
 
+
     usage: user_credentials.py [-h] [--launch-browser] project
 
     Command-line application to run a query using user credentials.
@@ -131,6 +143,10 @@ To run this sample:
 
 
 
+
+
+
+
 The client library
 -------------------------------------------------------------------------------
 
@@ -146,4 +162,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/

samples/snippets/authenticate_service_account.py

@@ -27,14 +27,10 @@ def main():
     # key_path = "path/to/service_account.json"
 
     credentials = service_account.Credentials.from_service_account_file(
-        key_path,
-        scopes=["https://www.googleapis.com/auth/cloud-platform"],
+        key_path, scopes=["https://www.googleapis.com/auth/cloud-platform"],
     )
 
-    client = bigquery.Client(
-        credentials=credentials,
-        project=credentials.project_id,
-    )
+    client = bigquery.Client(credentials=credentials, project=credentials.project_id,)
     # [END bigquery_client_json_credentials]
     return client
 

samples/snippets/authenticate_service_account_test.py

@@ -26,7 +26,7 @@ def mock_credentials(*args, **kwargs):
 
 def test_main(monkeypatch):
     monkeypatch.setattr(
-        'google.oauth2.service_account.Credentials.from_service_account_file',
+        "google.oauth2.service_account.Credentials.from_service_account_file",
         mock_credentials,
     )
     client = authenticate_service_account.main()

samples/snippets/authorized_view_tutorial.py

@@ -18,15 +18,15 @@
 def run_authorized_view_tutorial(override_values={}):
     # Note to user: This is a group email for testing purposes. Replace with
     # your own group email address when running this code.
-    analyst_group_email = 'example-analyst-group@google.com'
+    analyst_group_email = "example-analyst-group@google.com"
 
     # [START bigquery_authorized_view_tutorial]
     # Create a source dataset
     # [START bigquery_avt_create_source_dataset]
     from google.cloud import bigquery
 
     client = bigquery.Client()
-    source_dataset_id = 'github_source_data'
+    source_dataset_id = "github_source_data"
 
     # [END bigquery_authorized_view_tutorial]
     # [END bigquery_avt_create_source_dataset]
@@ -38,13 +38,13 @@ def run_authorized_view_tutorial(override_values={}):
 
     source_dataset = bigquery.Dataset(client.dataset(source_dataset_id))
     # Specify the geographic location where the dataset should reside.
-    source_dataset.location = 'US'
+    source_dataset.location = "US"
     source_dataset = client.create_dataset(source_dataset)  # API request
     # [END bigquery_avt_create_source_dataset]
 
     # Populate a source table
     # [START bigquery_avt_create_source_table]
-    source_table_id = 'github_contributors'
+    source_table_id = "github_contributors"
     job_config = bigquery.QueryJobConfig()
     job_config.destination = source_dataset.table(source_table_id)
     sql = """
@@ -56,15 +56,16 @@ def run_authorized_view_tutorial(override_values={}):
         sql,
         # Location must match that of the dataset(s) referenced in the query
         # and of the destination table.
-        location='US',
-        job_config=job_config)  # API request - starts the query
+        location="US",
+        job_config=job_config,
+    )  # API request - starts the query
 
     query_job.result()  # Waits for the query to finish
     # [END bigquery_avt_create_source_table]
 
     # Create a separate dataset to store your view
     # [START bigquery_avt_create_shared_dataset]
-    shared_dataset_id = 'shared_views'
+    shared_dataset_id = "shared_views"
 
     # [END bigquery_authorized_view_tutorial]
     # [END bigquery_avt_create_shared_dataset]
@@ -75,13 +76,13 @@ def run_authorized_view_tutorial(override_values={}):
     # [START bigquery_avt_create_shared_dataset]
 
     shared_dataset = bigquery.Dataset(client.dataset(shared_dataset_id))
-    shared_dataset.location = 'US'
+    shared_dataset.location = "US"
     shared_dataset = client.create_dataset(shared_dataset)  # API request
     # [END bigquery_avt_create_shared_dataset]
 
     # Create the view in the new dataset
     # [START bigquery_avt_create_view]
-    shared_view_id = 'github_analyst_view'
+    shared_view_id = "github_analyst_view"
     view = bigquery.Table(shared_dataset.table(shared_view_id))
     sql_template = """
         SELECT
@@ -91,7 +92,8 @@ def run_authorized_view_tutorial(override_values={}):
             `{}.{}.{}`
     """
     view.view_query = sql_template.format(
-        client.project, source_dataset_id, source_table_id)
+        client.project, source_dataset_id, source_table_id
+    )
     view = client.create_table(view)  # API request
     # [END bigquery_avt_create_view]
 
@@ -100,25 +102,27 @@ def run_authorized_view_tutorial(override_values={}):
     # analyst_group_email = 'data_analysts@example.com'
     access_entries = shared_dataset.access_entries
     access_entries.append(
-        bigquery.AccessEntry('READER', 'groupByEmail', analyst_group_email)
+        bigquery.AccessEntry("READER", "groupByEmail", analyst_group_email)
     )
     shared_dataset.access_entries = access_entries
     shared_dataset = client.update_dataset(
-        shared_dataset, ['access_entries'])  # API request
+        shared_dataset, ["access_entries"]
+    )  # API request
     # [END bigquery_avt_shared_dataset_access]
 
     # Authorize the view to access the source dataset
     # [START bigquery_avt_source_dataset_access]
     access_entries = source_dataset.access_entries
     access_entries.append(
-        bigquery.AccessEntry(None, 'view', view.reference.to_api_repr())
+        bigquery.AccessEntry(None, "view", view.reference.to_api_repr())
     )
     source_dataset.access_entries = access_entries
     source_dataset = client.update_dataset(
-        source_dataset, ['access_entries'])  # API request
+        source_dataset, ["access_entries"]
+    )  # API request
     # [END bigquery_avt_source_dataset_access]
     # [END bigquery_authorized_view_tutorial]
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     run_authorized_view_tutorial()

samples/snippets/authorized_view_tutorial_test.py

@@ -20,7 +20,7 @@
 import authorized_view_tutorial
 
 
-@pytest.fixture(scope='module')
+@pytest.fixture(scope="module")
 def client():
     return bigquery.Client()
 
@@ -35,30 +35,39 @@ def datasets_to_delete(client):
 
 def test_authorized_view_tutorial(client, datasets_to_delete):
     override_values = {
-        "source_dataset_id": "github_source_data_{}".format(str(uuid.uuid4()).replace("-", "_")),
-        "shared_dataset_id": "shared_views_{}".format(str(uuid.uuid4()).replace("-", "_")),
+        "source_dataset_id": "github_source_data_{}".format(
+            str(uuid.uuid4()).replace("-", "_")
+        ),
+        "shared_dataset_id": "shared_views_{}".format(
+            str(uuid.uuid4()).replace("-", "_")
+        ),
     }
     source_dataset_ref = client.dataset(override_values["source_dataset_id"])
     shared_dataset_ref = client.dataset(override_values["shared_dataset_id"])
-    datasets_to_delete.extend([override_values["source_dataset_id"],
-                               override_values["shared_dataset_id"]])
+    datasets_to_delete.extend(
+        [override_values["source_dataset_id"], override_values["shared_dataset_id"]]
+    )
 
     authorized_view_tutorial.run_authorized_view_tutorial(override_values)
 
     source_dataset = client.get_dataset(source_dataset_ref)
     shared_dataset = client.get_dataset(shared_dataset_ref)
-    analyst_email = 'example-analyst-group@google.com'
-    analyst_entries = [entry for entry in shared_dataset.access_entries
-                       if entry.entity_id == analyst_email]
+    analyst_email = "example-analyst-group@google.com"
+    analyst_entries = [
+        entry
+        for entry in shared_dataset.access_entries
+        if entry.entity_id == analyst_email
+    ]
     assert len(analyst_entries) == 1
-    assert analyst_entries[0].role == 'READER'
+    assert analyst_entries[0].role == "READER"
 
-    authorized_view_entries = [entry for entry in source_dataset.access_entries
-                               if entry.entity_type == 'view']
+    authorized_view_entries = [
+        entry for entry in source_dataset.access_entries if entry.entity_type == "view"
+    ]
     expected_view_ref = {
-        'projectId': client.project,
-        'datasetId': override_values["shared_dataset_id"],
-        'tableId': 'github_analyst_view',
+        "projectId": client.project,
+        "datasetId": override_values["shared_dataset_id"],
+        "tableId": "github_analyst_view",
     }
     assert len(authorized_view_entries) == 1
     assert authorized_view_entries[0].entity_id == expected_view_ref