DbCluster

Struct DbCluster 

Source
#[non_exhaustive]
pub struct DbCluster {
Show 45 fields pub allocated_storage: Option<i32>, pub availability_zones: Option<Vec<String>>, pub backup_retention_period: Option<i32>, pub character_set_name: Option<String>, pub database_name: Option<String>, pub db_cluster_identifier: Option<String>, pub db_cluster_parameter_group: Option<String>, pub db_subnet_group: Option<String>, pub status: Option<String>, pub percent_progress: Option<String>, pub earliest_restorable_time: Option<DateTime>, pub endpoint: Option<String>, pub reader_endpoint: Option<String>, pub multi_az: Option<bool>, pub engine: Option<String>, pub engine_version: Option<String>, pub latest_restorable_time: Option<DateTime>, pub port: Option<i32>, pub master_username: Option<String>, pub db_cluster_option_group_memberships: Option<Vec<DbClusterOptionGroupStatus>>, pub preferred_backup_window: Option<String>, pub preferred_maintenance_window: Option<String>, pub replication_source_identifier: Option<String>, pub read_replica_identifiers: Option<Vec<String>>, pub db_cluster_members: Option<Vec<DbClusterMember>>, pub vpc_security_groups: Option<Vec<VpcSecurityGroupMembership>>, pub hosted_zone_id: Option<String>, pub storage_encrypted: Option<bool>, pub kms_key_id: Option<String>, pub db_cluster_resource_id: Option<String>, pub db_cluster_arn: Option<String>, pub associated_roles: Option<Vec<DbClusterRole>>, pub iam_database_authentication_enabled: Option<bool>, pub clone_group_id: Option<String>, pub cluster_create_time: Option<DateTime>, pub copy_tags_to_snapshot: Option<bool>, pub enabled_cloudwatch_logs_exports: Option<Vec<String>>, pub pending_modified_values: Option<ClusterPendingModifiedValues>, pub deletion_protection: Option<bool>, pub cross_account_clone: Option<bool>, pub automatic_restart_time: Option<DateTime>, pub serverless_v2_scaling_configuration: Option<ServerlessV2ScalingConfigurationInfo>, pub global_cluster_identifier: Option<String>, pub io_optimized_next_allowed_modification_time: Option<DateTime>, pub storage_type: Option<String>,
}
Expand description

Contains the details of an Amazon Neptune DB cluster.

This data type is used as a response element in the DescribeDBClusters.

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.
§allocated_storage: Option<i32>

AllocatedStorage always returns 1, because Neptune DB cluster storage size is not fixed, but instead automatically adjusts as needed.

§availability_zones: Option<Vec<String>>

Provides the list of EC2 Availability Zones that instances in the DB cluster can be created in.

§backup_retention_period: Option<i32>

Specifies the number of days for which automatic DB snapshots are retained.

§character_set_name: Option<String>

Not supported by Neptune.

§database_name: Option<String>

Contains the name of the initial database of this DB cluster that was provided at create time, if one was specified when the DB cluster was created. This same name is returned for the life of the DB cluster.

§db_cluster_identifier: Option<String>

Contains a user-supplied DB cluster identifier. This identifier is the unique key that identifies a DB cluster.

§db_cluster_parameter_group: Option<String>

Specifies the name of the DB cluster parameter group for the DB cluster.

§db_subnet_group: Option<String>

Specifies information on the subnet group associated with the DB cluster, including the name, description, and subnets in the subnet group.

§status: Option<String>

Specifies the current state of this DB cluster.

§percent_progress: Option<String>

Specifies the progress of the operation as a percentage.

§earliest_restorable_time: Option<DateTime>

Specifies the earliest time to which a database can be restored with point-in-time restore.

§endpoint: Option<String>

Specifies the connection endpoint for the primary instance of the DB cluster.

§reader_endpoint: Option<String>

The reader endpoint for the DB cluster. The reader endpoint for a DB cluster load-balances connections across the Read Replicas that are available in a DB cluster. As clients request new connections to the reader endpoint, Neptune distributes the connection requests among the Read Replicas in the DB cluster. This functionality can help balance your read workload across multiple Read Replicas in your DB cluster.

If a failover occurs, and the Read Replica that you are connected to is promoted to be the primary instance, your connection is dropped. To continue sending your read workload to other Read Replicas in the cluster, you can then reconnect to the reader endpoint.

§multi_az: Option<bool>

Specifies whether the DB cluster has instances in multiple Availability Zones.

§engine: Option<String>

Provides the name of the database engine to be used for this DB cluster.

§engine_version: Option<String>

Indicates the database engine version.

§latest_restorable_time: Option<DateTime>

Specifies the latest time to which a database can be restored with point-in-time restore.

§port: Option<i32>

Specifies the port that the database engine is listening on.

§master_username: Option<String>

Not supported by Neptune.

§db_cluster_option_group_memberships: Option<Vec<DbClusterOptionGroupStatus>>

Not supported by Neptune.

§preferred_backup_window: Option<String>

Specifies the daily time range during which automated backups are created if automated backups are enabled, as determined by the BackupRetentionPeriod.

§preferred_maintenance_window: Option<String>

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

§replication_source_identifier: Option<String>

Not supported by Neptune.

§read_replica_identifiers: Option<Vec<String>>

Contains one or more identifiers of the Read Replicas associated with this DB cluster.

§db_cluster_members: Option<Vec<DbClusterMember>>

Provides the list of instances that make up the DB cluster.

§vpc_security_groups: Option<Vec<VpcSecurityGroupMembership>>

Provides a list of VPC security groups that the DB cluster belongs to.

§hosted_zone_id: Option<String>

Specifies the ID that Amazon Route 53 assigns when you create a hosted zone.

§storage_encrypted: Option<bool>

Specifies whether the DB cluster is encrypted.

§kms_key_id: Option<String>

If StorageEncrypted is true, the Amazon KMS key identifier for the encrypted DB cluster.

§db_cluster_resource_id: Option<String>

The Amazon Region-unique, immutable identifier for the DB cluster. This identifier is found in Amazon CloudTrail log entries whenever the Amazon KMS key for the DB cluster is accessed.

§db_cluster_arn: Option<String>

The Amazon Resource Name (ARN) for the DB cluster.

§associated_roles: Option<Vec<DbClusterRole>>

Provides a list of the Amazon Identity and Access Management (IAM) roles that are associated with the DB cluster. IAM roles that are associated with a DB cluster grant permission for the DB cluster to access other Amazon services on your behalf.

§iam_database_authentication_enabled: Option<bool>

True if mapping of Amazon Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.

§clone_group_id: Option<String>

Identifies the clone group to which the DB cluster is associated.

§cluster_create_time: Option<DateTime>

Specifies the time when the DB cluster was created, in Universal Coordinated Time (UTC).

§copy_tags_to_snapshot: Option<bool>

If set to true, tags are copied to any snapshot of the DB cluster that is created.

§enabled_cloudwatch_logs_exports: Option<Vec<String>>

A list of the log types that this DB cluster is configured to export to CloudWatch Logs. Valid log types are: audit (to publish audit logs to CloudWatch) and slowquery (to publish slow-query logs to CloudWatch). See Publishing Neptune logs to Amazon CloudWatch logs.

§pending_modified_values: Option<ClusterPendingModifiedValues>

This data type is used as a response element in the ModifyDBCluster operation and contains changes that will be applied during the next maintenance window.

§deletion_protection: Option<bool>

Indicates whether or not the DB cluster has deletion protection enabled. The database can't be deleted when deletion protection is enabled.

§cross_account_clone: Option<bool>

If set to true, the DB cluster can be cloned across accounts.

§automatic_restart_time: Option<DateTime>

Time at which the DB cluster will be automatically restarted.

§serverless_v2_scaling_configuration: Option<ServerlessV2ScalingConfigurationInfo>

Shows the scaling configuration for a Neptune Serverless DB cluster.

For more information, see Using Amazon Neptune Serverless in the Amazon Neptune User Guide.

§global_cluster_identifier: Option<String>

Contains a user-supplied global database cluster identifier. This identifier is the unique key that identifies a global database.

§io_optimized_next_allowed_modification_time: Option<DateTime>

The next time you can modify the DB cluster to use the iopt1 storage type.

§storage_type: Option<String>

The storage type used by the DB cluster.

Valid Values:

  • standard   –   ( the default ) Provides cost-effective database storage for applications with moderate to small I/O usage.

  • iopt1   –   Enables I/O-Optimized storage that's designed to meet the needs of I/O-intensive graph workloads that require predictable pricing with low I/O latency and consistent I/O throughput.

    Neptune I/O-Optimized storage is only available starting with engine release 1.3.0.0.

Implementations§

Source§

impl DbCluster

Source

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

AllocatedStorage always returns 1, because Neptune DB cluster storage size is not fixed, but instead automatically adjusts as needed.

Source

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

Provides the list of EC2 Availability Zones that instances in the DB cluster can be created in.

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

Source

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

Specifies the number of days for which automatic DB snapshots are retained.

Source

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

Not supported by Neptune.

Source

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

Contains the name of the initial database of this DB cluster that was provided at create time, if one was specified when the DB cluster was created. This same name is returned for the life of the DB cluster.

Source

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

Contains a user-supplied DB cluster identifier. This identifier is the unique key that identifies a DB cluster.

Source

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

Specifies the name of the DB cluster parameter group for the DB cluster.

Source

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

Specifies information on the subnet group associated with the DB cluster, including the name, description, and subnets in the subnet group.

Source

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

Specifies the current state of this DB cluster.

Source

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

Specifies the progress of the operation as a percentage.

Source

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

Specifies the earliest time to which a database can be restored with point-in-time restore.

Source

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

Specifies the connection endpoint for the primary instance of the DB cluster.

Source

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

The reader endpoint for the DB cluster. The reader endpoint for a DB cluster load-balances connections across the Read Replicas that are available in a DB cluster. As clients request new connections to the reader endpoint, Neptune distributes the connection requests among the Read Replicas in the DB cluster. This functionality can help balance your read workload across multiple Read Replicas in your DB cluster.

If a failover occurs, and the Read Replica that you are connected to is promoted to be the primary instance, your connection is dropped. To continue sending your read workload to other Read Replicas in the cluster, you can then reconnect to the reader endpoint.

Source

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

Specifies whether the DB cluster has instances in multiple Availability Zones.

Source

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

Provides the name of the database engine to be used for this DB cluster.

Source

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

Indicates the database engine version.

Source

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

Specifies the latest time to which a database can be restored with point-in-time restore.

Source

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

Specifies the port that the database engine is listening on.

Source

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

Not supported by Neptune.

Source

pub fn db_cluster_option_group_memberships( &self, ) -> &[DbClusterOptionGroupStatus]

Not supported by Neptune.

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

Source

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

Specifies the daily time range during which automated backups are created if automated backups are enabled, as determined by the BackupRetentionPeriod.

Source

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

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

Source

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

Not supported by Neptune.

Source

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

Contains one or more identifiers of the Read Replicas associated with this DB 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 .read_replica_identifiers.is_none().

Source

pub fn db_cluster_members(&self) -> &[DbClusterMember]

Provides the list of instances that make up the DB 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 .db_cluster_members.is_none().

Source

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

Provides a list of VPC security groups that the DB cluster belongs to.

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 hosted_zone_id(&self) -> Option<&str>

Specifies the ID that Amazon Route 53 assigns when you create a hosted zone.

Source

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

Specifies whether the DB cluster is encrypted.

Source

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

If StorageEncrypted is true, the Amazon KMS key identifier for the encrypted DB cluster.

Source

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

The Amazon Region-unique, immutable identifier for the DB cluster. This identifier is found in Amazon CloudTrail log entries whenever the Amazon KMS key for the DB cluster is accessed.

Source

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

The Amazon Resource Name (ARN) for the DB cluster.

Source

pub fn associated_roles(&self) -> &[DbClusterRole]

Provides a list of the Amazon Identity and Access Management (IAM) roles that are associated with the DB cluster. IAM roles that are associated with a DB cluster grant permission for the DB cluster to access other Amazon services on your behalf.

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

Source

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

True if mapping of Amazon Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.

Source

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

Identifies the clone group to which the DB cluster is associated.

Source

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

Specifies the time when the DB cluster was created, in Universal Coordinated Time (UTC).

Source

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

If set to true, tags are copied to any snapshot of the DB cluster that is created.

Source

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

A list of the log types that this DB cluster is configured to export to CloudWatch Logs. Valid log types are: audit (to publish audit logs to CloudWatch) and slowquery (to publish slow-query logs to CloudWatch). See Publishing Neptune logs to Amazon CloudWatch logs.

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

Source

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

This data type is used as a response element in the ModifyDBCluster operation and contains changes that will be applied during the next maintenance window.

Source

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

Indicates whether or not the DB cluster has deletion protection enabled. The database can't be deleted when deletion protection is enabled.

Source

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

If set to true, the DB cluster can be cloned across accounts.

Source

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

Time at which the DB cluster will be automatically restarted.

Source

pub fn serverless_v2_scaling_configuration( &self, ) -> Option<&ServerlessV2ScalingConfigurationInfo>

Shows the scaling configuration for a Neptune Serverless DB cluster.

For more information, see Using Amazon Neptune Serverless in the Amazon Neptune User Guide.

Source

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

Contains a user-supplied global database cluster identifier. This identifier is the unique key that identifies a global database.

Source

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

The next time you can modify the DB cluster to use the iopt1 storage type.

Source

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

The storage type used by the DB cluster.

Valid Values:

  • standard   –   ( the default ) Provides cost-effective database storage for applications with moderate to small I/O usage.

  • iopt1   –   Enables I/O-Optimized storage that's designed to meet the needs of I/O-intensive graph workloads that require predictable pricing with low I/O latency and consistent I/O throughput.

    Neptune I/O-Optimized storage is only available starting with engine release 1.3.0.0.

Source§

impl DbCluster

Source

pub fn builder() -> DbClusterBuilder

Creates a new builder-style object to manufacture DbCluster.

Trait Implementations§

Source§

impl Clone for DbCluster

Source§

fn clone(&self) -> DbCluster

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 DbCluster

Source§

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

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

impl PartialEq for DbCluster

Source§

fn eq(&self, other: &DbCluster) -> 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 DbCluster

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