Attendees-analyzer (atta) is a command line tool for you to generate a basic report of attendees, e.g. a pie chart of fields according to job titles. Currently it only supports a csv file as raw data input.

Fetch the source

git clone https://github.com/tai271828/attendees-analyzer.git

Create a working folder to place your attendee raw data outside of the source folder so you won't commit your raw data accidentally.

mkdir attendees-analyzer-working

• Create the working virtual environment with virtualenv

  virtualenv -p python3 ./attendees-analyzer/venv

  Activate your virtual environment by

  source ./attendees-analyzer/venv/bin/activate

• Or create and activate with conda
  conda create -n {your_env_name} python=3.6 anaconda
source activate {your_env_name}

• Go the source folder

  pip install -r requirements.txt

• Or install with conda

  conda install --yes --file requirements.txt

If you want to develop it, please run:

python setup.py develop

If you just want to install it in your virtual environment lib, please run:

python setup.py install

Now you should be ready to go.

Go to the test folder and execute the unit tests.

python -m unittest discover -s ./ -p 'test_*.py

Or you could just run one of them by

cd test
./test_title.py

If you get something like this, it means everything should work as expected.

.
----------------------------------------------------------------------
Ran 1 test in 0.014s

OK

After launching your virtual environment, issue the following command:

atta --csv ./a.csv --csv ./b.csv --csv ./c.csv
--yaml ./atta/data/generic.yaml
--package-yaml ./examples/packages.yaml
--sponsor-yaml ./examples/sponsors.yaml

Follow the prompt instruction and you will get jpg images. So far it is well tested with the data of year 2017.