Skip to content

Latest commit

 

History

History
100 lines (60 loc) · 3.12 KB

README.md

File metadata and controls

100 lines (60 loc) · 3.12 KB
Raw

JIRA Quick Reporter

License: MIT

JIRA Quick Reporter (JQR, pronounced "zheeker") is a free desktop application that helps automate your time management and reporting.

With JQR you can simply manage your issues, workflow, spent time, etc.  

 

How to build an executable application:

  • Create and activate a virtual environment with python3.6 or later.

  • Next you need to install all the necessary libraries and dependencies: pip install -r requirements.txt

  • Then you should run build_app.py: python3 build_app.py

You can find executable version of JQR in dist/JQR/JQR  

How to work with filters:

On the main window you can see menu with a list of filters. By default you have a 'my open issues' filter and 'Search issues' menu item.

main window

Creating new filter

  1. You need to click '+' button in menu or 'Search issues' menu item.

  2. Then, in the text input you can write a query.

  3. You can click the 'Search' button and see results of the query.

  4. To save filter, you need to click the 'Save as' button above the text input.

Editing a filter

  1. You need to click 'filter_name' menu item.

Default query is 'assignee = currentUser() and resolution = unresolved'

  1. Next you need to follow steps 2-3 from previous paragraph

  2. To save edited filter, you need to click the 'Save' button above the text input. If you haven't edited a filter, the 'Save' button will be disabled.

How to delete a filter

  1. First, you need to select the filter you want to delete.

  2. Then you need to click button in the right corner of the window.

You cannot delete default filter 'my open issues' and the 'Search issues' menu item.

Syntax help

Queries should be written in JQL.

Syntax help - https://confluence.atlassian.com/display/JIRASOFTWARECLOUD/Advanced+searching  

How to work with 'Pomodoro' timer

You can read about 'Pomodoro' technique here.

Basic rules

  • To start working with 'Pomodoro' timer you need to click 'Pomodoro' button against a task.

  • You can work with timer in tray menu.

  • You cannot start a new timer while the current one is running, first you need to click 'Quit timer' in the tray menu.

Task and breaks duration

By default the duration of one task is 25 minutes, a short break is 5 minutes and a long break is 15 minutes. But you can adjust the duration. To do this select the 'Settings' item in the tray menu.

Time logging

You can log work directly from the timer window. In this case time from the timer is set in the 'Time spent' field in time logging window.

Contacts

Max Jekov: mjekov@spherical.pm

Maria Filonova: mfilonova@spherical.pm

Dayana Shcheglova: dshcheglova@spherical.pm