Metadata-Version: 2.1
Name: cloudendure
Version: 0.2.1
Summary: Python wrapper and CLI for CloudEndure
Home-page: https://2ndwatch.github.io/cloudendure-python/
Author: Mark Beacom
Author-email: mark@markbeacom.com
Maintainer: Evan Lucchesi
Maintainer-email: evan@2ndwatch.com
Requires-Python: >=3.7,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Dist: boto3 (>=1.12.4,<2.0.0)
Requires-Dist: certifi (>=2019.11.28,<2020.0.0)
Requires-Dist: cookiecutter (>=1.7.0,<2.0.0)
Requires-Dist: fire (>=0.2.1,<0.3.0)
Requires-Dist: python-dateutil (>=2.8.1,<3.0.0)
Requires-Dist: requests (>=2.23.0,<3.0.0)
Requires-Dist: setuptools (>=45.2.0,<46.0.0)
Requires-Dist: six (>=1.14.0,<2.0.0)
Requires-Dist: urllib3 (>=1.25.8,<2.0.0)
Project-URL: Repository, https://github.com/2ndWatch/cloudendure-python
Description-Content-Type: text/markdown

# cloudendure-python

Python wrapper and CLI for [CloudEndure](https://www.cloudendure.com/)

[![PyPI](https://img.shields.io/pypi/v/cloudendure) ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/cloudendure)](https://pypi.org/project/cloudendure/) [![PyPi Publish](https://github.com/2ndWatch/cloudendure-python/workflows/PyPi%20Publish/badge.svg)](https://2ndwatch.github.io/cloudendure-python/) [![Documenation](https://github.com/2ndWatch/cloudendure-python/workflows/Github%20Pages/badge.svg)](https://2ndwatch.github.io/cloudendure-python/)

## Requirements

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

## Installation & Usage

### poetry

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

### pip

```sh
pip install cloudendure
```

### Usage

Then import the package:

```python
import cloudendure
```

## Getting Started
CloudEndure Pipeline Flow
![CloudEndure Pipeline Flow](images/ce_migration_pipeline.png)

CloudEndure Data Flow
![CloudEndure Data Flow](images/ce_dataflow.png)

Pipeline Flow (as seen in AWS Console)
![Pipeline_Flow](images/stepfunctions_graph.svg)

### 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>
export CLOUDENDURE_DESTINATION_ACCOUNT=<destination_aws_account_id>

cloudendure api login
```

or

```sh
export CLOUDENDURE_USER_API_TOKEN=<your_ce_user_api_token>
export CLOUDENDURE_DESTINATION_ACCOUNT=<destination_aws_account_id>

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_user_api_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.

## Changelog

Check out the [CHANGELOG](CHANGELOG.md)

