@grandom/string/README.md

A configurable, flexible, seedable, and overall great random string generator.

<h1 align="center">
  @grandom/string
</h1>

<br />

<!-- Badges - 1st row -->
<p align="center">
  <!-- NPM badge -->
  <a href="https://www.npmjs.com/package/@grandom/string"><img src="https://img.shields.io/npm/v/@grandom/string?color=brightgreen&logo=npm" alt="release-badge"></a>
  <!-- CI badge -->
  <a href="https://github.com/grandom-library/grandom-js/actions?query=workflow%3ACI"><img src="https://github.com/grandom-library/grandom-js/workflows/CI/badge.svg" alt="ci-badge"></a>
  <!-- Coverage badge -->
  <a href="https://app.codecov.io/gh/grandom-library/grandom-js/tree/main/packages"><img src="https://img.shields.io/codecov/c/github/grandom-library/grandom-js?flag=grandom-string&logo=codecov&logoColor=white" alt="coverage-badge"></a>
  <!-- Dependency badge -->
  <a href="https://github.com/grandom-library/grandom-js/pulls?q=is%3Apr+is%3Aopen+label%3Adependencies"><img src="https://img.shields.io/badge/Dependencies-✔-brightgreen.svg?logo=dependabot" alt="dependency-badge"></a>
  <!-- Security badge -->
  <a href="https://socket.dev/npm/package/@grandom/string"><img src="https://img.shields.io/badge/Security-✔-brightgreen.svg?logo=auth0&logoColor=white" alt="release-workflow-badge"></a> 
</p>

<!-- Badges - 2nd row -->
<p align="center">
  <!-- Code style badge -->
  <a href="https://www.npmjs.com/package/ts-standard"><img src="https://img.shields.io/badge/Code-TS--Standard-3178C6.svg?logo=typescript&logoColor=white" alt="code-style-badge"></a>
  <!-- Commit style badge -->
  <a href="https://github.com/semantic-release/semantic-release/blob/master/CONTRIBUTING.md#commit-message-guidelines"><img src="https://img.shields.io/badge/Commit-Conventional_Commits-EF7B4D.svg?logo=git&logoColor=white" alt="commit-style-badge"></a>
  <!-- Release workflow badge -->
  <a href="https://semantic-release.gitbook.io/semantic-release"><img src="https://img.shields.io/badge/Release-Semantic_Release-ED2B88.svg?logo=semanticweb&logoColor=white" alt="release-workflow-badge"></a>    
</p>

<!-- Badges - 3rd row -->
<p align="center">
  <!-- License badge -->
  <a href="https://github.com/grandom-library/grandom-js/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-brightgreen.svg?logo=github" alt="license-badge"></a>
  <!-- Contribution badge -->
  <a href="https://github.com/grandom-library/grandom-js/blob/main/.github/CONTRIBUTING.md"><img src="https://img.shields.io/badge/PRs-Welcome!-brightgreen.svg?logo=git&logoColor=white" alt="contribution-badge"></a>
</p>

---

<h3 align="center">
  The necessary random strings for your work.
</h3>

<p align="center">
  A configurable, flexible, and overall great<br/> <b>random 
  string generator</b> with an optional bias capability.
</p>

---

## 📦 Installation

```
npm i @grandom/string
```

## ⭐ Related

- [grandom on GitHub](https://github.com/grandom-library)
- [grandom on NPM](https://www.npmjs.com/search?q=keywords:grandom)

## 🍻 Contribution

**Any contribution is ***highly appreciated*****. To get going, check out the [**contribution guidelines**][url-contrib-doc].

***Thank you!***

## ©️ License

[MIT][url-license-doc] @ [Richard King](https://richrdkng.com)

<!--- References =============================================================================== -->

<!--- URLs -->
[url-license-doc]: https://github.com/grandom-library/grandom-js/blob/main/LICENSE
[url-contrib-doc]: https://github.com/grandom-library/grandom-js/blob/main/.github/CONTRIBUTING.md