Updated readme

This commit is contained in:
Zakary Timson 2023-12-14 20:02:07 -05:00
parent 6bafacf4f8
commit 4e80e99910
2 changed files with 68 additions and 12 deletions

View File

@ -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.

View File

@ -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")