#[non_exhaustive]pub struct JobBuilder { /* private fields */ }
Expand description
A builder for Job
.
Implementations§
Source§impl JobBuilder
impl JobBuilder
Sourcepub fn job_arn(self, input: impl Into<String>) -> Self
pub fn job_arn(self, input: impl Into<String>) -> Self
An ARN identifying the job with format "arn:aws:iot:region:account:job/jobId".
Sourcepub fn set_job_arn(self, input: Option<String>) -> Self
pub fn set_job_arn(self, input: Option<String>) -> Self
An ARN identifying the job with format "arn:aws:iot:region:account:job/jobId".
Sourcepub fn get_job_arn(&self) -> &Option<String>
pub fn get_job_arn(&self) -> &Option<String>
An ARN identifying the job with format "arn:aws:iot:region:account:job/jobId".
Sourcepub fn job_id(self, input: impl Into<String>) -> Self
pub fn job_id(self, input: impl Into<String>) -> Self
The unique identifier you assigned to this job when it was created.
Sourcepub fn set_job_id(self, input: Option<String>) -> Self
pub fn set_job_id(self, input: Option<String>) -> Self
The unique identifier you assigned to this job when it was created.
Sourcepub fn get_job_id(&self) -> &Option<String>
pub fn get_job_id(&self) -> &Option<String>
The unique identifier you assigned to this job when it was created.
Sourcepub fn target_selection(self, input: TargetSelection) -> Self
pub fn target_selection(self, input: TargetSelection) -> Self
Specifies whether the job will continue to run (CONTINUOUS), or will be complete after all those things specified as targets have completed the job (SNAPSHOT). If continuous, the job may also be run on a thing when a change is detected in a target. For example, a job will run on a device when the thing representing the device is added to a target group, even after the job was completed by all things originally in the group.
We recommend that you use continuous jobs instead of snapshot jobs for dynamic thing group targets. By using continuous jobs, devices that join the group receive the job execution even after the job has been created.
Sourcepub fn set_target_selection(self, input: Option<TargetSelection>) -> Self
pub fn set_target_selection(self, input: Option<TargetSelection>) -> Self
Specifies whether the job will continue to run (CONTINUOUS), or will be complete after all those things specified as targets have completed the job (SNAPSHOT). If continuous, the job may also be run on a thing when a change is detected in a target. For example, a job will run on a device when the thing representing the device is added to a target group, even after the job was completed by all things originally in the group.
We recommend that you use continuous jobs instead of snapshot jobs for dynamic thing group targets. By using continuous jobs, devices that join the group receive the job execution even after the job has been created.
Sourcepub fn get_target_selection(&self) -> &Option<TargetSelection>
pub fn get_target_selection(&self) -> &Option<TargetSelection>
Specifies whether the job will continue to run (CONTINUOUS), or will be complete after all those things specified as targets have completed the job (SNAPSHOT). If continuous, the job may also be run on a thing when a change is detected in a target. For example, a job will run on a device when the thing representing the device is added to a target group, even after the job was completed by all things originally in the group.
We recommend that you use continuous jobs instead of snapshot jobs for dynamic thing group targets. By using continuous jobs, devices that join the group receive the job execution even after the job has been created.
Sourcepub fn status(self, input: JobStatus) -> Self
pub fn status(self, input: JobStatus) -> Self
The status of the job, one of IN_PROGRESS
, CANCELED
, DELETION_IN_PROGRESS
or COMPLETED
.
Sourcepub fn set_status(self, input: Option<JobStatus>) -> Self
pub fn set_status(self, input: Option<JobStatus>) -> Self
The status of the job, one of IN_PROGRESS
, CANCELED
, DELETION_IN_PROGRESS
or COMPLETED
.
Sourcepub fn get_status(&self) -> &Option<JobStatus>
pub fn get_status(&self) -> &Option<JobStatus>
The status of the job, one of IN_PROGRESS
, CANCELED
, DELETION_IN_PROGRESS
or COMPLETED
.
Sourcepub fn force_canceled(self, input: bool) -> Self
pub fn force_canceled(self, input: bool) -> Self
Will be true
if the job was canceled with the optional force
parameter set to true
.
Sourcepub fn set_force_canceled(self, input: Option<bool>) -> Self
pub fn set_force_canceled(self, input: Option<bool>) -> Self
Will be true
if the job was canceled with the optional force
parameter set to true
.
Sourcepub fn get_force_canceled(&self) -> &Option<bool>
pub fn get_force_canceled(&self) -> &Option<bool>
Will be true
if the job was canceled with the optional force
parameter set to true
.
Sourcepub fn reason_code(self, input: impl Into<String>) -> Self
pub fn reason_code(self, input: impl Into<String>) -> Self
If the job was updated, provides the reason code for the update.
Sourcepub fn set_reason_code(self, input: Option<String>) -> Self
pub fn set_reason_code(self, input: Option<String>) -> Self
If the job was updated, provides the reason code for the update.
Sourcepub fn get_reason_code(&self) -> &Option<String>
pub fn get_reason_code(&self) -> &Option<String>
If the job was updated, provides the reason code for the update.
Sourcepub fn comment(self, input: impl Into<String>) -> Self
pub fn comment(self, input: impl Into<String>) -> Self
If the job was updated, describes the reason for the update.
Sourcepub fn set_comment(self, input: Option<String>) -> Self
pub fn set_comment(self, input: Option<String>) -> Self
If the job was updated, describes the reason for the update.
Sourcepub fn get_comment(&self) -> &Option<String>
pub fn get_comment(&self) -> &Option<String>
If the job was updated, describes the reason for the update.
Sourcepub fn targets(self, input: impl Into<String>) -> Self
pub fn targets(self, input: impl Into<String>) -> Self
Appends an item to targets
.
To override the contents of this collection use set_targets
.
A list of IoT things and thing groups to which the job should be sent.
Sourcepub fn set_targets(self, input: Option<Vec<String>>) -> Self
pub fn set_targets(self, input: Option<Vec<String>>) -> Self
A list of IoT things and thing groups to which the job should be sent.
Sourcepub fn get_targets(&self) -> &Option<Vec<String>>
pub fn get_targets(&self) -> &Option<Vec<String>>
A list of IoT things and thing groups to which the job should be sent.
Sourcepub fn description(self, input: impl Into<String>) -> Self
pub fn description(self, input: impl Into<String>) -> Self
A short text description of the job.
Sourcepub fn set_description(self, input: Option<String>) -> Self
pub fn set_description(self, input: Option<String>) -> Self
A short text description of the job.
Sourcepub fn get_description(&self) -> &Option<String>
pub fn get_description(&self) -> &Option<String>
A short text description of the job.
Sourcepub fn presigned_url_config(self, input: PresignedUrlConfig) -> Self
pub fn presigned_url_config(self, input: PresignedUrlConfig) -> Self
Configuration for pre-signed S3 URLs.
Sourcepub fn set_presigned_url_config(self, input: Option<PresignedUrlConfig>) -> Self
pub fn set_presigned_url_config(self, input: Option<PresignedUrlConfig>) -> Self
Configuration for pre-signed S3 URLs.
Sourcepub fn get_presigned_url_config(&self) -> &Option<PresignedUrlConfig>
pub fn get_presigned_url_config(&self) -> &Option<PresignedUrlConfig>
Configuration for pre-signed S3 URLs.
Sourcepub fn job_executions_rollout_config(
self,
input: JobExecutionsRolloutConfig,
) -> Self
pub fn job_executions_rollout_config( self, input: JobExecutionsRolloutConfig, ) -> Self
Allows you to create a staged rollout of a job.
Sourcepub fn set_job_executions_rollout_config(
self,
input: Option<JobExecutionsRolloutConfig>,
) -> Self
pub fn set_job_executions_rollout_config( self, input: Option<JobExecutionsRolloutConfig>, ) -> Self
Allows you to create a staged rollout of a job.
Sourcepub fn get_job_executions_rollout_config(
&self,
) -> &Option<JobExecutionsRolloutConfig>
pub fn get_job_executions_rollout_config( &self, ) -> &Option<JobExecutionsRolloutConfig>
Allows you to create a staged rollout of a job.
Sourcepub fn abort_config(self, input: AbortConfig) -> Self
pub fn abort_config(self, input: AbortConfig) -> Self
Configuration for criteria to abort the job.
Sourcepub fn set_abort_config(self, input: Option<AbortConfig>) -> Self
pub fn set_abort_config(self, input: Option<AbortConfig>) -> Self
Configuration for criteria to abort the job.
Sourcepub fn get_abort_config(&self) -> &Option<AbortConfig>
pub fn get_abort_config(&self) -> &Option<AbortConfig>
Configuration for criteria to abort the job.
Sourcepub fn created_at(self, input: DateTime) -> Self
pub fn created_at(self, input: DateTime) -> Self
The time, in seconds since the epoch, when the job was created.
Sourcepub fn set_created_at(self, input: Option<DateTime>) -> Self
pub fn set_created_at(self, input: Option<DateTime>) -> Self
The time, in seconds since the epoch, when the job was created.
Sourcepub fn get_created_at(&self) -> &Option<DateTime>
pub fn get_created_at(&self) -> &Option<DateTime>
The time, in seconds since the epoch, when the job was created.
Sourcepub fn last_updated_at(self, input: DateTime) -> Self
pub fn last_updated_at(self, input: DateTime) -> Self
The time, in seconds since the epoch, when the job was last updated.
Sourcepub fn set_last_updated_at(self, input: Option<DateTime>) -> Self
pub fn set_last_updated_at(self, input: Option<DateTime>) -> Self
The time, in seconds since the epoch, when the job was last updated.
Sourcepub fn get_last_updated_at(&self) -> &Option<DateTime>
pub fn get_last_updated_at(&self) -> &Option<DateTime>
The time, in seconds since the epoch, when the job was last updated.
Sourcepub fn completed_at(self, input: DateTime) -> Self
pub fn completed_at(self, input: DateTime) -> Self
The time, in seconds since the epoch, when the job was completed.
Sourcepub fn set_completed_at(self, input: Option<DateTime>) -> Self
pub fn set_completed_at(self, input: Option<DateTime>) -> Self
The time, in seconds since the epoch, when the job was completed.
Sourcepub fn get_completed_at(&self) -> &Option<DateTime>
pub fn get_completed_at(&self) -> &Option<DateTime>
The time, in seconds since the epoch, when the job was completed.
Sourcepub fn job_process_details(self, input: JobProcessDetails) -> Self
pub fn job_process_details(self, input: JobProcessDetails) -> Self
Details about the job process.
Sourcepub fn set_job_process_details(self, input: Option<JobProcessDetails>) -> Self
pub fn set_job_process_details(self, input: Option<JobProcessDetails>) -> Self
Details about the job process.
Sourcepub fn get_job_process_details(&self) -> &Option<JobProcessDetails>
pub fn get_job_process_details(&self) -> &Option<JobProcessDetails>
Details about the job process.
Sourcepub fn timeout_config(self, input: TimeoutConfig) -> Self
pub fn timeout_config(self, input: TimeoutConfig) -> Self
Specifies the amount of time each device has to finish its execution of the job. A timer is started when the job execution status is set to IN_PROGRESS
. If the job execution status is not set to another terminal state before the timer expires, it will be automatically set to TIMED_OUT
.
Sourcepub fn set_timeout_config(self, input: Option<TimeoutConfig>) -> Self
pub fn set_timeout_config(self, input: Option<TimeoutConfig>) -> Self
Specifies the amount of time each device has to finish its execution of the job. A timer is started when the job execution status is set to IN_PROGRESS
. If the job execution status is not set to another terminal state before the timer expires, it will be automatically set to TIMED_OUT
.
Sourcepub fn get_timeout_config(&self) -> &Option<TimeoutConfig>
pub fn get_timeout_config(&self) -> &Option<TimeoutConfig>
Specifies the amount of time each device has to finish its execution of the job. A timer is started when the job execution status is set to IN_PROGRESS
. If the job execution status is not set to another terminal state before the timer expires, it will be automatically set to TIMED_OUT
.
Sourcepub fn namespace_id(self, input: impl Into<String>) -> Self
pub fn namespace_id(self, input: impl Into<String>) -> Self
The namespace used to indicate that a job is a customer-managed job.
When you specify a value for this parameter, Amazon Web Services IoT Core sends jobs notifications to MQTT topics that contain the value in the following format.
$aws/things/THING_NAME/jobs/JOB_ID/notify-namespace-NAMESPACE_ID/
The namespaceId
feature is only supported by IoT Greengrass at this time. For more information, see Setting up IoT Greengrass core devices.
Sourcepub fn set_namespace_id(self, input: Option<String>) -> Self
pub fn set_namespace_id(self, input: Option<String>) -> Self
The namespace used to indicate that a job is a customer-managed job.
When you specify a value for this parameter, Amazon Web Services IoT Core sends jobs notifications to MQTT topics that contain the value in the following format.
$aws/things/THING_NAME/jobs/JOB_ID/notify-namespace-NAMESPACE_ID/
The namespaceId
feature is only supported by IoT Greengrass at this time. For more information, see Setting up IoT Greengrass core devices.
Sourcepub fn get_namespace_id(&self) -> &Option<String>
pub fn get_namespace_id(&self) -> &Option<String>
The namespace used to indicate that a job is a customer-managed job.
When you specify a value for this parameter, Amazon Web Services IoT Core sends jobs notifications to MQTT topics that contain the value in the following format.
$aws/things/THING_NAME/jobs/JOB_ID/notify-namespace-NAMESPACE_ID/
The namespaceId
feature is only supported by IoT Greengrass at this time. For more information, see Setting up IoT Greengrass core devices.
Sourcepub fn job_template_arn(self, input: impl Into<String>) -> Self
pub fn job_template_arn(self, input: impl Into<String>) -> Self
The ARN of the job template used to create the job.
Sourcepub fn set_job_template_arn(self, input: Option<String>) -> Self
pub fn set_job_template_arn(self, input: Option<String>) -> Self
The ARN of the job template used to create the job.
Sourcepub fn get_job_template_arn(&self) -> &Option<String>
pub fn get_job_template_arn(&self) -> &Option<String>
The ARN of the job template used to create the job.
Sourcepub fn job_executions_retry_config(
self,
input: JobExecutionsRetryConfig,
) -> Self
pub fn job_executions_retry_config( self, input: JobExecutionsRetryConfig, ) -> Self
The configuration for the criteria to retry the job.
Sourcepub fn set_job_executions_retry_config(
self,
input: Option<JobExecutionsRetryConfig>,
) -> Self
pub fn set_job_executions_retry_config( self, input: Option<JobExecutionsRetryConfig>, ) -> Self
The configuration for the criteria to retry the job.
Sourcepub fn get_job_executions_retry_config(
&self,
) -> &Option<JobExecutionsRetryConfig>
pub fn get_job_executions_retry_config( &self, ) -> &Option<JobExecutionsRetryConfig>
The configuration for the criteria to retry the job.
Sourcepub fn document_parameters(
self,
k: impl Into<String>,
v: impl Into<String>,
) -> Self
pub fn document_parameters( self, k: impl Into<String>, v: impl Into<String>, ) -> Self
Adds a key-value pair to document_parameters
.
To override the contents of this collection use set_document_parameters
.
A key-value map that pairs the patterns that need to be replaced in a managed template job document schema. You can use the description of each key as a guidance to specify the inputs during runtime when creating a job.
documentParameters
can only be used when creating jobs from Amazon Web Services managed templates. This parameter can't be used with custom job templates or to create jobs from them.
Sourcepub fn set_document_parameters(
self,
input: Option<HashMap<String, String>>,
) -> Self
pub fn set_document_parameters( self, input: Option<HashMap<String, String>>, ) -> Self
A key-value map that pairs the patterns that need to be replaced in a managed template job document schema. You can use the description of each key as a guidance to specify the inputs during runtime when creating a job.
documentParameters
can only be used when creating jobs from Amazon Web Services managed templates. This parameter can't be used with custom job templates or to create jobs from them.
Sourcepub fn get_document_parameters(&self) -> &Option<HashMap<String, String>>
pub fn get_document_parameters(&self) -> &Option<HashMap<String, String>>
A key-value map that pairs the patterns that need to be replaced in a managed template job document schema. You can use the description of each key as a guidance to specify the inputs during runtime when creating a job.
documentParameters
can only be used when creating jobs from Amazon Web Services managed templates. This parameter can't be used with custom job templates or to create jobs from them.
Sourcepub fn is_concurrent(self, input: bool) -> Self
pub fn is_concurrent(self, input: bool) -> Self
Indicates whether a job is concurrent. Will be true when a job is rolling out new job executions or canceling previously created executions, otherwise false.
Sourcepub fn set_is_concurrent(self, input: Option<bool>) -> Self
pub fn set_is_concurrent(self, input: Option<bool>) -> Self
Indicates whether a job is concurrent. Will be true when a job is rolling out new job executions or canceling previously created executions, otherwise false.
Sourcepub fn get_is_concurrent(&self) -> &Option<bool>
pub fn get_is_concurrent(&self) -> &Option<bool>
Indicates whether a job is concurrent. Will be true when a job is rolling out new job executions or canceling previously created executions, otherwise false.
Sourcepub fn scheduling_config(self, input: SchedulingConfig) -> Self
pub fn scheduling_config(self, input: SchedulingConfig) -> Self
The configuration that allows you to schedule a job for a future date and time in addition to specifying the end behavior for each job execution.
Sourcepub fn set_scheduling_config(self, input: Option<SchedulingConfig>) -> Self
pub fn set_scheduling_config(self, input: Option<SchedulingConfig>) -> Self
The configuration that allows you to schedule a job for a future date and time in addition to specifying the end behavior for each job execution.
Sourcepub fn get_scheduling_config(&self) -> &Option<SchedulingConfig>
pub fn get_scheduling_config(&self) -> &Option<SchedulingConfig>
The configuration that allows you to schedule a job for a future date and time in addition to specifying the end behavior for each job execution.
Sourcepub fn scheduled_job_rollouts(self, input: ScheduledJobRollout) -> Self
pub fn scheduled_job_rollouts(self, input: ScheduledJobRollout) -> Self
Appends an item to scheduled_job_rollouts
.
To override the contents of this collection use set_scheduled_job_rollouts
.
Displays the next seven maintenance window occurrences and their start times.
Sourcepub fn set_scheduled_job_rollouts(
self,
input: Option<Vec<ScheduledJobRollout>>,
) -> Self
pub fn set_scheduled_job_rollouts( self, input: Option<Vec<ScheduledJobRollout>>, ) -> Self
Displays the next seven maintenance window occurrences and their start times.
Sourcepub fn get_scheduled_job_rollouts(&self) -> &Option<Vec<ScheduledJobRollout>>
pub fn get_scheduled_job_rollouts(&self) -> &Option<Vec<ScheduledJobRollout>>
Displays the next seven maintenance window occurrences and their start times.
Sourcepub fn destination_package_versions(self, input: impl Into<String>) -> Self
pub fn destination_package_versions(self, input: impl Into<String>) -> Self
Appends an item to destination_package_versions
.
To override the contents of this collection use set_destination_package_versions
.
The package version Amazon Resource Names (ARNs) that are installed on the device when the job successfully completes. The package version must be in either the Published or Deprecated state when the job deploys. For more information, see Package version lifecycle.The package version must be in either the Published or Deprecated state when the job deploys. For more information, see Package version lifecycle.
Note:The following Length Constraints relates to a single ARN. Up to 25 package version ARNs are allowed.
Sourcepub fn set_destination_package_versions(
self,
input: Option<Vec<String>>,
) -> Self
pub fn set_destination_package_versions( self, input: Option<Vec<String>>, ) -> Self
The package version Amazon Resource Names (ARNs) that are installed on the device when the job successfully completes. The package version must be in either the Published or Deprecated state when the job deploys. For more information, see Package version lifecycle.The package version must be in either the Published or Deprecated state when the job deploys. For more information, see Package version lifecycle.
Note:The following Length Constraints relates to a single ARN. Up to 25 package version ARNs are allowed.
Sourcepub fn get_destination_package_versions(&self) -> &Option<Vec<String>>
pub fn get_destination_package_versions(&self) -> &Option<Vec<String>>
The package version Amazon Resource Names (ARNs) that are installed on the device when the job successfully completes. The package version must be in either the Published or Deprecated state when the job deploys. For more information, see Package version lifecycle.The package version must be in either the Published or Deprecated state when the job deploys. For more information, see Package version lifecycle.
Note:The following Length Constraints relates to a single ARN. Up to 25 package version ARNs are allowed.
Trait Implementations§
Source§impl Clone for JobBuilder
impl Clone for JobBuilder
Source§fn clone(&self) -> JobBuilder
fn clone(&self) -> JobBuilder
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Debug for JobBuilder
impl Debug for JobBuilder
Source§impl Default for JobBuilder
impl Default for JobBuilder
Source§fn default() -> JobBuilder
fn default() -> JobBuilder
Source§impl PartialEq for JobBuilder
impl PartialEq for JobBuilder
impl StructuralPartialEq for JobBuilder
Auto Trait Implementations§
impl Freeze for JobBuilder
impl RefUnwindSafe for JobBuilder
impl Send for JobBuilder
impl Sync for JobBuilder
impl Unpin for JobBuilder
impl UnwindSafe for JobBuilder
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);