Metadata-Version: 2.1
Name: cloudendure
Version: 0.0.3
Summary: CloudEndure Python Client and CLI
Home-page: https://github.com/mbeacom/cloudendure-py
Author: Mark Beacom
Author-email: markvbeacom@gmail.com
License: MIT
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS
Classifier: Operating System :: MacOS :: MacOS 9
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft
Classifier: Operating System :: Microsoft :: MS-DOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: Microsoft :: Windows :: Windows 8.1
Classifier: Operating System :: Microsoft :: Windows :: Windows 8
Classifier: Operating System :: Microsoft :: Windows :: Windows 7
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Session
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: Utilities
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: boto3
Provides-Extra: test
Requires-Dist: coverage ; extra == 'test'
Requires-Dist: isort ; extra == 'test'
Requires-Dist: pytest ; extra == 'test'
Requires-Dist: pytest-cov ; extra == 'test'
Requires-Dist: pytest-isort ; extra == 'test'
Requires-Dist: pytest-sugar ; extra == 'test'
Requires-Dist: black ; extra == 'test'
Requires-Dist: pydocstyle ; extra == 'test'
Requires-Dist: pycodestyle ; extra == 'test'
Requires-Dist: bandit ; extra == 'test'
Requires-Dist: mypy ; extra == 'test'
Requires-Dist: twine ; extra == 'test'


# cloudendure-python

Python wrapper and CLI for CloudEndure

[![Build Status](https://travis-ci.com/mbeacom/cloudendure-python.svg?branch=master)](https://travis-ci.com/mbeacom/cloudendure-python)

[Documentation](https://mbeacom.github.io/cloudendure-python/)

Package version: `0.0.3`

## Requirements

[Python 3.6+](https://www.python.org/downloads/)

## Installation & Usage

### pipenv

```sh
brew install pipenv # if not installed
pipenv install cloudendure
```

Then import the package:

```python
import cloudendure
```

### pip

```sh
pip install cloudendure
```

Then import the package:

```python
import cloudendure
```

### Setuptools

Install via [Pipenv](https://docs.pipenv.org/en/latest/).

```sh
python setup.py install --user
```

(or `sudo python setup.py install` to install the package for all users)

Then import the package:

```python
import cloudendure
```

## Getting Started

### Logging in via CLI using environment variables

Please note:  `cloudendure` and `ce` can be used interchangeably

```sh
export CLOUDENDURE_USERNAME=<your_ce_user>
export CLOUDENDURE_PASSWORD=<your_ce_password>

cloudendure api login
```

or

```sh
export CLOUDENDURE_TOKEN=<your_ce_api_token>

ce api login
```

### Logging in via CLI inline

Please note:  `cloudendure` and `ce` can be used interchangeably

```sh
cloudendure api login --user=<your_ce_user> --password=<your_ce_password>
```

or

```sh
ce api login --token=<your_ce_token>
```

Logging in for the first time will generate the `~/.cloudendure.yml` file.

## Coming Soon

This project is currently a work in progress and will actively change.  This client has not yet been finalized and is entirely subject to change.


