jist

https://github.com/emacs-pe/jist.el.git

git clone 'git://github.com/emacs-pe/jist.el.git'


---

jist.el

Manage gists from emacs -- lexical-binding: t; --

—

Yet another gist client for Emacs.

Features

• Allows to create gists.
• Allows to delete/clone/star/unstar a gist.
• List your owned/starred gists.
• List public gists.
• List public gists from another github user.

Configuration

To create anonymous gists is not necessary any configuration, but if you want to create gists with your github account you need to obtain a oauth-token with gist scope in https://github.com/settings/applications, and set it through any of the following methods:

• Add (setq jist-github-token "mytoken") to your init.el.
• Add oauth-token to your ~/.gitconfig: git config github.oauth-token mytoken

Usage

Warning: By default, the functions jist-region and jist-buffer create anonymous gists. To create gists with you configured account use jist-auth-region and jist-auth-buffer.

• Create a gist from an active region:

                      | public | anonymous
  

  ————————- | —— | ——— jist-auth-region | | jist-auth-region-public | x | jist-region | | x jist-region-public | x | x

• Create a gist of the contents of the current buffer:

                      | public | anonymous
  

  ————————- | —— | ——— jist-auth-buffer | | jist-auth-buffer-public | x | jist-buffer | | x jist-buffer-public | x | x

You can set the variable jist-enable-default-authorized to non nil to always use your configured account when creating gists.

Tips

• In the current gist API the values of gist_pull_url and git_push_url use the HTTP protocol, but it's inconvenient to use the HTTP for pushes. To use the SSH protocol for pushes in cloned gists you need to add the following to your git-config(1)

  [url "git@gist.github.com:/"]
      pushInsteadOf = "https://gist.github.com/"
  

TODO

• [ ] Add pagination support with rfc5988 link headers. See:
• Github api pagination
• Traversing with Pagination.
• rfc5988

Related Projects

• gist.el
• yagist.el

Function Documentation

(jist-auth-region)

Create an authorized gist from an active region.

(jist-region-public)

Create a public gist from an active region.

(jist-auth-region-public)

Create a public and authorized gist from an active region.

(jist-buffer)

Create a gist from the contents of the current buffer.

(jist-auth-buffer)

Create an authorized gist from the contents of the current buffer.

(jist-buffer-public)

Create a public gist from the contents of the current buffer.

(jist-auth-buffer-public)

Create an authorized and public gist from the contents of the current buffer.

(jist-delete-gist ID)

Delete gist with ID.

(jist-browse-gist ID)

Show a gist with ID in a browser.

(jist-star-gist ID)

Star a gist ID.

(jist-unstar-gist ID)

Unstar a gist ID.

(jist-clone-gist ID)

Close gist ID.

(jist-refetch-gists)

Refetch the gists of a jist-list-mode buffer.

(jist-list-user USER)

Show a list of gist of a github USER.

(jist-list-public)

Show a list of public gists.

(jist-list-starred)

Show a list of starred gists of the configured user.

—–