Rejigger entrypoints in stv_tool.py
Rejigger entrypoints in stv_tool.py

The old (unpublished?) API used load_votes() and read_nominees().
Create read_votefile() as a basic function to read the votes out of a
raw_board_votes.txt file. Similarly, read_labelmap() as a simple
function to read a lable:name mapping from board_nominations.ini files.

Concept: these two core functions return the needed data for running
an STV vote. Clarify these, and deprecate the older functions which
layer upon and alter the core data.

NOTE: it is unclear who may consume this module, so backwards-compat
is being retained for now.

apache/steve,apache/steve,apache/steve,apache/steve,apache/steve,apache/steve