| Name | jk_pwdgen JSON |
| Version |
0.2024.11.3.4
JSON |
| download |
| home_page | None |
| Summary | This python module provides support for password generation. |
| upload_time | 2024-11-03 19:51:45 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | None |
| keywords |
console
terminal
cli
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
jk_pwdgen
==========
Introduction
------------
This python module provides support for password generation.
Information about this module can be found here:
* [github.org](https://github.com/jkpubsrc/python-module-jk-pwdgen)
* [pypi.python.org](https://pypi.python.org/pypi/jk_pwdgen)
Why this module?
----------------
Every user needs strong passwords for various services used. Especially system administrators need passwords of good quality. This python module provides ways to easily generate strong passwords locally.
Limitations of this module
--------------------------
The implementations provided here makes use of default implementations of random number generators in Python. This is a Mersenne Twister and uses `/dev/urandom`. The quality of randomness is limited to the quality of the underlying implementation in Python. We should assume that the underlying implementation in Python is sufficiently tested and does not contain severe bugs. However it is important to realize that the quality of this underlying implementation is a limiting factor.
What is a (sufficiently) good password
----------------------
Good passwords ...:
- **should be random**. The more random the better. Passwords that contain words which can be found in a human readable dictionary aren't very good.
- **should contain numbers**. This increases the complexity.
- **should contain special characters**. This increases the complexity as well.
- **should not contain a high variety of characters**. This as well increases the complexity.
The password generator provided here aims to meet these criteria.
How to use this module
----------------------
### Import this module
Please include this module into your application using the following code:
```python
import jk_pwdgen
```
### Instantiate a password generator
Now you can instantiate a password generator (and configure it as desired):
```python
pwdGen = jk_pwdgen.PasswordGenerator()
pwdGen.setLength(24)
```
### Generate a password
A password can then be generated like this:
```python
print(pwdGen.generate())
```
How to use the standalone tool
----------------------
### Run the password generator
This module comes with a standalone program named `pwdgen.py`. After installing this module you should be able to invoke it via command line. It basically performs exactly those steps described above in order to generate a password. Just execute `pwdgen.py` such as this:
```
$ pwdgen.py
mS-UMb5JGSd.LVwszF54Hw~v
$ _
```
### Help text
For more details run `pwdgen.py -h` to display this help text:
```
pwdgen [options] - Generate strong passwords.
Description:
This tool assists in the generation of strong passwords. Generation is based on the Python
random number generator random.Random. According to the Python documentation this RNG is
based on Mersenne Twister and os.urandom(), so it should provide sufficient randomness for
password generation.
This tool will verify that passwords generated are of sufficient by verifying that the
correct number of special characters as well as enough numeric characters are present in
the password generated.
In order to use this password generation tool just run it. On each run it will generate
one or more passwords (depending on arguments specified). All passwords are printed to
STDOUT line by line.
Options:
-h --help Display this help text.
-n n Number of passwords to generate. (Default: 1)
-l n --length n Length of password to generate. (Default: 24)
--minNumberOfNumericChars n Minimum number of numeric characters. (Default: 2)
--numberOfSpecialChars n Minimum number of special characters. (Default: 3)
--prohibitedChars s Prohibites characters. (Default: "0l")
Author:
Jürgen Knauth <jk@binary-overflow.de>
Return codes:
0 Everything is okay.
1 An error occurred.
License:
This program is free software: you can redistribute it and/or modify it under the terms of
the Apache Software License as published by Apache Software Foundation in version 2. For
more details see the Apache Software License, which should be vailable at:
https://www.apache.org/licenses/LICENSE-2.0
```
Contact Information
-------------------
This work is Open Source. This enables you to use this work for free.
Please have in mind this also enables you to contribute. We, the subspecies of software developers, can create great things. But the more collaborate, the more fantastic these things can become. Therefore Feel free to contact the author(s) listed below, either for giving feedback, providing comments, hints, indicate possible collaborations, ideas, improvements. Or maybe for "only" reporting some bugs:
* Jürgen Knauth: pubsrc@binary-overflow.de
License
-------
This software is provided under the following license:
* Apache Software License 2.0
Raw data
{
"_id": null,
"home_page": null,
"name": "jk_pwdgen",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "J\u00fcrgen Knauth <pubsrc@binary-overflow.de>",
"keywords": "console, terminal, cli",
"author": null,
"author_email": "J\u00fcrgen Knauth <pubsrc@binary-overflow.de>",
"download_url": "https://files.pythonhosted.org/packages/ce/a2/67edf935e14ef5936668f9d870a4b0bfb72be0e39db5c6ef7a2d6a2f669d/jk_pwdgen-0.2024.11.3.4.tar.gz",
"platform": null,
"description": "\ufeffjk_pwdgen\n==========\n\nIntroduction\n------------\n\nThis python module provides support for password generation.\n\nInformation about this module can be found here:\n\n* [github.org](https://github.com/jkpubsrc/python-module-jk-pwdgen)\n* [pypi.python.org](https://pypi.python.org/pypi/jk_pwdgen)\n\nWhy this module?\n----------------\n\nEvery user needs strong passwords for various services used. Especially system administrators need passwords of good quality. This python module provides ways to easily generate strong passwords locally.\n\nLimitations of this module\n--------------------------\n\nThe implementations provided here makes use of default implementations of random number generators in Python. This is a Mersenne Twister and uses `/dev/urandom`. The quality of randomness is limited to the quality of the underlying implementation in Python. We should assume that the underlying implementation in Python is sufficiently tested and does not contain severe bugs. However it is important to realize that the quality of this underlying implementation is a limiting factor.\n\nWhat is a (sufficiently) good password\n----------------------\n\nGood passwords ...:\n\n- **should be random**. The more random the better. Passwords that contain words which can be found in a human readable dictionary aren't very good.\n- **should contain numbers**. This increases the complexity.\n- **should contain special characters**. This increases the complexity as well.\n- **should not contain a high variety of characters**. This as well increases the complexity.\n\nThe password generator provided here aims to meet these criteria.\n\nHow to use this module\n----------------------\n\n### Import this module\n\nPlease include this module into your application using the following code:\n\n```python\nimport jk_pwdgen\n```\n\n### Instantiate a password generator\n\nNow you can instantiate a password generator (and configure it as desired):\n\n```python\npwdGen = jk_pwdgen.PasswordGenerator()\npwdGen.setLength(24)\n```\n\n### Generate a password\n\nA password can then be generated like this:\n\n```python\nprint(pwdGen.generate())\n```\n\nHow to use the standalone tool\n----------------------\n\n### Run the password generator\n\nThis module comes with a standalone program named `pwdgen.py`. After installing this module you should be able to invoke it via command line. It basically performs exactly those steps described above in order to generate a password. Just execute `pwdgen.py` such as this:\n\n```\n$ pwdgen.py\nmS-UMb5JGSd.LVwszF54Hw~v\n$ _\n```\n\n### Help text\n\nFor more details run `pwdgen.py -h` to display this help text:\n\n```\npwdgen [options] - Generate strong passwords.\n\n Description:\n\n This tool assists in the generation of strong passwords. Generation is based on the Python\n random number generator random.Random. According to the Python documentation this RNG is\n based on Mersenne Twister and os.urandom(), so it should provide sufficient randomness for\n password generation.\n\n This tool will verify that passwords generated are of sufficient by verifying that the\n correct number of special characters as well as enough numeric characters are present in\n the password generated.\n\n In order to use this password generation tool just run it. On each run it will generate\n one or more passwords (depending on arguments specified). All passwords are printed to\n STDOUT line by line.\n\n Options:\n\n -h --help Display this help text.\n -n n Number of passwords to generate. (Default: 1)\n -l n --length n Length of password to generate. (Default: 24)\n --minNumberOfNumericChars n Minimum number of numeric characters. (Default: 2)\n --numberOfSpecialChars n Minimum number of special characters. (Default: 3)\n --prohibitedChars s Prohibites characters. (Default: \"0l\")\n\n Author:\n\n J\u00fcrgen Knauth <jk@binary-overflow.de>\n\n Return codes:\n\n 0 Everything is okay.\n 1 An error occurred.\n\n License:\n\n This program is free software: you can redistribute it and/or modify it under the terms of\n the Apache Software License as published by Apache Software Foundation in version 2. For\n more details see the Apache Software License, which should be vailable at:\n https://www.apache.org/licenses/LICENSE-2.0\n```\n\nContact Information\n-------------------\n\nThis work is Open Source. This enables you to use this work for free.\n\nPlease have in mind this also enables you to contribute. We, the subspecies of software developers, can create great things. But the more collaborate, the more fantastic these things can become. Therefore Feel free to contact the author(s) listed below, either for giving feedback, providing comments, hints, indicate possible collaborations, ideas, improvements. Or maybe for \"only\" reporting some bugs:\n\n* J\u00fcrgen Knauth: pubsrc@binary-overflow.de\n\nLicense\n-------\n\nThis software is provided under the following license:\n\n* Apache Software License 2.0\n\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "This python module provides support for password generation.",
"version": "0.2024.11.3.4",
"project_urls": null,
"split_keywords": [
"console",
" terminal",
" cli"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "bae52b0a55ec7827e14e64d278402bd0b26b5581d12a6c19db3741555c679ca7",
"md5": "7c437aa828b89ffa8c5b0fe230c7fbc7",
"sha256": "15ac11a210d966de7ba91240f7593ce814a9e1e18109ef5b10d585012339c862"
},
"downloads": -1,
"filename": "jk_pwdgen-0.2024.11.3.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7c437aa828b89ffa8c5b0fe230c7fbc7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 11524,
"upload_time": "2024-11-03T19:51:43",
"upload_time_iso_8601": "2024-11-03T19:51:43.245909Z",
"url": "https://files.pythonhosted.org/packages/ba/e5/2b0a55ec7827e14e64d278402bd0b26b5581d12a6c19db3741555c679ca7/jk_pwdgen-0.2024.11.3.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "cea267edf935e14ef5936668f9d870a4b0bfb72be0e39db5c6ef7a2d6a2f669d",
"md5": "d77f856d595c4b05b29962db2ea350b5",
"sha256": "decf617a087e71a83200ea8aceef63bbe8da9a22db146182f10cd7dd5043eb2e"
},
"downloads": -1,
"filename": "jk_pwdgen-0.2024.11.3.4.tar.gz",
"has_sig": false,
"md5_digest": "d77f856d595c4b05b29962db2ea350b5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 10134,
"upload_time": "2024-11-03T19:51:45",
"upload_time_iso_8601": "2024-11-03T19:51:45.215268Z",
"url": "https://files.pythonhosted.org/packages/ce/a2/67edf935e14ef5936668f9d870a4b0bfb72be0e39db5c6ef7a2d6a2f669d/jk_pwdgen-0.2024.11.3.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-03 19:51:45",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "jk_pwdgen"
}
