aws-arn: Types and optics for manipulating Amazon Resource Names (ARNs)

[ aws, bsd3, cloud, library ] [ Propose Tags ]

This library provides a type representing Amazon Resource Names (ARNs), and parsing/unparsing functions for them. The provided prisms, when combined with generic-lens or generic-optics, make it very convenient to rewrite parts of ARNs.

Start reading at the Network.AWS.ARN module, which defines the core data type and includes some examples.

The ARN type is not designed to be a 100% correct-by-construction representation of only valid ARNs; it is designed to be a lightweight way to destructure and reassemble ARNs to be used in place of string munging.

The library aims to provide additional parsers for destructuring the "resource" part of an ARN, but many are missing right now. PRs to add this support for more AWS resource types are especially welcome.


[Skip to Readme]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1.0.0, 0.1.0.1, 0.2.0.0, 0.3.0.0, 0.3.1.0, 0.3.2.0
Change log CHANGELOG.md
Dependencies base (>=4.12 && <4.20), deriving-compat (>=0.5.10 && <0.7), hashable (>=1.3.0.0 && <1.6), microlens-pro (>=0.2 && <0.3), profunctors (>=5.0 && <5.7), tagged (>=0.8 && <0.9), text (>=1.2.3 && <1.3 || >=2.0 && <2.2) [details]
License BSD-3-Clause
Copyright Copyright (C) 2020-2022 Bellroy Pty Ltd
Author Bellroy Tech Team <haskell@bellroy.com>
Maintainer Bellroy Tech Team <haskell@bellroy.com>
Category AWS, Cloud
Bug tracker http://github.com/bellroy/aws-arn/issues
Source repo head: git clone https://github.com/bellroy/aws-arn.git
Uploaded by jack at 2024-08-22T03:55:20Z
Distributions NixOS:0.3.1.0
Downloads 653 total (45 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2024-08-22 [all 1 reports]

Readme for aws-arn-0.3.2.0

[back to package description]

aws-arn

CI Status

This library provides a type representing Amazon Resource Names (ARNs), and parsing/unparsing functions for them. When combined with generic-lens or generic-optics, the provided prisms make it very convenient to rewrite parts of ARNs.

Start reading at the Network.AWS.ARN module, which defines the core data type and includes some examples.

The ARN type is not designed to be a 100% correct-by-construction representation of only valid ARNs; it is designed to be a lightweight way to destructure and reassemble ARNs to be used in place of string munging.

The library aims to provide additional parsers for destructuring the "resource" part of an ARN, but many are missing right now. PRs to add this support for more AWS resource types are especially welcome.

Guide: adding a resource

Cribbing from an existing module (e.g., Network.AWS.ARN.Lambda) is probably the easiest way to start, but here is an explicit process to add a new resource:

  1. Create a module for the AWS service, if it doesn't already exist. Example: src/Network/AWS/ARN/Lambda.hs.

  2. Define a record Foo to represent the parsed resource part of an ARN, and derive (at least) Eq, Ord, Hashable, Show and Generic:

    data Function = Function
    { name :: Text,
      qualifier :: Maybe Text
    }
    deriving (Eq, Ord, Hashable, Show, Generic)
    
  3. Define parseFoo and renderFoo functions that attempt to parse and unparse the resource part of the ARN:

    parseFunction :: Text -> Maybe Function
    renderFunction :: Function -> Text
    

    Remark: If you need to write tests for these functions, the corresponding module should live at test/Network/AWS/ARN/SomeAWSService/Test.hs

  4. Define a _Foo Prism' that combines the parsing/unparsing functions above:

    _Function :: Prism' Text Function
    _Function = prism' fromFunction toFunction
    
  5. Add the records, their fields, its parsing/unparsing functions, and prisms to the service module's export list:

    module Network.AWS.ARN.Lambda
      ( -- * Functions
        Function (..),
        parseFunction,
        renderFunction,
    
        -- ** Prisms
        _Function,
      )
    
  6. Test your work and make a PR.

Formatting code

The formatters used in this repo are provided by shell.nix:

Regenerating CI

This repo uses haskell-ci, which is provided by shell.nix:

haskell-ci regenerate

Fixing CI not being able to install tools

So you ran the above command but haskell-ci couldn't install one of its tools (e.g. hlint, doctest) due to version incompatibilities. haskell-ci selects particular versions by default, but this can be changed with command line flags (e.g. --hlint-version '>=3.5 && <3.6', --doctest-version ==0.20.1). If you do this, please check haskell-ci; if the HEAD version does not select the latest version of a tool, please contribute a PR to that repository.