Struct Client

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

Client for Amazon Omics

Client for invoking operations on Amazon Omics. Each operation on Amazon Omics 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_omics::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_omics::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 AbortMultipartReadSetUpload operation has a Client::abort_multipart_read_set_upload, 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.abort_multipart_read_set_upload()
    .sequence_store_id("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.

§Waiters

This client provides wait_until methods behind the Waiters trait. To use them, simply import the trait, and then call one of the wait_until methods. This will return a waiter fluent builder that takes various parameters, which are documented on the builder type. Once parameters have been provided, the wait method can be called to initiate waiting.

For example, if there was a wait_until_thing method, it could look like:

let result = client.wait_until_thing()
    .thing_id("someId")
    .wait(Duration::from_secs(120))
    .await;

Implementations§

Source§

impl Client

Source

pub fn abort_multipart_read_set_upload( &self, ) -> AbortMultipartReadSetUploadFluentBuilder

Constructs a fluent builder for the AbortMultipartReadSetUpload operation.

Source§

impl Client

Source

pub fn accept_share(&self) -> AcceptShareFluentBuilder

Constructs a fluent builder for the AcceptShare operation.

Source§

impl Client

Source

pub fn batch_delete_read_set(&self) -> BatchDeleteReadSetFluentBuilder

Constructs a fluent builder for the BatchDeleteReadSet operation.

Source§

impl Client

Source

pub fn cancel_annotation_import_job( &self, ) -> CancelAnnotationImportJobFluentBuilder

Constructs a fluent builder for the CancelAnnotationImportJob operation.

Source§

impl Client

Source

pub fn cancel_run(&self) -> CancelRunFluentBuilder

Constructs a fluent builder for the CancelRun operation.

Source§

impl Client

Source

pub fn cancel_variant_import_job(&self) -> CancelVariantImportJobFluentBuilder

Constructs a fluent builder for the CancelVariantImportJob operation.

Source§

impl Client

Source

pub fn complete_multipart_read_set_upload( &self, ) -> CompleteMultipartReadSetUploadFluentBuilder

Constructs a fluent builder for the CompleteMultipartReadSetUpload operation.

Source§

impl Client

Source

pub fn create_annotation_store(&self) -> CreateAnnotationStoreFluentBuilder

Constructs a fluent builder for the CreateAnnotationStore operation.

Source§

impl Client

Source

pub fn create_annotation_store_version( &self, ) -> CreateAnnotationStoreVersionFluentBuilder

Constructs a fluent builder for the CreateAnnotationStoreVersion operation.

Source§

impl Client

Source

pub fn create_multipart_read_set_upload( &self, ) -> CreateMultipartReadSetUploadFluentBuilder

Constructs a fluent builder for the CreateMultipartReadSetUpload operation.

Source§

impl Client

Source

pub fn create_reference_store(&self) -> CreateReferenceStoreFluentBuilder

Constructs a fluent builder for the CreateReferenceStore operation.

Source§

impl Client

Source

pub fn create_run_cache(&self) -> CreateRunCacheFluentBuilder

Constructs a fluent builder for the CreateRunCache operation.

Source§

impl Client

Source

pub fn create_run_group(&self) -> CreateRunGroupFluentBuilder

Constructs a fluent builder for the CreateRunGroup operation.

Source§

impl Client

Source

pub fn create_sequence_store(&self) -> CreateSequenceStoreFluentBuilder

Constructs a fluent builder for the CreateSequenceStore operation.

Source§

impl Client

Source

pub fn create_share(&self) -> CreateShareFluentBuilder

Constructs a fluent builder for the CreateShare operation.

Source§

impl Client

Source

pub fn create_variant_store(&self) -> CreateVariantStoreFluentBuilder

Constructs a fluent builder for the CreateVariantStore operation.

Source§

impl Client

Source

pub fn create_workflow(&self) -> CreateWorkflowFluentBuilder

Constructs a fluent builder for the CreateWorkflow operation.

Source§

impl Client

Source

pub fn create_workflow_version(&self) -> CreateWorkflowVersionFluentBuilder

Constructs a fluent builder for the CreateWorkflowVersion operation.

Source§

impl Client

Source

pub fn delete_annotation_store(&self) -> DeleteAnnotationStoreFluentBuilder

Constructs a fluent builder for the DeleteAnnotationStore operation.

Source§

impl Client

Source

pub fn delete_annotation_store_versions( &self, ) -> DeleteAnnotationStoreVersionsFluentBuilder

Constructs a fluent builder for the DeleteAnnotationStoreVersions operation.

Source§

impl Client

Source

pub fn delete_reference(&self) -> DeleteReferenceFluentBuilder

Constructs a fluent builder for the DeleteReference operation.

Source§

impl Client

Source

pub fn delete_reference_store(&self) -> DeleteReferenceStoreFluentBuilder

Constructs a fluent builder for the DeleteReferenceStore operation.

Source§

impl Client

Source

pub fn delete_run(&self) -> DeleteRunFluentBuilder

Constructs a fluent builder for the DeleteRun operation.

Source§

impl Client

Source

pub fn delete_run_cache(&self) -> DeleteRunCacheFluentBuilder

Constructs a fluent builder for the DeleteRunCache operation.

Source§

impl Client

Source

pub fn delete_run_group(&self) -> DeleteRunGroupFluentBuilder

Constructs a fluent builder for the DeleteRunGroup operation.

Source§

impl Client

Source

pub fn delete_s3_access_policy(&self) -> DeleteS3AccessPolicyFluentBuilder

Constructs a fluent builder for the DeleteS3AccessPolicy operation.

Source§

impl Client

Source

pub fn delete_sequence_store(&self) -> DeleteSequenceStoreFluentBuilder

Constructs a fluent builder for the DeleteSequenceStore operation.

Source§

impl Client

Source

pub fn delete_share(&self) -> DeleteShareFluentBuilder

Constructs a fluent builder for the DeleteShare operation.

Source§

impl Client

Source

pub fn delete_variant_store(&self) -> DeleteVariantStoreFluentBuilder

Constructs a fluent builder for the DeleteVariantStore operation.

Source§

impl Client

Source

pub fn delete_workflow(&self) -> DeleteWorkflowFluentBuilder

Constructs a fluent builder for the DeleteWorkflow operation.

Source§

impl Client

Source

pub fn delete_workflow_version(&self) -> DeleteWorkflowVersionFluentBuilder

Constructs a fluent builder for the DeleteWorkflowVersion operation.

Source§

impl Client

Source

pub fn get_annotation_import_job(&self) -> GetAnnotationImportJobFluentBuilder

Constructs a fluent builder for the GetAnnotationImportJob operation.

Source§

impl Client

Source

pub fn get_annotation_store(&self) -> GetAnnotationStoreFluentBuilder

Constructs a fluent builder for the GetAnnotationStore operation.

Source§

impl Client

Source

pub fn get_annotation_store_version( &self, ) -> GetAnnotationStoreVersionFluentBuilder

Constructs a fluent builder for the GetAnnotationStoreVersion operation.

Source§

impl Client

Source

pub fn get_read_set(&self) -> GetReadSetFluentBuilder

Constructs a fluent builder for the GetReadSet operation.

Source§

impl Client

Source

pub fn get_read_set_activation_job( &self, ) -> GetReadSetActivationJobFluentBuilder

Constructs a fluent builder for the GetReadSetActivationJob operation.

Source§

impl Client

Source

pub fn get_read_set_export_job(&self) -> GetReadSetExportJobFluentBuilder

Constructs a fluent builder for the GetReadSetExportJob operation.

Source§

impl Client

Source

pub fn get_read_set_import_job(&self) -> GetReadSetImportJobFluentBuilder

Constructs a fluent builder for the GetReadSetImportJob operation.

Source§

impl Client

Source

pub fn get_read_set_metadata(&self) -> GetReadSetMetadataFluentBuilder

Constructs a fluent builder for the GetReadSetMetadata operation.

Source§

impl Client

Source

pub fn get_reference(&self) -> GetReferenceFluentBuilder

Constructs a fluent builder for the GetReference operation.

Source§

impl Client

Source

pub fn get_reference_import_job(&self) -> GetReferenceImportJobFluentBuilder

Constructs a fluent builder for the GetReferenceImportJob operation.

Source§

impl Client

Source

pub fn get_reference_metadata(&self) -> GetReferenceMetadataFluentBuilder

Constructs a fluent builder for the GetReferenceMetadata operation.

Source§

impl Client

Source

pub fn get_reference_store(&self) -> GetReferenceStoreFluentBuilder

Constructs a fluent builder for the GetReferenceStore operation.

Source§

impl Client

Source

pub fn get_run(&self) -> GetRunFluentBuilder

Constructs a fluent builder for the GetRun operation.

Source§

impl Client

Source

pub fn get_run_cache(&self) -> GetRunCacheFluentBuilder

Constructs a fluent builder for the GetRunCache operation.

Source§

impl Client

Source

pub fn get_run_group(&self) -> GetRunGroupFluentBuilder

Constructs a fluent builder for the GetRunGroup operation.

Source§

impl Client

Source

pub fn get_run_task(&self) -> GetRunTaskFluentBuilder

Constructs a fluent builder for the GetRunTask operation.

Source§

impl Client

Source

pub fn get_s3_access_policy(&self) -> GetS3AccessPolicyFluentBuilder

Constructs a fluent builder for the GetS3AccessPolicy operation.

Source§

impl Client

Source

pub fn get_sequence_store(&self) -> GetSequenceStoreFluentBuilder

Constructs a fluent builder for the GetSequenceStore operation.

Source§

impl Client

Source

pub fn get_share(&self) -> GetShareFluentBuilder

Constructs a fluent builder for the GetShare operation.

Source§

impl Client

Source

pub fn get_variant_import_job(&self) -> GetVariantImportJobFluentBuilder

Constructs a fluent builder for the GetVariantImportJob operation.

Source§

impl Client

Source

pub fn get_variant_store(&self) -> GetVariantStoreFluentBuilder

Constructs a fluent builder for the GetVariantStore operation.

Source§

impl Client

Source

pub fn get_workflow(&self) -> GetWorkflowFluentBuilder

Constructs a fluent builder for the GetWorkflow operation.

Source§

impl Client

Source

pub fn get_workflow_version(&self) -> GetWorkflowVersionFluentBuilder

Constructs a fluent builder for the GetWorkflowVersion operation.

Source§

impl Client

Source

pub fn list_annotation_import_jobs( &self, ) -> ListAnnotationImportJobsFluentBuilder

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

Source§

impl Client

Source

pub fn list_annotation_store_versions( &self, ) -> ListAnnotationStoreVersionsFluentBuilder

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

Source§

impl Client

Source

pub fn list_annotation_stores(&self) -> ListAnnotationStoresFluentBuilder

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

Source§

impl Client

Source

pub fn list_multipart_read_set_uploads( &self, ) -> ListMultipartReadSetUploadsFluentBuilder

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

Source§

impl Client

Source

pub fn list_read_set_activation_jobs( &self, ) -> ListReadSetActivationJobsFluentBuilder

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

Source§

impl Client

Source

pub fn list_read_set_export_jobs(&self) -> ListReadSetExportJobsFluentBuilder

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

Source§

impl Client

Source

pub fn list_read_set_import_jobs(&self) -> ListReadSetImportJobsFluentBuilder

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

Source§

impl Client

Source

pub fn list_read_set_upload_parts(&self) -> ListReadSetUploadPartsFluentBuilder

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

Source§

impl Client

Source

pub fn list_read_sets(&self) -> ListReadSetsFluentBuilder

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

Source§

impl Client

Source

pub fn list_reference_import_jobs(&self) -> ListReferenceImportJobsFluentBuilder

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

Source§

impl Client

Source

pub fn list_reference_stores(&self) -> ListReferenceStoresFluentBuilder

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

Source§

impl Client

Source

pub fn list_references(&self) -> ListReferencesFluentBuilder

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

Source§

impl Client

Source

pub fn list_run_caches(&self) -> ListRunCachesFluentBuilder

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

Source§

impl Client

Source

pub fn list_run_groups(&self) -> ListRunGroupsFluentBuilder

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

Source§

impl Client

Source

pub fn list_run_tasks(&self) -> ListRunTasksFluentBuilder

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

Source§

impl Client

Source

pub fn list_runs(&self) -> ListRunsFluentBuilder

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

Source§

impl Client

Source

pub fn list_sequence_stores(&self) -> ListSequenceStoresFluentBuilder

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

Source§

impl Client

Source

pub fn list_shares(&self) -> ListSharesFluentBuilder

Constructs a fluent builder for the ListShares 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_variant_import_jobs(&self) -> ListVariantImportJobsFluentBuilder

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

Source§

impl Client

Source

pub fn list_variant_stores(&self) -> ListVariantStoresFluentBuilder

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

Source§

impl Client

Source

pub fn list_workflow_versions(&self) -> ListWorkflowVersionsFluentBuilder

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

Source§

impl Client

Source

pub fn list_workflows(&self) -> ListWorkflowsFluentBuilder

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

Source§

impl Client

Source

pub fn put_s3_access_policy(&self) -> PutS3AccessPolicyFluentBuilder

Constructs a fluent builder for the PutS3AccessPolicy operation.

Source§

impl Client

Source

pub fn start_annotation_import_job( &self, ) -> StartAnnotationImportJobFluentBuilder

Constructs a fluent builder for the StartAnnotationImportJob operation.

Source§

impl Client

Source

pub fn start_read_set_activation_job( &self, ) -> StartReadSetActivationJobFluentBuilder

Constructs a fluent builder for the StartReadSetActivationJob operation.

Source§

impl Client

Source

pub fn start_read_set_export_job(&self) -> StartReadSetExportJobFluentBuilder

Constructs a fluent builder for the StartReadSetExportJob operation.

Source§

impl Client

Source

pub fn start_read_set_import_job(&self) -> StartReadSetImportJobFluentBuilder

Constructs a fluent builder for the StartReadSetImportJob operation.

Source§

impl Client

Source

pub fn start_reference_import_job(&self) -> StartReferenceImportJobFluentBuilder

Constructs a fluent builder for the StartReferenceImportJob operation.

Source§

impl Client

Source

pub fn start_run(&self) -> StartRunFluentBuilder

Constructs a fluent builder for the StartRun operation.

Source§

impl Client

Source

pub fn start_variant_import_job(&self) -> StartVariantImportJobFluentBuilder

Constructs a fluent builder for the StartVariantImportJob operation.

Source§

impl Client

Source

pub fn tag_resource(&self) -> TagResourceFluentBuilder

Constructs a fluent builder for the TagResource operation.

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_annotation_store(&self) -> UpdateAnnotationStoreFluentBuilder

Constructs a fluent builder for the UpdateAnnotationStore operation.

Source§

impl Client

Source

pub fn update_annotation_store_version( &self, ) -> UpdateAnnotationStoreVersionFluentBuilder

Constructs a fluent builder for the UpdateAnnotationStoreVersion operation.

Source§

impl Client

Source

pub fn update_run_cache(&self) -> UpdateRunCacheFluentBuilder

Constructs a fluent builder for the UpdateRunCache operation.

Source§

impl Client

Source

pub fn update_run_group(&self) -> UpdateRunGroupFluentBuilder

Constructs a fluent builder for the UpdateRunGroup operation.

Source§

impl Client

Source

pub fn update_sequence_store(&self) -> UpdateSequenceStoreFluentBuilder

Constructs a fluent builder for the UpdateSequenceStore operation.

Source§

impl Client

Source

pub fn update_variant_store(&self) -> UpdateVariantStoreFluentBuilder

Constructs a fluent builder for the UpdateVariantStore operation.

Source§

impl Client

Source

pub fn update_workflow(&self) -> UpdateWorkflowFluentBuilder

Constructs a fluent builder for the UpdateWorkflow operation.

Source§

impl Client

Source

pub fn update_workflow_version(&self) -> UpdateWorkflowVersionFluentBuilder

Constructs a fluent builder for the UpdateWorkflowVersion operation.

Source§

impl Client

Source

pub fn upload_read_set_part(&self) -> UploadReadSetPartFluentBuilder

Constructs a fluent builder for the UploadReadSetPart 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 copy 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
Source§

impl Waiters for Client

Source§

fn wait_until_annotation_import_job_created( &self, ) -> AnnotationImportJobCreatedFluentBuilder

Wait until an annotation import is completed
Source§

fn wait_until_annotation_store_created( &self, ) -> AnnotationStoreCreatedFluentBuilder

Wait until an annotation store is created
Source§

fn wait_until_annotation_store_deleted( &self, ) -> AnnotationStoreDeletedFluentBuilder

Wait until an annotation store is deleted.
Source§

fn wait_until_annotation_store_version_created( &self, ) -> AnnotationStoreVersionCreatedFluentBuilder

Wait until an annotation store version is created
Source§

fn wait_until_annotation_store_version_deleted( &self, ) -> AnnotationStoreVersionDeletedFluentBuilder

Wait until an annotation store version is deleted.
Source§

fn wait_until_read_set_activation_job_completed( &self, ) -> ReadSetActivationJobCompletedFluentBuilder

Wait until a job is completed.
Source§

fn wait_until_read_set_export_job_completed( &self, ) -> ReadSetExportJobCompletedFluentBuilder

Wait until a job is completed.
Source§

fn wait_until_read_set_import_job_completed( &self, ) -> ReadSetImportJobCompletedFluentBuilder

Wait until a job is completed.
Source§

fn wait_until_reference_import_job_completed( &self, ) -> ReferenceImportJobCompletedFluentBuilder

Wait until a job is completed.
Source§

fn wait_until_run_running(&self) -> RunRunningFluentBuilder

Wait until a run is running.
Source§

fn wait_until_run_completed(&self) -> RunCompletedFluentBuilder

Wait until a run is completed.
Source§

fn wait_until_task_running(&self) -> TaskRunningFluentBuilder

Wait until a task is running.
Source§

fn wait_until_task_completed(&self) -> TaskCompletedFluentBuilder

Wait until a task is completed.
Source§

fn wait_until_variant_import_job_created( &self, ) -> VariantImportJobCreatedFluentBuilder

Wait until variant import is completed
Source§

fn wait_until_variant_store_created(&self) -> VariantStoreCreatedFluentBuilder

Wait until a variant store is created
Source§

fn wait_until_variant_store_deleted(&self) -> VariantStoreDeletedFluentBuilder

Wait until a variant store is deleted.
Source§

fn wait_until_workflow_active(&self) -> WorkflowActiveFluentBuilder

Wait until a workflow is active.
Source§

fn wait_until_workflow_version_active( &self, ) -> WorkflowVersionActiveFluentBuilder

Wait until a workflow version is active.

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,