Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jhbabon/slate
Slate: Manage your snippets from your command line.
https://github.com/jhbabon/slate
Last synced: about 1 month ago
JSON representation
Slate: Manage your snippets from your command line.
- Host: GitHub
- URL: https://github.com/jhbabon/slate
- Owner: jhbabon
- License: mit
- Created: 2016-05-11T07:13:22.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-11-08T16:06:11.000Z (about 7 years ago)
- Last Synced: 2024-09-17T14:49:13.799Z (2 months ago)
- Language: Rust
- Size: 53.7 KB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Slate
Slate is a snippets manager for your command line.
It helps you to have all those small pieces of code, text, and so on in one place and in your favorite environment: the shell.
## Installation
Slate is made with `rust`, so you will need the [latest stable version](https://www.rust-lang.org/downloads.html) of it to compile and run the program.
Clone the repository and run `cargo install`. You can also run `cargo build` if you want only to play with it:
```
$ git clone https://github.com/jhbabon/slate.git slate
$ cd slate
$ cargo install
```
## Usage
You can always check all the commands available with the `--help` option:
```
$ slate --help
Slate: Manage your snippets from your command line.
Note that Slate will use the file ~/.slate to save
its contents.
Usage:
slate [...]
slate [options]
Options:
-h --help Show this screen.
-v --version Show version.
Commands:
set Write a new key and value.
get Read a key.
list List all keys.
rename Rename a key.
remove Delete a key.
```
As you can see, Slate is basically a `HashMap`, so playing with it is straight forward:
```
# Basic operations
$ slate set foo bar
$ slate get foo
bar
$ slate list
foo
$ slate remove foo
The key has been removed
$ slate list
# Renaming
$ slate set bar baz
$ slate list
bar
$ slate rename bar foo
The key has been renamed
$ slate list
foo
# Cleaning up
$ slate remove --all
All keys have been removed
```
It also plays nice with other UNIX tools:
```
$ cat redis.conf | slate set redis
$ slate get redis
daemonize yes
dbfilename dump.rdb
dir /tmp
$ cd other/project
$ slate get redis > redis.conf
$ cd other/project/v2
$ slate get redis > redis.conf
```
### The `~/.slate` file
By default Slate will save all its contents in the file `~/.slate`. It is just a plain JSON file for the moment. It is better if you don't touch it and let the program handle it.
### Using your own custom file
If you don't want to use the default `~/.slate` file or, for example, you want to have a different one per project you can customize the path to the file with the `SLATE_FILEPATH` env variable:
```
$ SLATE_FILEPATH=/path/to/the/file/slate.json slate set foo bar
$ SLATE_FILEPATH=/path/to/the/file/slate.json slate list
foo
```
If you use a tool like [direnv](http://direnv.net/) you can easily set different slate files per directory/project.