dce/davideisinger.com
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Fix relative URLs in archives

Browse Source
This commit is contained in:
David Eisinger
2024-01-17 00:08:36 -05:00
parent 9fc1babee6
commit c5f0c6161a
76 changed files with 5949 additions and 6641 deletions
Download Patch File Download Diff File Expand all files Collapse all files

208
static/archive/medium-com-efpmux.txt
View File

@@ -1,18 +1,29 @@
#[1]Medium [2]alternate
[3]Open in app
(BUTTON) Sign up
[4]Sign in
____________________
Write
(BUTTON) Sign up
[5]Sign in
(BUTTON)
Go Project Layout
Kyle C. Quest (Q)
golang-learn
[3]Kyle C. Quest (Q)
[6]Kyle C. Quest (Q)
·
[4]Follow
[7]Follow
Published in
[5]
[8]
golang-learn
·
@@ -23,7 +34,7 @@ Go Project Layout
--
(BUTTON)
12
11
(BUTTON)
Listen
@@ -31,15 +42,15 @@ Go Project Layout
Share
You went through the ‘[6]Tour of Go’, played with
[7]https://play.golang.org/ and you feel you are ready to write some
You went through the ‘[9]Tour of Go’, played with
[10]https://play.golang.org/ and you feel you are ready to write some
code. Great! However, you are not sure how to structure your projects.
Can you put your code anywhere you want? Is there a standard way to
organize your code? What if you need to have multiple application
binaries? What does it mean to be ‘go gettable’? These are some of the
questions you’ll be asking yourself.
First, you have to understand Go workspaces. ‘[8]How to Write Go Code’
First, you have to understand Go workspaces. ‘[11]How to Write Go Code’
is a good place to start. By default, Go keeps and expects all code in
a single workspace. This place is identified by the GOPATH environment
variable. What does it mean for you? It means you have to put your code
@@ -51,7 +62,7 @@ Go Project Layout
your project doesn’t have to be in a workspace if you don’t import
external packages and you use relative imports for your own code, but
it’s not recommended. It’s fine for a toy project or a PoC though. Go
v1.11 does introduce the concept of [9]modules that allows you to have
v1.11 does introduce the concept of [12]modules that allows you to have
your project code outside of your GOPATHwithout the import restrictions
mentioned above, but it’s still an experimental feature at this point
in time.
@@ -80,9 +91,9 @@ Go Project Layout
to separate the application files. You’ll be able to build each
application with the right set of go build flags, but go get will no
longer work because it will not know which application code to build.
The official [10]Go tools is one example of the cmd layout patter. A
The official [13]Go tools is one example of the cmd layout patter. A
number of other well known projects use the same pattern:
[11]Kubernetes, [12]Docker, [13]Prometheus, [14]Influxdb.
[14]Kubernetes, [15]Docker, [16]Prometheus, [17]Influxdb.
The pkg layout pattern is also pretty popular. For new Go developers
it’s one of the most confusing package structure concepts because Go
@@ -94,14 +105,14 @@ Go Project Layout
you and other external users of your code. Other projects will import
these libraries expecting them to work, so think twice before you put
something here. Many well known projects use this pattern:
[15]Kubernetes, [16]Docker, [17]Grafana, [18]Influxdb, [19]Etcd.
[18]Kubernetes, [19]Docker, [20]Grafana, [21]Influxdb, [22]Etcd.
Some of the libraries in the pkg directory are not always for public
use. Why is that? It happens because many existing Go projects predate
the ability to hide internal packages. Some projects put those internal
libraries in the pkg directory to be consistent with the rest of their
code structure. Other projects put their internal libraries into
separate directories outside of the pkg directory. [20]Go 1.4 introduce
separate directories outside of the pkg directory. [23]Go 1.4 introduce
an ability to hide code using internal directories. What does it mean?
If you put your code in an ‘internal’ directory no external project
will be able to import that code. Even other code in your project won’t
@@ -110,7 +121,7 @@ Go Project Layout
new; however, it’s extremely valuable as an additional layer of control
(in addition to the lowercase and uppercase function visibility rules
in Go). A number of new and well known projects use this pattern:
[21]Dep, [22]Docker, [23]Nsq, [24]Go Ethereal, [25]Contour.
[24]Dep, [25]Docker, [26]Nsq, [27]Go Ethereal, [28]Contour.
The internal directory is the place to put your private packages. You
can optionally add additional structure by separating your internally
@@ -120,8 +131,8 @@ Go Project Layout
code in the ‘internal’ directory the application code in the cmd
directory will be limited to small files that define the ‘main’
function for the corresponding application binaries. Everything else
will be imported from the internal or pkg directories ([26]ark, from
Heptio, and [27]loki, from Grafana, are good examples of this tiny main
will be imported from the internal or pkg directories ([29]ark, from
Heptio, and [30]loki, from Grafana, are good examples of this tiny main
package pattern).
What if you forked and modified a piece of an external project? Some
@@ -136,7 +147,7 @@ Go Project Layout
might be brittle and unpredictable because when somebody else tries to
build your project they might get a backward incompatible version of
that package. The solution is ‘vendoring’. With ‘vendoring’ you freeze
your dependencies by committing them with your project. [28]Go 1.6
your dependencies by committing them with your project. [31]Go 1.6
introduced a standard way to ‘vendor’ external packages (it was an
experimental feature in Go 1.5). Put your external package in the
vendor directory. How is this different from the third_party directory?
@@ -145,19 +156,19 @@ Go Project Layout
project then put it in the third_party directory.
If you want to learn more about the project structure used by other Go
projects read the ‘[29]Analysis of the Top 1000 Go Repositories’. It’s
projects read the ‘[32]Analysis of the Top 1000 Go Repositories’. It’s
a little dated, but it’s still useful.
A real project will have additional directories too. You can use this
layout template as a starting point for your Go projects:
[30]https://github.com/golang-standards/project-layout. It covers the
[33]https://github.com/golang-standards/project-layout. It covers the
Go project layout patterns described in this blog post and it includes
a number of supporting directories you’ll need to have.
Now it’s time to write some code! If you don’t have Go installed take a
look at this [31]quick setup guide for Mac OS X (setup on other
platforms is similar). Go through the ‘[32]Tour of Go’ if you haven’t
done it yet and then read ’[33]50 Shades of Go’ to learn about the most
look at this [34]quick setup guide for Mac OS X (setup on other
platforms is similar). Go through the ‘[35]Tour of Go’ if you haven’t
done it yet and then read ’[36]50 Shades of Go’ to learn about the most
common gotchas in Go, which will save you quite a bit of time when you
start writing and debugging code.
Golang
@@ -170,116 +181,117 @@ Go Project Layout
--
(BUTTON)
12
11
(BUTTON)
Kyle C. Quest (Q)
golang-learn
(BUTTON) Follow
[34](BUTTON)
[35]
[37](BUTTON)
[38]
Written by Kyle C. Quest (Q)
[36]354 Followers
[39]358 Followers
·Editor for
[37]
[40]
golang-learn
CTO / Redefining DevOps * Hacker @DockerSlim * @Golang50Shades * Cloud
Native * Data * Security
(BUTTON) Follow
[38](BUTTON)
[39]
Help
[40]
Status
[41]
Writers
[41](BUTTON)
[42]
Blog
Help
[43]
Careers
Status
[44]
Privacy
About
[45]
Terms
Careers
[46]
About
Blog
[47]
Text to speech
Privacy
[48]
Terms
[49]
Text to speech
[50]
Teams
References
Visible links:
1. file:///osd.xml
1. https://medium.com/osd.xml
2. android-app://com.medium.reader/https/medium.com/p/e5213cdcfaa2
3. file:///@kcq?source=post_page-----e5213cdcfaa2--------------------------------
4. file:///m/signin?actionUrl=https://medium.com/_/subscribe/user/6aac7a58837&operation=register&redirect=https://medium.com/golang-learn/go-project-layout-e5213cdcfaa2&user=Kyle+C.+Quest+(Q)&userId=6aac7a58837&source=post_page-6aac7a58837----e5213cdcfaa2---------------------post_header-----------
5. https://medium.com/golang-learn?source=post_page-----e5213cdcfaa2--------------------------------
6. https://tour.golang.org/
7. https://play.golang.org/
8. https://golang.org/doc/code.html
9. https://github.com/golang/go/wiki/Modules
10. https://github.com/golang/tools/tree/master/cmd
11. https://github.com/kubernetes/kubernetes/tree/master/cmd
12. https://github.com/moby/moby/tree/master/cmd
13. https://github.com/prometheus/prometheus/tree/master/cmd
14. https://github.com/influxdata/influxdb/tree/master/cmd
15. https://github.com/kubernetes/kubernetes/tree/master/pkg
16. https://github.com/moby/moby/tree/master/pkg
17. https://github.com/grafana/grafana/tree/master/pkg
18. https://github.com/influxdata/influxdb/tree/master/pkg
19. https://github.com/coreos/etcd/tree/master/pkg
20. https://golang.org/doc/go1.4#internalpackages
21. https://github.com/golang/dep/tree/master/internal
22. https://github.com/moby/moby/tree/master/internal
23. https://github.com/nsqio/nsq/tree/master/internal
24. https://github.com/ethereum/go-ethereum/tree/master/internal
25. https://github.com/heptio/contour/tree/master/internal
26. https://github.com/heptio/ark/blob/master/cmd/ark/main.go
27. https://github.com/grafana/loki/blob/master/cmd/loki/main.go
28. https://golang.org/doc/go1.6#go_command
29. http://blog.sgmansfield.com/2016/01/an-analysis-of-the-top-1000-go-repositories/
30. https://github.com/golang-standards/project-layout
31. file:///golang-learn/quick-go-setup-guide-on-mac-os-x-956b327222b8
32. https://tour.golang.org/
33. http://devs.cloudimmunity.com/gotchas-and-common-mistakes-in-go-golang/
34. file:///m/signin?actionUrl=/_/api/subscriptions/newsletters/997b4efe98f9&operation=register&redirect=https://medium.com/golang-learn/go-project-layout-e5213cdcfaa2&newsletterV3=6aac7a58837&newsletterV3Id=997b4efe98f9&user=Kyle+C.+Quest+(Q)&userId=6aac7a58837&source=-----e5213cdcfaa2---------------------subscribe_user-----------
35. file:///@kcq?source=post_page-----e5213cdcfaa2--------------------------------
36. file:///@kcq/followers?source=post_page-----e5213cdcfaa2--------------------------------
37. https://medium.com/golang-learn?source=post_page-----e5213cdcfaa2--------------------------------
38. file:///m/signin?actionUrl=/_/api/subscriptions/newsletters/997b4efe98f9&operation=register&redirect=https://medium.com/golang-learn/go-project-layout-e5213cdcfaa2&newsletterV3=6aac7a58837&newsletterV3Id=997b4efe98f9&user=Kyle+C.+Quest+(Q)&userId=6aac7a58837&source=-----e5213cdcfaa2---------------------subscribe_user-----------
39. https://help.medium.com/hc/en-us?source=post_page-----e5213cdcfaa2--------------------------------
40. https://medium.statuspage.io/?source=post_page-----e5213cdcfaa2--------------------------------
41. https://about.medium.com/creators/?source=post_page-----e5213cdcfaa2--------------------------------
42. https://blog.medium.com/?source=post_page-----e5213cdcfaa2--------------------------------
43. file:///jobs-at-medium/work-at-medium-959d1a85284e?source=post_page-----e5213cdcfaa2--------------------------------
44. https://policy.medium.com/medium-privacy-policy-f03bf92035c9?source=post_page-----e5213cdcfaa2--------------------------------
45. https://policy.medium.com/medium-terms-of-service-9db0094a1e0f?source=post_page-----e5213cdcfaa2--------------------------------
46. https://medium.com/about?autoplay=1&source=post_page-----e5213cdcfaa2--------------------------------
47. https://speechify.com/medium?source=post_page-----e5213cdcfaa2--------------------------------
48. file:///business?source=post_page-----e5213cdcfaa2--------------------------------
3. https://rsci.app.link/?$canonical_url=https://medium.com/p/e5213cdcfaa2&~feature=LoOpenInAppButton&~channel=ShowPostUnderCollection&source=---two_column_layout_nav----------------------------------
4. https://medium.com/m/signin?operation=login&redirect=https://medium.com/golang-learn/go-project-layout-e5213cdcfaa2&source=post_page---two_column_layout_nav-----------------------global_nav-----------
5. https://medium.com/m/signin?operation=login&redirect=https://medium.com/golang-learn/go-project-layout-e5213cdcfaa2&source=post_page---two_column_layout_nav-----------------------global_nav-----------
6. https://medium.com/@kcq?source=post_page-----e5213cdcfaa2--------------------------------
7. https://medium.com/m/signin?actionUrl=https://medium.com/_/subscribe/user/6aac7a58837&operation=register&redirect=https://medium.com/golang-learn/go-project-layout-e5213cdcfaa2&user=Kyle+C.+Quest+(Q)&userId=6aac7a58837&source=post_page-6aac7a58837----e5213cdcfaa2---------------------post_header-----------
8. https://medium.com/golang-learn?source=post_page-----e5213cdcfaa2--------------------------------
9. https://tour.golang.org/
10. https://play.golang.org/
11. https://golang.org/doc/code.html
12. https://github.com/golang/go/wiki/Modules
13. https://github.com/golang/tools/tree/master/cmd
14. https://github.com/kubernetes/kubernetes/tree/master/cmd
15. https://github.com/moby/moby/tree/master/cmd
16. https://github.com/prometheus/prometheus/tree/master/cmd
17. https://github.com/influxdata/influxdb/tree/master/cmd
18. https://github.com/kubernetes/kubernetes/tree/master/pkg
19. https://github.com/moby/moby/tree/master/pkg
20. https://github.com/grafana/grafana/tree/master/pkg
21. https://github.com/influxdata/influxdb/tree/master/pkg
22. https://github.com/coreos/etcd/tree/master/pkg
23. https://golang.org/doc/go1.4#internalpackages
24. https://github.com/golang/dep/tree/master/internal
25. https://github.com/moby/moby/tree/master/internal
26. https://github.com/nsqio/nsq/tree/master/internal
27. https://github.com/ethereum/go-ethereum/tree/master/internal
28. https://github.com/heptio/contour/tree/master/internal
29. https://github.com/heptio/ark/blob/master/cmd/ark/main.go
30. https://github.com/grafana/loki/blob/master/cmd/loki/main.go
31. https://golang.org/doc/go1.6#go_command
32. http://blog.sgmansfield.com/2016/01/an-analysis-of-the-top-1000-go-repositories/
33. https://github.com/golang-standards/project-layout
34. https://medium.com/golang-learn/quick-go-setup-guide-on-mac-os-x-956b327222b8
35. https://tour.golang.org/
36. http://devs.cloudimmunity.com/gotchas-and-common-mistakes-in-go-golang/
37. https://medium.com/m/signin?actionUrl=/_/api/subscriptions/newsletters/997b4efe98f9&operation=register&redirect=https://medium.com/golang-learn/go-project-layout-e5213cdcfaa2&newsletterV3=6aac7a58837&newsletterV3Id=997b4efe98f9&user=Kyle+C.+Quest+(Q)&userId=6aac7a58837&source=-----e5213cdcfaa2---------------------subscribe_user-----------
38. https://medium.com/@kcq?source=post_page-----e5213cdcfaa2--------------------------------
39. https://medium.com/@kcq/followers?source=post_page-----e5213cdcfaa2--------------------------------
40. https://medium.com/golang-learn?source=post_page-----e5213cdcfaa2--------------------------------
41. https://medium.com/m/signin?actionUrl=/_/api/subscriptions/newsletters/997b4efe98f9&operation=register&redirect=https://medium.com/golang-learn/go-project-layout-e5213cdcfaa2&newsletterV3=6aac7a58837&newsletterV3Id=997b4efe98f9&user=Kyle+C.+Quest+(Q)&userId=6aac7a58837&source=-----e5213cdcfaa2---------------------subscribe_user-----------
42. https://help.medium.com/hc/en-us?source=post_page-----e5213cdcfaa2--------------------------------
43. https://medium.statuspage.io/?source=post_page-----e5213cdcfaa2--------------------------------
44. https://medium.com/about?autoplay=1&source=post_page-----e5213cdcfaa2--------------------------------
45. https://medium.com/jobs-at-medium/work-at-medium-959d1a85284e?source=post_page-----e5213cdcfaa2--------------------------------
46. https://blog.medium.com/?source=post_page-----e5213cdcfaa2--------------------------------
47. https://policy.medium.com/medium-privacy-policy-f03bf92035c9?source=post_page-----e5213cdcfaa2--------------------------------
48. https://policy.medium.com/medium-terms-of-service-9db0094a1e0f?source=post_page-----e5213cdcfaa2--------------------------------
49. https://speechify.com/medium?source=post_page-----e5213cdcfaa2--------------------------------
50. https://medium.com/business?source=post_page-----e5213cdcfaa2--------------------------------
Hidden links:
50. file://localhost/?source=---two_column_layout_nav----------------------------------
51. file://localhost/@kcq?source=post_page-----e5213cdcfaa2--------------------------------
52. https://medium.com/golang-learn?source=post_page-----e5213cdcfaa2--------------------------------
53. file://localhost/tag/golang?source=post_page-----e5213cdcfaa2---------------golang-----------------
54. file://localhost/tag/go?source=post_page-----e5213cdcfaa2---------------go-----------------
55. file://localhost/tag/standards?source=post_page-----e5213cdcfaa2---------------standards-----------------
56. file://localhost/tag/project-structure?source=post_page-----e5213cdcfaa2---------------project_structure-----------------
57. file://localhost/@kcq?source=post_page-----e5213cdcfaa2--------------------------------
58. https://medium.com/golang-learn?source=post_page-----e5213cdcfaa2--------------------------------
52. https://medium.com/?source=---two_column_layout_nav----------------------------------
53. https://medium.com/m/signin?operation=register&redirect=https%3A%2F%2Fmedium.com%2Fnew-story&source=---two_column_layout_nav-----------------------new_post_topnav-----------
54. https://medium.com/search?source=---two_column_layout_nav----------------------------------
55. https://medium.com/@kcq?source=post_page-----e5213cdcfaa2--------------------------------
56. https://medium.com/golang-learn?source=post_page-----e5213cdcfaa2--------------------------------
57. https://medium.com/tag/golang?source=post_page-----e5213cdcfaa2---------------golang-----------------
58. https://medium.com/tag/go?source=post_page-----e5213cdcfaa2---------------go-----------------
59. https://medium.com/tag/standards?source=post_page-----e5213cdcfaa2---------------standards-----------------
60. https://medium.com/tag/project-structure?source=post_page-----e5213cdcfaa2---------------project_structure-----------------
61. https://medium.com/@kcq?source=post_page-----e5213cdcfaa2--------------------------------
62. https://medium.com/golang-learn?source=post_page-----e5213cdcfaa2--------------------------------