# Qwerty
[](https://crates.io/crates/qwerty) [](https://crates.io/crates/qwerty) [](https://gitlab.com/starshell/passport/qwerty/blob/master/LICENSE) [](https://codecov.io/gl/starshell/qwerty)
Linux: [](https://gitlab.com/starshell/passport/qwerty/commits/master)
Windows: [](https://ci.appveyor.com/project/Eudoxier/qwerty/branch/master)
---
> Qwerty IS NOT READY TO BE USED FOR SECURE GENERATION OF PASSWORDS.
---
A password generation library.
## Usage
Add `qwerty` as a dependency in your `Cargo.toml` to use from crates.io:
```toml
[dependencies]
qwerty = "0.1.0"
```
Then add `extern crate qwerty;` to your crate root and run `cargo build` or `cargo update && cargo build` for your project. Documentation for all releases can be found on [docs.rs](https://docs.rs/qwerty/).
### Example
```rust
extern crate qwerty;
```
Examples can also be ran directly:
```sh
$ cargo run --example some_example
Finished dev [unoptimized + debuginfo] target(s) in 0.0 secs
Running `target/debug/examples/some_example`
```
See [examples](examples/) for more.
## Contributing
The project is mirrored to GitHub, but all development is done on GitLab. Please use the [GitLab issue tracker](https://gitlab.com/starshell/passport/qwerty/issues). Don't have a GitLab account? Just email `incoming+starshell/passport/qwerty@gitlab.com` and those emails automatically become issues (with the comments becoming the email conversation).
To contribute to qwerty, please see [CONTRIBUTING](CONTRIBUTING.md).
## License
Qwerty is distributed under the terms of the MPL 2.0 license. If this does not suit your needs for some reason please feel free to contact me, or open an issue.
See [LICENSE](LICENSE).