Skip to main content

Time tracker for Command Line

Project description

Snap Status PyPI version

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

letsdo-2.0.1.tar.gz (32.5 kB view details)

Uploaded Source

Built Distribution

letsdo-2.0.1-py3-none-any.whl (30.9 kB view details)

Uploaded Python 3

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

Hashes for letsdo-2.0.1.tar.gz
Algorithm Hash digest
SHA256 31a76b06960d36795f2f479763ae84d4c890579675ee25102091515d8df9900c
MD5 2882d7afe73e56b6d83d14dfd3162c0f
BLAKE2b-256 912a68f9c796e165d6e24de97d9e7b53ba09ce22a78505c23ec4bef14ffb3aa9

See more details on using hashes here.

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

Hashes for letsdo-2.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3d5e60d61c51019b560b68640fdc1af5657a22179c04dddbaf4d23dcc23bf1ec
MD5 022136746f208199e1525860bcdddd5c
BLAKE2b-256 22148c880a392654ee5b55e6e2a1657dc9298e4ec2eb62f7944df757467792ca

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page