plzthx / github-starred-to-pinboard

Send starred github repos to pinboard

Github Starred Repos to Pinboard Bookmarks

It turns recently starred repos from a Github account into bookmarks in Pinboard.

It makes the bookmark like this:

That is, it sets the bookmark title to the repo name followed by the short, one-liner repo description. It lists the languages used in the repo in order of bytes, too. Just for you. Because I like you. It also lists the as much of the readme file as will fit in Pinboard's description field.

Usage

Get your Github OAuth token from here.

Get your Pinboard API token from here.

If you already have some of these repos bookmarked, this script will not replace them. If you wish to change this, set the replace variable to no. Take note that even if replace is yes, the datetime on the bookmarks will not be altered.

The bookmarks will be tagged with the terms in the tags variable.

On first run, it creates a config file with the same base filename as you named this script. (If you didn't rename the script, it'll be called exporter.config) You can uncomment and fill in gh_username, gh_token, and pb_token if you do not want to create a config file.

Otherwise, run the script and follow the directions.

Requirements

python 2.6 - 2.7.5

Requests

Limitations

It only works for the 100 most recently starred repos. It works for any number of repos. Thanks, jdherg!

API calls are limited to 4103 characters which really cuts down on how much of the readme file is included in the description.

TODO

• Make it work for folks who have more than 100 starred repos.
• Make it fail more gracefully
  • Pinboard rate limit failure (once every 3 seconds) done.
  • Github rate limit failure (60 per hour unauthenticated or 5000 authenticated). The authenticated limit isn't a problem because the pinboard rate limit is already significantly lower: 3/second, or 1200/hour
• Add an option to replace existing bookmarks with the original datetime
• Check to ensure the entered github username exists.