@stdlib/string-capitalize - npm Package Compare versions

Comparing version 0.0.7 to 0.0.8

docs/usage.txt

@@ -8,1 +8,2 @@
   -V,    --version             Print the package version.
+         --split sep           Delimiter for stdin data. Default: '/\\r?\\n/'.

etc/cli_opts.json

 {
+	"string": [
+		"split"
+	],
 	"boolean": [
@@ -3,0 +6,0 @@ "help",

NOTICE

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

package.json

 {
   "name": "@stdlib/string-capitalize",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "Capitalize the first character in a string.",
@@ -43,2 +43,3 @@ "license": "Apache-2.0",
   "dependencies": {
+    "@stdlib/assert-is-regexp-string": "^0.0.x",
     "@stdlib/assert-is-string": "^0.0.x",
@@ -49,3 +50,4 @@ "@stdlib/cli-ctor": "^0.0.x",
     "@stdlib/regexp-eol": "^0.0.x",
-    "@stdlib/streams-node-stdin": "^0.0.x"
+    "@stdlib/streams-node-stdin": "^0.0.x",
+    "@stdlib/utils-regexp-from-string": "^0.0.x"
   },
@@ -52,0 +54,0 @@ "devDependencies": {

README.md

@@ -23,3 +23,3 @@ <!--
 
-[![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url] [![dependencies][dependencies-image]][dependencies-url]
+[![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url] <!-- [![dependencies][dependencies-image]][dependencies-url] -->
 
@@ -108,2 +108,4 @@ > Capitalize the first character in a string.
 
+<!-- CLI usage documentation. -->
+
 <section class="usage">
@@ -120,2 +122,3 @@
   -V,    --version             Print the package version.
+         --split sep           Delimiter for stdin data. Default: '/\\r?\\n/'.
 ```
@@ -127,2 +130,24 @@
 
+<!-- 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\nboop' | capitalize --split /\r?\n/
+
+    # Escaped...
+    $ echo -n $'beep\nboop' | capitalize --split /\\r?\\n/
+    ```
+
+-   The implementation ignores trailing delimiters.
+
+</section>
+
+<!-- /.notes -->
+
 <section class="examples">
@@ -144,2 +169,10 @@
 
+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 'beep\tbOOP' | capitalize --split '\t'
+Beep
+BOOP
+```
+
 </section>
@@ -153,3 +186,20 @@
 
+<!-- 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/string/uncapitalize`][@stdlib/string/uncapitalize]</span><span class="delimiter">: </span><span class="description">uncapitalize the first character of a string.</span>
+-   <span class="package-name">[`@stdlib/string/uppercase`][@stdlib/string/uppercase]</span><span class="delimiter">: </span><span class="description">convert a string to uppercase.</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" >
@@ -178,3 +228,3 @@
 
-Copyright &copy; 2016-2021. The Stdlib [Authors][stdlib-authors].
+Copyright &copy; 2016-2022. The Stdlib [Authors][stdlib-authors].
 
@@ -198,5 +248,16 @@ </section>
 
+<!--
+
 [dependencies-image]: https://img.shields.io/david/stdlib-js/string-capitalize.svg
 [dependencies-url]: https://david-dm.org/stdlib-js/string-capitalize/main
 
+-->
+
+[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/string-capitalize/tree/deno
+[umd-url]: https://github.com/stdlib-js/string-capitalize/tree/umd
+[esm-url]: https://github.com/stdlib-js/string-capitalize/tree/esm
+
 [chat-image]: https://img.shields.io/gitter/room/stdlib-js/stdlib.svg
@@ -213,4 +274,14 @@ [chat-url]: https://gitter.im/stdlib-js/stdlib/
 
+[mdn-regexp]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions
+
+<!-- <related-links> -->
+
+[@stdlib/string/uncapitalize]: https://www.npmjs.com/package/@stdlib/string-uncapitalize
+
+[@stdlib/string/uppercase]: https://www.npmjs.com/package/@stdlib/string-uppercase
+
+<!-- </related-links> -->
+
 </section>
 
 <!-- /.links -->

New alerts

Unidentified License

License

Something that seems like a license was found, but its contents could not be matched with a known license.

Found 1 instance in 1 package

Fixed alerts

Unidentified License

License

Something that seems like a license was found, but its contents could not be matched with a known license.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

41632

7.75%

Lines of code

189

1.61%

Number of lines in readme file

279

34.13%

Worsened metrics

Dependency count

8

33.33%

Dependency changes

• + Added

  @stdlib/assert-is-regexp-string@^0.0.x

• + Added

  @stdlib/utils-regexp-from-string@^0.0.x

• + Added

  @stdlib/assert-is-regexp-string@0.0.9
  (transitive)

• + Added

  @stdlib/regexp-regexp@0.0.8
  (transitive)

• + Added

  @stdlib/utils-regexp-from-string@0.0.9
  (transitive)