two-horse-race/README

TWO-HORSE RACE
==============

Generates a human-readable plain text stream of election results from JSON input.


Usage
-----

Assuming `twohorserace` is in your $PATH and executable:

Read JSON from a file:

	$ twohorserace results.json

Read JSON from STDIN:

	$ cat results.json | twohorserace --


Installation
------------

Tested and working with Ruby 3.1.2, which is currently the latest stable
release.

Tested and working with Ruby 2.6.10, which is currently the oldest
version supported by the Ruby project.

Will probably work with earlier versions.

There are no other dependencies.

No gems outside the standard library or databases are used. No
environment variables.

There isn't a Gemfile. You don't need Bundler.


Example files
-------------

elections.json is an example input file.
elections.txt is an example output file.

These files are for demonstration purposes only. Do not rely on them as
accurate representations of actual election results.


Roadmap
-------

Write a man page.


Repository
----------

https://git.adrianshort.org/adrian/twohorserace


Maintainer
----------

Adrian Short <adrian@adrianshort.org>