Metadata-Version: 2.1
Name: icebox
Version: 0.0.0
Summary: Encrypting command-line client for Amazon Glacier.
Home-page: UNKNOWN
Author: 
Author-email: 
License: GPLv3+
Platform: UNKNOWN
Requires-Python: >=3
Description-Content-Type: text/markdown
Requires-Dist: boto3 (>=1.7.40)
Requires-Dist: click (>=6.7)
Requires-Dist: python-gnupg (>=0.4.3)
Requires-Dist: pyyaml (>=3.12)
Requires-Dist: enum34; python_version < "3.4"

icebox
======

Encrypting command-line client for [Amazon Glacier][].

This command-line client lets you store files and directories in Amazon
Glacier. All data is encrypted using GnuPG before being uploaded and no
original filenames will be visible remotely.

  [Amazon Glacier]: https://aws.amazon.com/glacier/

Requirements
------------

* AWS credentials with write access to Glacier
* GnuPG public/private keypair

Setup
-----

**AWS credentials**

Configure AWS credentials as described in the [Boto documentation][].
The credentials should have write access to the Glacier vaults you plan to use.
See the [example IAM policy](docs/iam-policy.example.json) for recommended
permissions.

  [Boto documentation]: https://boto3.readthedocs.io/en/latest/guide/quickstart.html#configuration

**GnuPG keypair**

Create a keypair for icebox and make a note of the ID. Retrieval operations
can take a long time, so you should make sure the keypair stays accessible,
i.e. no password prompts blocking the operation.

**Install icebox**

Install icebox using pip (or [pipsi][]):

    pip install icebox

  [pipsi]: https://github.com/mitsuhiko/pipsi

Usage
-----

**Create a new box**

Create the box _mybox_ for a Glacier vault called *myvault* like this:

    icebox init mybox 0xMYKEYID glacier myvault

If your AWS credentials are not in the `default` profile, use the `--profile`
option:

    icebox init mybox 0xMYKEYID glacier myvault --profile icebox

**Store data in a box**

To store a file or directory, simply specify its location:

    icebox put myvault cat-pictures/grumpy.jpg

**Retrieve data from a box**

There are no directories in boxes, so you just specify the original name of the
source and a destination:

    icebox get myvault grumpy.jpg ~/Desktop

Standard retrievals can take a long time. To perform an [Expedited][pricing]
retrieval, use the `Tier` option:

    icebox get myvault grumpy.jpg ~/Desktop -o Tier=Expedited

Retrieval operations are tracked by icebox, so you can interrupt a waiting
retrieval and request the same source again later.

  [pricing]: https://aws.amazon.com/glacier/pricing/


