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)
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
- Fork this repository to your GitHub
- Clone the repository from your GitHub
git clone https://github.com/[YOUR GITHUB ACCOUNT]/pycontw-postevent-report-generator.git
- 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 throughgit pull upstream master
afterward. - Check out a branch for your new feature
git checkout -b [YOUR FEATURE]
- Work on your new feature
- Run
inv test.cov
to check the test coverage and see where you can add test cases - Run
inv test
and make sure all tests pass. - Run
inv style
and make sure your coding style passes the linter checks - [Optional] Run
inv style.pylint
to check your coding style throughpylint
. Note that you do not have to fix all the issues warned bypylint
. - Run
inv style.reformat
to format your code throughblack
. - Run
inv secure
to ensure the packages installed are secure - [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 bybandit
- Run
inv build.test-cli
to ensure that the command is runable - Create a Pull Request
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pycontw-report-generator-1.0.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5cf0e88eac31d95c8f35cfb1175c2ae05ba14d5fd1f1681db1162624dff60663 |
|
MD5 | c47b202016b055bce039565628fade47 |
|
BLAKE2b-256 | 586e0bdbe04be5f1eb01e3e87bc2785ca540e300c93a98115a8e8681e1a9e0f0 |
Hashes for pycontw_report_generator-1.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 184101fa2b9c0cc705eb2160cb1effcf50b1f57985adf97e6194bc3be8156fb3 |
|
MD5 | 576612769547a49fe4b8f7962c068455 |
|
BLAKE2b-256 | 8d42c4e0477b137d6cdb8cf07783fe17453497126c820f0a7768ff59834e6ddf |