Skip to main content

A simple password manager

Project description

Simple Password Manager

PyPI version License: MIT

Overview

Simple Password Manager is a lightweight and secure Python package for managing passwords. It allows users to store, retrieve, and manage their passwords securely using encryption with a single master password. It supports two types of storage: local storage and cloud storage. The package provides a command-line interface (CLI) for easy management of passwords.

Features

  • Encryption: All passwords are encrypted using a master password.
  • Secure Storage: Passwords are stored in a secure format locally or in the cloud.
  • Command-Line Interface: Easy to use CLI for managing passwords.
  • Custom Password Generation: Generate secure passwords on the fly.
  • Log and Backup System: Keeps track of changes and allows for easy backup.

Installation

Install the package using pip:

pip install simple-password-manager

Usage

Command-Line Interface (CLI)

The Simple Password Manager can be used directly from the command line with the following commands:

  1. Start in Online or Offline Mode:

    • For online use, where your passwords are stored securely in the cloud:
      spm mode -o
      
    • For offline use, where your passwords are stored locally:
      spm mode -f
      
  2. Create an Account:

    • Once the mode is selected, sign up by creating an account:
      spm signup <username>
      
  3. Manage Your Passwords:

    • After creating an account, you can begin managing your passwords with the following commands:
      • Add a new password:
        spm add <service> <username>
        
      • Retrieve a password:
        spm get <service>
        
      • Update an existing password:
        spm update <service>
        
      • Delete a password:
        spm delete <service>
        

Python Integration

You can also use Simple Password Manager directly in your Python code:

from simplepasswordmanager import Manager, OfflineManager, OnlineManager

# Initialize the manager
manager = Manager(master_password="your_master_password")

# Example usage:
manager.add_password("gmail", "your_email@gmail.com", "your_password")
password = manager.get_password("gmail")
print(f"Retrieved password: {password}")

Notes

  • If you have your own solution to store your passwords on the cloud, you can modify where the package stores your passwords online by updating the settings in setting.py.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

simple-password-manager-0.0.4.tar.gz (10.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

simple_password_manager-0.0.4-py3-none-any.whl (12.6 kB view details)

Uploaded Python 3

File details

Details for the file simple-password-manager-0.0.4.tar.gz.

File metadata

  • Download URL: simple-password-manager-0.0.4.tar.gz
  • Upload date:
  • Size: 10.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.4

File hashes

Hashes for simple-password-manager-0.0.4.tar.gz
Algorithm Hash digest
SHA256 73c6725382cd1ae68a15db8a51b71f26d70c5a875497c0223fe0aad0164ea8a2
MD5 c3c22ba7b67e7f9e5bb4bb83fcfc3c1c
BLAKE2b-256 74640c8f125dcc5c01ee6cf70cb0adee8514806db2065dc84599b73670856620

See more details on using hashes here.

File details

Details for the file simple_password_manager-0.0.4-py3-none-any.whl.

File metadata

File hashes

Hashes for simple_password_manager-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 9c94faca7522dfde759f667b65a1f3d25afd2dc46c1066a4f314af55ea15580d
MD5 7b3fc1822b8a86d21d3e2a23b714b367
BLAKE2b-256 23d1b7c0dbb570cbb53d628b8f531c3f95d667808ef7fb1202634330756378e2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page