Struct Cluster

Source
#[non_exhaustive]
pub struct Cluster {
Show 60 fields pub cluster_identifier: Option<String>, pub node_type: Option<String>, pub cluster_status: Option<String>, pub cluster_availability_status: Option<String>, pub modify_status: Option<String>, pub master_username: Option<String>, pub db_name: Option<String>, pub endpoint: Option<Endpoint>, pub cluster_create_time: Option<DateTime>, pub automated_snapshot_retention_period: Option<i32>, pub manual_snapshot_retention_period: Option<i32>, pub cluster_security_groups: Option<Vec<ClusterSecurityGroupMembership>>, pub vpc_security_groups: Option<Vec<VpcSecurityGroupMembership>>, pub cluster_parameter_groups: Option<Vec<ClusterParameterGroupStatus>>, pub cluster_subnet_group_name: Option<String>, pub vpc_id: Option<String>, pub availability_zone: Option<String>, pub preferred_maintenance_window: Option<String>, pub pending_modified_values: Option<PendingModifiedValues>, pub cluster_version: Option<String>, pub allow_version_upgrade: Option<bool>, pub number_of_nodes: Option<i32>, pub publicly_accessible: Option<bool>, pub encrypted: Option<bool>, pub restore_status: Option<RestoreStatus>, pub data_transfer_progress: Option<DataTransferProgress>, pub hsm_status: Option<HsmStatus>, pub cluster_snapshot_copy_status: Option<ClusterSnapshotCopyStatus>, pub cluster_public_key: Option<String>, pub cluster_nodes: Option<Vec<ClusterNode>>, pub elastic_ip_status: Option<ElasticIpStatus>, pub cluster_revision_number: Option<String>, pub tags: Option<Vec<Tag>>, pub kms_key_id: Option<String>, pub enhanced_vpc_routing: Option<bool>, pub iam_roles: Option<Vec<ClusterIamRole>>, pub pending_actions: Option<Vec<String>>, pub maintenance_track_name: Option<String>, pub elastic_resize_number_of_node_options: Option<String>, pub deferred_maintenance_windows: Option<Vec<DeferredMaintenanceWindow>>, pub snapshot_schedule_identifier: Option<String>, pub snapshot_schedule_state: Option<ScheduleState>, pub expected_next_snapshot_schedule_time: Option<DateTime>, pub expected_next_snapshot_schedule_time_status: Option<String>, pub next_maintenance_window_start_time: Option<DateTime>, pub resize_info: Option<ResizeInfo>, pub availability_zone_relocation_status: Option<String>, pub cluster_namespace_arn: Option<String>, pub total_storage_capacity_in_mega_bytes: Option<i64>, pub aqua_configuration: Option<AquaConfiguration>, pub default_iam_role_arn: Option<String>, pub reserved_node_exchange_status: Option<ReservedNodeExchangeStatus>, pub custom_domain_name: Option<String>, pub custom_domain_certificate_arn: Option<String>, pub custom_domain_certificate_expiry_date: Option<DateTime>, pub master_password_secret_arn: Option<String>, pub master_password_secret_kms_key_id: Option<String>, pub ip_address_type: Option<String>, pub multi_az: Option<String>, pub multi_az_secondary: Option<SecondaryClusterInfo>,
}
Expand description

Describes a cluster.

Fields (Non-exhaustive)§

This struct is marked as non-exhaustive
Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.
§cluster_identifier: Option<String>

The unique identifier of the cluster.

§node_type: Option<String>

The node type for the nodes in the cluster.

§cluster_status: Option<String>

The current state of the cluster. Possible values are the following:

  • available

  • available, prep-for-resize

  • available, resize-cleanup

  • cancelling-resize

  • creating

  • deleting

  • final-snapshot

  • hardware-failure

  • incompatible-hsm

  • incompatible-network

  • incompatible-parameters

  • incompatible-restore

  • modifying

  • paused

  • rebooting

  • renaming

  • resizing

  • rotating-keys

  • storage-full

  • updating-hsm

§cluster_availability_status: Option<String>

The availability status of the cluster for queries. Possible values are the following:

  • Available - The cluster is available for queries.

  • Unavailable - The cluster is not available for queries.

  • Maintenance - The cluster is intermittently available for queries due to maintenance activities.

  • Modifying - The cluster is intermittently available for queries due to changes that modify the cluster.

  • Failed - The cluster failed and is not available for queries.

§modify_status: Option<String>

The status of a modify operation, if any, initiated for the cluster.

§master_username: Option<String>

The admin user name for the cluster. This name is used to connect to the database that is specified in the DBName parameter.

§db_name: Option<String>

The name of the initial database that was created when the cluster was created. This same name is returned for the life of the cluster. If an initial database was not specified, a database named devdev was created by default.

§endpoint: Option<Endpoint>

The connection endpoint.

§cluster_create_time: Option<DateTime>

The date and time that the cluster was created.

§automated_snapshot_retention_period: Option<i32>

The number of days that automatic cluster snapshots are retained.

§manual_snapshot_retention_period: Option<i32>

The default number of days to retain a manual snapshot. If the value is -1, the snapshot is retained indefinitely. This setting doesn't change the retention period of existing snapshots.

The value must be either -1 or an integer between 1 and 3,653.

§cluster_security_groups: Option<Vec<ClusterSecurityGroupMembership>>

A list of cluster security group that are associated with the cluster. Each security group is represented by an element that contains ClusterSecurityGroup.Name and ClusterSecurityGroup.Status subelements.

Cluster security groups are used when the cluster is not created in an Amazon Virtual Private Cloud (VPC). Clusters that are created in a VPC use VPC security groups, which are listed by the VpcSecurityGroups parameter.

§vpc_security_groups: Option<Vec<VpcSecurityGroupMembership>>

A list of Amazon Virtual Private Cloud (Amazon VPC) security groups that are associated with the cluster. This parameter is returned only if the cluster is in a VPC.

§cluster_parameter_groups: Option<Vec<ClusterParameterGroupStatus>>

The list of cluster parameter groups that are associated with this cluster. Each parameter group in the list is returned with its status.

§cluster_subnet_group_name: Option<String>

The name of the subnet group that is associated with the cluster. This parameter is valid only when the cluster is in a VPC.

§vpc_id: Option<String>

The identifier of the VPC the cluster is in, if the cluster is in a VPC.

§availability_zone: Option<String>

The name of the Availability Zone in which the cluster is located.

§preferred_maintenance_window: Option<String>

The weekly time range, in Universal Coordinated Time (UTC), during which system maintenance can occur.

§pending_modified_values: Option<PendingModifiedValues>

A value that, if present, indicates that changes to the cluster are pending. Specific pending changes are identified by subelements.

§cluster_version: Option<String>

The version ID of the Amazon Redshift engine that is running on the cluster.

§allow_version_upgrade: Option<bool>

A boolean value that, if true, indicates that major version upgrades will be applied automatically to the cluster during the maintenance window.

§number_of_nodes: Option<i32>

The number of compute nodes in the cluster.

§publicly_accessible: Option<bool>

A boolean value that, if true, indicates that the cluster can be accessed from a public network.

Default: false

§encrypted: Option<bool>

A boolean value that, if true, indicates that data in the cluster is encrypted at rest.

§restore_status: Option<RestoreStatus>

A value that describes the status of a cluster restore action. This parameter returns null if the cluster was not created by restoring a snapshot.

§data_transfer_progress: Option<DataTransferProgress>

§hsm_status: Option<HsmStatus>

A value that reports whether the Amazon Redshift cluster has finished applying any hardware security module (HSM) settings changes specified in a modify cluster command.

Values: active, applying

§cluster_snapshot_copy_status: Option<ClusterSnapshotCopyStatus>

A value that returns the destination region and retention period that are configured for cross-region snapshot copy.

§cluster_public_key: Option<String>

The public key for the cluster.

§cluster_nodes: Option<Vec<ClusterNode>>

The nodes in the cluster.

§elastic_ip_status: Option<ElasticIpStatus>

The status of the elastic IP (EIP) address.

§cluster_revision_number: Option<String>

The specific revision number of the database in the cluster.

§tags: Option<Vec<Tag>>

The list of tags for the cluster.

§kms_key_id: Option<String>

The Key Management Service (KMS) key ID of the encryption key used to encrypt data in the cluster.

§enhanced_vpc_routing: Option<bool>

An option that specifies whether to create the cluster with enhanced VPC routing enabled. To create a cluster that uses enhanced VPC routing, the cluster must be in a VPC. For more information, see Enhanced VPC Routing in the Amazon Redshift Cluster Management Guide.

If this option is true, enhanced VPC routing is enabled.

Default: false

§iam_roles: Option<Vec<ClusterIamRole>>

A list of Identity and Access Management (IAM) roles that can be used by the cluster to access other Amazon Web Services services.

§pending_actions: Option<Vec<String>>

Cluster operations that are waiting to be started.

§maintenance_track_name: Option<String>

The name of the maintenance track for the cluster.

§elastic_resize_number_of_node_options: Option<String>

The number of nodes that you can resize the cluster to with the elastic resize method.

§deferred_maintenance_windows: Option<Vec<DeferredMaintenanceWindow>>

Describes a group of DeferredMaintenanceWindow objects.

§snapshot_schedule_identifier: Option<String>

A unique identifier for the cluster snapshot schedule.

§snapshot_schedule_state: Option<ScheduleState>

The current state of the cluster snapshot schedule.

§expected_next_snapshot_schedule_time: Option<DateTime>

The date and time when the next snapshot is expected to be taken for clusters with a valid snapshot schedule and backups enabled.

§expected_next_snapshot_schedule_time_status: Option<String>

The status of next expected snapshot for clusters having a valid snapshot schedule and backups enabled. Possible values are the following:

  • OnTrack - The next snapshot is expected to be taken on time.

  • Pending - The next snapshot is pending to be taken.

§next_maintenance_window_start_time: Option<DateTime>

The date and time in UTC when system maintenance can begin.

§resize_info: Option<ResizeInfo>

Returns the following:

  • AllowCancelResize: a boolean value indicating if the resize operation can be cancelled.

  • ResizeType: Returns ClassicResize

§availability_zone_relocation_status: Option<String>

Describes the status of the Availability Zone relocation operation.

§cluster_namespace_arn: Option<String>

The namespace Amazon Resource Name (ARN) of the cluster.

§total_storage_capacity_in_mega_bytes: Option<i64>

The total storage capacity of the cluster in megabytes.

§aqua_configuration: Option<AquaConfiguration>

This field is retired. Amazon Redshift automatically determines whether to use AQUA (Advanced Query Accelerator).

§default_iam_role_arn: Option<String>

The Amazon Resource Name (ARN) for the IAM role set as default for the cluster.

§reserved_node_exchange_status: Option<ReservedNodeExchangeStatus>

The status of the reserved-node exchange request. Statuses include in-progress and requested.

§custom_domain_name: Option<String>

The custom domain name associated with the cluster.

§custom_domain_certificate_arn: Option<String>

The certificate Amazon Resource Name (ARN) for the custom domain name.

§custom_domain_certificate_expiry_date: Option<DateTime>

The expiration date for the certificate associated with the custom domain name.

§master_password_secret_arn: Option<String>

The Amazon Resource Name (ARN) for the cluster's admin user credentials secret.

§master_password_secret_kms_key_id: Option<String>

The ID of the Key Management Service (KMS) key used to encrypt and store the cluster's admin credentials secret.

§ip_address_type: Option<String>

The IP address type for the cluster. Possible values are ipv4 and dualstack.

§multi_az: Option<String>

A boolean value that, if true, indicates that the cluster is deployed in two Availability Zones.

§multi_az_secondary: Option<SecondaryClusterInfo>

The secondary compute unit of a cluster, if Multi-AZ deployment is turned on.

Implementations§

Source§

impl Cluster

Source

pub fn cluster_identifier(&self) -> Option<&str>

The unique identifier of the cluster.

Source

pub fn node_type(&self) -> Option<&str>

The node type for the nodes in the cluster.

Source

pub fn cluster_status(&self) -> Option<&str>

The current state of the cluster. Possible values are the following:

  • available

  • available, prep-for-resize

  • available, resize-cleanup

  • cancelling-resize

  • creating

  • deleting

  • final-snapshot

  • hardware-failure

  • incompatible-hsm

  • incompatible-network

  • incompatible-parameters

  • incompatible-restore

  • modifying

  • paused

  • rebooting

  • renaming

  • resizing

  • rotating-keys

  • storage-full

  • updating-hsm

Source

pub fn cluster_availability_status(&self) -> Option<&str>

The availability status of the cluster for queries. Possible values are the following:

  • Available - The cluster is available for queries.

  • Unavailable - The cluster is not available for queries.

  • Maintenance - The cluster is intermittently available for queries due to maintenance activities.

  • Modifying - The cluster is intermittently available for queries due to changes that modify the cluster.

  • Failed - The cluster failed and is not available for queries.

Source

pub fn modify_status(&self) -> Option<&str>

The status of a modify operation, if any, initiated for the cluster.

Source

pub fn master_username(&self) -> Option<&str>

The admin user name for the cluster. This name is used to connect to the database that is specified in the DBName parameter.

Source

pub fn db_name(&self) -> Option<&str>

The name of the initial database that was created when the cluster was created. This same name is returned for the life of the cluster. If an initial database was not specified, a database named devdev was created by default.

Source

pub fn endpoint(&self) -> Option<&Endpoint>

The connection endpoint.

Source

pub fn cluster_create_time(&self) -> Option<&DateTime>

The date and time that the cluster was created.

Source

pub fn automated_snapshot_retention_period(&self) -> Option<i32>

The number of days that automatic cluster snapshots are retained.

Source

pub fn manual_snapshot_retention_period(&self) -> Option<i32>

The default number of days to retain a manual snapshot. If the value is -1, the snapshot is retained indefinitely. This setting doesn't change the retention period of existing snapshots.

The value must be either -1 or an integer between 1 and 3,653.

Source

pub fn cluster_security_groups(&self) -> &[ClusterSecurityGroupMembership]

A list of cluster security group that are associated with the cluster. Each security group is represented by an element that contains ClusterSecurityGroup.Name and ClusterSecurityGroup.Status subelements.

Cluster security groups are used when the cluster is not created in an Amazon Virtual Private Cloud (VPC). Clusters that are created in a VPC use VPC security groups, which are listed by the VpcSecurityGroups parameter.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .cluster_security_groups.is_none().

Source

pub fn vpc_security_groups(&self) -> &[VpcSecurityGroupMembership]

A list of Amazon Virtual Private Cloud (Amazon VPC) security groups that are associated with the cluster. This parameter is returned only if the cluster is in a VPC.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .vpc_security_groups.is_none().

Source

pub fn cluster_parameter_groups(&self) -> &[ClusterParameterGroupStatus]

The list of cluster parameter groups that are associated with this cluster. Each parameter group in the list is returned with its status.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .cluster_parameter_groups.is_none().

Source

pub fn cluster_subnet_group_name(&self) -> Option<&str>

The name of the subnet group that is associated with the cluster. This parameter is valid only when the cluster is in a VPC.

Source

pub fn vpc_id(&self) -> Option<&str>

The identifier of the VPC the cluster is in, if the cluster is in a VPC.

Source

pub fn availability_zone(&self) -> Option<&str>

The name of the Availability Zone in which the cluster is located.

Source

pub fn preferred_maintenance_window(&self) -> Option<&str>

The weekly time range, in Universal Coordinated Time (UTC), during which system maintenance can occur.

Source

pub fn pending_modified_values(&self) -> Option<&PendingModifiedValues>

A value that, if present, indicates that changes to the cluster are pending. Specific pending changes are identified by subelements.

Source

pub fn cluster_version(&self) -> Option<&str>

The version ID of the Amazon Redshift engine that is running on the cluster.

Source

pub fn allow_version_upgrade(&self) -> Option<bool>

A boolean value that, if true, indicates that major version upgrades will be applied automatically to the cluster during the maintenance window.

Source

pub fn number_of_nodes(&self) -> Option<i32>

The number of compute nodes in the cluster.

Source

pub fn publicly_accessible(&self) -> Option<bool>

A boolean value that, if true, indicates that the cluster can be accessed from a public network.

Default: false

Source

pub fn encrypted(&self) -> Option<bool>

A boolean value that, if true, indicates that data in the cluster is encrypted at rest.

Source

pub fn restore_status(&self) -> Option<&RestoreStatus>

A value that describes the status of a cluster restore action. This parameter returns null if the cluster was not created by restoring a snapshot.

Source

pub fn data_transfer_progress(&self) -> Option<&DataTransferProgress>

Source

pub fn hsm_status(&self) -> Option<&HsmStatus>

A value that reports whether the Amazon Redshift cluster has finished applying any hardware security module (HSM) settings changes specified in a modify cluster command.

Values: active, applying

Source

pub fn cluster_snapshot_copy_status(&self) -> Option<&ClusterSnapshotCopyStatus>

A value that returns the destination region and retention period that are configured for cross-region snapshot copy.

Source

pub fn cluster_public_key(&self) -> Option<&str>

The public key for the cluster.

Source

pub fn cluster_nodes(&self) -> &[ClusterNode]

The nodes in the cluster.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .cluster_nodes.is_none().

Source

pub fn elastic_ip_status(&self) -> Option<&ElasticIpStatus>

The status of the elastic IP (EIP) address.

Source

pub fn cluster_revision_number(&self) -> Option<&str>

The specific revision number of the database in the cluster.

Source

pub fn tags(&self) -> &[Tag]

The list of tags for the cluster.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .tags.is_none().

Source

pub fn kms_key_id(&self) -> Option<&str>

The Key Management Service (KMS) key ID of the encryption key used to encrypt data in the cluster.

Source

pub fn enhanced_vpc_routing(&self) -> Option<bool>

An option that specifies whether to create the cluster with enhanced VPC routing enabled. To create a cluster that uses enhanced VPC routing, the cluster must be in a VPC. For more information, see Enhanced VPC Routing in the Amazon Redshift Cluster Management Guide.

If this option is true, enhanced VPC routing is enabled.

Default: false

Source

pub fn iam_roles(&self) -> &[ClusterIamRole]

A list of Identity and Access Management (IAM) roles that can be used by the cluster to access other Amazon Web Services services.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .iam_roles.is_none().

Source

pub fn pending_actions(&self) -> &[String]

Cluster operations that are waiting to be started.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .pending_actions.is_none().

Source

pub fn maintenance_track_name(&self) -> Option<&str>

The name of the maintenance track for the cluster.

Source

pub fn elastic_resize_number_of_node_options(&self) -> Option<&str>

The number of nodes that you can resize the cluster to with the elastic resize method.

Source

pub fn deferred_maintenance_windows(&self) -> &[DeferredMaintenanceWindow]

Describes a group of DeferredMaintenanceWindow objects.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .deferred_maintenance_windows.is_none().

Source

pub fn snapshot_schedule_identifier(&self) -> Option<&str>

A unique identifier for the cluster snapshot schedule.

Source

pub fn snapshot_schedule_state(&self) -> Option<&ScheduleState>

The current state of the cluster snapshot schedule.

Source

pub fn expected_next_snapshot_schedule_time(&self) -> Option<&DateTime>

The date and time when the next snapshot is expected to be taken for clusters with a valid snapshot schedule and backups enabled.

Source

pub fn expected_next_snapshot_schedule_time_status(&self) -> Option<&str>

The status of next expected snapshot for clusters having a valid snapshot schedule and backups enabled. Possible values are the following:

  • OnTrack - The next snapshot is expected to be taken on time.

  • Pending - The next snapshot is pending to be taken.

Source

pub fn next_maintenance_window_start_time(&self) -> Option<&DateTime>

The date and time in UTC when system maintenance can begin.

Source

pub fn resize_info(&self) -> Option<&ResizeInfo>

Returns the following:

  • AllowCancelResize: a boolean value indicating if the resize operation can be cancelled.

  • ResizeType: Returns ClassicResize

Source

pub fn availability_zone_relocation_status(&self) -> Option<&str>

Describes the status of the Availability Zone relocation operation.

Source

pub fn cluster_namespace_arn(&self) -> Option<&str>

The namespace Amazon Resource Name (ARN) of the cluster.

Source

pub fn total_storage_capacity_in_mega_bytes(&self) -> Option<i64>

The total storage capacity of the cluster in megabytes.

Source

pub fn aqua_configuration(&self) -> Option<&AquaConfiguration>

This field is retired. Amazon Redshift automatically determines whether to use AQUA (Advanced Query Accelerator).

Source

pub fn default_iam_role_arn(&self) -> Option<&str>

The Amazon Resource Name (ARN) for the IAM role set as default for the cluster.

Source

pub fn reserved_node_exchange_status( &self, ) -> Option<&ReservedNodeExchangeStatus>

The status of the reserved-node exchange request. Statuses include in-progress and requested.

Source

pub fn custom_domain_name(&self) -> Option<&str>

The custom domain name associated with the cluster.

Source

pub fn custom_domain_certificate_arn(&self) -> Option<&str>

The certificate Amazon Resource Name (ARN) for the custom domain name.

Source

pub fn custom_domain_certificate_expiry_date(&self) -> Option<&DateTime>

The expiration date for the certificate associated with the custom domain name.

Source

pub fn master_password_secret_arn(&self) -> Option<&str>

The Amazon Resource Name (ARN) for the cluster's admin user credentials secret.

Source

pub fn master_password_secret_kms_key_id(&self) -> Option<&str>

The ID of the Key Management Service (KMS) key used to encrypt and store the cluster's admin credentials secret.

Source

pub fn ip_address_type(&self) -> Option<&str>

The IP address type for the cluster. Possible values are ipv4 and dualstack.

Source

pub fn multi_az(&self) -> Option<&str>

A boolean value that, if true, indicates that the cluster is deployed in two Availability Zones.

Source

pub fn multi_az_secondary(&self) -> Option<&SecondaryClusterInfo>

The secondary compute unit of a cluster, if Multi-AZ deployment is turned on.

Source§

impl Cluster

Source

pub fn builder() -> ClusterBuilder

Creates a new builder-style object to manufacture Cluster.

Trait Implementations§

Source§

impl Clone for Cluster

Source§

fn clone(&self) -> Cluster

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

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Cluster

Source§

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

Formats the value using the given formatter. Read more
Source§

impl PartialEq for Cluster

Source§

fn eq(&self, other: &Cluster) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl StructuralPartialEq for Cluster

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

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

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

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

Source§

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

Mutably borrows from an owned value. Read more
Source§

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

Source§

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

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

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

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

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

fn in_current_span(self) -> Instrumented<Self>

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

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

Source§

fn into(self) -> U

Calls U::from(self).

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

Source§

impl<T> IntoEither for T

Source§

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

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

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

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

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

Source§

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.
Source§

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

Source§

fn fg(&self, value: Color) -> Painted<&T>

Returns a styled value derived from self with the foreground set to value.

This method should be used rarely. Instead, prefer to use color-specific builder methods like red() and green(), which have the same functionality but are pithier.

§Example

Set foreground color to white using fg():

use yansi::{Paint, Color};

painted.fg(Color::White);

Set foreground color to white using white().

use yansi::Paint;

painted.white();
Source§

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

fn bg(&self, value: Color) -> Painted<&T>

Returns a styled value derived from self with the background set to value.

This method should be used rarely. Instead, prefer to use color-specific builder methods like on_red() and on_green(), which have the same functionality but are pithier.

§Example

Set background color to red using fg():

use yansi::{Paint, Color};

painted.bg(Color::Red);

Set background color to red using on_red().

use yansi::Paint;

painted.on_red();
Source§

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

fn attr(&self, value: Attribute) -> Painted<&T>

Enables the styling Attribute value.

This method should be used rarely. Instead, prefer to use attribute-specific builder methods like bold() and underline(), which have the same functionality but are pithier.

§Example

Make text bold using attr():

use yansi::{Paint, Attribute};

painted.attr(Attribute::Bold);

Make text bold using using bold().

use yansi::Paint;

painted.bold();
Source§

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

fn quirk(&self, value: Quirk) -> Painted<&T>

Enables the yansi Quirk value.

This method should be used rarely. Instead, prefer to use quirk-specific builder methods like mask() and wrap(), which have the same functionality but are pithier.

§Example

Enable wrapping using .quirk():

use yansi::{Paint, Quirk};

painted.quirk(Quirk::Wrap);

Enable wrapping using wrap().

use yansi::Paint;

painted.wrap();
Source§

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

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

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

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

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

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

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

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

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

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

👎Deprecated since 1.0.1: renamed to resetting() due to conflicts with Vec::clear(). The clear() method will be removed in a future release.

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

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

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

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

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

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

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

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

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

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

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

fn whenever(&self, value: Condition) -> Painted<&T>

Conditionally enable styling based on whether the Condition value applies. Replaces any previous condition.

See the crate level docs for more details.

§Example

Enable styling painted only when both stdout and stderr are TTYs:

use yansi::{Paint, Condition};

painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);
Source§

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

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

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

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

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

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

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

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

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

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

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

Source§

type Error = Infallible

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

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

Performs the conversion.
Source§

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

Source§

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

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

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

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

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

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

fn with_current_subscriber(self) -> WithDispatch<Self>

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

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