Contributing to DNSimple/Elixir View Source

Getting started

1. Clone the repository

Clone the repository and move into it:

git clone git@github.com:dnsimple/dnsimple-elixir.git
cd dnsimple-elixir

2. Install Elixir

3. Install the dependencies

mix deps.get

4. Build and test

Compile the project and run the test suite to check everything works as expected.

Testing

mix test

Releasing

The following instructions uses $VERSION as a placeholder, where $VERSION is a MAJOR.MINOR.BUGFIX release such as 1.2.0.

  1. Run the test suite and ensure all the tests pass.

  2. Set the version in mix.exs:

     defmodule Dnsimple.Mixfile do
       use Mix.Project
       @version "$VERSION"
     end
  3. Run the test suite and ensure all the tests pass.

  4. Finalize the ## main section in CHANGELOG.md assigning the version.

  5. Commit and push the changes

     git commit -a -m "Release $VERSION"
     git push origin main
    
  6. Wait for CI to complete.

  7. Create a signed tag.

     git tag -a v$VERSION -s -m "Release $VERSION"
     git push origin --tags
    
  8. Release to Hex.

     mix hex.publish
    

Tests

Submit unit tests for your changes. You can test your changes on your machine by running the test suite.

When you submit a PR, tests will also be run on the continuous integration environment via GitHub Actions.