Created: 2011-07-18 09:57
Updated: 2014-05-04 04:33
License: apache-2.0

Con Harvester

This app harvests information about comic creators attending a convention and produces a Markdown report.

This report can be used to quickly find comic creators that you are interested in. For instance, you may be interested in finding any artist that has been involved in the creation of X-Men comics so that you can get an X-Men sketch on your blank cover comic or grep the report to see what comic books you should bring to the convention to get signed.

The artists attending Comic-Con 2013 have already been harvested in a report. You can view that report under examples\comic-con-2013



To run Con Harvester you will need Ruby installed. Con Harvester has been tested with Ruby 1.9.3p362 which is the latest version as of this writing.

Comic Vine API Key

Con Harvester is built on top of the Comic Vine API. As such, you will need your own API key. If you don't have an API key, register for free as a developer at

Once you have your API key, edit the API-KEY file replacing the current contents with your own API key.

List of Comic Creators

The list of comic creators harvested must be provided as a plain text file named person.txt. This file should have a single comic creator per line.

See examples\comic-con-2013\people.txt as an example.


To run Con Harvester, simply open a terminal session in the root directory and execute the following command:

$ ./harvester --dir comic-con-2013 --title "Comic-Con 2013"

Where comic-con-2013 is an existing directory containing a file name people.txt containing the names of the comic creators, one per line. This directory will also be used to write a Markdown report named

You can also view the usage help via:

$ ./harvester --help


Here are things I'd like to improve:

  • Harvest the data into a semantic format and then generate the report from it, allowing custom reports to be easily created/run without having to re-harvest the data


Copyright 2013 Kevin Shekleton

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more