Openrefine-client

bugfixes:
* overriding export file format with --format fails when --output is set to a different file extension 14
* unicode issues in --list and --info when piping stdout 15

features:
* works now with OpenRefine 3.3+ by introducing CSRF tokens 7
* added functional tests for all command line options (`tests-cli.sh`)

known issues:
* create project from xls, xlsx and ods broken with OpenRefine >=2.8 4
* this release was still built with Python 2

bugfixes:
* templating with options --mode=record-based and --splitToFiles=true fails with exception "missing or bad template" 6
* --separator argument was broken in v0.3.8 11

features:
* one-file-executable for Windows is now backwards compatible to Windows 7 32-bit 10

known issues:
* works with OpenRefine 2.7, 2.8, 3.0, 3.1, 3.2 -> OpenRefine 3.3 is not supported yet 7
* create project from xls, xlsx and ods broken with OpenRefine >=2.8 4
* this release was still built with Python2. The code will soon be ported to Python3. 8

bugfixes:
* fixed bugs in 5 (unicode issues)
* list, info and export failed for projectnames containing unicode chars (all versions, also upstream)
* info failed if column name contains unicode chars (since 0.3.5)
* templating feature suffixById failed with UnicodeEncodeError
* fixed bugs in create/new_project
* newly introduced option projectTags was not working in 0.3.7
* txt defaulted to fixed-width (should be line-based)
* default recordPath for json was not working in 0.3.7
* default sheets option was broken (but xls, xlsx, ods is broken in OpenRefine >=2.8 anyway, see 4)

features:
* create: xml root element will now be discovered if recordPath is not set
* export: support for unicode chars in export to terminal/stdout. example:


./openrefine-client --export "evil-fruits"
🔣 code meaning
🍇 1F347 GRAPES
🍉 1F349 WATERMELON
🍒 1F352 CHERRIES
🍓 1F353 STRAWBERRY
🍍 1F34D PINEAPPLE

("evil" because there is an emoji as column name which even stresses OpenRefine itself)

documentation:
* tests: added sample files and ipython notebooks for comprehensive tests of create option and unicode support
* [test notebook for Linux bash](https://nbviewer.jupyter.org/github/opencultureconsulting/openrefine-client/blob/master/tests/cli_bash.ipynb)
* [test notebook for Python2](https://nbviewer.jupyter.org/github/opencultureconsulting/openrefine-client/blob/master/tests/cli_bash.ipynb)
* added code highlighting in docs

code:
* realigned code for new_project to upstream
* [workarounds](https://github.com/opencultureconsulting/openrefine-client/blob/c80bef3fb1a4908f73b26ae9f64b4f4180452993/refine.pyL25) for unicode support with pyinstaller

bugfixes:
* fixed bug 1 (option columnWidths broken) which was introduced in v0.3.2
* fixed bug 3 (commands create and export templating broken) which was introduced in v0.3.5

features:
* new command `--download` to download files from URL (e.g. to download example data)
* extended `--info` command to list all available metadata and columns of a project
* improved performance of `--export` command
* improved error handling and user feedback

distribution:
* added one-file-executable for macOS (also available for v0.3.4)
* distribution on PyPI with package name [openrefine-client](https://pypi.org/project/openrefine-client)
* improved [Dockerfile](docker/Dockerfile) to build from latest code and added version tags to [Docker Hub repository](https://hub.docker.com/r/felixlohmeier/openrefine-client/)
* removed support for legacy option `docker --link`

documentation:
* revised docs in [README.md](README.md) substantially
* detailed usage instructions with examples
* added chapter on Python library
* added chapter on Binder openrefineder
* integrated separate docker README.md and extended instructions

code:
* added script [tests.sh](tests.sh) for running unit tests with different OpenRefine and Java versions
* realigned code to upstream refine-client-py
* moved all functions from parser to cli module
* separated export and template function
* improved code style (PEP8)

improved templating option splitToFiles
* get filename extension from --output parameter
* fixed bug in templating export option -- splitToFiles

- added support for templating export
- fixed bug in connection parameters (prevented connection to external hosts)
- fixed bug in input parameter for txt format (fixed-width/line-based)
- relocated options for create_project (just code style)
- unicode workaround