Skip to content

golang

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

golang

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
cmd
cmd
 
 
internal
internal
 
 
README.md
README.md
 
 

README.md

Go module documentation

Quick start

Prerequisites

  • Go (tested on go 1.24 linux/amd64). Installation instructions here.

  • Prepare the required libraries by running this command from the root dir of this repository:

go mod download

This command will download all packages as defined in go.mod and go.sum.

Project layout

This go module follows the Golang project layout as specified in golang-standards/project-layout.

macaron
├── golang
│   ├── cmd
│   │   ├── bashparser
│   │   └── cuevalidator
│   ├── internal
│   │   ├── bashparser
│   │   ├── cuevalidator
│   │   └── filewriter
│   └── README.md
├── go.mod
├── go.sum
└── <other files in the root repository ...>
  • golang is the directory where all Go source files and tests are located. This is to separate it from python where the code for Macaron sit.
  • The cmd dir contains the main applications of the module. The applications usually don't have a lot of code. These applications will import and use code from internal or pkg.
  • The internal dir contains the internal code that we don't want others importing. This is also enforced by Go itself - check here for more information.
  • The pkg dir contains code that we want to share with anyone who use our go module. They can import those libraries so we should expect code in this directory to work properly. This dir is empty at the moment.
  • go.mod and go.sum contain the metadata (checksum, semantic versions, etc.) of required libraries, the name of the Go module and the Go version.

Run the application code directly using Go

To run an application (in the cmd dir), from the root dir of this repository:

go run ./golang/cmd/<app_name>/<app_name>.go [ARGS]

Run the Go tests

To run all the tests, from the root dir of this repository:

make test

To just run the Go tests:

go test ./golang/...

To run the tests and record the code coverage, from the root dir of this repository:

go test -cover ./golang/...

Build the executable

To build an executable of an application in this module:

make setup-go

Alternatively you can run:

go build ./golang/cmd/<app_name>/<app_name>.go

This will generate an executable app_name in the current directory. We can also change the path of the output executable by using:

go build -o <output_path> ./golang/cmd/<app_name>/<app_name>.go