Browse your starred repositories with Emacs helm interface
Emacs Lisp
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
test
.gitignore
.travis.yml
COPYING
Cask
ChangeLog
README.org
helm-github-stars.el

README.org

Helm Github Stars

http://secure.travis-ci.org/Sliim/helm-github-stars.png?branch=master http://melpa.org/packages/helm-github-stars-badge.svg http://stable.melpa.org/packages/helm-github-stars-badge.svg

helm-github-stars provides capabilities to fetch your starred repositories from github and select one for browsing.

Requirements

  • Emacs >= 24.4
  • Helm >= 1.6.8

Installation

MELPA

helm-github-stars is available on Melpa:

M-x package-install helm-github-stars

Manual

Drop helm-github-stars.el in your load-path:

(add-to-list 'load-path "/path/to/helm-github-stars")
(require 'helm-github-stars)

Usage

To show your starred repositories:

M-x helm-github-stars

Setup your username

(setq helm-github-stars-username "USERNAME")

Cache

At the first execution of helm-github-stars, list of repositories is fetched from github and saved into a cache file.

To refresh cache and open helm interface run:

M-x helm-github-stars-fetch

The default cache location is $HOME/.emacs.d/hgs-cache, you can customize this path:

(setq helm-github-stars-cache-file "/cache/path")

Update the cache file automatically

Besides runing helm-github-stars-fetch to update the cache file manually, you can also do it automatically while runing helm-github-stars by customizing helm-github-stars-refetch-time, for example, refresh the cache file once it is older than 0.5 days (i.e., 12 hours):

(setq helm-github-stars-refetch-time 0.5)

Align repositories’s description

For a clean look, repositories’s description is aligned by default, you can customize this behavior via helm-github-stars-name-length, it’s default value is 30. You can disable this by setting helm-github-stars-name-length to nil:

(setq helm-github-stars-name-length nil)

Private repositories

If you want to be able to show your private repositories, customize helm-github-stars-token then call helm-github-stars-fetch or helm-github-stars.

Run tests

Move into repository’s root directory and run:

cask install
cask exec ert-runner