The aws-performance-tests package

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain]

Warnings:

Performance Tests for the Haskell bindings for Amazon Web Services (AWS).

At the current stage this package only has tests for the DynamoDb bindings.

IMPORTANT NOTE

By using the dynamo-performace application from this package with your AWS API credentials costs will incure to your AWS account. Depending on the provisioned test table read and write throughput these costs can be in the order of several dollars per hour.

Also be aware that there is an option to keep the table after the tests are finished (for example for usage with successive test runs). If you use that option you have to make sure that you delete the table yourself when you don't need it any more.


[Skip to ReadMe]

Properties

Versions0.1, 0.1.1, 0.1.1
Change logCHANGELOG.md
Dependenciesaeson (>=0.7), async (>=2.0), aws (>=0.10.3), aws-performance-tests, base (==4.*), bytestring (>=0.10), configuration-tools (>=0.2.4), containers (>=0.5), dlist (>=0.7), errors (>=1.4.7), http-client (>=0.3), lens (>=4.2), lifted-base (>=0.2), monad-control (>=0.3), mtl (>=2.1), optparse-applicative (>=0.10), resourcet (>=1.1), statistics (>=0.12), text (>=1.1), time (>=1.4), transformers (>=0.3), vector (>=0.10) [details]
LicenseMIT
Copyright(c) 2014 AlephCloud, Inc.
AuthorLars Kuhtz <lars@alephcloud.com>
MaintainerLars Kuhtz <lars@alephcloud.com>
CategoryNetwork, Web, AWS, Cloud, Distributed Computing
Home pagehttp://github.com/alephcloud/hs-aws-performance-tests
Source repositoryhead: git clone https://github.com/alephcloud/hs-aws-performance-tests.git
this: git clone https://github.com/alephcloud/hs-aws-performance-tests.git(tag 0.1.1)
Executablesdynamodb-performance
UploadedTue Sep 2 18:31:20 UTC 2014 by larsk

Modules

Flags

NameDescriptionDefaultType
with-chart

Build applications with support for printing charts.

DisabledManual

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainers' corner

For package maintainers and hackage trustees


Readme for aws-performance-tests-0.1.1

[back to package description]

Build Status

By using the dynamo-performace application from this package with your AWS API credentials costs will incure to your AWS account. Depending on the provisioned test table read and write throughput these costs can be in the order of several dollars per hour.

Also be aware that there is an option to keep the table after the tests are finished (for example for usage with successive test runs). If you use that option you have to make sure that you delete the table yourself when you don't need it any more.

Installation

First make sure that you have at least version 1.20 of Cabal. You can upgrade to a recent version via

cabal install Cabal --constraint='cabal>=1.20'

It is important that you upgrade to a recent Cabal version before you run one of the following commands.

For installation from Hackage you run:

cabal install aws-performance-tests

For installation from the GitHub repository can can use the following commands:

git clone https://github.com/alephcloud/hs-aws-performance-tests
cd hs-aws-performance-tests
cabal install

Charts

Optionally the application can be compiled with support for generating charts. For this you must install cairo and gtk2hs-buildtools. You also need recent versions of alex and happy. On a Linux/Debian system you can install cairo as follows:

sudo apt-get install libcairo2

The Haskell build-tools are installed via:

cabal install alex happy gtk2hs-buildtools

You then pass the flag -fwith-chart to the the installation commands:

cabal install aws-performance-tests -fwith-chart

Or when compiling the sources from GitHub:

git clone https://github.com/alephcloud/hs-aws-performance-tests
cd hs-aws-performance-tests
cabal install -fwith-chart

Usage

After installing the package you'll find the executable dynamodb-performance in the default location where cabal is configured to install binaries.

In order to use the application you must put your AWS API credentials for your AWS account in the file ~/.aws-keys as described in the Documentation of the aws package.

For help on available options you may call the executable with --help:

dynamodb-performance --help