#password #manager #passwordstore

bin+lib rass

A rust implementation for the standard *nix password manager: pass

1 unstable release

Uses old Rust 2015

0.2.0 Feb 19, 2017

#649 in Authentication

ISC and LGPL-2.1

52KB
1K SLoC

rass

Build Status

A password-store clone written in Rust.

The name rass is a combination of rust and pass whereas pass being the command line tool for password-store.

Documentation

Requirements

Due to rass dependency to rust-gpgme you need to have a recent version of GPGme installed, see.

Installation

From source:

$ git clone https://github.com/awidegreen/rass.git
$ cd rass
$ cargo build --release

NOTE: Not released on crates.io yet

$ cargo install rust-rass

Limitations

In comparison to pass, rass does not support [yet]:

  • no clipboard support
  • initialize
  • not all environment variables are support
    • supported: PASSWORD_STORE_DIR
    • not supported: PASSWORD_STORE_DIR, PASSWORD_STORE_GIT, PASSWORD_STORE_X_SELECTION, PASSWORD_STORE_CLIP_TIME, PASSWORD_STORE_UMASK

Usage

Note: rass is not yet able to create and initialize a new password store, therefore use pass init <gpg-ide>.

As pass, rass assume that your password store is located in $HOME/.password-store. If your store is in a different location, set the PASSWORD_STORE_DIR variable.

Show the help

$ rass -h

# some detailed subcommand help
$ rass insert -h

List all store entries (subcommand ls)

$ rass 

Show an entry

$ rass PASS_ENTRY

Insert a new entry (subcommand insert or add)

# single-line
$ rass insert foobar

# multi-line 
$ rass insert -m foobar

Dispatch git command to rass, executed within the password-store

# push new entries to origin
$ rass git push origin master

# pull latest changes
$ rass git pull

# show the git log of the password-store
$ rass git log

Grep for a string in the password store.

# search for "foobar" in the entire store 
$ rass grep foobar

For more information see the help: rass help

Edit an entry will make use of the EDITOR environment variable. If the variable is not, vim will be assumed.

# edit entry foobar
$ rass edit foobar

ToDo

  • subcommands
    • init
    • generate
    • mv
    • cp
  • some more tests
  • a simple CLI UI?

License

Copyright (C) 2016 by Armin Widegreen

This is free software, licensed under The ISC License.

Dependencies

~1.5MB
~27K SLoC