Downloadable binaries are available from the releases page.
Download the appropriate archive for for operating system and architecture.
Extract the executable to a directory of your choosing.
Create Aura API Credentials in your Account Settings, and note down the client ID and secret.
Add these credentials into the CLI with a name of your choosing:
./neo4j-cli aura credential add --name "Aura API Credentials" --client-id <client-id> --client-secret <client-secret>
This will add the credential and set it as the default credential for use.
You can then, for example, list your instances:
./neo4j-cli aura instance list
The full suite of tests can be run using the following command:
go test ./...
The CLI can be run locally without building by running the following command:
go run neo4j-cli/main.go
As well as your code changes, pull requests need a changelog entry. These are added using the tool changie
. You will need to install this using the following command:
go install github.com/miniscruff/changie@latest
With this installed, the following command will guide through the process of adding a changelog entry:
changie new
Simply commit the file that this command produces and you're done!
Builds for releases are handled in GitHub Actions. If you want to create local builds, there are a couple of approaches.
To create a simply binary using go
directly, you can execute the following command:
go build -o bin/ ./...
If you want to build binaries for all varieties of platforms, you can do so with the following command:
GORELEASER_CURRENT_TAG=dev goreleaser release --snapshot --clean
In the above command, GORELEASER_CURRENT_TAG
can be substituted for any version of your choosing.