Skip to content

Latest commit

 

History

History
58 lines (37 loc) · 1.45 KB

CONTRIBUTE.md

File metadata and controls

58 lines (37 loc) · 1.45 KB
Raw

How to Build and Contribute

Below are guidelines for building and code contribution.

Prerequisites

  • JDK 11 and above
  • Gradle 7.0 and above

Build from source

To build the project, run maven commands.

git clone https://github.com/ochiengolanga/mpesa4j.git 
cd mpesa4j
gradle clean assemble

Cloning the git repository on Windows

Some files in the git repository may exceed the Windows maximum file path (260 characters), depending on where you clone the repository. If you get Filename too long errors, set the core.longPaths=true git option:

git clone -c core.longPaths=true https://github.com/ochiengolanga/mpesa4j.git
cd mpesa4j
gradle clean assemble

Test

  • Run unit tests
gradle clean test
  • Skip test execution
gradle clean build -x test

Version management

Developing version naming convention is like 2.0.0. Release version naming convention is like 2.0.0. Please don't update version if no release plan.

CI

GitHubActions is enabled.

Contribution

Code contribution is welcome. To contribute to existing code or add a new starter, please make sure below check list is checked.

  • Documents are updated to align with code.
  • New starter must have sample folder containing sample code and corresponding readme file.
  • Code coverage for new code >= 65%. Code coverage check is enabled with 65% bar.