make prepare
. venv/bin/activate

or

sudo apt install pip3-venv
python3 -m venv env
. venv/bin/activate
pip install -r requirements.txt

combine.py [-h] [-s SUMMARY] [-t TIME] [-i ISSUES] [-f FILTER] [-o OUTPUT]

Issue numbers extracted from Description columns of summary files and compared with Issue column of issue list.

• -h, --help — show help message and exit
• -s SUMMARY, --summary SUMMARY — read summary report from file
• -t TIME, --time TIME — read time entries from file
• -i ISSUES, --issues ISSUES — read issues list from file
• -f FILTER, --filter FILTER — filter input file by column=value
• -o OUTPUT, --output OUTPUT — output to file

Any of SUMMARY or TIME is enough

Appropriate file format is choosing according to its extension.

• CSV — Comma Separated Values — file.csv

• HTML — Hypertext Markup Language — file.htm, file.html
• JSON — JavaScript Notation Object — file.json, file.js
• Microsoft Excel — file.xlsx

Read Track summary report, combine it with issue list issues.csv and put the result to merged.csv

./combine.py -s Toggl_Track_summary_report_2023-03-01_2024-02-29.csv \
  -i issues.csv -o merged.csv

Filter input file by project name

./combine.py -s Toggl_Track_summary_report_2023-03-01_2024-02-29.csv \
  -f Project=Something \
  -i issues.csv -o merged.csv