pub struct Client { /* private fields */ }Expand description
Client for Braket
Client for invoking operations on Braket. Each operation on Braket is a method on this
this struct. .send() MUST be invoked on the generated operations to dispatch the request to the service.
§Constructing a Client
A Config is required to construct a client. For most use cases, the aws-config
crate should be used to automatically resolve this config using
aws_config::load_from_env(), since this will resolve an SdkConfig which can be shared
across multiple different AWS SDK clients. This config resolution process can be customized
by calling aws_config::from_env() instead, which returns a ConfigLoader that uses
the builder pattern to customize the default config.
In the simplest case, creating a client looks as follows:
let config = aws_config::load_from_env().await;
let client = aws_sdk_braket::Client::new(&config);Occasionally, SDKs may have additional service-specific values that can be set on the Config that
is absent from SdkConfig, or slightly different settings for a specific client may be desired.
The Builder struct implements From<&SdkConfig>, so setting these specific settings can be
done as follows:
let sdk_config = ::aws_config::load_from_env().await;
let config = aws_sdk_braket::config::Builder::from(&sdk_config)
.some_service_specific_setting("value")
.build();See the aws-config docs and Config for more information on customizing configuration.
Note: Client construction is expensive due to connection thread pool initialization, and should be done once at application start-up.
§Using the Client
A client has a function for every operation that can be performed by the service.
For example, the CancelJob operation has
a Client::cancel_job, function which returns a builder for that operation.
The fluent builder ultimately has a send() function that returns an async future that
returns a result, as illustrated below:
let result = client.cancel_job()
.job_arn("example")
.send()
.await;The underlying HTTP requests that get made by this can be modified with the customize_operation
function on the fluent builder. See the customize module for more
information.
Implementations§
Source§impl Client
impl Client
Sourcepub fn cancel_job(&self) -> CancelJobFluentBuilder
pub fn cancel_job(&self) -> CancelJobFluentBuilder
Constructs a fluent builder for the CancelJob operation.
- The fluent builder is configurable:
job_arn(impl Into<String>)/set_job_arn(Option<String>):
required: trueThe ARN of the Amazon Braket hybrid job to cancel.
- On success, responds with
CancelJobOutputwith field(s):job_arn(String):The ARN of the Amazon Braket job.
cancellation_status(CancellationStatus):The status of the hybrid job.
- On failure, responds with
SdkError<CancelJobError>
Source§impl Client
impl Client
Sourcepub fn cancel_quantum_task(&self) -> CancelQuantumTaskFluentBuilder
pub fn cancel_quantum_task(&self) -> CancelQuantumTaskFluentBuilder
Constructs a fluent builder for the CancelQuantumTask operation.
- The fluent builder is configurable:
quantum_task_arn(impl Into<String>)/set_quantum_task_arn(Option<String>):
required: trueThe ARN of the quantum task to cancel.
client_token(impl Into<String>)/set_client_token(Option<String>):
required: trueThe client token associated with the cancellation request.
- On success, responds with
CancelQuantumTaskOutputwith field(s):quantum_task_arn(String):The ARN of the quantum task.
cancellation_status(CancellationStatus):The status of the quantum task.
- On failure, responds with
SdkError<CancelQuantumTaskError>
Source§impl Client
impl Client
Sourcepub fn create_job(&self) -> CreateJobFluentBuilder
pub fn create_job(&self) -> CreateJobFluentBuilder
Constructs a fluent builder for the CreateJob operation.
- The fluent builder is configurable:
client_token(impl Into<String>)/set_client_token(Option<String>):
required: trueThe client token associated with this request that guarantees that the request is idempotent.
algorithm_specification(AlgorithmSpecification)/set_algorithm_specification(Option<AlgorithmSpecification>):
required: trueDefinition of the Amazon Braket job to be created. Specifies the container image the job uses and information about the Python scripts used for entry and training.
input_data_config(InputFileConfig)/set_input_data_config(Option<Vec::<InputFileConfig>>):
required: falseA list of parameters that specify the name and type of input data and where it is located.
output_data_config(JobOutputDataConfig)/set_output_data_config(Option<JobOutputDataConfig>):
required: trueThe path to the S3 location where you want to store hybrid job artifacts and the encryption key used to store them.
checkpoint_config(JobCheckpointConfig)/set_checkpoint_config(Option<JobCheckpointConfig>):
required: falseInformation about the output locations for hybrid job checkpoint data.
job_name(impl Into<String>)/set_job_name(Option<String>):
required: trueThe name of the Amazon Braket hybrid job.
role_arn(impl Into<String>)/set_role_arn(Option<String>):
required: trueThe Amazon Resource Name (ARN) of an IAM role that Amazon Braket can assume to perform tasks on behalf of a user. It can access user resources, run an Amazon Braket job container on behalf of user, and output results and hybrid job details to the users’ s3 buckets.
stopping_condition(JobStoppingCondition)/set_stopping_condition(Option<JobStoppingCondition>):
required: falseThe user-defined criteria that specifies when a hybrid job stops running.
instance_config(InstanceConfig)/set_instance_config(Option<InstanceConfig>):
required: trueConfiguration of the resource instances to use while running the hybrid job on Amazon Braket.
hyper_parameters(impl Into<String>, impl Into<String>)/set_hyper_parameters(Option<HashMap::<String, String>>):
required: falseAlgorithm-specific parameters used by an Amazon Braket hybrid job that influence the quality of the training job. The values are set with a map of JSON key:value pairs, where the key is the name of the hyperparameter and the value is the value of the hyperparameter.
Do not include any security-sensitive information including account access IDs, secrets, or tokens in any hyperparameter fields. As part of the shared responsibility model, you are responsible for any potential exposure, unauthorized access, or compromise of your sensitive data if caused by security-sensitive information included in the request hyperparameter variable or plain text fields.
device_config(DeviceConfig)/set_device_config(Option<DeviceConfig>):
required: trueThe quantum processing unit (QPU) or simulator used to create an Amazon Braket hybrid job.
tags(impl Into<String>, impl Into<String>)/set_tags(Option<HashMap::<String, String>>):
required: falseTags to be added to the hybrid job you’re creating.
associations(Association)/set_associations(Option<Vec::<Association>>):
required: falseThe list of Amazon Braket resources associated with the hybrid job.
- On success, responds with
CreateJobOutputwith field(s):job_arn(String):The ARN of the Amazon Braket hybrid job created.
- On failure, responds with
SdkError<CreateJobError>
Source§impl Client
impl Client
Sourcepub fn create_quantum_task(&self) -> CreateQuantumTaskFluentBuilder
pub fn create_quantum_task(&self) -> CreateQuantumTaskFluentBuilder
Constructs a fluent builder for the CreateQuantumTask operation.
- The fluent builder is configurable:
client_token(impl Into<String>)/set_client_token(Option<String>):
required: trueThe client token associated with the request.
device_arn(impl Into<String>)/set_device_arn(Option<String>):
required: trueThe ARN of the device to run the quantum task on.
device_parameters(impl Into<String>)/set_device_parameters(Option<String>):
required: falseThe parameters for the device to run the quantum task on.
shots(i64)/set_shots(Option<i64>):
required: trueThe number of shots to use for the quantum task.
output_s3_bucket(impl Into<String>)/set_output_s3_bucket(Option<String>):
required: trueThe S3 bucket to store quantum task result files in.
output_s3_key_prefix(impl Into<String>)/set_output_s3_key_prefix(Option<String>):
required: trueThe key prefix for the location in the S3 bucket to store quantum task results in.
action(impl Into<String>)/set_action(Option<String>):
required: trueThe action associated with the quantum task.
tags(impl Into<String>, impl Into<String>)/set_tags(Option<HashMap::<String, String>>):
required: falseTags to be added to the quantum task you’re creating.
job_token(impl Into<String>)/set_job_token(Option<String>):
required: falseThe token for an Amazon Braket hybrid job that associates it with the quantum task.
associations(Association)/set_associations(Option<Vec::<Association>>):
required: falseThe list of Amazon Braket resources associated with the quantum task.
experimental_capabilities(ExperimentalCapabilities)/set_experimental_capabilities(Option<ExperimentalCapabilities>):
required: falseEnable experimental capabilities for the quantum task.
- On success, responds with
CreateQuantumTaskOutputwith field(s):quantum_task_arn(String):The ARN of the quantum task created by the request.
- On failure, responds with
SdkError<CreateQuantumTaskError>
Source§impl Client
impl Client
Sourcepub fn create_spending_limit(&self) -> CreateSpendingLimitFluentBuilder
pub fn create_spending_limit(&self) -> CreateSpendingLimitFluentBuilder
Constructs a fluent builder for the CreateSpendingLimit operation.
- The fluent builder is configurable:
client_token(impl Into<String>)/set_client_token(Option<String>):
required: trueA unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, Amazon Braket ignores the request, but does not return an error.
device_arn(impl Into<String>)/set_device_arn(Option<String>):
required: trueThe Amazon Resource Name (ARN) of the quantum device to apply the spending limit to.
spending_limit(impl Into<String>)/set_spending_limit(Option<String>):
required: trueThe maximum amount that can be spent on the specified device, in USD.
time_period(TimePeriod)/set_time_period(Option<TimePeriod>):
required: falseThe time period during which the spending limit is active, including start and end dates.
tags(impl Into<String>, impl Into<String>)/set_tags(Option<HashMap::<String, String>>):
required: falseThe tags to apply to the spending limit. Each tag consists of a key and an optional value.
- On success, responds with
CreateSpendingLimitOutputwith field(s):spending_limit_arn(String):The Amazon Resource Name (ARN) of the created spending limit.
- On failure, responds with
SdkError<CreateSpendingLimitError>
Source§impl Client
impl Client
Sourcepub fn delete_spending_limit(&self) -> DeleteSpendingLimitFluentBuilder
pub fn delete_spending_limit(&self) -> DeleteSpendingLimitFluentBuilder
Constructs a fluent builder for the DeleteSpendingLimit operation.
- The fluent builder is configurable:
spending_limit_arn(impl Into<String>)/set_spending_limit_arn(Option<String>):
required: trueThe Amazon Resource Name (ARN) of the spending limit to delete.
- On success, responds with
DeleteSpendingLimitOutput - On failure, responds with
SdkError<DeleteSpendingLimitError>
Source§impl Client
impl Client
Sourcepub fn get_device(&self) -> GetDeviceFluentBuilder
pub fn get_device(&self) -> GetDeviceFluentBuilder
Constructs a fluent builder for the GetDevice operation.
- The fluent builder is configurable:
device_arn(impl Into<String>)/set_device_arn(Option<String>):
required: trueThe ARN of the device to retrieve.
- On success, responds with
GetDeviceOutputwith field(s):device_arn(String):The ARN of the device.
device_name(String):The name of the device.
provider_name(String):The name of the partner company for the device.
device_type(DeviceType):The type of the device.
device_status(DeviceStatus):The status of the device.
device_capabilities(String):Details about the capabilities of the device.
device_queue_info(Option<Vec::<DeviceQueueInfo>>):The number of quantum tasks and hybrid jobs currently queued on the device.
- On failure, responds with
SdkError<GetDeviceError>
Source§impl Client
impl Client
Sourcepub fn get_job(&self) -> GetJobFluentBuilder
pub fn get_job(&self) -> GetJobFluentBuilder
Constructs a fluent builder for the GetJob operation.
- The fluent builder is configurable:
job_arn(impl Into<String>)/set_job_arn(Option<String>):
required: trueThe ARN of the hybrid job to retrieve.
additional_attribute_names(HybridJobAdditionalAttributeName)/set_additional_attribute_names(Option<Vec::<HybridJobAdditionalAttributeName>>):
required: falseA list of attributes to return additional information for. Only the QueueInfo additional attribute name is currently supported.
- On success, responds with
GetJobOutputwith field(s):status(JobPrimaryStatus):The status of the Amazon Braket hybrid job.
job_arn(String):The ARN of the Amazon Braket hybrid job.
role_arn(String):The Amazon Resource Name (ARN) of an IAM role that Amazon Braket can assume to perform tasks on behalf of a user. It can access user resources, run an Amazon Braket job container on behalf of user, and output results and other hybrid job details to the s3 buckets of a user.
failure_reason(Option<String>):A description of the reason why an Amazon Braket hybrid job failed, if it failed.
job_name(String):The name of the Amazon Braket hybrid job.
hyper_parameters(Option<HashMap::<String, String>>):Algorithm-specific parameters used by an Amazon Braket hybrid job that influence the quality of the traiing job. The values are set with a map of JSON key:value pairs, where the key is the name of the hyperparameter and the value is the value of th hyperparameter.
input_data_config(Option<Vec::<InputFileConfig>>):A list of parameters that specify the name and type of input data and where it is located.
output_data_config(Option<JobOutputDataConfig>):The path to the S3 location where hybrid job artifacts are stored and the encryption key used to store them there.
stopping_condition(Option<JobStoppingCondition>):The user-defined criteria that specifies when to stop a running hybrid job.
checkpoint_config(Option<JobCheckpointConfig>):Information about the output locations for hybrid job checkpoint data.
algorithm_specification(Option<AlgorithmSpecification>):Definition of the Amazon Braket hybrid job created. Provides information about the container image used, and the Python scripts used for training.
instance_config(Option<InstanceConfig>):The resource instances to use while running the hybrid job on Amazon Braket.
created_at(DateTime):The time at which the Amazon Braket hybrid job was created.
started_at(Option<DateTime>):The time at which the Amazon Braket hybrid job was started.
ended_at(Option<DateTime>):The time at which the Amazon Braket hybrid job ended.
billable_duration(Option<i32>):The billable time for which the Amazon Braket hybrid job used to complete.
device_config(Option<DeviceConfig>):The primary device used by the Amazon Braket hybrid job.
events(Option<Vec::<JobEventDetails>>):Details about the time and type of events occurred related to the Amazon Braket hybrid job.
tags(Option<HashMap::<String, String>>):The tags associated with this hybrid job.
queue_info(Option<HybridJobQueueInfo>):Queue information for the requested hybrid job. Only returned if
QueueInfois specified in theadditionalAttributeNames“field in theGetJobAPI request.associations(Option<Vec::<Association>>):The list of Amazon Braket resources associated with the hybrid job.
- On failure, responds with
SdkError<GetJobError>
Source§impl Client
impl Client
Sourcepub fn get_quantum_task(&self) -> GetQuantumTaskFluentBuilder
pub fn get_quantum_task(&self) -> GetQuantumTaskFluentBuilder
Constructs a fluent builder for the GetQuantumTask operation.
- The fluent builder is configurable:
quantum_task_arn(impl Into<String>)/set_quantum_task_arn(Option<String>):
required: trueThe ARN of the quantum task to retrieve.
additional_attribute_names(QuantumTaskAdditionalAttributeName)/set_additional_attribute_names(Option<Vec::<QuantumTaskAdditionalAttributeName>>):
required: falseA list of attributes to return additional information for. Only the QueueInfo additional attribute name is currently supported.
- On success, responds with
GetQuantumTaskOutputwith field(s):quantum_task_arn(String):The ARN of the quantum task.
status(QuantumTaskStatus):The status of the quantum task.
failure_reason(Option<String>):The reason that a quantum task failed.
device_arn(String):The ARN of the device the quantum task was run on.
device_parameters(String):The parameters for the device on which the quantum task ran.
shots(i64):The number of shots used in the quantum task.
output_s3_bucket(String):The S3 bucket where quantum task results are stored.
output_s3_directory(String):The folder in the S3 bucket where quantum task results are stored.
created_at(DateTime):The time at which the quantum task was created.
ended_at(Option<DateTime>):The time at which the quantum task ended.
tags(Option<HashMap::<String, String>>):The tags that belong to this quantum task.
job_arn(Option<String>):The ARN of the Amazon Braket job associated with the quantum task.
queue_info(Option<QuantumTaskQueueInfo>):Queue information for the requested quantum task. Only returned if
QueueInfois specified in theadditionalAttributeNames“field in theGetQuantumTaskAPI request.associations(Option<Vec::<Association>>):The list of Amazon Braket resources associated with the quantum task.
num_successful_shots(Option<i64>):The number of successful shots for the quantum task. This is available after a successfully completed quantum task.
action_metadata(Option<ActionMetadata>):Metadata about the action performed by the quantum task, including information about the type of action and program counts.
experimental_capabilities(Option<ExperimentalCapabilities>):Enabled experimental capabilities for the quantum task, if any.
- On failure, responds with
SdkError<GetQuantumTaskError>
Source§impl Client
impl Client
Constructs a fluent builder for the ListTagsForResource operation.
- The fluent builder is configurable:
resource_arn(impl Into<String>)/set_resource_arn(Option<String>):
required: trueSpecify the
resourceArnfor the resource whose tags to display.
- On success, responds with
ListTagsForResourceOutputwith field(s):tags(Option<HashMap::<String, String>>):Displays the key, value pairs of tags associated with this resource.
- On failure, responds with
SdkError<ListTagsForResourceError>
Source§impl Client
impl Client
Sourcepub fn search_devices(&self) -> SearchDevicesFluentBuilder
pub fn search_devices(&self) -> SearchDevicesFluentBuilder
Constructs a fluent builder for the SearchDevices operation.
This operation supports pagination; See into_paginator().
- The fluent builder is configurable:
next_token(impl Into<String>)/set_next_token(Option<String>):
required: falseA token used for pagination of results returned in the response. Use the token returned from the previous request to continue search where the previous request ended.
max_results(i32)/set_max_results(Option<i32>):
required: falseThe maximum number of results to return in the response.
filters(SearchDevicesFilter)/set_filters(Option<Vec::<SearchDevicesFilter>>):
required: trueArray of SearchDevicesFilter objects to use when searching for devices.
- On success, responds with
SearchDevicesOutputwith field(s):devices(Vec::<DeviceSummary>):An array of
DeviceSummaryobjects for devices that match the specified filter values.next_token(Option<String>):A token used for pagination of results, or null if there are no additional results. Use the token value in a subsequent request to continue search where the previous request ended.
- On failure, responds with
SdkError<SearchDevicesError>
Source§impl Client
impl Client
Sourcepub fn search_jobs(&self) -> SearchJobsFluentBuilder
pub fn search_jobs(&self) -> SearchJobsFluentBuilder
Constructs a fluent builder for the SearchJobs operation.
This operation supports pagination; See into_paginator().
- The fluent builder is configurable:
next_token(impl Into<String>)/set_next_token(Option<String>):
required: falseA token used for pagination of results returned in the response. Use the token returned from the previous request to continue search where the previous request ended.
max_results(i32)/set_max_results(Option<i32>):
required: falseThe maximum number of results to return in the response.
filters(SearchJobsFilter)/set_filters(Option<Vec::<SearchJobsFilter>>):
required: trueArray of SearchJobsFilter objects to use when searching for hybrid jobs.
- On success, responds with
SearchJobsOutputwith field(s):jobs(Vec::<JobSummary>):An array of
JobSummaryobjects for devices that match the specified filter values.next_token(Option<String>):A token used for pagination of results, or
nullif there are no additional results. Use the token value in a subsequent request to continue search where the previous request ended.
- On failure, responds with
SdkError<SearchJobsError>
Source§impl Client
impl Client
Sourcepub fn search_quantum_tasks(&self) -> SearchQuantumTasksFluentBuilder
pub fn search_quantum_tasks(&self) -> SearchQuantumTasksFluentBuilder
Constructs a fluent builder for the SearchQuantumTasks operation.
This operation supports pagination; See into_paginator().
- The fluent builder is configurable:
next_token(impl Into<String>)/set_next_token(Option<String>):
required: falseA token used for pagination of results returned in the response. Use the token returned from the previous request to continue search where the previous request ended.
max_results(i32)/set_max_results(Option<i32>):
required: falseMaximum number of results to return in the response.
filters(SearchQuantumTasksFilter)/set_filters(Option<Vec::<SearchQuantumTasksFilter>>):
required: trueArray of
SearchQuantumTasksFilterobjects to use when searching for quantum tasks.
- On success, responds with
SearchQuantumTasksOutputwith field(s):quantum_tasks(Vec::<QuantumTaskSummary>):An array of
QuantumTaskSummaryobjects for quantum tasks that match the specified filters.next_token(Option<String>):A token used for pagination of results, or null if there are no additional results. Use the token value in a subsequent request to continue search where the previous request ended.
- On failure, responds with
SdkError<SearchQuantumTasksError>
Source§impl Client
impl Client
Sourcepub fn search_spending_limits(&self) -> SearchSpendingLimitsFluentBuilder
pub fn search_spending_limits(&self) -> SearchSpendingLimitsFluentBuilder
Constructs a fluent builder for the SearchSpendingLimits operation.
This operation supports pagination; See into_paginator().
- The fluent builder is configurable:
next_token(impl Into<String>)/set_next_token(Option<String>):
required: falseThe token to retrieve the next page of results. This value is returned from a previous call to SearchSpendingLimits when there are more results available.
max_results(i32)/set_max_results(Option<i32>):
required: falseThe maximum number of results to return in a single call. Minimum value of 1, maximum value of 100. Default is 20.
filters(SearchSpendingLimitsFilter)/set_filters(Option<Vec::<SearchSpendingLimitsFilter>>):
required: falseThe filters to apply when searching for spending limits. Use filters to narrow down the results based on specific criteria.
- On success, responds with
SearchSpendingLimitsOutputwith field(s):spending_limits(Vec::<SpendingLimitSummary>):An array of spending limit summaries that match the specified filters.
next_token(Option<String>):The token to retrieve the next page of results. This value is null when there are no more results to return.
- On failure, responds with
SdkError<SearchSpendingLimitsError>
Source§impl Client
impl Client
Sourcepub fn tag_resource(&self) -> TagResourceFluentBuilder
pub fn tag_resource(&self) -> TagResourceFluentBuilder
Constructs a fluent builder for the TagResource operation.
- The fluent builder is configurable:
resource_arn(impl Into<String>)/set_resource_arn(Option<String>):
required: trueSpecify the
resourceArnof the resource to which a tag will be added.tags(impl Into<String>, impl Into<String>)/set_tags(Option<HashMap::<String, String>>):
required: trueSpecify the tags to add to the resource. Tags can be specified as a key-value map.
- On success, responds with
TagResourceOutput - On failure, responds with
SdkError<TagResourceError>
Source§impl Client
impl Client
Sourcepub fn untag_resource(&self) -> UntagResourceFluentBuilder
pub fn untag_resource(&self) -> UntagResourceFluentBuilder
Constructs a fluent builder for the UntagResource operation.
- The fluent builder is configurable:
resource_arn(impl Into<String>)/set_resource_arn(Option<String>):
required: trueSpecify the
resourceArnfor the resource from which to remove the tags.tag_keys(impl Into<String>)/set_tag_keys(Option<Vec::<String>>):
required: trueSpecify the keys for the tags to remove from the resource.
- On success, responds with
UntagResourceOutput - On failure, responds with
SdkError<UntagResourceError>
Source§impl Client
impl Client
Sourcepub fn update_spending_limit(&self) -> UpdateSpendingLimitFluentBuilder
pub fn update_spending_limit(&self) -> UpdateSpendingLimitFluentBuilder
Constructs a fluent builder for the UpdateSpendingLimit operation.
- The fluent builder is configurable:
spending_limit_arn(impl Into<String>)/set_spending_limit_arn(Option<String>):
required: trueThe Amazon Resource Name (ARN) of the spending limit to update.
client_token(impl Into<String>)/set_client_token(Option<String>):
required: trueA unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, Amazon Braket ignores the request, but does not return an error.
spending_limit(impl Into<String>)/set_spending_limit(Option<String>):
required: falseThe new maximum amount that can be spent on the specified device, in USD.
time_period(TimePeriod)/set_time_period(Option<TimePeriod>):
required: falseThe new time period during which the spending limit is active, including start and end dates.
- On success, responds with
UpdateSpendingLimitOutput - On failure, responds with
SdkError<UpdateSpendingLimitError>
Source§impl Client
impl Client
Sourcepub fn from_conf(conf: Config) -> Self
pub fn from_conf(conf: Config) -> Self
Creates a new client from the service Config.
§Panics
This method will panic in the following cases:
- Retries or timeouts are enabled without a
sleep_implconfigured. - Identity caching is enabled without a
sleep_implandtime_sourceconfigured. - No
behavior_versionis provided.
The panic message for each of these will have instructions on how to resolve them.
Source§impl Client
impl Client
Sourcepub fn new(sdk_config: &SdkConfig) -> Self
pub fn new(sdk_config: &SdkConfig) -> Self
Creates a new client from an SDK Config.
§Panics
- This method will panic if the
sdk_configis missing an async sleep implementation. If you experience this panic, set thesleep_implon the Config passed into this function to fix it. - This method will panic if the
sdk_configis missing an HTTP connector. If you experience this panic, set thehttp_connectoron the Config passed into this function to fix it. - This method will panic if no
BehaviorVersionis provided. If you experience this panic, setbehavior_versionon the Config or enable thebehavior-version-latestCargo feature.
Trait Implementations§
Auto Trait Implementations§
impl Freeze for Client
impl !RefUnwindSafe for Client
impl Send for Client
impl Sync for Client
impl Unpin for Client
impl !UnwindSafe for Client
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self with the foreground set to
value.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red() and
green(), which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg():
use yansi::{Paint, Color};
painted.fg(Color::White);Set foreground color to white using white().
use yansi::Paint;
painted.white();Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self with the background set to
value.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red() and
on_green(), which have the same functionality but
are pithier.
§Example
Set background color to red using fg():
use yansi::{Paint, Color};
painted.bg(Color::Red);Set background color to red using on_red().
use yansi::Paint;
painted.on_red();Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute value.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold() and
underline(), which have the same functionality
but are pithier.
§Example
Make text bold using attr():
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);Make text bold using using bold().
use yansi::Paint;
painted.bold();Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi Quirk value.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask() and
wrap(), which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk():
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);Enable wrapping using wrap().
use yansi::Paint;
painted.wrap();Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting() due to conflicts with Vec::clear().
The clear() method will be removed in a future release.
fn clear(&self) -> Painted<&T>
resetting() due to conflicts with Vec::clear().
The clear() method will be removed in a future release.Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted only when both stdout and stderr are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);