Gain insights into writing professional command-line programs in Go. Delve into structuring Go programs, writing idiomatic code, testing effectively, and impressing users and managers.

write professional command  - line programs in Go.png

data.tar.gz

Go run main.go

Run main.sh

Run go test

Run go test2

GoLive

GoLiveTesting

Multi-git-Custom

Pre+main-v0.2

Main_to_cmd

Run go test-Coverage

Ginkgo

Ginkgo-BDD

Ginkgo-e2e

Cobra

Cobra-NoInstall

Cobra-NoInstall-FullApp

Final_Cobra_Multi-git

Viper

Viper-etcd

Viper-Cobra

SelfUpdating

Make

Special build

Embedding_Data

Go run main.go-Simple

In this course you will learn why Go is an awesome language for writing command-line programs. You will learn how to structure your Go programs, how to write idiomatic Go code, how to test your programs and how to amaze your users, peers and managers. 

The focus is on command-line programs in order to keep the course down to earth, but most of the principles and best practices you will learn apply to any Go program.

Write Professional Command-line Programs in Go

# The importance of directory structure

Command-line programs can be tiny or very large. Large programs have a lot of code and are developed over a long time by many different developers. The proper directory structure can contribute a lot to the program's long-term success. There are several dimensions that benefit from deliberate and well-planned directory structure.

## Code organization

The code of every large program should be organized in a way that makes it easy to locate, search, and wrap your head around. Directories with specific roles are a time-tested strategy to achieve this.

## Developer collaboration

Developers can collaborate more easily when specific aspects of the program live in distinct directories. Many types of changes will involve specific directories, while other cross-functional changes will involve multiple directories. It is convenient to review changes when files that perform similar functions live in the same directory. Developers can detect omissions and changes that don't follow consistent patterns more easily.

## Program evolution

As the program grows, directories and subdirectories help to extend the program without making the overall structure represented by directories more complicated. A directory with ten files is not much more complicated than a directory that contains a hundred files.

# Go workspaces, $GOPATH, and modules

Before Go 1.11, Go programs had to live in a very strict hierarchy called a workspace. The `$GOPATH` environment variable had a list of one or more directories, and three sub-directories under the `$GOPATH`:

- src
- bin
- pkg

All your source code and the source code of your dependencies would go under source typically organized further by the source control system it originated from. Compiled packages would go under `pkg` and compiled executables would go under `bin`.

Go 1.11 introduced preliminary support, with a special environment variable, for modules where your code could be anywhere as long as it contained a go.mod file. Go 1.12 supported modules by default anywhere except inside `$GOPATH`. Go 1.13 supports modules anywhere, including inside GOPATH.

For more information about Go modules, check out https://github.com/golang/go/wiki/Modules.

# The elements of a Go program

There are many ways to divide and categorize the files that go into a Go program. I highlight some of the most common ones.

## Packages

Go code is organized in packages. A package is a directory that contains files and sub-packages, or sub-directories. Here is the repo_manager package:

```
$ tree repo_manager/
repo_manager/
├── repo_manager.go
├── repo_manager_suite_test.go
└── repo_manager_test.go
```

The repo_manager lives under pkg/repo_manager and has three Go files.


Code in a package has access to all the variables and functions defined in the package. Meanwhile, code in other packages has access only to public variables and functions with capitalized names. Every source code file must have a package statement at the top that matches the package name.


```
package repo_manager

...
```

## Commands

Commands are executables. In a command-line program the program itself is a command. A command will have a file that contains the main() function. If a project has multiple executables, there will be multiple commands (possibly in multiple sub-directories) that contain the main() function. Each one will have to be built separately. They can all import the same packages, but it's not recommended to import other commands. If there is shared functionality useful for multiple commands, it should be placed in a package both commands can import. 

## Tests

Tests are critical for any program, and command-line programs are no different. Go recognizes this fact and provides support for creating and running tests out of the box via the standard testing package and the `go test` command. If a file has a name with the suffix `_test.go`, Go will consider it a test file and run the tests in it when you type `go test`. We will discuss testing in detail later in the course.

For-example, the `repo_manager` package, has a test called `repo_manager_test.go`.

## Documentation

Programs often have documentation beyond comments in the code. In particular, command-line programs usually have detailed in-program help about each command and option. However, some programs have external documentation, too.

## Metadata and build information

Here, you'll often find all kinds of files such as `README`, `LICENSE`, `Dockerfile`, `go.mod`, etc. Those files are not Go source files, but they support the program in various ways. In particular, the `go.mod` file describes your program's dependencies.

# The importance of directory structure

Command-line programs can be tiny or very large. Large programs have a lot of code and are developed over a long time by many different developers. The proper directory structure can contribute a lot to the program's long-term success. There are several dimensions that benefit from deliberate and well-planned directory structure.

## Code organization

The code of every large program should be organized in a way that makes it easy to locate, search, and wrap your head around. Directories with specific roles are a time-tested strategy to achieve this.

## Developer collaboration

Developers can collaborate more easily when specific aspects of the program live in distinct directories. Many types of changes will involve specific directories, while other cross-functional changes will involve multiple directories. It is convenient to review changes when files that perform similar functions live in the same directory. Developers can detect omissions and changes that don't follow consistent patterns more easily.

## Program evolution

As the program grows, directories and subdirectories help to extend the program without making the overall structure represented by directories more complicated. A directory with ten files is not much more complicated than a directory that contains a hundred files.

# Go workspaces, $GOPATH, and modules

Before Go 1.11, Go programs had to live in a very strict hierarchy called a workspace. The `＄GOPATH` environment variable had a list of one or more directories, and three sub-directories under the `＄GOPATH`:

- src
- bin
- pkg

All your source code and the source code of your dependencies would go under source typically organized further by the source control system it originated from. Compiled packages would go under `pkg` and compiled executables would go under `bin`.

Go 1.11 introduced preliminary support, with a special environment variable, for modules where your code could be anywhere as long as it contained a go.mod file. Go 1.12 supported modules by default anywhere except inside `＄GOPATH`. Go 1.13 supports modules anywhere, including inside GOPATH.

For more information about Go modules, check out https://github.com/golang/go/wiki/Modules.

# The elements of a Go program

There are many ways to divide and categorize the files that go into a Go program. I highlight some of the most common ones.

## Packages

Go code is organized in packages. A package is a directory that contains files and sub-packages, or sub-directories. Here is the repo_manager package:

```
$ tree repo_manager/
repo_manager/
├── repo_manager.go
├── repo_manager_suite_test.go
└── repo_manager_test.go
```

The repo_manager lives under pkg/repo_manager and has three Go files.


Code in a package has access to all the variables and functions defined in the package. Meanwhile, code in other packages has access only to public variables and functions with capitalized names. Every source code file must have a package statement at the top that matches the package name.


```
package repo_manager

...
```

## Commands

Commands are executables. In a command-line program the program itself is a command. A command will have a file that contains the main() function. If a project has multiple executables, there will be multiple commands (possibly in multiple sub-directories) that contain the main() function. Each one will have to be built separately. They can all import the same packages, but it's not recommended to import other commands. If there is shared functionality useful for multiple commands, it should be placed in a package both commands can import. 

## Tests

Tests are critical for any program, and command-line programs are no different. Go recognizes this fact and provides support for creating and running tests out of the box via the standard testing package and the `go test` command. If a file has a name with the suffix `_test.go`, Go will consider it a test file and run the tests in it when you type `go test`. We will discuss testing in detail later in the course.

For-example, the `repo_manager` package, has a test called `repo_manager_test.go`.

## Documentation

Programs often have documentation beyond comments in the code. In particular, command-line programs usually have detailed in-program help about each command and option. However, some programs have external documentation, too.

## Metadata and build information

Here, you'll often find all kinds of files such as `README`, `LICENSE`, `Dockerfile`, `go.mod`, etc. Those files are not Go source files, but they support the program in various ways. In particular, the `go.mod` file describes your program's dependencies.

Let's dive into one of the foundations of Go programs. In this lesson, you'll learn to organize your code in a directory structure that will help separate concerns, promote understanding, and support the evolution of the code.

The foundations of a Go Program

Overview

Restructuring multi-git

Testing 1,2,3...

Adding Smart Command-Line Parsing

Adding Advanced Configuration

Adding Bells and Whistles

Summary

The foundations of a Go Program

The importance of directory structure