chore(migration): Migrate code from googleapis/python-bigquery-magics into packages/bigquery-magics (#16005)

See #14911. 

This PR should be merged with a merge-commit, not a squash-commit, in
order to preserve the git history.

Author: parthea

.librarian/state.yaml

@@ -1,5 +1,14 @@
 image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator@sha256:160860d189ff1c2f7515638478823712fa5b243e27ccc33a2728669fa1e2ed0c
 libraries:
+  - id: bigquery-magics
+    version: 0.12.1
+    last_generated_commit: ""
+    apis: []
+    source_roots:
+      - packages/bigquery-magics
+    preserve_regex: []
+    remove_regex: []
+    tag_format: '{id}-v{version}'
   - id: db-dtypes
     version: 1.5.0
     last_generated_commit: ""

packages/bigquery-magics/.coveragerc

@@ -0,0 +1,39 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright 2024 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
+#
+# 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.
+
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+omit =
+  google/__init__.py
+  google/cloud/__init__.py
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
+  google/cloud/__init__.py

packages/bigquery-magics/.flake8

@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright 2024 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
+#
+# 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.
+
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E231, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  **/services/**
+  **/types/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  **/.nox/**
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py

packages/bigquery-magics/.repo-metadata.json

@@ -0,0 +1,16 @@
+{
+    "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"
+}

packages/bigquery-magics/CHANGELOG.md

@@ -0,0 +1,163 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/bigquery-magics/#history
+
+## [0.12.1](https://github.com/googleapis/python-bigquery-magics/compare/v0.12.0...v0.12.1) (2026-02-25)
+
+
+### Bug Fixes
+
+* usability improvement to the graph visualizer (#215) ([7655ada777d16f6514040747855fd1f0e9d77b1b](https://github.com/googleapis/python-bigquery-magics/commit/7655ada777d16f6514040747855fd1f0e9d77b1b))
+
+## [0.12.0](https://github.com/googleapis/python-bigquery-magics/compare/v0.11.0...v0.12.0) (2026-02-10)
+
+
+### Features
+
+* support schema view (#211) ([8e1883ee553a5ca4a31c0ad3affbbfd96433a6d2](https://github.com/googleapis/python-bigquery-magics/commit/8e1883ee553a5ca4a31c0ad3affbbfd96433a6d2))
+* remove bqsql magic to make that name available for bigframes (#210) ([c46c94af3a7e8d9632e2abed0198bc070a1fa2cf](https://github.com/googleapis/python-bigquery-magics/commit/c46c94af3a7e8d9632e2abed0198bc070a1fa2cf))
+
+
+### Bug Fixes
+
+* reduce conflicts between Spanner and BigQuery graph visualization on Colab (#209) ([7dca7b13164953bd07929c5313648184d44a422f](https://github.com/googleapis/python-bigquery-magics/commit/7dca7b13164953bd07929c5313648184d44a422f))
+
+## [0.11.0](https://github.com/googleapis/google-cloud-python/compare/bigquery-magics-v0.10.3...bigquery-magics-v0.11.0) (2025-12-16)
+
+
+### Features
+
+* support python 3.14 (#165) ([8ee73ecf20636eed124b80f76a364ca990acd5fe](https://github.com/googleapis/google-cloud-python/commit/8ee73ecf20636eed124b80f76a364ca990acd5fe))
+
+## [0.10.3](https://github.com/googleapis/python-bigquery-magics/compare/v0.10.2...v0.10.3) (2025-08-21)
+
+
+### Bug Fixes
+
+* Convert property fields in graph visualization to strings before sending them to JavaScript ([#133](https://github.com/googleapis/python-bigquery-magics/issues/133)) ([f869a61](https://github.com/googleapis/python-bigquery-magics/commit/f869a61369801f1e6fee56d6dcb51b647d16df95))
+
+## [0.10.2](https://github.com/googleapis/python-bigquery-magics/compare/v0.10.1...v0.10.2) (2025-08-04)
+
+
+### Dependencies
+
+* Drop support for Python 3.7 and 3.8 ([#127](https://github.com/googleapis/python-bigquery-magics/issues/127)) ([2a8e9de](https://github.com/googleapis/python-bigquery-magics/commit/2a8e9debe32f4f406e41072ee56bb954656af3de))
+* Make graph features compatible with `spanner-graph-notebook >= 1.1.7` ([#131](https://github.com/googleapis/python-bigquery-magics/issues/131)) ([f6f6d70](https://github.com/googleapis/python-bigquery-magics/commit/f6f6d70f575113e192107dce13a0f93b853b0ad3))
+
+## [0.10.1](https://github.com/googleapis/python-bigquery-magics/compare/v0.10.0...v0.10.1) (2025-07-07)
+
+
+### Dependencies
+
+* Move spanner-graph-notebook back to version 1.1.6 ([#126](https://github.com/googleapis/python-bigquery-magics/issues/126)) ([17ee695](https://github.com/googleapis/python-bigquery-magics/commit/17ee6956c8fec740440836609a9106e900b63074))
+
+## [0.10.0](https://github.com/googleapis/python-bigquery-magics/compare/v0.9.0...v0.10.0) (2025-05-16)
+
+
+### Features
+
+* Instrument vscode, jupyter and 3p plugin usage ([#115](https://github.com/googleapis/python-bigquery-magics/issues/115)) ([0dd163f](https://github.com/googleapis/python-bigquery-magics/commit/0dd163f3e5a2627e21b7d2d91ad1eefcd662b7a0))
+
+## [0.9.0](https://github.com/googleapis/python-bigquery-magics/compare/v0.8.1...v0.9.0) (2025-03-26)
+
+
+### Features
+
+* Add --pyformat option to use Python string formatting ([#111](https://github.com/googleapis/python-bigquery-magics/issues/111)) ([bd15a5b](https://github.com/googleapis/python-bigquery-magics/commit/bd15a5b941d14212c6bfaad84b0bc4cfd3220a0f))
+
+## [0.8.1](https://github.com/googleapis/python-bigquery-magics/compare/v0.8.0...v0.8.1) (2025-03-21)
+
+
+### Bug Fixes
+
+* Remove setup.cfg configuration for creating universal wheels ([#106](https://github.com/googleapis/python-bigquery-magics/issues/106)) ([fe3ec29](https://github.com/googleapis/python-bigquery-magics/commit/fe3ec29fefb7ca9195484d13f2bf15c65cf20614))
+
+
+### Dependencies
+
+* Bump minimum required version of spanner-graph-notebook to 1.1.5 ([#110](https://github.com/googleapis/python-bigquery-magics/issues/110)) ([756ac0d](https://github.com/googleapis/python-bigquery-magics/commit/756ac0d0910a0622aee88ed558886456311976e9))
+
+## [0.8.0](https://github.com/googleapis/python-bigquery-magics/compare/v0.7.0...v0.8.0) (2025-03-13)
+
+
+### Features
+
+* Fix graph visualization to work with latest spanner-graph-notebook code; also, allow visualization when only some columns are json. ([#102](https://github.com/googleapis/python-bigquery-magics/issues/102)) ([c33297c](https://github.com/googleapis/python-bigquery-magics/commit/c33297cf2a1db9a0bd2e8c078be1e06239122459))
+* Support multiple columns in graph visualization ([#100](https://github.com/googleapis/python-bigquery-magics/issues/100)) ([dbb6442](https://github.com/googleapis/python-bigquery-magics/commit/dbb64426dd617697785bccf15d98c32f8217c33e))
+
+## [0.7.0](https://github.com/googleapis/python-bigquery-magics/compare/v0.6.0...v0.7.0) (2025-03-11)
+
+
+### Features
+
+* Support visualization of graph queries by adding the --graph argument. ([#94](https://github.com/googleapis/python-bigquery-magics/issues/94)) ([3c054f5](https://github.com/googleapis/python-bigquery-magics/commit/3c054f5e27b5097c18899ff732fccebdf36b47e6))
+
+
+### Bug Fixes
+
+* Resolve issue where pre-release versions of dependencies are installed ([#97](https://github.com/googleapis/python-bigquery-magics/issues/97)) ([79c59e7](https://github.com/googleapis/python-bigquery-magics/commit/79c59e7b8ceba6f2be1fbe16d12b69b5a0b4d774))
+
+## [0.6.0](https://github.com/googleapis/python-bigquery-magics/compare/v0.5.0...v0.6.0) (2025-02-12)
+
+
+### Features
+
+* Add '--use-geodataframe' argument to return a GeoDataFrame ([#91](https://github.com/googleapis/python-bigquery-magics/issues/91)) ([fc04f34](https://github.com/googleapis/python-bigquery-magics/commit/fc04f343d0e9c5c6b11e784d698c28865c2909cd))
+* Add an is_registered global value to indicate whether the extension has been loaded ([#83](https://github.com/googleapis/python-bigquery-magics/issues/83)) ([0bc4473](https://github.com/googleapis/python-bigquery-magics/commit/0bc4473d550c612241ea1428f7538938257b2656))
+
+## [0.5.0](https://github.com/googleapis/python-bigquery-magics/compare/v0.4.0...v0.5.0) (2024-12-17)
+
+
+### Features
+
+* Add `%%bqsql` as an alias to the `%%bigquery` magic ([#72](https://github.com/googleapis/python-bigquery-magics/issues/72)) ([03fe1d5](https://github.com/googleapis/python-bigquery-magics/commit/03fe1d544ef22865c07c680873f980c64bbc7abc))
+* Add `bigquery_magics.context.default_variable` option ([#70](https://github.com/googleapis/python-bigquery-magics/issues/70)) ([72ed882](https://github.com/googleapis/python-bigquery-magics/commit/72ed882c9359718a702bab2bca76933548650064))
+
+## [0.4.0](https://github.com/googleapis/python-bigquery-magics/compare/v0.3.0...v0.4.0) (2024-09-24)
+
+
+### Features
+
+* Add support for overriding `context.engine` by magic argument ([#60](https://github.com/googleapis/python-bigquery-magics/issues/60)) ([ff57f14](https://github.com/googleapis/python-bigquery-magics/commit/ff57f14aa43c60ffc02b8966da2405c31ea42c64))
+
+## [0.3.0](https://github.com/googleapis/python-bigquery-magics/compare/v0.2.0...v0.3.0) (2024-09-20)
+
+
+### Features
+
+* Add support for BigQuery DataFrames. Set `context.engine` to 'bigframes' to support query results larger than 10 GB ([#58](https://github.com/googleapis/python-bigquery-magics/issues/58)) ([90ba05f](https://github.com/googleapis/python-bigquery-magics/commit/90ba05f3d918979788e01b0cd3201ac8f01741a9))
+
+## [0.2.0](https://github.com/googleapis/python-bigquery-magics/compare/v0.1.1...v0.2.0) (2024-08-27)
+
+
+### Features
+
+* Depend on pydata-google-auth to fetch credentials ([#49](https://github.com/googleapis/python-bigquery-magics/issues/49)) ([8db23fc](https://github.com/googleapis/python-bigquery-magics/commit/8db23fc60624baae9c0dffd500d8856cb6e92f42))
+
+## [0.1.1](https://github.com/googleapis/python-bigquery-magics/compare/v0.1.0...v0.1.1) (2024-08-22)
+
+
+### Dependencies
+
+* Depend on ipykernel 5.5.6+ instead of 6.0+ ([83d8fac](https://github.com/googleapis/python-bigquery-magics/commit/83d8facf6d04752c1f8c5e25575a3975c9b30e1c))
+
+
+### Documentation
+
+* Correct links to project pages in README ([#33](https://github.com/googleapis/python-bigquery-magics/issues/33)) ([ace5020](https://github.com/googleapis/python-bigquery-magics/commit/ace5020ff8ae374145579e75cb996150680f2bde))
+* Update the IPython Magics docs ([#27](https://github.com/googleapis/python-bigquery-magics/issues/27)) ([62e88b3](https://github.com/googleapis/python-bigquery-magics/commit/62e88b3f4a595ecdc4a00d661b956c5d50fd6c35))
+
+## 0.1.0 (2024-04-25)
+
+
+### Features
+
+* Initial copy from google-cloud-bigquery ([4a69d26](https://github.com/googleapis/python-bigquery-magics/commit/4a69d26ae3e5e7c659c7b79ac935393abb4146e3))
+
+
+### Documentation
+
+* Clean up docs and let the nox pass ([#24](https://github.com/googleapis/python-bigquery-magics/issues/24)) ([275712f](https://github.com/googleapis/python-bigquery-magics/commit/275712f4e4b647cda2d253e1f6b7a2fa093ee7c1))
+* Reset the changelog for the new package ([#22](https://github.com/googleapis/python-bigquery-magics/issues/22)) ([f7d9c14](https://github.com/googleapis/python-bigquery-magics/commit/f7d9c1445feac32e468a3e06ca55c9474a1ae548))

packages/bigquery-magics/CONTRIBUTING.md

@@ -0,0 +1,28 @@
+# How to Contribute
+
+We'd love to accept your patches and contributions to this project. There are
+just a few small guidelines you need to follow.
+
+## Contributor License Agreement
+
+Contributions to this project must be accompanied by a Contributor License
+Agreement. You (or your employer) retain the copyright to your contribution;
+this simply gives us permission to use and redistribute your contributions as
+part of the project. Head over to <https://cla.developers.google.com/> to see
+your current agreements on file or to sign a new one.
+
+You generally only need to submit a CLA once, so if you've already submitted one
+(even if it was for a different project), you probably don't need to do it
+again.
+
+## Code Reviews
+
+All submissions, including submissions by project members, require review. We
+use GitHub pull requests for this purpose. Consult
+[GitHub Help](https://help.github.com/articles/about-pull-requests/) for more
+information on using pull requests.
+
+## Community Guidelines
+
+This project follows [Google's Open Source Community
+Guidelines](https://opensource.google/conduct/).