Metadata-Version: 2.1
Name: zalando-aws-cli
Version: 1.2.12.61
Summary: AWS login CLI
Home-page: https://github.com/zalando-incubator/zalando-aws-cli
Author: Henning Jacobs
Author-email: henning.jacobs@zalando.de
License: Apache License 2.0
Keywords: aws account saml login federated shibboleth
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
License-File: LICENSE
Requires-Dist: requests[security]

===============
Zalando AWS CLI
===============

**IMPORTANT**: This tool is deprecated. Please use the new tool available at: https://cloud.docs.zalando.net/reference/zaws/

This package previously provided the ``zaws`` command line utility. It now serves as a transition to the new tool.
package provides the ``zaws`` command line utility to exchange OAuth tokens for temporary AWS credentials by calling the `AWS Credentials Service`_.

Installation
============

Installing or updating this package will provide information about migrating to the new tool.

The ``zalando-aws-cli`` package is part of the ``stups`` bundle:

.. code-block:: bash

    $ sudo pip3 install -U stups
    $ stups configure

Usage (deprecated)
==================

.. code-block:: bash

    $ zaws list                  # list all allowed account roles
    $ zaws login myacc RoleName  # write ~/.aws/credentials

You can configure your default account/role to only run ``zaws``:

.. code-block:: bash

    $ zaws set-default myacc RoleName
    $ zaws

There are multiple ways of abbreviating the command line:

.. code-block:: bash

    $ zaws li            # command can be abbreviated
    $ zaws login myacc   # only the account name is needed if you have only one role
    $ zaws alias myalias myacc PowerUser # create an alias
    $ zaws lo myalias    # use the alias

Use ``-h`` to get a list of commands and help:

.. code-block:: bash

    $ zaws -h        # list top-level commands
    $ zaws login -h  # help on the "login" command

Running locally
===============

You can run the module directly during development:

.. code-block:: bash

    $ python3 -m zalando_aws_cli list
    $ python3 -m zalando_aws_cli login myacc PowerUser

Unit tests
==========

.. code-block:: bash

    $ sudo pip3 install tox
    $ tox

.. _AWS Credentials Service: https://github.com/zalando-incubator/aws-credentials-service
