Metadata-Version: 2.1
Name: ssh-aws
Version: 1.0.7
Summary: SSH into your EC2 instances.
Home-page: https://gitlab.com/franciscogd/awssh
Author: Francisco Duran
Author-email: franciscogd@gatech.edu
License: UNKNOWN
Download-URL: https://gitlab.com/franciscogd/awssh/archive/1.0.7.tar.gz
Description: awssh
        ----------------
        
        SSH boto3 utility for AWS
        
        Installation
        ----------------
        
            $ aws configure
            $ pip install ssh-aws # or pip install --user ssh-aws
        
        **Note**: The `awssh` utility is installed in `$HOME/Library/Python/2.7/bin` which may not be on PATH. 
        Consider adding this directory to PATH.
        
        Requirements
        ----------------
        
        - Python 2.7
        
        
        Features
        ----------------
        
        The `awssh` utility gives you a list of hosts you have access to and preconfigures `ssh` with the proper key and user. 
        You can filter by instance name. If it matches only one instance you will be logged into it. 
        This utility also allows local and remote port forwarding for SSH tunneling (e.g. `ssh -L 9000:imgur.com:80 user@ip_address`).
        
        Usage
        -----
        
        ```
        usage: awsh [-h] [--region REGION] [--users USERS [USERS ...]]
                           [-i KEY_PATH] [-c COMMAND] [-r REMOTE_HOST]
                           [-p REMOTE_PORT] [-l LOCAL_PORT] [--keys KEYS]
                           [--timeout TIMEOUT] [--console-output] [--version]
                           [instance name key word]
        
        SSH into AWS instances. The default user list assumes that your user is centos, ubuntu, or ec2-user. 
        
        positional arguments:
          filter                Optional instance name or key word as filter. If only one instance is found,
                                it will connect to it directly.
        
        optional arguments:
          -h, --help            Show usage message and exit.
          --users USERS [USERS ...]
                                Users to try (centos, ubuntu, and ec2-user are defaults).
          --region REGION       AWS region (us-east-2 by default)..
          -i KEY_PATH, --key-path KEY_PATH
                                Specific key path, overrides, --keys
          -c COMMAND, --command COMMAND
                                Translates to ssh -C
          -r REMOTE_HOST, --remote-host REMOTE_HOST
                                Open a tunnel. 
                                Equivalent to ssh -L <local-port>:<remote-host>:<remote-port> <selected-aws-host>
          -p REMOTE_PORT, --remote-port REMOTE_PORT
                                Port to use on the remote host.
          -l LOCAL_PORT, --local-port LOCAL_PORT
                                Port to use on the local host. Get overwritten by
                                remote port if not defined.
          --keys KEYS           Directory of the private keys (~/.ssh by default).
          --timeout TIMEOUT     SSH connection timeout.
          --console-output      Display the instance console out before logging in.
          --version             Returns awssh's version.
          
          Examples: 
            "awssh --users user1 user2 --region us-east-2 --keys '~/.ssh' instance-name"
            "awssh instance-name --users user1 user2".
        
        ```
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 2.7
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
