README.org

Helm Github Stars

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

Known issues

wrong-type-argument integer-or-marker-p nil

Reported in #26

Github API use TLS 1.3 which don’t like emacs’s default TLS settings.

I suggest to set these settings in your emacs configuration:

(setq gnutls-verify-error t
      gnutls-min-prime-bits 2048
      gnutls-algorithm-priority "SECURE192:+SECURE128:-VERS-ALL:+VERS-TLS1.2"
      nsm-settings-file (expand-file-name "network-security.data" user-emacs-directory)
      nsm-save-host-names t
      network-security-level 'high
      tls-checktrust t
      tls-program '("gnutls-cli -p %p --dh-bits=2048 --ocsp --x509cafile=%t --priority='SECURE192:+SECURE128:-VERS-ALL:+VERS-TLS1.2:%%PROFILE_MEDIUM' %h"))

Sources:

• https://github.com/Sliim/emacs.d/blob/master/modules/emacsd-tls-hardening-module.el
• https://www.reddit.com/r/emacs/comments/8sykl1/emacs_tls_defaults_are_downright_dangerous/