Client

Struct Client 

Source
pub struct Client { /* private fields */ }
Expand description

Client for AWS Clean Rooms ML

Client for invoking operations on AWS Clean Rooms ML. Each operation on AWS Clean Rooms ML 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_cleanroomsml::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_cleanroomsml::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 CancelTrainedModel operation has a Client::cancel_trained_model, 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_trained_model()
    .membership_identifier("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

Source

pub fn cancel_trained_model(&self) -> CancelTrainedModelFluentBuilder

Constructs a fluent builder for the CancelTrainedModel operation.

Source§

impl Client

Source

pub fn cancel_trained_model_inference_job( &self, ) -> CancelTrainedModelInferenceJobFluentBuilder

Constructs a fluent builder for the CancelTrainedModelInferenceJob operation.

Source§

impl Client

Source

pub fn create_audience_model(&self) -> CreateAudienceModelFluentBuilder

Constructs a fluent builder for the CreateAudienceModel operation.

Source§

impl Client

Source

pub fn create_configured_audience_model( &self, ) -> CreateConfiguredAudienceModelFluentBuilder

Constructs a fluent builder for the CreateConfiguredAudienceModel operation.

Source§

impl Client

Source

pub fn create_configured_model_algorithm( &self, ) -> CreateConfiguredModelAlgorithmFluentBuilder

Constructs a fluent builder for the CreateConfiguredModelAlgorithm operation.

Source§

impl Client

Source

pub fn create_configured_model_algorithm_association( &self, ) -> CreateConfiguredModelAlgorithmAssociationFluentBuilder

Constructs a fluent builder for the CreateConfiguredModelAlgorithmAssociation operation.

Source§

impl Client

Source

pub fn create_ml_input_channel(&self) -> CreateMLInputChannelFluentBuilder

Constructs a fluent builder for the CreateMLInputChannel operation.

Source§

impl Client

Source

pub fn create_trained_model(&self) -> CreateTrainedModelFluentBuilder

Constructs a fluent builder for the CreateTrainedModel operation.

Source§

impl Client

Source

pub fn create_training_dataset(&self) -> CreateTrainingDatasetFluentBuilder

Constructs a fluent builder for the CreateTrainingDataset operation.

  • The fluent builder is configurable:
    • name(impl Into<String>) / set_name(Option<String>):
      required: true

      The name of the training dataset. This name must be unique in your account and region.


    • role_arn(impl Into<String>) / set_role_arn(Option<String>):
      required: true

      The ARN of the IAM role that Clean Rooms ML can assume to read the data referred to in the dataSource field of each dataset.

      Passing a role across AWS accounts is not allowed. If you pass a role that isn’t in your account, you get an AccessDeniedException error.


    • training_data(Dataset) / set_training_data(Option<Vec::<Dataset>>):
      required: true

      An array of information that lists the Dataset objects, which specifies the dataset type and details on its location and schema. You must provide a role that has read access to these tables.


    • tags(impl Into<String>, impl Into<String>) / set_tags(Option<HashMap::<String, String>>):
      required: false

      The optional metadata that you apply to the resource to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define.

      The following basic restrictions apply to tags:

      • Maximum number of tags per resource - 50.

      • For each resource, each tag key must be unique, and each tag key can have only one value.

      • Maximum key length - 128 Unicode characters in UTF-8.

      • Maximum value length - 256 Unicode characters in UTF-8.

      • If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.

      • Tag keys and values are case sensitive.

      • Do not use aws:, AWS:, or any upper or lowercase combination of such as a prefix for keys as it is reserved for AWS use. You cannot edit or delete tag keys with this prefix. Values can have this prefix. If a tag value has aws as its prefix but the key does not, then Clean Rooms ML considers it to be a user tag and will count against the limit of 50 tags. Tags with only the key prefix of aws do not count against your tags per resource limit.


    • description(impl Into<String>) / set_description(Option<String>):
      required: false

      The description of the training dataset.


  • On success, responds with CreateTrainingDatasetOutput with field(s):
  • On failure, responds with SdkError<CreateTrainingDatasetError>
Source§

impl Client

Source

pub fn delete_audience_generation_job( &self, ) -> DeleteAudienceGenerationJobFluentBuilder

Constructs a fluent builder for the DeleteAudienceGenerationJob operation.

Source§

impl Client

Source

pub fn delete_audience_model(&self) -> DeleteAudienceModelFluentBuilder

Constructs a fluent builder for the DeleteAudienceModel operation.

Source§

impl Client

Source

pub fn delete_configured_audience_model( &self, ) -> DeleteConfiguredAudienceModelFluentBuilder

Constructs a fluent builder for the DeleteConfiguredAudienceModel operation.

Source§

impl Client

Source

pub fn delete_configured_audience_model_policy( &self, ) -> DeleteConfiguredAudienceModelPolicyFluentBuilder

Constructs a fluent builder for the DeleteConfiguredAudienceModelPolicy operation.

Source§

impl Client

Source

pub fn delete_configured_model_algorithm( &self, ) -> DeleteConfiguredModelAlgorithmFluentBuilder

Constructs a fluent builder for the DeleteConfiguredModelAlgorithm operation.

Source§

impl Client

Source

pub fn delete_configured_model_algorithm_association( &self, ) -> DeleteConfiguredModelAlgorithmAssociationFluentBuilder

Constructs a fluent builder for the DeleteConfiguredModelAlgorithmAssociation operation.

Source§

impl Client

Source

pub fn delete_ml_configuration(&self) -> DeleteMLConfigurationFluentBuilder

Constructs a fluent builder for the DeleteMLConfiguration operation.

Source§

impl Client

Source

pub fn delete_ml_input_channel_data( &self, ) -> DeleteMLInputChannelDataFluentBuilder

Constructs a fluent builder for the DeleteMLInputChannelData operation.

Source§

impl Client

Source

pub fn delete_trained_model_output( &self, ) -> DeleteTrainedModelOutputFluentBuilder

Constructs a fluent builder for the DeleteTrainedModelOutput operation.

Source§

impl Client

Source

pub fn delete_training_dataset(&self) -> DeleteTrainingDatasetFluentBuilder

Constructs a fluent builder for the DeleteTrainingDataset operation.

Source§

impl Client

Source

pub fn get_audience_generation_job( &self, ) -> GetAudienceGenerationJobFluentBuilder

Constructs a fluent builder for the GetAudienceGenerationJob operation.

Source§

impl Client

Source

pub fn get_audience_model(&self) -> GetAudienceModelFluentBuilder

Constructs a fluent builder for the GetAudienceModel operation.

Source§

impl Client

Source

pub fn get_collaboration_configured_model_algorithm_association( &self, ) -> GetCollaborationConfiguredModelAlgorithmAssociationFluentBuilder

Constructs a fluent builder for the GetCollaborationConfiguredModelAlgorithmAssociation operation.

Source§

impl Client

Source

pub fn get_collaboration_ml_input_channel( &self, ) -> GetCollaborationMLInputChannelFluentBuilder

Constructs a fluent builder for the GetCollaborationMLInputChannel operation.

Source§

impl Client

Source

pub fn get_collaboration_trained_model( &self, ) -> GetCollaborationTrainedModelFluentBuilder

Constructs a fluent builder for the GetCollaborationTrainedModel operation.

Source§

impl Client

Source

pub fn get_configured_audience_model( &self, ) -> GetConfiguredAudienceModelFluentBuilder

Constructs a fluent builder for the GetConfiguredAudienceModel operation.

Source§

impl Client

Source

pub fn get_configured_audience_model_policy( &self, ) -> GetConfiguredAudienceModelPolicyFluentBuilder

Constructs a fluent builder for the GetConfiguredAudienceModelPolicy operation.

Source§

impl Client

Source

pub fn get_configured_model_algorithm( &self, ) -> GetConfiguredModelAlgorithmFluentBuilder

Constructs a fluent builder for the GetConfiguredModelAlgorithm operation.

  • The fluent builder is configurable:
  • On success, responds with GetConfiguredModelAlgorithmOutput with field(s):
    • create_time(DateTime):

      The time at which the configured model algorithm was created.

    • update_time(DateTime):

      The most recent time at which the configured model algorithm was updated.

    • configured_model_algorithm_arn(String):

      The Amazon Resource Name (ARN) of the configured model algorithm.

    • name(String):

      The name of the configured model algorithm.

    • training_container_config(Option<ContainerConfig>):

      The configuration information of the training container for the configured model algorithm.

    • inference_container_config(Option<InferenceContainerConfig>):

      Configuration information for the inference container.

    • role_arn(String):

      The Amazon Resource Name (ARN) of the service role that was used to create the configured model algorithm.

    • description(Option<String>):

      The description of the configured model algorithm.

    • tags(Option<HashMap::<String, String>>):

      The optional metadata that you applied to the resource to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define.

      The following basic restrictions apply to tags:

      • Maximum number of tags per resource - 50.

      • For each resource, each tag key must be unique, and each tag key can have only one value.

      • Maximum key length - 128 Unicode characters in UTF-8.

      • Maximum value length - 256 Unicode characters in UTF-8.

      • If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.

      • Tag keys and values are case sensitive.

      • Do not use aws:, AWS:, or any upper or lowercase combination of such as a prefix for keys as it is reserved for AWS use. You cannot edit or delete tag keys with this prefix. Values can have this prefix. If a tag value has aws as its prefix but the key does not, then Clean Rooms ML considers it to be a user tag and will count against the limit of 50 tags. Tags with only the key prefix of aws do not count against your tags per resource limit.

    • kms_key_arn(Option<String>):

      The Amazon Resource Name (ARN) of the KMS key. This key is used to encrypt and decrypt customer-owned data in the configured ML model and associated data.

  • On failure, responds with SdkError<GetConfiguredModelAlgorithmError>
Source§

impl Client

Source

pub fn get_configured_model_algorithm_association( &self, ) -> GetConfiguredModelAlgorithmAssociationFluentBuilder

Constructs a fluent builder for the GetConfiguredModelAlgorithmAssociation operation.

Source§

impl Client

Source

pub fn get_ml_configuration(&self) -> GetMLConfigurationFluentBuilder

Constructs a fluent builder for the GetMLConfiguration operation.

Source§

impl Client

Source

pub fn get_ml_input_channel(&self) -> GetMLInputChannelFluentBuilder

Constructs a fluent builder for the GetMLInputChannel operation.

Source§

impl Client

Source

pub fn get_trained_model(&self) -> GetTrainedModelFluentBuilder

Constructs a fluent builder for the GetTrainedModel operation.

Source§

impl Client

Source

pub fn get_trained_model_inference_job( &self, ) -> GetTrainedModelInferenceJobFluentBuilder

Constructs a fluent builder for the GetTrainedModelInferenceJob operation.

Source§

impl Client

Source

pub fn get_training_dataset(&self) -> GetTrainingDatasetFluentBuilder

Constructs a fluent builder for the GetTrainingDataset operation.

Source§

impl Client

Source

pub fn list_audience_export_jobs(&self) -> ListAudienceExportJobsFluentBuilder

Constructs a fluent builder for the ListAudienceExportJobs operation. This operation supports pagination; See into_paginator().

Source§

impl Client

Source

pub fn list_audience_generation_jobs( &self, ) -> ListAudienceGenerationJobsFluentBuilder

Constructs a fluent builder for the ListAudienceGenerationJobs operation. This operation supports pagination; See into_paginator().

Source§

impl Client

Source

pub fn list_audience_models(&self) -> ListAudienceModelsFluentBuilder

Constructs a fluent builder for the ListAudienceModels operation. This operation supports pagination; See into_paginator().

Source§

impl Client

Source

pub fn list_collaboration_configured_model_algorithm_associations( &self, ) -> ListCollaborationConfiguredModelAlgorithmAssociationsFluentBuilder

Constructs a fluent builder for the ListCollaborationConfiguredModelAlgorithmAssociations operation. This operation supports pagination; See into_paginator().

Source§

impl Client

Source

pub fn list_collaboration_ml_input_channels( &self, ) -> ListCollaborationMLInputChannelsFluentBuilder

Constructs a fluent builder for the ListCollaborationMLInputChannels operation. This operation supports pagination; See into_paginator().

Source§

impl Client

Source

pub fn list_collaboration_trained_model_export_jobs( &self, ) -> ListCollaborationTrainedModelExportJobsFluentBuilder

Constructs a fluent builder for the ListCollaborationTrainedModelExportJobs operation. This operation supports pagination; See into_paginator().

Source§

impl Client

Source

pub fn list_collaboration_trained_model_inference_jobs( &self, ) -> ListCollaborationTrainedModelInferenceJobsFluentBuilder

Constructs a fluent builder for the ListCollaborationTrainedModelInferenceJobs operation. This operation supports pagination; See into_paginator().

Source§

impl Client

Source

pub fn list_collaboration_trained_models( &self, ) -> ListCollaborationTrainedModelsFluentBuilder

Constructs a fluent builder for the ListCollaborationTrainedModels operation. This operation supports pagination; See into_paginator().

Source§

impl Client

Source

pub fn list_configured_audience_models( &self, ) -> ListConfiguredAudienceModelsFluentBuilder

Constructs a fluent builder for the ListConfiguredAudienceModels operation. This operation supports pagination; See into_paginator().

Source§

impl Client

Source

pub fn list_configured_model_algorithm_associations( &self, ) -> ListConfiguredModelAlgorithmAssociationsFluentBuilder

Constructs a fluent builder for the ListConfiguredModelAlgorithmAssociations operation. This operation supports pagination; See into_paginator().

Source§

impl Client

Source

pub fn list_configured_model_algorithms( &self, ) -> ListConfiguredModelAlgorithmsFluentBuilder

Constructs a fluent builder for the ListConfiguredModelAlgorithms operation. This operation supports pagination; See into_paginator().

Source§

impl Client

Source

pub fn list_ml_input_channels(&self) -> ListMLInputChannelsFluentBuilder

Constructs a fluent builder for the ListMLInputChannels operation. This operation supports pagination; See into_paginator().

Source§

impl Client

Source

pub fn list_tags_for_resource(&self) -> ListTagsForResourceFluentBuilder

Constructs a fluent builder for the ListTagsForResource operation.

Source§

impl Client

Source

pub fn list_trained_model_inference_jobs( &self, ) -> ListTrainedModelInferenceJobsFluentBuilder

Constructs a fluent builder for the ListTrainedModelInferenceJobs operation. This operation supports pagination; See into_paginator().

Source§

impl Client

Source

pub fn list_trained_model_versions( &self, ) -> ListTrainedModelVersionsFluentBuilder

Constructs a fluent builder for the ListTrainedModelVersions operation. This operation supports pagination; See into_paginator().

Source§

impl Client

Source

pub fn list_trained_models(&self) -> ListTrainedModelsFluentBuilder

Constructs a fluent builder for the ListTrainedModels operation. This operation supports pagination; See into_paginator().

Source§

impl Client

Source

pub fn list_training_datasets(&self) -> ListTrainingDatasetsFluentBuilder

Constructs a fluent builder for the ListTrainingDatasets operation. This operation supports pagination; See into_paginator().

Source§

impl Client

Source

pub fn put_configured_audience_model_policy( &self, ) -> PutConfiguredAudienceModelPolicyFluentBuilder

Constructs a fluent builder for the PutConfiguredAudienceModelPolicy operation.

Source§

impl Client

Source

pub fn put_ml_configuration(&self) -> PutMLConfigurationFluentBuilder

Constructs a fluent builder for the PutMLConfiguration operation.

Source§

impl Client

Source

pub fn start_audience_export_job(&self) -> StartAudienceExportJobFluentBuilder

Constructs a fluent builder for the StartAudienceExportJob operation.

Source§

impl Client

Source

pub fn start_audience_generation_job( &self, ) -> StartAudienceGenerationJobFluentBuilder

Constructs a fluent builder for the StartAudienceGenerationJob operation.

Source§

impl Client

Source

pub fn start_trained_model_export_job( &self, ) -> StartTrainedModelExportJobFluentBuilder

Constructs a fluent builder for the StartTrainedModelExportJob operation.

Source§

impl Client

Source

pub fn start_trained_model_inference_job( &self, ) -> StartTrainedModelInferenceJobFluentBuilder

Constructs a fluent builder for the StartTrainedModelInferenceJob operation.

Source§

impl Client

Source

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: true

      The Amazon Resource Name (ARN) of the resource that you want to assign tags.


    • tags(impl Into<String>, impl Into<String>) / set_tags(Option<HashMap::<String, String>>):
      required: true

      The optional metadata that you apply to the resource to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define.

      The following basic restrictions apply to tags:

      • Maximum number of tags per resource - 50.

      • For each resource, each tag key must be unique, and each tag key can have only one value.

      • Maximum key length - 128 Unicode characters in UTF-8.

      • Maximum value length - 256 Unicode characters in UTF-8.

      • If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.

      • Tag keys and values are case sensitive.

      • Do not use aws:, AWS:, or any upper or lowercase combination of such as a prefix for keys as it is reserved for AWS use. You cannot edit or delete tag keys with this prefix. Values can have this prefix. If a tag value has aws as its prefix but the key does not, then Clean Rooms considers it to be a user tag and will count against the limit of 50 tags. Tags with only the key prefix of aws do not count against your tags per resource limit.


  • On success, responds with TagResourceOutput
  • On failure, responds with SdkError<TagResourceError>
Source§

impl Client

Source

pub fn untag_resource(&self) -> UntagResourceFluentBuilder

Constructs a fluent builder for the UntagResource operation.

Source§

impl Client

Source

pub fn update_configured_audience_model( &self, ) -> UpdateConfiguredAudienceModelFluentBuilder

Constructs a fluent builder for the UpdateConfiguredAudienceModel operation.

Source§

impl Client

Source

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_impl configured.
  • Identity caching is enabled without a sleep_impl and time_source configured.
  • No behavior_version is provided.

The panic message for each of these will have instructions on how to resolve them.

Source

pub fn config(&self) -> &Config

Returns the client’s configuration.

Source§

impl Client

Source

pub fn new(sdk_config: &SdkConfig) -> Self

Creates a new client from an SDK Config.

§Panics
  • This method will panic if the sdk_config is missing an async sleep implementation. If you experience this panic, set the sleep_impl on the Config passed into this function to fix it.
  • This method will panic if the sdk_config is missing an HTTP connector. If you experience this panic, set the http_connector on the Config passed into this function to fix it.
  • This method will panic if no BehaviorVersion is provided. If you experience this panic, set behavior_version on the Config or enable the behavior-version-latest Cargo feature.

Trait Implementations§

Source§

impl Clone for Client

Source§

fn clone(&self) -> Client

Returns a duplicate of the value. Read more
1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for Client

Source§

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

Formats the value using the given formatter. Read more

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> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts 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 more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts 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 more
Source§

impl<Unshared, Shared> IntoShared<Shared> for Unshared
where Shared: FromUnshared<Unshared>,

Source§

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.
Source§

impl<T> Paint for T
where T: ?Sized,

Source§

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 primary(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: Primary].

§Example
println!("{}", value.primary());
Source§

fn fixed(&self, color: u8) -> Painted<&T>

Returns self with the fg() set to [Color :: Fixed].

§Example
println!("{}", value.fixed(color));
Source§

fn rgb(&self, r: u8, g: u8, b: u8) -> Painted<&T>

Returns self with the fg() set to [Color :: Rgb].

§Example
println!("{}", value.rgb(r, g, b));
Source§

fn black(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: Black].

§Example
println!("{}", value.black());
Source§

fn red(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: Red].

§Example
println!("{}", value.red());
Source§

fn green(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: Green].

§Example
println!("{}", value.green());
Source§

fn yellow(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: Yellow].

§Example
println!("{}", value.yellow());
Source§

fn blue(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: Blue].

§Example
println!("{}", value.blue());
Source§

fn magenta(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: Magenta].

§Example
println!("{}", value.magenta());
Source§

fn cyan(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: Cyan].

§Example
println!("{}", value.cyan());
Source§

fn white(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: White].

§Example
println!("{}", value.white());
Source§

fn bright_black(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: BrightBlack].

§Example
println!("{}", value.bright_black());
Source§

fn bright_red(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: BrightRed].

§Example
println!("{}", value.bright_red());
Source§

fn bright_green(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: BrightGreen].

§Example
println!("{}", value.bright_green());
Source§

fn bright_yellow(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: BrightYellow].

§Example
println!("{}", value.bright_yellow());
Source§

fn bright_blue(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: BrightBlue].

§Example
println!("{}", value.bright_blue());
Source§

fn bright_magenta(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: BrightMagenta].

§Example
println!("{}", value.bright_magenta());
Source§

fn bright_cyan(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: BrightCyan].

§Example
println!("{}", value.bright_cyan());
Source§

fn bright_white(&self) -> Painted<&T>

Returns self with the fg() set to [Color :: BrightWhite].

§Example
println!("{}", value.bright_white());
Source§

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>

Returns self with the bg() set to [Color :: Primary].

§Example
println!("{}", value.on_primary());
Source§

fn on_fixed(&self, color: u8) -> Painted<&T>

Returns self with the bg() set to [Color :: Fixed].

§Example
println!("{}", value.on_fixed(color));
Source§

fn on_rgb(&self, r: u8, g: u8, b: u8) -> Painted<&T>

Returns self with the bg() set to [Color :: Rgb].

§Example
println!("{}", value.on_rgb(r, g, b));
Source§

fn on_black(&self) -> Painted<&T>

Returns self with the bg() set to [Color :: Black].

§Example
println!("{}", value.on_black());
Source§

fn on_red(&self) -> Painted<&T>

Returns self with the bg() set to [Color :: Red].

§Example
println!("{}", value.on_red());
Source§

fn on_green(&self) -> Painted<&T>

Returns self with the bg() set to [Color :: Green].

§Example
println!("{}", value.on_green());
Source§

fn on_yellow(&self) -> Painted<&T>

Returns self with the bg() set to [Color :: Yellow].

§Example
println!("{}", value.on_yellow());
Source§

fn on_blue(&self) -> Painted<&T>

Returns self with the bg() set to [Color :: Blue].

§Example
println!("{}", value.on_blue());
Source§

fn on_magenta(&self) -> Painted<&T>

Returns self with the bg() set to [Color :: Magenta].

§Example
println!("{}", value.on_magenta());
Source§

fn on_cyan(&self) -> Painted<&T>

Returns self with the bg() set to [Color :: Cyan].

§Example
println!("{}", value.on_cyan());
Source§

fn on_white(&self) -> Painted<&T>

Returns self with the bg() set to [Color :: White].

§Example
println!("{}", value.on_white());
Source§

fn on_bright_black(&self) -> Painted<&T>

Returns self with the bg() set to [Color :: BrightBlack].

§Example
println!("{}", value.on_bright_black());
Source§

fn on_bright_red(&self) -> Painted<&T>

Returns self with the bg() set to [Color :: BrightRed].

§Example
println!("{}", value.on_bright_red());
Source§

fn on_bright_green(&self) -> Painted<&T>

Returns self with the bg() set to [Color :: BrightGreen].

§Example
println!("{}", value.on_bright_green());
Source§

fn on_bright_yellow(&self) -> Painted<&T>

Returns self with the bg() set to [Color :: BrightYellow].

§Example
println!("{}", value.on_bright_yellow());
Source§

fn on_bright_blue(&self) -> Painted<&T>

Returns self with the bg() set to [Color :: BrightBlue].

§Example
println!("{}", value.on_bright_blue());
Source§

fn on_bright_magenta(&self) -> Painted<&T>

Returns self with the bg() set to [Color :: BrightMagenta].

§Example
println!("{}", value.on_bright_magenta());
Source§

fn on_bright_cyan(&self) -> Painted<&T>

Returns self with the bg() set to [Color :: BrightCyan].

§Example
println!("{}", value.on_bright_cyan());
Source§

fn on_bright_white(&self) -> Painted<&T>

Returns self with the bg() set to [Color :: BrightWhite].

§Example
println!("{}", value.on_bright_white());
Source§

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 bold(&self) -> Painted<&T>

Returns self with the attr() set to [Attribute :: Bold].

§Example
println!("{}", value.bold());
Source§

fn dim(&self) -> Painted<&T>

Returns self with the attr() set to [Attribute :: Dim].

§Example
println!("{}", value.dim());
Source§

fn italic(&self) -> Painted<&T>

Returns self with the attr() set to [Attribute :: Italic].

§Example
println!("{}", value.italic());
Source§

fn underline(&self) -> Painted<&T>

Returns self with the attr() set to [Attribute :: Underline].

§Example
println!("{}", value.underline());

Returns self with the attr() set to [Attribute :: Blink].

§Example
println!("{}", value.blink());

Returns self with the attr() set to [Attribute :: RapidBlink].

§Example
println!("{}", value.rapid_blink());
Source§

fn invert(&self) -> Painted<&T>

Returns self with the attr() set to [Attribute :: Invert].

§Example
println!("{}", value.invert());
Source§

fn conceal(&self) -> Painted<&T>

Returns self with the attr() set to [Attribute :: Conceal].

§Example
println!("{}", value.conceal());
Source§

fn strike(&self) -> Painted<&T>

Returns self with the attr() set to [Attribute :: Strike].

§Example
println!("{}", value.strike());
Source§

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 mask(&self) -> Painted<&T>

Returns self with the quirk() set to [Quirk :: Mask].

§Example
println!("{}", value.mask());
Source§

fn wrap(&self) -> Painted<&T>

Returns self with the quirk() set to [Quirk :: Wrap].

§Example
println!("{}", value.wrap());
Source§

fn linger(&self) -> Painted<&T>

Returns self with the quirk() set to [Quirk :: Linger].

§Example
println!("{}", value.linger());
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.

Returns self with the quirk() set to [Quirk :: Clear].

§Example
println!("{}", value.clear());
Source§

fn resetting(&self) -> Painted<&T>

Returns self with the quirk() set to [Quirk :: Resetting].

§Example
println!("{}", value.resetting());
Source§

fn bright(&self) -> Painted<&T>

Returns self with the quirk() set to [Quirk :: Bright].

§Example
println!("{}", value.bright());
Source§

fn on_bright(&self) -> Painted<&T>

Returns self with the quirk() set to [Quirk :: OnBright].

§Example
println!("{}", value.on_bright());
Source§

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);
Source§

fn new(self) -> Painted<Self>
where Self: Sized,

Create a new Painted with a default Style. Read more
Source§

fn paint<S>(&self, style: S) -> Painted<&Self>
where S: Into<Style>,

Apply a style wholesale to self. Any previous style is replaced. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

impl<T> ErasedDestructor for T
where T: 'static,