Description

Slim Docker container-based AWS Lambda function that processes PGN chess databases stored on Amazon S3 and enriches them with Forsyth–Edwards Notation comments using the pgn-extract CLI tool.

Architecture

Example

Single-game database example of processing using the pgn-extract binary:

• Original database
• Processed database

Usage

Prerequisites

• Docker
• GNU make
• AWS CLI for running the sandbox locally

Configuration

Both build-time and run-time variables are stored in default.config which is loaded into the Makefile.

Command	Description
PGN_EXTRACT_DOWNLOAD_URL	Download URL of the zipped source code of the targeted version of pgn-extract
AWS_S3_BUCKET	Name of the S3 bucket to upload processed PGN databases to when running the sandbox

Testing

You can run the function locally by building and running the sandbox image which contains the AWS Lambda RIE.

make build-sandbox

Running the sandbox image exposes the emulated Lambda environment on the endpoint http://localhost:9000/2015-03-31/functions/function/invocations waiting for S3 event messages.

make run-sandbox

Building

make build