Metadata-Version: 1.1
Name: awsh
Version: 1.0.9
Summary: SSH into your EC2 instances based on their configurations.
Home-page: https://github.com/j-martin/awsh
Author: Jean-Martin Archer
Author-email: pypi@jmartin.ca
License: UNKNOWN
Download-URL: https://github.com/j-martin/awsh/archive/1.0.9.tar.gz
Description: awsh
        ----
        
        Another SSH utility for AWS
        
        Installation
        ------------
        
        ::
        
            $ pip install awsh
        
        If you never configured awscli before.
        
        ::
        
            $ aws configure
        
        Alternatively it can be downloaded on
        `pypi <https://pypi.python.org/pypi/awsh>`__.
        
        Requirements
        ------------
        
        -  Python 2 or 3
        
        What does it do?
        ----------------
        
        It gives you a list of hosts you have access to and preconfigure ``ssh``
        with the proper key and user (assuming they have not been overridden by
        a configuration management tool). You can filter by instance name and if
        it matches only one instance it will log to it.
        
        Use Cases
        ---------
        
        -  You are running Elasticbeanstalk, EMR or something that creates it's
           own instance automatically.
        -  You are using different key-set for different instances and you can't
           remember which one does what.
        -  Instances are coming and going and you lost track of what is
           available.
        
        Usage
        -----
        
        ::
        
            awsh -h
            usage: awsh [-h] [--users USERS [USERS ...]] [--region REGION] [-i KEY_PATH]
                        [-c COMMAND] [--keys KEYS] [--timeout TIMEOUT] [--version]
                        [filter]
        
            SSH into AWS instances. the default Assumes that everything runs on Ubuntu and
            or Amazon's AMIs. ex: "awsh --users user1 user2 --region us-west-2 --keys
            '~/.keys' instance-name". Note that "awsh --users user1 user2 instance-name"
            will not be parsed properly due to the nature of nargs. In that case you may
            want to do: "awsh instance-name --users user1 user2".
        
            positional arguments:
              filter                Optional name filter. If only one instance is found,
                                    it will connect to it directly.
        
            optional arguments:
              -h, --help            show this help message and exit
              --users USERS [USERS ...]
                                    Specify the users to try.
              --region REGION       Specify the aws region.
              -i KEY_PATH           Specific key path, overrides, --keys
              -c COMMAND            Translates to ssh -C
              --keys KEYS           Directory of the private keys.
              --timeout TIMEOUT     SSH connection timeout.
              --version             Returns awsh's version.
        
Keywords: tool,aws,ec2
Platform: UNKNOWN
