Skip to content

Setup

Getting

To begin developing the Synse SDK, you will first need your own copy of the source code. Fork the GitHub repo and clone it down to your local workspace.

Requirements

It is recommended to use the following development tools:

  • Go 1.13+: The SDK was developed using Go 1.13.
  • docker: Build and run Synse plugins in a containerized environment.
  • docker-compose: Define and run deployments for development and testing.
  • make: Run predefined targets that simplify various development actions and workflows.

Workflow

To aid in developer workflow, Makefile targets are provided for common development tasks. To see what targets are provided, see the project Makefile, or run make help from the project repo root.

$ make help
check-examples  Check that the example plugins run without failing
clean           Remove temporary files
cover           Run tests and open the coverage report
examples        Build the example plugins
fmt             Run goimports on all go files
github-tag      Create and push a tag with the current version
godoc           Server godocs locally on port 8080
help            Print usage information
lint            Lint project source files
test            Run all tests
version         Print the version of the SDK

It is recommended to run tests, formatting, and linting locally prior to pushing/opening a pull request. These steps, including building the examples, are also run in CI. CI failures will prevent pull requests from being merged.