4 releases (2 breaking)
0.3.0 | Sep 22, 2024 |
---|---|
0.2.1 | Sep 22, 2024 |
0.2.0 | Sep 22, 2024 |
0.1.0 | Sep 17, 2024 |
#666 in Network programming
299 downloads per month
73KB
1.5K
SLoC
aws_config_mod
aws_config_mod
A missing piece of the Rust AWS SDK. A current missing feature of the SDK is the ability to read and modify AWS config files programatically, such as what we can do with the set command: https://docs.aws.amazon.com/cli/latest/reference/configure/set.html
The goal of this library is allowing you to add, modify, and remove AWS CLI configuration settings for existing configuration files to to generate new ones while any existing whitespace or comments in the original file.
This crate is still a work-in-progress, so if there are any features that you need right away, please open an issue and they will be prioritized.
Usage
// Assuming you already read the configuration file to a string
let config_content = r#"
[profile A]
credential_source = Ec2InstanceMetadata
endpoint_url = https://profile-a-endpoint.aws/
[profile B]
source_profile = A
role_arn = arn:aws:iam::123456789012:role/roleB
services = profileB
[services profileB]
ec2 =
endpoint_url = https://profile-b-ec2-endpoint.aws"#;
let mut config = AwsConfigFile::parse(SAMPLE_FILE).expect("Sample file should be valid");
let setting_path = SettingPath::try_from("profile.A.credential_source").expect("Should parse");
config.set(setting_path, Value::from("my-new-credential-source"));
let stringified = config.to_string();
// Write the content back to your file
TODOs
- improved error messages
- automatic config file loading via standard aws config locations and environment variables
- detect and match formatting
- set formatting
- utilize aws types
License: MIT OR Apache-2.0
Dependencies
~1–1.7MB
~35K SLoC