Forking

Forking

In case you want to submit a pull request, you will have to follow these steps:

1. Fork awless on github https://github.com/wallix/awless.git
2. Create a new branch for your feature git checkout -b feature-branch
3. Add your feature and its tests
4. Commit your changes git commit -a -m "New feature"
5. Test your changes and the whole awless project, following the procedure described on the testing page
6. Push the branch to your github git push -u origin feature-branch
7. Create a new pull request

Sources

If you just want to play or code against the source code you can just get the sources with:

go get -u github.com/wallix/awless

Building, testing and running

You need first need to install Golang >= 1.10 to build awless.

Quick test

$ cd awless
$ go test -v -race ./...

Have a look at the Testing wiki page for more on the awless test suite.

Build and Run

To run from your local repo:

$ cd awless
$ go run main.go list instances

To build a local executable

$ go build
	
	or

$ GOARCH=amd64 GOOS=linux go build # Cross compilation to Linux amd64

Then

$ ./awless list instances

Or if you want to install to your $GOPATH/bin

$ go install
$ awless list instances