feat: export

[Pertempto]

Implemented the export command according to spec 6

Testing

First run just build-docker

Note

The output of the export command on stdout might look funny (misaligned). That is because tabs are often interpreted as just taking the text to the next "tab stop" (usually the next multiple of 8). The key thing is that the fields are correctly separated by tabs. You can pipe the output of the export command to od -c to see raw characters, or pipe to cat -A which will show tabs as ^I.

Daily Projects

• just run-docker export outputs all the days with their projects, durations, and descriptions

Raw

• just run-docker export -f raw outputs all the entries with their project, task, start, end, and duration

Output to File

To test the -o option, you will have to install/build the actual app, running it inside the docker container will just write a file inside the docker container

[github-actions]

Changes Requested

Please make the following small changes before I can approve:

• Replace fmt.Println(exportData) in cmd/export_cmd.go with fmt.Fprint(os.Stdout, exportData) (or os.Stdout.WriteString) so the command does not add an extra trailing newline to the TSV output.
• Remove the redundant if entry.End == nil { continue } in utils/aggregation.go (the earlier entry.IsRunning() check already covers this), or add a brief comment explaining the defensive duplication.
• Clarify timezone intent for ProjectDateEntry.Date in utils/aggregation.go: either parse with the entry's location (e.g. time.ParseInLocation("2006-01-02", dateStr, entry.Start.Location())) or expand the comment to state why normalizing to UTC midnight is desired and how it affects local-date consumers.

Summary of Changes

• Added new export command (cmd/export_cmd.go) with --format and --output flags.
• Implemented ExportDailyProjects and ExportRaw in utils/export.go, returning errors on write/flush failures.
• Added comprehensive TSV tests in utils/export_test.go covering special characters, filtering, and rounding.
• Updated AggregateByProjectDate in utils/aggregation.go to skip running/blank entries and normalize date parsing.
• Marked the export spec specs/006-export.md as completed.

Overall Feedback

• Issues / Concerns (please address):

  • The CLI currently prints TSV to stdout with fmt.Println, which appends an extra newline. That can break exact-match tests or downstream parsers — switch to fmt.Fprint.
  • AggregateByProjectDate contains a redundant nil-check after IsRunning(); simplify or document the defensive pattern to avoid confusion.
  • Timezone handling for aggregated dates is potentially surprising: parsing the date string using time.Parse yields a UTC midnight time. Please confirm intended semantics and either preserve the entry's timezone when parsing or document the UTC normalization.

• Positive: The change set is well-tested and thorough. Error handling for CSV writes/flushes has been implemented and the export tests cover edge cases (tabs, newlines, quotes, rounding). The CLI flag handling and file-permission choice (0600) are thoughtful for privacy. Nice work — tests and structure make this easy to review. 🎉

@Pertempto — once you address the three small items above I will re-review quickly. Thanks!

[Pertempto]

Pushed some commits to address feedback from code review bot.

[Pertempto]

@bambam955 no need to do in-depth code review for this one. mostly just looking for a sanity check with the testing

[bambam955]

I still don't understand how the Docker part works:

bennett-moore@desktop:~/projects/open-source/time-tracker (feat/export)$ just build-docker
docker compose build
[+] Building 0.1s (5/5) FINISHED                                                                                                                                                                                                              
 => [internal] load local bake definitions                                                                                                                                                                                               0.0s
 => => reading from stdin 1.06kB                                                                                                                                                                                                         0.0s
 => [test internal] load build definition from Dockerfile.test                                                                                                                                                                           0.0s
 => => transferring dockerfile: 2B                                                                                                                                                                                                       0.0s
 => [time-tracker internal] load build definition from Dockerfile                                                                                                                                                                        0.0s
 => => transferring dockerfile: 429B                                                                                                                                                                                                     0.0s
 => CANCELED [time-tracker internal] load metadata for docker.io/library/alpine:latest                                                                                                                                                   0.0s
 => CANCELED [time-tracker internal] load metadata for docker.io/library/golang:1.24                                                                                                                                                     0.0s
[+] build 0/2
 ⠙ Image time-tracker      Building                                                                                                                                                                                                      0.2s 
 ⠙ Image time-tracker-test Building                                                                                                                                                                                                      0.2s 
target test: failed to solve: failed to read dockerfile: open Dockerfile.test: no such file or directory

error: Recipe `build-docker` failed on line 25 with exit code 1

But until this is resolved I can't actually test anything with the steps given.

[Pertempto]

Ah, no I think there is something broke with that recipe. It got fixed in another branch. I'll bring that fix over here. 👍🏽

[Pertempto]

Actually it was a problem in docker-compose.yml referencing non-existent Dockerfile.test

[Pertempto]

@bambam955 It should work now

[bambam955]

@Pertempto code looks fine and it tests well. At first I was wishing there was something like time-tracker export -f pretty or something, but that's what the stats subcommand is for.

Merge whenever 👍

[Pertempto]

At first I was wishing there was something like time-tracker export -f pretty or something, but that's what the stats subcommand is for.

Correct. This command is purely for data export. We have the stats command and stats view in the TUI (press tab) to display stats. We should consider making the stats command have output that matches the stats view in the TUI.