Split SDK is an open source project and we welcome feedback and contribution. The information below describes how to build the project with your changes, run the tests, and send the Pull Request(PR).
- Fork the repository and create a topic branch from
development
branch. Please use a descriptive name for your branch. - While developing, use descriptive messages in your commits. Avoid short or meaningless sentences like "fix bug".
- Make sure to add tests for both positive and negative cases.
- Run the linter script of the project and fix any issues you find.
- Run the build script and make sure it runs with no errors.
- Run all tests and make sure there are no failures.
git push
your changes to GitHub within your topic branch.- Open a Pull Request(PR) from your forked repo and into the
development
branch of the original repository. - When creating your PR, please fill out all the fields of the PR template, as applicable, for the project.
- Check for conflicts once the pull request is created to make sure your PR can be merged cleanly into
development
. - Keep an eye out for any feedback or comments from Split's SDK team.
To install this gem dependencies onto your local machine, run bundle exec rake install
.
Then you can build the gem using gem build splitclient-rb.gemspec
and install on your Ruby version with gem install splitclient-rb-X.X.X.gem
(the version number should match what you just built).
The gem uses rspec
for unit testing. You can find the files for the unit tests and the specs helper file (spec_helper.rb
) under the default /spec
folder.
To run all the specs in the spec
folder, use the provided rake task (make sure Redis is running in localhost):
bundle exec rspec
Simplecov
is used for coverage reporting. Upon executing the rake task it will store the reports in the /coverage
folder.
To run the static code analysis using Rubocop run:
bundle exec rubocop
If you want to benchmark the hashing algorithm (MurmurHash) run:
bundle exec rake compile:murmurhash
If you have any other questions or need to contact us directly in a private manner send us a note at [email protected]