Skip to main content

Python library for creating, testing, and deploying small single-page web applications using AWS Lambda and API-Gateway

Project description

LambdaPage

Framework for serving static pages through AWS Lambda and API Gateway

Installation

Install with pip:

pip install LambdaPage

Examples

Simple examples with corresponding Serverless configuration files can be found in the examples directory

Usage

A page is composed by one or more endpoints. Each endpoint should define a REST method, a path, and a function that will handle the request with that method and path. Endpoints can also optionally specify a content-type for the response payload, this defaults to application/json (static html pages should use text/html;charset=utf-8).

Each endpoint function should accept a single argument and return a tuple with (status_code:int, response_body:str). The argument will be a Lambda-Proxy event Regardless of content-type, the response body should always be in string format. Also note that given paths are matched with incoming requests as if they were prefixes, meaning the request will be routed to the first available matching prefix. This can be confusing if you have multiple paths with similar prefixes, so be sure to always add the more specific paths first.

LambdaPage also allows for caching responses. This should primarily be done for GET requests that require several seconds to return. Currently only a S3LambdaPageCache is available, this can be added to a LambdaPage by instantiating it with a bucket and optionally a max_age for cached items (defaults to 300 seconds).

Testing

This framework provides a nice wsgi test bed powered by Falcon. Simply set up the LambdaPage and call start_local(). Note this should be done under 'main' so Lambda doesn't try to execute this code:

def hello(event):
    return 200, '{"message": "hello world"}'

if __name__ == '__main__':
    from LambdaPage import LambdaPage
    page = LambdaPage()
    page.add_endpoint(method='get', path='/', func=hello)
    page.start_local()

Then go to http://127.0.0.1:9000 in a browser.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

LambdaPage-0.0.12-py3-none-any.whl (5.1 kB view details)

Uploaded Python 3

File details

Details for the file LambdaPage-0.0.12-py3-none-any.whl.

File metadata

  • Download URL: LambdaPage-0.0.12-py3-none-any.whl
  • Upload date:
  • Size: 5.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.14.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.5.2

File hashes

Hashes for LambdaPage-0.0.12-py3-none-any.whl
Algorithm Hash digest
SHA256 2f5b270d4142fb1247e2c0832db0d9551b947b0c9c14c2e274ac990aaff4281b
MD5 23d4dbc3e18c062494131999cd1c284c
BLAKE2b-256 8e85de04d6e8ca982a1551a2111ee9893647eb5f1a71d47142955861d86ac1e5

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page