[comment]: # "markdown: { smartypants: true }" # Hello Go Grand Tour of Tooling <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/NtKBcVku6EU?start=0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

# Hello Go Grand Tour of Tooling <img title="QR Code for jswithtypes.com" alt="slides link" src="https://i.imgur.com/M7cV8Kg.png" width="42%">

### Useful Links <table> <tr><td> <small>Slides:</small></td><td><small> <a href="https://beyondcodebootcamp.github.io/presos/hello-go/">beyondcodebootcamp.github.io</a></small></td> </tr> <tr><td> <small>Appendix:</small></td><td><small> <a href="https://github.com/BeyondCodeBootcamp/hello-go/issues/1">github.com/BeyondCodeBootcamp/hello-go/issues/1</a></small></td> </tr> <tr><td> <small>Video:</small></td><td><small> <a href="https://www.youtube.com/watch?v=NtKBcVku6EU">https://youtu.be/NtKBcVku6EU</a></small> </td></tr> <tr><td> <small>Go Proverbs (Poster):</small></td><td><small> <a href="https://github.com/BeyondCodeBootcamp/go-proverbs/">github.com/BeyondCodeBootcamp/go-proverbs</a></small> </td></tr> <tr><td> <small>Template Repo:</small></td><td><small> <a href="https://github.com/BeyondCodeBootcamp/hello-go">github.com/BeyondCodeBootcamp/hello-go</a></small> </td></tr> <tr><td> <small>Slides Builder:</small></td><td><small> <a href="https://beyondcodebootcamp.github.io/presos/#quick-start-to-render">MD Slides</a></small> </td></tr> </table>

AJ ONeal <br> [@\_beyondcode](https://twitter.com/@_beyondcode) <br> [youtube.com/coolaj86](https://youtube.com/coolaj86)

Dangerous Wrong Thinker Equal Opportunity Offender Technophobic Technologist Extraordinairé

## Savvi Legal Startups anyone?

Utah Node.js Utah Rust [twitch.tv/coolaj86](https://twitch.tv/coolaj86)

❤️ 🐹

Useful? Entertaining? 👍 🔔 ➡️

# Hello Go Grand Tour of Tooling

<table><tr> <td><small> 1. Effective Go<br /> 2. Install<br /> 3. IDE Tooling<br /> 4. eXtended Library<br /> 4. <code>go mod</code><br /> 5. <code>./hello/</code><br /> 6. <code>./internal/</code><br /> 7. <code>go generate</code><br /> 9. <code>tools.go</code><br /> </small></td> <td><small> 10. <code>./vendor/</code><br /> 11. Modules (Plural)<br /> 12. <code>./cmd/</code><br /> 13. <code>godoc</code><br /> 14. <code>version</code><br /> 15. <code>embed</code><br /> 16. <code>goreleaser</code><br /> 17. <code>webi</code><br /> 18. CGO w/ <code>zig</code><br /> </small></td> </tr></table> <!-- - install - version (semver with git tags) - embed (including files in the binary) - tools/tools.go - standard flags (version, help, etc) - godoc - goreleaser - webi - CGO with Zig -->

# 0. Why Go?

- PREDICTABLE

- PREDICTABLE - REPRODUCIBLE

- PREDICTABLE - REPRODUCIBLE - GUARANTEED

- Learn it in a Weekend - [Go Proverbs](https://go-proverbs.github.io/) - Cross-platform to boot

## 1. Hello (Effective) Go

- Go Proverbs - [Rob Pike's Talk](https://www.youtube.com/watch?v=PAAkCSZUG1c) - [Poster](https://github.com/BeyondCodeBootcamp/go-proverbs/) <br> <br> - Effective Go - [go.dev/doc/effective_go](https://go.dev/doc/effective_go) <br> <br> - [Creeds of Craftsmanship . com](https://creedsofcraftsmanship.com/) - [Simplicity is Complicated](https://www.youtube.com/watch?v=rFejpH_tAHM) - [Things in Go I Never Use](https://www.youtube.com/watch?v=5DVV36uqQ4E)

# 2. Hello Go

```go package main import "fmt" func main() { fmt.Println("Hello, 世界") } ``` ```sh go run ./hello.go ```

Go's JSON Download API <https://golang.org/dl/?mode=json&include=all>

1. untar to `~/.local/opt` 2. symlink libs and bin 3. update `PATH`

Webi: [webinstall.dev/golang](https://webinstall.dev/golang) ```sh # Linux, Mac curl -sS https://webi.sh/golang | sh source ~/.config/envman/PATH.env ``` ```sh # Windows curl.exe https://webi.ms/golang | powershell ```

Update or Switch versions ```bash webi golang@1.18 ```

- 💪 Go Download API + Webi - ⚠️ <https://golang.org/dl/> <!-- (`tar`, _not_ pkg) --> - ❌ `brew` - 😵‍💫 `apt` - 🐳 `FROM scratch`

## 3. Hello IDE (vim-go)

Vim or VSCode

```bash webi vim-essentials vim-go ```

## 4. Hello Go X - [golang.org/x](https://pkg.go.dev/golang.org/x) - [golang.org/x/tools/cmd](https://pkg.go.dev/golang.org/x/tools/cmd)

<table> <tr> <th><small>Automatic Tooling<br>(IDE, toolchain)</small></th> <th><small>Dev Utils<br>(<code>go generate</code>)</small></th> <th><small>Libs<br>(special purpose)</small></th> </tr> <tr> <td><small><code>gopls</code></small></td> <td><small><code>stringer</code></small></td> <td><small><code>golang.org/x/crypto</code></small></td> </tr> <tr> <td><small><code>goimports</code></small></td> <td><small><code>godoc *</code></small></td> <td><small><code>golang.org/x/sys/windows</code></small></td> </tr> <tr> <td><small><code>godoc</code> **</small></td> <td><small><code>embed *</code></small></td> <td><small><code>golang.org/x/text</code></small></td> </tr>

## 5. Hello Module

```bash go mod init github.com/example/foo ```

```bash go mod tidy ```

Create project ```bash mkdir -p ./myproject/ pushd ./myproject/ ``` Init with (git-ish) URL ```bash #go mod init <package-path> go mod init github.com/example/foo ``` ```txt go: creating new go.mod: module github.com/example/foo ```

- url-ish - git-ish

📌 Multi-Modules

## 6. Hello Project (Anatomy)

```txt hello/ ├── .git/ ├── .ignore ├── go.mod ├── go.lock ├── hello.go └── cmd/ └── hello/ ```

```txt hello/ ├── .git/ ├── .ignore ├── go.mod ├── go.lock ├── hello.go ├── assets/ ├── cmd/ │ └── hello/ ├── internal/ ├── migrations/ ├── tools/ └── vendor/ └── modules.txt ```

## 7. Hello `./internal/`

`./internal/` for non-exported peer packages

- whole packages (not files)

- whole packages (not files) - experimental / unstable

- whole packages (not files) - experimental / unstable - internal implementation details

- whole packages (not files) - experimental / unstable - internal implementation details - "private"

## 8. Hello `go generate`

`generate.go`: ```go //go:generate stringer -type=Greeting package hello ```

❌ `Makefile`

❌ `Makefile` - ❌ Cross-platform

❌ `Makefile` - ❌ Cross-platform - 🤮 gcc toolchain

## 9. Hello `./tools/`

`./tools/tools.go`: ```go //go:build tools package tools import ( // for the 'stringer' command _ "golang.org/x/tools/cmd/stringer" ) ```

`generate.go`: ```go //go:generate go run -mod=vendor golang.org/x/tools/cmd/stringer -type=Greeting package hello ```

## 10. Hello `./vendor/`

- PREDICTABLE

- PREDICTABLE - REPRODUCIBLE

- PREDICTABLE - REPRODUCIBLE - GUARANTEED

```bash [1-2] go mod tidy go mod vendor ```

```bash [1-2] go generate -mod=vendor ./... go build -mod=vendor ./... ```

```txt -mod=vendor ```

`.ignore`: ```txt vendor ```

## 11. Hello Module(s) (Plural)

(limit dependency hell)

```txt hello/ ├── go.mod ├── go.lock ├── cmd/ │ └── hello/ │ ├── go.mod │ └── go.lock └── examples/ ├── go.mod └── go.lock ```

- [Golang Migrate](https://github.com/golang-migrate/migrate)'s [go.mod](https://github.com/golang-migrate/migrate/blob/master/go.mod)

## 12. Hello `./cmd/`

```txt hello/ └── cmd/ ├── hello/ │ ├── main.go │ └── world.go └── goodbye/ └── main.go ```

```go package main import ( "fmt" ) func main() { fmt.Println("Hello, World!") } ```

```bash go build -mod=vendor -o hello ./cmd/hello/ go build -mod=vendor -o goodbye ./cmd/goodbye/ ```

## 13. Hello `godoc`

`doc.go`:

[godoc-tricks](https://pkg.go.dev/github.com/fluhus/godoc-tricks)

## 14. Hello `version`

```go git tag v1.0.0 ```

- GoReleaser - Go GitVer: \ <https://github.com/therootcompany/go-gitver>

```go var ( version = "v0.0.0" date = "0001-01-01T00:00:00Z" commit = "0000000" ) ```

```go import ( "runtime/debug" ) function main() { build := debug.ReadBuildInfo() fmt.Println( build.Main.Version, build.Main.Sum, ) } ```

```txt -V --version version -version ```

```go if len(args) > 1 { arg := args[0] if "-V" == arg || "version" == strings.TrimLeft(arg, "-") { ver() os.Exit(0) } } ```

for `help` too

```go if len(args) > 1 { arg := args[0] if "-h" == arg || "help" == strings.TrimLeft(arg, "-") { ver() os.Exit(0) } } ```

## 15. Hello `embed`

``` # Create config directory hello init # Serve auto-magic configurator hello server ```

```go package hello import "embed" //go:embed html/* assets/* // FS is the virtual embedded filesystem for all the Hello World things var FS embed.FS ```

```go import ( // ... hello "github.com/BeyondCodeBootcamp/hello-go" ) func main() { f, _ := hello.FS.Open("assets/proverbs.txt") proverbs, _ := ioutil.ReadAll(f) fmt.Printf("%s", proverbs) } ```

## 16. Hello `goreleaser`

Cheat Sheet: https://webinstall.dev/goreleaser

- PREDICTABLE

- PREDICTABLE - REPRODUCIBLE

- PREDICTABLE - REPRODUCIBLE - GUARANTEED

`.goreleaser.yml`: ```yml builds: - env: - CGO_ENABLED=0 main: ./main.go binary: mssql-to-csv goos: - linux - windows goarch: - amd64 - arm64 archives: - format_overrides: - goos: windows format: zip ```

```txt ~/.config/goreleaser/github_token ``` <https://github.com/settings/tokens/new>

- version - git commit - date

`main.go`: ```go var ( version = "v0.0.0" date = "0001-01-01T00:00:00Z" commit = "0000000" ) ```

Cheat Sheet: https://webinstall.dev/goreleaser

## 17. Hello `webi`

- PREDICTABLE

- PREDICTABLE - REPRODUCIBLE

- PREDICTABLE - REPRODUCIBLE - GUARANTEED

Template Repo: <small> <a href="https://github.com/BeyondCodeBootcamp/hello-go">github.com/BeyondCodeBootcamp/hello-go</a></small> ```txt ./dist/webi/ ```

## 18. Hello `zig`

No time. 😢

[Zig makes CGO Cross-Compilation Just Work](https://dev.to/kristoff/zig-makes-go-cross-compilation-just-work-29ho)

Like, Sub, & Follow

Q&A

Thanks.

Like, Sub, & Follow <small>(if you wannu)</small>

FIN