Struct DynamodbConnector

pub struct DynamodbConnector { /* private fields */ }

Provides a connection to DynamoDB, potentially managing test table lifecycles.

This struct encapsulates an AWS DynamoDB client (aws_sdk_dynamodb::Client). If configured with table definitions and a local endpoint in TableConfig, it will create uniquely named tables upon construction.

If the test_utils feature is enabled and delete_on_exit is true in the configuration, the created tables will be automatically deleted when this connector is dropped.

Implementations

impl DynamodbConnector

pub async fn load(config_path: impl AsRef<Path>) -> Result<Self>

Creates a new connector by loading configuration from a YAML file.

See TableConfig::load_from_file and DynamodbConnector::try_new.

Errors

Returns Err if loading the config file fails or if creating the connector fails (e.g., table creation fails, AWS configuration error).

pub fn client(&self) -> Result<&Client>

Returns a reference to the underlying aws_sdk_dynamodb::Client.

Errors

Returns Err (DynamoToolsError::Internal) if the client has already been taken (e.g., after Drop has started).

pub fn get_created_table_name(&self, base_name: &str) -> Option<&str>

Returns the unique name of a table created by this connector, given its base name.

The base_name corresponds to the table_name field within [TableInfo] in the configuration.

pub fn get_all_created_table_names(&self) -> &HashMap<String, String>

Returns a map of all tables created by this connector. Keys are the base names from the config, values are the unique created names.

pub async fn try_new(config: TableConfig) -> Result<Self>

Creates a new connector based on the provided TableConfig.

• Sets up AWS SDK configuration.
• Creates a aws_sdk_dynamodb::Client.
• Iterates through config.tables. For each TableInfo:
  • Attempts to create a DynamoDB table with a unique name derived from TableInfo.table_name.
  • Stores the mapping from the base name to the unique name.

Errors

Returns Err if AWS config fails, client creation fails, or any table creation fails.

Trait Implementations

impl Debug for DynamodbConnector

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

Formats the value using the given formatter.