Skip to content

Latest commit

 

History

History
46 lines (26 loc) · 1.94 KB

CONTRIBUTING.template.md

File metadata and controls

46 lines (26 loc) · 1.94 KB

{{ ossHeader }}

Welcome to client-sdk-go contributing guide 👋

Thank you for taking your time to contribute to our Go SDK! This guide will provide you information to start your own development and testing. Happy coding 💃

Submitting

If you've found a bug, or have a suggestion, please open an issue in our project.

If you want to submit a change, please submit a pull request to our project. Use the normal Github pull request process. Please run make precommit before submitting your pull request; see below for more information.

Minimum Go version

Our minimum supported Go version is currently 1.19. You can download it from go.dev.

Requirements

To make development easier, we provide a Makefile to do common development tasks. If you're on Windows, you can get make by installing Windows Subsystem for Linux (WSL).

First-time setup 🔧

Run make install-devtools. This will install...

Developing 💻

Running make precommit will run all formatters, linters, and the tests. Run this before submitting a PR to ensure the code passes tests and follows our project conventions.

  • make test will just run the tests
  • make lint will just run the formatting and linters

Tests ⚡

We use Ginkgo and Gomega to write our tests.

Integration tests require an auth token for testing. Set the env var TEST_AUTH_TOKEN to provide it, you can get this from your ~/.momento/credentials file.

Then run make test.

{{ ossFooter }}