https://github.com/iphoting/pwqgen.rb

pwqgen.rb is a Ruby implementation of passwdqc's pwqgen, a random pronouncable password generator.
https://github.com/iphoting/pwqgen.rb

gem passphrase-generator passwdqc-pwqgen password-generator ruby

Last synced: about 1 month ago
JSON representation

pwqgen.rb is a Ruby implementation of passwdqc's pwqgen, a random pronouncable password generator.

• Host: GitHub
• URL: https://github.com/iphoting/pwqgen.rb
• Owner: iphoting
• Created: 2012-06-28T14:46:20.000Z (over 12 years ago)
• Default Branch: develop
• Last Pushed: 2023-09-12T17:55:23.000Z (about 1 year ago)
• Last Synced: 2024-09-29T21:01:34.361Z (about 1 month ago)
• Topics: gem, passphrase-generator, passwdqc-pwqgen, password-generator, ruby
• Language: Ruby
• Homepage: https://rubygems.org/gems/pwqgen.rb/
• Size: 486 KB
• Stars: 6
• Watchers: 3
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: ChangeLog

Awesome Lists containing this project

README

        
# pwqgen.rb

![GitHub Action Tests](https://github.com/iphoting/pwqgen.rb/actions/workflows/test.yml/badge.svg) [![Gem Version](https://badge.fury.io/rb/pwqgen.rb.svg)](https://badge.fury.io/rb/pwqgen.rb)

pwqgen.rb is a Ruby implementation of passwdqc's pwqgen, a random pronouncable password generator.

## Installation

```

gem install pwqgen.rb

```

## Usage

### CLI

You can generate a random password from the command line.

```

$ pwqgen.rb --help

Usage: pwqgen.rb [options] []

Options:

  -h, --help      show this help message and exit

  -v, --version   show version and exit

: Number of words in the passphrase. [default: 3]

```

### Ruby App

You can `require` it within your app:

```

require 'rubygems'

require 'pwqgen'

p Pwqgen.generate             # => "Image&Both-action"

p Pwqgen.generate 5           # => "Alaska_Union9Calf=domain&ever"

pgen = Pwqgen.new             # => #

p pgen.generate               # => "String5Rebel+horse"

p pgen.generate 2             # => "Easily2desist"

```

## Contributing

1. Fork it

2. Create your feature branch (`git checkout -b feature/my-new-feature`)

3. Commit your changes (`git commit -am 'Add some feature'`)

4. Push to the branch (`git push origin feature/my-new-feature`)

5. Create new Pull Request

## Related

- A web-based demonstration is available on [Heroku](https://pwqgen.herokuapp.com/). ([Source](https://github.com/iphoting/pwqgen-web)).

- Original C Implementation, .

## Credits

- Original Design and C implementation from  by Solar Designer.