teddywing edited this page Oct 25, 2018 · 54 revisions

Table of Contents

This document collects thoughts and notes about versioned Go modules from the Gophers #vgo channel. Invites to Gophers Slack from here.

Initial paper

The initial paper can be read here https://research.swtch.com/vgo.

The proposal can be found here https://github.com/golang/go/issues/24301.

The reference implementation: https://go.googlesource.com/vgo/ and mirrored on Github here: https://github.com/golang/vgo.

The Go issue tracker is used to track bugs/feature requests. Issues should have the label modules and titles starting with cmd/go so that they can be automatically categorized. You can read the existing issues here.

Note: The reference implementation was named vgo, but support for modules is being integrated into the go command itself. The feature within the go command is called “versioned Go modules” (or “modules” for short), not “vgo”.

Current state

Currently, module support is in active development in the main go repository, with changes mirrored back to the vgo repository. Module support still has some rough edges. You are encouraged to try it and give your feedback, share your experience with it, and contribute to it.

For any production workloads, use dep, or migrate to it if you have not done so already.

The proposal has been accepted and vgo was merged into the Go tree in version 1.11.

You will be able to experiment with the module workflow from Go 1.11 as it is included as an experiment in this release.

Comment Threads

These are threads that have been created from the initial reference manifest:

Blog posts



Projects Related to module support


Question Answer
Hitting GitHub API rate limits? Create a token and add it to .netrc, see related issue
How does vgo handles dependencies of older, discarded versions link? https://github.com/zeebo/vgo-test-version-selection
Why are major versions in import paths? https://groups.google.com/forum/#!topic/golang-dev/Plc42fslQEk
How to go get so that I can run a program, not download a library? https://gophers.slack.com/archives/C9BMAAFFB/p1519687366000101
What's the best way to maintain a package repository that have the major version in the import path? https://groups.google.com/d/topic/golang-nuts/nS6ST60dwF8/discussion, https://groups.google.com/d/topic/golang-nuts/VREgKrQRFcY/discussion
Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.