Clean up snippet test errors in ionq and pasqal md files (#7918)

Similar to #7803, this commit fix the errors from the temporarily
excluded md files.

1. Use mocked Service instance for ionq documents
2. Remove the outdated Circuit initialization in pasqal doc, the device
argument has been removed since #5189.

Fixes #7787

---------

Co-authored-by: Pavol Juhas <juhas@google.com>

Author: ToastCheng

dev_tools/snippets_test.py

@@ -85,19 +85,9 @@ def test_can_run_readme_code_snippets():
 
 
 def find_docs_code_snippets_paths() -> Iterator[str]:
-    # TODO: #7787 - fix and enable these later
-    excluded = (
-        'hardware/ionq/access.md',
-        'hardware/ionq/calibrations.md',
-        'hardware/ionq/circuits.md',
-        'hardware/ionq/jobs.md',
-        'hardware/ionq/service.md',
-        'hardware/pasqal/sampler.md',
-    )
     for filename in DOCS_FOLDER.rglob('*.md'):
         path = filename.relative_to(DOCS_FOLDER).as_posix()
-        if not path.endswith(excluded):
-            yield path
+        yield path
 
 
 @pytest.mark.parametrize('path', find_docs_code_snippets_paths())

docs/hardware/ionq/access.md

@@ -31,6 +31,12 @@ export IONQ_API_KEY=tomyheart
 Once this variable is set, the `ionq.Service()` will look for it automatically
 in the environment:
 
+<!---test_substitution
+service = ionq.Service\(\)
+import os
+with mock.patch.dict(os.environ, {'IONQ_API_KEY': 'tomyheart'}):
+    \g<0>
+--->
 ```python
 import cirq_ionq as ionq
 

docs/hardware/ionq/calibrations.md

@@ -7,11 +7,20 @@ periodically.
 
 In this section, we assume a `cirq_ionq.Service` object has been instantiated and is
 called `service` and `cirq` and `cirq_ionq` have been imported:
+
+<!---test_substitution
+service = ionq.Service\(\)
+service = mock.create_autospec(ionq.Service, instance=True)
+mock_calibration = mock.create_autospec(ionq.Calibration, instance=True)
+service.configure_mock(**{"get_current_calibration.return_value": mock_calibration})
+--->
 ```python
 import cirq
 import cirq_ionq as ionq
+
 service = ionq.Service()
 ```
+
 See [IonQ API Service](service.md) for how to set up the service.
 
 ## Fetching information about the device

docs/hardware/ionq/circuits.md

@@ -7,11 +7,20 @@ or on the IonQ simulator.  Here we describe the restrictions on these circuits.
 
 In this section we assume a `cirq_ionq.Service` object has been instantiated and is
 called `service` and `cirq` and `cirq_ionq` have been imported:
+
+<!---test_substitution
+service = ionq.Service\(\)
+service = mock.create_autospec(ionq.Service, instance=True)
+mock_calibration = mock.create_autospec(ionq.Calibration, instance=True)
+service.configure_mock(**{"get_current_calibration.return_value": mock_calibration})
+--->
 ```python
 import cirq
 import cirq_ionq as ionq
+
 service = ionq.Service()
 ```
+
 See [IonQ API Service](service.md) for how to set up the service.
 
 ## Qubits

docs/hardware/ionq/jobs.md

@@ -6,9 +6,14 @@ IonQ simulator.
 In this section we assume a `cirq_ionq.Service` object has been instantiated and is
 called `service` and `cirq` and `cirq_ionq` have been imported:
 
+<!---test_substitution
+service = ionq.Service\(\)
+service = mock.create_autospec(ionq.Service, instance=True)
+--->
 ```python
 import cirq
 import cirq_ionq as ionq
+
 service = ionq.Service()
 ```
 
@@ -35,8 +40,8 @@ The first method for running is to do so via the `run` method on `cirq_ionq.Serv
 ```python
 qubit = cirq.LineQubit(0)
 circuit = cirq.Circuit(
-    cirq.X(qubit)**0.5,            # Square root of NOT.
-    cirq.measure(qubit, key='x')   # Measurement store in key 'x'
+    cirq.X(qubit) ** 0.5,  # Square root of NOT.
+    cirq.measure(qubit, key='x'),  # Measurement store in key 'x'
 )
 
 result = service.run(circuit=circuit, repetitions=100, target='qpu')
@@ -72,6 +77,12 @@ in a [pandas](https://pandas.pydata.org/) dataframe and is the interface
 used by other classes in Cirq for objects that process data. Here is a
 simple example showing how to get a sampler and use it.
 
+<!---test_substitution
+sampler = service.sampler\(target=.*\)
+mock_sampler = mock.create_autospec(ionq.Sampler, instance=True)
+service.configure_mock(**{"sampler.return_value": mock_sampler})
+\g<0>
+--->
 ```python
 qubit = cirq.LineQubit(0)
 circuit = cirq.Circuit(
@@ -93,6 +104,12 @@ wish to run, and the service immediately returns an object that has
 the id of the job. This job id can be recorded, and at any time in
 the future you can query for the results of this job.
 
+<!---test_substitution
+job = service.create_job\(circuit=.*\)
+mock_job = mock.create_autospec(ionq.Job, instance=True)
+service.configure_mock(**{"create_job.return_value": mock_job})
+\g<0>
+--->
 ```python
 qubit = cirq.LineQubit(0)
 circuit = cirq.Circuit(

docs/hardware/ionq/service.md

@@ -21,15 +21,21 @@ The basic steps for running a quantum circuit in a blocking manner are:
 
 Here is a simple example of this flow:
 
+<!---test_substitution
+service = ionq.Service\(api_key=API_KEY\)
+service = mock.create_autospec(ionq.Service, instance=True)
+mock_result = mock.create_autospec(cirq.Result, instance=True)
+service.configure_mock(**{"run.return_value": mock_result})
+--->
 ```python
 import cirq
 import cirq_ionq as ionq
 
 # A circuit that applies a square root of NOT and then a measurement.
 qubit = cirq.LineQubit(0)
 circuit = cirq.Circuit(
-  cirq.X(qubit)**0.5,      # Square root of NOT.
-  cirq.measure(qubit, key='x')  # Measurement store in key 'x'
+    cirq.X(qubit) ** 0.5,  # Square root of NOT.
+    cirq.measure(qubit, key='x'),  # Measurement store in key 'x'
 )
 
 # Create a ionq.Service object.
@@ -105,11 +111,11 @@ Here is an example of using error mitigation and sharpening options:
 ```python
 # Run a program against the service with error mitigation and sharpening
 result = service.run(
-  circuit=circuit,
-  repetitions=100,
-  target='qpu',
-  error_mitigation={'debias': True},
-  sharpen=True
+    circuit=circuit,
+    repetitions=100,
+    target='qpu',
+    error_mitigation={'debias': True},
+    sharpen=True,
 )
 ```
 

docs/hardware/pasqal/sampler.md

@@ -12,24 +12,28 @@ The `PasqalSampler` class is the entry point to communicate with the API. It can
 using your PASQAL_API_ACCESS_TOKEN.
 
 
+<!---test_substitution
+sampler = PasqalSampler\(.*\)
+PasqalSampler = mock.create_autospec(PasqalSampler)
+\g<0>
+--->
 ```python
 import cirq
 from cirq_pasqal import ThreeDQubit, PasqalVirtualDevice, PasqalSampler
 
 # A simple sample circuit
 qubit = ThreeDQubit(0, 0, 0)
-p_device = PasqalVirtualDevice(control_radius=2.1, qubits=[qubit])
-p_circuit = cirq.Circuit(device=p_device)
+p_circuit = cirq.Circuit()
 p_circuit.append(cirq.X(qubit))                        # NOT gate.
 p_circuit.append(cirq.measure(qubit, key='result'))    # Measurement.
 
 
 # Create a PasqalSampler object to use.
 # Replace 'my_token' with the access token and uncomment next lines.
 
-# PASQAL_API_ACCESS_TOKEN = 'my_token'
-# sampler = cirq_pasqal.PasqalSampler(remote_host='http://34.98.71.118/v0/pasqal', access_token=PASQAL_API_ACCESS_TOKEN)
-# results = sampler.run(p_circuit, repetitions=1000) # Runs the circuit and returns the results in a 'Result'
+PASQAL_API_ACCESS_TOKEN = 'my_token'
+sampler = PasqalSampler(remote_host='http://34.98.71.118/v0/pasqal', access_token=PASQAL_API_ACCESS_TOKEN)
+results = sampler.run(p_circuit, repetitions=1000) # Runs the circuit and returns the results in a 'Result'
 ```
 
 ## Device Specification