Generics.pw: Go Generics Made Easy.

---

Why?

• Go lacks generics and templates, and while interfacestries to help with that, they come at a heavy runtime-performance cost.
• Copying / pasting a template is rather inconvenient and if you modify the base, you have to modify them all by hand.
• Using reflection is even slower than using interfaces.

What is the solution?

• Until there are proper generics / templating support in Go, it will always be inconvenient.
• Generics.pw tries to make it less inconvenient by allowing you to directly import templates with custom types instead of using interfaces.

How to use it?

The template url consists of: generics.pw/t/template-name[=type-name[,pkgname][,cmp]]/*pkg.type1[=import-path]/typeN[=import-path]

if pkg. is omitted when importing a custom type, the type will be imported as import . "yourtype".

• Using import in your code: import "generics.pw/t/set/int"
• Using git manually: git clone https://generics.pw/t/set/int
• Using go get: go get "generics.pw/t/set/int"
• Download the file directly: generics.pw/t/set/int
• Download the named file (add .go to the url): generics.pw/t/set/int.go / curl -O -J -L https://generics.pw/t/set/int.go, you will have a file named set_int.go in the current directory.

If =type-name is omitted, the package name will be main if the file is downloaded directly or lowercase template-name if imported using git, and the type name will be capitalized Templatename

Advance Usage

Custom Types:

Any valid import URL can be used as long as you replace / with :, this also works for local urls.

Available (optional) shortcuts:

Shortcut	Expands To
g	generics.pw/t/
gp	gopkg.in/
gh	github.com/
gc	code.google.com/p/
gcg	code.google.com/p/go.
bb	bitbucket.org/
lp	launchpad.net/

Example:

import "generics.pw/t/safemap=lmap/string/*tng.TCPListener=gh:OneOfOne:net-tng"

Using other generic types as custom types:

Paramaters for custom types are T = Type #1 , U and V = Type #3, knowing that, you can mix and match generic types together:

import "generics.pw/t/safemap/string/*Set=g:set:V/string" // = map[string]*Set where Set is an int Set.

Custom Compare Functions not available yet:

If your type doesn't support native compare operators (=, <), you will have to define a Cmp function on your type, assuming the template requires comparision for your type (for example heap or sort):

// yourtype.go
func (t *Type) Cmp(o *Type) int {
	switch {
		case t > o: return 1
		case t == o: return 0
	}
	return -1
}
// import code
import "generics.pw/t/heap=,cmp/*MyType=gh:you:YourType"

How to create a custom template to submit?

Variable	Meaning
P	package name
N	package type name
T	type 1
U	type 2
V	type 3
W	type 4
X	type 5
Y	type 6
Z	type 7

FAQ

Where's the source for available templates?

on github @ tmpl/

How to add / improve a current template?

Fork the project on github, add the type following the specs and send a pull request.

Is this project a fork of or based on gonerics.io?

Not at all, I've been working on this idea for quiet sometime, we're using completely different approaches to the problem.