googleapis · tswast · Sep 24, 2020 · Sep 18, 2020 · Sep 18, 2020 · Sep 18, 2020
diff --git a/.kokoro/release/common.cfg b/.kokoro/release/common.cfg
@@ -23,14 +23,14 @@ env_vars: {
     value: "github/python-bigquery-storage/.kokoro/release.sh"
 }
 
-# Fetch PyPI password
-before_action {
-  fetch_keystore {
-    keystore_resource {
-      keystore_config_id: 73713
-      keyname: "google_cloud_pypi_password"
-    }
-  }
+# Fetch PyPI password	
+before_action {	
+  fetch_keystore {	
+    keystore_resource {	
+      keystore_config_id: 73713	
+      keyname: "google_cloud_pypi_password"	
+    }	
+  }	
 }
 
 # Tokens needed to report release status back to GitHub

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
@@ -80,25 +80,6 @@ We use `nox <https://nox.readthedocs.io/en/latest/>`__ to instrument our tests.
 
 .. nox: https://pypi.org/project/nox/
 
-Note on Editable Installs / Develop Mode
-========================================
-
-- As mentioned previously, using ``setuptools`` in `develop mode`_
-  or a ``pip`` `editable install`_ is not possible with this
-  library. This is because this library uses `namespace packages`_.
-  For context see `Issue #2316`_ and the relevant `PyPA issue`_.
-
-  Since ``editable`` / ``develop`` mode can't be used, packages
-  need to be installed directly. Hence your changes to the source
-  tree don't get incorporated into the **already installed**
-  package.
-
-.. _namespace packages: https://www.python.org/dev/peps/pep-0420/
-.. _Issue #2316: https://github.com/GoogleCloudPlatform/google-cloud-python/issues/2316
-.. _PyPA issue: https://github.com/pypa/packaging-problems/issues/12
-.. _develop mode: https://setuptools.readthedocs.io/en/latest/setuptools.html#development-mode
-.. _editable install: https://pip.pypa.io/en/stable/reference/pip_install/#editable-installs
-
 *****************************************
 I'm getting weird errors... Can you help?
 *****************************************

diff --git a/docs/conf.py b/docs/conf.py
@@ -39,6 +39,7 @@
     "sphinx.ext.autosummary",
     "sphinx.ext.intersphinx",
     "sphinx.ext.coverage",
+    "sphinx.ext.doctest",
     "sphinx.ext.napoleon",
     "sphinx.ext.todo",
     "sphinx.ext.viewcode",

diff --git a/docs/gapic/v1/api.rst b/docs/gapic/v1/api.rst
diff --git a/docs/gapic/v1/types.rst b/docs/gapic/v1/types.rst
diff --git a/docs/gapic/v1beta1/api.rst b/docs/gapic/v1beta1/api.rst
diff --git a/docs/gapic/v1beta1/reader.rst b/docs/gapic/v1beta1/reader.rst
diff --git a/docs/gapic/v1beta1/types.rst b/docs/gapic/v1beta1/types.rst
diff --git a/docs/gapic/v1beta2/api.rst b/docs/gapic/v1beta2/api.rst
diff --git a/docs/gapic/v1beta2/types.rst b/docs/gapic/v1beta2/types.rst
diff --git a/docs/index.rst b/docs/index.rst
@@ -7,15 +7,8 @@ API Reference
 .. toctree::
     :maxdepth: 2
 
-    gapic/v1beta1/api
-    gapic/v1beta1/reader
-    gapic/v1beta1/types
-
-    gapic/v1beta2/api
-    gapic/v1beta2/types
-
-    gapic/v1/api
-    gapic/v1/types
+    storage_v1/services
+    storage_v1/types
 
 Example Usage
 -------------

diff --git a/docs/storage_v1/services.rst b/docs/storage_v1/services.rst
@@ -0,0 +1,6 @@
+Services for Google Cloud Bigquery Storage v1 API
+=================================================
+
+.. automodule:: google.cloud.bigquery.storage_v1.services.big_query_read
+    :members:
+    :inherited-members:
diff --git a/docs/storage_v1/types.rst b/docs/storage_v1/types.rst
@@ -0,0 +1,5 @@
+Types for Google Cloud Bigquery Storage v1 API
+==============================================
+
+.. automodule:: google.cloud.bigquery.storage_v1.types
+    :members:
diff --git a/google/cloud/bigquery/storage/__init__.py b/google/cloud/bigquery/storage/__init__.py
@@ -0,0 +1,56 @@
+# -*- 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
+#
+#     http://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.
+#
+
+from google.cloud.bigquery_storage_v1 import BigQueryReadAsyncClient
+from google.cloud.bigquery_storage_v1 import BigQueryReadClient
+from google.cloud.bigquery_storage_v1 import types
+from google.cloud.bigquery_storage_v1 import __version__
+from google.cloud.bigquery.storage_v1.types.arrow import ArrowRecordBatch
+from google.cloud.bigquery.storage_v1.types.arrow import ArrowSchema
+from google.cloud.bigquery.storage_v1.types.avro import AvroRows
+from google.cloud.bigquery.storage_v1.types.avro import AvroSchema
+from google.cloud.bigquery.storage_v1.types.storage import CreateReadSessionRequest
+from google.cloud.bigquery.storage_v1.types.storage import ReadRowsRequest
+from google.cloud.bigquery.storage_v1.types.storage import ReadRowsResponse
+from google.cloud.bigquery.storage_v1.types.storage import SplitReadStreamRequest
+from google.cloud.bigquery.storage_v1.types.storage import SplitReadStreamResponse
+from google.cloud.bigquery.storage_v1.types.storage import StreamStats
+from google.cloud.bigquery.storage_v1.types.storage import ThrottleState
+from google.cloud.bigquery.storage_v1.types.stream import DataFormat
+from google.cloud.bigquery.storage_v1.types.stream import ReadSession
+from google.cloud.bigquery.storage_v1.types.stream import ReadStream
+
+__all__ = (
+    "__version__",
+    "types",
+    "ArrowRecordBatch",
+    "ArrowSchema",
+    "AvroRows",
+    "AvroSchema",
+    "BigQueryReadAsyncClient",
+    "BigQueryReadClient",
+    "CreateReadSessionRequest",
+    "DataFormat",
+    "ReadRowsRequest",
+    "ReadRowsResponse",
+    "ReadSession",
+    "ReadStream",
+    "SplitReadStreamRequest",
+    "SplitReadStreamResponse",
+    "StreamStats",
+    "ThrottleState",
+)
diff --git a/google/cloud/bigquery/storage/py.typed b/google/cloud/bigquery/storage/py.typed
@@ -0,0 +1,2 @@
+# Marker file for PEP 561.
+# The google-cloud-bigquery-storage package uses inline types.
diff --git a/google/cloud/bigquery/storage_v1/__init__.py b/google/cloud/bigquery/storage_v1/__init__.py
@@ -0,0 +1,53 @@
+# -*- 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
+#
+#     http://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.
+#
+
+from .services.big_query_read import BigQueryReadAsyncClient
+from .services.big_query_read import BigQueryReadClient
+from .types.arrow import ArrowRecordBatch
+from .types.arrow import ArrowSchema
+from .types.avro import AvroRows
+from .types.avro import AvroSchema
+from .types.storage import CreateReadSessionRequest
+from .types.storage import ReadRowsRequest
+from .types.storage import ReadRowsResponse
+from .types.storage import SplitReadStreamRequest
+from .types.storage import SplitReadStreamResponse
+from .types.storage import StreamStats
+from .types.storage import ThrottleState
+from .types.stream import DataFormat
+from .types.stream import ReadSession
+from .types.stream import ReadStream
+
+
+__all__ = (
+    "ArrowRecordBatch",
+    "ArrowSchema",
+    "AvroRows",
+    "AvroSchema",
+    "CreateReadSessionRequest",
+    "DataFormat",
+    "ReadRowsRequest",
+    "ReadRowsResponse",
+    "ReadSession",
+    "ReadStream",
+    "SplitReadStreamRequest",
+    "SplitReadStreamResponse",
+    "StreamStats",
+    "ThrottleState",
+    "BigQueryReadAsyncClient",
+    "BigQueryReadClient",
+)
diff --git a/google/cloud/bigquery/storage_v1/py.typed b/google/cloud/bigquery/storage_v1/py.typed
@@ -0,0 +1,2 @@
+# Marker file for PEP 561.
+# The google-cloud-bigquery-storage package uses inline types.
diff --git a/google/cloud/bigquery/storage_v1/services/__init__.py b/google/cloud/bigquery/storage_v1/services/__init__.py
@@ -0,0 +1,16 @@
+# -*- 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
+#
+#     http://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.
+#
diff --git a/google/cloud/bigquery_storage.py → ...ge_v1/services/big_query_read/__init__.py b/google/cloud/bigquery_storage.py → ...ge_v1/services/big_query_read/__init__.py
@@ -1,29 +1,24 @@
 # -*- 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
+#     http://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.
+#
 
-
-from __future__ import absolute_import
-
-from google.cloud.bigquery_storage_v1 import BigQueryReadClient
-from google.cloud.bigquery_storage_v1 import enums
-from google.cloud.bigquery_storage_v1 import types
-
+from .client import BigQueryReadClient
+from .async_client import BigQueryReadAsyncClient
 
 __all__ = (
-    "enums",
-    "types",
     "BigQueryReadClient",
+    "BigQueryReadAsyncClient",
 )