defaults

Tricky and fun utilities for Go programs.

Getting Started

Prerequisites

Developed with go version go1.17.6 darwin/arm64. Go is extremely backwards compatible and semver stable. Nearly any v1.x should work fine.

Installation

To use this repo as a template for your own project:

gh repo create -y --public --template "https://github.com/skeptycal/testutils"

Clone this repo to test and contribute:

# add repo to $GOPATH (xxxxxx is your computer login username)
go get github.com/xxxxxx/testutils

cd ${GOPATH}/src/github.com/xxxxxx/testutils

# test results and coverage info
./go.test.sh

# install as a utility package
go install

Use the Issues and PR templates on the GitHub repo page to contribute.

Basic Usage

This is a copy of the example script available in the cmd/example/testutils folder:

package main

import "github.com/skeptycal/testutils"

func main() {
    testutils.Example()
}

To try it out:

# change to the sample folder
cd cmd/example/testutils

# run the main.go program
go run ./main.go

# to compile as an executable
go build

Code of Conduct and Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us. Please read the Code of Conduct for details before submitting anything.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Contributors and Inspiration

Michael Treanor (GitHub / Twitter) - Initial work, updates, maintainer
Francesc Campoy - Inspiration and great YouTube videos!

See also the list of contributors who participated in this project.

License

Licensed under the MIT https://opensource.org/licenses/MIT - see the LICENSE file for details.