Skip to main content

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 by invoking:

pip install sala

To install from source, invoke:

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, invoke:

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, invoke

make -C doc

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

Release history

Version 1.3

Released on 2012-06-13

  • Respect SALADIR when creating subdirectories with ‘set’.

  • Add a bash completion script: contrib/sala-completion.bash.

  • Move the repository state to the .sala subdirectory. .salakey becomes .sala/key and sala.conf becomes .sala/config.

  • Add support for hooks in .sala/hooks. Initially, the post-set hook is supported.

Version 1.2

Released on 2011-12-31

  • Add -r option for raw output format.

  • Allow setting the store location with SALADIR environment variable and -C command line option.

  • Add support for Python 3.2, drop support for Python 2.5.

  • Drop the GnuPGInterface dependency. Sala now implements its own GnuPG wrapper.

  • Add man page (in ReST format), move most of README there.

  • Improve portability.

  • Add a regression test suite (cram is required to run the tests).

Version 1.1

Released on 2011-02-02

  • Add support for Python 2.5.

  • Read configuration from $XDG_CONFIG_HOME/sala.conf, too.

Version 1.0.1

Released on 2011-01-19

  • Distribute README.rst, LICENSE and CHANGES with the source tarball.

Version 1.0

Released on 2011-01-18

  • Initial release.

Release files for sala 1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sala 1.3
File Size Uploaded
sala-1.3.tar.gz 16.9 kB Details

Release files / sala-1.3.tar.gz

Download URL sala-1.3.tar.gz
Size 16.9 kB
Tags Source
SHA-256 checksum
How to use checksums
28feae15094aa8ff029bd1bd2bc67acac16be948d4652cd1c50c281107ab0f8f
BLAKE2b-256 checksum
How to use checksums
6e277d4920e59e0444cc0143b92ffef567781618d4a7f9f997f5d31ca2f9c3ff
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

1.3 This release

1 release file

1.2

1 release file

1.1

1 release file

1.0.1

1 release file

1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page