aws-chain-secrets 1.0.0

This aims to enable the use of one or more secrets from AWS SecretsManager.

This package aims to make using AWS SecretsManager more comfortable.

Introduce

This aims to enable the use of one or more secrets from AWS SecretsManager.

If more than one secret is used, the secret specified last takes precedence.

For example, if you use secrets named A and B in that order, overlapping entries from A and B will later use the value of the specified B entry.

>>> A = {"foo": 1, "bar": 2}
>>> B = {"bar": 3}
>>> secrets("bar", casting_type=int)
3

Install

$ python -m pip install aws_chain_secrets

How to use

Note

AWS credential is required.

If your credentials installed or set to environment, you can omit credentials when initialize SecretsManager.

connect and fetch manually

from aws_chain_secrets import SecretsManager
secrets = SecretsManager('ap-northeast-2', 'secret_name_1', 'secret_name_2', ...)
secrets.connect()
secrets.fetch()
secrets(key="A", default=None, casting_type=int)
secrets.disconnect()

Note

The secret assigned last takes precedence over secrets assigned earlier.

In this case, secret_name_2 has a higher priority than secret_name_1.

This works likes dict.update (secret_name_1.update(secret_name_2)).

use with context manager

You can omit connect(), fetch() and disconnect() when using context manager.

from aws_chain_secrets import SecretsManager
with SecretsManager('ap-northeast-2', 'secret_name_1', 'secret_name_2', ...) as secrets:
    secrets(key="A", default=None, casting_type=int)

type casting

All secret values ​​retrieved from AWS SecretsManager are string types by default.

You can change it to any type you want.

>>> secrets(key="A", casting_type=int)
1
>>> secrets(key="SOME_ARRAY", casting_type=list)
['1', '2', '3', '4']
>>> secrets(key="SOME_ARRAY", casting_type=list[int])
[1, 2, 3, 4]

default value

You can specify a default value, just like when using Python dict’s get.

# if the key value of A does not exist, 0 specified as default is returned.
>>> secrets(key="A", default=0)
0

change value

You can change (or add) the value of a specified secret by name.

>>> secrets.set('secret_name_1', 'key', 'value')

update remote (AWS secrets manager) data from local

You can update (upload) the values of a specified secret by name from local to remote.

>>> secrets.update('secret_name_1')