@stdlib/datasets-suthaharan-single-hop-sensor-network-cli 0.1.0

package/NOTICE

@@ -0,0 +1 @@
+Copyright (c) 2016-2023 The Stdlib Authors.

package/README.md

@@ -0,0 +1,215 @@
+<!--
+
+@license Apache-2.0
+
+Copyright (c) 2018 The Stdlib Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+-->
+
+
+<details>
+  <summary>
+    About stdlib...
+  </summary>
+  <p>We believe in a future in which the web is a preferred environment for numerical computation. To help realize this future, we've built stdlib. stdlib is a standard library, with an emphasis on numerical and scientific computation, written in JavaScript (and C) for execution in browsers and in Node.js.</p>
+  <p>The library is fully decomposable, being architected in such a way that you can swap out and mix and match APIs and functionality to cater to your exact preferences and use cases.</p>
+  <p>When you use stdlib, you can be absolutely certain that you are using the most thorough, rigorous, well-written, studied, documented, tested, measured, and high-quality code out there.</p>
+  <p>To join us in bringing numerical computing to the web, get started by checking us out on <a href="https://github.com/stdlib-js/stdlib">GitHub</a>, and please consider <a href="https://opencollective.com/stdlib">financially supporting stdlib</a>. We greatly appreciate your continued support!</p>
+</details>
+
+# Single-Hop Sensor Network
+
+[![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url] <!-- [![dependencies][dependencies-image]][dependencies-url] -->
+
+> Labeled wireless sensor network data set collected from a simple single-hop wireless sensor network deployment using TelosB motes.
+
+
+
+
+
+
+
+
+
+
+
+<section class="cli">
+
+
+
+<section class="installation">
+
+## Installation
+
+To use as a general utility, install the CLI package globally
+
+```bash
+npm install -g @stdlib/datasets-suthaharan-single-hop-sensor-network-cli
+```
+
+</section>
+
+<!-- CLI usage documentation. -->
+
+<section class="usage">
+
+## Usage
+
+```text
+Usage: suthaharan-single-hop-sensor-network [options]
+
+Options:
+
+  -h,    --help                Print this message.
+  -V,    --version             Print the package version.
+         --format fmt          Output format: 'csv' or 'ndjson'.
+```
+
+</section>
+
+<!-- /.usage -->
+
+<section class="examples">
+
+## Examples
+
+```bash
+$ suthaharan-single-hop-sensor-network
+```
+
+</section>
+
+<!-- /.examples -->
+
+</section>
+
+<!-- /.cli -->
+
+* * *
+
+<section class="references">
+
+## References
+
+-   Suthaharan, Shan, Mohammed Alzahrani, Sutharshan Rajasegarar, Christopher Leckie, and Marimuthu Palaniswami. 2010. "Labelled data collection for anomaly detection in wireless sensor networks." In _Proceedings of the Sixth International Conference on Intelligent Sensors, Sensor Networks and Information Processing (ISSNIP 2010)_. Brisbane, Australia: IEEE.
+
+</section>
+
+<!-- /.references -->
+
+<!-- <license> -->
+
+## License
+
+The data files (databases) are licensed under an [Open Data Commons Attribution 1.0 License][odc-by-1.0] and their contents are licensed under a [Creative Commons Attribution 4.0 International Public License][cc-by-4.0]. The original dataset is attributed to Shan Suthaharan, Mohammed Alzahrani, Sutharshan Rajasegarar, Christopher Leckie, and Marimuthu Palaniswami and can be found [here][suthaharan-single-hop-sensor-network-data]. The software is licensed under [Apache License, Version 2.0][apache-license].
+
+<!-- </license> -->
+
+<!-- Section for related `stdlib` packages. Do not manually edit this section, as it is automatically populated. -->
+
+<section class="related">
+
+## See Also
+
+-   <span class="package-name">[`@stdlib/datasets-suthaharan-single-hop-sensor-network`][@stdlib/datasets-suthaharan-single-hop-sensor-network]</span><span class="delimiter">: </span><span class="description">labeled wireless sensor network data set collected from a simple single-hop wireless sensor network deployment using TelosB motes.</span>
+-   <span class="package-name">[`@stdlib/datasets-suthaharan-multi-hop-sensor-network`][@stdlib/datasets/suthaharan-multi-hop-sensor-network]</span><span class="delimiter">: </span><span class="description">labeled wireless sensor network data set collected from a multi-hop wireless sensor network deployment using TelosB motes.</span>
+
+</section>
+
+<!-- /.related -->
+
+<!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+
+<section class="main-repo" >
+
+* * *
+
+## Notice
+
+This package is part of [stdlib][stdlib], a standard library for JavaScript and Node.js, with an emphasis on numerical and scientific computing. The library provides a collection of robust, high performance libraries for mathematics, statistics, streams, utilities, and more.
+
+For more information on the project, filing bug reports and feature requests, and guidance on how to develop [stdlib][stdlib], see the main project [repository][stdlib].
+
+### Community
+
+[![Chat][chat-image]][chat-url]
+
+---
+
+## Copyright
+
+Copyright &copy; 2016-2023. The Stdlib [Authors][stdlib-authors].
+
+</section>
+
+<!-- /.stdlib -->
+
+<!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="links">
+
+[npm-image]: http://img.shields.io/npm/v/@stdlib/datasets-suthaharan-single-hop-sensor-network-cli.svg
+[npm-url]: https://npmjs.org/package/@stdlib/datasets-suthaharan-single-hop-sensor-network-cli
+
+[test-image]: https://github.com/stdlib-js/datasets-suthaharan-single-hop-sensor-network/actions/workflows/test.yml/badge.svg?branch=v0.1.0
+[test-url]: https://github.com/stdlib-js/datasets-suthaharan-single-hop-sensor-network/actions/workflows/test.yml?query=branch:v0.1.0
+
+[coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/datasets-suthaharan-single-hop-sensor-network/main.svg
+[coverage-url]: https://codecov.io/github/stdlib-js/datasets-suthaharan-single-hop-sensor-network?branch=main
+
+<!--
+
+[dependencies-image]: https://img.shields.io/david/stdlib-js/datasets-suthaharan-single-hop-sensor-network.svg
+[dependencies-url]: https://david-dm.org/stdlib-js/datasets-suthaharan-single-hop-sensor-network/main
+
+-->
+
+[chat-image]: https://img.shields.io/gitter/room/stdlib-js/stdlib.svg
+[chat-url]: https://app.gitter.im/#/room/#stdlib-js_stdlib:gitter.im
+
+[stdlib]: https://github.com/stdlib-js/stdlib
+
+[stdlib-authors]: https://github.com/stdlib-js/stdlib/graphs/contributors
+
+[cli-section]: https://github.com/stdlib-js/datasets-suthaharan-single-hop-sensor-network#cli
+[cli-url]: https://github.com/stdlib-js/datasets-suthaharan-single-hop-sensor-network/tree/cli
+[@stdlib/datasets-suthaharan-single-hop-sensor-network]: https://www.npmjs.com/package/@stdlib/datasets-suthaharan-single-hop-sensor-network
+
+[umd]: https://github.com/umdjs/umd
+[es-module]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules
+
+[deno-url]: https://github.com/stdlib-js/datasets-suthaharan-single-hop-sensor-network/tree/deno
+[umd-url]: https://github.com/stdlib-js/datasets-suthaharan-single-hop-sensor-network/tree/umd
+[esm-url]: https://github.com/stdlib-js/datasets-suthaharan-single-hop-sensor-network/tree/esm
+[branches-url]: https://github.com/stdlib-js/datasets-suthaharan-single-hop-sensor-network/blob/main/branches.md
+
+[suthaharan-single-hop-sensor-network-data]: http://www.uncg.edu/cmp/downloads/lwsndr.html
+
+[odc-by-1.0]: http://opendatacommons.org/licenses/by/1.0/
+
+[cc-by-4.0]: http://creativecommons.org/licenses/by/4.0/
+
+[apache-license]: https://www.apache.org/licenses/LICENSE-2.0
+
+<!-- <related-links> -->
+
+[@stdlib/datasets/suthaharan-multi-hop-sensor-network]: https://www.npmjs.com/package/@stdlib/datasets-suthaharan-multi-hop-sensor-network
+
+<!-- </related-links> -->
+
+</section>
+
+<!-- /.links -->

package/bin/cli

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2018 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var createReadStream = require( 'fs' ).createReadStream;
+var resolve = require( 'path' ).resolve;
+var readFileSync = require( '@stdlib/fs-read-file' ).sync;
+var stdout = require( '@stdlib/streams-node-stdout' );
+var CLI = require( '@stdlib/cli-ctor' );
+
+
+// MAIN //
+
+/**
+* Main execution sequence.
+*
+* @private
+*/
+function main() {
+	var flags;
+	var cli;
+
+	// Create a command-line interface:
+	cli = new CLI({
+		'pkg': require( './../package.json' ),
+		'options': require( './../etc/cli_opts.json' ),
+		'help': readFileSync( resolve( __dirname, '..', 'docs', 'usage.txt' ), {
+			'encoding': 'utf8'
+		})
+	});
+
+	// Get any provided command-line options:
+	flags = cli.flags();
+	if ( flags.help || flags.version ) {
+		return;
+	}
+	if ( flags.format === 'ndjson' ) {
+		ndjson();
+	} else {
+		csv();
+	}
+
+	/**
+	* Prints data as newline-delimited JSON (ndjson).
+	*
+	* @private
+	*/
+	function ndjson() {
+		var data;
+		var i;
+
+		data = require( './../data/data.json' );
+		for ( i = 0; i < data.length; i++ ) {
+			console.log( JSON.stringify( data[i] ) ); // eslint-disable-line no-console
+		}
+	}
+
+	/**
+	* Prints data as lines of comma-separated values (CSV).
+	*
+	* @private
+	*/
+	function csv() {
+		var fpath = resolve( __dirname, '..', 'data', 'data.csv' );
+		createReadStream( fpath )
+			.pipe( stdout )
+			.on( 'close', onClose );
+	}
+
+	/**
+	* Exits the CLI.
+	*
+	* @private
+	*/
+	function onClose() {
+		cli.close( 0 );
+	}
+}
+
+main();

package/docs/usage.txt

@@ -0,0 +1,9 @@
+
+Usage: suthaharan-single-hop-sensor-network [options]
+
+Options:
+
+  -h,    --help                Print this message.
+  -V,    --version             Print the package version.
+         --format fmt          Output format: 'csv' or 'ndjson'.
+

package/etc/cli_opts.json

@@ -0,0 +1,17 @@
+{
+	"string": [
+		"format"
+	],
+	"boolean": [
+		"help",
+		"version"
+	],
+	"alias": {
+		"help": [
+			"h"
+		],
+		"version": [
+			"V"
+		]
+	}
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@stdlib/datasets-suthaharan-single-hop-sensor-network-cli",
+  "version": "0.1.0",
+  "description": "Labeled wireless sensor network data set collected from a simple single-hop wireless sensor network deployment using TelosB motes.",
+  "license": "Apache-2.0",
+  "author": {
+    "name": "The Stdlib Authors",
+    "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+  },
+  "contributors": [
+    {
+      "name": "The Stdlib Authors",
+      "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+    }
+  ],
+  "bin": {
+    "suthaharan-single-hop-sensor-network": "./bin/cli"
+  },
+  "homepage": "https://stdlib.io",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/stdlib-js/datasets-suthaharan-single-hop-sensor-network.git"
+  },
+  "bugs": {
+    "url": "https://github.com/stdlib-js/stdlib/issues"
+  },
+  "dependencies": {
+    "@stdlib/cli-ctor": "^0.1.0",
+    "@stdlib/fs-read-file": "^0.1.0",
+    "@stdlib/streams-node-stdout": "^0.1.0"
+  },
+  "devDependencies": {
+    "@stdlib/assert-is-browser": "^0.1.0",
+    "@stdlib/assert-is-windows": "^0.1.0",
+    "@stdlib/process-exec-path": "^0.1.0",
+    "@stdlib/regexp-eol": "^0.1.0",
+    "proxyquire": "^2.0.0",
+    "tape": "git+https://github.com/kgryte/tape.git#fix/globby",
+    "istanbul": "^0.4.1",
+    "tap-min": "git+https://github.com/Planeshifter/tap-min.git"
+  },
+  "keywords": [
+    "stdlib",
+    "datasets",
+    "dataset",
+    "data",
+    "sample",
+    "sensor",
+    "network",
+    "machine learning",
+    "ml",
+    "labeled",
+    "mote",
+    "motes",
+    "outliers",
+    "outlier",
+    "statistics",
+    "stats"
+  ],
+  "funding": {
+    "type": "opencollective",
+    "url": "https://opencollective.com/stdlib"
+  }
+}

package/test/test.cli.js

@@ -0,0 +1,208 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2018 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var resolve = require( 'path' ).resolve;
+var exec = require( 'child_process' ).exec;
+var tape = require( 'tape' );
+var IS_BROWSER = require( '@stdlib/assert-is-browser' );
+var IS_WINDOWS = require( '@stdlib/assert-is-windows' );
+var EXEC_PATH = require( '@stdlib/process-exec-path' );
+var RE_EOL = require( '@stdlib/regexp-eol' ).REGEXP;
+var readFileSync = require( '@stdlib/fs-read-file' ).sync;
+
+
+// VARIABLES //
+
+var fpath = resolve( __dirname, '..', 'bin', 'cli' );
+var opts = {
+	'skip': IS_BROWSER || IS_WINDOWS
+};
+
+
+// FIXTURES //
+
+var PKG_VERSION = require( './../package.json' ).version;
+
+
+// TESTS //
+
+tape( 'command-line interface', function test( t ) {
+	t.ok( true, __filename );
+	t.end();
+});
+
+tape( 'when invoked with a `--help` flag, the command-line interface prints the help text to `stderr`', opts, function test( t ) {
+	var expected;
+	var cmd;
+
+	expected = readFileSync( resolve( __dirname, '..', 'docs', 'usage.txt' ), {
+		'encoding': 'utf8'
+	});
+	cmd = [
+		EXEC_PATH,
+		fpath,
+		'--help'
+	];
+
+	exec( cmd.join( ' ' ), done );
+
+	function done( error, stdout, stderr ) {
+		if ( error ) {
+			t.fail( error.message );
+		} else {
+			t.strictEqual( stdout.toString(), '', 'does not print to `stdout`' );
+			t.strictEqual( stderr.toString(), expected+'\n', 'expected value' );
+		}
+		t.end();
+	}
+});
+
+tape( 'when invoked with a `-h` flag, the command-line interface prints the help text to `stderr`', opts, function test( t ) {
+	var expected;
+	var cmd;
+
+	expected = readFileSync( resolve( __dirname, '..', 'docs', 'usage.txt' ), {
+		'encoding': 'utf8'
+	});
+	cmd = [
+		EXEC_PATH,
+		fpath,
+		'-h'
+	];
+
+	exec( cmd.join( ' ' ), done );
+
+	function done( error, stdout, stderr ) {
+		if ( error ) {
+			t.fail( error.message );
+		} else {
+			t.strictEqual( stdout.toString(), '', 'does not print to `stdout`' );
+			t.strictEqual( stderr.toString(), expected+'\n', 'expected value' );
+		}
+		t.end();
+	}
+});
+
+tape( 'when invoked with a `--version` flag, the command-line interface prints the version to `stderr`', opts, function test( t ) {
+	var cmd = [
+		EXEC_PATH,
+		fpath,
+		'--version'
+	];
+
+	exec( cmd.join( ' ' ), done );
+
+	function done( error, stdout, stderr ) {
+		if ( error ) {
+			t.fail( error.message );
+		} else {
+			t.strictEqual( stdout.toString(), '', 'does not print to `stdout`' );
+			t.strictEqual( stderr.toString(), PKG_VERSION+'\n', 'expected value' );
+		}
+		t.end();
+	}
+});
+
+tape( 'when invoked with a `-V` flag, the command-line interface prints the version to `stderr`', opts, function test( t ) {
+	var cmd = [
+		EXEC_PATH,
+		fpath,
+		'-V'
+	];
+
+	exec( cmd.join( ' ' ), done );
+
+	function done( error, stdout, stderr ) {
+		if ( error ) {
+			t.fail( error.message );
+		} else {
+			t.strictEqual( stdout.toString(), '', 'does not print to `stdout`' );
+			t.strictEqual( stderr.toString(), PKG_VERSION+'\n', 'expected value' );
+		}
+		t.end();
+	}
+});
+
+tape( 'the command-line interface prints the dataset as comma-separated values', opts, function test( t ) {
+	var expected;
+	var opts;
+	var cmd;
+
+	cmd = [
+		EXEC_PATH,
+		fpath
+	];
+
+	expected = readFileSync( resolve( __dirname, '..', 'data', 'data.csv' ) );
+
+	opts = {
+		'maxBuffer': 50000*1024
+	};
+	exec( cmd.join( ' ' ), opts, done );
+
+	function done( error, stdout, stderr ) {
+		if ( error ) {
+			t.fail( error.message );
+		} else {
+			stdout = stdout.toString();
+			expected = expected.toString();
+			t.strictEqual( stdout, expected, 'prints CSV' );
+			t.strictEqual( stderr.toString(), '', 'does not print to `stderr`' );
+		}
+		t.end();
+	}
+});
+
+tape( 'the command-line interface prints the dataset as newline-delimited JSON', opts, function test( t ) {
+	var expected;
+	var opts;
+	var cmd;
+
+	cmd = [
+		EXEC_PATH,
+		fpath,
+		'--format ndjson'
+	];
+
+	expected = require( './../data/data.json' );
+
+	opts = {
+		'maxBuffer': 50000*1024
+	};
+	exec( cmd.join( ' ' ), opts, done );
+
+	function done( error, stdout, stderr ) {
+		var str;
+		var i;
+		if ( error ) {
+			t.fail( error.message );
+		} else {
+			stdout = stdout.toString().split( RE_EOL );
+			for ( i = 0; i < expected.length; i++ ) {
+				str = JSON.stringify( expected[ i ] );
+				t.strictEqual( stdout[ i ], str, 'returns expected JSON string' );
+			}
+			t.strictEqual( stderr.toString(), '', 'does not print to `stderr`' );
+		}
+		t.end();
+	}
+});