We love contribution
We are very grateful to you if you take some time to contribute to the project.
If you have some time to spend on the project you can pick existing enhancement or bug from Issues page.
You can also contribute to translation, see JMeter Localisation (Translator's Guide).
Submitting a patch
If you want to contribute to JMeter for a bug fix or enhancement, here is the procedure to follow:
Check your patch
Before submitting your patch ensure you do the following:
Check that patch compiles and follows Tab space policy by running:
Check that patch does not break JUnit tests by running:
Create a PR using GIT
- Open a bugzilla issue, see Issues page
- Fork Apache JMeter mirror
- Clone your forked repository locally :
|
|
|
|
git clone https://github.com/yourid/jmeter/ |
|
|
|
|
- Create a branch using for example bugzilla id:
- Checkout the new branch :
- commit your fix there :
|
|
|
|
git commit -m 'Fix to BUGID' list of files |
|
|
|
|
- Please avoid creating merge commits in the PR. We embrace small changes, and merge commits are harder to review
- Add JMeter repository as upstream :
|
|
|
|
git remote add upstream http://www.github.com/apache/jmeter |
|
|
|
|
- push it :
- Create a PR and link it in the bugzilla issue
Different operation systems have different defaults for end-of-line markers.
Typical configuration is CRLF for Windows and LF for macOS and GNU/Linux.
It is recommended to follow that configuration by appropriate settings of core.autocrlf.
For Windows
|
|
|
|
git config --global core.autocrlf true |
|
|
|
|
, and for macOS and GNU/Linux set
|
|
|
|
git config --global core.autocrlf input |
|
|
|
|
Git will automatically recognize text files in the repository thanks to .gitattributes,
and Git will convert line endings for text files to the appropriate platform-native format (according to core.autocrlf)
Certain files (e.g. *.sh or *.bat) have predefined end of line policy
no matter the configuration of the developer workstation.
|
Create a PR using Patch
- Open a bugzilla issue, see Issues page
- Checkout Apache JMeter source
- Code your fix
- Create your patch by Right clicking on Eclipse project and select
- Attach your patch to the bugzilla issue