Rename branch master to main

.github/workflows/ci-build-checks.yaml

@@ -18,12 +18,77 @@ run-name: Continuous integration build and test
 on:
   pull_request:
     branches:
-      - master
+      - main
 
   merge_group:
     types:
       - checks_requested
 
+  push:
+    branches:
+      - main
+
+  # Allow manual invocation, with options that can be useful for debugging.
+  workflow_dispatch:
+    inputs:
+      sha:
+        description: 'SHA of commit to run against:'
+        type: string
+        required: true
+
+      python_ver:
+        description: 'Python version:'
+        type: string
+        default: '3.10.15'
+
+      extra_bazel_options:
+        description: 'Extra Bazel options:'
+        type: string
+
+      remake_python_cache:
+        description: 'Delete & remake the Python cache'
+        type: boolean
+        default: false
+
+      debug:
+        description: 'Print additional workflow info'
+        type: boolean
+        default: false
+
+env:
+  # Default Python version to use. Important: give it a full x.y.z number.
+  python_ver: '3.10.15'
+
+  # Additional .bazelrc options to use.
+  bazelrc_additions: |
+    common -c opt
+    common --announce_rc
+    common --color=no
+    common --experimental_repo_remote_exec
+    common --remote_upload_local_results=false
+    common --cxxopt="-D_GLIBCXX_USE_CXX11_ABI=1"
+    common --cxxopt="-std=c++17"
+    common --cxxopt="-msse2"
+    common --cxxopt="-msse3"
+    common --cxxopt="-msse4"
+    build --verbose_failures
+    build --auto_output_filter=none
+    build --show_progress_rate_limit=1
+    test --test_output=errors
+    test --test_summary=detailed
+
+  # Note: these regexes are Bash regex syntax, NOT path glob syntax.
+  # Also, do not put dashes in front of the values.
+  ignore_patterns: |-
+    .*\.md$
+    .*\.jpg$
+    .*\.png$
+    ^\.gitignore
+    ^\.pylintrc
+    ^\.yamllint.yaml
+    ^\.github/problem-matchers/.*
+    ^benchmarks/.*
+
 concurrency:
   cancel-in-progress: true
   group: ${{github.workflow}}-${{github.event.pull_request.number||github.ref}}

.github/workflows/ci-file-checks.yaml

@@ -32,15 +32,15 @@ on:
   pull_request:
     types: [opened, synchronize]
     branches:
-      - master
+      - main
 
   merge_group:
     types:
       - checks_requested
 
   push:
     branches:
-      - master
+      - main
 
   # Allow manual invocation, with options that can be useful for debugging.
   workflow_dispatch:

README.md

@@ -7,7 +7,7 @@ src="docs/images/logo/tf_quantum1.svg">
 High-performance Python framework for hybrid quantum-classical machine learning
 
 [![Licensed under the Apache 2.0
-license](https://img.shields.io/badge/License-Apache%202.0-3c60b1.svg?logo=opensourceinitiative&logoColor=white&style=flat-square)](https://github.com/tensorflow/quantum/blob/master/LICENSE)
+license](https://img.shields.io/badge/License-Apache%202.0-3c60b1.svg?logo=opensourceinitiative&logoColor=white&style=flat-square)](https://github.com/tensorflow/quantum/blob/main/LICENSE)
 [![Compatible with Python versions 3.10 and
 higher](https://img.shields.io/badge/Python-3.10+-fcbc2c.svg?style=flat-square&logo=python&logoColor=white)](https://www.python.org/downloads/)
 [![TensorFlow Quantum project on
@@ -84,7 +84,7 @@ including tutorials and API documentation, can be found online at the
 TensorFlow.org web site.
 
 All of the examples can be found in GitHub in the form of [Python notebook
-tutorials](https://github.com/tensorflow/quantum/tree/master/docs/tutorials)
+tutorials](https://github.com/tensorflow/quantum/tree/main/docs/tutorials)
 
 ## Getting help
 

docs/design.md

@@ -76,7 +76,7 @@ with AVX2 and SSE instructions). Ops with identical functional signatures were
 created that use a physical quantum computer. Switching between a simulated and
 physical quantum computer is as easy as changing a single line of code. These
 ops are located in the
-<a href="https://github.com/tensorflow/quantum/blob/master/tensorflow_quantum/core/ops/circuit_execution_ops.py" class="external"><code>circuit_execution_ops.py</code></a>.
+<a href="https://github.com/tensorflow/quantum/blob/main/tensorflow_quantum/core/ops/circuit_execution_ops.py" class="external"><code>circuit_execution_ops.py</code></a>.
 
 ### Layers
 

docs/install.md

@@ -5,7 +5,7 @@ There are a few ways to set up your environment to use TensorFlow Quantum (TFQ):
 * The easiest way to learn and use TFQ requires no installation—run the
   [TensorFlow Quantum tutorials](./tutorials/hello_many_worlds.ipynb) directly
   in your browser using
-  [Google Colab](https://colab.research.google.com/github/tensorflow/quantum/blob/master/docs/tutorials/hello_many_worlds.ipynb).
+  [Google Colab](https://colab.research.google.com/github/tensorflow/quantum/blob/main/docs/tutorials/hello_many_worlds.ipynb).
 * To use TensorFlow Quantum on a local machine, install the TFQ package using
   Python's pip package manager.
 * Or build TensorFlow Quantum from source.

docs/tutorials/barren_plateaus.ipynb

@@ -1,4 +1,4 @@
-{
+{
  "cells": [
   {
    "cell_type": "markdown",
@@ -56,10 +56,10 @@
     "    <a target=\"_blank\" href=\"https://www.tensorflow.org/quantum/tutorials/barren_plateaus\"><img src=\"https://www.tensorflow.org/images/tf_logo_32px.png\" />View on TensorFlow.org</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/master/docs/tutorials/barren_plateaus.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
+    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/main/docs/tutorials/barren_plateaus.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/master/docs/tutorials/barren_plateaus.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
+    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/main/docs/tutorials/barren_plateaus.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
     "  </td>\n",
     "  <td>\n",
     "    <a href=\"https://storage.googleapis.com/tensorflow_docs/quantum/docs/tutorials/barren_plateaus.ipynb\"><img src=\"https://www.tensorflow.org/images/download_logo_32px.png\" />Download notebook</a>\n",

docs/tutorials/gradients.ipynb

@@ -1,4 +1,4 @@
-{
+{
  "cells": [
   {
    "cell_type": "markdown",
@@ -56,10 +56,10 @@
     "    <a target=\"_blank\" href=\"https://www.tensorflow.org/quantum/tutorials/gradients\"><img src=\"https://www.tensorflow.org/images/tf_logo_32px.png\" />View on TensorFlow.org</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/master/docs/tutorials/gradients.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
+    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/main/docs/tutorials/gradients.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/master/docs/tutorials/gradients.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
+    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/main/docs/tutorials/gradients.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
     "  </td>\n",
     "  <td>\n",
     "    <a href=\"https://storage.googleapis.com/tensorflow_docs/quantum/docs/tutorials/gradients.ipynb\"><img src=\"https://www.tensorflow.org/images/download_logo_32px.png\" />Download notebook</a>\n",

docs/tutorials/hello_many_worlds.ipynb

@@ -1,4 +1,4 @@
-{
+{
  "cells": [
   {
    "cell_type": "markdown",
@@ -59,10 +59,10 @@
     "    <a target=\"_blank\" href=\"https://www.tensorflow.org/quantum/tutorials/hello_many_worlds\"><img src=\"https://www.tensorflow.org/images/tf_logo_32px.png\" />View on TensorFlow.org</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/master/docs/tutorials/hello_many_worlds.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
+    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/main/docs/tutorials/hello_many_worlds.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/master/docs/tutorials/hello_many_worlds.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
+    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/main/docs/tutorials/hello_many_worlds.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
     "  </td>\n",
     "  <td>\n",
     "    <a href=\"https://storage.googleapis.com/tensorflow_docs/quantum/docs/tutorials/hello_many_worlds.ipynb\"><img src=\"https://www.tensorflow.org/images/download_logo_32px.png\" />Download notebook</a>\n",

docs/tutorials/mnist.ipynb

@@ -1,4 +1,4 @@
-{
+{
  "cells": [
   {
    "cell_type": "markdown",
@@ -56,10 +56,10 @@
     "    <a target=\"_blank\" href=\"https://www.tensorflow.org/quantum/tutorials/mnist\"><img src=\"https://www.tensorflow.org/images/tf_logo_32px.png\" />View on TensorFlow.org</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/master/docs/tutorials/mnist.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
+    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/main/docs/tutorials/mnist.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/master/docs/tutorials/mnist.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
+    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/main/docs/tutorials/mnist.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
     "  </td>\n",
     "  <td>\n",
     "    <a href=\"https://storage.googleapis.com/tensorflow_docs/quantum/docs/tutorials/mnist.ipynb\"><img src=\"https://www.tensorflow.org/images/download_logo_32px.png\" />Download notebook</a>\n",

docs/tutorials/noise.ipynb

@@ -1,4 +1,4 @@
-{
+{
  "cells": [
   {
    "cell_type": "markdown",
@@ -51,10 +51,10 @@
     "    <a target=\"_blank\" href=\"https://www.tensorflow.org/quantum/tutorials/noise\"><img src=\"https://www.tensorflow.org/images/tf_logo_32px.png\" />View on TensorFlow.org</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/master/docs/tutorials/noise.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
+    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/main/docs/tutorials/noise.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/master/docs/tutorials/noise.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
+    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/main/docs/tutorials/noise.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
     "  </td>\n",
     "  <td>\n",
     "    <a href=\"https://storage.googleapis.com/tensorflow_docs/quantum/docs/tutorials/noise.ipynb\"><img src=\"https://www.tensorflow.org/images/download_logo_32px.png\" />Download notebook</a>\n",

docs/tutorials/qcnn.ipynb

@@ -1,4 +1,4 @@
-{
+{
  "cells": [
   {
    "cell_type": "markdown",
@@ -59,10 +59,10 @@
     "    <a target=\"_blank\" href=\"https://www.tensorflow.org/quantum/tutorials/qcnn\"><img src=\"https://www.tensorflow.org/images/tf_logo_32px.png\" />View on TensorFlow.org</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/master/docs/tutorials/qcnn.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
+    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/main/docs/tutorials/qcnn.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/master/docs/tutorials/qcnn.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
+    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/main/docs/tutorials/qcnn.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
     "  </td>\n",
     "  <td>\n",
     "    <a href=\"https://storage.googleapis.com/tensorflow_docs/quantum/docs/tutorials/qcnn.ipynb\"><img src=\"https://www.tensorflow.org/images/download_logo_32px.png\" />Download notebook</a>\n",

docs/tutorials/quantum_data.ipynb

@@ -1,4 +1,4 @@
-{
+{
  "cells": [
   {
    "cell_type": "markdown",
@@ -56,10 +56,10 @@
     "    <a target=\"_blank\" href=\"https://www.tensorflow.org/quantum/tutorials/quantum_data\"><img src=\"https://www.tensorflow.org/images/tf_logo_32px.png\" />View on TensorFlow.org</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/master/docs/tutorials/quantum_data.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
+    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/main/docs/tutorials/quantum_data.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/master/docs/tutorials/quantum_data.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
+    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/main/docs/tutorials/quantum_data.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
     "  </td>\n",
     "  <td>\n",
     "    <a href=\"https://storage.googleapis.com/tensorflow_docs/quantum/docs/tutorials/quantum_data.ipynb\"><img src=\"https://www.tensorflow.org/images/download_logo_32px.png\" />Download notebook</a>\n",

docs/tutorials/quantum_reinforcement_learning.ipynb

@@ -1,4 +1,4 @@
-{
+{
  "cells": [
   {
    "cell_type": "markdown",
@@ -50,10 +50,10 @@
     "    <a target=\"_blank\" href=\"https://www.tensorflow.org/quantum/tutorials/quantum_reinforcement_learning\"><img src=\"https://www.tensorflow.org/images/tf_logo_32px.png\" />View on TensorFlow.org</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/master/docs/tutorials/quantum_reinforcement_learning.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
+    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/main/docs/tutorials/quantum_reinforcement_learning.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/master/docs/tutorials/quantum_reinforcement_learning.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
+    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/main/docs/tutorials/quantum_reinforcement_learning.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
     "  </td>\n",
     "  <td>\n",
     "    <a href=\"https://storage.googleapis.com/tensorflow_docs/quantum/docs/tutorials/quantum_reinforcement_learning.ipynb\"><img src=\"https://www.tensorflow.org/images/download_logo_32px.png\" />Download notebook</a>\n",

docs/tutorials/research_tools.ipynb

@@ -1,4 +1,4 @@
-{
+{
  "cells": [
   {
    "cell_type": "markdown",
@@ -51,10 +51,10 @@
     "    <a target=\"_blank\" href=\"https://www.tensorflow.org/quantum/tutorials/research_tools\"><img src=\"https://www.tensorflow.org/images/tf_logo_32px.png\" />View on TensorFlow.org</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/master/docs/tutorials/research_tools.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
+    "    <a target=\"_blank\" href=\"https://colab.research.google.com/github/tensorflow/quantum/blob/main/docs/tutorials/research_tools.ipynb\"><img src=\"https://www.tensorflow.org/images/colab_logo_32px.png\" />Run in Google Colab</a>\n",
     "  </td>\n",
     "  <td>\n",
-    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/master/docs/tutorials/research_tools.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
+    "    <a target=\"_blank\" href=\"https://github.com/tensorflow/quantum/blob/main/docs/tutorials/research_tools.ipynb\"><img src=\"https://www.tensorflow.org/images/GitHub-Mark-32px.png\" />View source on GitHub</a>\n",
     "  </td>\n",
     "  <td>\n",
     "    <a href=\"https://storage.googleapis.com/tensorflow_docs/quantum/docs/tutorials/research_tools.ipynb\"><img src=\"https://www.tensorflow.org/images/download_logo_32px.png\" />Download notebook</a>\n",

scripts/build_docs.py

@@ -31,7 +31,7 @@
 flags.DEFINE_string("output_dir", "/tmp/tfq_api", "Where to output the docs")
 
 flags.DEFINE_string("code_url_prefix",
-                    ("https://github.com/tensorflow/quantum/tree/master/"
+                    ("https://github.com/tensorflow/quantum/tree/main/"
                      "tensorflow_quantum"), "The url prefix for links to code.")
 
 flags.DEFINE_bool("search_hints", True,