Metadata-Version: 1.1
Name: awsie
Version: 0.0.2
Summary: CloudFormation aware aws cli wrapper.
Home-page: https://github.com/flomotlik/awsie
Author: Florian Motlik
Author-email: flo@flomotlik.me
License: MIT
Description: AWSIE
        =====
        
        pronounced /ˈɒzi/ oz-ee like our great friends from down under.
        
        AWSIE is a CloudFormation aware wrapper on top of the AWS cli. It help
        you to call an awscli command, but instead of the actual physical ID of
        the resource you set the logical CloudFormation template id which will
        be replaced then.
        
        For many different resources AWS can automatically set a random name
        when creating the resource through Cloudformation. While this has a big
        upside with resources not clashing when the same stack gets deployed
        multipe times, a downside is that running a command against a specific
        resource means you have to write lookup code or use the resource name by
        hand.
        
        Awsie helps you to do that lookup and call the awscli without any
        potential for clashes.
        
        Installation
        ------------
        
        awsie can be installed through pip:
        
        .. code:: shell
        
            pip install awsie
        
        Alternatively you can clone this repository and run
        
        .. code:: shell
        
            python setup.py install
        
        Quick example
        -------------
        
        For example when you deploy a CloudFormation stack:
        
        .. code:: json
        
            {
                "Resources": {
                    "DeploymentBucket": {
                        "Type": "AWS::S3::Bucket"
                    }
                }
            }
        
        and then want to list the content of the bucket you can use ``awsie``:
        
        .. code:: shell
        
            awsie example-stack s3 ls s3://cf:DeploymentBucket: --region us-west-1
        
        which will replace ``cf:DeploymentBucket:`` with the actual name of the
        resource and run the awscli with all arguments you passed to awsie,
        except for the stack-name (which has to be the first argument):
        
        .. code:: shell
        
            aws s3 ls s3://formica-example-stack-deploymentbucket-1jjzisylxreh9 --region us-west-1
        
        Replacement syntax
        ------------------
        
        The replacement syntax is ``cf:LOGICAL_ID:`` and will replace
        LOGICAL\_ID with the PhysicalId of the resource through the data
        returned from list-stack-resources.
        
        Options
        -------
        
        ``awsie STACK_NAME``
        
        -  ``stack`` Has to be the first positional argument and will be removed
           from call to the AWS cli.
        -  ``--profile PROFILE`` The AWS profile to use for the CloudFormation
           lookup, will be passed to the aws cli.
        -  ``--region REGION`` The AWS region to use for the CloudFormation
           lookup, will be passed to the aws cli.
        
        
Keywords: aws,cloud,awscli
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Topic :: Utilities
Classifier: License :: Public Domain
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
