I volunteered in the Matrix [#pimalaya.comodoro][1] room to try out the
most recent version comodoro. This is my report of that trial.
The Windows artifact is [comodoro-windows.tar.gz][2], version
[0.6.0][3].
The artifact itself is a tarball. While I *can* extract this via `7z` or
[MSys2][4], these are third party tools. Distribution of tools using
`tar.gz` is therefore frowned upon. If there's a way to use `.zip`, I
would encourage that. They can be extracted with no additional tooling.
Upon extraction, the tool worked fine. There are obvious subcommands
that are less useful, such as `man` and `completion`. That said, I was
able to get the man command to work in the [MSys2][4] environment using
the command `comodoro man /usr/share/man/man1`. I was not able to get
completions working, but I do know this is possible.
I was able to put the following configuration file in the location
`C:\Users\<username>\AppData\Roaming\comodoro\config.toml` and have it
work:
```
toml work-duration = 1500 short-break-duration = 300
long-break-duration = 900
timer-started-hook = "msg.exe %USERNAME% Pomodoro Started"
timer-stopped-hook = "msg.exe %USERNAME% Pomodoro Stopped"
work-began-hook = "msg.exe %USERNAME% Work Began"
# This hook fires every second. Use to update a system tray, but I don't
# know How to do that yet.
#work-running-hook = "" work-paused-hook = "msg %USERNAME% Work Paused"
work-resumed-hook = "msg %USERNAME% Work Resumed"
work-ended-hook = "msg %USERNAME% Work Ended"
[tcp]
host = "localhost"
port = 9999
```
I propose it be put in the `examples/` folder.
Finally, it is understandable that documentation doesn't exist yet, but
will obviously become important later :)
The `msg.exe` command above works a lot like the `zenity` command on
linux: it displays a pop-up dialog box.
[1]: https://matrix.to/#/#pimalaya.comodoro:matrix.org
[2]: https://github.com/soywod/comodoro/releases/tag/v0.0.6
[3]:
https://github.com/soywod/comodoro/releases/download/v0.0.6/comodoro-windows.tar.gz
[4]: https://www.msys2.org/
> The artifact itself is a tarball. While I *can* extract this via `7z`
> or [MSys2][4], these are third party tools. Distribution of tools
> using `tar.gz` is therefore frowned upon. If there's a way to use
> `.zip`, I would encourage that. They can be extracted with no
> additional tooling.
Good point, I will change that!
> I propose it be put in the `examples/` folder.
There is already a config in the `examples/` folder, it just needs to be
completed a bit more:
<https://github.com/soywod/comodoro/blob/master/examples/config.toml>
> Finally, it is understandable that documentation doesn't exist yet, but
> will obviously become important later :)
I am working on it, I let you know when it is ready :)
Thanks a lot for this review, very useful!!