Crate aws-arn
Provides types, builders, and other helpers to manipulate AWS Amazon Resource Name (ARN) strings.
The ARN is a key component of all AWS service APIs and yet nearly all client toolkits treat it simply as a string. While this may be a reasonable and expedient decision, it seems there might be a need to not only ensure correctness of ARNs with validators but also constructors that allow making these strings correclt in the first place.
This crate provides three levels of ARN manipulation, the first is the direct construction of an ARN type (module aws_arn
- the core Resource
and ARN
types).
let arn = ARN
Or, alternatively using FromStr
you can parse a string into an ARN.
let arn: ARN = "arn:aws:s3:::mythings/thing-1".parse.expect;
The next is to use a more readable builder which also allows you to ignore those fields in the ARN you don't always need (module aws_arn::builder
- the ResourceBuilder
and ArnBuilder
types providing a more fluent style of ARN construction).
let arn = new
.resource
.in_partition
.build;
Finally, it is possible to use resource-type specific functions that allow an even more direct and simple construction (module aws_arn::builder::{service}
- service builder functions.
let arn = object;
Features
This crate has attempted to be as lean as possible, with a really minimal set of dependencies, we have include the following as features.
serde_support
derivesSerialize
andDeserialize
for theARN
andResource
types.ext_validation
adds extended, service specific, validation using an external configuration file.
Changes
Version 0.1.1
- Documentation additions and fixes, in both README and Rustdoc.
- Renamed service builder functions, added a parent/child pattern for s3.
- Added Serde feature.
- Made external validation optional.
Version 0.1.0
- Initial commit.
- Provides basic ARN type with
Display
andFromStr
. - Provides scaffolding for service-specific validation.
- Provides initial set of service builder,
make_{format}
, functions for ARN construction.
TODO
- More tests!
- More service formats for validation.
- More service builder functions.