Struct aws_sdk_dynamodb::types::TableDescription
source · #[non_exhaustive]pub struct TableDescription {Show 24 fields
pub attribute_definitions: Option<Vec<AttributeDefinition>>,
pub table_name: Option<String>,
pub key_schema: Option<Vec<KeySchemaElement>>,
pub table_status: Option<TableStatus>,
pub creation_date_time: Option<DateTime>,
pub provisioned_throughput: Option<ProvisionedThroughputDescription>,
pub table_size_bytes: Option<i64>,
pub item_count: Option<i64>,
pub table_arn: Option<String>,
pub table_id: Option<String>,
pub billing_mode_summary: Option<BillingModeSummary>,
pub local_secondary_indexes: Option<Vec<LocalSecondaryIndexDescription>>,
pub global_secondary_indexes: Option<Vec<GlobalSecondaryIndexDescription>>,
pub stream_specification: Option<StreamSpecification>,
pub latest_stream_label: Option<String>,
pub latest_stream_arn: Option<String>,
pub global_table_version: Option<String>,
pub replicas: Option<Vec<ReplicaDescription>>,
pub restore_summary: Option<RestoreSummary>,
pub sse_description: Option<SseDescription>,
pub archival_summary: Option<ArchivalSummary>,
pub table_class_summary: Option<TableClassSummary>,
pub deletion_protection_enabled: Option<bool>,
pub on_demand_throughput: Option<OnDemandThroughput>,
}
Expand description
Represents the properties of a table.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. }
syntax; cannot be matched against without a wildcard ..
; and struct update syntax will not work.attribute_definitions: Option<Vec<AttributeDefinition>>
An array of AttributeDefinition
objects. Each of these objects describes one attribute in the table and index key schema.
Each AttributeDefinition
object in this array is composed of:
-
AttributeName
- The name of the attribute. -
AttributeType
- The data type for the attribute.
table_name: Option<String>
The name of the table.
key_schema: Option<Vec<KeySchemaElement>>
The primary key structure for the table. Each KeySchemaElement
consists of:
-
AttributeName
- The name of the attribute. -
KeyType
- The role of the attribute:-
HASH
- partition key -
RANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values.
The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
-
For more information about primary keys, see Primary Key in the Amazon DynamoDB Developer Guide.
table_status: Option<TableStatus>
The current state of the table:
-
CREATING
- The table is being created. -
UPDATING
- The table/index configuration is being updated. The table/index remains available for data operations whenUPDATING
. -
DELETING
- The table is being deleted. -
ACTIVE
- The table is ready for use. -
INACCESSIBLE_ENCRYPTION_CREDENTIALS
- The KMS key used to encrypt the table in inaccessible. Table operations may fail due to failure to use the KMS key. DynamoDB will initiate the table archival process when a table's KMS key remains inaccessible for more than seven days. -
ARCHIVING
- The table is being archived. Operations are not allowed until archival is complete. -
ARCHIVED
- The table has been archived. See the ArchivalReason for more information.
creation_date_time: Option<DateTime>
The date and time when the table was created, in UNIX epoch time format.
provisioned_throughput: Option<ProvisionedThroughputDescription>
The provisioned throughput settings for the table, consisting of read and write capacity units, along with data about increases and decreases.
table_size_bytes: Option<i64>
The total size of the specified table, in bytes. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value.
item_count: Option<i64>
The number of items in the specified table. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value.
table_arn: Option<String>
The Amazon Resource Name (ARN) that uniquely identifies the table.
table_id: Option<String>
Unique identifier for the table for which the backup was created.
billing_mode_summary: Option<BillingModeSummary>
Contains the details for the read/write capacity mode.
local_secondary_indexes: Option<Vec<LocalSecondaryIndexDescription>>
Represents one or more local secondary indexes on the table. Each index is scoped to a given partition key value. Tables with one or more local secondary indexes are subject to an item collection size limit, where the amount of data within a given item collection cannot exceed 10 GB. Each element is composed of:
-
IndexName
- The name of the local secondary index. -
KeySchema
- Specifies the complete index key schema. The attribute names in the key schema must be between 1 and 255 characters (inclusive). The key schema must begin with the same partition key as the table. -
Projection
- Specifies attributes that are copied (projected) from the table into the index. These are in addition to the primary key attributes and index key attributes, which are automatically projected. Each attribute specification is composed of:-
ProjectionType
- One of the following:-
KEYS_ONLY
- Only the index and primary keys are projected into the index. -
INCLUDE
- Only the specified table attributes are projected into the index. The list of projected attributes is inNonKeyAttributes
. -
ALL
- All of the table attributes are projected into the index.
-
-
NonKeyAttributes
- A list of one or more non-key attribute names that are projected into the secondary index. The total count of attributes provided inNonKeyAttributes
, summed across all of the secondary indexes, must not exceed 100. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total.
-
-
IndexSizeBytes
- Represents the total size of the index, in bytes. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value. -
ItemCount
- Represents the number of items in the index. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value.
If the table is in the DELETING
state, no information about indexes will be returned.
global_secondary_indexes: Option<Vec<GlobalSecondaryIndexDescription>>
The global secondary indexes, if any, on the table. Each index is scoped to a given partition key value. Each element is composed of:
-
Backfilling
- If true, then the index is currently in the backfilling phase. Backfilling occurs only when a new global secondary index is added to the table. It is the process by which DynamoDB populates the new index with data from the table. (This attribute does not appear for indexes that were created during aCreateTable
operation.)You can delete an index that is being created during the
Backfilling
phase whenIndexStatus
is set to CREATING andBackfilling
is true. You can't delete the index that is being created whenIndexStatus
is set to CREATING andBackfilling
is false. (This attribute does not appear for indexes that were created during aCreateTable
operation.) -
IndexName
- The name of the global secondary index. -
IndexSizeBytes
- The total size of the global secondary index, in bytes. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value. -
IndexStatus
- The current status of the global secondary index:-
CREATING
- The index is being created. -
UPDATING
- The index is being updated. -
DELETING
- The index is being deleted. -
ACTIVE
- The index is ready for use.
-
-
ItemCount
- The number of items in the global secondary index. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value. -
KeySchema
- Specifies the complete index key schema. The attribute names in the key schema must be between 1 and 255 characters (inclusive). The key schema must begin with the same partition key as the table. -
Projection
- Specifies attributes that are copied (projected) from the table into the index. These are in addition to the primary key attributes and index key attributes, which are automatically projected. Each attribute specification is composed of:-
ProjectionType
- One of the following:-
KEYS_ONLY
- Only the index and primary keys are projected into the index. -
INCLUDE
- In addition to the attributes described inKEYS_ONLY
, the secondary index will include other non-key attributes that you specify. -
ALL
- All of the table attributes are projected into the index.
-
-
NonKeyAttributes
- A list of one or more non-key attribute names that are projected into the secondary index. The total count of attributes provided inNonKeyAttributes
, summed across all of the secondary indexes, must not exceed 100. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total.
-
-
ProvisionedThroughput
- The provisioned throughput settings for the global secondary index, consisting of read and write capacity units, along with data about increases and decreases.
If the table is in the DELETING
state, no information about indexes will be returned.
stream_specification: Option<StreamSpecification>
The current DynamoDB Streams configuration for the table.
latest_stream_label: Option<String>
A timestamp, in ISO 8601 format, for this stream.
Note that LatestStreamLabel
is not a unique identifier for the stream, because it is possible that a stream from another table might have the same timestamp. However, the combination of the following three elements is guaranteed to be unique:
-
Amazon Web Services customer ID
-
Table name
-
StreamLabel
latest_stream_arn: Option<String>
The Amazon Resource Name (ARN) that uniquely identifies the latest stream for this table.
global_table_version: Option<String>
Represents the version of global tables in use, if the table is replicated across Amazon Web Services Regions.
replicas: Option<Vec<ReplicaDescription>>
Represents replicas of the table.
restore_summary: Option<RestoreSummary>
Contains details for the restore.
sse_description: Option<SseDescription>
The description of the server-side encryption status on the specified table.
archival_summary: Option<ArchivalSummary>
Contains information about the table archive.
table_class_summary: Option<TableClassSummary>
Contains details of the table class.
deletion_protection_enabled: Option<bool>
Indicates whether deletion protection is enabled (true) or disabled (false) on the table.
on_demand_throughput: Option<OnDemandThroughput>
The maximum number of read and write units for the specified on-demand table. If you use this parameter, you must specify MaxReadRequestUnits
, MaxWriteRequestUnits
, or both.
Implementations§
source§impl TableDescription
impl TableDescription
sourcepub fn attribute_definitions(&self) -> &[AttributeDefinition]
pub fn attribute_definitions(&self) -> &[AttributeDefinition]
An array of AttributeDefinition
objects. Each of these objects describes one attribute in the table and index key schema.
Each AttributeDefinition
object in this array is composed of:
-
AttributeName
- The name of the attribute. -
AttributeType
- The data type for the attribute.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .attribute_definitions.is_none()
.
sourcepub fn table_name(&self) -> Option<&str>
pub fn table_name(&self) -> Option<&str>
The name of the table.
sourcepub fn key_schema(&self) -> &[KeySchemaElement]
pub fn key_schema(&self) -> &[KeySchemaElement]
The primary key structure for the table. Each KeySchemaElement
consists of:
-
AttributeName
- The name of the attribute. -
KeyType
- The role of the attribute:-
HASH
- partition key -
RANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values.
The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
-
For more information about primary keys, see Primary Key in the Amazon DynamoDB Developer Guide.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .key_schema.is_none()
.
sourcepub fn table_status(&self) -> Option<&TableStatus>
pub fn table_status(&self) -> Option<&TableStatus>
The current state of the table:
-
CREATING
- The table is being created. -
UPDATING
- The table/index configuration is being updated. The table/index remains available for data operations whenUPDATING
. -
DELETING
- The table is being deleted. -
ACTIVE
- The table is ready for use. -
INACCESSIBLE_ENCRYPTION_CREDENTIALS
- The KMS key used to encrypt the table in inaccessible. Table operations may fail due to failure to use the KMS key. DynamoDB will initiate the table archival process when a table's KMS key remains inaccessible for more than seven days. -
ARCHIVING
- The table is being archived. Operations are not allowed until archival is complete. -
ARCHIVED
- The table has been archived. See the ArchivalReason for more information.
sourcepub fn creation_date_time(&self) -> Option<&DateTime>
pub fn creation_date_time(&self) -> Option<&DateTime>
The date and time when the table was created, in UNIX epoch time format.
sourcepub fn provisioned_throughput(
&self,
) -> Option<&ProvisionedThroughputDescription>
pub fn provisioned_throughput( &self, ) -> Option<&ProvisionedThroughputDescription>
The provisioned throughput settings for the table, consisting of read and write capacity units, along with data about increases and decreases.
sourcepub fn table_size_bytes(&self) -> Option<i64>
pub fn table_size_bytes(&self) -> Option<i64>
The total size of the specified table, in bytes. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value.
sourcepub fn item_count(&self) -> Option<i64>
pub fn item_count(&self) -> Option<i64>
The number of items in the specified table. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value.
sourcepub fn table_arn(&self) -> Option<&str>
pub fn table_arn(&self) -> Option<&str>
The Amazon Resource Name (ARN) that uniquely identifies the table.
sourcepub fn table_id(&self) -> Option<&str>
pub fn table_id(&self) -> Option<&str>
Unique identifier for the table for which the backup was created.
sourcepub fn billing_mode_summary(&self) -> Option<&BillingModeSummary>
pub fn billing_mode_summary(&self) -> Option<&BillingModeSummary>
Contains the details for the read/write capacity mode.
sourcepub fn local_secondary_indexes(&self) -> &[LocalSecondaryIndexDescription]
pub fn local_secondary_indexes(&self) -> &[LocalSecondaryIndexDescription]
Represents one or more local secondary indexes on the table. Each index is scoped to a given partition key value. Tables with one or more local secondary indexes are subject to an item collection size limit, where the amount of data within a given item collection cannot exceed 10 GB. Each element is composed of:
-
IndexName
- The name of the local secondary index. -
KeySchema
- Specifies the complete index key schema. The attribute names in the key schema must be between 1 and 255 characters (inclusive). The key schema must begin with the same partition key as the table. -
Projection
- Specifies attributes that are copied (projected) from the table into the index. These are in addition to the primary key attributes and index key attributes, which are automatically projected. Each attribute specification is composed of:-
ProjectionType
- One of the following:-
KEYS_ONLY
- Only the index and primary keys are projected into the index. -
INCLUDE
- Only the specified table attributes are projected into the index. The list of projected attributes is inNonKeyAttributes
. -
ALL
- All of the table attributes are projected into the index.
-
-
NonKeyAttributes
- A list of one or more non-key attribute names that are projected into the secondary index. The total count of attributes provided inNonKeyAttributes
, summed across all of the secondary indexes, must not exceed 100. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total.
-
-
IndexSizeBytes
- Represents the total size of the index, in bytes. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value. -
ItemCount
- Represents the number of items in the index. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value.
If the table is in the DELETING
state, no information about indexes will be returned.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .local_secondary_indexes.is_none()
.
sourcepub fn global_secondary_indexes(&self) -> &[GlobalSecondaryIndexDescription]
pub fn global_secondary_indexes(&self) -> &[GlobalSecondaryIndexDescription]
The global secondary indexes, if any, on the table. Each index is scoped to a given partition key value. Each element is composed of:
-
Backfilling
- If true, then the index is currently in the backfilling phase. Backfilling occurs only when a new global secondary index is added to the table. It is the process by which DynamoDB populates the new index with data from the table. (This attribute does not appear for indexes that were created during aCreateTable
operation.)You can delete an index that is being created during the
Backfilling
phase whenIndexStatus
is set to CREATING andBackfilling
is true. You can't delete the index that is being created whenIndexStatus
is set to CREATING andBackfilling
is false. (This attribute does not appear for indexes that were created during aCreateTable
operation.) -
IndexName
- The name of the global secondary index. -
IndexSizeBytes
- The total size of the global secondary index, in bytes. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value. -
IndexStatus
- The current status of the global secondary index:-
CREATING
- The index is being created. -
UPDATING
- The index is being updated. -
DELETING
- The index is being deleted. -
ACTIVE
- The index is ready for use.
-
-
ItemCount
- The number of items in the global secondary index. DynamoDB updates this value approximately every six hours. Recent changes might not be reflected in this value. -
KeySchema
- Specifies the complete index key schema. The attribute names in the key schema must be between 1 and 255 characters (inclusive). The key schema must begin with the same partition key as the table. -
Projection
- Specifies attributes that are copied (projected) from the table into the index. These are in addition to the primary key attributes and index key attributes, which are automatically projected. Each attribute specification is composed of:-
ProjectionType
- One of the following:-
KEYS_ONLY
- Only the index and primary keys are projected into the index. -
INCLUDE
- In addition to the attributes described inKEYS_ONLY
, the secondary index will include other non-key attributes that you specify. -
ALL
- All of the table attributes are projected into the index.
-
-
NonKeyAttributes
- A list of one or more non-key attribute names that are projected into the secondary index. The total count of attributes provided inNonKeyAttributes
, summed across all of the secondary indexes, must not exceed 100. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total.
-
-
ProvisionedThroughput
- The provisioned throughput settings for the global secondary index, consisting of read and write capacity units, along with data about increases and decreases.
If the table is in the DELETING
state, no information about indexes will be returned.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .global_secondary_indexes.is_none()
.
sourcepub fn stream_specification(&self) -> Option<&StreamSpecification>
pub fn stream_specification(&self) -> Option<&StreamSpecification>
The current DynamoDB Streams configuration for the table.
sourcepub fn latest_stream_label(&self) -> Option<&str>
pub fn latest_stream_label(&self) -> Option<&str>
A timestamp, in ISO 8601 format, for this stream.
Note that LatestStreamLabel
is not a unique identifier for the stream, because it is possible that a stream from another table might have the same timestamp. However, the combination of the following three elements is guaranteed to be unique:
-
Amazon Web Services customer ID
-
Table name
-
StreamLabel
sourcepub fn latest_stream_arn(&self) -> Option<&str>
pub fn latest_stream_arn(&self) -> Option<&str>
The Amazon Resource Name (ARN) that uniquely identifies the latest stream for this table.
sourcepub fn global_table_version(&self) -> Option<&str>
pub fn global_table_version(&self) -> Option<&str>
Represents the version of global tables in use, if the table is replicated across Amazon Web Services Regions.
sourcepub fn replicas(&self) -> &[ReplicaDescription]
pub fn replicas(&self) -> &[ReplicaDescription]
Represents replicas of the table.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .replicas.is_none()
.
sourcepub fn restore_summary(&self) -> Option<&RestoreSummary>
pub fn restore_summary(&self) -> Option<&RestoreSummary>
Contains details for the restore.
sourcepub fn sse_description(&self) -> Option<&SseDescription>
pub fn sse_description(&self) -> Option<&SseDescription>
The description of the server-side encryption status on the specified table.
sourcepub fn archival_summary(&self) -> Option<&ArchivalSummary>
pub fn archival_summary(&self) -> Option<&ArchivalSummary>
Contains information about the table archive.
sourcepub fn table_class_summary(&self) -> Option<&TableClassSummary>
pub fn table_class_summary(&self) -> Option<&TableClassSummary>
Contains details of the table class.
sourcepub fn deletion_protection_enabled(&self) -> Option<bool>
pub fn deletion_protection_enabled(&self) -> Option<bool>
Indicates whether deletion protection is enabled (true) or disabled (false) on the table.
sourcepub fn on_demand_throughput(&self) -> Option<&OnDemandThroughput>
pub fn on_demand_throughput(&self) -> Option<&OnDemandThroughput>
The maximum number of read and write units for the specified on-demand table. If you use this parameter, you must specify MaxReadRequestUnits
, MaxWriteRequestUnits
, or both.
source§impl TableDescription
impl TableDescription
sourcepub fn builder() -> TableDescriptionBuilder
pub fn builder() -> TableDescriptionBuilder
Creates a new builder-style object to manufacture TableDescription
.
Trait Implementations§
source§impl Clone for TableDescription
impl Clone for TableDescription
source§fn clone(&self) -> TableDescription
fn clone(&self) -> TableDescription
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for TableDescription
impl Debug for TableDescription
source§impl PartialEq for TableDescription
impl PartialEq for TableDescription
source§fn eq(&self, other: &TableDescription) -> bool
fn eq(&self, other: &TableDescription) -> bool
self
and other
values to be equal, and is used
by ==
.impl StructuralPartialEq for TableDescription
Auto Trait Implementations§
impl Freeze for TableDescription
impl RefUnwindSafe for TableDescription
impl Send for TableDescription
impl Sync for TableDescription
impl Unpin for TableDescription
impl UnwindSafe for TableDescription
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§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§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 more§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
§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();
§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
§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();
§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
§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();
§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
§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();
§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.§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);