cirq-core 1.5.0.dev20250403170622__py3-none-any.whl → 1.5.0.dev20250404165440__py3-none-any.whl

cirq/contrib/routing/greedy.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 import itertools
 from typing import (
     Callable,
@@ -109,7 +111,7 @@ class _GreedyRouter:
             op1.qubits
         )
         & set(op2.qubits),
-        random_state: 'cirq.RANDOM_STATE_OR_SEED_LIKE' = None,
+        random_state: cirq.RANDOM_STATE_OR_SEED_LIKE = None,
     ):
 
         self.prng = value.parse_random_state(random_state)
@@ -148,12 +150,12 @@ class _GreedyRouter:
             ]
         return self.edge_sets[edge_set_size]
 
-    def log_to_phys(self, *qubits: 'cirq.Qid') -> Iterable[ops.Qid]:
+    def log_to_phys(self, *qubits: cirq.Qid) -> Iterable[ops.Qid]:
         """Returns an iterator over the physical qubits mapped to by the given
         logical qubits."""
         return (self._log_to_phys[q] for q in qubits)
 
-    def phys_to_log(self, *qubits: 'cirq.Qid') -> Iterable[Optional[ops.Qid]]:
+    def phys_to_log(self, *qubits: cirq.Qid) -> Iterable[Optional[ops.Qid]]:
         """Returns an iterator over the logical qubits that map to the given
         physical qubits."""
         return (self._phys_to_log[q] for q in qubits)

cirq/contrib/routing/initialization.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 import itertools
 from typing import cast, Dict, Hashable, TYPE_CHECKING
 
@@ -32,7 +34,7 @@ def get_center(graph: nx.Graph) -> Hashable:
 def get_initial_mapping(
     logical_graph: nx.Graph,
     device_graph: nx.Graph,
-    random_state: 'cirq.RANDOM_STATE_OR_SEED_LIKE' = None,
+    random_state: cirq.RANDOM_STATE_OR_SEED_LIKE = None,
 ) -> Dict[ops.Qid, ops.Qid]:
     """Gets an initial mapping of logical to physical qubits for routing.
 

cirq/contrib/routing/swap_network.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 from typing import Dict, Iterable, TYPE_CHECKING
 
 import cirq.contrib.acquaintance as cca
@@ -35,20 +37,18 @@ class SwapNetwork:
         initial_mapping: The initial mapping from physical to logical qubits.
     """
 
-    def __init__(
-        self, circuit: 'cirq.Circuit', initial_mapping: Dict['cirq.Qid', 'cirq.Qid']
-    ) -> None:
+    def __init__(self, circuit: cirq.Circuit, initial_mapping: Dict[cirq.Qid, cirq.Qid]) -> None:
         if not all(isinstance(i, ops.Qid) for I in initial_mapping.items() for i in I):
             raise ValueError('Mapping must be from Qids to Qids.')
         self.circuit = circuit
         self.initial_mapping = initial_mapping
 
-    def final_mapping(self) -> Dict['cirq.Qid', 'cirq.Qid']:
+    def final_mapping(self) -> Dict[cirq.Qid, cirq.Qid]:
         mapping = dict(self.initial_mapping)
         cca.update_mapping(mapping, self.circuit.all_operations())
         return mapping
 
-    def get_logical_operations(self) -> Iterable['cirq.Operation']:
+    def get_logical_operations(self) -> Iterable[cirq.Operation]:
         return cca.get_logical_operations(self.circuit.all_operations(), self.initial_mapping)
 
     def __eq__(self, other) -> bool:

cirq/contrib/routing/utils.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 import operator
 import re
 from typing import Callable, Iterable, List, TYPE_CHECKING
@@ -21,10 +23,10 @@ import networkx as nx
 import cirq.contrib.acquaintance as cca
 from cirq import circuits, ops
 from cirq.contrib.circuitdag import CircuitDag
-from cirq.contrib.routing.swap_network import SwapNetwork
 
 if TYPE_CHECKING:
     import cirq
+    from cirq.contrib.routing import SwapNetwork
 
 BINARY_OP_PREDICATE = Callable[[ops.Operation, ops.Operation], bool]
 
@@ -86,7 +88,7 @@ def is_valid_routing(
         raise
 
 
-def get_circuit_connectivity(circuit: 'cirq.Circuit') -> nx.Graph:
+def get_circuit_connectivity(circuit: cirq.Circuit) -> nx.Graph:
     """Return a graph of all 2q interactions in a circuit.
 
     Nodes are qubits and undirected edges correspond to any two-qubit

cirq/contrib/svg/svg.py

@@ -1,4 +1,7 @@
 # pylint: disable=wrong-or-nonexistent-copyright-notice
+
+from __future__ import annotations
+
 from typing import cast, Dict, List, Tuple, TYPE_CHECKING
 
 import matplotlib.font_manager
@@ -59,7 +62,7 @@ def _text(x: float, y: float, text: str, fontsize: int = 14):
 
 
 def _fit_horizontal(
-    tdd: 'cirq.TextDiagramDrawer', ref_boxwidth: float, col_padding: float
+    tdd: cirq.TextDiagramDrawer, ref_boxwidth: float, col_padding: float
 ) -> Tuple[List[float], List[float]]:
     """Figure out the horizontal spacing of columns to fit everything in.
 
@@ -89,7 +92,7 @@ def _fit_horizontal(
 
 
 def _fit_vertical(
-    tdd: 'cirq.TextDiagramDrawer', ref_boxheight: float, row_padding: float
+    tdd: cirq.TextDiagramDrawer, ref_boxheight: float, row_padding: float
 ) -> Tuple[List[float], List[float], Dict[float, int]]:
     """Return data structures used to turn tdd vertical coordinates into
     well-spaced SVG coordinates.
@@ -164,7 +167,7 @@ def _debug_spacing(col_starts, row_starts):  # pragma: no cover
 
 
 def tdd_to_svg(
-    tdd: 'cirq.TextDiagramDrawer',
+    tdd: cirq.TextDiagramDrawer,
     ref_boxwidth: float = 40,
     ref_boxheight: float = 40,
     col_padding: float = 20,
@@ -246,7 +249,7 @@ def tdd_to_svg(
     return t
 
 
-def _validate_circuit(circuit: 'cirq.Circuit'):
+def _validate_circuit(circuit: cirq.Circuit):
     if len(circuit) == 0:
         raise ValueError("Can't draw SVG diagram for empty circuits")
 
@@ -260,14 +263,14 @@ class SVGCircuit:
     which will cause the circuit to be displayed as an SVG image.
     """
 
-    def __init__(self, circuit: 'cirq.Circuit'):
+    def __init__(self, circuit: cirq.Circuit):
         self.circuit = circuit
 
     def _repr_svg_(self) -> str:
         return circuit_to_svg(self.circuit)
 
 
-def circuit_to_svg(circuit: 'cirq.Circuit') -> str:
+def circuit_to_svg(circuit: cirq.Circuit) -> str:
     """Render a circuit as SVG."""
     _validate_circuit(circuit)
     tdd = circuit.to_text_diagram_drawer(transpose=False)

cirq/devices/device.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 import abc
 from typing import FrozenSet, Iterable, Optional, TYPE_CHECKING
 
@@ -57,7 +59,7 @@ class Device(metaclass=abc.ABCMeta):
     """
 
     @property
-    def metadata(self) -> Optional['DeviceMetadata']:
+    def metadata(self) -> Optional[DeviceMetadata]:
         """Returns the associated Metadata with the device if applicable.
 
         Returns:
@@ -65,7 +67,7 @@ class Device(metaclass=abc.ABCMeta):
         """
         return None
 
-    def validate_operation(self, operation: 'cirq.Operation') -> None:
+    def validate_operation(self, operation: cirq.Operation) -> None:
         """Raises an exception if an operation is not valid.
 
         Args:
@@ -75,7 +77,7 @@ class Device(metaclass=abc.ABCMeta):
             ValueError: The operation isn't valid for this device.
         """
 
-    def validate_circuit(self, circuit: 'cirq.AbstractCircuit') -> None:
+    def validate_circuit(self, circuit: cirq.AbstractCircuit) -> None:
         """Raises an exception if a circuit is not valid.
 
         Args:
@@ -87,7 +89,7 @@ class Device(metaclass=abc.ABCMeta):
         for moment in circuit:
             self.validate_moment(moment)
 
-    def validate_moment(self, moment: 'cirq.Moment') -> None:
+    def validate_moment(self, moment: cirq.Moment) -> None:
         """Raises an exception if a moment is not valid.
 
         Args:
@@ -104,7 +106,7 @@ class Device(metaclass=abc.ABCMeta):
 class DeviceMetadata:
     """Parent type for all device specific metadata classes."""
 
-    def __init__(self, qubits: Iterable['cirq.Qid'], nx_graph: 'nx.Graph'):
+    def __init__(self, qubits: Iterable[cirq.Qid], nx_graph: nx.Graph):
         """Construct a DeviceMetadata object.
 
         Args:
@@ -114,11 +116,11 @@ class DeviceMetadata:
                 directional coupling, undirected edges indicate bi-directional
                 coupling.
         """
-        self._qubits_set: FrozenSet['cirq.Qid'] = frozenset(qubits)
+        self._qubits_set: FrozenSet[cirq.Qid] = frozenset(qubits)
         self._nx_graph = nx_graph
 
     @property
-    def qubit_set(self) -> FrozenSet['cirq.Qid']:
+    def qubit_set(self) -> FrozenSet[cirq.Qid]:
         """Returns the set of qubits on the device.
 
         Returns:
@@ -127,7 +129,7 @@ class DeviceMetadata:
         return self._qubits_set
 
     @property
-    def nx_graph(self) -> 'nx.Graph':
+    def nx_graph(self) -> nx.Graph:
         """Returns a nx.Graph where nodes are qubits and edges are couple-able qubits.
 
         Returns:
@@ -150,6 +152,6 @@ class DeviceMetadata:
         return {'qubits': qubits_payload, 'nx_graph': graph_payload}
 
     @classmethod
-    def _from_json_dict_(cls, qubits: Iterable['cirq.Qid'], nx_graph: 'nx.Graph', **kwargs):
+    def _from_json_dict_(cls, qubits: Iterable[cirq.Qid], nx_graph: nx.Graph, **kwargs):
         graph_obj = nx.readwrite.json_graph.node_link_graph(nx_graph)
         return cls(qubits, graph_obj)

cirq/devices/grid_device_metadata.py

@@ -11,8 +11,11 @@
 # 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.
+
 """Metadata subtype for 2D Homogenous devices."""
 
+from __future__ import annotations
+
 from typing import cast, FrozenSet, Iterable, Mapping, Optional, Tuple, TYPE_CHECKING
 
 import networkx as nx
@@ -30,11 +33,11 @@ class GridDeviceMetadata(device.DeviceMetadata):
 
     def __init__(
         self,
-        qubit_pairs: Iterable[Tuple['cirq.GridQubit', 'cirq.GridQubit']],
-        gateset: 'cirq.Gateset',
-        gate_durations: Optional[Mapping['cirq.GateFamily', 'cirq.Duration']] = None,
-        all_qubits: Optional[Iterable['cirq.GridQubit']] = None,
-        compilation_target_gatesets: Iterable['cirq.CompilationTargetGateset'] = (),
+        qubit_pairs: Iterable[Tuple[cirq.GridQubit, cirq.GridQubit]],
+        gateset: cirq.Gateset,
+        gate_durations: Optional[Mapping[cirq.GateFamily, cirq.Duration]] = None,
+        all_qubits: Optional[Iterable[cirq.GridQubit]] = None,
+        compilation_target_gatesets: Iterable[cirq.CompilationTargetGateset] = (),
     ):
         """Create a GridDeviceMetadata object.
 
@@ -115,7 +118,7 @@ class GridDeviceMetadata(device.DeviceMetadata):
         self._gate_durations = gate_durations
 
     @property
-    def qubit_set(self) -> FrozenSet['cirq.GridQubit']:
+    def qubit_set(self) -> FrozenSet[cirq.GridQubit]:
         """Returns the set of grid qubits on the device.
 
         Returns:
@@ -124,7 +127,7 @@ class GridDeviceMetadata(device.DeviceMetadata):
         return cast(FrozenSet['cirq.GridQubit'], super().qubit_set)
 
     @property
-    def qubit_pairs(self) -> FrozenSet[FrozenSet['cirq.GridQubit']]:
+    def qubit_pairs(self) -> FrozenSet[FrozenSet[cirq.GridQubit]]:
         """Returns the set of all couple-able qubits on the device.
 
         Each element in the outer frozenset is a 2-element frozenset representing a bidirectional
@@ -133,22 +136,22 @@ class GridDeviceMetadata(device.DeviceMetadata):
         return self._qubit_pairs
 
     @property
-    def isolated_qubits(self) -> FrozenSet['cirq.GridQubit']:
+    def isolated_qubits(self) -> FrozenSet[cirq.GridQubit]:
         """Returns the set of all isolated qubits on the device (if applicable)."""
         return self._isolated_qubits
 
     @property
-    def gateset(self) -> 'cirq.Gateset':
+    def gateset(self) -> cirq.Gateset:
         """Returns the `cirq.Gateset` of supported gates on this device."""
         return self._gateset
 
     @property
-    def compilation_target_gatesets(self) -> Tuple['cirq.CompilationTargetGateset', ...]:
+    def compilation_target_gatesets(self) -> Tuple[cirq.CompilationTargetGateset, ...]:
         """Returns a sequence of valid `cirq.CompilationTargetGateset`s for this device."""
         return self._compilation_target_gatesets
 
     @property
-    def gate_durations(self) -> Optional[Mapping['cirq.GateFamily', 'cirq.Duration']]:
+    def gate_durations(self) -> Optional[Mapping[cirq.GateFamily, cirq.Duration]]:
         """Get a dictionary mapping from gate family to duration for gates.
 
         To look up the duration of a specific gate instance / gate type / operation which is part of

cirq/devices/grid_qubit.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 import abc
 import functools
 import weakref
@@ -104,17 +106,17 @@ class _BaseGridQid(ops.Qid):
     def dimension(self) -> int:
         return self._dimension
 
-    def with_dimension(self, dimension: int) -> 'GridQid':
+    def with_dimension(self, dimension: int) -> GridQid:
         return GridQid(self._row, self._col, dimension=dimension)
 
-    def is_adjacent(self, other: 'cirq.Qid') -> bool:
+    def is_adjacent(self, other: cirq.Qid) -> bool:
         """Determines if two qubits are adjacent qubits."""
         return (
             isinstance(other, GridQubit)
             and abs(self._row - other._row) + abs(self._col - other._col) == 1
         )
 
-    def neighbors(self, qids: Optional[Iterable[ops.Qid]] = None) -> Set['_BaseGridQid']:
+    def neighbors(self, qids: Optional[Iterable[ops.Qid]] = None) -> Set[_BaseGridQid]:
         """Returns qubits that are potential neighbors to this GridQid
 
         Args:
@@ -204,7 +206,7 @@ class GridQid(_BaseGridQid):
     # Holds weak references so instances can still be garbage collected.
     _cache = weakref.WeakValueDictionary[Tuple[int, int, int], 'cirq.GridQid']()
 
-    def __new__(cls, row: int, col: int, *, dimension: int) -> 'cirq.GridQid':
+    def __new__(cls, row: int, col: int, *, dimension: int) -> cirq.GridQid:
         """Creates a grid qid at the given row, col coordinate
 
         Args:
@@ -234,11 +236,11 @@ class GridQid(_BaseGridQid):
     def __getstate__(self) -> Dict[str, Any]:
         return {}
 
-    def _with_row_col(self, row: int, col: int) -> 'GridQid':
+    def _with_row_col(self, row: int, col: int) -> GridQid:
         return GridQid(row, col, dimension=self._dimension)
 
     @staticmethod
-    def square(diameter: int, top: int = 0, left: int = 0, *, dimension: int) -> List['GridQid']:
+    def square(diameter: int, top: int = 0, left: int = 0, *, dimension: int) -> List[GridQid]:
         """Returns a square of GridQid.
 
         Args:
@@ -254,9 +256,7 @@ class GridQid(_BaseGridQid):
         return GridQid.rect(diameter, diameter, top=top, left=left, dimension=dimension)
 
     @staticmethod
-    def rect(
-        rows: int, cols: int, top: int = 0, left: int = 0, *, dimension: int
-    ) -> List['GridQid']:
+    def rect(rows: int, cols: int, top: int = 0, left: int = 0, *, dimension: int) -> List[GridQid]:
         """Returns a rectangle of GridQid.
 
         Args:
@@ -277,7 +277,7 @@ class GridQid(_BaseGridQid):
         ]
 
     @staticmethod
-    def from_diagram(diagram: str, dimension: int) -> List['GridQid']:
+    def from_diagram(diagram: str, dimension: int) -> List[GridQid]:
         """Parse ASCII art device layout into a device.
 
         As an example, the below diagram will create a list of GridQid in a
@@ -337,9 +337,7 @@ class GridQid(_BaseGridQid):
     def __str__(self) -> str:
         return f"q({self._row}, {self._col}) (d={self._dimension})"
 
-    def _circuit_diagram_info_(
-        self, args: 'cirq.CircuitDiagramInfoArgs'
-    ) -> 'cirq.CircuitDiagramInfo':
+    def _circuit_diagram_info_(self, args: cirq.CircuitDiagramInfoArgs) -> cirq.CircuitDiagramInfo:
         return protocols.CircuitDiagramInfo(
             wire_symbols=(f"({self._row}, {self._col}) (d={self._dimension})",)
         )
@@ -371,7 +369,7 @@ class GridQubit(_BaseGridQid):
     # Holds weak references so instances can still be garbage collected.
     _cache = weakref.WeakValueDictionary[Tuple[int, int], 'cirq.GridQubit']()
 
-    def __new__(cls, row: int, col: int) -> 'cirq.GridQubit':
+    def __new__(cls, row: int, col: int) -> cirq.GridQubit:
         """Creates a grid qubit at the given row, col coordinate
 
         Args:
@@ -396,11 +394,11 @@ class GridQubit(_BaseGridQid):
     def __getstate__(self) -> Dict[str, Any]:
         return {}
 
-    def _with_row_col(self, row: int, col: int) -> 'GridQubit':
+    def _with_row_col(self, row: int, col: int) -> GridQubit:
         return GridQubit(row, col)
 
     @staticmethod
-    def square(diameter: int, top: int = 0, left: int = 0) -> List['GridQubit']:
+    def square(diameter: int, top: int = 0, left: int = 0) -> List[GridQubit]:
         """Returns a square of GridQubits.
 
         Args:
@@ -414,7 +412,7 @@ class GridQubit(_BaseGridQid):
         return GridQubit.rect(diameter, diameter, top=top, left=left)
 
     @staticmethod
-    def rect(rows: int, cols: int, top: int = 0, left: int = 0) -> List['GridQubit']:
+    def rect(rows: int, cols: int, top: int = 0, left: int = 0) -> List[GridQubit]:
         """Returns a rectangle of GridQubits.
 
         Args:
@@ -433,7 +431,7 @@ class GridQubit(_BaseGridQid):
         ]
 
     @staticmethod
-    def from_diagram(diagram: str) -> List['GridQubit']:
+    def from_diagram(diagram: str) -> List[GridQubit]:
         """Parse ASCII art into device layout info.
 
         As an example, the below diagram will create a list of
@@ -490,9 +488,7 @@ class GridQubit(_BaseGridQid):
     def __str__(self) -> str:
         return f"q({self._row}, {self._col})"
 
-    def _circuit_diagram_info_(
-        self, args: 'cirq.CircuitDiagramInfoArgs'
-    ) -> 'cirq.CircuitDiagramInfo':
+    def _circuit_diagram_info_(self, args: cirq.CircuitDiagramInfoArgs) -> cirq.CircuitDiagramInfo:
         return protocols.CircuitDiagramInfo(wire_symbols=(f"({self._row}, {self._col})",))
 
     def _json_dict_(self) -> Dict[str, Any]:

cirq/devices/grid_qubit_test.py

@@ -58,7 +58,7 @@ def test_grid_qid_pickled_hash():
     _test_qid_pickled_hash(q, q_bad)
 
 
-def _test_qid_pickled_hash(q: 'cirq.Qid', q_bad: 'cirq.Qid') -> None:
+def _test_qid_pickled_hash(q: cirq.Qid, q_bad: cirq.Qid) -> None:
     """Test that hashes are not pickled with Qid instances."""
     assert q_bad is not q
     _ = hash(q_bad)  # compute hash to ensure it is cached.

cirq/devices/insertion_noise_model.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 import dataclasses
 from typing import Any, Dict, List, Optional, Sequence, TYPE_CHECKING
 
@@ -42,16 +44,14 @@ class InsertionNoiseModel(devices.NoiseModel):
             with PHYSICAL_GATE_TAG.
     """
 
-    ops_added: Dict[noise_utils.OpIdentifier, 'cirq.Operation'] = dataclasses.field(
+    ops_added: Dict[noise_utils.OpIdentifier, cirq.Operation] = dataclasses.field(
         default_factory=dict
     )
     prepend: bool = False
     require_physical_tag: bool = True
 
-    def noisy_moment(
-        self, moment: 'cirq.Moment', system_qubits: Sequence['cirq.Qid']
-    ) -> 'cirq.OP_TREE':
-        noise_ops: List['cirq.Operation'] = []
+    def noisy_moment(self, moment: cirq.Moment, system_qubits: Sequence[cirq.Qid]) -> cirq.OP_TREE:
+        noise_ops: List[cirq.Operation] = []
         candidate_ops = [
             op
             for op in moment

cirq/devices/line_qubit.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 import abc
 import functools
 import weakref
@@ -93,10 +95,10 @@ class _BaseLineQid(ops.Qid):
     def dimension(self) -> int:
         return self._dimension
 
-    def with_dimension(self, dimension: int) -> 'LineQid':
+    def with_dimension(self, dimension: int) -> LineQid:
         return LineQid(self._x, dimension)
 
-    def is_adjacent(self, other: 'cirq.Qid') -> bool:
+    def is_adjacent(self, other: cirq.Qid) -> bool:
         """Determines if two qubits are adjacent line qubits.
 
         Args:
@@ -106,7 +108,7 @@ class _BaseLineQid(ops.Qid):
         """
         return isinstance(other, _BaseLineQid) and abs(self._x - other._x) == 1
 
-    def neighbors(self, qids: Optional[Iterable[ops.Qid]] = None) -> Set['_BaseLineQid']:
+    def neighbors(self, qids: Optional[Iterable[ops.Qid]] = None) -> Set[_BaseLineQid]:
         """Returns qubits that are potential neighbors to this LineQubit
 
         Args:
@@ -184,7 +186,7 @@ class LineQid(_BaseLineQid):
     # Holds weak references so instances can still be garbage collected.
     _cache = weakref.WeakValueDictionary[Tuple[int, int], 'cirq.LineQid']()
 
-    def __new__(cls, x: int, dimension: int) -> 'cirq.LineQid':
+    def __new__(cls, x: int, dimension: int) -> cirq.LineQid:
         """Initializes a line qid at the given x coordinate.
 
         Args:
@@ -212,11 +214,11 @@ class LineQid(_BaseLineQid):
     def __getstate__(self) -> Dict[str, Any]:
         return {}
 
-    def _with_x(self, x: int) -> 'LineQid':
+    def _with_x(self, x: int) -> LineQid:
         return LineQid(x, dimension=self._dimension)
 
     @staticmethod
-    def range(*range_args, dimension: int) -> List['LineQid']:
+    def range(*range_args, dimension: int) -> List[LineQid]:
         """Returns a range of line qids.
 
         Args:
@@ -230,7 +232,7 @@ class LineQid(_BaseLineQid):
         return [LineQid(i, dimension=dimension) for i in range(*range_args)]
 
     @staticmethod
-    def for_qid_shape(qid_shape: Sequence[int], start: int = 0, step: int = 1) -> List['LineQid']:
+    def for_qid_shape(qid_shape: Sequence[int], start: int = 0, step: int = 1) -> List[LineQid]:
         """Returns a range of line qids for each entry in `qid_shape` with
         matching dimension.
 
@@ -244,7 +246,7 @@ class LineQid(_BaseLineQid):
         ]
 
     @staticmethod
-    def for_gate(val: Any, start: int = 0, step: int = 1) -> List['LineQid']:
+    def for_gate(val: Any, start: int = 0, step: int = 1) -> List[LineQid]:
         """Returns a range of line qids with the same qid shape as the gate.
 
         Args:
@@ -264,9 +266,7 @@ class LineQid(_BaseLineQid):
     def __str__(self) -> str:
         return f"q({self._x}) (d={self._dimension})"
 
-    def _circuit_diagram_info_(
-        self, args: 'cirq.CircuitDiagramInfoArgs'
-    ) -> 'cirq.CircuitDiagramInfo':
+    def _circuit_diagram_info_(self, args: cirq.CircuitDiagramInfoArgs) -> cirq.CircuitDiagramInfo:
         return protocols.CircuitDiagramInfo(wire_symbols=(f"{self._x} (d={self._dimension})",))
 
     def _json_dict_(self) -> Dict[str, Any]:
@@ -296,7 +296,7 @@ class LineQubit(_BaseLineQid):
     # Holds weak references so instances can still be garbage collected.
     _cache = weakref.WeakValueDictionary[int, 'cirq.LineQubit']()
 
-    def __new__(cls, x: int) -> 'cirq.LineQubit':
+    def __new__(cls, x: int) -> cirq.LineQubit:
         """Initializes a line qid at the given x coordinate.
 
         Args:
@@ -318,11 +318,11 @@ class LineQubit(_BaseLineQid):
     def __getstate__(self) -> Dict[str, Any]:
         return {}
 
-    def _with_x(self, x: int) -> 'LineQubit':
+    def _with_x(self, x: int) -> LineQubit:
         return LineQubit(x)
 
     @staticmethod
-    def range(*range_args) -> List['LineQubit']:
+    def range(*range_args) -> List[LineQubit]:
         """Returns a range of line qubits.
 
         Args:
@@ -339,9 +339,7 @@ class LineQubit(_BaseLineQid):
     def __str__(self) -> str:
         return f"q({self._x})"
 
-    def _circuit_diagram_info_(
-        self, args: 'cirq.CircuitDiagramInfoArgs'
-    ) -> 'cirq.CircuitDiagramInfo':
+    def _circuit_diagram_info_(self, args: cirq.CircuitDiagramInfoArgs) -> cirq.CircuitDiagramInfo:
         return protocols.CircuitDiagramInfo(wire_symbols=(f"{self._x}",))
 
     def _json_dict_(self) -> Dict[str, Any]:

cirq/devices/named_topologies.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+
 import abc
 import warnings
 from dataclasses import dataclass
@@ -127,7 +129,7 @@ class LineTopology(NamedTopology):
         )
         object.__setattr__(self, 'graph', graph)
 
-    def nodes_as_linequbits(self) -> List['cirq.LineQubit']:
+    def nodes_as_linequbits(self) -> List[cirq.LineQubit]:
         """Get the graph nodes as cirq.LineQubit"""
         return [LineQubit(x) for x in sorted(self.graph.nodes)]
 
@@ -142,7 +144,7 @@ class LineTopology(NamedTopology):
         g2 = nx.relabel_nodes(self.graph, {n: (n, 1) for n in self.graph.nodes})
         return draw_gridlike(g2, ax=ax, tilted=tilted, **kwargs)
 
-    def nodes_to_linequbits(self, offset: int = 0) -> Dict[int, 'cirq.LineQubit']:
+    def nodes_to_linequbits(self, offset: int = 0) -> Dict[int, cirq.LineQubit]:
         """Return a mapping from graph nodes to `cirq.LineQubit`
 
         Args:
@@ -240,11 +242,11 @@ class TiltedSquareLattice(NamedTopology):
         """
         return draw_gridlike(self.graph, ax=ax, tilted=tilted, **kwargs)
 
-    def nodes_as_gridqubits(self) -> List['cirq.GridQubit']:
+    def nodes_as_gridqubits(self) -> List[cirq.GridQubit]:
         """Get the graph nodes as cirq.GridQubit"""
         return [GridQubit(r, c) for r, c in sorted(self.graph.nodes)]
 
-    def nodes_to_gridqubits(self, offset=(0, 0)) -> Dict[Tuple[int, int], 'cirq.GridQubit']:
+    def nodes_to_gridqubits(self, offset=(0, 0)) -> Dict[Tuple[int, int], cirq.GridQubit]:
         """Return a mapping from graph nodes to `cirq.GridQubit`
 
         Args: