Skip to content

gophr-pm/gophr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gophr - golang package management

Go Report Card GoDoc Build Status Coverage Status

An end-to-end package management solution for Go. No manifest or lock file and a fully versioned dependency graph. Simply place the url in your import path and it's automatically fully versioned.

gophr.pm/author/repo@(semver or SHA)

Native golang dependency management

go get can only retrieve the current master branch. If you ever need to re-download your dependency it could be totally different each time.

  import (
      // Un-versioned github link
      "github.com/a/b"
  )

Gophr dependency management and versioning

Gophr allows you to version lock your dependencies by semver or SHA.

  import (
      // Version current master branch
      "gophr.pm/a/b"
      // Version by semver
      "gophr.pm/a/b@1.0"
      // Version by semver logic
      "gophr.pm/a/b@>1.0.0"
      "gophr.pm/a/b@<1.3.2"
      // Version by partial or full SHA (Anything between 6 - 40 Characters)
      "gophr.pm/a/b@24638c"
      "gophr.pm/a/b@24638c6d1aaa1"
      "gophr.pm/a/b@24638c6d1aaa1a39c14c704918e354fd3949b93c"
  )

The problem with native Golang dependency management

Golang has no ability to version a specific SHA or tag for a repo. Anytime you pull down an import it grabs the current master branch. This not only bad practice but it could potentially silently break your code without you ever knowing why.

There are plenty of Golang versioning tools. What makes Gophr special?

Gophr doesn't require you to install any tooling to use. Simply place the versioned url gophr.pm/author/repo@(semver or SHA) in your import path and you're done.

We give you the power of semver to reference tags and create logical equivalence operations just like in gem and npm.

"gophr.pm/a/b@>1.0.4"
"gophr.pm/a/b@<1.0.0"

We also fully version the entire dependency graph. Meaning, we version lock every sub-dependency as well, so it's perfectly preserved, everytime. Something no one else does.

Gophr Resources

Questions, comments, concerns? Feel free to open an issue or reach out on slack @shikkic, @skeswa or @ZacharyThomas