Merge remote-tracking branch 'github/main' into garrettwu-blog

Author: GarrettWu

.github/workflows/lint.yml

@@ -15,7 +15,7 @@ jobs:
     - name: Setup Python
       uses: actions/setup-python@v5
       with:
-        python-version: "3.10"
+        python-version: "3.14"
     - name: Install nox
       run: |
         python -m pip install --upgrade setuptools pip wheel

.github/workflows/unittest.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-22.04
     strategy:
       matrix:
-        python: ['3.10', '3.11', '3.12', '3.13']
+        python: ['3.10', '3.11', '3.12', '3.13', '3.14']
     steps:
     - name: Checkout
       uses: actions/checkout@v4
@@ -48,7 +48,7 @@ jobs:
     - name: Setup Python
       uses: actions/setup-python@v5
       with:
-        python-version: "3.10"
+        python-version: "3.14"
     - name: Install coverage
       run: |
         python -m pip install --upgrade setuptools pip wheel

.kokoro/release-nightly.sh

@@ -93,9 +93,9 @@ for gcs_path in gs://vertex_sdk_private_releases/bigframe/ \
                     gs://dl-platform-colab/bigframes/ \
                     gs://bigframes-wheels/;
     do
-      gsutil cp -v dist/* ${gcs_path}
-      gsutil cp -v LICENSE ${gcs_path}
-      gsutil -m cp -r -v "notebooks/" ${gcs_path}notebooks/
+      gcloud storage cp --print-created-message dist/* ${gcs_path}
+      gcloud storage cp --print-created-message LICENSE ${gcs_path}
+      gcloud storage cp --recursive --print-created-message "notebooks/" ${gcs_path}notebooks/
 
     done
 

.kokoro/trampoline_v2.sh

@@ -26,8 +26,8 @@
 # To run this script, first download few files from gcs to /dev/shm.
 # (/dev/shm is passed into the container as KOKORO_GFILE_DIR).
 #
-# gsutil cp gs://cloud-devrel-kokoro-resources/python-docs-samples/secrets_viewer_service_account.json /dev/shm
-# gsutil cp gs://cloud-devrel-kokoro-resources/python-docs-samples/automl_secrets.txt /dev/shm
+# gcloud storage cp gs://cloud-devrel-kokoro-resources/python-docs-samples/secrets_viewer_service_account.json /dev/shm
+# gcloud storage cp gs://cloud-devrel-kokoro-resources/python-docs-samples/automl_secrets.txt /dev/shm
 #
 # Then run the script.
 # .kokoro/trampoline_v2.sh

.pre-commit-config.yaml

@@ -32,7 +32,7 @@ repos:
     -   id: isort
         name: isort (python)
 -   repo: https://github.com/psf/black
-    rev: 22.3.0
+    rev: 23.7.0
     hooks:
     - id: black
 -   repo: https://github.com/pycqa/flake8

CONTRIBUTING.rst

@@ -22,7 +22,7 @@ In order to add a feature:
   documentation.
 
 - The feature must work fully on the following CPython versions:
-  3.10, 3.11, 3.12 and 3.13 on both UNIX and Windows.
+  3.10, 3.11, 3.12, 3.13 and 3.14 on both UNIX and Windows.
 
 - The feature must not add unnecessary dependencies (where
   "unnecessary" is of course subjective, but new dependencies should
@@ -72,7 +72,7 @@ We use `nox <https://nox.readthedocs.io/en/latest/>`__ to instrument our tests.
 
 - To run a single unit test::
 
-    $ nox -s unit-3.13 -- -k <name of test>
+    $ nox -s unit-3.14 -- -k <name of test>
 
 
   .. note::
@@ -143,12 +143,12 @@ Running System Tests
    $ nox -s system
 
    # Run a single system test
-   $ nox -s system-3.13 -- -k <name of test>
+   $ nox -s system-3.14 -- -k <name of test>
 
 
   .. note::
 
-      System tests are only configured to run under Python 3.10, 3.11, 3.12 and 3.13.
+      System tests are only configured to run under Python 3.10, 3.12 and 3.14.
       For expediency, we do not run them in older versions of Python 3.
 
   This alone will not run the tests. You'll need to change some local
@@ -262,11 +262,13 @@ We support:
 -  `Python 3.11`_
 -  `Python 3.12`_
 -  `Python 3.13`_
+-  `Python 3.14`_
 
 .. _Python 3.10: https://docs.python.org/3.10/
 .. _Python 3.11: https://docs.python.org/3.11/
 .. _Python 3.12: https://docs.python.org/3.12/
 .. _Python 3.13: https://docs.python.org/3.13/
+.. _Python 3.14: https://docs.python.org/3.14/
 
 
 Supported versions can be found in our ``noxfile.py`` `config`_.

GEMINI.md

@@ -13,7 +13,7 @@ We use `nox` to instrument our tests.
 - To run a single unit test:
 
   ```bash
-  nox -r -s unit-3.13 -- -k <name of test>
+  nox -r -s unit-3.14 -- -k <name of test>
   ```
 
 - Ignore this step if you lack access to Google Cloud resources. To run system
@@ -23,7 +23,7 @@ We use `nox` to instrument our tests.
    $ nox -r -s system
 
    # Run a single system test
-   $ nox -r -s system-3.13 -- -k <name of test>
+   $ nox -r -s system-3.14 -- -k <name of test>
 
 - The codebase must have better coverage than it had previously after each
   change. You can test coverage via `nox -s unit system cover` (takes a long

README.rst

@@ -1,8 +1,7 @@
-:orphan:
-
 BigQuery DataFrames (BigFrames)
 ===============================
 
+
 |GA| |pypi| |versions|
 
 BigQuery DataFrames (also known as BigFrames) provides a Pythonic DataFrame

bigframes/_config/auth.py

@@ -30,9 +30,9 @@
 _cached_project_default: Optional[str] = None
 
 
-def get_default_credentials_with_project() -> tuple[
-    google.auth.credentials.Credentials, Optional[str]
-]:
+def get_default_credentials_with_project() -> (
+    tuple[google.auth.credentials.Credentials, Optional[str]]
+):
     global _AUTH_LOCK, _cached_credentials, _cached_project_default
 
     with _AUTH_LOCK:

bigframes/_config/experiment_options.py

@@ -72,6 +72,13 @@ def ai_operators(self, value: bool):
 
     @property
     def sql_compiler(self) -> Literal["legacy", "stable", "experimental"]:
+        """Set to 'experimental' to try out the latest in compilation experiments..
+
+        **Examples:**
+
+            >>> import bigframes.pandas as bpd
+            >>> bpd.options.experiments.sql_compiler = 'experimental'  # doctest: +SKIP
+        """
         return self._sql_compiler
 
     @sql_compiler.setter