Metadata-Version: 2.1
Name: cloudssh
Version: 1.0.1
Summary: EC2 SSH connections helper
Home-page: https://github.com/gabfl/cloudssh
Author: gab
Author-email: gab@confiant.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Topic :: Software Development
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python
Classifier: Development Status :: 4 - Beta
Requires-Dist: argparse
Requires-Dist: boto3

cloudssh
========

|Build Status| |codecov| |MIT licensed|

EC2 SSH connections helper

An SSH connection helper for AWS
--------------------------------

``cloudssh`` allows you to quickly connect to EC2 instances using their
names or instance IDs.

It will call the AWS SDK to find the instance public IP address and open
a SSH connection in a subprocess.

Example:

.. figure:: https://github.com/gabfl/cloudssh/blob/master/img/ec2.png?raw=true
   :alt: EC2

   EC2

You can connect to this instance with:

::

   cloudssh dev

Installation and usage
----------------------

.. code:: bash

   pip3 install cloudssh
   aws configure # To configure your AWS credentials

   cloudssh myserver # Call the module followed by the name of one of your servers

Advanced configuration
----------------------

You can optionally create a file ``~/.cloudssh.cfg`` (see
`example <.cloudssh.cfg.sample>`__).

.. |Build Status| image:: https://travis-ci.org/gabfl/cloudssh.svg?branch=master
   :target: https://travis-ci.org/gabfl/cloudssh
.. |codecov| image:: https://codecov.io/gh/gabfl/cloudssh/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/gabfl/cloudssh
.. |MIT licensed| image:: https://img.shields.io/badge/license-MIT-green.svg
   :target: https://raw.githubusercontent.com/gabfl/cloudssh/master/LICENSE


