snipcli 0.5.0
Snipline CLI
Snipline CLI allows you to organise and use your favourite shell commands from the terminal. It can optionally sync to your Snipline account.
Installation
Homebrew (MacOS)
Snipline CLI is available through Homebrew for MacOS and Linux.
brew install snipline/snipline/snipcli
Snapcraft (Linux)
Linux users can download via Snapcraft
sudo snap install snipcli --beta
From source
Snipline CLI requires Crystal 0.35.1 to be installed to install from source
# Clone the repo
git clone git@github.com:snipline/snipcli.git
# Checkout the latest release
git checkout <tagname - e.g. 0.5.0>
# Make sure you have the same Crystal installed that's required in shard.yml
crystal -v
# Install dependencies
shards
# Build app for Crystal 0.34.0 / MacOS
crystal build src/snipline_cli.cr -o snipcli --release -o snipcli
# Build app for Crystal 0.34.0 / Linux (Alpine)
crystal build src/snipline_cli.cr -o snipcli --release -o snipcli -Dstatic_linux
./snipcli --version
Upgrading
Upgrading Snipline CLI depends on your method of installation
# Homebrew
brew upgrade snipline/snipline/snipcli
# Snapcraft
snap refresh
# From Source
git pull origin master
git checkout <tagname - e.g. 0.3.1>
crystal -v # confirm Crystal is the same as shard.yml requirement
shards
crystal build src/snipline_cli.cr -o snipcli --release -o snipcli
./snipcli --version
Usage
Using Snipline CLI for free
Snipline CLI can be used without an active Snipline account.
To generate the initial configuration files use the init
command.
snipcli init
The above command will generate a config.toml
file and a snippets.json
file in your ~/.config/snipline
directory.
Syncing to Snipline
Log-in to your Snipline account and sync your snippets.
Follow login instructions (Enter email and token)
snipcli login
Download snippets from your Snipline account
snipcli sync
Searching snippets
A basic search can be done with the search
command.
snipcli search
If you wish to pre-filter the results you can do so by adding a search term and specify the field to search on.
snipcli search <searchterm> --field=tags
Search options include field
and limit
. See snipcli search --help
for more information
Note that as of 0.2.0 it's not possible to search and copy to clipboard from a Linux VM/SSH session. Use run
to run the command directly from your terminal session.
Creating a new snippet
You can create a new snippet by using the new
command. This will open a TOML file in the text editor of your preference. Once closed it will attempt to add it to your snippets.json
file and sync to your Snipline Account.
snipcli new
Web interface
As of 0.3.0 the web interface has been removed infavour of the new TUI.
Development
See the Installation section on building from source.
Set log levels for additional development output and specifiy different config files for testing
crystal build src/snipline_cli.cr -o snipcli
env CONFIG_FILE=~/.config/snipline/config.dev.toml ./snipcli search login
env CONFIG_FILE=~/.config/snipline/config.dev.toml env CRYSTAL_LOG_LEVEL=INFO ./snipcli search git
To change the config file location (For testing) use the CONFIG_FILE
environment variable.
There is an example already in place for testing located in config.spec.toml
env CONFIG_FILE=./config.spec.toml crystal spec
Contributing
See the Contributing guide for details.
TODO
- More tests.
- More documentation (Including usage without a Snipline account).
- Syncing local snippets via
snipcli sync
. - Editing snippets.
- Compact search mode.
Contributors
- Mitchell Stanley - creator and maintainer
snipcli
- 23
- 2
- 3
- 0
- 7
- over 3 years ago
- May 28, 2019
MIT License
Thu, 21 Nov 2024 16:25:59 GMT