Skip to content

bevry-archive/argsbytype

Repository files navigation

Arguments By Type

Travis CI Build Status NPM version NPM downloads Dependency Status Dev Dependency Status
GitHub Sponsors donate button Patreon donate button Flattr donate button Liberapay donate button Buy Me A Coffee donate button Open Collective donate button crypto donate button PayPal donate button Wishlist browse button

Provide some arguments, get back a hash object of the arguments indexed by their type. Very useful for agnostic argument orders.

Usage

Let's say your coding a function, and you want to accept arguments in any order. Traditionally this would look like:

https://github.com/bevry/argsbytype/blob/master/example/01.js

But what happens when you:

  • Start having arguments that are regular expressions or dates which typeof is still object instead of regexp or date
  • Or, when you start having multiple arguments of the same type, that you would like to accept (e.g. the first string should be the name property, the second string should be the keyword property)

At that point in time, it becomes too much trouble to bother with. Fortunately, argsbytype is to the rescue! Now you can do:

https://github.com/bevry/argsbytype/blob/master/example/02.js

Yay! Big win for agnostic argument order! But when would you actually want this? Well, it turns out that in CoffeeScript options come first, in JavaScript, options usually come last. By using this, we can support both conventions, for example:

https://github.com/bevry/argsbytype/blob/master/example/03.js

Install

npm

  • Install: npm install --save argsbytype
  • Import: import * as pkg from ('argsbytype')
  • Require: const pkg = require('argsbytype')

jspm

<script type="module">
    import * as pkg from '//dev.jspm.io/[email protected]'
</script>

This package is published with the following editions:

  • argsbytype aliases argsbytype/source/index.js
  • argsbytype/source/index.js is ESNext source code for Node.js 10 || 12 || 14 || 15 with Require for modules
  • argsbytype/edition-browsers/index.js is ESNext compiled for web browsers with Require for modules

History

Discover the release history by heading on over to the HISTORY.md file.

Contribute

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

Backers

Maintainers

These amazing people are maintaining this project:

Sponsors

No sponsors yet! Will you be the first?

GitHub Sponsors donate button Patreon donate button Flattr donate button Liberapay donate button Buy Me A Coffee donate button Open Collective donate button crypto donate button PayPal donate button Wishlist browse button

Contributors

These amazing people have contributed code to this project:

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

License

Unless stated otherwise all works are:

and licensed under: