Metadata-Version: 2.1
Name: zalando-aws-cli
Version: 1.2.10.48
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: boto3>=1.3.0
Requires-Dist: clickclick>=0.6
Requires-Dist: PyJWT<3.0,>=2.0
Requires-Dist: PyYAML
Requires-Dist: stups-zign>=1.0.24
Requires-Dist: requests[security]

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

This package provides the ``zaws`` command line utility to exchange OAuth tokens for temporary AWS credentials by calling the `AWS Credentials Service`_.

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

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

.. code-block:: bash

    $ sudo pip3 install -U stups
    $ stups configure

Usage
=====

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