From 4aee0c1944c71b5a5b3db8c5de54f52c4200d126 Mon Sep 17 00:00:00 2001 From: Jon Skeet Date: Thu, 16 Apr 2026 06:40:46 +0000 Subject: [PATCH 1/2] chore: reformat bigframes with nox --- packages/bigframes/bigframes/session/loader.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/packages/bigframes/bigframes/session/loader.py b/packages/bigframes/bigframes/session/loader.py index 960208063105..a07b6fd71ca7 100644 --- a/packages/bigframes/bigframes/session/loader.py +++ b/packages/bigframes/bigframes/session/loader.py @@ -54,6 +54,8 @@ from google.cloud import bigquery_storage_v1 from google.cloud.bigquery_storage_v1 import ( types as bq_storage_types, +) +from google.cloud.bigquery_storage_v1 import ( writer as bq_storage_writer, ) From 80d1999ad30d985adbf8fc00c2f7e2d5da47333c Mon Sep 17 00:00:00 2001 From: Jon Skeet Date: Thu, 16 Apr 2026 06:40:48 +0000 Subject: [PATCH 2/2] chore: regenerate bigframes with librarian --- librarian.yaml | 1 - packages/bigframes/.repo-metadata.json | 20 +++--- packages/bigframes/docs/README.rst | 95 +++++++++++++++++++++++++- 3 files changed, 103 insertions(+), 13 deletions(-) mode change 120000 => 100644 packages/bigframes/docs/README.rst diff --git a/librarian.yaml b/librarian.yaml index 7c0eb430af62..dd3174dcbb8d 100644 --- a/librarian.yaml +++ b/librarian.yaml @@ -55,7 +55,6 @@ default: libraries: - name: bigframes version: 2.39.0 - skip_generate: true python: library_type: INTEGRATION name_pretty_override: A unified Python API in BigQuery diff --git a/packages/bigframes/.repo-metadata.json b/packages/bigframes/.repo-metadata.json index c56e1245b5e9..4a1c7ed478e3 100644 --- a/packages/bigframes/.repo-metadata.json +++ b/packages/bigframes/.repo-metadata.json @@ -1,16 +1,14 @@ { - "name": "bigframes", - "name_pretty": "A unified Python API in BigQuery", - "product_documentation": "https://cloud.google.com/bigquery", + "api_id": "bigquery.googleapis.com", + "api_shortname": "bigquery", "client_documentation": "https://cloud.google.com/python/docs/reference/bigframes/latest", + "distribution_name": "bigframes", "issue_tracker": "https://github.com/googleapis/python-bigquery-dataframes/issues", - "release_level": "preview", "language": "python", "library_type": "INTEGRATION", - "repo": "googleapis/google-cloud-python", - "distribution_name": "bigframes", - "api_id": "bigquery.googleapis.com", - "default_version": "", - "codeowner_team": "@googleapis/bigquery-dataframe-team", - "api_shortname": "bigquery" -} + "name": "bigframes", + "name_pretty": "A unified Python API in BigQuery", + "product_documentation": "https://cloud.google.com/bigquery", + "release_level": "stable", + "repo": "googleapis/google-cloud-python" +} \ No newline at end of file diff --git a/packages/bigframes/docs/README.rst b/packages/bigframes/docs/README.rst deleted file mode 120000 index 89a0106941ff..000000000000 --- a/packages/bigframes/docs/README.rst +++ /dev/null @@ -1 +0,0 @@ -../README.rst \ No newline at end of file diff --git a/packages/bigframes/docs/README.rst b/packages/bigframes/docs/README.rst new file mode 100644 index 000000000000..a3aef5380bb1 --- /dev/null +++ b/packages/bigframes/docs/README.rst @@ -0,0 +1,94 @@ +BigQuery DataFrames (BigFrames) +=============================== + + +|GA| |pypi| |versions| + +BigQuery DataFrames (also known as BigFrames) provides a Pythonic DataFrame +and machine learning (ML) API powered by the BigQuery engine. It provides modules +for many use cases, including: + +* `bigframes.pandas `_ + is a pandas API for analytics. Many workloads can be + migrated from pandas to bigframes by just changing a few imports. +* `bigframes.ml `_ + is a scikit-learn-like API for ML. +* `bigframes.bigquery.ai `_ + are a collection of powerful AI methods, powered by Gemini. + +BigQuery DataFrames is an `open-source package `_. + +.. |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/bigframes.svg + :target: https://pypi.org/project/bigframes/ +.. |versions| image:: https://img.shields.io/pypi/pyversions/bigframes.svg + :target: https://pypi.org/project/bigframes/ + +Getting started with BigQuery DataFrames +---------------------------------------- + +The easiest way to get started is to try the +`BigFrames quickstart `_ +in a `notebook in BigQuery Studio `_. + +To use BigFrames in your local development environment, + +1. Run ``pip install --upgrade bigframes`` to install the latest version. + +2. Setup `Application default credentials `_ + for your local development environment enviroment. + +3. Create a `GCP project with the BigQuery API enabled `_. + +4. Use the ``bigframes`` package to query data. + +.. code-block:: python + + import bigframes.pandas as bpd + + bpd.options.bigquery.project = your_gcp_project_id # Optional in BQ Studio. + bpd.options.bigquery.ordering_mode = "partial" # Recommended for performance. + df = bpd.read_gbq("bigquery-public-data.usa_names.usa_1910_2013") + print( + df.groupby("name") + .agg({"number": "sum"}) + .sort_values("number", ascending=False) + .head(10) + .to_pandas() + ) + +Documentation +------------- + +To learn more about BigQuery DataFrames, visit these pages + +* `Introduction to BigQuery DataFrames (BigFrames) `_ +* `Sample notebooks `_ +* `API reference `_ +* `Source code (GitHub) `_ + +License +------- + +BigQuery DataFrames is distributed with the `Apache-2.0 license +`_. + +It also contains code derived from the following third-party packages: + +* `Ibis `_ +* `pandas `_ +* `Python `_ +* `scikit-learn `_ +* `XGBoost `_ +* `SQLGlot `_ + +For details, see the `third_party +`_ +directory. + + +Contact Us +---------- + +For further help and provide feedback, you can email us at `bigframes-feedback@google.com `_.