+ldflags

README.md

@@ -51,6 +51,7 @@
    + [➡ Create 3D visualization of concurrency traces](#-create-3d-visualization-of-concurrency-traces)
  - Generate Code
    + [➡ Generate `String` method for enum types](#-generate-string-method-for-enum-types)
+   + [➡ Run `go:generate` in parallel](#-run-gogenerate-in-parallel)
  - Refactoring
    + [➡ Replace symbol](#-replace-symbol)
  - Errors
@@ -60,6 +61,7 @@
    + [➡ Disable inlining](#-disable-inlining)
    + [➡ Aggressive inlining](#-aggressive-inlining)
    + [➡ Manually disable or enable `cgo`](#-manually-disable-or-enable-cgo)
+   + [➡ Include metadata in binary during compilation with `ldflags`](#-include-metadata-in-binary-during-compilation-with-ldflags)
  - Binary
    + [➡ Make treemap breakdown of Go executable binary](#-make-treemap-breakdown-of-go-executable-binary)
  - Documentation
@@ -792,6 +794,16 @@ Requirements
 go install golang.org/x/tools/cmd/stringer@latest
 ```
 
+### ➡ Run `go:generate` in parallel
+
+Official Go team [encourages](https://github.com/golang/go/issues/20520) to run sequentially. However, in certain cituations, such as lots of mocks, parallelization helps a lot, ableit, you should consider including your generated files in git. The solution bellow spawns multiple processes, each per pkg.
+
+
+```
+grep -rnw "go:generate" -E -l "${1:-*.go}" . | xargs -L1 dirname | sort -u | xargs -P 8 -I{} go generate {}
+```
+
+
 ## Refactoring
 
 ### ➡ Replace symbol
@@ -874,6 +886,29 @@ go build -gcflags="-l -l -l -l" .
 Disable `cgo` with `CGO_ENABLED=0` and enable with `CGO_ENABLED=1`. If you don't, `cgo` may end-up being enabled or code dynamically linked if, for example, you use some `net` or `os` packages. You may want to disable `cgo` to improve performance, since complier and runtime would have easier job optimizing code. This also should reduce your image size, as you can have alpine image with less shared libraries.
 
 
+### ➡ Include metadata in binary during compilation with `ldflags`
+
+You can pass metadata through compiler to your binary. This is useulf for including things like git commit, database schema version, integrity hashes. Variables can only be strings.
+
+
+```
+go build -v -ldflags="-X 'main.Version=v1.0.0'"
+go build -v -ldflags="-X 'my/pkg/here.Variable=some-string'"
+```
+
+```go
+package main
+
+var Version string
+
+func main() {
+	// Version here has some value
+	...
+}
+
+```
+
+
 ## Binary
 
 ### ➡ Make treemap breakdown of Go executable binary

page.yaml

@@ -297,6 +297,10 @@ groups:
         example_content_url: source/stringer/stringer.go
         requirements:
           - go install golang.org/x/tools/cmd/stringer@latest
+      - title: Run `go:generate` in parallel
+        description: Official Go team [encourages](https://github.com/golang/go/issues/20520) to run sequentially. However, in certain cituations, such as lots of mocks, parallelization helps a lot, ableit, you should consider including your generated files in git. The solution bellow spawns multiple processes, each per pkg.
+        commands:
+          - grep -rnw "go:generate" -E -l "${1:-*.go}" . | xargs -L1 dirname | sort -u | xargs -P 8 -I{} go generate {}
   - title: Refactoring
     entries:
       - title: Replace symbol
@@ -329,6 +333,12 @@ groups:
           - go build -gcflags="-l -l -l -l" .
       - title: Manually disable or enable `cgo`
         description: Disable `cgo` with `CGO_ENABLED=0` and enable with `CGO_ENABLED=1`. If you don't, `cgo` may end-up being enabled or code dynamically linked if, for example, you use some `net` or `os` packages. You may want to disable `cgo` to improve performance, since complier and runtime would have easier job optimizing code. This also should reduce your image size, as you can have alpine image with less shared libraries.
+      - title: Include metadata in binary during compilation with `ldflags`
+        description: You can pass metadata through compiler to your binary. This is useulf for including things like git commit, database schema version, integrity hashes. Variables can only be strings.
+        commands:
+          - go build -v -ldflags="-X 'main.Version=v1.0.0'"
+          - go build -v -ldflags="-X 'my/pkg/here.Variable=some-string'"
+        example_content_url: source/ldflags-meta.go
   - title: Binary
     entries:
       - title: Make treemap breakdown of Go executable binary

source/ldflags-meta.go

@@ -0,0 +1,8 @@
+package main
+
+var Version string
+
+func main() {
+	// Version here has some value
+	...
+}