#[non_exhaustive]pub struct DescribeTrainingJobOutputBuilder { /* private fields */ }
Expand description
A builder for DescribeTrainingJobOutput
.
Implementations§
Source§impl DescribeTrainingJobOutputBuilder
impl DescribeTrainingJobOutputBuilder
Sourcepub fn training_job_name(self, input: impl Into<String>) -> Self
pub fn training_job_name(self, input: impl Into<String>) -> Self
Name of the model training job.
This field is required.Sourcepub fn set_training_job_name(self, input: Option<String>) -> Self
pub fn set_training_job_name(self, input: Option<String>) -> Self
Name of the model training job.
Sourcepub fn get_training_job_name(&self) -> &Option<String>
pub fn get_training_job_name(&self) -> &Option<String>
Name of the model training job.
Sourcepub fn training_job_arn(self, input: impl Into<String>) -> Self
pub fn training_job_arn(self, input: impl Into<String>) -> Self
The Amazon Resource Name (ARN) of the training job.
This field is required.Sourcepub fn set_training_job_arn(self, input: Option<String>) -> Self
pub fn set_training_job_arn(self, input: Option<String>) -> Self
The Amazon Resource Name (ARN) of the training job.
Sourcepub fn get_training_job_arn(&self) -> &Option<String>
pub fn get_training_job_arn(&self) -> &Option<String>
The Amazon Resource Name (ARN) of the training job.
Sourcepub fn tuning_job_arn(self, input: impl Into<String>) -> Self
pub fn tuning_job_arn(self, input: impl Into<String>) -> Self
The Amazon Resource Name (ARN) of the associated hyperparameter tuning job if the training job was launched by a hyperparameter tuning job.
Sourcepub fn set_tuning_job_arn(self, input: Option<String>) -> Self
pub fn set_tuning_job_arn(self, input: Option<String>) -> Self
The Amazon Resource Name (ARN) of the associated hyperparameter tuning job if the training job was launched by a hyperparameter tuning job.
Sourcepub fn get_tuning_job_arn(&self) -> &Option<String>
pub fn get_tuning_job_arn(&self) -> &Option<String>
The Amazon Resource Name (ARN) of the associated hyperparameter tuning job if the training job was launched by a hyperparameter tuning job.
Sourcepub fn labeling_job_arn(self, input: impl Into<String>) -> Self
pub fn labeling_job_arn(self, input: impl Into<String>) -> Self
The Amazon Resource Name (ARN) of the SageMaker Ground Truth labeling job that created the transform or training job.
Sourcepub fn set_labeling_job_arn(self, input: Option<String>) -> Self
pub fn set_labeling_job_arn(self, input: Option<String>) -> Self
The Amazon Resource Name (ARN) of the SageMaker Ground Truth labeling job that created the transform or training job.
Sourcepub fn get_labeling_job_arn(&self) -> &Option<String>
pub fn get_labeling_job_arn(&self) -> &Option<String>
The Amazon Resource Name (ARN) of the SageMaker Ground Truth labeling job that created the transform or training job.
Sourcepub fn auto_ml_job_arn(self, input: impl Into<String>) -> Self
pub fn auto_ml_job_arn(self, input: impl Into<String>) -> Self
The Amazon Resource Name (ARN) of an AutoML job.
Sourcepub fn set_auto_ml_job_arn(self, input: Option<String>) -> Self
pub fn set_auto_ml_job_arn(self, input: Option<String>) -> Self
The Amazon Resource Name (ARN) of an AutoML job.
Sourcepub fn get_auto_ml_job_arn(&self) -> &Option<String>
pub fn get_auto_ml_job_arn(&self) -> &Option<String>
The Amazon Resource Name (ARN) of an AutoML job.
Sourcepub fn model_artifacts(self, input: ModelArtifacts) -> Self
pub fn model_artifacts(self, input: ModelArtifacts) -> Self
Information about the Amazon S3 location that is configured for storing model artifacts.
This field is required.Sourcepub fn set_model_artifacts(self, input: Option<ModelArtifacts>) -> Self
pub fn set_model_artifacts(self, input: Option<ModelArtifacts>) -> Self
Information about the Amazon S3 location that is configured for storing model artifacts.
Sourcepub fn get_model_artifacts(&self) -> &Option<ModelArtifacts>
pub fn get_model_artifacts(&self) -> &Option<ModelArtifacts>
Information about the Amazon S3 location that is configured for storing model artifacts.
Sourcepub fn training_job_status(self, input: TrainingJobStatus) -> Self
pub fn training_job_status(self, input: TrainingJobStatus) -> Self
The status of the training job.
SageMaker provides the following training job statuses:
-
InProgress
- The training is in progress. -
Completed
- The training job has completed. -
Failed
- The training job has failed. To see the reason for the failure, see theFailureReason
field in the response to aDescribeTrainingJobResponse
call. -
Stopping
- The training job is stopping. -
Stopped
- The training job has stopped.
For more detailed information, see SecondaryStatus
.
Sourcepub fn set_training_job_status(self, input: Option<TrainingJobStatus>) -> Self
pub fn set_training_job_status(self, input: Option<TrainingJobStatus>) -> Self
The status of the training job.
SageMaker provides the following training job statuses:
-
InProgress
- The training is in progress. -
Completed
- The training job has completed. -
Failed
- The training job has failed. To see the reason for the failure, see theFailureReason
field in the response to aDescribeTrainingJobResponse
call. -
Stopping
- The training job is stopping. -
Stopped
- The training job has stopped.
For more detailed information, see SecondaryStatus
.
Sourcepub fn get_training_job_status(&self) -> &Option<TrainingJobStatus>
pub fn get_training_job_status(&self) -> &Option<TrainingJobStatus>
The status of the training job.
SageMaker provides the following training job statuses:
-
InProgress
- The training is in progress. -
Completed
- The training job has completed. -
Failed
- The training job has failed. To see the reason for the failure, see theFailureReason
field in the response to aDescribeTrainingJobResponse
call. -
Stopping
- The training job is stopping. -
Stopped
- The training job has stopped.
For more detailed information, see SecondaryStatus
.
Sourcepub fn secondary_status(self, input: SecondaryStatus) -> Self
pub fn secondary_status(self, input: SecondaryStatus) -> Self
Provides detailed information about the state of the training job. For detailed information on the secondary status of the training job, see StatusMessage
under SecondaryStatusTransition.
SageMaker provides primary statuses and secondary statuses that apply to each of them:
- InProgress
-
-
Starting
- Starting the training job. -
Downloading
- An optional stage for algorithms that supportFile
training input mode. It indicates that data is being downloaded to the ML storage volumes. -
Training
- Training is in progress. -
Interrupted
- The job stopped because the managed spot training instances were interrupted. -
Uploading
- Training is complete and the model artifacts are being uploaded to the S3 location.
-
- Completed
-
-
Completed
- The training job has completed.
-
- Failed
-
-
Failed
- The training job has failed. The reason for the failure is returned in theFailureReason
field ofDescribeTrainingJobResponse
.
-
- Stopped
-
-
MaxRuntimeExceeded
- The job stopped because it exceeded the maximum allowed runtime. -
MaxWaitTimeExceeded
- The job stopped because it exceeded the maximum allowed wait time. -
Stopped
- The training job has stopped.
-
- Stopping
-
-
Stopping
- Stopping the training job.
-
Valid values for SecondaryStatus
are subject to change.
We no longer support the following secondary statuses:
-
LaunchingMLInstances
-
PreparingTraining
-
DownloadingTrainingImage
Sourcepub fn set_secondary_status(self, input: Option<SecondaryStatus>) -> Self
pub fn set_secondary_status(self, input: Option<SecondaryStatus>) -> Self
Provides detailed information about the state of the training job. For detailed information on the secondary status of the training job, see StatusMessage
under SecondaryStatusTransition.
SageMaker provides primary statuses and secondary statuses that apply to each of them:
- InProgress
-
-
Starting
- Starting the training job. -
Downloading
- An optional stage for algorithms that supportFile
training input mode. It indicates that data is being downloaded to the ML storage volumes. -
Training
- Training is in progress. -
Interrupted
- The job stopped because the managed spot training instances were interrupted. -
Uploading
- Training is complete and the model artifacts are being uploaded to the S3 location.
-
- Completed
-
-
Completed
- The training job has completed.
-
- Failed
-
-
Failed
- The training job has failed. The reason for the failure is returned in theFailureReason
field ofDescribeTrainingJobResponse
.
-
- Stopped
-
-
MaxRuntimeExceeded
- The job stopped because it exceeded the maximum allowed runtime. -
MaxWaitTimeExceeded
- The job stopped because it exceeded the maximum allowed wait time. -
Stopped
- The training job has stopped.
-
- Stopping
-
-
Stopping
- Stopping the training job.
-
Valid values for SecondaryStatus
are subject to change.
We no longer support the following secondary statuses:
-
LaunchingMLInstances
-
PreparingTraining
-
DownloadingTrainingImage
Sourcepub fn get_secondary_status(&self) -> &Option<SecondaryStatus>
pub fn get_secondary_status(&self) -> &Option<SecondaryStatus>
Provides detailed information about the state of the training job. For detailed information on the secondary status of the training job, see StatusMessage
under SecondaryStatusTransition.
SageMaker provides primary statuses and secondary statuses that apply to each of them:
- InProgress
-
-
Starting
- Starting the training job. -
Downloading
- An optional stage for algorithms that supportFile
training input mode. It indicates that data is being downloaded to the ML storage volumes. -
Training
- Training is in progress. -
Interrupted
- The job stopped because the managed spot training instances were interrupted. -
Uploading
- Training is complete and the model artifacts are being uploaded to the S3 location.
-
- Completed
-
-
Completed
- The training job has completed.
-
- Failed
-
-
Failed
- The training job has failed. The reason for the failure is returned in theFailureReason
field ofDescribeTrainingJobResponse
.
-
- Stopped
-
-
MaxRuntimeExceeded
- The job stopped because it exceeded the maximum allowed runtime. -
MaxWaitTimeExceeded
- The job stopped because it exceeded the maximum allowed wait time. -
Stopped
- The training job has stopped.
-
- Stopping
-
-
Stopping
- Stopping the training job.
-
Valid values for SecondaryStatus
are subject to change.
We no longer support the following secondary statuses:
-
LaunchingMLInstances
-
PreparingTraining
-
DownloadingTrainingImage
Sourcepub fn failure_reason(self, input: impl Into<String>) -> Self
pub fn failure_reason(self, input: impl Into<String>) -> Self
If the training job failed, the reason it failed.
Sourcepub fn set_failure_reason(self, input: Option<String>) -> Self
pub fn set_failure_reason(self, input: Option<String>) -> Self
If the training job failed, the reason it failed.
Sourcepub fn get_failure_reason(&self) -> &Option<String>
pub fn get_failure_reason(&self) -> &Option<String>
If the training job failed, the reason it failed.
Sourcepub fn hyper_parameters(
self,
k: impl Into<String>,
v: impl Into<String>,
) -> Self
pub fn hyper_parameters( self, k: impl Into<String>, v: impl Into<String>, ) -> Self
Adds a key-value pair to hyper_parameters
.
To override the contents of this collection use set_hyper_parameters
.
Algorithm-specific parameters.
Sourcepub fn set_hyper_parameters(
self,
input: Option<HashMap<String, String>>,
) -> Self
pub fn set_hyper_parameters( self, input: Option<HashMap<String, String>>, ) -> Self
Algorithm-specific parameters.
Sourcepub fn get_hyper_parameters(&self) -> &Option<HashMap<String, String>>
pub fn get_hyper_parameters(&self) -> &Option<HashMap<String, String>>
Algorithm-specific parameters.
Sourcepub fn algorithm_specification(self, input: AlgorithmSpecification) -> Self
pub fn algorithm_specification(self, input: AlgorithmSpecification) -> Self
Information about the algorithm used for training, and algorithm metadata.
This field is required.Sourcepub fn set_algorithm_specification(
self,
input: Option<AlgorithmSpecification>,
) -> Self
pub fn set_algorithm_specification( self, input: Option<AlgorithmSpecification>, ) -> Self
Information about the algorithm used for training, and algorithm metadata.
Sourcepub fn get_algorithm_specification(&self) -> &Option<AlgorithmSpecification>
pub fn get_algorithm_specification(&self) -> &Option<AlgorithmSpecification>
Information about the algorithm used for training, and algorithm metadata.
Sourcepub fn role_arn(self, input: impl Into<String>) -> Self
pub fn role_arn(self, input: impl Into<String>) -> Self
The Amazon Web Services Identity and Access Management (IAM) role configured for the training job.
Sourcepub fn set_role_arn(self, input: Option<String>) -> Self
pub fn set_role_arn(self, input: Option<String>) -> Self
The Amazon Web Services Identity and Access Management (IAM) role configured for the training job.
Sourcepub fn get_role_arn(&self) -> &Option<String>
pub fn get_role_arn(&self) -> &Option<String>
The Amazon Web Services Identity and Access Management (IAM) role configured for the training job.
Sourcepub fn input_data_config(self, input: Channel) -> Self
pub fn input_data_config(self, input: Channel) -> Self
Appends an item to input_data_config
.
To override the contents of this collection use set_input_data_config
.
An array of Channel
objects that describes each data input channel.
Sourcepub fn set_input_data_config(self, input: Option<Vec<Channel>>) -> Self
pub fn set_input_data_config(self, input: Option<Vec<Channel>>) -> Self
An array of Channel
objects that describes each data input channel.
Sourcepub fn get_input_data_config(&self) -> &Option<Vec<Channel>>
pub fn get_input_data_config(&self) -> &Option<Vec<Channel>>
An array of Channel
objects that describes each data input channel.
Sourcepub fn output_data_config(self, input: OutputDataConfig) -> Self
pub fn output_data_config(self, input: OutputDataConfig) -> Self
The S3 path where model artifacts that you configured when creating the job are stored. SageMaker creates subfolders for model artifacts.
Sourcepub fn set_output_data_config(self, input: Option<OutputDataConfig>) -> Self
pub fn set_output_data_config(self, input: Option<OutputDataConfig>) -> Self
The S3 path where model artifacts that you configured when creating the job are stored. SageMaker creates subfolders for model artifacts.
Sourcepub fn get_output_data_config(&self) -> &Option<OutputDataConfig>
pub fn get_output_data_config(&self) -> &Option<OutputDataConfig>
The S3 path where model artifacts that you configured when creating the job are stored. SageMaker creates subfolders for model artifacts.
Sourcepub fn resource_config(self, input: ResourceConfig) -> Self
pub fn resource_config(self, input: ResourceConfig) -> Self
Resources, including ML compute instances and ML storage volumes, that are configured for model training.
This field is required.Sourcepub fn set_resource_config(self, input: Option<ResourceConfig>) -> Self
pub fn set_resource_config(self, input: Option<ResourceConfig>) -> Self
Resources, including ML compute instances and ML storage volumes, that are configured for model training.
Sourcepub fn get_resource_config(&self) -> &Option<ResourceConfig>
pub fn get_resource_config(&self) -> &Option<ResourceConfig>
Resources, including ML compute instances and ML storage volumes, that are configured for model training.
Sourcepub fn warm_pool_status(self, input: WarmPoolStatus) -> Self
pub fn warm_pool_status(self, input: WarmPoolStatus) -> Self
The status of the warm pool associated with the training job.
Sourcepub fn set_warm_pool_status(self, input: Option<WarmPoolStatus>) -> Self
pub fn set_warm_pool_status(self, input: Option<WarmPoolStatus>) -> Self
The status of the warm pool associated with the training job.
Sourcepub fn get_warm_pool_status(&self) -> &Option<WarmPoolStatus>
pub fn get_warm_pool_status(&self) -> &Option<WarmPoolStatus>
The status of the warm pool associated with the training job.
Sourcepub fn vpc_config(self, input: VpcConfig) -> Self
pub fn vpc_config(self, input: VpcConfig) -> Self
A VpcConfig object that specifies the VPC that this training job has access to. For more information, see Protect Training Jobs by Using an Amazon Virtual Private Cloud.
Sourcepub fn set_vpc_config(self, input: Option<VpcConfig>) -> Self
pub fn set_vpc_config(self, input: Option<VpcConfig>) -> Self
A VpcConfig object that specifies the VPC that this training job has access to. For more information, see Protect Training Jobs by Using an Amazon Virtual Private Cloud.
Sourcepub fn get_vpc_config(&self) -> &Option<VpcConfig>
pub fn get_vpc_config(&self) -> &Option<VpcConfig>
A VpcConfig object that specifies the VPC that this training job has access to. For more information, see Protect Training Jobs by Using an Amazon Virtual Private Cloud.
Sourcepub fn stopping_condition(self, input: StoppingCondition) -> Self
pub fn stopping_condition(self, input: StoppingCondition) -> Self
Specifies a limit to how long a model training job can run. It also specifies how long a managed Spot training job has to complete. When the job reaches the time limit, SageMaker ends the training job. Use this API to cap model training costs.
To stop a job, SageMaker sends the algorithm the SIGTERM
signal, which delays job termination for 120 seconds. Algorithms can use this 120-second window to save the model artifacts, so the results of training are not lost.
Sourcepub fn set_stopping_condition(self, input: Option<StoppingCondition>) -> Self
pub fn set_stopping_condition(self, input: Option<StoppingCondition>) -> Self
Specifies a limit to how long a model training job can run. It also specifies how long a managed Spot training job has to complete. When the job reaches the time limit, SageMaker ends the training job. Use this API to cap model training costs.
To stop a job, SageMaker sends the algorithm the SIGTERM
signal, which delays job termination for 120 seconds. Algorithms can use this 120-second window to save the model artifacts, so the results of training are not lost.
Sourcepub fn get_stopping_condition(&self) -> &Option<StoppingCondition>
pub fn get_stopping_condition(&self) -> &Option<StoppingCondition>
Specifies a limit to how long a model training job can run. It also specifies how long a managed Spot training job has to complete. When the job reaches the time limit, SageMaker ends the training job. Use this API to cap model training costs.
To stop a job, SageMaker sends the algorithm the SIGTERM
signal, which delays job termination for 120 seconds. Algorithms can use this 120-second window to save the model artifacts, so the results of training are not lost.
Sourcepub fn creation_time(self, input: DateTime) -> Self
pub fn creation_time(self, input: DateTime) -> Self
A timestamp that indicates when the training job was created.
This field is required.Sourcepub fn set_creation_time(self, input: Option<DateTime>) -> Self
pub fn set_creation_time(self, input: Option<DateTime>) -> Self
A timestamp that indicates when the training job was created.
Sourcepub fn get_creation_time(&self) -> &Option<DateTime>
pub fn get_creation_time(&self) -> &Option<DateTime>
A timestamp that indicates when the training job was created.
Sourcepub fn training_start_time(self, input: DateTime) -> Self
pub fn training_start_time(self, input: DateTime) -> Self
Indicates the time when the training job starts on training instances. You are billed for the time interval between this time and the value of TrainingEndTime
. The start time in CloudWatch Logs might be later than this time. The difference is due to the time it takes to download the training data and to the size of the training container.
Sourcepub fn set_training_start_time(self, input: Option<DateTime>) -> Self
pub fn set_training_start_time(self, input: Option<DateTime>) -> Self
Indicates the time when the training job starts on training instances. You are billed for the time interval between this time and the value of TrainingEndTime
. The start time in CloudWatch Logs might be later than this time. The difference is due to the time it takes to download the training data and to the size of the training container.
Sourcepub fn get_training_start_time(&self) -> &Option<DateTime>
pub fn get_training_start_time(&self) -> &Option<DateTime>
Indicates the time when the training job starts on training instances. You are billed for the time interval between this time and the value of TrainingEndTime
. The start time in CloudWatch Logs might be later than this time. The difference is due to the time it takes to download the training data and to the size of the training container.
Sourcepub fn training_end_time(self, input: DateTime) -> Self
pub fn training_end_time(self, input: DateTime) -> Self
Indicates the time when the training job ends on training instances. You are billed for the time interval between the value of TrainingStartTime
and this time. For successful jobs and stopped jobs, this is the time after model artifacts are uploaded. For failed jobs, this is the time when SageMaker detects a job failure.
Sourcepub fn set_training_end_time(self, input: Option<DateTime>) -> Self
pub fn set_training_end_time(self, input: Option<DateTime>) -> Self
Indicates the time when the training job ends on training instances. You are billed for the time interval between the value of TrainingStartTime
and this time. For successful jobs and stopped jobs, this is the time after model artifacts are uploaded. For failed jobs, this is the time when SageMaker detects a job failure.
Sourcepub fn get_training_end_time(&self) -> &Option<DateTime>
pub fn get_training_end_time(&self) -> &Option<DateTime>
Indicates the time when the training job ends on training instances. You are billed for the time interval between the value of TrainingStartTime
and this time. For successful jobs and stopped jobs, this is the time after model artifacts are uploaded. For failed jobs, this is the time when SageMaker detects a job failure.
Sourcepub fn last_modified_time(self, input: DateTime) -> Self
pub fn last_modified_time(self, input: DateTime) -> Self
A timestamp that indicates when the status of the training job was last modified.
Sourcepub fn set_last_modified_time(self, input: Option<DateTime>) -> Self
pub fn set_last_modified_time(self, input: Option<DateTime>) -> Self
A timestamp that indicates when the status of the training job was last modified.
Sourcepub fn get_last_modified_time(&self) -> &Option<DateTime>
pub fn get_last_modified_time(&self) -> &Option<DateTime>
A timestamp that indicates when the status of the training job was last modified.
Sourcepub fn secondary_status_transitions(
self,
input: SecondaryStatusTransition,
) -> Self
pub fn secondary_status_transitions( self, input: SecondaryStatusTransition, ) -> Self
Appends an item to secondary_status_transitions
.
To override the contents of this collection use set_secondary_status_transitions
.
A history of all of the secondary statuses that the training job has transitioned through.
Sourcepub fn set_secondary_status_transitions(
self,
input: Option<Vec<SecondaryStatusTransition>>,
) -> Self
pub fn set_secondary_status_transitions( self, input: Option<Vec<SecondaryStatusTransition>>, ) -> Self
A history of all of the secondary statuses that the training job has transitioned through.
Sourcepub fn get_secondary_status_transitions(
&self,
) -> &Option<Vec<SecondaryStatusTransition>>
pub fn get_secondary_status_transitions( &self, ) -> &Option<Vec<SecondaryStatusTransition>>
A history of all of the secondary statuses that the training job has transitioned through.
Sourcepub fn final_metric_data_list(self, input: MetricData) -> Self
pub fn final_metric_data_list(self, input: MetricData) -> Self
Appends an item to final_metric_data_list
.
To override the contents of this collection use set_final_metric_data_list
.
A collection of MetricData
objects that specify the names, values, and dates and times that the training algorithm emitted to Amazon CloudWatch.
Sourcepub fn set_final_metric_data_list(self, input: Option<Vec<MetricData>>) -> Self
pub fn set_final_metric_data_list(self, input: Option<Vec<MetricData>>) -> Self
A collection of MetricData
objects that specify the names, values, and dates and times that the training algorithm emitted to Amazon CloudWatch.
Sourcepub fn get_final_metric_data_list(&self) -> &Option<Vec<MetricData>>
pub fn get_final_metric_data_list(&self) -> &Option<Vec<MetricData>>
A collection of MetricData
objects that specify the names, values, and dates and times that the training algorithm emitted to Amazon CloudWatch.
Sourcepub fn enable_network_isolation(self, input: bool) -> Self
pub fn enable_network_isolation(self, input: bool) -> Self
If you want to allow inbound or outbound network calls, except for calls between peers within a training cluster for distributed training, choose True
. If you enable network isolation for training jobs that are configured to use a VPC, SageMaker downloads and uploads customer data and model artifacts through the specified VPC, but the training container does not have network access.
Sourcepub fn set_enable_network_isolation(self, input: Option<bool>) -> Self
pub fn set_enable_network_isolation(self, input: Option<bool>) -> Self
If you want to allow inbound or outbound network calls, except for calls between peers within a training cluster for distributed training, choose True
. If you enable network isolation for training jobs that are configured to use a VPC, SageMaker downloads and uploads customer data and model artifacts through the specified VPC, but the training container does not have network access.
Sourcepub fn get_enable_network_isolation(&self) -> &Option<bool>
pub fn get_enable_network_isolation(&self) -> &Option<bool>
If you want to allow inbound or outbound network calls, except for calls between peers within a training cluster for distributed training, choose True
. If you enable network isolation for training jobs that are configured to use a VPC, SageMaker downloads and uploads customer data and model artifacts through the specified VPC, but the training container does not have network access.
Sourcepub fn enable_inter_container_traffic_encryption(self, input: bool) -> Self
pub fn enable_inter_container_traffic_encryption(self, input: bool) -> Self
To encrypt all communications between ML compute instances in distributed training, choose True
. Encryption provides greater security for distributed training, but training might take longer. How long it takes depends on the amount of communication between compute instances, especially if you use a deep learning algorithms in distributed training.
Sourcepub fn set_enable_inter_container_traffic_encryption(
self,
input: Option<bool>,
) -> Self
pub fn set_enable_inter_container_traffic_encryption( self, input: Option<bool>, ) -> Self
To encrypt all communications between ML compute instances in distributed training, choose True
. Encryption provides greater security for distributed training, but training might take longer. How long it takes depends on the amount of communication between compute instances, especially if you use a deep learning algorithms in distributed training.
Sourcepub fn get_enable_inter_container_traffic_encryption(&self) -> &Option<bool>
pub fn get_enable_inter_container_traffic_encryption(&self) -> &Option<bool>
To encrypt all communications between ML compute instances in distributed training, choose True
. Encryption provides greater security for distributed training, but training might take longer. How long it takes depends on the amount of communication between compute instances, especially if you use a deep learning algorithms in distributed training.
Sourcepub fn enable_managed_spot_training(self, input: bool) -> Self
pub fn enable_managed_spot_training(self, input: bool) -> Self
A Boolean indicating whether managed spot training is enabled (True
) or not (False
).
Sourcepub fn set_enable_managed_spot_training(self, input: Option<bool>) -> Self
pub fn set_enable_managed_spot_training(self, input: Option<bool>) -> Self
A Boolean indicating whether managed spot training is enabled (True
) or not (False
).
Sourcepub fn get_enable_managed_spot_training(&self) -> &Option<bool>
pub fn get_enable_managed_spot_training(&self) -> &Option<bool>
A Boolean indicating whether managed spot training is enabled (True
) or not (False
).
Sourcepub fn checkpoint_config(self, input: CheckpointConfig) -> Self
pub fn checkpoint_config(self, input: CheckpointConfig) -> Self
Contains information about the output location for managed spot training checkpoint data.
Sourcepub fn set_checkpoint_config(self, input: Option<CheckpointConfig>) -> Self
pub fn set_checkpoint_config(self, input: Option<CheckpointConfig>) -> Self
Contains information about the output location for managed spot training checkpoint data.
Sourcepub fn get_checkpoint_config(&self) -> &Option<CheckpointConfig>
pub fn get_checkpoint_config(&self) -> &Option<CheckpointConfig>
Contains information about the output location for managed spot training checkpoint data.
Sourcepub fn training_time_in_seconds(self, input: i32) -> Self
pub fn training_time_in_seconds(self, input: i32) -> Self
The training time in seconds.
Sourcepub fn set_training_time_in_seconds(self, input: Option<i32>) -> Self
pub fn set_training_time_in_seconds(self, input: Option<i32>) -> Self
The training time in seconds.
Sourcepub fn get_training_time_in_seconds(&self) -> &Option<i32>
pub fn get_training_time_in_seconds(&self) -> &Option<i32>
The training time in seconds.
Sourcepub fn billable_time_in_seconds(self, input: i32) -> Self
pub fn billable_time_in_seconds(self, input: i32) -> Self
The billable time in seconds. Billable time refers to the absolute wall-clock time.
Multiply BillableTimeInSeconds
by the number of instances (InstanceCount
) in your training cluster to get the total compute time SageMaker bills you if you run distributed training. The formula is as follows: BillableTimeInSeconds * InstanceCount
.
You can calculate the savings from using managed spot training using the formula (1 - BillableTimeInSeconds / TrainingTimeInSeconds) * 100
. For example, if BillableTimeInSeconds
is 100 and TrainingTimeInSeconds
is 500, the savings is 80%.
Sourcepub fn set_billable_time_in_seconds(self, input: Option<i32>) -> Self
pub fn set_billable_time_in_seconds(self, input: Option<i32>) -> Self
The billable time in seconds. Billable time refers to the absolute wall-clock time.
Multiply BillableTimeInSeconds
by the number of instances (InstanceCount
) in your training cluster to get the total compute time SageMaker bills you if you run distributed training. The formula is as follows: BillableTimeInSeconds * InstanceCount
.
You can calculate the savings from using managed spot training using the formula (1 - BillableTimeInSeconds / TrainingTimeInSeconds) * 100
. For example, if BillableTimeInSeconds
is 100 and TrainingTimeInSeconds
is 500, the savings is 80%.
Sourcepub fn get_billable_time_in_seconds(&self) -> &Option<i32>
pub fn get_billable_time_in_seconds(&self) -> &Option<i32>
The billable time in seconds. Billable time refers to the absolute wall-clock time.
Multiply BillableTimeInSeconds
by the number of instances (InstanceCount
) in your training cluster to get the total compute time SageMaker bills you if you run distributed training. The formula is as follows: BillableTimeInSeconds * InstanceCount
.
You can calculate the savings from using managed spot training using the formula (1 - BillableTimeInSeconds / TrainingTimeInSeconds) * 100
. For example, if BillableTimeInSeconds
is 100 and TrainingTimeInSeconds
is 500, the savings is 80%.
Sourcepub fn debug_hook_config(self, input: DebugHookConfig) -> Self
pub fn debug_hook_config(self, input: DebugHookConfig) -> Self
Configuration information for the Amazon SageMaker Debugger hook parameters, metric and tensor collections, and storage paths. To learn more about how to configure the DebugHookConfig
parameter, see Use the SageMaker and Debugger Configuration API Operations to Create, Update, and Debug Your Training Job.
Sourcepub fn set_debug_hook_config(self, input: Option<DebugHookConfig>) -> Self
pub fn set_debug_hook_config(self, input: Option<DebugHookConfig>) -> Self
Configuration information for the Amazon SageMaker Debugger hook parameters, metric and tensor collections, and storage paths. To learn more about how to configure the DebugHookConfig
parameter, see Use the SageMaker and Debugger Configuration API Operations to Create, Update, and Debug Your Training Job.
Sourcepub fn get_debug_hook_config(&self) -> &Option<DebugHookConfig>
pub fn get_debug_hook_config(&self) -> &Option<DebugHookConfig>
Configuration information for the Amazon SageMaker Debugger hook parameters, metric and tensor collections, and storage paths. To learn more about how to configure the DebugHookConfig
parameter, see Use the SageMaker and Debugger Configuration API Operations to Create, Update, and Debug Your Training Job.
Sourcepub fn experiment_config(self, input: ExperimentConfig) -> Self
pub fn experiment_config(self, input: ExperimentConfig) -> Self
Associates a SageMaker job as a trial component with an experiment and trial. Specified when you call the following APIs:
Sourcepub fn set_experiment_config(self, input: Option<ExperimentConfig>) -> Self
pub fn set_experiment_config(self, input: Option<ExperimentConfig>) -> Self
Associates a SageMaker job as a trial component with an experiment and trial. Specified when you call the following APIs:
Sourcepub fn get_experiment_config(&self) -> &Option<ExperimentConfig>
pub fn get_experiment_config(&self) -> &Option<ExperimentConfig>
Associates a SageMaker job as a trial component with an experiment and trial. Specified when you call the following APIs:
Sourcepub fn debug_rule_configurations(self, input: DebugRuleConfiguration) -> Self
pub fn debug_rule_configurations(self, input: DebugRuleConfiguration) -> Self
Appends an item to debug_rule_configurations
.
To override the contents of this collection use set_debug_rule_configurations
.
Configuration information for Amazon SageMaker Debugger rules for debugging output tensors.
Sourcepub fn set_debug_rule_configurations(
self,
input: Option<Vec<DebugRuleConfiguration>>,
) -> Self
pub fn set_debug_rule_configurations( self, input: Option<Vec<DebugRuleConfiguration>>, ) -> Self
Configuration information for Amazon SageMaker Debugger rules for debugging output tensors.
Sourcepub fn get_debug_rule_configurations(
&self,
) -> &Option<Vec<DebugRuleConfiguration>>
pub fn get_debug_rule_configurations( &self, ) -> &Option<Vec<DebugRuleConfiguration>>
Configuration information for Amazon SageMaker Debugger rules for debugging output tensors.
Sourcepub fn tensor_board_output_config(self, input: TensorBoardOutputConfig) -> Self
pub fn tensor_board_output_config(self, input: TensorBoardOutputConfig) -> Self
Configuration of storage locations for the Amazon SageMaker Debugger TensorBoard output data.
Sourcepub fn set_tensor_board_output_config(
self,
input: Option<TensorBoardOutputConfig>,
) -> Self
pub fn set_tensor_board_output_config( self, input: Option<TensorBoardOutputConfig>, ) -> Self
Configuration of storage locations for the Amazon SageMaker Debugger TensorBoard output data.
Sourcepub fn get_tensor_board_output_config(&self) -> &Option<TensorBoardOutputConfig>
pub fn get_tensor_board_output_config(&self) -> &Option<TensorBoardOutputConfig>
Configuration of storage locations for the Amazon SageMaker Debugger TensorBoard output data.
Sourcepub fn debug_rule_evaluation_statuses(
self,
input: DebugRuleEvaluationStatus,
) -> Self
pub fn debug_rule_evaluation_statuses( self, input: DebugRuleEvaluationStatus, ) -> Self
Appends an item to debug_rule_evaluation_statuses
.
To override the contents of this collection use set_debug_rule_evaluation_statuses
.
Evaluation status of Amazon SageMaker Debugger rules for debugging on a training job.
Sourcepub fn set_debug_rule_evaluation_statuses(
self,
input: Option<Vec<DebugRuleEvaluationStatus>>,
) -> Self
pub fn set_debug_rule_evaluation_statuses( self, input: Option<Vec<DebugRuleEvaluationStatus>>, ) -> Self
Evaluation status of Amazon SageMaker Debugger rules for debugging on a training job.
Sourcepub fn get_debug_rule_evaluation_statuses(
&self,
) -> &Option<Vec<DebugRuleEvaluationStatus>>
pub fn get_debug_rule_evaluation_statuses( &self, ) -> &Option<Vec<DebugRuleEvaluationStatus>>
Evaluation status of Amazon SageMaker Debugger rules for debugging on a training job.
Sourcepub fn profiler_config(self, input: ProfilerConfig) -> Self
pub fn profiler_config(self, input: ProfilerConfig) -> Self
Configuration information for Amazon SageMaker Debugger system monitoring, framework profiling, and storage paths.
Sourcepub fn set_profiler_config(self, input: Option<ProfilerConfig>) -> Self
pub fn set_profiler_config(self, input: Option<ProfilerConfig>) -> Self
Configuration information for Amazon SageMaker Debugger system monitoring, framework profiling, and storage paths.
Sourcepub fn get_profiler_config(&self) -> &Option<ProfilerConfig>
pub fn get_profiler_config(&self) -> &Option<ProfilerConfig>
Configuration information for Amazon SageMaker Debugger system monitoring, framework profiling, and storage paths.
Sourcepub fn profiler_rule_configurations(
self,
input: ProfilerRuleConfiguration,
) -> Self
pub fn profiler_rule_configurations( self, input: ProfilerRuleConfiguration, ) -> Self
Appends an item to profiler_rule_configurations
.
To override the contents of this collection use set_profiler_rule_configurations
.
Configuration information for Amazon SageMaker Debugger rules for profiling system and framework metrics.
Sourcepub fn set_profiler_rule_configurations(
self,
input: Option<Vec<ProfilerRuleConfiguration>>,
) -> Self
pub fn set_profiler_rule_configurations( self, input: Option<Vec<ProfilerRuleConfiguration>>, ) -> Self
Configuration information for Amazon SageMaker Debugger rules for profiling system and framework metrics.
Sourcepub fn get_profiler_rule_configurations(
&self,
) -> &Option<Vec<ProfilerRuleConfiguration>>
pub fn get_profiler_rule_configurations( &self, ) -> &Option<Vec<ProfilerRuleConfiguration>>
Configuration information for Amazon SageMaker Debugger rules for profiling system and framework metrics.
Sourcepub fn profiler_rule_evaluation_statuses(
self,
input: ProfilerRuleEvaluationStatus,
) -> Self
pub fn profiler_rule_evaluation_statuses( self, input: ProfilerRuleEvaluationStatus, ) -> Self
Appends an item to profiler_rule_evaluation_statuses
.
To override the contents of this collection use set_profiler_rule_evaluation_statuses
.
Evaluation status of Amazon SageMaker Debugger rules for profiling on a training job.
Sourcepub fn set_profiler_rule_evaluation_statuses(
self,
input: Option<Vec<ProfilerRuleEvaluationStatus>>,
) -> Self
pub fn set_profiler_rule_evaluation_statuses( self, input: Option<Vec<ProfilerRuleEvaluationStatus>>, ) -> Self
Evaluation status of Amazon SageMaker Debugger rules for profiling on a training job.
Sourcepub fn get_profiler_rule_evaluation_statuses(
&self,
) -> &Option<Vec<ProfilerRuleEvaluationStatus>>
pub fn get_profiler_rule_evaluation_statuses( &self, ) -> &Option<Vec<ProfilerRuleEvaluationStatus>>
Evaluation status of Amazon SageMaker Debugger rules for profiling on a training job.
Sourcepub fn profiling_status(self, input: ProfilingStatus) -> Self
pub fn profiling_status(self, input: ProfilingStatus) -> Self
Profiling status of a training job.
Sourcepub fn set_profiling_status(self, input: Option<ProfilingStatus>) -> Self
pub fn set_profiling_status(self, input: Option<ProfilingStatus>) -> Self
Profiling status of a training job.
Sourcepub fn get_profiling_status(&self) -> &Option<ProfilingStatus>
pub fn get_profiling_status(&self) -> &Option<ProfilingStatus>
Profiling status of a training job.
Sourcepub fn environment(self, k: impl Into<String>, v: impl Into<String>) -> Self
pub fn environment(self, k: impl Into<String>, v: impl Into<String>) -> Self
Adds a key-value pair to environment
.
To override the contents of this collection use set_environment
.
The environment variables to set in the Docker container.
Do not include any security-sensitive information including account access IDs, secrets, or tokens in any environment fields. As part of the shared responsibility model, you are responsible for any potential exposure, unauthorized access, or compromise of your sensitive data if caused by security-sensitive information included in the request environment variable or plain text fields.
Sourcepub fn set_environment(self, input: Option<HashMap<String, String>>) -> Self
pub fn set_environment(self, input: Option<HashMap<String, String>>) -> Self
The environment variables to set in the Docker container.
Do not include any security-sensitive information including account access IDs, secrets, or tokens in any environment fields. As part of the shared responsibility model, you are responsible for any potential exposure, unauthorized access, or compromise of your sensitive data if caused by security-sensitive information included in the request environment variable or plain text fields.
Sourcepub fn get_environment(&self) -> &Option<HashMap<String, String>>
pub fn get_environment(&self) -> &Option<HashMap<String, String>>
The environment variables to set in the Docker container.
Do not include any security-sensitive information including account access IDs, secrets, or tokens in any environment fields. As part of the shared responsibility model, you are responsible for any potential exposure, unauthorized access, or compromise of your sensitive data if caused by security-sensitive information included in the request environment variable or plain text fields.
Sourcepub fn retry_strategy(self, input: RetryStrategy) -> Self
pub fn retry_strategy(self, input: RetryStrategy) -> Self
The number of times to retry the job when the job fails due to an InternalServerError
.
Sourcepub fn set_retry_strategy(self, input: Option<RetryStrategy>) -> Self
pub fn set_retry_strategy(self, input: Option<RetryStrategy>) -> Self
The number of times to retry the job when the job fails due to an InternalServerError
.
Sourcepub fn get_retry_strategy(&self) -> &Option<RetryStrategy>
pub fn get_retry_strategy(&self) -> &Option<RetryStrategy>
The number of times to retry the job when the job fails due to an InternalServerError
.
Sourcepub fn remote_debug_config(self, input: RemoteDebugConfig) -> Self
pub fn remote_debug_config(self, input: RemoteDebugConfig) -> Self
Configuration for remote debugging. To learn more about the remote debugging functionality of SageMaker, see Access a training container through Amazon Web Services Systems Manager (SSM) for remote debugging.
Sourcepub fn set_remote_debug_config(self, input: Option<RemoteDebugConfig>) -> Self
pub fn set_remote_debug_config(self, input: Option<RemoteDebugConfig>) -> Self
Configuration for remote debugging. To learn more about the remote debugging functionality of SageMaker, see Access a training container through Amazon Web Services Systems Manager (SSM) for remote debugging.
Sourcepub fn get_remote_debug_config(&self) -> &Option<RemoteDebugConfig>
pub fn get_remote_debug_config(&self) -> &Option<RemoteDebugConfig>
Configuration for remote debugging. To learn more about the remote debugging functionality of SageMaker, see Access a training container through Amazon Web Services Systems Manager (SSM) for remote debugging.
Sourcepub fn infra_check_config(self, input: InfraCheckConfig) -> Self
pub fn infra_check_config(self, input: InfraCheckConfig) -> Self
Contains information about the infrastructure health check configuration for the training job.
Sourcepub fn set_infra_check_config(self, input: Option<InfraCheckConfig>) -> Self
pub fn set_infra_check_config(self, input: Option<InfraCheckConfig>) -> Self
Contains information about the infrastructure health check configuration for the training job.
Sourcepub fn get_infra_check_config(&self) -> &Option<InfraCheckConfig>
pub fn get_infra_check_config(&self) -> &Option<InfraCheckConfig>
Contains information about the infrastructure health check configuration for the training job.
Sourcepub fn build(self) -> DescribeTrainingJobOutput
pub fn build(self) -> DescribeTrainingJobOutput
Consumes the builder and constructs a DescribeTrainingJobOutput
.
Trait Implementations§
Source§impl Clone for DescribeTrainingJobOutputBuilder
impl Clone for DescribeTrainingJobOutputBuilder
Source§fn clone(&self) -> DescribeTrainingJobOutputBuilder
fn clone(&self) -> DescribeTrainingJobOutputBuilder
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Default for DescribeTrainingJobOutputBuilder
impl Default for DescribeTrainingJobOutputBuilder
Source§fn default() -> DescribeTrainingJobOutputBuilder
fn default() -> DescribeTrainingJobOutputBuilder
Source§impl PartialEq for DescribeTrainingJobOutputBuilder
impl PartialEq for DescribeTrainingJobOutputBuilder
Source§fn eq(&self, other: &DescribeTrainingJobOutputBuilder) -> bool
fn eq(&self, other: &DescribeTrainingJobOutputBuilder) -> bool
self
and other
values to be equal, and is used by ==
.impl StructuralPartialEq for DescribeTrainingJobOutputBuilder
Auto Trait Implementations§
impl Freeze for DescribeTrainingJobOutputBuilder
impl RefUnwindSafe for DescribeTrainingJobOutputBuilder
impl Send for DescribeTrainingJobOutputBuilder
impl Sync for DescribeTrainingJobOutputBuilder
impl Unpin for DescribeTrainingJobOutputBuilder
impl UnwindSafe for DescribeTrainingJobOutputBuilder
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);