Time tracker for Command Line
Project description
Breaking changes
Starting from v2.0.0, Letsdo has this configuration changes:
- the configuration file name changes from
$HOME/.letsdo
to$HOME/.letsdo.yaml
- the data file name changes from
<data_directory>/letsdo-data
to<data_directory>/letsdo-history
If you have old data and configuration, just change the names accordingly and all will work as before.
Letsdo, the CLI time-tracker
Letsdo helps you to be more focused and productive tracking the time you spend on your work activities.
Features
Have a look at the help message:
$ letsdo
Usage:
lets do <name>... [--time=<time>]
lets see [all|config] [--detailed|--day-by-day] [--ascii| --dot-list] [-p|--project] [<query>...]
lets edit
lets cancel
lets stop [<time>...]
lets goto <newtask>...
lets track <name>...
lets config
lets autocomplete
options:
-a, --ascii Print report table in ASCII characters
-t, --time=<time> Change the start/stop time of the task on the fly
examples:
lets see # show today's activities
lets see yesterday # show yesterday's activities
lets see 2018-07 # show 2018 July's activities
lets see last July # same as above (if we're still in 2019)
lets see +project # show activities with +project tag (+project is autocompleted with TAB)
lets see something # show activities whose description has he word 'something'
lets see this week
lets see last month
lets see 2019
...
First of all, we do not want to waste time typing too much. Letsdo is the name of the package and you can use it as well as command line interface, but all the interface is designed to be as informal as possible, so you are encouraged to use lets instead.
That said, when you do not know what to do, just write lets see, this command shows the current status of your task, whether you're doing something or not
$ lets see
When you're ready to start with something just type lets do followed by a short description.
$ lets do write a good readme
task 'write a good readme' started at 2020-10-04 11:38:00
Contexts, and Projects are supported in form of words starting with @, or + signs respectively.
$ lets do +myproject write a good readme
task '+myproject write a good readme' started at 2020-10-04 11:38:00
You can edit the current task's name or starting time, cancel it or stop it.
$ lets stop
stopped task '+myproject write a good readme @github' after 0 hours, 40 minutes
$ lets do foo
task 'foo' started at 2020-10-04 12:30:00
$ lets cancel
Cancelled task
{
"name": "foo",
"start": "2020-10-04 12:30:58.404926"
}
If you forgot to stop the task on time, you can adjust it giving an absolute or relative time:
$ lets stop 11:02
$ lets stop 10 minutes ago
Once stopped, the task is saved in your history, that by default is located under your HOME
directory in a file called 'letsdo-data'.
Don't you like the default location? let's have a look at the config sub-command:
$ lets config
config opens the configuration file (HOME/.letsdo.yaml) with two configurable fields
color: true
data_directory: /home/username/
Let's see now the history: you can rapidly have a look at today and yesterday work done by typing:
$ lets see today
$ lets see yesterday
If you want to see the work done in another date, just write the date:
$ lets see 2017-07-13
a partial date will do as well, just keep the same order: Year first, then Month and Day
$ lets see 17-07-13
you can even use only '07-13' if you have not yet tracked data in different years.
The same way, you can look at all the work done in a particular month:
e.g in July 2017
$ lets see 17-07
or all your tasks:
$ lets see all
or again, a specific project or all the tasks that share a pattern:
$ lets see +myproject
As you can see, tasks are reported along with an ID, so you can re-start the same task again using its ID:
$ lets do 10
or if you just want to start again the last task you stopped
$ lets do last
Do you switch often among tasks? Do not need to stop and start again, just goto using description or ID again:
$ lets goto new project
$ lets goto 3
Finally, you can configure autocompletion to let Letsdo suggest your flags, contexts and projects' names, type lets config autocomplete and follow the instructions.
Licence
Letsdo is release under the MIT license. See LICENSE file for more details.
Contributions
I am really happy to consider any PR that can make Letsdo better.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file letsdo-2.0.1.tar.gz
.
File metadata
- Download URL: letsdo-2.0.1.tar.gz
- Upload date:
- Size: 32.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 31a76b06960d36795f2f479763ae84d4c890579675ee25102091515d8df9900c |
|
MD5 | 2882d7afe73e56b6d83d14dfd3162c0f |
|
BLAKE2b-256 | 912a68f9c796e165d6e24de97d9e7b53ba09ce22a78505c23ec4bef14ffb3aa9 |
File details
Details for the file letsdo-2.0.1-py3-none-any.whl
.
File metadata
- Download URL: letsdo-2.0.1-py3-none-any.whl
- Upload date:
- Size: 30.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3d5e60d61c51019b560b68640fdc1af5657a22179c04dddbaf4d23dcc23bf1ec |
|
MD5 | 022136746f208199e1525860bcdddd5c |
|
BLAKE2b-256 | 22148c880a392654ee5b55e6e2a1657dc9298e4ec2eb62f7944df757467792ca |