You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@fineract.apache.org by Dara Isaiah <da...@gmail.com> on 2026/02/19 10:22:56 UTC

Cucumber Testing Framework

Hi all,

Wanted to start a conversation thread regarding cucumber testing and the
plans going forward

Been looking through previous issues and modules, trying to understand if
there’s currently work being done regarding the phasing/conversion of the
integration tests

Otherwise, what needs to be done to get things rolling

P.S I think Adam is heading this FSIP

Re: Cucumber Testing Framework

Posted by Dara Isaiah <da...@gmail.com>.
Saw you post on cucumber, might be a good place to start

There aren’t jira tickets for this

We have to currently review the state of the integration test and advise on
how to go back introducing more

On Thu, Feb 19, 2026 at 12:48 PM Dara Isaiah <da...@gmail.com>
wrote:

> This helps a lot with getting started, thanks!
>
> Will report back soon with a review
>
> On Thu, Feb 19, 2026 at 11:02 AM Ádám Sághy <ad...@gmail.com> wrote:
>
>> Hi
>>
>> During the last Community Call, the E2E test framework was a topic. I
>> wanted to share some basic information about it to start a conversation and
>> ask your help to review our available documentations, maybe extend it.
>>
>> Also it would be nice if we can cover more functionalities with E2E
>> tests, maybe even replace some of the existing integration tests with
>> these, because easier to work with, easier to read and maintain and
>> hopefully, we can cover more!
>>
>> *How to run:*
>> *Official documentation: *
>> https://fineract.apache.org/docs/1.14.0/#_testing or in the Fineract
>> codebase fineract-doc/src/docs/en/chapters/testing/cucumber.adoc
>> *(unofficial article more technical):*
>> https://fineract-academy.com/how-to-run-fineract-e2e-test-with-intellij-idea/
>>
>> *Where are they?*
>> fineract-e2e-tests-core -> Contains the core data and the test steps
>> (test step implementation) and the framework for the E2E tests. Contains
>> the initialization interfaces
>> fineract-e2e-tests-runner -> Contains the initialization implementation
>> + the test features files (these describe the test steps)
>>
>> *Where to create a new test step?*
>> In the fineract-e2e-tests-core , you can add extra test steps which can
>> be used in the tests. Example:
>> org.apache.fineract.test.stepdef.loan.LoanRepaymentStepDef#makeLoanRepayment ->
>> This can be used to initiate a repayment
>>
>> *Where to use the new test step?*
>> In the fineract-e2e-tests-runner can be found the test cases and there
>> you can define which steps to be executed with what data. Exameple:
>> features/LoanReAgingAccruals.feature:31 -> Do a repayment on 1 Feb 2024
>> with  amount of 17.01
>>
>> *What is covered?*
>> So far mostly Loan related functionalities are covered.
>>
>> *Documentation*
>> fineract-doc/src/docs/en/chapters/testing/cucumber.adoc -> It might need
>> to be extended with more information and use cases to help other to start
>> using it!
>>
>> You can help to review and advise!
>>
>> Regards,
>> Adam
>>
>> On Feb 19, 2026, at 11:22 AM, Dara Isaiah <da...@gmail.com>
>> wrote:
>>
>> Hi all,
>>
>> Wanted to start a conversation thread regarding cucumber testing and the
>> plans going forward
>>
>> Been looking through previous issues and modules, trying to understand if
>> there’s currently work being done regarding the phasing/conversion of the
>> integration tests
>>
>> Otherwise, what needs to be done to get things rolling
>>
>> P.S I think Adam is heading this FSIP
>>
>>
>>

Re: Cucumber Testing Framework

Posted by Dara Isaiah <da...@gmail.com>.
This helps a lot with getting started, thanks!

Will report back soon with a review

On Thu, Feb 19, 2026 at 11:02 AM Ádám Sághy <ad...@gmail.com> wrote:

> Hi
>
> During the last Community Call, the E2E test framework was a topic. I
> wanted to share some basic information about it to start a conversation and
> ask your help to review our available documentations, maybe extend it.
>
> Also it would be nice if we can cover more functionalities with E2E tests,
> maybe even replace some of the existing integration tests with these,
> because easier to work with, easier to read and maintain and hopefully, we
> can cover more!
>
> *How to run:*
> *Official documentation: *
> https://fineract.apache.org/docs/1.14.0/#_testing or in the Fineract
> codebase fineract-doc/src/docs/en/chapters/testing/cucumber.adoc
> *(unofficial article more technical):*
> https://fineract-academy.com/how-to-run-fineract-e2e-test-with-intellij-idea/
>
> *Where are they?*
> fineract-e2e-tests-core -> Contains the core data and the test steps
> (test step implementation) and the framework for the E2E tests. Contains
> the initialization interfaces
> fineract-e2e-tests-runner -> Contains the initialization implementation
> + the test features files (these describe the test steps)
>
> *Where to create a new test step?*
> In the fineract-e2e-tests-core , you can add extra test steps which can
> be used in the tests. Example:
> org.apache.fineract.test.stepdef.loan.LoanRepaymentStepDef#makeLoanRepayment ->
> This can be used to initiate a repayment
>
> *Where to use the new test step?*
> In the fineract-e2e-tests-runner can be found the test cases and there
> you can define which steps to be executed with what data. Exameple:
> features/LoanReAgingAccruals.feature:31 -> Do a repayment on 1 Feb 2024
> with  amount of 17.01
>
> *What is covered?*
> So far mostly Loan related functionalities are covered.
>
> *Documentation*
> fineract-doc/src/docs/en/chapters/testing/cucumber.adoc -> It might need
> to be extended with more information and use cases to help other to start
> using it!
>
> You can help to review and advise!
>
> Regards,
> Adam
>
> On Feb 19, 2026, at 11:22 AM, Dara Isaiah <da...@gmail.com> wrote:
>
> Hi all,
>
> Wanted to start a conversation thread regarding cucumber testing and the
> plans going forward
>
> Been looking through previous issues and modules, trying to understand if
> there’s currently work being done regarding the phasing/conversion of the
> integration tests
>
> Otherwise, what needs to be done to get things rolling
>
> P.S I think Adam is heading this FSIP
>
>
>

Re: Cucumber Testing Framework

Posted by Dara Isaiah <da...@gmail.com>.
Hi Adam,

Just a brief update, so far I've:

   - Ran the test suite (3/2177 Failures related to place lock)
   - Fixed 2 failing tests related to actual values
   - Updated documentation on tests

I've also looked into the entire cucumber test suite steps and features,
still working on a comprehensive review

Lastly, I tagged you on some PRs raised, happy to get a review

Best,
Dara


On Thu, Feb 19, 2026 at 11:02 AM Ádám Sághy <ad...@gmail.com> wrote:

> Hi
>
> During the last Community Call, the E2E test framework was a topic. I
> wanted to share some basic information about it to start a conversation and
> ask your help to review our available documentations, maybe extend it.
>
> Also it would be nice if we can cover more functionalities with E2E tests,
> maybe even replace some of the existing integration tests with these,
> because easier to work with, easier to read and maintain and hopefully, we
> can cover more!
>
> *How to run:*
> *Official documentation: *
> https://fineract.apache.org/docs/1.14.0/#_testing or in the Fineract
> codebase fineract-doc/src/docs/en/chapters/testing/cucumber.adoc
> *(unofficial article more technical):*
> https://fineract-academy.com/how-to-run-fineract-e2e-test-with-intellij-idea/
>
> *Where are they?*
> fineract-e2e-tests-core -> Contains the core data and the test steps
> (test step implementation) and the framework for the E2E tests. Contains
> the initialization interfaces
> fineract-e2e-tests-runner -> Contains the initialization implementation
> + the test features files (these describe the test steps)
>
> *Where to create a new test step?*
> In the fineract-e2e-tests-core , you can add extra test steps which can
> be used in the tests. Example:
> org.apache.fineract.test.stepdef.loan.LoanRepaymentStepDef#makeLoanRepayment ->
> This can be used to initiate a repayment
>
> *Where to use the new test step?*
> In the fineract-e2e-tests-runner can be found the test cases and there
> you can define which steps to be executed with what data. Exameple:
> features/LoanReAgingAccruals.feature:31 -> Do a repayment on 1 Feb 2024
> with  amount of 17.01
>
> *What is covered?*
> So far mostly Loan related functionalities are covered.
>
> *Documentation*
> fineract-doc/src/docs/en/chapters/testing/cucumber.adoc -> It might need
> to be extended with more information and use cases to help other to start
> using it!
>
> You can help to review and advise!
>
> Regards,
> Adam
>
> On Feb 19, 2026, at 11:22 AM, Dara Isaiah <da...@gmail.com> wrote:
>
> Hi all,
>
> Wanted to start a conversation thread regarding cucumber testing and the
> plans going forward
>
> Been looking through previous issues and modules, trying to understand if
> there’s currently work being done regarding the phasing/conversion of the
> integration tests
>
> Otherwise, what needs to be done to get things rolling
>
> P.S I think Adam is heading this FSIP
>
>
>

Re: Cucumber Testing Framework

Posted by Ádám Sághy <ad...@gmail.com>.
Hi

During the last Community Call, the E2E test framework was a topic. I wanted to share some basic information about it to start a conversation and ask your help to review our available documentations, maybe extend it.

Also it would be nice if we can cover more functionalities with E2E tests, maybe even replace some of the existing integration tests with these, because easier to work with, easier to read and maintain and hopefully, we can cover more! 

How to run:
Official documentation: https://fineract.apache.org/docs/1.14.0/#_testing or in the Fineract codebase fineract-doc/src/docs/en/chapters/testing/cucumber.adoc
(unofficial article more technical): https://fineract-academy.com/how-to-run-fineract-e2e-test-with-intellij-idea/

Where are they?
fineract-e2e-tests-core -> Contains the core data and the test steps (test step implementation) and the framework for the E2E tests. Contains the initialization interfaces
fineract-e2e-tests-runner -> Contains the initialization implementation  + the test features files (these describe the test steps)

Where to create a new test step?
In the fineract-e2e-tests-core , you can add extra test steps which can be used in the tests. Example: org.apache.fineract.test.stepdef.loan.LoanRepaymentStepDef#makeLoanRepayment -> This can be used to initiate a repayment

Where to use the new test step?
In the fineract-e2e-tests-runner can be found the test cases and there you can define which steps to be executed with what data. Exameple: features/LoanReAgingAccruals.feature:31 -> Do a repayment on 1 Feb 2024 with  amount of 17.01

What is covered?
So far mostly Loan related functionalities are covered.

Documentation
fineract-doc/src/docs/en/chapters/testing/cucumber.adoc -> It might need to be extended with more information and use cases to help other to start using it! 

You can help to review and advise! 

Regards,
Adam

> On Feb 19, 2026, at 11:22 AM, Dara Isaiah <da...@gmail.com> wrote:
> 
> Hi all, 
> 
> Wanted to start a conversation thread regarding cucumber testing and the plans going forward 
> 
> Been looking through previous issues and modules, trying to understand if there’s currently work being done regarding the phasing/conversion of the integration tests 
> 
> Otherwise, what needs to be done to get things rolling 
> 
> P.S I think Adam is heading this FSIP
>