Newton's Preposterous Miscalculation

    parse-github-payload

    0.1.1 • Public • Published

    parse-github-payload

    build status

    Parses a github push event payload adding a list of files added, modified and removed to the payload

    parsePayload(payload, [options], [options.matchName], [options.ignoreCommit])

    Parses a Github webhook payload returning a clone of the payload with additional useful properties.

    Right now it only does anything with the push event adding a property _files with arrays of files that have been added, modified and removed by the push event.

    Why?

    If you want to act on added or modified files that are present in the most recent commit. A single push event might include commits that add then delete a file. In this case that file would not be included in _files.added. This is most useful for webhooks that act on files added or modified in push events.

    Parameters

    parameter type description
    payload Object Github webhook payload
    [options] Object optional:
    [options.matchName] Regex optional: only return files that match this regex.
    [options.ignoreCommit] Regex optional: ignore files submitted with a commit message that matches this regex - useful for avoiding circular webhooks

    Returns parsedPayload, a new parsedPayload with the _files property.

    _files.modified Array of files in push event commits, with duplicates removed and any files that were removed in a later commit also removed.

    _files.removed Array of files removed from the repo in the commits in the push event, duplicates removed.

    _files.added Array of files added to and modified in the repo, with duplicates removed and any files that were removed in a later commit also removed.

    _files.added_and_modified array of files that have been added and modified in the commits in a push event, excluding files that were added or modified and subsequently deleted.

    Installation

    Requires nodejs.

    $ npm install parse-github-payload

    Tests

    $ npm test

    Install

    npm i parse-github-payload

    DownloadsWeekly Downloads

    0

    Version

    0.1.1

    License

    MIT

    Last publish

    Collaborators

    • andrew_chou
    • substack
    • karissa
    • digidem-admin
    • gmaclennan
    • noffle