rass 0.2.0

A rust implementation for the standard *nix password manager: pass
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

# rass 
[![Build Status](https://travis-ci.org/awidegreen/rass.svg?branch=master)](https://travis-ci.org/awidegreen/rass)

A [password-store](https://www.passwordstore.org/) clone written in Rust. 

The name `rass` is a combination of **r**ust and p**ass** whereas `pass` being 
the command line tool for password-store.

[Documentation](https://awidegreen.github.io/rass/)

## Requirements

Due to `rass` dependency to [rust-gpgme](https://crates.io/crates/gpgme/) you 
need to have a recent version of GPGme installed, 
[see](https://github.com/johnschug/rust-gpgme). 

## Installation

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

NOTE: Not released on crates.io yet
```shell
$ 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
```shell
$ rass -h

# some detailed subcommand help
$ rass insert -h
```

List all store entries (subcommand `ls`)
```shell
$ rass 
```

Show an entry
```shell
$ rass PASS_ENTRY
```

Insert a new entry (subcommand `insert` or `add`)
```shell
# single-line
$ rass insert foobar

# multi-line 
$ rass insert -m foobar
```

Dispatch `git` command to rass, executed within the password-store
```shell
# 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. 
```shell
# 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.

```shell
# 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](LICENSE).