===============
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.
Raw data
{
"_id": null,
"home_page": "https://github.com/CloudVE/cloudlaunch_cli",
"name": "cloudlaunch-cli",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "cloudlaunch_cli",
"author": "Galaxy and GVL Projects",
"author_email": "help@CloudVE.org",
"download_url": "https://files.pythonhosted.org/packages/9b/c7/d3ab153fed06998c1af9241bf7f5185f058a7239e50fa0e9df292ae0b3ed/cloudlaunch_cli-0.2.1.tar.gz",
"platform": "",
"description": "===============\nCloudLaunch CLI\n===============\n\n.. image:: https://travis-ci.org/CloudVE/cloudlaunch-cli.svg?branch=master\n :target: https://travis-ci.org/CloudVE/cloudlaunch-cli\n\n.. image:: https://coveralls.io/repos/github/CloudVE/cloudlaunch-cli/badge.svg?branch=master\n :target: https://coveralls.io/github/CloudVE/cloudlaunch-cli?branch=master\n\n.. image:: https://img.shields.io/pypi/v/cloudlaunch_cli.svg\n :target: https://pypi.python.org/pypi/cloudlaunch_cli\n\n.. image:: https://readthedocs.org/projects/cloudlaunch-cli/badge/?version=latest\n :target: https://cloudlaunch-cli.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\n.. image:: https://pyup.io/repos/github/CloudVE/cloudlaunch_cli/shield.svg\n :target: https://pyup.io/repos/github/CloudVE/cloudlaunch_cli/\n :alt: Updates\n\n\nCommand line client to the CloudLaunch API.\n\n\n* Free software: MIT license\n* Documentation: https://cloudlaunch-cli.readthedocs.io.\n\n\nQuickstart\n==========\n\n1. Create a virtual environment and activate it\n ::\n\n python3 -m venv venv\n source venv/bin/activate\n\n2. Install ``cloudlaunch-cli`` with pip\n ::\n\n pip install cloudlaunch-cli\n\n3. The CloudLaunch CLI requires two config settings. First is the URL of\n the API root:\n ::\n\n cloudlaunch config set url https://launch.usegalaxy.org/cloudlaunch/api/v1\n\n4. Second config setting is an auth token. To get an auth token, first\n log into CloudLaunch, for example, by going to\n https://launch.usegalaxy.org/login. Then navigate to the\n ``/api/v1/auth/tokens`` API endpoint, for example,\n https://launch.usegalaxy.org/cloudlaunch/api/v1/auth/tokens/.\n Copy the token out of the JSON response and then run the following\n (substituting your own token instead):\n ::\n\n cloudlaunch config set token b38faadf2ef6d59ce46711ed73e99d6...\n\n5. Now you should be able to list your deployments\n ::\n\n cloudlaunch deployments list\n\n6. You can create a deployment as well\n ::\n\n cloudlaunch deployments create my-ubuntu-test ubuntu \\\n amazon-us-east-n-virginia --application-version 16.04\n\nInstalling for development\n==========================\n\n1. ``python3 -m venv venv``\n2. ``source venv/bin/activate``\n3. ``pip install -r requirements_dev.txt``\n\nNow you can run ``cloudlaunch``.\n\nRelease process\n===============\n\n::\n\n bumpversion patch\n # or `bumpversion minor` or `bumpversion major`\n git push\n git push --tags\n make release\n\nCredits\n---------\n\nThis package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.\n\n.. _Cookiecutter: https://github.com/audreyr/cookiecutter\n.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage\n\n\n=======\nHistory\n=======\n\n0.2.0 - 2018-11-14 - (sha 331e58f756145316334049100f582dd4316055fb)\n------------------\n\n* Major refactoring.\n* Backward compatibility with Python 2.\n* Integration tests with CloudLaunch.\n\n0.1.0 - 2018-01-09\n------------------\n\n* First release on PyPI.\n",
"bugtrack_url": null,
"license": "MIT license",
"summary": "Command line client to the CloudLaunch API.",
"version": "0.2.1",
"split_keywords": [
"cloudlaunch_cli"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3a087013c704830a993ff00ca9f1f591ef5027ba28476f4b93067cc44f88fcf7",
"md5": "e390caf0eac9f02917e4dfae7ba60d8d",
"sha256": "f07fbf212c2b63a2e17f59c5214f03f13e8bb6ecb66ec663f61d6110ca904f4f"
},
"downloads": -1,
"filename": "cloudlaunch_cli-0.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e390caf0eac9f02917e4dfae7ba60d8d",
"packagetype": "bdist_wheel",
"python_version": "3.6",
"requires_python": null,
"size": 13522,
"upload_time": "2018-11-15T12:15:15",
"upload_time_iso_8601": "2018-11-15T12:15:15.227104Z",
"url": "https://files.pythonhosted.org/packages/3a/08/7013c704830a993ff00ca9f1f591ef5027ba28476f4b93067cc44f88fcf7/cloudlaunch_cli-0.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9bc7d3ab153fed06998c1af9241bf7f5185f058a7239e50fa0e9df292ae0b3ed",
"md5": "3c0c5c1341473be8696e4463a358a095",
"sha256": "1057199769c328cf95b7d3578a9c7c3e3fb374b0e1b468025893b90f07fb9748"
},
"downloads": -1,
"filename": "cloudlaunch_cli-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "3c0c5c1341473be8696e4463a358a095",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 33415,
"upload_time": "2018-11-15T12:15:10",
"upload_time_iso_8601": "2018-11-15T12:15:10.440066Z",
"url": "https://files.pythonhosted.org/packages/9b/c7/d3ab153fed06998c1af9241bf7f5185f058a7239e50fa0e9df292ae0b3ed/cloudlaunch_cli-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2018-11-15 12:15:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "CloudVE",
"github_project": "cloudlaunch_cli",
"lcname": "cloudlaunch-cli"
}
JSON
