Metadata-Version: 1.1
Name: awslimitchecker
Version: 0.2.3
Summary: A script and python module to check your AWS service limits and usage using boto.
Home-page: https://github.com/jantman/awslimitchecker
Author: Jason Antman
Author-email: jason@jasonantman.com
License: UNKNOWN
Description: awslimitchecker
        ========================
        
        .. image:: https://img.shields.io/pypi/v/awslimitchecker.svg
           :target: https://pypi.python.org/pypi/awslimitchecker
           :alt: PyPi package version
        
        .. image:: https://img.shields.io/pypi/dm/awslimitchecker.svg
           :target: https://pypi.python.org/pypi/awslimitchecker
           :alt: PyPi downloads
        
        .. image:: https://img.shields.io/github/forks/jantman/awslimitchecker.svg
           :alt: GitHub Forks
           :target: https://github.com/jantman/awslimitchecker/network
        
        .. image:: https://img.shields.io/github/issues/jantman/awslimitchecker.svg
           :alt: GitHub Open Issues
           :target: https://github.com/jantman/awslimitchecker/issues
        
        .. image:: http://www.repostatus.org/badges/0.1.0/active.svg
           :alt: Project Status: Active - The project has reached a stable, usable state and is being actively developed.
           :target: http://www.repostatus.org/#active
        
        Master:
        
        .. image:: https://secure.travis-ci.org/jantman/awslimitchecker.png?branch=master
           :target: http://travis-ci.org/jantman/awslimitchecker
           :alt: travis-ci for master branch
        
        .. image:: https://landscape.io/github/jantman/awslimitchecker/master/landscape.svg
           :target: https://landscape.io/github/jantman/awslimitchecker/master
           :alt: Code Health
        
        .. image:: https://codecov.io/github/jantman/awslimitchecker/coverage.svg?branch=master
           :target: https://codecov.io/github/jantman/awslimitchecker?branch=master
           :alt: coverage report for master branch
        
        .. image:: https://readthedocs.org/projects/awslimitchecker/badge/?version=latest
           :target: https://readthedocs.org/projects/awslimitchecker/?badge=latest
           :alt: sphinx documentation for latest release
        
        Develop:
        
        .. image:: https://secure.travis-ci.org/jantman/awslimitchecker.png?branch=develop
           :target: http://travis-ci.org/jantman/awslimitchecker
           :alt: travis-ci for develop branch
        
        .. image:: https://landscape.io/github/jantman/awslimitchecker/develop/landscape.svg
           :target: https://landscape.io/github/jantman/awslimitchecker/develop
           :alt: Code Health
        
        .. image:: https://codecov.io/github/jantman/awslimitchecker/coverage.svg?branch=develop
           :target: https://codecov.io/github/jantman/awslimitchecker?branch=develop
           :alt: coverage report for develop branch
        
        .. image:: https://readthedocs.org/projects/awslimitchecker/badge/?version=develop
           :target: https://readthedocs.org/projects/awslimitchecker/?badge=develop
           :alt: sphinx documentation for develop branch
        
        A script and python module to check your AWS service limits and usage using `boto <http://docs.pythonboto.org/en/latest/>`_.
        
        Users building out scalable services in Amazon AWS often run into AWS' `service limits <http://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html>`_ -
        often at the least convenient time (i.e. mid-deploy or when autoscaling fails). Amazon's `Trusted Advisor <https://aws.amazon.com/premiumsupport/trustedadvisor/>`_
        can help this, but even the version that comes with Business and Enterprise support only monitors a small subset of AWS limits
        and only alerts *weekly*. awslimitchecker provides a command line script and reusable package that queries your current
        usage of AWS resources and compares it to limits (hard-coded AWS defaults that you can override, API-based limits where available, or data from Trusted
        Advisor where available), notifying you when you are approaching or at your limits.
        
        Full project documentation is available at `http://awslimitchecker.readthedocs.org <http://awslimitchecker.readthedocs.org>`_.
        
        Status
        ------
        
        This project is currently in very early development. At this time please consider it beta code and not fully tested in all situations;
        furthermore its API may be changing rapidly. I hope to have this stabilized soon.
        
        What It Does
        ------------
        
        - Check current AWS resource usage against AWS Service Limits
        - Show and inspect current usage
        - Override default Service Limits (for accounts with increased limits)
        - Compare current usage to limits; return information about limits that
          exceed thresholds, and (CLI wrapper) exit non-0 if thresholds are exceeded
        - Define custom thresholds per-limit
        - where possible, pull current limits from Trusted Advisor API
        - where possible, pull current limits from each service's API (for services that provide this information)
        - Supports explicitly setting the AWS region
        - Supports using `STS <http://docs.aws.amazon.com/STS/latest/APIReference/Welcome.html>`_ to assume roles in other accounts, including using ``external_id``.
        
        Requirements
        ------------
        
        * Python 2.6 through 3.4. Python 2.x is recommended, as `boto <http://docs.pythonboto.org/en/latest/>`_ (the AWS client library) currently has
          incomplete Python3 support. See the `boto documentation <http://boto.readthedocs.org/en/latest/>`_ for a list of AWS services that are Python3-compatible.
        * Python `VirtualEnv <http://www.virtualenv.org/>`_ and ``pip`` (recommended installation method; your OS/distribution should have packages for these)
        * `boto <http://docs.pythonboto.org/en/latest/>`_ >= 2.32.0
        
        Installation
        ------------
        
        It's recommended that you install into a virtual environment (virtualenv /
        venv). See the `virtualenv usage documentation <http://www.virtualenv.org/en/latest/>`_
        for information on how to create a venv. If you really want to install
        system-wide, you can (using sudo).
        
        .. code-block:: bash
        
            pip install awslimitchecker
        
        Credentials
        -----------
        
        Aside from STS, awslimitchecker does nothing with AWS credentials, it leaves that to boto itself.
        You must either have your credentials configured in one of boto's supported config
        files, or set as environment variables. See
        `boto config <http://docs.pythonboto.org/en/latest/boto_config_tut.html>`_
        and
        `this project's documentation <http://awslimitchecker.readthedocs.org/en/latest/getting_started.html#credentials>`_
        for further information.
        
        When using STS, you will need to specify the ``-r`` / ``--region`` option as well as the ``-A`` / ``--sts-account-id``
        and ``-R`` / ``--sts-account-role`` options to specify the Account ID that you want to assume a role in, and the
        name of the role you want to assume. If an external ID is required, you can specify it with ``-E`` / ``--external-id``.
        
        Usage
        -----
        
        For basic usage, see:
        
        .. code-block:: bash
        
            awslimitchecker --help
        
        See the `project documentation <http://awslimitchecker.readthedocs.org>`_
        for further information.
        
        Bugs, Feature Requests
        ----------------------
        
        Questions, comments, Bug reports and feature requests are happily accepted via
        the `GitHub Issue Tracker <https://github.com/jantman/awslimitchecker/issues>`_.
        Pull requests are always welcome.
        
        Please see the [Development](http://awslimitchecker.readthedocs.org/en/latest/development.html)
        and [Getting Help](http://awslimitchecker.readthedocs.org/en/latest/getting_help.html) documentation for more information.
        
        Changelog
        ---------
        
        See `https://github.com/jantman/awslimitchecker/blob/develop/CHANGES.rst <https://github.com/jantman/awslimitchecker/blob/develop/CHANGES.rst>`_.
        
        Contributions
        -------------
        
        Pull requests are most definitely welcome. Please cut them against the **develop** branch. For more information, see
        the [development documentation](http://awslimitchecker.readthedocs.org/en/latest/development.html#pull-requests). I'm
        also happy to accept contributions in the form of bug reports, feature requests, testing, etc.
        
        License
        -------
        
        awslimitchecker is licensed under the `GNU Affero General Public License, version 3 or later <http://www.gnu.org/licenses/agpl.html>`_.
        This shouldn't be much of a concern to most people.
        
        If you're simply *running* awslimitchecker, all you must do is provide a notice on where to get the source code
        in your output; this is already handled via a warning-level log message in the package. If you modify awslimitchecker's
        code, you must update this URL to reflect your modifications (see ``awslimitchecker/version.py``).
        
        If you're distributing awslimitchecker with modifications or as part of your own software (as opposed to simply a
        requirement that gets installed with pip), please read the license and ensure that you comply with its terms.
        
        If you are running awslimitchecker as part of a hosted service that users somehow interact with, please
        ensure that the source code URL is visible in the output given to users.
        
Keywords: AWS EC2 Amazon boto limits cloud
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Internet
Classifier: Topic :: System :: Monitoring
