Metadata-Version: 2.0
Name: awsparams
Version: 0.9.0
Summary: A simple CLI for adding/removing/renaming/copying AWS Param Store Parameters
Home-page: https://github.com/byu-oit/awsparams
Author: BYU OIT Application Development
Author-email: it@byu.edu
License: Apache 2
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Natural Language :: English
Classifier: Topic :: Utilities
Requires-Dist: boto3
Requires-Dist: fire

Why this script?
================

The current (Jul 2017) AWS Console for the Systems Manager Parameter Store is good for 
adding and editing the values of parameters, but misses key productivity functions like
copying (especially en mass), renaming, etc.  The current ``aws ssm`` CLI is very 
similar in functionality to the AWS Console.

This script is to automate a lot of the manual work currently needed with the existing
AWS-provided UIs.

Usage
=====

ls usage
--------

ls names only

``python awsparams.py ls``

ls with values no decryption

``python awsparams.py ls --values=True``

ls with values and decryption

``python awsparams.py ls --values=True --with-decryption=True``

ls by prefix

``python awsparams.py ls --prefix=appname.prd``

new usage
---------

new interactively

``python awsparams.py new``

new semi-interactively

``python awsparams.py new appname.prd.username``

new non-interactive

``python awsparams.py new appname.prd.usrname parameter_value parameter_descripton``

cp usage
--------

copy a parameter

``python awsparams.py cp appname.prd.username newappname.prd.username``

copy set of parameters with prefix appname.dev. to appname.prd.

``python awsparams.py cp appname.dev. appname.prd. --prefix=True``

copy set of parameters starting with pattern repometa-generator.prd
overwrite existing parameters accross different accounts

``python awsparams.py cp repometa-generator.prd --src_profile=dev --dst_profile=trn --prefix=True``

copy single parameters or list of specific parameters accross different
accounts

``python awsparams.py cp  appname.dev.username appname.trb.username --src_profile=dev --dst_profile=trn``

mv usage
--------

rename/move a parameter

``python awsparams.py mv appname.dev.username appname.prd.username``

rename/move all parameters with a prefix changing only the prefix

``python awsparams.py mv appname.dev appname.prd --prefix=True``

