Google Git
Sign in
go / wiki / 6ddfd5742b4cc66393c7013e85b94aa032e3ff2e / . / vgo.md
blob: 8f4a83e1a6646ec3cd9423b921bffeebb5e4a63a [file] [log] [blame] [view]
Florin Pățanc3caba32018-02-24 22:07:48 +0000[diff] [blame]1## Table of Contents
2
Florin Pățane7177be2018-02-24 22:31:52 +0000[diff] [blame]3* [Initial paper](#initial-paper)
Florin Pățande0605e2018-02-24 22:39:47 +0000[diff] [blame]4* [Current state](#current-state)
Florin Pățanc3caba32018-02-24 22:07:48 +0000[diff] [blame]5* [Comment Threads](#comment-threads)
6* [Blog posts](#blog-posts)
Florin Pățan7687a8e2018-03-17 09:43:18 +0000[diff] [blame]7* [Presentations](#presentations)
Florin Pățanc3caba32018-02-24 22:07:48 +0000[diff] [blame]8* [Videos](#videos)
9* [Questions](#questions)
Florin Pățan7687a8e2018-03-17 09:43:18 +0000[diff] [blame]10* [Proxies](#proxies)
Florin Pățanc3caba32018-02-24 22:07:48 +0000[diff] [blame]11
Florin Pățanabf2c9c2018-02-24 21:51:56 +0000[diff] [blame]12This document collects thoughts and notes about vgo from the Gophers [#vgo](https://gophers.slack.com/messages/vgo) channel. Invites to Gophers Slack from [here](https://invite.slack.golangbridge.org/).
13
Florin Pățane7177be2018-02-24 22:31:52 +0000[diff] [blame]14### Initial paper
Florin Pățanabf2c9c2018-02-24 21:51:56 +0000[diff] [blame]15
Florin Pățane7177be2018-02-24 22:31:52 +0000[diff] [blame]16The **initial paper** can be read here [https://research.swtch.com/vgo](https://research.swtch.com/vgo).
Florin Pățanc3caba32018-02-24 22:07:48 +0000[diff] [blame]17
Florin Pățan67d80332018-03-20 20:20:43 +0000[diff] [blame]18The **proposal** can be found here [https://github.com/golang/go/issues/24301](https://github.com/golang/go/issues/24301).
19
Florin Pățane7177be2018-02-24 22:31:52 +0000[diff] [blame]20The **reference implementation**: [https://go.googlesource.com/vgo/](https://go.googlesource.com/vgo/) and mirrored on Github here: [https://github.com/golang/vgo](https://github.com/golang/vgo).
Florin Pățanfffd9742018-02-24 22:19:59 +0000[diff] [blame]21
Damian Gryski6dcc43b2018-02-26 13:56:29 -0800[diff] [blame]22The **[Go issue tracker](https://golang.org/issues)** is used to track bugs / feature requests for vgo. The issue titles need to start with `x/vgo` so that they can be automatically categorized. You can read the [existing issues here](https://golang.org/issues?q=is%3Aopen+is%3Aissue+milestone%3Avgo).
Florin Pățanfffd9742018-02-24 22:19:59 +0000[diff] [blame]23
Florin Pățancb7780e2018-02-24 22:59:06 +0000[diff] [blame]24***
25
Florin Pățancc6d77e2018-02-24 22:39:11 +0000[diff] [blame]26### Current state
27
Florin Pățan8a36e312018-02-24 22:43:10 +0000[diff] [blame]28Currently vgo is in active development / prototype phase. It has some rough edges, changes will happen at a rapid pace. You are encouraged to try vgo and give your feedback, share your experience with it, and contribute to it.
Florin Pățancc6d77e2018-02-24 22:39:11 +0000[diff] [blame]29
30For any production workloads, use [dep](https://github.com/golang/dep), or migrate to it if you have not done so already.
31
Gordon Klaus6a6260b2018-03-05 21:27:39 +0100[diff] [blame]32vgo will be merged in the Go tree and replace dep at a later date, assuming the proposal is accepted.
Florin Pățancc6d77e2018-02-24 22:39:11 +0000[diff] [blame]33
Florin Pățancb7780e2018-02-24 22:59:06 +0000[diff] [blame]34***
35
Florin Pățanc3caba32018-02-24 22:07:48 +0000[diff] [blame]36### Comment Threads
Florin Pățanabf2c9c2018-02-24 21:51:56 +0000[diff] [blame]37
38These are threads that have been created from the initial reference manifest for vgo:
39
Damian Gryski0699cf92018-02-27 01:40:05 -0800[diff] [blame]40- **golang-nuts ML:** [Go += Package Versioning](https://groups.google.com/forum/#!topic/golang-nuts/jFPz5yZCPcQ), [vgo and vendoring](https://groups.google.com/forum/#!topic/golang-dev/FTMScX1fsYk)
41
Florin Pățan04e7bcd2018-03-19 20:20:36 +0000[diff] [blame]42- **golang-dev ML:** https://groups.google.com/forum/#!topic/golang-dev/MNQwgYHMEcY
Florin Pățanabf2c9c2018-02-24 21:51:56 +0000[diff] [blame]43- **HackerNews posts:** https://news.ycombinator.com/from?site=swtch.com
44- **Reddit:** https://www.reddit.com/domain/research.swtch.com/
45
Florin Pățan04e7bcd2018-03-19 20:20:36 +0000[diff] [blame]46- **vgo & vendoring:** https://groups.google.com/forum/#!topic/golang-dev/FTMScX1fsYk
47- **vgo & semantic import versioning** https://groups.google.com/forum/#!topic/golang-dev/Plc42fslQEk
Florin Pățan14362c42018-03-19 20:19:54 +0000[diff] [blame]48
Florin Pățanc3caba32018-02-24 22:07:48 +0000[diff] [blame]49***
50
Florin Pățanabf2c9c2018-02-24 21:51:56 +0000[diff] [blame]51### Blog posts
52
53- [Thoughts on vgo and dep](https://sdboyer.io/blog/vgo-and-dep/)
Florin Pățanb5099b02018-02-24 22:22:32 +0000[diff] [blame]54- [Exploring vgo](https://www.calhoun.io/exploring-vgo/)
Florin Pățan3df89672018-02-24 22:46:09 +0000[diff] [blame]55- [Semantic Import Versioning in the wild](http://blog.ezyang.com/2018/02/semantic-import-versioning-in-the-wild/)
Florin Pățanabf2c9c2018-02-24 21:51:56 +0000[diff] [blame]56
Florin Pățanc3caba32018-02-24 22:07:48 +0000[diff] [blame]57***
58
Florin Pățanbc2d8762018-03-17 09:44:22 +0000[diff] [blame]59### Presentations
Florin Pățanabf2c9c2018-02-24 21:51:56 +0000[diff] [blame]60
Florin Pățan7687a8e2018-03-17 09:43:18 +0000[diff] [blame]61- [Repeatable Builds with vgo](https://cda.ms/jD)
62
63***
64
65### Videos
66
Florin Pățan7edd71f2018-02-28 20:16:34 +0000[diff] [blame]67- [Using vgo for Go Dependency Management](https://www.gophersnacks.com/programs/using-vgo-for-go-dependency-management) by Brian Ketelsen
68- [Building Predictability into Your Pipeline](https://www.youtube.com/watch?v=sbrZfPgNmfw) with Russ Cox, Jess Frazelle, Sam Boyer, Pete Garcin.
Florin Pățanabf2c9c2018-02-24 21:51:56 +0000[diff] [blame]69
Florin Pățanc3caba32018-02-24 22:07:48 +0000[diff] [blame]70***
Florin Pățanabf2c9c2018-02-24 21:51:56 +0000[diff] [blame]71
Florin Pățanc3caba32018-02-24 22:07:48 +0000[diff] [blame]72### Questions
73
Florin Pățanb9ccd872018-02-24 22:08:47 +0000[diff] [blame]74| Question | Answer |
Florin Pățanc3caba32018-02-24 22:07:48 +0000[diff] [blame]75| ------------- | ------------- |
76| Hitting GitHub API rate limits? | Create a token and add it to .netrc, see [related issue](https://golang.org/issues/23955) |
Florin Pățanbed91c62018-02-26 22:52:48 +0000[diff] [blame]77| How does vgo handles dependencies of older, discarded versions [link](https://gophers.slack.com/archives/C9BMAAFFB/p1519493604000033)? | [https://github.com/zeebo/vgo-test-version-selection](https://github.com/zeebo/vgo-test-version-selection) |
Daniel Jay Haskine4cee862018-02-26 16:27:45 -0700[diff] [blame]78| Why are major versions in import paths? | https://groups.google.com/forum/#!topic/golang-dev/Plc42fslQEk |
79| How to `go get` so that I can run a program, not download a library? | https://gophers.slack.com/archives/C9BMAAFFB/p1519687366000101 |
Florin Pățan7687a8e2018-03-17 09:43:18 +0000[diff] [blame]80
81***
82
83### Proxies
84
85- [Athens](https://github.com/gomods/athens) - A proxy server for vgo