Skip to content

Add documentation on automated testing for extensions#480

Merged
SoryRawyer merged 5 commits intomasterfrom
extension-testing
Jan 21, 2026
Merged

Add documentation on automated testing for extensions#480
SoryRawyer merged 5 commits intomasterfrom
extension-testing

Conversation

@SoryRawyer
Copy link
Member

@SoryRawyer SoryRawyer commented Aug 27, 2025

This pull request adds a section at the end of "writing extensions" to add some references to unit and integration tests. It's a small section of notes I kept while exploring this part of the codebase.

@netlify
Copy link

netlify bot commented Aug 27, 2025

Deploy Preview for openrefine-website ready!

Name Link
🔨 Latest commit d1ca0cb
🔍 Latest deploy log https://app.netlify.com/projects/openrefine-website/deploys/6970e9fa2263d0000811998b
😎 Deploy Preview https://deploy-preview-480--openrefine-website.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@SoryRawyer SoryRawyer marked this pull request as ready for review September 15, 2025 21:45
Copy link
Member

@tfmorris tfmorris left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A couple of small suggestions, but approved with those made.

The improved docs are great, but I suspect we probably also need to add more scaffolding for testing to the sample extension to really nudge developers in the right direction.


Cypress can also be run in headless mode, enabling end-to-end tests in CI/CD pipelines. The documentation for this feature can be found [on the Cypress website](https://docs.cypress.io/app/continuous-integration/overview) and an example script for running end-to-end tests can be found in [the `refine` shell script](https://github.com/OpenRefine/OpenRefine/blob/master/refine#L364-L443).

#### Testing OpenRefine with your extension installed
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@SoryRawyer do you want to add here more details following your recent work?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it would make more sense to update the sample extension directly. I'll open a few issues on that repo to add more detail for testing.

@magdmartin
Copy link
Member

Everything looks good to me at a high level. I added a suggestion that can be addressed separately. I believe it is more beneficial to publish the documentation sooner and then refine it based on feedback from extension developers, rather than keeping it hidden in a pull request.

SoryRawyer and others added 2 commits January 21, 2026 09:59
Co-authored-by: Tom Morris <tfmorris@gmail.com>
Co-authored-by: Tom Morris <tfmorris@gmail.com>
@SoryRawyer SoryRawyer merged commit 1826dd8 into master Jan 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants