Entry point to print test logs from JSON output.

[jeffherman]

Test results produced by OpenHTF are in JSON format. This entry point facilitates perusing through complex logs by parsing the JSON and color-highlighting each line based on its logging level. To run:

$ openhtf-testcat your_test_output.json

---

This change is 

[fahhem]

I think this should be in contrib/ or bin/, not util/

[jeffherman]

setuptools.find_packages (used in setup.py) will only search for directories with __init__.py. Adding either contrib/ or bin/ to openhtf's package list will result in either contrib or bin being a top-level importable module. While it's unlikely that anyone would ever publish a bin or contrib pypi module, it's not clear that we should be co-opting this part of the namespace for openhtf-specific purposes.

[jettisonjoe]

I agree with @jeffherman. Unless you want to force people to go to our GitHub page and download utilities separately, stuff like this should go somewhere inside the actual package.

However I am an advocate of using runnable modules (invoke with python -m) instead of declaring entry points for setuptools to wire up executable scripts. In my anecdotal experience, the entry points mechanism is more brittle and doesn't always work with all environments. Whereas if you've gotten as far as successfully making the packager itself importable, it's more unlikely runnable modules within will fail.

[jettisonjoe]

@Kenadia, I remember having talked about this at one of the maintainers' meetings. Do you remember what our consensus was? I feel like we agreed on the runnable module approach but I can't remember where we decided to put them. Were we going to add a tools/ or bin/ to util/ or somewhere else in the package?

[Kenadia]

@jeffherman, I talked with @jettisonjoe, and if you'd like to update this PR, we'd like to put this script in a openhtf/util/bin/ directory. Users can then run the script with python -m openhtf.util.bin.testcat (as opposed to the setuptools method)

(As an aside, I wonder if the name print_logs.py would be more accurate than testcat.py.)