Metadata-Version: 1.1
Name: webhook2lambda2sqs
Version: 0.2.0
Summary: Generate code and manage infrastructure for receiving webhooks with AWS API Gateway and pushing to SQS via Lambda.
Home-page: https://github.com/jantman/webhook2lambda2sqs
Author: Jason Antman
Author-email: jason@jasonantman.com
License: UNKNOWN
Description: webhook2lambda2sqs
        ==================
        
        .. image:: https://img.shields.io/pypi/v/webhook2lambda2sqs.svg?maxAge=2592000
           :target: https://pypi.python.org/pypi/webhook2lambda2sqs
           :alt: pypi version
        
        .. image:: http://jantman-personal-public.s3-website-us-east-1.amazonaws.com/pypi-stats/webhook2lambda2sqs/per-month.svg
           :target: http://jantman-personal-public.s3-website-us-east-1.amazonaws.com/pypi-stats/webhook2lambda2sqs/index.html
           :alt: PyPi downloads
        
        .. image:: https://img.shields.io/github/forks/jantman/webhook2lambda2sqs.svg
           :alt: GitHub Forks
           :target: https://github.com/jantman/webhook2lambda2sqs/network
        
        .. image:: https://img.shields.io/github/issues/jantman/webhook2lambda2sqs.svg
           :alt: GitHub Open Issues
           :target: https://github.com/jantman/webhook2lambda2sqs/issues
        
        .. image:: https://secure.travis-ci.org/jantman/webhook2lambda2sqs.png?branch=master
           :target: http://travis-ci.org/jantman/webhook2lambda2sqs
           :alt: travis-ci for master branch
        
        .. image:: https://codecov.io/github/jantman/webhook2lambda2sqs/coverage.svg?branch=master
           :target: https://codecov.io/github/jantman/webhook2lambda2sqs?branch=master
           :alt: coverage report for master branch
        
        .. image:: https://readthedocs.org/projects/webhook2lambda2sqs/badge/?version=latest
           :target: https://readthedocs.org/projects/webhook2lambda2sqs/?badge=latest
           :alt: sphinx documentation for latest release
        
        .. image:: https://badge.waffle.io/jantman/webhook2lambda2sqs.png?label=ready&title=Ready
           :target: https://waffle.io/jantman/webhook2lambda2sqs
           :alt: 'Stories in Ready'
        
        .. 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
        
        Generate code and manage infrastructure for receiving webhooks with AWS API Gateway and pushing to SQS via Lambda.
        
        Webhooks are great, and many projects and services are now offering them as a notification option. But sometimes
        it makes more sense to have the messages in a queue that can absorb changes in rate and de-couple the sending service from a potentially slow or unavailable backend.
        
        webhook2lambda2sqs generates code for an `AWS Lambda <https://aws.amazon.com/lambda/>`_ function
        to receive webhook content via `API Gateway <https://aws.amazon.com/api-gateway/>`_ and push it
        to an SQS queue, where it can be consumed as needed. It supports multiple endpoints via unique URL
        paths (API Gateway resources), where content sent to each endpoint is pushed to one or more SQS
        queues.
        
        In addition, webhook2lambda2sqs includes a wrapper around HashiCorp Terraform to automate creation
        and maintenance of all or part of the infrastructure required to operate this (the API Gateway
        and its configuration, the Lambda function, the function's IAM role, etc.). If TerraForm isn't
        a viable option for you to manage infrastructure with, you can use the generated configuration
        (which maps quite closely to AWS API parameters) as a guide for manual management.
        
        There are also helper commands to view the Lambda Function and API Gateway logs,
        send a test message, and view the queue contents.
        
        For full documentation, see: `http://webhook2lambda2sqs.readthedocs.io/en/latest/ <http://webhook2lambda2sqs.readthedocs.io/en/latest/>`_
        
        Requirements
        ------------
        
        * An Amazon AWS account to run this all in (note - it will probably be cheap, but not free)
        * Python 2.7+ (currently tested with 2.7, 3.3, 3.4, 3.5). Note that AWS Lambda currently only supports python 2.7 as an execution environment, but you're welcome to use other versions on the machine where you run this project.
        * Python `VirtualEnv <http://www.virtualenv.org/>`_ and ``pip`` (recommended installation method; your OS/distribution should have packages for these)
        * `HashiCorp Terraform <https://www.terraform.io/>`_ >= 0.6.16 to manage the AWS infrastructure, if desired. Terraform is written in Go,  and `distributed <https://www.terraform.io/downloads.html>`_ as a static binary.
        
        Program Components
        ------------------
        
        * Lambda Function code generation
        * Terraform configuration generation
        * Management of infrastructure via Terraform
        * AWS-related helpers for inspecting queues and logs, querying information, and
          enabling metrics/logging/rate limiting on the API Gateway.
        
        Full Documentation
        ------------------
        
        For full documentation, see: `http://webhook2lambda2sqs.readthedocs.io/en/latest/ <http://webhook2lambda2sqs.readthedocs.io/en/latest/>`_
        
        Bugs and Feature Requests
        -------------------------
        
        Bug reports and feature requests are happily accepted via the `GitHub Issue Tracker <https://github.com/jantman/webhook2lambda2sqs/issues>`_. Pull requests are
        welcome. Issues that don't have an accompanying pull request will be worked on
        as my time and priority allows.
        
        A Note About the License
        ------------------------
        
        This program is licensed under the `GNU Affero General Public License, version 3.0 or later <https://www.gnu.org/licenses/agpl-3.0.en.html>`_ ("AGPLv3").
        The AGPLv3 includes a clause that source code must be made available to anyone using the program over a network.
        
Keywords: aws webhook lambda apigateway sqs queue amazon
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Environment :: Other Environment
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.7
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Utilities
