StackGenVis: Alignment of Data, Algorithms, and Models for Stacking Ensemble Learning Using Performance Metrics
https://doi.org/10.1109/TVCG.2020.3030352
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
306 lines
6.0 KiB
306 lines
6.0 KiB
# expand-object [](https://www.npmjs.com/package/expand-object) [](https://travis-ci.org/jonschlinkert/expand-object)
|
|
|
|
> Expand a string into a JavaScript object using a simple notation. Use the CLI or as a node.js lib.
|
|
|
|
- [Install](#install)
|
|
* [Type casting](#type-casting)
|
|
- [Install](#install-1)
|
|
- [CLI](#cli)
|
|
- [node.js](#nodejs)
|
|
* [children](#children)
|
|
* [siblings](#siblings)
|
|
+ [general siblings](#general-siblings)
|
|
+ [adjacent siblings](#adjacent-siblings)
|
|
+ [difference between sibling types](#difference-between-sibling-types)
|
|
* [key-value pairs](#key-value-pairs)
|
|
* [arrays](#arrays)
|
|
- [Usage examples](#usage-examples)
|
|
- [Related projects](#related-projects)
|
|
- [Running tests](#running-tests)
|
|
- [Contributing](#contributing)
|
|
- [Author](#author)
|
|
- [License](#license)
|
|
|
|
_(TOC generated by [verb](https://github.com/verbose/verb) using [markdown-toc](https://github.com/jonschlinkert/markdown-toc))_
|
|
|
|
## Install
|
|
|
|
Install with [npm](https://www.npmjs.com/)
|
|
|
|
```sh
|
|
$ npm i expand-object --save
|
|
```
|
|
|
|
Also see [collapse-object](https://github.com/jonschlinkert/collapse-object), for doing the reverse of this library.
|
|
|
|
**Examples**
|
|
|
|
```js
|
|
expand('a')
|
|
//=> {a: ''}
|
|
|
|
expand('a.b')
|
|
//=> {a: {b: ''}}
|
|
|
|
expand('a|b')
|
|
//=> {a: '', b: ''}
|
|
|
|
expand('a|b', {toBoolean: true})
|
|
//=> {a: true, b: true}
|
|
|
|
expand('a:b')
|
|
//=> {a: 'b'}
|
|
|
|
expand('a,b')
|
|
//=> ['a', 'b']
|
|
```
|
|
|
|
### Type casting
|
|
|
|
Introduced in v0.2.2, some values are cast to their JavaScript type.
|
|
|
|
**Booleans**
|
|
|
|
If the value is `"true"` or `"false"` it will be coerced to a boolean value.
|
|
|
|
```js
|
|
expand('a:true')
|
|
//=> {a: true}
|
|
expand('a:false')
|
|
//=> {a: false}
|
|
```
|
|
|
|
**Numbers**
|
|
|
|
If the value is an integer it will be coerced to a number.
|
|
|
|
```js
|
|
expand('a:1')
|
|
//=> {a: 1}
|
|
expand('a:123')
|
|
//=> {a: 123}
|
|
```
|
|
|
|
**Regex**
|
|
|
|
If the value is a simple regular expression it will be coerced to a `new RegExp()`.
|
|
|
|
```js
|
|
expand('a:/foo/')
|
|
//=> {a: /foo/}
|
|
expand('a.b.c:/^bar/gmi')
|
|
//=> {a: {b: {c: /^bar/gmi}}}
|
|
```
|
|
|
|
## Install
|
|
|
|
Install with [npm](https://www.npmjs.com/)
|
|
|
|
```sh
|
|
$ npm i expand-object --save
|
|
```
|
|
|
|
## CLI
|
|
|
|
Usage with cli:
|
|
|
|
```sh
|
|
❯ expand-object --help
|
|
|
|
Usage: expand-object [options] <string>
|
|
|
|
Expand a string into a JavaScript object using a simple notation.
|
|
|
|
Options:
|
|
|
|
-h, --help output usage information
|
|
-V, --version output the version number
|
|
-r, --raw Output as raw javascript object - not stringified
|
|
|
|
Examples:
|
|
|
|
$ expand-object "a:b"
|
|
$ expand-object --raw "a:b"
|
|
$ echo "a:b" | expand-object
|
|
```
|
|
|
|
## node.js
|
|
|
|
To use as a node.js library:
|
|
|
|
```js
|
|
var expand = require('expand-object');
|
|
```
|
|
|
|
### children
|
|
|
|
> Expand dots into **child objects**:
|
|
|
|
```js
|
|
expand('a')
|
|
//=> {a: ''}
|
|
expand('a.b')
|
|
//=> {a: {b: ''}}
|
|
expand('a.b.c')
|
|
//=> {a: {b: {c: ''}}}
|
|
expand('a.b.c.d')
|
|
//=> {a: {b: {c: {d: ''}}}}
|
|
```
|
|
|
|
### siblings
|
|
|
|
expand-object supports two kinds of siblings, **general** and **adjacent**. It's much easier to understand the difference in the last example.
|
|
|
|
#### general siblings
|
|
|
|
> Use pipes (`|`) to expand **general siblings**:
|
|
|
|
```js
|
|
expand('a|b')
|
|
//=> {a: '', b: ''}
|
|
expand('a|b|c')
|
|
//=> {a: '', b: '', c: ''}
|
|
expand('a|b|c|d')
|
|
//=> {a: '', b: '', c: '', d: ''}
|
|
expand('a:b|c:d')
|
|
//=> {a: 'b', c: 'd'}
|
|
```
|
|
|
|
#### adjacent siblings
|
|
|
|
> Use plus (`+`) to expand **adjacent siblings**:
|
|
|
|
Adjacent siblings are objects that immediately follow one another.
|
|
|
|
```js
|
|
expand('a:b+c:d')
|
|
//=> {a: 'b', c: 'd'}
|
|
expand('a.b:c+d:e')
|
|
//=> {a: {b: 'c', d: 'e'}}
|
|
```
|
|
|
|
#### difference between sibling types
|
|
|
|
In the example below:
|
|
|
|
* **general**: `d` is a sibling to `a`
|
|
* **adjacent**: `d` is a sibling to `b`
|
|
|
|
```js
|
|
// general siblings
|
|
expand('a.b:c|d:e')
|
|
//=> { a: { b: 'c' }, d: 'e' }
|
|
|
|
// adjacent siblings
|
|
expand('a.b:c+d:e')
|
|
//=> { a: { b: 'c', d: 'e' } }
|
|
```
|
|
|
|
### key-value pairs
|
|
|
|
> Expand colons into **key-value pairs**:
|
|
|
|
```js
|
|
expand('a:b')
|
|
//=> {a: 'b'}
|
|
expand('a.b:c')
|
|
//=> {a: {b: 'c'}}
|
|
expand('a.b.c:d')
|
|
//=> {a: {b: {c: 'd'}}}
|
|
```
|
|
|
|
### arrays
|
|
|
|
> Expand comma separated values into **arrays**:
|
|
|
|
```js
|
|
expand('a,b')
|
|
//=> ['a', 'b']
|
|
expand('a,b,c')
|
|
//=> ['a', 'b', 'c']
|
|
expand('a:b,c,d|e:f,g,h')
|
|
//=> {a: ['b', 'c', 'd'], e: ['f', 'g', 'h']}
|
|
```
|
|
|
|
## Usage examples
|
|
|
|
Expand siblings with comma separated values into arrays:
|
|
|
|
```js
|
|
expand('a:b,c,d|e:f,g,h')
|
|
//=> {a: ['b', 'c', 'd'], e: ['f', 'g', 'h']}
|
|
```
|
|
|
|
Expand children with comma separated values into arrays:
|
|
|
|
```js
|
|
expand('a.b.c:d,e,f|g.h:i,j,k')
|
|
//=> {a: { b: {c: ['d', 'e', 'f']}}, g: {h: ['i', 'j', 'k']}}
|
|
```
|
|
|
|
Expand sibling objects into key-value pairs:
|
|
|
|
```js
|
|
expand('a:b|c:d')
|
|
//=> {a: 'b', c: 'd'}
|
|
expand('a:b|c:d|e:f')
|
|
//=> {a: 'b', c: 'd', e: 'f'}
|
|
expand('a:b|c:d|e:f|g:h')
|
|
//=> {a: 'b', c: 'd', e: 'f', g: 'h'}
|
|
```
|
|
|
|
Expand child objects into key-value pairs:
|
|
|
|
```js
|
|
expand('a.b:c')
|
|
//=> {a: {b: 'c'}}
|
|
expand('a.b.c:d')
|
|
//=> {a: {b: {c: 'd'}}}
|
|
expand('a.b.c.d:e')
|
|
//=> {a: {b: {c: {d: 'e'}}}}
|
|
```
|
|
|
|
Expand sibling and child objects into key-value pairs:
|
|
|
|
```js
|
|
expand('a:b|c:d')
|
|
//=> {a: 'b', c: 'd'}
|
|
expand('a.b.c|d.e:f')
|
|
//=> {a: {b: {c: ''}}, d: {e: 'f'}}
|
|
expand('a.b:c|d.e:f')
|
|
//=> {a: {b: 'c'}, d: {e: 'f'}}
|
|
expand('a.b.c:d|e.f.g:h')
|
|
//=> {a: {b: {c: 'd'}}, e: {f: {g: 'h'}}}
|
|
```
|
|
|
|
## Related projects
|
|
|
|
[expand-args](https://www.npmjs.com/package/expand-args): Expand parsed command line arguments using expand-object. | [homepage](https://github.com/jonschlinkert/expand-args)
|
|
|
|
## Running tests
|
|
|
|
Install dev dependencies:
|
|
|
|
```sh
|
|
$ npm i -d && npm test
|
|
```
|
|
|
|
## Contributing
|
|
|
|
Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](https://github.com/jonschlinkert/expand-object/issues/new).
|
|
|
|
## Author
|
|
|
|
**Jon Schlinkert**
|
|
|
|
* [github/jonschlinkert](https://github.com/jonschlinkert)
|
|
* [twitter/jonschlinkert](http://twitter.com/jonschlinkert)
|
|
|
|
## License
|
|
|
|
Copyright © 2015 [Jon Schlinkert](https://github.com/jonschlinkert)
|
|
Released under the MIT license.
|
|
|
|
***
|
|
|
|
_This file was generated by [verb](https://github.com/verbose/verb) on December 23, 2015._ |