#[non_exhaustive]pub struct AssociationDescriptionBuilder { /* private fields */ }
Expand description
A builder for AssociationDescription
.
Implementations§
Source§impl AssociationDescriptionBuilder
impl AssociationDescriptionBuilder
Sourcepub fn instance_id(self, input: impl Into<String>) -> Self
pub fn instance_id(self, input: impl Into<String>) -> Self
The managed node ID.
Sourcepub fn set_instance_id(self, input: Option<String>) -> Self
pub fn set_instance_id(self, input: Option<String>) -> Self
The managed node ID.
Sourcepub fn get_instance_id(&self) -> &Option<String>
pub fn get_instance_id(&self) -> &Option<String>
The managed node ID.
Sourcepub fn association_version(self, input: impl Into<String>) -> Self
pub fn association_version(self, input: impl Into<String>) -> Self
The association version.
Sourcepub fn set_association_version(self, input: Option<String>) -> Self
pub fn set_association_version(self, input: Option<String>) -> Self
The association version.
Sourcepub fn get_association_version(&self) -> &Option<String>
pub fn get_association_version(&self) -> &Option<String>
The association version.
Sourcepub fn last_update_association_date(self, input: DateTime) -> Self
pub fn last_update_association_date(self, input: DateTime) -> Self
The date when the association was last updated.
Sourcepub fn set_last_update_association_date(self, input: Option<DateTime>) -> Self
pub fn set_last_update_association_date(self, input: Option<DateTime>) -> Self
The date when the association was last updated.
Sourcepub fn get_last_update_association_date(&self) -> &Option<DateTime>
pub fn get_last_update_association_date(&self) -> &Option<DateTime>
The date when the association was last updated.
Sourcepub fn status(self, input: AssociationStatus) -> Self
pub fn status(self, input: AssociationStatus) -> Self
The association status.
Sourcepub fn set_status(self, input: Option<AssociationStatus>) -> Self
pub fn set_status(self, input: Option<AssociationStatus>) -> Self
The association status.
Sourcepub fn get_status(&self) -> &Option<AssociationStatus>
pub fn get_status(&self) -> &Option<AssociationStatus>
The association status.
Sourcepub fn overview(self, input: AssociationOverview) -> Self
pub fn overview(self, input: AssociationOverview) -> Self
Information about the association.
Sourcepub fn set_overview(self, input: Option<AssociationOverview>) -> Self
pub fn set_overview(self, input: Option<AssociationOverview>) -> Self
Information about the association.
Sourcepub fn get_overview(&self) -> &Option<AssociationOverview>
pub fn get_overview(&self) -> &Option<AssociationOverview>
Information about the association.
Sourcepub fn document_version(self, input: impl Into<String>) -> Self
pub fn document_version(self, input: impl Into<String>) -> Self
The document version.
Sourcepub fn set_document_version(self, input: Option<String>) -> Self
pub fn set_document_version(self, input: Option<String>) -> Self
The document version.
Sourcepub fn get_document_version(&self) -> &Option<String>
pub fn get_document_version(&self) -> &Option<String>
The document version.
Sourcepub fn automation_target_parameter_name(self, input: impl Into<String>) -> Self
pub fn automation_target_parameter_name(self, input: impl Into<String>) -> Self
Choose the parameter that will define how your automation will branch out. This target is required for associations that use an Automation runbook and target resources by using rate controls. Automation is a tool in Amazon Web Services Systems Manager.
Sourcepub fn set_automation_target_parameter_name(self, input: Option<String>) -> Self
pub fn set_automation_target_parameter_name(self, input: Option<String>) -> Self
Choose the parameter that will define how your automation will branch out. This target is required for associations that use an Automation runbook and target resources by using rate controls. Automation is a tool in Amazon Web Services Systems Manager.
Sourcepub fn get_automation_target_parameter_name(&self) -> &Option<String>
pub fn get_automation_target_parameter_name(&self) -> &Option<String>
Choose the parameter that will define how your automation will branch out. This target is required for associations that use an Automation runbook and target resources by using rate controls. Automation is a tool in Amazon Web Services Systems Manager.
Sourcepub fn parameters(self, k: impl Into<String>, v: Vec<String>) -> Self
pub fn parameters(self, k: impl Into<String>, v: Vec<String>) -> Self
Adds a key-value pair to parameters
.
To override the contents of this collection use set_parameters
.
A description of the parameters for a document.
Sourcepub fn set_parameters(self, input: Option<HashMap<String, Vec<String>>>) -> Self
pub fn set_parameters(self, input: Option<HashMap<String, Vec<String>>>) -> Self
A description of the parameters for a document.
Sourcepub fn get_parameters(&self) -> &Option<HashMap<String, Vec<String>>>
pub fn get_parameters(&self) -> &Option<HashMap<String, Vec<String>>>
A description of the parameters for a document.
Sourcepub fn association_id(self, input: impl Into<String>) -> Self
pub fn association_id(self, input: impl Into<String>) -> Self
The association ID.
Sourcepub fn set_association_id(self, input: Option<String>) -> Self
pub fn set_association_id(self, input: Option<String>) -> Self
The association ID.
Sourcepub fn get_association_id(&self) -> &Option<String>
pub fn get_association_id(&self) -> &Option<String>
The association ID.
Sourcepub fn targets(self, input: Target) -> Self
pub fn targets(self, input: Target) -> Self
Appends an item to targets
.
To override the contents of this collection use set_targets
.
The managed nodes targeted by the request.
Sourcepub fn set_targets(self, input: Option<Vec<Target>>) -> Self
pub fn set_targets(self, input: Option<Vec<Target>>) -> Self
The managed nodes targeted by the request.
Sourcepub fn get_targets(&self) -> &Option<Vec<Target>>
pub fn get_targets(&self) -> &Option<Vec<Target>>
The managed nodes targeted by the request.
Sourcepub fn schedule_expression(self, input: impl Into<String>) -> Self
pub fn schedule_expression(self, input: impl Into<String>) -> Self
A cron expression that specifies a schedule when the association runs.
Sourcepub fn set_schedule_expression(self, input: Option<String>) -> Self
pub fn set_schedule_expression(self, input: Option<String>) -> Self
A cron expression that specifies a schedule when the association runs.
Sourcepub fn get_schedule_expression(&self) -> &Option<String>
pub fn get_schedule_expression(&self) -> &Option<String>
A cron expression that specifies a schedule when the association runs.
Sourcepub fn output_location(self, input: InstanceAssociationOutputLocation) -> Self
pub fn output_location(self, input: InstanceAssociationOutputLocation) -> Self
An S3 bucket where you want to store the output details of the request.
Sourcepub fn set_output_location(
self,
input: Option<InstanceAssociationOutputLocation>,
) -> Self
pub fn set_output_location( self, input: Option<InstanceAssociationOutputLocation>, ) -> Self
An S3 bucket where you want to store the output details of the request.
Sourcepub fn get_output_location(&self) -> &Option<InstanceAssociationOutputLocation>
pub fn get_output_location(&self) -> &Option<InstanceAssociationOutputLocation>
An S3 bucket where you want to store the output details of the request.
Sourcepub fn last_execution_date(self, input: DateTime) -> Self
pub fn last_execution_date(self, input: DateTime) -> Self
The date on which the association was last run.
Sourcepub fn set_last_execution_date(self, input: Option<DateTime>) -> Self
pub fn set_last_execution_date(self, input: Option<DateTime>) -> Self
The date on which the association was last run.
Sourcepub fn get_last_execution_date(&self) -> &Option<DateTime>
pub fn get_last_execution_date(&self) -> &Option<DateTime>
The date on which the association was last run.
Sourcepub fn last_successful_execution_date(self, input: DateTime) -> Self
pub fn last_successful_execution_date(self, input: DateTime) -> Self
The last date on which the association was successfully run.
Sourcepub fn set_last_successful_execution_date(self, input: Option<DateTime>) -> Self
pub fn set_last_successful_execution_date(self, input: Option<DateTime>) -> Self
The last date on which the association was successfully run.
Sourcepub fn get_last_successful_execution_date(&self) -> &Option<DateTime>
pub fn get_last_successful_execution_date(&self) -> &Option<DateTime>
The last date on which the association was successfully run.
Sourcepub fn association_name(self, input: impl Into<String>) -> Self
pub fn association_name(self, input: impl Into<String>) -> Self
The association name.
Sourcepub fn set_association_name(self, input: Option<String>) -> Self
pub fn set_association_name(self, input: Option<String>) -> Self
The association name.
Sourcepub fn get_association_name(&self) -> &Option<String>
pub fn get_association_name(&self) -> &Option<String>
The association name.
Sourcepub fn max_errors(self, input: impl Into<String>) -> Self
pub fn max_errors(self, input: impl Into<String>) -> Self
The number of errors that are allowed before the system stops sending requests to run the association on additional targets. You can specify either an absolute number of errors, for example 10, or a percentage of the target set, for example 10%. If you specify 3, for example, the system stops sending requests when the fourth error is received. If you specify 0, then the system stops sending requests after the first error is returned. If you run an association on 50 managed nodes and set MaxError
to 10%, then the system stops sending the request when the sixth error is received.
Executions that are already running an association when MaxErrors
is reached are allowed to complete, but some of these executions may fail as well. If you need to ensure that there won't be more than max-errors failed executions, set MaxConcurrency
to 1 so that executions proceed one at a time.
Sourcepub fn set_max_errors(self, input: Option<String>) -> Self
pub fn set_max_errors(self, input: Option<String>) -> Self
The number of errors that are allowed before the system stops sending requests to run the association on additional targets. You can specify either an absolute number of errors, for example 10, or a percentage of the target set, for example 10%. If you specify 3, for example, the system stops sending requests when the fourth error is received. If you specify 0, then the system stops sending requests after the first error is returned. If you run an association on 50 managed nodes and set MaxError
to 10%, then the system stops sending the request when the sixth error is received.
Executions that are already running an association when MaxErrors
is reached are allowed to complete, but some of these executions may fail as well. If you need to ensure that there won't be more than max-errors failed executions, set MaxConcurrency
to 1 so that executions proceed one at a time.
Sourcepub fn get_max_errors(&self) -> &Option<String>
pub fn get_max_errors(&self) -> &Option<String>
The number of errors that are allowed before the system stops sending requests to run the association on additional targets. You can specify either an absolute number of errors, for example 10, or a percentage of the target set, for example 10%. If you specify 3, for example, the system stops sending requests when the fourth error is received. If you specify 0, then the system stops sending requests after the first error is returned. If you run an association on 50 managed nodes and set MaxError
to 10%, then the system stops sending the request when the sixth error is received.
Executions that are already running an association when MaxErrors
is reached are allowed to complete, but some of these executions may fail as well. If you need to ensure that there won't be more than max-errors failed executions, set MaxConcurrency
to 1 so that executions proceed one at a time.
Sourcepub fn max_concurrency(self, input: impl Into<String>) -> Self
pub fn max_concurrency(self, input: impl Into<String>) -> Self
The maximum number of targets allowed to run the association at the same time. You can specify a number, for example 10, or a percentage of the target set, for example 10%. The default value is 100%, which means all targets run the association at the same time.
If a new managed node starts and attempts to run an association while Systems Manager is running MaxConcurrency
associations, the association is allowed to run. During the next association interval, the new managed node will process its association within the limit specified for MaxConcurrency
.
Sourcepub fn set_max_concurrency(self, input: Option<String>) -> Self
pub fn set_max_concurrency(self, input: Option<String>) -> Self
The maximum number of targets allowed to run the association at the same time. You can specify a number, for example 10, or a percentage of the target set, for example 10%. The default value is 100%, which means all targets run the association at the same time.
If a new managed node starts and attempts to run an association while Systems Manager is running MaxConcurrency
associations, the association is allowed to run. During the next association interval, the new managed node will process its association within the limit specified for MaxConcurrency
.
Sourcepub fn get_max_concurrency(&self) -> &Option<String>
pub fn get_max_concurrency(&self) -> &Option<String>
The maximum number of targets allowed to run the association at the same time. You can specify a number, for example 10, or a percentage of the target set, for example 10%. The default value is 100%, which means all targets run the association at the same time.
If a new managed node starts and attempts to run an association while Systems Manager is running MaxConcurrency
associations, the association is allowed to run. During the next association interval, the new managed node will process its association within the limit specified for MaxConcurrency
.
Sourcepub fn compliance_severity(self, input: AssociationComplianceSeverity) -> Self
pub fn compliance_severity(self, input: AssociationComplianceSeverity) -> Self
The severity level that is assigned to the association.
Sourcepub fn set_compliance_severity(
self,
input: Option<AssociationComplianceSeverity>,
) -> Self
pub fn set_compliance_severity( self, input: Option<AssociationComplianceSeverity>, ) -> Self
The severity level that is assigned to the association.
Sourcepub fn get_compliance_severity(&self) -> &Option<AssociationComplianceSeverity>
pub fn get_compliance_severity(&self) -> &Option<AssociationComplianceSeverity>
The severity level that is assigned to the association.
Sourcepub fn sync_compliance(self, input: AssociationSyncCompliance) -> Self
pub fn sync_compliance(self, input: AssociationSyncCompliance) -> Self
The mode for generating association compliance. You can specify AUTO
or MANUAL
. In AUTO
mode, the system uses the status of the association execution to determine the compliance status. If the association execution runs successfully, then the association is COMPLIANT
. If the association execution doesn't run successfully, the association is NON-COMPLIANT
.
In MANUAL
mode, you must specify the AssociationId
as a parameter for the PutComplianceItems
API operation. In this case, compliance data isn't managed by State Manager, a tool in Amazon Web Services Systems Manager. It is managed by your direct call to the PutComplianceItems
API operation.
By default, all associations use AUTO
mode.
Sourcepub fn set_sync_compliance(
self,
input: Option<AssociationSyncCompliance>,
) -> Self
pub fn set_sync_compliance( self, input: Option<AssociationSyncCompliance>, ) -> Self
The mode for generating association compliance. You can specify AUTO
or MANUAL
. In AUTO
mode, the system uses the status of the association execution to determine the compliance status. If the association execution runs successfully, then the association is COMPLIANT
. If the association execution doesn't run successfully, the association is NON-COMPLIANT
.
In MANUAL
mode, you must specify the AssociationId
as a parameter for the PutComplianceItems
API operation. In this case, compliance data isn't managed by State Manager, a tool in Amazon Web Services Systems Manager. It is managed by your direct call to the PutComplianceItems
API operation.
By default, all associations use AUTO
mode.
Sourcepub fn get_sync_compliance(&self) -> &Option<AssociationSyncCompliance>
pub fn get_sync_compliance(&self) -> &Option<AssociationSyncCompliance>
The mode for generating association compliance. You can specify AUTO
or MANUAL
. In AUTO
mode, the system uses the status of the association execution to determine the compliance status. If the association execution runs successfully, then the association is COMPLIANT
. If the association execution doesn't run successfully, the association is NON-COMPLIANT
.
In MANUAL
mode, you must specify the AssociationId
as a parameter for the PutComplianceItems
API operation. In this case, compliance data isn't managed by State Manager, a tool in Amazon Web Services Systems Manager. It is managed by your direct call to the PutComplianceItems
API operation.
By default, all associations use AUTO
mode.
Sourcepub fn apply_only_at_cron_interval(self, input: bool) -> Self
pub fn apply_only_at_cron_interval(self, input: bool) -> Self
By default, when you create a new associations, the system runs it immediately after it is created and then according to the schedule you specified. Specify this option if you don't want an association to run immediately after you create it. This parameter isn't supported for rate expressions.
Sourcepub fn set_apply_only_at_cron_interval(self, input: Option<bool>) -> Self
pub fn set_apply_only_at_cron_interval(self, input: Option<bool>) -> Self
By default, when you create a new associations, the system runs it immediately after it is created and then according to the schedule you specified. Specify this option if you don't want an association to run immediately after you create it. This parameter isn't supported for rate expressions.
Sourcepub fn get_apply_only_at_cron_interval(&self) -> &Option<bool>
pub fn get_apply_only_at_cron_interval(&self) -> &Option<bool>
By default, when you create a new associations, the system runs it immediately after it is created and then according to the schedule you specified. Specify this option if you don't want an association to run immediately after you create it. This parameter isn't supported for rate expressions.
Sourcepub fn calendar_names(self, input: impl Into<String>) -> Self
pub fn calendar_names(self, input: impl Into<String>) -> Self
Appends an item to calendar_names
.
To override the contents of this collection use set_calendar_names
.
The names or Amazon Resource Names (ARNs) of the Change Calendar type documents your associations are gated under. The associations only run when that change calendar is open. For more information, see Amazon Web Services Systems Manager Change Calendar in the Amazon Web Services Systems Manager User Guide.
Sourcepub fn set_calendar_names(self, input: Option<Vec<String>>) -> Self
pub fn set_calendar_names(self, input: Option<Vec<String>>) -> Self
The names or Amazon Resource Names (ARNs) of the Change Calendar type documents your associations are gated under. The associations only run when that change calendar is open. For more information, see Amazon Web Services Systems Manager Change Calendar in the Amazon Web Services Systems Manager User Guide.
Sourcepub fn get_calendar_names(&self) -> &Option<Vec<String>>
pub fn get_calendar_names(&self) -> &Option<Vec<String>>
The names or Amazon Resource Names (ARNs) of the Change Calendar type documents your associations are gated under. The associations only run when that change calendar is open. For more information, see Amazon Web Services Systems Manager Change Calendar in the Amazon Web Services Systems Manager User Guide.
Sourcepub fn target_locations(self, input: TargetLocation) -> Self
pub fn target_locations(self, input: TargetLocation) -> Self
Appends an item to target_locations
.
To override the contents of this collection use set_target_locations
.
The combination of Amazon Web Services Regions and Amazon Web Services accounts where you want to run the association.
Sourcepub fn set_target_locations(self, input: Option<Vec<TargetLocation>>) -> Self
pub fn set_target_locations(self, input: Option<Vec<TargetLocation>>) -> Self
The combination of Amazon Web Services Regions and Amazon Web Services accounts where you want to run the association.
Sourcepub fn get_target_locations(&self) -> &Option<Vec<TargetLocation>>
pub fn get_target_locations(&self) -> &Option<Vec<TargetLocation>>
The combination of Amazon Web Services Regions and Amazon Web Services accounts where you want to run the association.
Sourcepub fn schedule_offset(self, input: i32) -> Self
pub fn schedule_offset(self, input: i32) -> Self
Number of days to wait after the scheduled day to run an association.
Sourcepub fn set_schedule_offset(self, input: Option<i32>) -> Self
pub fn set_schedule_offset(self, input: Option<i32>) -> Self
Number of days to wait after the scheduled day to run an association.
Sourcepub fn get_schedule_offset(&self) -> &Option<i32>
pub fn get_schedule_offset(&self) -> &Option<i32>
Number of days to wait after the scheduled day to run an association.
Sourcepub fn duration(self, input: i32) -> Self
pub fn duration(self, input: i32) -> Self
The number of hours that an association can run on specified targets. After the resulting cutoff time passes, associations that are currently running are cancelled, and no pending executions are started on remaining targets.
Sourcepub fn set_duration(self, input: Option<i32>) -> Self
pub fn set_duration(self, input: Option<i32>) -> Self
The number of hours that an association can run on specified targets. After the resulting cutoff time passes, associations that are currently running are cancelled, and no pending executions are started on remaining targets.
Sourcepub fn get_duration(&self) -> &Option<i32>
pub fn get_duration(&self) -> &Option<i32>
The number of hours that an association can run on specified targets. After the resulting cutoff time passes, associations that are currently running are cancelled, and no pending executions are started on remaining targets.
Sourcepub fn target_maps(self, input: HashMap<String, Vec<String>>) -> Self
pub fn target_maps(self, input: HashMap<String, Vec<String>>) -> Self
Appends an item to target_maps
.
To override the contents of this collection use set_target_maps
.
A key-value mapping of document parameters to target resources. Both Targets and TargetMaps can't be specified together.
Sourcepub fn set_target_maps(
self,
input: Option<Vec<HashMap<String, Vec<String>>>>,
) -> Self
pub fn set_target_maps( self, input: Option<Vec<HashMap<String, Vec<String>>>>, ) -> Self
A key-value mapping of document parameters to target resources. Both Targets and TargetMaps can't be specified together.
Sourcepub fn get_target_maps(&self) -> &Option<Vec<HashMap<String, Vec<String>>>>
pub fn get_target_maps(&self) -> &Option<Vec<HashMap<String, Vec<String>>>>
A key-value mapping of document parameters to target resources. Both Targets and TargetMaps can't be specified together.
Sourcepub fn alarm_configuration(self, input: AlarmConfiguration) -> Self
pub fn alarm_configuration(self, input: AlarmConfiguration) -> Self
The details for the CloudWatch alarm you want to apply to an automation or command.
Sourcepub fn set_alarm_configuration(self, input: Option<AlarmConfiguration>) -> Self
pub fn set_alarm_configuration(self, input: Option<AlarmConfiguration>) -> Self
The details for the CloudWatch alarm you want to apply to an automation or command.
Sourcepub fn get_alarm_configuration(&self) -> &Option<AlarmConfiguration>
pub fn get_alarm_configuration(&self) -> &Option<AlarmConfiguration>
The details for the CloudWatch alarm you want to apply to an automation or command.
Sourcepub fn triggered_alarms(self, input: AlarmStateInformation) -> Self
pub fn triggered_alarms(self, input: AlarmStateInformation) -> Self
Appends an item to triggered_alarms
.
To override the contents of this collection use set_triggered_alarms
.
The CloudWatch alarm that was invoked during the association.
Sourcepub fn set_triggered_alarms(
self,
input: Option<Vec<AlarmStateInformation>>,
) -> Self
pub fn set_triggered_alarms( self, input: Option<Vec<AlarmStateInformation>>, ) -> Self
The CloudWatch alarm that was invoked during the association.
Sourcepub fn get_triggered_alarms(&self) -> &Option<Vec<AlarmStateInformation>>
pub fn get_triggered_alarms(&self) -> &Option<Vec<AlarmStateInformation>>
The CloudWatch alarm that was invoked during the association.
Sourcepub fn build(self) -> AssociationDescription
pub fn build(self) -> AssociationDescription
Consumes the builder and constructs a AssociationDescription
.
Trait Implementations§
Source§impl Clone for AssociationDescriptionBuilder
impl Clone for AssociationDescriptionBuilder
Source§fn clone(&self) -> AssociationDescriptionBuilder
fn clone(&self) -> AssociationDescriptionBuilder
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Default for AssociationDescriptionBuilder
impl Default for AssociationDescriptionBuilder
Source§fn default() -> AssociationDescriptionBuilder
fn default() -> AssociationDescriptionBuilder
Source§impl PartialEq for AssociationDescriptionBuilder
impl PartialEq for AssociationDescriptionBuilder
Source§fn eq(&self, other: &AssociationDescriptionBuilder) -> bool
fn eq(&self, other: &AssociationDescriptionBuilder) -> bool
self
and other
values to be equal, and is used by ==
.impl StructuralPartialEq for AssociationDescriptionBuilder
Auto Trait Implementations§
impl Freeze for AssociationDescriptionBuilder
impl RefUnwindSafe for AssociationDescriptionBuilder
impl Send for AssociationDescriptionBuilder
impl Sync for AssociationDescriptionBuilder
impl Unpin for AssociationDescriptionBuilder
impl UnwindSafe for AssociationDescriptionBuilder
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);