minvws/horsebattery

A password generator inspired by https://xkcd.com/936/

Maintainers

Details

github.com/minvws/horsebattery

Installs: 51 046

Dependents: 1

Suggesters: 0

Security: 0

Stars: 8

Watchers: 21

Forks: 1

v1.1.3 2022-02-18 13:07 UTC

This package is auto-updated.

Last update: 2025-06-18 13:00:37 UTC


README

A password generator based on this XKCD comic. Provides a default word list in Dutch and will generate a password based on the wordlist and a given number of words.

May be expanded to include other locales in the future or configuration to allow for other word lists.

Requirements

  • PHP >= 8.1
  • Composer

Installation

  1. Install the package via composer:
composer require minvws/horsebattery

Usage

Generic usage

$generator = new HorseBattery();
$password = $generator->generate(4);

// returns for instance: AandeelBijkomendeDereguleringHandelingen

Running tests

You can run the tests by issuing the following command:

$ composer run test

Contributing

If you encounter any issues or have suggestions for improvements, please feel free to open an issue or submit a pull request on the GitHub repository of this package.

License

This package is open-source and released under the European Union Public License version 1.2. You are free to use, modify, and distribute the package in accordance with the terms of the license.