Command line documentation is available in the docs folder.
ApiGear CLI is a command line application that runs on Windows, Mac and Linux. You can download the latest version from the release page.
Note: The product has not yet a certification from Microsoft, Apple or Linux. So you may need to disable the security check to run the application.
Install latest Go from Go Dev
build using
go build ./cmd/apigear
and use apigear command line:
./apigear --help
For development you need some environment variables:
export APIGEAR_GIT_PUBLIC_TOKEN=your_token
export APIGEAR_GIT_AUTH_TOKEN=your_token
The git public token provides access to public repositories. The git auth token provides access to private template repositories.
You can build and run the project using the following commands:
go run cmd/apigear/main.go --help
To build the project:
go build ./cmd/apigear
To run all the tests:
```bash
go test "./..."
To run the debugger
dlv debug cmd/apigear/main.go -- --help
Settings are stored in the file ~/.apigear/config.json
. The file is created automatically when the first command is executed.
Log files are stored in the file ~/.apigear/*.log
. Outdated log-files are automatically deleted.
The template cache is stored in the file ~/.apigear/templates
. The file is created automatically when a template is downloaded from a git-repository.
The template registry is stored in the file ~/.apigear/registry/registry.json
. The file is created automatically when the registry is updated. The registry is currently hosted on github.