Jupyter server proxy wrapper for Open Refine
Project description
nb_serverproxy_openrefine
Jupyter server proxy for OpenRefine
Based on the original https://github.com/psychemedia/jupyterserverproxy-openrefine which has some docs, although the reponame/install instructions will need updating for this repo. I will pop the package on PyPi at some point.
Jupyter-server-proxy config for running OpenRefine.
Install as:
pip install nb-serverproxy-openrefine
To install directly from this repo:
pip install git+https://github.com/innovationOUtside/nb_serverproxy_openrefine.git
OpenRefine can now be started and launched from the notebook homepage New menu:
Or from the JupyterLab launcher:
The OpenRefine client can be found on the openrefine
path (the port number is allocated dynamically).
Calling the path directly (eg starting MyBinder with the path openrefine
, or adding ?urlpath=openrefine
to the Binder URL) will launch the Binder container directly into the OpenRefine GUI application.
The directory path into which the OpenRefine project files are saved is $HOME/openrefine
by default, although you can trump it via the $REFINE_DIR
global variable:
openrefine_path = os.getenv("REFINE_DIR") if "REFINE_DIR" in os.environ else str(Path.home() / 'openrefine')
The host openrefine will use is 127.0.0.1
by default. This can be overriden with the $REFINE_DOMAIN
global variable
Early original work on getting OpenRefine running in MyBinder was done by @betatim (betatim/openrefineder) and @yuvipanda helped me get my head round various bits of jupyterhub/jupyter-server-proxy/ which is key to proxying web services via Jupyter. @manics PR for handling predefined, rather than allocated, port mappings also made life much easier...
Python Client
A Python client is also available for working with OpenRefine:
opencultureconsulting/openrefine-client
looks to be the best supported but seems to rely on Python 2.7; there is a currently failing PR to add Python3 support.dbutlerdb /refine-client-py
works with Python3 but lagsopencultureconsulting /openrefine-client
Using the client requires Open Refine to be running. TO DO: should we hardwire the port? Else how do we know where to connect?
:
When the client works with Python3 I will add it as an optional dependency to this package.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for nb_serverproxy_openrefine-0.0.9.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3ca1ef01b7776dd25a37f88d6ddefa9b92167a4b6b8be0b11823cb92baac6f22 |
|
MD5 | c8dfcecdbee79bb628c1e1e710f19846 |
|
BLAKE2b-256 | a50c05ab4ac4f63e7e61cde530ce6495f5dd58356a2e229b6e9942ac023e0b7f |
Hashes for nb_serverproxy_openrefine-0.0.9-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 083c953c99c46d334248e6456e706802f368f2feaeb9912f1c6d37be2988c5fa |
|
MD5 | da7084b01ce5886e15ee4f904d638c12 |
|
BLAKE2b-256 | 44ae1cb4de04e238197b70c1660b1972a95bad6145593dfc0646a83e1b01ebac |