go-auth0

go-auth0 is a Go client to Auth0 APIs.

Using

Use go modules. Import just the module(s) you need as follows:

import (
	"github.com/zenoss/go-auth0/auth0"
	"github.com/zenoss/go-auth0/auth0/mgmt"
)

Then run go mod tidy to add the requirement to go.mod and go.sum. You will also have to run go mod vendor if your project vendors its dependencies.

Contributing

1. Create a branch based on master named ZING-???? after a JIRA issue.
2. Make your changes in the branch.
3. Add unit tests for your changes.
4. Run all the unit tests: make test
5. Commit your changes.
6. Push your changes: git push -u origin ZING-????
7. Open a pull request against master: gh pr create -f
8. Merge your pull request after getting it reviewed and approved.

Releasing

Releases of this library should be made the same way as releases for any go library.

1. Create a tag for the version on the master branch: git tag vX.Y.Z
2. Push the tag: git push --tags

P.S. Use the vX.Y.Z format for your tag. This is the convention preferred by go mod.

P.P.S. Avoid making backwards-incompatible changes if at all possible. The major version (e.g. 4 in 4.3.2) should only be incremented when a backwards-incompatible change has been made. This major version change also requires the go package have its prefix (e.g. v4/) incremented. All users of the library will then have to update their import paths to opt-in to the new major version.