Updated readme
This commit is contained in:
parent
6bafacf4f8
commit
4e80e99910
78
README.md
78
README.md
@ -1,15 +1,47 @@
|
||||
# password_hasher
|
||||
<!-- Header -->
|
||||
<div id="top" align="center">
|
||||
<br />
|
||||
|
||||
<!-- Logo -->
|
||||
<img src="https://git.zakscode.com/repo-avatars/941ba5e37b669fb4ca722ec226b10b9206c2d65006641d0dd77d6a122ee64aff" alt="Logo" width="200" height="200">
|
||||
|
||||
<!-- Title -->
|
||||
### Password Hasher
|
||||
|
||||
<!-- Description -->
|
||||
Python Password Hasher
|
||||
|
||||
<!-- Repo badges -->
|
||||
[![Version](https://img.shields.io/badge/dynamic/json.svg?label=Version&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/password-hasher/tags&query=$[0].name)](https://git.zakscode.com/ztimson/password-hasher/tags)
|
||||
[![Pull Requests](https://img.shields.io/badge/dynamic/json.svg?label=Pull%20Requests&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/password-hasher&query=open_pr_counter)](https://git.zakscode.com/ztimson/password-hasher/pulls)
|
||||
[![Issues](https://img.shields.io/badge/dynamic/json.svg?label=Issues&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/password-hasher&query=open_issues_count)](https://git.zakscode.com/ztimson/password-hasher/issues)
|
||||
|
||||
<!-- Links -->
|
||||
|
||||
---
|
||||
<div>
|
||||
<a href="https://git.zakscode.com/ztimson/password-hasher/releases" target="_blank">Release Notes</a>
|
||||
• <a href="https://git.zakscode.com/ztimson/password-hasher/issues/new?template=.github%2fissue_template%2fbug.md" target="_blank">Report a Bug</a>
|
||||
• <a href="https://git.zakscode.com/ztimson/password-hasher/issues/new?template=.github%2fissue_template%2fenhancement.md" target="_blank">Request a Feature</a>
|
||||
</div>
|
||||
|
||||
---
|
||||
</div>
|
||||
|
||||
## Table of Contents
|
||||
- [Password Hasher](#top)
|
||||
- [About](#about)
|
||||
- [Built With](#built-with)
|
||||
- [Setup](#setup)
|
||||
- [Production](#production)
|
||||
- [License](#license)
|
||||
|
||||
## About
|
||||
|
||||
Python utility to hash passwords. Often when creating a user, a hashed password is needed. This cammond line utility can simply hash the password or multiple parameters can be passed to replicated. password, salt, hashing algorithm, pass+salt concatination order, and number of iterations can all be specified.
|
||||
|
||||
### Authors
|
||||
* [Zak Timson](http://zakscode.com)
|
||||
|
||||
### License
|
||||
GNU GENERAL PUBLIC LICENSE, Version 3, 29 June 2007. read LICENSE for more
|
||||
|
||||
### API
|
||||
```
|
||||
Usage: password_hash.py [options] PASSWORD
|
||||
Usage: password_hash.py [OPTIONS] <PASSWORD>
|
||||
|
||||
Options:
|
||||
-h, --help show this help message and exit
|
||||
@ -22,5 +54,29 @@ Options:
|
||||
--hash-algorithms display available hash algorithms and exit
|
||||
```
|
||||
|
||||
### Bug Reporting
|
||||
Please submit bugs to the github [issue tracker](https://github.com/zaktimson/password_hasher/issues)
|
||||
|
||||
### Built With
|
||||
[![Python](https://img.shields.io/badge/Python-FFD43B?style=for-the-badge&logo=python)](https://www.python.org/)
|
||||
|
||||
## Setup
|
||||
|
||||
<details>
|
||||
<summary>
|
||||
<h3 id="production" style="display: inline">
|
||||
Production
|
||||
</h3>
|
||||
</summary>
|
||||
|
||||
#### Prerequisites
|
||||
- [Python](https://www.python.org/downloads/)
|
||||
|
||||
#### Instructions
|
||||
1. Download script: `curl https://git.zakscode.com/ztimson/password-hasher/raw/branch/master/password_hash.py`
|
||||
2. Run python script: `python3 password_hasher.py [OPTIONS] <PASSWORD>`
|
||||
|
||||
</details>
|
||||
|
||||
## License
|
||||
Copyright © 2007 Zakary Timson | Available under the GNU General Public License
|
||||
|
||||
See the [license](./LICENSE) for more information.
|
||||
|
@ -72,7 +72,7 @@ def output(password, salt, iterations, hash_algorithm):
|
||||
|
||||
|
||||
# Specify flags
|
||||
parser = OptionParser(usage="usage: %prog [options] PASSWORD")
|
||||
parser = OptionParser(usage="usage: %prog [OPTIONS] <PASSWORD>")
|
||||
parser.add_option("-s", "--salt", help="specify salt")
|
||||
parser.add_option("-i", "--iterations", help="specify number of iterations to hash password")
|
||||
parser.add_option("-o", "--order", help="order the password and salt ex. \"ps\" to append salt")
|
||||
|
Loading…
Reference in New Issue
Block a user