Metadata-Version: 2.1
Name: awscliv2
Version: 1.1.0
Summary: Wrapper for dockerized AWS CLI v2
Home-page: https://github.com/vemel/awscliv2
Author: Vlad Emelianov
Author-email: vlad.emelianov.nz@gmail.com
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Typing :: Typed
Description-Content-Type: text/markdown

# AWS CLI v2

Wrapper for dockerized [AWS CLI v2](https://github.com/aws/aws-cli/tree/v2).
Uses [amazon/aws-cli](https://hub.docker.com/r/amazon/aws-cli) Docker image.

- [AWS CLI v2](#aws-cli-v2)
  - [Installation](#installation)
  - [Usage](#usage)
  - [Versioning](#versioning)
  - [Latest changes](#latest-changes)

## Installation

Install [Docker](https://docs.docker.com/get-docker/).

```bash
pip install awscliv2
```

## Usage

Container uses two volumes:

- `$HOME/.aws` -> `/root/.aws`
- `$(cwd)` -> `/aws`

Pull latest `amazon/aws-cli` image:

```bash
awsv2 --update
```

Configure default frofile if needed:

```bash
AWS_ACCESS_KEY_ID='my-access-key'
AWS_SECRET_ACCESS_KEY='my-secret-key'

# --configure profile_name access_key secret_key
awsv2 --configure default ${AWS_ACCESS_KEY_ID} ${AWS_SECRET_ACCESS_KEY}
awsv2 configure set region us-west-1
```

Use `awscli` as usual:

```bash
# alias for
# docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/aws amazon/aws-cli $@
awsv2 s3 ls

# or as a python module
python -m awscliv2 s3 ls
```

## Versioning

`awscliv2` version follows [PEP 440](https://www.python.org/dev/peps/pep-0440/).

## Latest changes

Full changelog can be found in [Changelog](./CHANGELOG.md).
Release notes can be found in [Releases](https://github.com/vemel/awscliv2/releases).

# Change Log

All notable changes to this project are documented on [Releases](https://github.com/vemel/awscliv2/releases) page.

The format is based on [Keep a Changelog](http://keepachangelog.com/)
and this project adheres to [PEP 440](https://www.python.org/dev/peps/pep-0440/).

# [Released]

## [1.1.0] - 2020-08-29

### Added

- `-U`/`--update` CLI argument to pull latest `amazon/aws-cli` image

### Changed

- `-V`/`--version` command shows underlying image version
- `region_name` removed from `--configure` command

## [1.0.0] - 2020-08-29

Initial release

