All development is transferred to https://review.fuel-infra.org/#/admin/projects/tools/lp-reports
No further changes are accepted into this repository.
Convenient web-based frontend for Launchpad. Displays bug tables and charts for a Launchpad project.
First, install pip and virtualenv on your system. On Ubuntu it can be done by
running "sudo apt-get install python-pip python-virtualenv". You may also
consider using virtualenvwrapper script (http://virtualenvwrapper.readthedocs.org/en/latest/).
Also you will need to install mongodb.
Please, note, that launchpad-reporting connects to launchpad, which requires
oauth authorization. Setting this up usually requires a web browser, and some
users have experience trouble with console browsers such as lynx. Therefore,
you may also want to run the following commands on your local system where a
regular GUI browser is available, instead of on a remote server where only the
terminal is available to you.
Also launchpad-reporting stores creds in the `/etc/lp-reports/credentials.txt`
file, so you must ensure, that this path exists and launchpad-reporting have
enough permissions to create/read/modify `credentials.txt` file.
Then:
~$ virtualenv venv # creating virtualenv
~$ source venv/bin/activate
~$ git clone https://github.com/Mirantis/launchpad-reports-summary.git
~$ cd launchpad-reports-summary
~$ mkdir data # folder to store mongodb data (you can specify your own)
~$ mongod --dbpath ./data # this launches mongodb instance. It may take some
# time first
~$ pip install -r requirements.txt
~$ python syncdb.py
~$ python collect_assignees.py
~$ python main.py run --port=1111
After that, open http://localhost:1111 in your browser.
- Flask is used as a web frontend
- d3 & nvd3 are used for the charts
- Interation with Launchpad is done through launchpadlib
- The code is optimized to retrieve data from launchpad using the minimum amount of queries. Still, it can take up to 5-10 seconds for a query to complete (for a milestone with hundreds of bugs)
- The results retrieved from Launchpad are cached for 5 minutes. See decorator @ttl_cache
- Does not show private bugs, as it requires more complex authentication flow with Launchpad
