Skip to main content

PyCon TW post-event report generator.A cli command to generate PyCon TW post-event reports.

Project description

PyCon TW post-event report generator (rg-cli)

Build Status

PyCon TW post-event report generator.A cli command, rg-cli, to generate PyCon TW post-event reports. Previously known as attendee-analyzer.

rg-cli 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.

Prerequsite

  • Python 3.7
  • pipenv
    • for dependency management
    • pip install pipenv
  • invoke
    • for task management
    • pip install invoke

Installation

Fetch The Source

Fetch the source

git clone https://github.com/pycontw/pycontw-postevent-report-generator.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 pycontw-postevent-report-generator-working

Create Your Own Python Virtual Environment and Install package

inv env.init-dev

Install Attendees Analyzer

If you want to develop it, please run:

inv build.develop

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

inv build.install

Now you should be ready to go.

Test The Installation

inv build.test-cli

Run Test Cases

inv test

Example

After launching your virtual environment, issue the following command:

rg-cli --csv ./a.csv --csv ./b.csv --csv ./c.csv --yaml ./report_generator/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.

How to contribute

  1. Fork this repository to your GitHub
  2. Clone the repository from your GitHub
    git clone https://github.com/[YOUR GITHUB ACCOUNT]/pycontw-postevent-report-generator.git
    
  3. Add this repository to the remote in your local repository
    git remote add upstream "https://github.com/pycontw/pycontw-postevent-report-generator"
    
    You can pull the latest code in master branch through git pull upstream master afterward.
  4. Check out a branch for your new feature
    git checkout -b [YOUR FEATURE]
    
  5. Work on your new feature
  6. Run inv test.cov to check the test coverage and see where you can add test cases
  7. Run inv test and make sure all tests pass.
  8. Run inv style and make sure your coding style passes the linter checks
  9. [Optional] Run inv style.pylint to check your coding style through pylint. Note that you do not have to fix all the issues warned by pylint.
  10. Run inv style.reformat to format your code through black.
  11. Run inv secure to ensure the packages installed are secure
  12. [Optional] Run inv secure.bandit to check whether there is common security issue in the code. Note that you do not have to fix all the issues warned by bandit
  13. Run inv build.test-cli to ensure that the command is runable
  14. Create a Pull Request

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pycontw-report-generator, version 1.0.2
Filename, size File type Python version Upload date Hashes
Filename, size pycontw-report-generator-1.0.2.tar.gz (158.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page