Skip to content

update list of client libraries #487

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Oct 15, 2025
Merged

update list of client libraries #487

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
92fad39
update list of client libraries
felixlohmeier Sep 23, 2025
f49b58d
Merge branch 'OpenRefine:master' into master
felixlohmeier Sep 25, 2025
54e0d33
make relative links by removing http://openrefine.org in docs and pages
felixlohmeier Sep 25, 2025
9bd7f9f
fix broken links
felixlohmeier Sep 25, 2025
946651b
fix another broken links
felixlohmeier Sep 25, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 1 addition & 25 deletions docs/technical-reference/openrefine-api.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -283,29 +283,5 @@ The result array will hold up to ten results, depending on how many rows there a
```

## Third-party software libraries {#third-party-software-libraries}
Libraries using the [OpenRefine API](openrefine-api):

### Python {#python}
* [refine-client-py](https://github.com/PaulMakepeace/refine-client-py/)
* [openrefine-client](https://github.com/opencultureconsulting/openrefine-client), a fork of the above with an extended CLI
* [refine-python](https://github.com/maxogden/refine-python)

### Ruby {#ruby}
* [refine-ruby](https://github.com/distillytics/refine-ruby)
* The above is a maintained fork of [refine-ruby](https://github.com/maxogden/refine-ruby)
* [google_refine](https://github.com/chengguangnan/google_refine)

### NodeJS {#nodejs}
* [node-openrefine](https://github.com/pm5/node-openrefine)

### R {#r}
* [rrefine](https://cran.r-project.org/web/packages/rrefine/index.html)

### PHP {#php}
* [openrefine-php-client](https://github.com/keboola/openrefine-php-client)

### Java {#java}
* [refine-java](https://github.com/ancore/refine-java)

### Bash {#bash}
* [bash-refine.sh](https://gist.github.com/felixlohmeier/d76bd27fbc4b8ab6d683822cdf61f81d) (templates for shell scripts)
Libraries using the OpenRefine API are listed on the [Extensions](https://openrefine.org/extensions#client-libraries) website.
Copy link
Member

Choose a reason for hiding this comment

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

Would you mind changing this (and the link back to this page on the extensions page) to remove https://openrefine.org/? That way, the links will be generated relative to the existing domain so deployments like the Netlify preview will direct this to the Netlify preview version of the extensions page.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yes, I'll take care of it. Give me some time to change the other absolute links in the docs and test the Netlify preview.

28 changes: 14 additions & 14 deletions src/pages/extensions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,24 +58,24 @@ OpenRefine can connect to several reconciliation services. You can find informat

## Client libraries

You can automate some OpenRefine operations using one of the existing libraries. Those libraries are using the [OpenRefine API](https://github.com/OpenRefine/OpenRefine/wiki/OpenRefine-API).
You can automate some OpenRefine operations using one of the existing libraries. Those libraries are using the [OpenRefine API](https://openrefine.org/docs/technical-reference/openrefine-api).

| Language | Name | Latest compatible OpenRefine version |
|----------|------|--------------------------------------|
| python | [openrefine-client](https://github.com/felixlohmeier/openrefine-client) | 3.7 |
| R | [rrefine](https://cran.r-project.org/web/packages/rrefine/index.html) | 3.7 |
| java | [refine-java](https://github.com/dtap-gmbh/refine-java) | 3.7 |
| bash | [orcli](https://github.com/opencultureconsulting/orcli) | 3.7 |
| C# / .NET | [OpenRefine.Net](https://github.com/ADelRosarioH/OpenRefine.Net) | 3.7 |
| Language | Name |
|-----------|------|
| bash | [orcli](https://github.com/opencultureconsulting/orcli) |
| C# / .NET | [OpenRefine.Net](https://github.com/ADelRosarioH/OpenRefine.Net) |
| java | [refine-java](https://github.com/ancore/refine-java) |
| python | [openrefine-client](https://github.com/opencultureconsulting/openrefine-client) |
| R | [rrefine](https://cran.r-project.org/web/packages/rrefine/index.html) |

### Legacy client libraries

OpenRefine 3.3 [introduced CSRF tokens](https://github.com/OpenRefine/OpenRefine/wiki/Changes-for-3.3#csrf-protection-changes). The following client libraries have not yet adapted their API calls.

| Language | Name | Latest compatible OpenRefine version |
|----------|------|--------------------------------------|
| python | [refine-client-py](https://github.com/PaulMakepeace/refine-client-py/) | ?
| python | [refine-python](https://github.com/maxogden/refine-python) | 3.2 |
| ruby | [refine-ruby](https://github.com/maxogden/refine-ruby) | 3.2 |
| Language | Name | Latest compatible OpenRefine version |
|------------|------|--------------------------------------|
| javascript | [node-openrefine](https://github.com/pm5/node-openrefine) | 3.2 |
| php | [openrefine-php-client](https://github.com/keboola/openrefine-php-client) | 3.2 |
| python | [refine-client-py](https://github.com/PaulMakepeace/refine-client-py/) | 3.2 |
| python | [refine-python](https://github.com/maxogden/refine-python) | 3.2 |
| ruby | [refine-ruby](https://github.com/distillytics/refine-ruby) (fork) | 3.2 |
| ruby | [refine-ruby](https://github.com/maxogden/refine-ruby) | 3.2 |