v0.3.10

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

v0.3.9

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

v0.3.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
  • test notebook for Python2
• added code highlighting in docs

code:

• realigned code for new_project to upstream
• workarounds for unicode support with pyinstaller

v0.3.7

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
• improved Dockerfile to build from latest code and added version tags to Docker Hub repository
• removed support for legacy option docker --link

documentation:

• revised docs in 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 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)

v0.3.4

improved templating option splitToFiles

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

v0.3.3

• 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

v0.3.2

• new command info prints metadata of a project
• new command delete to destroy projects
• projects may now be specified by name
• input format will now be derived from file extension
• refactored CLI
• tested with OpenRefine 2.7

v0.3.1

• included urllib2_file.py in the package to ease installation
• generated one-file-executable for linux 64-bit with pyinstaller

v0.3

extended the CLI with some options to create new OpenRefine projects from files

examples:

• ./refine.py --create example.csv # create new project from file example.csv
• ./refine.py --create example.tsv --format=tsv --encoding=UTF-8
• ./refine.py --create example.xml --format=xml --recordPath=collection --recordPath=record
• ./refine.py --create example.json --format=json --recordPath=_ --recordPath=_
• ./refine.py --create example.xlsx --format=xlsx --sheets=0
• ./refine.py --create example.ods --format=ods --sheets=0