Pargras

Pargras is a minimalistic helper around function arguments for Node.js and the Browser. Pargras has a fluent interface and supports adding, removing and altering arguments before applying them to a function.

Getting started

Node.js

Install pargras using npm.

npm install pargras --save

Then require it into any module.

const Pargras = require('pargras');

Browser

You can download the latest release from the repository

• pargras.js unminified, including comments
• pargras.min.js minified version

Use a script tag to directly add Pargras to the global scope.

<script src="pargras.min.js"></script>

Usage

function specialMin()
{
    // Instantiate the arguments helper.
    const args = new Pargras(arguments);

    // Remove first and last parameter, then call Math.min() with the resulting arguments.
    var min = args.shift().pop().applyTo(Math.min);
}

specialMin(0, 2, 3, 4, 1);
// -> 2

Examples

Return the function arguments as an array.

function afunc()
{
    // Instantiate the arguments helper.
    const args = new Pargras(arguments);

    // Return the function arguments as an array.
    return args.array();
}

afunc(0, 1, "two", true);
// -> [ 0, 1, "two", true ]

Return the number of arguments passed to a function.

function afunc()
{
    // Instantiate the arguments helper.
    const args = new Pargras(arguments);

    // Return the number of arguments passed to function.
    return args.length();
}

afunc(0, 1, "two", true);
// -> 4

Alter an argument value.

function afunc()
{
    // Instantiate the arguments helper.
    const args = new Pargras(arguments);

    // Check value.
    args.get(1);
    // -> "banana"

    // Alter second argument value.
    args.set(1, 'altered');

    // Check value again.
    args.get(1);
    // -> "altered"

    // Return sorted arguments.
    return args.array().sort();
}

afunc("peach", "banana", "apple");
// -> [ "altered", "apple", "peach" ]

Alter arguments and apply them to another function.

function afunc()
{
    // Instantiate the arguments helper.
    const args = new Pargras(arguments);

    // Alter arguments.
    // a) Remove first argument.
    // b) Remove last argument.
    // c) Prepend argument 'one'.
    // d) Append argument 'four'.
    args.shift().pop().unshift('one').push('four');

    // Apply to console.log().
    args.applyTo(console.log);
}

afunc(1, 2, 3, 4);
// -> [ "one", 2, 3, "four" ]

More examples

Please refer to the test spec for more examples.

Testing

We use

• JSHint for static code analysis.
• Jasmine testing framework for testing.
• Karma test runner for testing in the browser.
• Istanbul test coverage framework for tracking test coverage.

Steps to be taken

• Clone or download the repository.
• Change into the project directory.
• Use npm install to install all development dependencies.
• Use npm runt lint to run static code analysis.
• Use npm test to run the tests.
• Use npm run coverage to track test coverage.
• The output should display successful execution results and a code coverage map.

Build

• Clone or download the repository.
• Change into project directory.
• Use npm run build in project directory to build pargras.min.js from pargras.js.

Contribution

Please use Github issues for requests.

Pull requests are welcome.

Issues

We use GitHub issues to track bugs. Please ensure your bug description is clear and has sufficient instructions to be able to reproduce the issue.

The absolute best way to report a bug is to submit a pull request including a new failing test which describes the bug. When the bug is fixed, your pull request can then be merged.

The next best way to report a bug is to provide a reduced test case on jsFiddle or jsBin or produce exact code inline in the issue which will reproduce the bug.

Support

• Send us an email: [email protected]
• Follow us on Twitter: @tbillenstein

Changelog

v1.1.0

• Update npm modules.
• Update and extend test environment.
• Add static code analysis tool JSHint.
• Add Karma test runner.
• Fix JSHint issues.
• Replace uglify-js by terser for minification.
• Update README.

v1.0.3

• Update npm modules.

v1.0.2

• Update npm modules.

v1.0.1

• Update npm modules.

v1.0.0

• Initial public release

License

Copyright (c) 2016-present, tbillenstein. Pargras is licensed under the MIT License.