Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
532 changes: 527 additions & 5 deletions .librarian/config.yaml

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
# Copyright 2026 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.
description: Mitigate synthtool adding a second copyright notice when one already exists
url: https://github.com/googleapis/librarian/issues/4322
replacements:
- paths: [
packages/googleapis-common-protos/google/gapic/metadata/gapic_metadata_pb2.pyi,
packages/googleapis-common-protos/google/longrunning/operations_proto_pb2.pyi
]
before: |
# Copyright 2025 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.\n
# Copyright 2025 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.
after: |
# Copyright 2025 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.
count: 2
Original file line number Diff line number Diff line change
Expand Up @@ -97,6 +97,14 @@ replacements:
translate_v3/services_
translate_v3/types_

API Reference
-------------
.. toctree::
:maxdepth: 2

translate_v2/services_
translate_v2/types_

API Reference
-------------
.. toctree::
Expand Down
6 changes: 3 additions & 3 deletions .librarian/state.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -1585,7 +1585,7 @@ libraries:
tag_format: '{id}-v{version}'
- id: google-cloud-dlp
version: 3.34.0
last_generated_commit: 9a477cd3c26a704130e2a2fb44a40281d9312e4c
last_generated_commit: dfcbe6807e8c0bb8d5abb2b5e875a2a03af8d874
apis:
- path: google/privacy/dlp/v2
service_config: dlp_v2.yaml
Expand Down Expand Up @@ -3721,7 +3721,7 @@ libraries:
tag_format: '{id}-v{version}'
- id: google-maps-places
version: 0.7.0
last_generated_commit: 6df3ecf4fd43b64826de6a477d1a535ec18b0d7c
last_generated_commit: dfcbe6807e8c0bb8d5abb2b5e875a2a03af8d874
apis:
- path: google/maps/places/v1
service_config: places_v1.yaml
Expand Down Expand Up @@ -3800,7 +3800,7 @@ libraries:
tag_format: '{id}-v{version}'
- id: google-shopping-merchant-accounts
version: 1.3.0
last_generated_commit: 256b575f6915282b20795c13414b21f2c0af65db
last_generated_commit: dfcbe6807e8c0bb8d5abb2b5e875a2a03af8d874
apis:
- path: google/shopping/merchant/accounts/v1
service_config: merchantapi_v1.yaml
Expand Down
367 changes: 229 additions & 138 deletions librarian.yaml

Large diffs are not rendered by default.

18 changes: 7 additions & 11 deletions packages/bigquery-magics/.repo-metadata.json
Original file line number Diff line number Diff line change
@@ -1,16 +1,12 @@
{
"api_id": "bigquery.googleapis.com",
"client_documentation": "https://googleapis.dev/python/bigquery-magics/latest/",
"distribution_name": "bigquery-magics",
"issue_tracker": "https://github.com/googleapis/python-bigquery-magics/issues",
"library_type": "INTEGRATION",
"name": "bigquery-magics",
"name_pretty": "Google BigQuery connector for Jupyter and IPython",
"product_documentation": "https://cloud.google.com/bigquery",
"client_documentation": "https://googleapis.dev/python/bigquery-magics/latest/",
"issue_tracker": "https://github.com/googleapis/python-bigquery-magics/issues",
"release_level": "stable",
"language": "python",
"library_type": "INTEGRATION",
"repo": "googleapis/google-cloud-python",
"distribution_name": "bigquery-magics",
"api_id": "bigquery.googleapis.com",
"requires_billing": false,
"default_version": "",
"codeowner_team": "@googleapis/cloud-sdk-python-team @googleapis/bigquery-dataframe-team"
}
"repo": "googleapis/google-cloud-python"
}
1 change: 0 additions & 1 deletion packages/bigquery-magics/docs/README.rst

This file was deleted.

103 changes: 103 additions & 0 deletions packages/bigquery-magics/docs/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
IPython Magics for BigQuery
===========================

|GA| |pypi| |versions|

Querying massive datasets can be time consuming and expensive without the
right hardware and infrastructure. Google `BigQuery`_ solves this problem by
enabling super-fast, SQL queries against append-mostly tables, using the
processing power of Google's infrastructure.

- `Library Documentation`_
- `Product Documentation`_

.. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg
:target: https://github.com/googleapis/google-cloud-python/blob/main/README.rst#general-availability
.. |pypi| image:: https://img.shields.io/pypi/v/bigquery-magics.svg
:target: https://pypi.org/project/bigquery-magics/
.. |versions| image:: https://img.shields.io/pypi/pyversions/bigquery-magics.svg
:target: https://pypi.org/project/bigquery-magics/
.. _BigQuery: https://cloud.google.com/bigquery/what-is-bigquery
.. _Library Documentation: https://googleapis.dev/python/bigquery-magics/latest
.. _Product Documentation: https://cloud.google.com/bigquery/docs/reference/v2/

Quick Start
-----------

In order to use this library, you first need to go through the following steps:

1. `Select or create a Cloud Platform project.`_
2. `Enable billing for your project.`_
3. `Enable the Google Cloud BigQuery 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
.. _Enable the Google Cloud BigQuery API.: https://cloud.google.com/bigquery
.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html

Installation
~~~~~~~~~~~~

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.

.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/


Supported Python Versions
^^^^^^^^^^^^^^^^^^^^^^^^^
Python >= 3.9

Unsupported Python Versions
^^^^^^^^^^^^^^^^^^^^^^^^^^^
Python <= 3.8.


Mac/Linux
^^^^^^^^^

.. code-block:: console

pip install virtualenv
virtualenv <your-env>
source <your-env>/bin/activate
<your-env>/bin/pip install bigquery-magics


Windows
^^^^^^^

.. code-block:: console

pip install virtualenv
virtualenv <your-env>
<your-env>\Scripts\activate
<your-env>\Scripts\pip.exe install bigquery-magics

Example Usage
-------------

To use these magics, you must first register them. Run the ``%load_ext bigquery_magics``
in a Jupyter notebook cell.

.. code-block::

%load_ext bigquery_magics

Perform a query
~~~~~~~~~~~~~~~

.. code:: python

%%bigquery
SELECT name, SUM(number) as count
FROM 'bigquery-public-data.usa_names.usa_1910_current'
GROUP BY name
ORDER BY count DESC
LIMIT 3
16 changes: 6 additions & 10 deletions packages/db-dtypes/.repo-metadata.json
Original file line number Diff line number Diff line change
@@ -1,15 +1,11 @@
{
"api_id": "bigquery.googleapis.com",
"client_documentation": "https://googleapis.dev/python/db-dtypes/latest/index.html",
"distribution_name": "db-dtypes",
"library_type": "INTEGRATION",
"name": "db-dtypes",
"name_pretty": "Pandas Data Types for SQL systems (BigQuery, Spanner)",
"product_documentation": "https://pandas.pydata.org/pandas-docs/stable/ecosystem.html#ecosystem-extensions",
"client_documentation": "https://googleapis.dev/python/db-dtypes/latest/index.html",
"release_level": "stable",
"language": "python",
"library_type": "INTEGRATION",
"repo": "googleapis/google-cloud-python",
"distribution_name": "db-dtypes",
"api_id": "bigquery.googleapis.com",
"default_version": "",
"codeowner_team": "@googleapis/python-core-client-libraries",
"api_description": "Pandas extension data types for data from SQL systems such as BigQuery."
}
"repo": "googleapis/google-cloud-python"
}
1 change: 0 additions & 1 deletion packages/db-dtypes/docs/README.rst

This file was deleted.

63 changes: 63 additions & 0 deletions packages/db-dtypes/docs/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
Pandas Data Types for SQL systems (BigQuery, Spanner)
=====================================================

|ga| |pypi| |versions|

`Pandas extension data types`_ for data from SQL systems such as `BigQuery`_.

- `Library Documentation`_

.. |ga| image:: https://img.shields.io/badge/support-GA-gold.svg
:target: https://github.com/googleapis/google-cloud-python/blob/main/README.rst#general-availability
.. |pypi| image:: https://img.shields.io/pypi/v/db-dtypes.svg
:target: https://pypi.org/project/db-dtypes/
.. |versions| image:: https://img.shields.io/pypi/pyversions/db-dtypes.svg
:target: https://pypi.org/project/db-dtypes/
.. _Pandas extension data types: https://pandas.pydata.org/docs/development/extending.html#extension-types
.. _BigQuery: https://cloud.google.com/bigquery/docs/
.. _Library Documentation: https://googleapis.dev/python/db-dtypes/latest


Installation
------------

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.

.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/


Supported Python Versions
^^^^^^^^^^^^^^^^^^^^^^^^^
Python >= 3.9

Unsupported Python Versions
^^^^^^^^^^^^^^^^^^^^^^^^^^^
Python <= 3.8.


Mac/Linux
^^^^^^^^^

.. code-block:: console

pip install virtualenv
virtualenv <your-env>
source <your-env>/bin/activate
<your-env>/bin/pip install db-dtypes


Windows
^^^^^^^

.. code-block:: console

pip install virtualenv
virtualenv <your-env>
<your-env>\Scripts\activate
<your-env>\Scripts\pip.exe install db-dtypes
16 changes: 7 additions & 9 deletions packages/django-google-spanner/.repo-metadata.json
Original file line number Diff line number Diff line change
@@ -1,14 +1,12 @@
{
"api_shortname": "django-google-spanner",
"client_documentation": "https://googleapis.dev/python/django-google-spanner/latest",
"distribution_name": "django-google-spanner",
"issue_tracker": "https://issuetracker.google.com/issues?q=componentid:190851%2B%20status:open",
"library_type": "INTEGRATION",
"name": "django-google-spanner",
"name_pretty": "Cloud Spanner Django",
"product_documentation": "https://cloud.google.com/spanner/docs/",
"client_documentation": "https://googleapis.dev/python/django-google-spanner/latest",
"issue_tracker": "https://issuetracker.google.com/issues?q=componentid:190851%2B%20status:open",
"release_level": "stable",
"language": "python",
"library_type": "INTEGRATION",
"repo": "googleapis/google-cloud-python",
"distribution_name": "django-google-spanner",
"requires_billing": true,
"api_shortname": "django-google-spanner"
}
"repo": "googleapis/google-cloud-python"
}
Loading
Loading