Enum qcs::Error

pub enum Error {
    Settings(String),
    Authentication,
    QpuNotFound,
    QpuUnavailable(Duration),
    Connection(Service),
    Quil(ProgramError<Program>),
    Compilation(String),
    Translation(String),
    RewriteArithmetic(Error),
    Substitution(String),
    MissingRoSources,
    Unexpected(String),
    InvalidJobHandle,
    QcsConfigLoadFailure(LoadError),
}

The possible errors which can be returned by Executable::execute_on_qpu and Executable::execute_on_qvm..

Variants

Settings(String)

Communicating with QCS requires appropriate settings and secrets files. By default, these should be $HOME/.qcs/settings.toml and $HOME/.qcs/secrets.toml, though those files can be overridden by setting the QCS_SETTINGS_FILE_PATH and QCS_SECRETS_FILE_PATH environment variables.

This error can occur when one of those files is required but missing or there is a problem with the contents of those files.

Authentication

This error occurs when the SDK was unable to authenticate a request to QCS. This could mean that your credentials are invalid or expired, or that you do not have access to the requested QPU.

QpuNotFound

The requested QPU was not found. Either the QPU does not exist or you do not have access to it.

QpuUnavailable(Duration)

This happens when the QPU is down for maintenance and not accepting new jobs. If you receive this error, internal compilation caches will have been cleared as programs should be recompiled with new settings after a maintenance window. If you are mid-experiment, you might want to start over.

Connection(Service)

Indicates a problem connecting to an external service. Check your network connection and ensure that any required local services (e.g., qvm or quilc) are running.

Quil(ProgramError<Program>)

There was some problem with the provided Quil program. This could be a syntax error with quil, providing Quil-T to quilc or qvm (which is not supported), or forgetting to set some parameters.

Compilation(String)

There was a problem when compiling the Quil program.

Translation(String)

There was a problem when translating the Quil program.

RewriteArithmetic(Error)

There was a problem when rewriting parameter arithmetic in the Quil program.

Substitution(String)

There was a problem when substituting parameters in the Quil program.

MissingRoSources

The Quil program is missing readout sources.

Unexpected(String)

This error returns when a runtime check that should always pass fails. This most likely indicates a bug in the SDK and should be reported to GitHub,

InvalidJobHandle

Occurs when Executable::retrieve_results is called with an invalid JobHandle. Calling functions on Executable between Executable::submit_to_qpu and Executable::retrieve_results can invalidate the handle.

QcsConfigLoadFailure(LoadError)

Occurs when failing to construct a [QcsClient].

Trait Implementations

impl Debug for Error

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Error

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide(&'a self, demand: &mut Demand<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type based access to context intended for error reports.

impl From<LoadError> for Error

fn from(source: LoadError) -> Self

Converts to this type from the input type.

impl From<ProgramError<Program>> for Error

fn from(source: ProgramError<Program>) -> Self

Converts to this type from the input type.