Simple encrypted password storage
Python Perl Shell Perl6
Latest commit c1746e8 Sep 27, 2016 @akheron committed on GitHub Update README.rst wording

README.rst

sala - encrypted plaintext password store

PyPI version Python versions

Sala lets you store passwords and other bits of sensitive plain-text information to encrypted files on a directory hierarchy. The information is protected by GnuPG's symmetrical encryption.

Basic usage

Passwords are stored in a directory hierarchy, each file containing one secret.

Commands:

sala init
Initialize a password store
sala get FILE...
Read secret(s)
sala set FILE...
Create or modify secret(s)
sala FILE...
Read or modify, depending on whether the first file exists or not

For more information, see sala(1) and http://www.digip.org/sala/.

Installation

Install sala:

pip install sala

Install from source:

python setup.py install

Requirements:

Suggested packages:

  • pwgen: With the default configuration, if pwgen is installed, it's used to suggest good passwords to the user

Development

The test suite is in the test/ directory. Use the run-tests.py script to run the test suite. For more info, run:

python run-tests.py --help

cram 0.5 or newer is required to run the tests. If coverage is installed, the script can also show test coverage.

The documentation is in the doc/ directory. To build a manpage and a HTML documentation page, run

make -C doc

in the top directory. Docutils 0.8 or newer is required.