Support roles with paths in them

[ryanjfrizzell]

• support AWS paths in role names
  • reference: here
• adjust RegEx to allow for this
• minor docs updates for new home
• minor version bump

small example of this working

from collections import namedtuple
import re

ROLE_ARN_REGEXP = re.compile(r"^arn:aws:iam::([0-9]{12}):role/([\w+=,.@-]+.*$)")
ParseResult = namedtuple("ArnParts", ["aws_account_id", "aws_role"])
normal = 'arn:aws:iam::584999999999:role/superNeatRole'
slashes = 'arn:aws:iam::584999999999:role/some/other/role/withSlashes'
def parse_arn(role_arn):
    return ParseResult(*ROLE_ARN_REGEXP.match(role_arn).groups())
print(type(ROLE_ARN_REGEXP))

print("###Normal")
normal_res = parse_arn(normal)
print(normal_res)

print("####Slashes")
slashes_res = parse_arn(slashes)
print(slashes_res)

output:

###Normal
ArnParts(aws_account_id='584999999999', aws_role='superNeatRole')
####Slashes
ArnParts(aws_account_id='584999999999', aws_role='some/other/role/withSlashes')

[ionosphere80]

LGTM.