From 20f25d2f6f4d3ed1af555e71a8da76db596bad5d Mon Sep 17 00:00:00 2001 From: Kiersten Gilberg Date: Tue, 30 Jan 2024 15:32:52 -0800 Subject: [PATCH 1/4] fix: added backticks to functions --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index ceace80..6c4e999 100644 --- a/README.md +++ b/README.md @@ -3,10 +3,10 @@ [![Documentation Status](https://readthedocs.org/projects/passwordler/badge/?version=latest)](https://passwordler.readthedocs.io/en/latest/?badge=latest) This package provides password management tools in Python. The package consists of four functions: -- **generate_password**: This function creates a random password containing a mix of upper and lower case letters, numbers, and symbols. The inclusion of numbers and symbols can be controlled through parameters. -- **password_strength**: This function tests the strength of a string to be used as a password. It determines password strength by assessing the length and the amount of capital letters, numbers and special characters used. -- **encrypt_password**: Encrypts a password using a simple substitution cipher. This function applies a character mapping based on a shuffled character set, providing basic encryption. -- **decrypt_password**: Decrypts a message that was encrypted using the `encrypt_password` function. It reverses the encryption process by mapping each character of the encrypted message back to its original character. +- `generate_password`: This function creates a random password containing a mix of upper and lower case letters, numbers, and symbols. The inclusion of numbers and symbols can be controlled through parameters. +- `password_strength`: This function tests the strength of a string to be used as a password. It determines password strength by assessing the length and the amount of capital letters, numbers and special characters used. +- `encrypt_password`: Encrypts a password using a simple substitution cipher. This function applies a character mapping based on a shuffled character set, providing basic encryption. +- `decrypt_password`: Decrypts a message that was encrypted using the `encrypt_password` function. It reverses the encryption process by mapping each character of the encrypted message back to its original character. This Python package is useful for users seeking an integrated solution for password management, offering a user-friendly experience. With key functionalities consolidated in one package, users can effortlessly generate strong passwords, evaluate their strength, and grasp encryption and decryption methods through our straightforward substitution cipher. From b53f747f92b6f86d655cb3dcc3ba032275875fa0 Mon Sep 17 00:00:00 2001 From: Kiersten Gilberg Date: Tue, 30 Jan 2024 15:42:01 -0800 Subject: [PATCH 2/4] fix: Added documentation link to README --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index 6c4e999..ffc0ad9 100644 --- a/README.md +++ b/README.md @@ -22,6 +22,9 @@ $ pip install poetry $ poetry install $ pip install passwordler ``` +## Documentation + +Our online documentation can be found [here](https://passwordler.readthedocs.io/en/latest/?badge=latest). ## Using `passwordler` in Python From 4cb61739836b08de53e3c635cbdf46ead86ff7fb Mon Sep 17 00:00:00 2001 From: Kiersten Gilberg Date: Tue, 30 Jan 2024 16:37:40 -0800 Subject: [PATCH 3/4] fix: added badges to REAME file --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index ffc0ad9..e924f20 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,7 @@ # passwordler -[![Documentation Status](https://readthedocs.org/projects/passwordler/badge/?version=latest)](https://passwordler.readthedocs.io/en/latest/?badge=latest) +[![Documentation Status](https://readthedocs.org/projects/passwordler/badge/?version=latest)](https://passwordler.readthedocs.io/en/latest/?badge=latest) [![Python 3.11](https://img.shields.io/badge/python-3.11-blue.svg)](https://www.python.org/downloads/release/python-360/) ![ci-cd](https://github.com/UBC-MDS/passwordler/actions/workflows/ci-cd.yml/badge.svg) [![codecov](https://codecov.io/gh/UBC-MDS/passwordler/branch/main/graph/badge.svg)](https://codecov.io/gh/UBC-MDS/passwordler) + This package provides password management tools in Python. The package consists of four functions: - `generate_password`: This function creates a random password containing a mix of upper and lower case letters, numbers, and symbols. The inclusion of numbers and symbols can be controlled through parameters. From b76e6c37e6aa4f021fa84be5cea2ff0d13a701b0 Mon Sep 17 00:00:00 2001 From: Kiersten Gilberg Date: Tue, 30 Jan 2024 16:44:50 -0800 Subject: [PATCH 4/4] fix: updated installation instructions --- README.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/README.md b/README.md index e924f20..0597174 100644 --- a/README.md +++ b/README.md @@ -15,12 +15,8 @@ This Python package is useful for users seeking an integrated solution for passw There are many password related packages already on the PyPI server. We have selected a few key examples that complete the same functions as our package. An example of a package that is similar to our password_creator function can be found [here](https://pypi.org/project/easy-password-generator/). Similarly, there are also other packages that check for the strength of passwords, one of which can be seen [here](https://pypi.org/project/password-strength/), this is similar to our password_strength function. There is also a [password encryption package](https://pypi.org/project/password/) which does the same thing as our password_encryption functions. However, there were no password decryption specific function on PyPI. The advantage of our package lies in its comprehensive suite of password-related functions, complemented by an original and intuitive algorithm that demonstrates the fundamental principles of password encryption and decryption. ## Installation -To use the release 2.0.0, clone the repository to your local machine. In the root directory run the following commands to install `passwordler` locally: +To install `passwordler` type the following command into your terminal: ``` -$ conda create --name passwordler python=3.11 -y -$ conda activate passwordler -$ pip install poetry -$ poetry install $ pip install passwordler ``` ## Documentation