Numbers Prefer Multiplication
    Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    autocannon-storagepublic

    banner

    Autocannon-storage

    A utility module for storing autocannon results in s3 and sorting/retrieving them in useful manners.

    Usage

    Command-line

    Usage: autocannon-storage {command} [opts]
    
    A convenient command-line library for storing autocannon results in S3
    
    Available commands:
      save
        Save autocannon results to s3
      load
        Load autocannon results from s3 and output them as ndjson
    
    Available options:
    
      -i/--input FILE
            The path to some json results to save. Required when not piping into this tool.
      -o/--output DIRECTORY
            The path to some directory to save results in. Will save results in `${result.finish}.json`
      -c/--credentials FILE
            The path to some json file with S3 credentials
      -k/--accessKey S3_ACCESS_KEY
            Some S3 access key
      -K/--secretKey S3_SECRET_KEY
            Some S3 secret key
      -b/--bucket NAME
            The title of some S3 bucket
      -a/--amount AMOUNT
            The amount of results to load
      -t/--tag TAG
            A semver version tag to tag the results with if doing a save.
            An NPM version tag to filter results by if doing a load.
      -v/--version
            Print the version number.
      -h/--help
            Print this menu.
    

    Example

    saving

    autocannon -d 30 -j localhost:3000 | autocannon-storage save -c ./s3Credentials.json -t `node -e "console.log(require('./package.json').version)"`
    

    loading

    autocannon-storage load -c ./s3Credentials.json -t ">=1.0.0" | autocannon-reporter
    

    Programmatically

    'use strict'
     
    const storage = require('autocannon-storage')
    const abstractBlobStore = require('abstract-blob-store')
    const autocannonResults = require('./SOME_AUTOCANNON_RESULTS')
     
    storage.createStore(abstractBlobStore, function (err, store) {
      store.save(autocannonResults, function (error) {
        // ...
      })
      store.load({}, function (error, results) {
        // ...
      })
    })

    API

    createStore(store, callback)

    Creates an autocannon-storage store that wraps around some library that the implements abstract-blob-store api

    • store: An object that implements the abstract-blob-store API
    • callback(err, store): the callback that is called when the store is instantiated. This takes an error and store as parameters. The store implements the store api described below.

    Store API

    An autocannon store object is passed in the callback of the createStore, and it wraps an abstract-blob-store library. It has the following methods.

    store.save(results, cb, metadata)

    This takes autocannon results and saves it in the store. These results can also have an added tag attribute with semver tags for utilty filtering later.

    The callback takes error and metadata parameters for utility purposes.

    store.load(opts, cb)

    This takes a set of options and loads results matching those params from the store.

    The callback takes error and results parameters.

    • opts.amt: The amount of results to load
    • opts.sort: a sorting function which is used to sort results before returning. defaults to sorting by most recent finish time in the autocannon results

    store.filter(opts, cb)

    This takes a set of options and filters results to matching those params from the store.

    The callback takes error and results parameters.

    • opts.filter: A filter function which should return true if some metadata passed to it should be included in the downloaded results. Can be used to filter by tags.
    • opts.amt: The amount of results to load
    • opts.sort: a sorting function which is used to sort results before returning. defaults to sorting by most recent finish time in the autocannon results

    Utility

    createS3Store(credentials, bucket)

    A wrapper around s3-blob-store that creates and returns that store when passed valid credentials and a bucket name

    Valid credentials have accessKey and secretKey attributes. Used by the command line functionality.

    Acknowlegements

    Sponsored by nearform

    License

    MIT.

    install

    npm i autocannon-storage

    Downloadsweekly downloads

    4

    version

    0.0.1

    license

    MIT

    repository

    githubgithub

    last publish

    collaborators

    • avatar
    • avatar