{ "info": { "author": "Christopher Petrilli", "author_email": "petrilli@amber.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta" ], "description": "=============\r\nGeneral Words\r\n=============\r\n\r\n.. image:: https://badge.fury.io/py/generalwords.png\r\n :target: http://badge.fury.io/py/generalwords\r\n\r\n.. image:: https://travis-ci.org/petrilli/generalwords.png?branch=master\r\n :target: https://travis-ci.org/petrilli/generalwords\r\n\r\n.. image:: https://pypip.in/d/generalwords/badge.png\r\n :target: https://pypi.python.org/pypi/generalwords\r\n\r\nOften, when building an application, I've had occasions where I need to provide\r\na nonce of some sort to a user. A nonce is some thing, whether number, or\r\notherwise, that is used only once.\r\n\r\n\r\nGoals\r\n-----\r\n\r\nThe over-arching goal was for this to be simple to use,\r\nand reasonably fast. Next, I wanted something that the average user would be\r\nable to enter manually with minimal risk. This ruled out a lot of the crazy\r\nmixed-case alphanumeric strings that are often used. Finally,\r\na goal was to have a reasonably large number of permutations available so\r\nthat the nonce, while not cryptographically strong, was strong enough for\r\nuses like registration, password reset, etc. For example, with the default\r\n`word source`_, and a selection of three words, there are\r\n`almost 19 billion permutations`_ available. Presuming you're doing any form\r\nof brute-force-attack prevention, this should be more than adequate.\r\n\r\n.. _almost 19 billion permutations: http://www.wolframalpha.com/input/?i=number+of+3+permutations+of+2668+objects\r\n\r\n\r\nWord Source\r\n-----------\r\n\r\nThe list of words comes from the `New General Service List`_ v1.01. The original\r\nlist, distributed in Excel format, is covered under the\r\n`Creative Commons Attribution 3.0 Unported License`_. More information can be\r\nfound on the website. From the base data, the following changes have been made:\r\n\r\n#. The list was converted from Excel to a simple one-word-per-line text file\r\n format;\r\n2. Only headwords were retained for clarity;\r\n3. Supplemental words, such as months and numbers, were added;\r\n3. Words less than 4 characters were removed.\r\n\r\nCombined, a total of 2,668 headwords were retained.\r\n\r\n.. _New General Service List: http://www.newgeneralservicelist.org/\r\n.. _Creative Commons Attribution 3.0 Unported License: http://creativecommons.org/licenses/by/3.0/deed.en_US\r\n\r\n\r\nUsage Example\r\n-------------\r\n\r\nThe library is trivially easy to use::\r\n\r\n >>> from generalwords import *\r\n >>> get_word()\r\n 'tire'\r\n >>> get_word()\r\n 'offense'\r\n >>> get_words(n=3)\r\n ('climb', 'repair', 'force')\r\n\r\nIn the future, there may be more options, but not right now.\r\n\r\n\r\nNot Done Yet\r\n------------\r\n\r\nWhile the library will never be massively complicated, there's a few things I'd\r\nlike to have in the future:\r\n\r\n* Expand to other languages\r\n* Add additional word sources\r\n\r\n\r\n\r\n\r\nHistory\r\n-------\r\n\r\n0.1.0 (2015-55)\r\n---------------------\r\n\r\n* First release on PyPI.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/petrilli/generalwords", "keywords": "generalwords", "license": "BSD Simplified", "maintainer": "", "maintainer_email": "", "name": "generalwords", "package_url": "https://pypi.org/project/generalwords/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/generalwords/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/petrilli/generalwords" }, "release_url": "https://pypi.org/project/generalwords/1.0/", "requires_dist": null, "requires_python": null, "summary": "A somewhat curated collection of words to use in nonce generation.", "version": "1.0" }, "last_serial": 1389557, "releases": { "1.0": [ { "comment_text": "", "digests": { "md5": "f16e2d63166eebf875822e6832a7dae8", "sha256": "1dadab589b074368ae347c26dbf174aac33258306e6956971a49652b741b01d5" }, "downloads": -1, "filename": "generalwords-1.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "f16e2d63166eebf875822e6832a7dae8", "packagetype": "bdist_wheel", "python_version": "3.4", "requires_python": null, "size": 16370, "upload_time": "2015-01-05T21:25:27", "url": "https://files.pythonhosted.org/packages/0d/fb/2f44ea95e49ad8e893ca9ebb5d5fbe91ba0d0f9a41cc479d1f6ef834fa9f/generalwords-1.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f15b70c250a92dec407d8e86a1f75dde", "sha256": "9f97cf25650b0c419e9b9c5ff02a779333c663daa769b14f63dfe3d7cdbf6676" }, "downloads": -1, "filename": "generalwords-1.0.tar.gz", "has_sig": false, "md5_digest": "f15b70c250a92dec407d8e86a1f75dde", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17237, "upload_time": "2015-01-05T21:05:56", "url": "https://files.pythonhosted.org/packages/08/f9/5cff6765cff09f2725bc6b74d57491cf27c07e8d2d81f66ef53f889648d9/generalwords-1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "f16e2d63166eebf875822e6832a7dae8", "sha256": "1dadab589b074368ae347c26dbf174aac33258306e6956971a49652b741b01d5" }, "downloads": -1, "filename": "generalwords-1.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "f16e2d63166eebf875822e6832a7dae8", "packagetype": "bdist_wheel", "python_version": "3.4", "requires_python": null, "size": 16370, "upload_time": "2015-01-05T21:25:27", "url": "https://files.pythonhosted.org/packages/0d/fb/2f44ea95e49ad8e893ca9ebb5d5fbe91ba0d0f9a41cc479d1f6ef834fa9f/generalwords-1.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f15b70c250a92dec407d8e86a1f75dde", "sha256": "9f97cf25650b0c419e9b9c5ff02a779333c663daa769b14f63dfe3d7cdbf6676" }, "downloads": -1, "filename": "generalwords-1.0.tar.gz", "has_sig": false, "md5_digest": "f15b70c250a92dec407d8e86a1f75dde", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17237, "upload_time": "2015-01-05T21:05:56", "url": "https://files.pythonhosted.org/packages/08/f9/5cff6765cff09f2725bc6b74d57491cf27c07e8d2d81f66ef53f889648d9/generalwords-1.0.tar.gz" } ] }