Metadata-Version: 2.0
Name: linode-cli
Version: 1.0.3b4
Summary: CLI for Linode API v4
Home-page: https://www.linode.com/docs/platform/linode-cli
Author: Linode
Author-email: wsmith@linode.com
License: UNKNOWN
Platform: UNKNOWN
Requires-Python: >=3.4
Requires-Dist: colorclass
Requires-Dist: linode-api (>=4.1.0b0)
Requires-Dist: terminaltables

linode-cli
==========

A reimplementation of the `Linode CLI`_ using the `Python Library`_ and
`API V4`_.

Installation
------------
::

    pip3 install linode-cli

Building from Source
-------------------

To build this package from source:

- Clone this repository.
- ``python3 setup.py install``

Usage
-----

While the Linode API V4 is in beta, this package installs the command
``linode-beta``.

When running the CLI for the first time, configure it by running
``linode-beta configure``.  This will prompt for for your API V4
personal access token and some defaults.

This is intended to be used like the existing Linode CLI, and you can
use `the existing CLI docs`_ for reference.

In addition, the following commands have been added:

- ``linode-beta event list`` - lists recent Events
- ``linode-beta event seen`` - marks all Events as seen
- ``linode-beta backups-show LINODE`` - show backups for a Linode
- ``linode-beta snapshot LINODE`` - create a snapshot of a Linode
- ``linode-beta backups-restore LINODE BACKUPID -l TARGET -f`` - restore a backup
- ``linode-beta backups-enable LINODE`` - enable backups for a Linode
- ``linode-beta backups-cancel LINODE`` - cancel backups for a Linode
- ``linode-beta ticket list`` - list tickets open on your account
- ``linode-beta ticket show TICKETID`` - show a ticket and its replies

Examples
--------

List all linodes and their status:

``linode-beta list``

Create a new Linode with a root password of "hunter7" and label "cli-test-1"
in your default region with your default type:

``linode-beta create -P hunter7 -l cli-test-1``

Shut down your new linode:

``linode-beta stop cli-test-1``

Show a Linode's Backups:

``linode-beta backups-show cli-test-1``

List your domains:

``linode-beta domain list``

Show recent events:

``linode-beta event list``

Show open tickets:

``linode-beta ticket list``

.. _API v4: https://developers.linode.com
.. _Linode CLI: https://linode.com/cli
.. _Python Library: https://github.com/linode/python-linode-api
.. _the existing CLI docs: https://www.linode.com/docs/platform/linode-cli#using-the-cli


