doc: starting job/device compatibility matrix

+ starting to fix doctest in ci

Author: Henri-ColibrITD

mpqp/execution/devices.py

@@ -9,6 +9,11 @@
 - :class:`ATOSDevice`,
 - :class:`AWSDevice`,
 - :class:`GOOGLEDevice`.
+
+Not all combinations of :class:`AvailableDevice` and 
+:class:`JobType<mpqp.execution.job.JobType>` are possible, for each device 
+listed bellow, ``S`` means if supports the ``SAMPLE`` job type, ``SV`` the
+``STATE_VECTOR`` one and ``O`` the ``OBSERVABLE`` one.
 """
 
 from abc import abstractmethod
@@ -52,7 +57,9 @@ class IBMDevice(AvailableDevice):
     PULSE_SIMULATOR = "pulse_simulator"
 
     AER_SIMULATOR = "aer_simulator"
+    """``S``"""
     AER_SIMULATOR_STATEVECTOR = "aer_simulator_statevector"
+    """``SV``"""
     AER_SIMULATOR_DENSITY_MATRIX = "aer_simulator_density_matrix"
     AER_SIMULATOR_STABILIZER = "aer_simulator_stabilizer"
     AER_SIMULATOR_MATRIX_PRODUCT_STATE = "aer_simulator_matrix_product_state"

tests/test_doc.py

@@ -68,6 +68,8 @@ def __exit__(
 
 
 def test_documentation():
+    print(os.getcwd())
+
     test_globals = globals().copy()
     test_globals.update(locals())
 
@@ -100,5 +102,3 @@ def test_documentation():
                                     assert runner.run(test).failed == 0
                         else:
                             assert runner.run(test).failed == 0
-
-