Skip to content

Latest commit

 

History

History
73 lines (43 loc) · 2.68 KB

CONTRIBUTING.md

File metadata and controls

73 lines (43 loc) · 2.68 KB

Development and Testing

To run the project locally, clone the repository and install the dependencies.

git clone https://github.com/amadeusdev/amadeus-ruby.git
cd amadeus-ruby
bundle

Running tests

To run tests, simply run rake or guard to keep watching the source for changes and test accordingly.

We are trying to keep 100% coverage, so keep an eye on the coverage folder for an overview of the coverage.

Using a library locally

To use a library locally as a dependency, simply link to this library in your project by path:

gem 'amadeus', path: '../path/to/clone'

To install quickly get playing with your code we have added a console that automatically includes the gem into the gem path.

rake console
> amadeus = Amadeus::Client.new

Releasing

To release, make sure to update the version number, submit all your changes, and run rake release. This will be replaced in the future by a deploy through Travis CI.

How to contribute to the Amadeus Ruby Gem

Did you find a bug?

  • Ensure the bug was not already reported by searching on GitHub under Issues.

  • If you're unable to find an open issue addressing the problem, open a new one. Be sure to include a title and clear description, as much relevant information as possible, and a code sample or an executable test case demonstrating the expected behavior that is not occurring.

Did you write a patch that fixes a bug?

  • Open a new GitHub pull request with the patch.

  • Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.

Do you intend to add a new feature or change an existing one?

  • Suggest your change in a new issue and start writing code.

  • Make sure your new code does not break any tests and include new tests.

  • With good code comes good documentation. Try to copy the existing documentation and adapt it to your needs.

  • Close the issue or mark it as inactive if you decide to discontinue working on the code.

Do you have questions about the source code?

Do you want to contribute to the documentation?

Excellent, to get start developing this library ensure you have Ruby 2.2+ installed and clone the repository.

Then, you should be able to run the tests.

bundle install # ensure all gems are installed
guard # watches for changes and runs all tests and updates docs