jolheiser
/
gpm
1
0
Fork 0
Code Issues Pull Requests Releases 8 Activity
Go Package Mapper
15 Commits
1 Branch
8 Tags
596 KiB
Go 98.8%
Dockerfile 1.2%
 
 
Go to file
jolheiser 2da056a909
continuous-integration/woodpecker the build was successful Details
Refactor (#9) 
Reviewed-on: #9
Co-authored-by: jolheiser <john.olheiser@gmail.com>
Co-committed-by: jolheiser <john.olheiser@gmail.com>
 		2021-11-03 04:37:57 +00:00
cmd Refactor (#9) 2021-11-03 04:37:57 +00:00
database Rewrite (#7) 2021-02-28 13:04:05 +08:00
docker Rewrite (#7) 2021-02-28 13:04:05 +08:00
go-gpm Remove extra go mod (#8) 2021-10-29 01:09:23 +00:00
router Refactor (#9) 2021-11-03 04:37:57 +00:00
.gitignore Initial commit 2020-02-18 23:18:36 -06:00
.woodpecker.yml Refactor (#9) 2021-11-03 04:37:57 +00:00
DOCS.md Refactor (#9) 2021-11-03 04:37:57 +00:00
LICENSE Rewrite (#7) 2021-02-28 13:04:05 +08:00
README.md Refactor (#9) 2021-11-03 04:37:57 +00:00
docs.go Refactor (#9) 2021-11-03 04:37:57 +00:00
go.mod Refactor (#9) 2021-11-03 04:37:57 +00:00
go.sum Refactor (#9) 2021-11-03 04:37:57 +00:00
main.go Refactor (#9) 2021-11-03 04:37:57 +00:00
tools.go Refactor (#9) 2021-11-03 04:37:57 +00:00

README.md

GPM

Go Package Mapping

Motivation

I personally use a lot of nice libraries in Go, but every time I start a new project I have to go hunting for import paths again!

Enter GPM, a glorified mapping of simple names to go-get imports.

For example, I use urfave/cli for all of my CLI projects. I've used it enough times to remember the import path, but let's say I didn't.
Using either a GPM server or local config, I can instead gpm get cli which finds cli in my map and runs go get github.com/urfave/cli/v2.

Commands

  • add - Add a local package
  • remove - Remove a local package
  • list - List local packages
  • config - Change local configuration
  • get - Get a list of packages
    • e.g. gpm get zerolog survey bbolt cli chi to get all the modules needed for gpm itself (assuming the map resolves to the same packages)
  • server - Start a gpm server

Server

gpm will call out to a gpm server to find a package.
This makes it much simpler to have a central library of packages rather than exporting and importing between environments.

Want to run your own server? It's very easy! This CLI comes packaged with the server inside, simply run gpm server to start up a GPM server.
Remember to set a --token!
Put it behind your favorite reverse proxy, and it's ready to go!

License

MIT