Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add support for testing whether a value is a constant-cased string (#540
) * Add readme.md * Add README.md * add package.json * Add lib * Add examples * Add etc * Add docs * Add bin * add benchmark * Add test.js * add test/fixtures * Add test.cli.js * add test.cli.js * update bin/cli * add test.cli.js * performed suggested changes * Fix example * Fix example * Update description * Update descriptions * Update descriptions Co-authored-by: Philipp Burckhardt <pburckhardt@outlook.com> Co-authored-by: Athan <kgryte@gmail.com>
- Loading branch information
1 parent
ebb5347
commit 4b64ebb
Showing
15 changed files
with
1,104 additions
and
0 deletions.
There are no files selected for viewing
202 changes: 202 additions & 0 deletions
202
lib/node_modules/@stdlib/assert/is-constantcase/README.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,202 @@ | ||
<!-- | ||
@license Apache-2.0 | ||
Copyright (c) 2022 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. | ||
--> | ||
|
||
# isConstantcase | ||
|
||
> Test if a value is a constantcase string. | ||
<section class="usage"> | ||
|
||
## Usage | ||
|
||
```javascript | ||
var isConstantcase = require( '@stdlib/assert/is-constantcase' ); | ||
``` | ||
|
||
#### isConstantcase( value ) | ||
|
||
Tests if a `value` is a constantcase `string`. | ||
|
||
```javascript | ||
var bool = isConstantcase( 'BEEP_BOOP' ); | ||
// returns true | ||
|
||
bool = isConstantcase( 'BEEP and BOOP' ); | ||
// returns false | ||
``` | ||
|
||
</section> | ||
|
||
<!-- /.usage --> | ||
|
||
<section class="notes"> | ||
|
||
## Notes | ||
|
||
- The function validates that a `value` is a `string`. For all other types, the function returns `false`. | ||
|
||
</section> | ||
|
||
<!-- /.notes --> | ||
|
||
<section class="examples"> | ||
|
||
## Examples | ||
|
||
<!-- eslint no-undef: "error" --> | ||
|
||
```javascript | ||
var isConstantcase = require( '@stdlib/assert/is-constantcase' ); | ||
|
||
console.log( isConstantcase( 'BEEP_BOOP' ) ); | ||
// => true | ||
|
||
console.log( isConstantcase( 'BEEP and BOOP' ) ); | ||
// => false | ||
|
||
console.log( isConstantcase( 'BEEP_BOOP_BEEP' ) ); | ||
// => true | ||
|
||
console.log( isConstantcase( 'b' ) ); | ||
// => false | ||
|
||
console.log( isConstantcase( 'B' ) ); | ||
// => true | ||
|
||
console.log( isConstantcase( '!' ) ); | ||
// => false | ||
|
||
console.log( isConstantcase( 'beep boop' ) ); | ||
// => false | ||
|
||
``` | ||
|
||
</section> | ||
|
||
<!-- /.examples --> | ||
|
||
* * * | ||
|
||
<section class="cli"> | ||
|
||
## CLI | ||
|
||
<section class="usage"> | ||
|
||
### Usage | ||
|
||
```text | ||
Usage: is-constantcase [options] [<string>] | ||
Options: | ||
-h, --help Print this message. | ||
-V, --version Print the package version. | ||
--split sep Delimiter for stdin data. Default: '/\\r?\\n/'. | ||
``` | ||
|
||
</section> | ||
|
||
<!-- /.usage --> | ||
|
||
<!-- CLI usage notes. Make sure to keep an empty line after the `section` element and another before the `/section` close. --> | ||
|
||
<section class="notes"> | ||
|
||
### Notes | ||
|
||
- If the split separator is a [regular expression][mdn-regexp], ensure that the `split` option is either properly escaped or enclosed in quotes. | ||
|
||
```bash | ||
# Not escaped... | ||
$ echo -n $'beEp booP\nFOO' | is-constantcase --split /\r?\n/ | ||
# Escaped... | ||
$ echo -n $'beEp booP\nFOO' | is-constantcase --split /\\r?\\n/ | ||
``` | ||
|
||
- The implementation ignores trailing delimiters. | ||
|
||
</section> | ||
|
||
<!-- /.notes --> | ||
|
||
<section class="examples"> | ||
|
||
### Examples | ||
|
||
```bash | ||
$ is-constantcase BEEP_BOOP | ||
true | ||
``` | ||
|
||
To use as a [standard stream][standard-streams], | ||
|
||
```bash | ||
$ echo -n 'beep Boop' | is-constantcase | ||
false | ||
``` | ||
|
||
By default, when used as a [standard stream][standard-streams], the implementation assumes newline-delimited data. To specify an alternative delimiter, set the `split` option. | ||
|
||
```bash | ||
$ echo -n 'beepBoop\tBEEP_BOOP' | is-constantcase --split '\t' | ||
false | ||
true | ||
``` | ||
|
||
</section> | ||
|
||
<!-- /.examples --> | ||
|
||
</section> | ||
|
||
<!-- /.cli --> | ||
|
||
<!-- 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/assert/is-string`][@stdlib/assert/is-string]</span><span class="delimiter">: </span><span class="description">test if a value is a string.</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="links"> | ||
|
||
[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams | ||
|
||
[mdn-regexp]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions | ||
|
||
<!-- <related-links> --> | ||
|
||
[@stdlib/assert/is-string]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/assert/is-string | ||
|
||
<!-- </related-links> --> | ||
|
||
</section> | ||
|
||
<!-- /.links --> |
59 changes: 59 additions & 0 deletions
59
lib/node_modules/@stdlib/assert/is-constantcase/benchmark/benchmark.js
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,59 @@ | ||
/* | ||
* @license Apache-2.0 | ||
* | ||
* Copyright (c) 2022 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 bench = require( '@stdlib/bench' ); | ||
var isBoolean = require( '@stdlib/assert/is-boolean' ).isPrimitive; | ||
var pkg = require( './../package.json' ).name; | ||
var isConstantcase = require( './../lib' ); | ||
|
||
|
||
// MAIN // | ||
|
||
bench( pkg, function benchmark( b ) { | ||
var values; | ||
var bool; | ||
var i; | ||
|
||
values = [ | ||
'', | ||
'BEEP_BOOP', | ||
'beep_boop', | ||
'BEEP-BOOP', | ||
'beep boop', | ||
'beep', | ||
null | ||
]; | ||
|
||
b.tic(); | ||
for ( i = 0; i < b.iterations; i++ ) { | ||
bool = isConstantcase( values[ i % values.length ] ); | ||
if ( typeof bool !== 'boolean' ) { | ||
b.fail( 'should return a boolean' ); | ||
} | ||
} | ||
b.toc(); | ||
if ( !isBoolean( bool ) ) { | ||
b.fail( 'should return a boolean' ); | ||
} | ||
b.pass( 'benchmark finished' ); | ||
b.end(); | ||
}); |
108 changes: 108 additions & 0 deletions
108
lib/node_modules/@stdlib/assert/is-constantcase/bin/cli
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,108 @@ | ||
#!/usr/bin/env node | ||
|
||
/** | ||
* @license Apache-2.0 | ||
* | ||
* Copyright (c) 2022 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 readFileSync = require( '@stdlib/fs/read-file' ).sync; | ||
var CLI = require( '@stdlib/cli/ctor' ); | ||
var stdin = require( '@stdlib/process/read-stdin' ); | ||
var stdinStream = require( '@stdlib/streams/node/stdin' ); | ||
var RE_EOL = require( '@stdlib/regexp/eol' ).REGEXP; | ||
var isRegExpString = require( '@stdlib/assert/is-regexp-string' ); | ||
var reFromString = require( '@stdlib/utils/regexp-from-string' ); | ||
var isConstantcase = require( './../lib' ); | ||
|
||
|
||
// MAIN // | ||
|
||
/** | ||
* Main execution sequence. | ||
* | ||
* @private | ||
* @returns {void} | ||
*/ | ||
function main() { | ||
var split; | ||
var flags; | ||
var args; | ||
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; | ||
} | ||
|
||
// Get any provided command-line arguments: | ||
args = cli.args(); | ||
|
||
// Check if we are receiving data from `stdin`... | ||
if ( !stdinStream.isTTY ) { | ||
if ( flags.split ) { | ||
if ( !isRegExpString( flags.split ) ) { | ||
flags.split = '/'+flags.split+'/'; | ||
} | ||
split = reFromString( flags.split ); | ||
} else { | ||
split = RE_EOL; | ||
} | ||
return stdin( onRead ); | ||
} | ||
console.log( isConstantcase( args[ 0 ] ) ); // eslint-disable-line no-console | ||
|
||
/** | ||
* Callback invoked upon reading from `stdin`. | ||
* | ||
* @private | ||
* @param {(Error|null)} error - error object | ||
* @param {(string|Buffer)} data - data | ||
* @returns {void} | ||
*/ | ||
function onRead( error, data ) { | ||
var lines; | ||
var i; | ||
if ( error ) { | ||
return cli.error( error ); | ||
} | ||
lines = data.toString().split( split ); | ||
|
||
// Remove any trailing separators (e.g., trailing newline)... | ||
if ( lines[ lines.length-1 ] === '' ) { | ||
lines.pop(); | ||
} | ||
for ( i = 0; i < lines.length; i++ ) { | ||
console.log( isConstantcase( lines[ i ] ) ); // eslint-disable-line no-console | ||
} | ||
} | ||
} | ||
|
||
main(); |
23 changes: 23 additions & 0 deletions
23
lib/node_modules/@stdlib/assert/is-constantcase/docs/repl.txt
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,23 @@ | ||
|
||
{{alias}}( value ) | ||
Tests if a value is a constantcase string. | ||
|
||
Parameters | ||
---------- | ||
value: any | ||
Value to test. | ||
|
||
Returns | ||
------- | ||
bool: boolean | ||
Boolean indicating whether a value is a constantcase string. | ||
|
||
Examples | ||
-------- | ||
> var bool = {{alias}}( 'BEEP_BOOP' ) | ||
true | ||
> bool = {{alias}}( 'BEEP and BOOP' ) | ||
false | ||
|
||
See Also | ||
-------- |
Oops, something went wrong.