:satellite: Canonical Imports Generator for Go Packages

GitHub Repository

Twist generates canonical imports for your Go packages. Since it does not require a running server (ie in existing tools like uber-go/sally and rsc/go-import-redirector), Twist is particularly useful in conjunction with GitHub Pages.

A canonical import path allows you to make your package import a little fancier with a custom domain, for example:

- import "github.com/bobheadxi/zapx"
+ import "go.bobheadxi.dev/zapx"

I use Twist myself to generate import names for my packages at go.bobheadxi.dev, which acts as the source for a GitHub Pages site that performs the redirection.

The CLI can easily generate templates for a single package:

go get -u go.bobheadxi.dev/twist
#          [        source         ] [     canonical     ]
twist -o x github.com/bobheadxi/zapx go.bobheadxi.dev/zapx

Or generate templates for many packages using a flexible configuration format:

twist -c twist.example.yml -o x -readme

Drop by the repository to learn more!


Robert Lin

Robert Lin

Enthusiastic eater of lunches

rss facebook twitter github youtube tumblr mail spotify lastfm instagram linkedin google google-plus pinterest medium vimeo stackoverflow reddit quora quora