Metadata-Version: 2.1
Name: cloudlaunch-cli
Version: 0.2.1
Summary: Command line client to the CloudLaunch API.
Home-page: https://github.com/CloudVE/cloudlaunch_cli
Author: Galaxy and GVL Projects
Author-email: help@CloudVE.org
License: MIT license
Keywords: cloudlaunch_cli
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Provides-Extra: test
Provides-Extra: dev
Requires-Dist: Click (>=6.0)
Requires-Dist: coreapi (==2.2.3)
Requires-Dist: arrow (==0.12.0)
Provides-Extra: dev
Requires-Dist: sphinx (>=1.3.1); extra == 'dev'
Requires-Dist: bumpversion (>=0.5.3); extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Requires-Dist: tox (>=2.9.1); extra == 'dev'
Requires-Dist: coverage (>=4.4.1); extra == 'dev'
Requires-Dist: flake8 (>=3.4.1); extra == 'dev'
Requires-Dist: flake8-import-order (>=0.13); extra == 'dev'
Requires-Dist: Click (>=6.0); extra == 'dev'
Requires-Dist: coreapi (==2.2.3); extra == 'dev'
Requires-Dist: arrow (==0.12.0); extra == 'dev'
Provides-Extra: test
Requires-Dist: tox (>=2.9.1); extra == 'test'
Requires-Dist: coverage (>=4.4.1); extra == 'test'
Requires-Dist: flake8 (>=3.4.1); extra == 'test'
Requires-Dist: flake8-import-order (>=0.13); extra == 'test'
Requires-Dist: Click (>=6.0); extra == 'test'
Requires-Dist: coreapi (==2.2.3); extra == 'test'
Requires-Dist: arrow (==0.12.0); extra == 'test'

===============
CloudLaunch CLI
===============

.. image:: https://travis-ci.org/CloudVE/cloudlaunch-cli.svg?branch=master
        :target: https://travis-ci.org/CloudVE/cloudlaunch-cli

.. image:: https://coveralls.io/repos/github/CloudVE/cloudlaunch-cli/badge.svg?branch=master
        :target: https://coveralls.io/github/CloudVE/cloudlaunch-cli?branch=master

.. image:: https://img.shields.io/pypi/v/cloudlaunch_cli.svg
        :target: https://pypi.python.org/pypi/cloudlaunch_cli

.. image:: https://readthedocs.org/projects/cloudlaunch-cli/badge/?version=latest
        :target: https://cloudlaunch-cli.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

.. image:: https://pyup.io/repos/github/CloudVE/cloudlaunch_cli/shield.svg
     :target: https://pyup.io/repos/github/CloudVE/cloudlaunch_cli/
     :alt: Updates


Command line client to the CloudLaunch API.


* Free software: MIT license
* Documentation: https://cloudlaunch-cli.readthedocs.io.


Quickstart
==========

1. Create a virtual environment and activate it
   ::

       python3 -m venv venv
       source venv/bin/activate

2. Install ``cloudlaunch-cli`` with pip
   ::

       pip install cloudlaunch-cli

3. The CloudLaunch CLI requires two config settings. First is the URL of
   the API root:
   ::

       cloudlaunch config set url https://launch.usegalaxy.org/cloudlaunch/api/v1

4. Second config setting is an auth token. To get an auth token, first
   log into CloudLaunch, for example, by going to
   https://launch.usegalaxy.org/login. Then navigate to the
   ``/api/v1/auth/tokens`` API endpoint, for example,
   https://launch.usegalaxy.org/cloudlaunch/api/v1/auth/tokens/.
   Copy the token out of the JSON response and then run the following
   (substituting your own token instead):
   ::

       cloudlaunch config set token b38faadf2ef6d59ce46711ed73e99d6...

5. Now you should be able to list your deployments
   ::

       cloudlaunch deployments list

6. You can create a deployment as well
   ::

       cloudlaunch deployments create my-ubuntu-test ubuntu \
           amazon-us-east-n-virginia --application-version 16.04

Installing for development
==========================

1. ``python3 -m venv venv``
2. ``source venv/bin/activate``
3. ``pip install -r requirements_dev.txt``

Now you can run ``cloudlaunch``.

Release process
===============

::

    bumpversion patch
    # or `bumpversion minor` or `bumpversion major`
    git push
    git push --tags
    make release

Credits
---------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.2.0 - 2018-11-14 - (sha 331e58f756145316334049100f582dd4316055fb)
------------------

* Major refactoring.
* Backward compatibility with Python 2.
* Integration tests with CloudLaunch.

0.1.0 - 2018-01-09
------------------

* First release on PyPI.


