gister 1.0.18

gist making script

examples

• post a secret gist on public github: cat doge | gister

• post a secret gist on private github deployment: cat doge | gister -p

• post a secret anonymous gist on public github: cat doge | gister -a

• post a secret anonymous gist on private github deployment: cat doge | gister -ap

• post a secret gist on public github with a command: cat doge | tail -n4 | gister -c "cat doge | tail -n4"

• post a secret gist of a file on public github: gister filename.txt

• post a secret gist of two files on public github: gister lolcats doge.text

• post a secret anonymous gist of globbed files on public github: gister -a *.txt *.py

usage

NOTE! all gists are now secret

gister [-h] [-p] [-s] [-a] [-c COMMAND] [-v] [file [file ...]]

make gists!

positional arguments:
  files                 name of file(s) to gist

optional arguments:
  -h, --help            show this help message and exit
  -p, --private         put gist on configured enterprise github
  -a, --anonymous       gist will be anonymous even if you have oauth
                        configured
  -c COMMAND, --command COMMAND
                        command to prepend to gist
  -v, --vim             gist came from vim, no prompt/history
  -d DESCRIPTION, --description DESCRIPTION
                        description of the gist

install

• pip install gister or clone the repo and python setup.py install

config file - .gister

an example configuration file .gister is given for you to use. it will be looked for in ~/.gister. it supports these values:

• public_oauth - your public github oauth token (not necessary for anonymous gists)

• private_oauth - your private github oauth token (if you plan on using private github) (not necessary for anonymous gists)

• prompt - configure prompt that is displayed when using the -c/--command option

• public_github_url - this defaults to the url for public github

• private_github_url - if you plan on using -p/--private this url needs to be set to the location of your private github deployment

github oauth tokens

gister can be used with no oauth tokens, but can only create anonymous gists by specifying the -a/--anonymous flag

all gists will fall back to anonymous posting if you don’t have oauthxi configured for the endpoint being used

you can manage your github oauth tokens here by visiting applications in your account settings

you can also create an oauth token using the github api as I did in this gist

keyring

use of keyring is optional. it allows you store your oauth tokens in a safer place than the ~/.gister config file

if you wish to use keyring, specify your public_oauth and/or public_oauth tokens as follows:

[gister]
private_oauth = KEYRING
public_oauth = KEYRING

gister will look for a section called gister with keys public_oauth and/or private_oauth containing a github oauth tokens linked to your public github and/or private github account. an example of adding keys to python keyring

using with vim

I added the following to my .vimrc to interact with gister:

" ------- gist making! --------------------------------
fun Gister(...)
  let gister_call = "gister -v"
  for flag in a:000
    let gister_call = gister_call . " " . flag
  endfor
  let result = system(gister_call, expand("%:t") . "\n" . getreg("\""))
  echo result
endfun
" secret gist on public github from selection or single line
vnoremap <F9> y:call Gister()<cr>
nnoremap <F9> yy:call Gister()<cr>

" secret gist on private github from selection or single line
vnoremap <F10> y:call Gister("-p")<cr>
nnoremap <F10> yy:call Gister("-p")<cr>
" ------- end pastie.org ---------------------------