Move coverage configuration to pyproject.toml (#7038)

* Copy configuration from dev_tools/conf/.coveragerc to pyproject.toml

Configuration verified by comparing output from
`coverage debug --rcfile=dev_tools/conf/.coveragerc config`  and
`coverage debug config`

Partially fixes #6800

* Delete `dev_tools/conf/.coveragerc` and its references

The coverage configuration is now present in pyproject.toml by default.

* Introduce temporary TYPE_CHECKING guarded import

* Revert "Introduce temporary TYPE_CHECKING guarded import"

This reverts commit ef248ea.

Author: pavoljuhas

check/pytest-and-incremental-coverage

@@ -71,9 +71,7 @@ fi
 source dev_tools/pypath || exit $?
 
 # Run tests while producing coverage files.
-check/pytest --cov \
-             --cov-config=dev_tools/conf/.coveragerc \
-             "${PYTEST_ARGS[@]}"
+check/pytest --cov "${PYTEST_ARGS[@]}"
 pytest_result=$?
 
 

check/pytest-changed-files-and-incremental-coverage

@@ -92,8 +92,7 @@ source dev_tools/pypath || exit $?
 # Run tests while producing coverage files.
 check/pytest "${changed_python_tests[@]}" \
     "${cov_changed_python_file_dirs[@]}" \
-    --cov-report=annotate \
-    --cov-config=dev_tools/conf/.coveragerc
+    --cov-report=annotate
 pytest_result=$?
 
 # Analyze coverage files.

dev_tools/bash_scripts_test.py

@@ -344,8 +344,7 @@ def test_pytest_and_incremental_coverage_branch_selection(tmpdir_factory):
     )
     assert result.returncode == 0
     assert result.stdout == (
-        'INTERCEPTED check/pytest '
-        '--cov --cov-config=dev_tools/conf/.coveragerc\n'
+        'INTERCEPTED check/pytest --cov\n'
         'No data to report.\n'
         'INTERCEPTED '
         'python dev_tools/check_incremental_coverage_annotations.py HEAD\n'
@@ -368,8 +367,7 @@ def test_pytest_and_incremental_coverage_branch_selection(tmpdir_factory):
     )
     assert result.returncode == 0
     assert result.stdout == (
-        'INTERCEPTED check/pytest '
-        '--cov --cov-config=dev_tools/conf/.coveragerc\n'
+        'INTERCEPTED check/pytest --cov\n'
         'No data to report.\n'
         'INTERCEPTED '
         'python dev_tools/check_incremental_coverage_annotations.py main\n'
@@ -384,8 +382,7 @@ def test_pytest_and_incremental_coverage_branch_selection(tmpdir_factory):
     )
     assert result.returncode == 0
     assert result.stdout == (
-        'INTERCEPTED check/pytest '
-        '--cov --cov-config=dev_tools/conf/.coveragerc\n'
+        'INTERCEPTED check/pytest --cov\n'
         'No data to report.\n'
         'INTERCEPTED '
         'python dev_tools/check_incremental_coverage_annotations.py origin/main\n'
@@ -400,8 +397,7 @@ def test_pytest_and_incremental_coverage_branch_selection(tmpdir_factory):
     )
     assert result.returncode == 0
     assert result.stdout == (
-        'INTERCEPTED check/pytest '
-        '--cov --cov-config=dev_tools/conf/.coveragerc\n'
+        'INTERCEPTED check/pytest --cov\n'
         'No data to report.\n'
         'INTERCEPTED '
         'python dev_tools/check_incremental_coverage_annotations.py upstream/main\n'
@@ -416,8 +412,7 @@ def test_pytest_and_incremental_coverage_branch_selection(tmpdir_factory):
     )
     assert result.returncode == 0
     assert result.stdout == (
-        'INTERCEPTED check/pytest '
-        '--cov --cov-config=dev_tools/conf/.coveragerc\n'
+        'INTERCEPTED check/pytest --cov\n'
         'No data to report.\n'
         'INTERCEPTED '
         'python dev_tools/check_incremental_coverage_annotations.py upstream/main\n'
@@ -444,8 +439,7 @@ def test_pytest_and_incremental_coverage_branch_selection(tmpdir_factory):
     )
     assert result.returncode == 0
     assert result.stdout == (
-        'INTERCEPTED check/pytest '
-        '--cov --cov-config=dev_tools/conf/.coveragerc\n'
+        'INTERCEPTED check/pytest --cov\n'
         'No data to report.\n'
         'INTERCEPTED '
         'python dev_tools/check_incremental_coverage_annotations.py HEAD\n'
@@ -460,8 +454,7 @@ def test_pytest_and_incremental_coverage_branch_selection(tmpdir_factory):
     )
     assert result.returncode == 0
     assert result.stdout == (
-        'INTERCEPTED check/pytest '
-        '--cov --cov-config=dev_tools/conf/.coveragerc\n'
+        'INTERCEPTED check/pytest --cov\n'
         'No data to report.\n'
         'INTERCEPTED '
         'python dev_tools/check_incremental_coverage_annotations.py main\n'
@@ -483,8 +476,7 @@ def test_pytest_and_incremental_coverage_branch_selection(tmpdir_factory):
     )
     assert result.returncode == 0
     assert result.stdout.startswith(
-        'INTERCEPTED check/pytest '
-        '--cov --cov-config=dev_tools/conf/.coveragerc\n'
+        'INTERCEPTED check/pytest --cov\n'
         'No data to report.\n'
         'INTERCEPTED '
         'python dev_tools/check_incremental_coverage_annotations.py '

dev_tools/conf/.coveragerc

@@ -4,6 +4,22 @@ target_version = ['py310', 'py311', 'py312']
 skip-string-normalization = true
 skip-magic-trailing-comma = true
 
+
+[tool.coverage.run]
+include = [
+    # Omit files outside the current working directory.
+    # Note: this means coverage must be run from the cirq repo root.
+    # Failure to do so will result in false positives.
+    "./*",
+]
+omit = ["benchmarks/*"]
+
+[tool.coverage.report]
+exclude_also = [
+    "if TYPE_CHECKING:",
+]
+
+
 [tool.pytest.ini_options]
 filterwarnings = [
     "ignore:Matplotlib is currently using agg:UserWarning",