{"id":32136942,"url":"https://github.com/ulif/diceware","last_synced_at":"2025-10-21T04:52:27.275Z","repository":{"id":26434142,"uuid":"29884754","full_name":"ulif/diceware","owner":"ulif","description":"Passphrases to remember","archived":false,"fork":false,"pushed_at":"2025-07-21T23:34:35.000Z","size":1168,"stargazers_count":384,"open_issues_count":23,"forks_count":49,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-09-30T12:29:55.638Z","etag":null,"topics":["diceware","passphrase","password","python"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ulif.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGES.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-01-26T22:22:10.000Z","updated_at":"2025-09-23T13:23:13.000Z","dependencies_parsed_at":"2023-01-14T04:38:54.606Z","dependency_job_id":"89401a67-6ace-4629-99ba-5ac64726be53","html_url":"https://github.com/ulif/diceware","commit_stats":{"total_commits":704,"total_committers":16,"mean_commits":44.0,"dds":0.03693181818181823,"last_synced_commit":"992cfb69e76983812e8ace311d042704dcf20cf8"},"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/ulif/diceware","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ulif%2Fdiceware","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ulif%2Fdiceware/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ulif%2Fdiceware/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ulif%2Fdiceware/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ulif","download_url":"https://codeload.github.com/ulif/diceware/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ulif%2Fdiceware/sbom","scorecard":{"id":907980,"data":{"date":"2025-08-11","repo":{"name":"github.com/ulif/diceware","commit":"109df8b50720fd9ee60b414eecb4a097b3b2ba06"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.7,"checks":[{"name":"Maintained","score":3,"reason":"3 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 3","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":0,"reason":"Found 1/28 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/tests.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/ulif/diceware/tests.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/ulif/diceware/tests.yml/master?enable=pin","Warn: pipCommand not pinned by hash: .github/workflows/tests.yml:36","Warn: pipCommand not pinned by hash: .github/workflows/tests.yml:37","Info:   0 out of   2 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   2 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: GNU General Public License v3.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 3 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-24T18:03:33.057Z","repository_id":26434142,"created_at":"2025-08-24T18:03:33.057Z","updated_at":"2025-08-24T18:03:33.057Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280207189,"owners_count":26290616,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-21T02:00:06.614Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["diceware","passphrase","password","python"],"created_at":"2025-10-21T04:52:23.820Z","updated_at":"2025-10-21T04:52:27.268Z","avatar_url":"https://github.com/ulif.png","language":"Python","readme":"diceware\n========\n\nPassphrases to remember...\n\n|bdg-tests|  | `documentation \u003chttps://diceware.readthedocs.io/\u003e`_ | `sources \u003chttps://github.com/ulif/diceware\u003e`_ | `issues \u003chttps://github.com/ulif/diceware/issues\u003e`_\n\n.. |bdg-tests| image:: https://github.com/ulif/diceware/actions/workflows/tests.yml/badge.svg?branch=master\n   :target: https://github.com/ulif/diceware/actions/workflows/tests.yml\n   :alt: Test Status\n\n.. |bdg-last-release| image:: https://img.shields.io/pypi/v/diceware.svg\n    :target: https://pypi.python.org/pypi/diceware/\n    :alt: Latest Release\n\n.. |bdg-versions| image:: https://img.shields.io/pypi/pyversions/diceware.svg\n    :target: https://pypi.python.org/pypi/diceware/\n    :alt: Supported Python Versions\n\n.. |bdg-license| image:: https://img.shields.io/pypi/l/diceware.svg\n    :target: https://pypi.python.org/pypi/diceware/\n    :alt: License\n\n.. |doc-status| image:: https://readthedocs.io/projects/diceware/badge/?version=latest\n     :target: https://diceware.readthedocs.io/en/latest/\n     :alt: Documentation Status\n\n`diceware` is a passphrase generator following the proposals of\nArnold G. Reinhold on http://diceware.com . It generates passphrases\nby concatenating words randomly picked from wordlists. For instance::\n\n  $ diceware\n  MyraPend93rdSixthEagleAid\n\nThe passphrase contains by default six words (with first char\ncapitalized) without any separator chars. Optionally you can let\n`diceware` insert special chars into the passphrase.\n\n`diceware` supports several sources of randomness (including real life\ndice) and different wordlists (including cryptographically signed\nones).\n\n.. contents::\n\n\nInstall\n-------\n\nThis Python package can be installed via pip_::\n\n  $ pip install diceware\n\nThe exact way depends on your operating system.\n\n\nUsage\n-----\n\nOnce installed, use ``--help`` to list all available options::\n\n  $ diceware --help\n  usage: diceware [-h] [-n NUM] [-c | --no-caps] [-s NUM] [-d DELIMITER]\n                  [-r SOURCE] [-w [NAME [NAME ...]]] [--dice-sides N] [-v]\n                  [--version]\n                  [INFILE]\n\n  Create a passphrase\n\n  positional arguments:\n    INFILE                Input wordlist. `-' will read from stdin.\n\n  optional arguments:\n    -h, --help            show this help message and exit\n    -n NUM, --num NUM     number of words to concatenate. Default: 6\n    -c, --caps            Capitalize words. This is the default.\n    --no-caps             Turn off capitalization.\n    -s NUM, --specials NUM\n                          Append NUM special chars at the end of the generated\n                          passphrase.\n    -d DELIMITER, --delimiter DELIMITER\n                          Separate words by DELIMITER. Empty string by default.\n    -r SOURCE, --randomsource SOURCE\n                          Get randomness from this source. Possible values:\n                          `realdice', `system'. Default: system\n    -w [NAME [NAME ...]], --wordlist [NAME [NAME ...]]\n                          Use words from this wordlist. Possible values: `ca`,\n                          `de', `de_8k', `en_adjectives', `en_eff', `en_nouns',\n                          `en_securedrop', `es`, `fr`, `it`, `pt-br'.\n                          Wordlists are stored in the folders displayed below.\n                          Default: en_eff\n    -v, --verbose         Be verbose. Use several times for increased verbosity.\n    --version             output version information and exit.\n    --show-wordlist-dirs  Output directories we look up to find wordlists and exit.\n\n  Arguments related to `realdice' randomsource:\n    --dice-sides N        Number of sides of dice. Default: 6\n\n  Use --show-wordlist-dirs to list directories where you can store custom wordlists.\n\nWith ``-n`` you can tell how many words are supposed to be picked for\nyour new passphrase::\n\n  $ diceware -n 1\n  Runny\n\n  $ diceware -n 2\n  GroovyPostbox\n\nYou can `diceware` additionally let generate special chars, that will be\nappended  to the 'normal' passphrase.  The number of special chars\ngenerated can be determined with the ``-s`` option (*default is zero*)::\n\n  $ diceware -s 2\n  VioletParadoxImaginaryWheneverHarddiskOutburst%5\n\nHere ``\"%\"`` and ``\"5\"`` are the special chars.\n\nSpecial chars are randomly taken from the following list::\n\n  ~!#$%^\u0026*()-=+[]\\{}:;\\\"'\u003c\u003e?/0123456789\n\nChanged in: version 1.1.0. Until then the special chars were spread over the\ngenerated passphrase, rendering it glibberish and harder to read and harder to\nmemorize.\n\nWith ``-d`` you can advise `diceware` to put a delimiter string\nbetween the words generated::\n\n  $ diceware -d \"_\"\n  Wavy_Baden_400_Whelp_Quest_Macon\n\nBy default we use the empty string as delimiter, which is good for\ncopying via double click on Linux systems. But other delimiters might\nmake your passphrases more readable (and more secure, see\n`Security Traps \u003c#sec-traps\u003e`_ below).\n\nBy default the single phrase words are capitalized, i.e. the first\nchar of each word is made uppercase. This does not necessarily give\nbetter entropy (but protects against entropy loss due to non `prefix\ncode`_, see `Security Traps \u003c#sec-traps\u003e`_ below), and it might\nimprove phrase readability.\n\nYou can nevertheless disable caps with the ``--no-caps`` option::\n\n  $ diceware --no-caps\n  oceanblendbaronferrylistenvalet\n\nThis will leave the input words untouched (upper-case stays upper-case,\nlower-case stays lower-case). It does *not* mean, that all output words will be\nlower-case (except if all words of your wordlist are lowercase).\n\nAs the default lists of `diceware` contain only lower-case terms, here\n``--no-caps`` means in fact lower-case only output, which might be easier to\ntype on smart phones and similar.\n\n`diceware` supports also different sources of randomness, which can be\nchosen with the ``-r \u003cSOURCENAME\u003e`` or ``--randomsource \u003cSOURCENAME\u003e``\noption. Use the ``--help`` option to list all valid values for this\noption.\n\nBy default we use the `random.SystemRandom`_ class of standard Python\nlib but you can also bring your own dice to create randomness::\n\n  $ diceware -r realdice --dice-sides 6\n  Please roll 5 dice (or a single dice 5 times).\n  Enter your 5 dice results, separated by spaces: 6 4 2 3 1\n  Please roll 5 dice (or a single dice 5 times).\n  Enter your 5 dice results, separated by spaces: 5 4 3 6 2\n  ...\n  UnleveledSimilarlyBackboardMurkyOasisReplay\n\nNormally dice have six sides. And this is also the default in\n`diceware` if you do not use ``--dice-sides``. But if you do, you can\ntell how many sides (all) your dice have. More sides will lead to less\nrolls required.\n\n`diceware` comes with an English wordlist provided by the EFF_, which will be\nused by default and contains 7776 (=6^5) different words. This list is\nregistered as ``en_eff``.\n\nAdditionally `diceware` comes with an English wordlist provided by\n`@heartsucker`_, which contains 8192 different words. This list is based off\nthe original diceware list written by Arnold G. Reinhold.\n\nYou can enable a certain (installed) wordlist with the ``-w`` option::\n\n  $ diceware --wordlist en_orig\n  YorkNodePrickEchoToriNiobe\n\nSee ``diceware --help`` for a list of all installed wordlists.\n\nYou can also build phrases from adjectives and nouns (yet in english only)\nusing the included `en_adjectives` and `en_nouns` lists. For that you specify\nthese two wordlists after each other::\n\n  $ diceware -n 1 -w en_adjectives en_nouns\n  TediousPerimeter\n\nThese adjective/noun phrases might be easier to memorize.\n\nIf you do not like the wordlists provided, you can use your own\none. Any `INFILE` provided will be parsed line by line and each line\nconsidered a possible word. For instance::\n\n  $ echo -e \"hi\\nhello\\n\" \u003e mywordlist.txt\n  $ diceware mywordlist.txt\n  HelloHelloHiHiHiHello\n\nWith dash (``-``) as filename you can pipe in wordlists::\n\n  $ echo -e \"hi\\nhello\\n\" | diceware -\n  HiHiHelloHiHiHello\n\nIn custom wordlists we take each line for a valid word and ignore\nempty lines (i.e. lines containing whitespace characters only). Oh,\nand we handle even PGP-signed wordlists.\n\nYou can set customized default values in a configuration file ``.diceware.ini``\n(note the leading dot) placed in your home directory. Since version 1.0 you can\nalso use ``${XDG_CONFIG_HOME}/diceware/diceware.ini`` or\n``${HOME}/.config/diceware/diceware.ini`` (if ``${XDG_CONFIG_HOME}`` is\nundefined, see XDG_ for details).\n\n\nThis file could look like this::\n\n  [diceware]\n  num = 7\n  caps = off\n  specials = 2\n  delimiter = \"MYDELIMITER\"\n  randomsource = \"system\"\n  wordlist = \"en_securedrop\"\n\nThe options names have to match long argument names, as output by\n``--help``. The values set must meet the requirements valid for\ncommandline usage. All options must be set within a section\n``[diceware]``.\n\n\nWhat is it good for?\n--------------------\n\nNormally, `diceware` passphrases are easier to remember than shorter\npasswords constructed in more or less bizarre ways. But at the same\ntime `diceware` passphrases provide more entropy as `xkcd`_ can show\nwith the famous '936' proof_:\n\n.. image:: http://imgs.xkcd.com/comics/password_strength.png\n   :align: center\n   :target: http://xkcd.com/936/\n\n.. _xkcd: http://xkcd.com/\n.. _proof: http://xkcd.com/936/\n\nThe standard english wordlist of this `diceware` implementation contains 7776 =\n6^5 different english words. It is the official EFF_ wordlist.  compiled by\n`Joseph Bonneau`_. Therefore, picking a random word from this list gives an\nentropy of nearly 12.9 bits. Picking six words means an entropy of 6 x 12.9 =\n77.54 bits.\n\nThe special chars replacing chars of the originally created passphrase\ngive some more entropy (the more chars you have, the more additional\nentropy), but not much. For instance, for a sixteen chars phrase you\nhave sixteen possibilities to place one of the 36 special chars. That\nmakes 36 x 16 possibilities or an entropy of about 9.17 you can add.\nTo get an entropy increase of at least 10 bits, you have to put a\nspecial char in a phrase with at least 29 chars (while at the same\ntime an additional word would give you 13 bits of extra\nentropy). Therefore you might think again about using special chars in\nyour passphrase.\n\n\nIs it secure?\n-------------\n\nThe security level provided by Diceware_ depends heavily on your\nsource of random. If the delivered randomness is good, then your\npassphrases will be very strong. If instead someone can foresee the\nnumbers generated by a random number generator, your passphrases will\nbe surprisingly weak.\n\nThis Python implementation uses (by default) the\n`random.SystemRandom`_ source provided by Python. On Un*x systems it\naccesses `/dev/urandom`. You might want to follow reports about\nmanipulated random number generators in operating systems closely.\n\nThe Python API of this package allows usage of other sources of\nrandomness when generating passphrases. This includes real dice. See\nthe ``-r`` option.\n\n\n.. _sec-traps:\n\nSecurity Traps\n--------------\n\nThere are issues that might reduce the entropy of the passphrase\ngenerated. One of them is the `prefix code`_ problem:\n\n\nPrefix Code\n...........\n\nIf the wordlist contains, for example, the words::\n\n   \"air\", \"airport\", \"portable\", \"able\"\n\n*and* we switched off caps *and* delimiter chars, then `diceware` might\ngenerate a passphrase containing::\n\n   \"airportable\"\n\nwhich could come from ``air-portable`` or ``airport-able``. We cannot\ntell and an attacker would have less combinations to guess.\n\nTo avoid that, you can leave caps enabled (the default), use any word\ndelimiter except the empty string or use the ``en_eff`` wordlist,\nwhich was checked to be a `prefix code`_ (i.e. it does not contain\nwords that start with other words in the list). The ``pt-br`` is also a secure\n`prefix code`_.\n\nEach of these measures is sufficient to protect you against the\n`prefix code`_ problem.\n\n\nReduced Entropy\n...............\n\nOverall, `diceware` is a kind of mapping input values, dice throws for\ninstance, onto wordlist entries. We normally want each of the words in the\nwordlist to be picked for passphrases with the same probability.\n\nThis, however, is not possible, if the number of wordlist entries is not a\npower of dice sides. In that case we cut some words of the wordlist and inform\nthe user about the matter. Reducing the number of words this way makes it\neasier for attackers to guess the phrase picked.\n\nYou can fix that problem by using longer wordlists.\n\n\nDeveloper Install\n-----------------\n\nDevelopers want to `fork me on github`_::\n\n  $ git clone https://github.com/ulif/diceware.git\n\nWe recommend to create and activate a virtualenv_ first::\n\n  $ cd diceware/\n  $ virtualenv -p /usr/bin/python3.11 py311\n  $ source py311/bin/activate\n  (py311) $\n\nWe support Python versions 2.7, 3.4 to 3.12, and pypy3.\n\nNow you can create the devel environment::\n\n  (py311) $ pip install '.[tests,dev]'\n\nThis will fetch test packages (py.test_), `ruff` as linter, `black` as code\nformatter and `coverage`. You should be able to run tests now::\n\n  (py311) $ pytest\n\nIf you have also different Python versions installed you can use tox_\nfor using them all for testing::\n\n  (py311) $ pip install tox   # only once\n  (py311) $ tox\n\nShould run tests in all supported Python versions, the linter (`ruff`),\ncoverage tests and more.\n\n\nDocumentation Install\n.....................\n\nThe docs can be generated with Sphinx_. The needed packages are\ninstalled via::\n\n  (py311) $ pip install '.[docs]'\n\nTo create the docs as HTML in a directory of your choice, then run::\n\n   (py311) $ sphinx-build docs/ mydir/\n\nYou can also change to the ``docs/`` directory and use the prepared\n``Makefile``::\n\n  (py311) $ cd docs/\n  (py311) $ make\n\nThis should generate the docs in ``docs/_build/html/``.\n\n\nCreating the Man Page\n.....................\n\nWe provide a `ReStructuredTexT`_ template to create a man page. When the\ndocumentation engine is installed (`Sphinx`_, see above), then you can create a\nmanpage doing::\n\n  (py311) $ rst2man.py docs/manpage.rst \u003e diceware.1\n\nThe template is mainly provided to ease the job of Debian maintainers.\nCurrently, it is not automatically updated. Dates, authors, synopsis, etc. have\nto be updated manually. Information in the manpage may therefore be wrong,\noutdated, or simply misleading.\n\n\nCredits\n-------\n\nArnold G. Reinhold deserves all merits for the working parts of\n`Diceware`_. The non-working parts are certainly my fault.\n\nPeople that helped spotting bugs, providing solutions, etc.:\n\n - `Conor Schaefer (conorsch) \u003chttps://github.com/conorsch\u003e`_\n - Rodolfo Gouveia suggested to activate the ``--delimiter`` option.\n - `@drebs`_ provided patches and discussion for different sources of\n   randomness and the excellent ``pt-br`` wordlist. `@drebs`_ also initiated\n   and performed the packaging of `diceware` for the `Debian`_ platform. Many\n   kudos for this work! `@drebs`_ is also the official Debian maintainer of the\n   `diceware` package.\n - `@heartsucker`_ hand-compiled and added a new english wordlist.\n - `dwcoder \u003chttps://github.com/dwcoder\u003e`_ revealed and fixed bugs\n   #19, #21, #23. Also showed sound knowledge of (theoretical)\n   entropy. A pleasure to work with.\n - `George V. Reilly \u003chttps://github.com/georgevreilly\u003e`_ pointed to new\n   EFF wordlists.\n - `lieryan \u003chttps://github.com/lieryan\u003e`_ brought up the `prefix\n   code`_ problem.\n - `LogosOfJ \u003chttps://github.com/LogosOfJ\u003e`_ discovered and fixed\n   serious `realdice` source of randomness problem.\n - `Bhavin Gandhi \u003chttps://github.com/bhavin192\u003e`_ fixed the confusing error\n   message when an invalid input filename is given.\n - `Simon Fondrie-Teitler \u003chttps://github.com/simonft\u003e`_ contributed a\n   machine-readable copyright file, with improvements from `@anarcat`_\n - `Doug Muth \u003chttps://github.com/dmuth\u003e`_ fixed formatting in docs.\n - `@kmille`_ suggested support for XDG config file locations.\n - `Tango` provided the french wordlist, also provided for `Tails OS`_ and the\n   `Tor Project`_.\n - `@jawlenskys`_ provided the catalan, spanish and italian wordlists, also\n   provided for `Tails OS`_ and the `Tor Project`_.\n\nMany thanks to all of them!\n\n\nLinks\n-----\n\n- The Diceware_ home page. Reading definitely recommended!\n- `fork me on github`_\n\nExternal Wordlists:\n\n- `Diceware standard list`_ by Arnold G. Reinhold.\n- `Diceware8k list`_ by Arnold G. Reinhold.\n- `Diceware SecureDrop list`_ by `@heartsucker`_.\n- `EFF large list`_ provided by EFF_.\n- `English adjectives and nouns lists`_ provided by `NaturalLanguagePasswords`_.\n\n\nLicense\n-------\n\nThis Python implementation of Diceware, (C) 2015-2024 Uli Fouquet, is\nlicensed under the GPL v3+. See file LICENSE for details.\n\n\"Diceware\" is a trademark of Arnold G Reinhold, used with permission.\n\nThe copyright for the `Diceware8k list`_ is owned by Arnold G Reinhold.  The\ncopyright for the `Diceware SecureDrop list`_ are owned by `@heartsucker`_.\nCopyright for the `EFF large list`_ by `Joseph Bonneau`_ and EFF_. Copyright\nfor the brazilian portuguese list by `@drebs`_. Copyright for the english\nadjective and noun lists by `NaturalLanguagePasswords`_. See file COPYRIGHT for\ndetails.\n\n.. _pip: https://pip.pypa.io/en/latest/\n.. _`@anarcat`: https://github.com/anarcat\n.. _`Debian`: https://www.debian.org/\n.. _`Diceware`: http://diceware.com/\n.. _`Diceware standard list`: http://world.std.com/~reinhold/diceware.wordlist.asc\n.. _`Diceware SecureDrop list`: https://github.com/heartsucker/diceware\n.. _`Diceware8k list`: http://world.std.com/~reinhold/diceware8k.txt\n.. _`@drebs`: https://github.com/drebs\n.. _`EFF`: https://eff.org/\n.. _`EFF large list`: https://www.eff.org/files/2016/07/18/eff_large_wordlist.txt\n.. _`English adjectives and nouns lists`: https://github.com/NaturalLanguagePasswords/system\n.. _`fork me on github`: http://github.com/ulif/diceware/\n.. _`@heartsucker`: https://github.com/heartsucker/\n.. _`@jawlenskys`: https://github.com/jawlenskys\n.. _`Joseph Bonneau`: https://www.eff.org/about/staff/joseph-bonneau\n.. _`@kmille`: https://github.com/kmille\n.. _`NaturalLanguagePasswords`: https://github.com/NaturalLanguagePasswords\n.. _`prefix code`: https://en.wikipedia.org/wiki/Prefix_code\n.. _`random.SystemRandom`: https://docs.python.org/3.4/library/random.html#random.SystemRandom\n.. _`Tails OS`: https://tails.net/\n.. _`Tor Project`: https://torproject.org/\n.. _ReStructuredText: http://docutils.sourceforge.net/rst.html\n.. _virtualenv: https://virtualenv.pypa.io/\n.. _py.test: https://pytest.org/\n.. _tox: https://tox.wiki/\n.. _Sphinx: https://sphinx-doc.org/\n.. _`XDG`: https://specifications.freedesktop.org/basedir-spec/latest/\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fulif%2Fdiceware","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fulif%2Fdiceware","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fulif%2Fdiceware/lists"}