edryd.org

commit 33680e7ebf283de6f2013e62a384144cbe75a763
parent 19ee230585698212b0ac30a8777a6427f32cbcfb
Author: Ed van Bruggen <edvb54@gmail.com>
Date:   Wed, 26 Jul 2017 20:50:23 -0700

proj: add gs

Diffstat:
_data/projects.yml
 | 
2
++
projects/gs.md
 | 
94
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

2 files changed, 96 insertions(+), 0 deletions(-)
diff --git a/_data/projects.yml b/_data/projects.yml
@@ -5,6 +5,8 @@ main:
       desc: 'simple note taker'
     - name: 'tim'
       desc: 'extendable personal assistant'
+    - name: 'gs'
+      desc: 'gist creator'
     - name: 'dmenium'
       desc: 'small collection of dmenu scripts'
     - name: 'dmenu-center'
diff --git a/projects/gs.md b/projects/gs.md
@@ -0,0 +1,94 @@
+---
+title: gs
+description: 'gist creator'
+tags: c linux cli github gist curl json api
+---
+
+Easy way to create Github gists with the command line.
+
+## OPTIONS
+
+**-d** *DESCRIPTION*
+	Set gist description
+
+**-f** *FILENAME*
+	Set file name when reading from `stdin`
+
+**-p**
+	Make gist private
+
+**-P**
+	Make gist public (default)
+
+**-u** *USER*[:*PASSWORD*]
+	Change the Github account the gist will be posted under. A password can
+	given as well with a separating colon, a prompt is provided if not.
+
+**-U**
+	Post gist anonymously (default)
+
+**-h**
+	Print help and exit
+
+**-v**
+	Print version info and exit
+
+## USAGE
+
+Create a new gist of file `file.txt`:
+
+	$ gs file.txt
+	https://gist.github.com/<new-id>
+
+There is also support for multiple files in a single gist:
+
+	$ gs README.md Makefile prog.c
+	https://gist.github.com/<new-id>
+
+Specify the gist's description:
+
+	$ gs -d 'a cool shell script' script.sh
+	https://gist.github.com/<new-id>
+
+The gist's URL can be piped to other programs, for example to your clipboard to
+be pasted else where:
+
+	$ gs file.txt | xsel -bi
+
+You can also create a new gist from `stdin`. The file name needs to be supplied
+however:
+
+	$ cmd-which-errors | gs -f log.txt
+	https://gist.github.com/<new-id>
+
+New gists can be private as well:
+
+	$ gs -p personal.info
+	https://gist.github.com/<new-id>
+
+The new gist can be posted under a Github user, a prompt will ask for your
+password:
+
+	$ gs -u your-name good-proj.rs
+	Github password:
+	https://gist.github.com/<new-id>
+
+To skip the prompt your password can be supplied after a colon with the
+username:
+
+	$ gs -u your-name:password plugin/func.vim doc/func.txt
+	https://gist.github.com/<new-id>
+
+## AUTHOR
+
+Ed van Bruggen <edvb54@gmail.com>
+
+## SEE ALSO
+
+See project page at: <http://edryd.org/projects/gs.html>
+
+View source code at: <https://github.com/edvb/gs>
+
+## LICENSE
+
+zlib License