Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

A simple command line snippet manager

Project description

snipster

A simple cli snippet manager

GitHub (pre-)release PyPI Python GitHub issues license

snipster is a command line snippet manager allowing you to view, edit, create and copy snippets from your command line. It follows the Unix philosophy of "do one thing and do it well".

Installation | Setup | Usage | Troubleshooting | Other | Credits

Installation

snipster is available on PyPI. This is the easiest way to install it. All dependencies will be installed automatically.

pip3 install snipster-py

If you want to install snipster from source, have a look here

Setup

When you first start up snipster, you should run

snipster source

This will create a .snipster directory in your home folder (if it does not already exist) and create an empty snippet list.

Usage

snipster source
snipster list
snipster list [-t <tag>... | -l <language>... | -k <keyword>... ]...
snipster (-c|-e|-o) [-f] <snippet-id>
snipster -h | --help
snipster -v | --version

Listing (And Filtering) All Snippets

You can filter by tag (-t), keyword in the title (-k) and language (-l). If the filters result in only one match, the match will be displayed directly (instead of a list with only one entry).

Creating/Editing A Snippet

When you create a snippet, an empty file will be created in ~/.snipster and opened in your $EDITOR. For this snippet to be read as valid, it needs to have yaml frontmatter and the actual snippet code needs to be marked as such. You do not need to have any attributes in the front matter but they are heavily encouraged. Valid attributes are tags, lang, title. An id is not necessary. It will be automatically assigned by snipster when you source again.

In order for (changes to) a snippet to be recognized you need to snipster source after saving.

Viewing A Snippet

Copying A Snippet To The Clipboard

Troubleshooting

Bug Reports and Feature Requests

Bug reports and feature requests are very much appreciated. Please contact me on Twitter (@SolviAu) or open an issue here.

Other

Install From Source

If you do not want to use pip, you can "install" snipster by simply cloning the repo onto your local machine or downloading the latest release from here

git clone https://github.com/SophieAu/snipster.git

Then, you need to add the file snipster to your path. the easiest way to do that is to symbolically link to it from the bin directory

ln -s snipster/src/snipster ~/bin/

snipster also needs a few dependencies to function properly. Make sure they are installed

Credits

This project was heavily inspired by cheat, a command line cheat sheet viewer/creator


sophieau.github.io – Twitter @SolviAu – © 2018, MIT Licence

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
snipster_py-1.0.3-py3-none-any.whl (7.5 kB) Copy SHA256 hash SHA256 Wheel py3
snipster-py-1.0.3.tar.gz (7.0 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page