Eagle

Eagle is a simple CLI todo tool. It's so simple it hurts my coding skills.

How does it work?

~ eagle

Today:
    4. brush yo teeth

Your list:

   1. do the laundry (every week)
   2. buy some food (each other day)
   3. buy presents (on 24th December)
   4. do the homework [School]

How can I install it?

Don't worry about the early version number 0.x. I tend to Semantic Versioning more than to "Marketing Versioning". That means version 0.5 is quite solid piece of software instead or having version 25 and still not-even-half-way there.

So:

pip install eagle-cli

You might need to use pip3 instead if you run Python 2 next to Python 3.

Requirements

• Python 3.6+

Parameters (how to use it)

Tasks

-a, --add

Adds a task (can be used multiple times).

1. place takes the task name.
2. place takes date/frequency [optional].
3. place takes group [optional].

Examples:

~ eagle -a "make yo bed"  # Adds a todo
~ eagle -a "make yo bed" today  # Adds a todo task for today
~ eagle -a "make yo bed" tomorrow  # Adds a todo task for tomorrow
~ eagle -a "make yo bed" wed  # Adds a todo task for nearest Wednesday
~ eagle -a "make yo bed" 1d  # Adds todo for each day
~ eagle -a "make yo sis bed" @20/1/2050  # Adds todo on 20th January 2050
~ eagle -a "make yo sis bed" @20/1  # Adds todo on 20th January this year
~ eagle -a "make yo sis bed" +5  # Adds todo on 5th day from today
~ eagle -a "make yo dog bed ... someday" @20/1/2050 dog # Adds todo on 20th January 2050 to the "dog" group
~ eagle -a "make yo dog bed groupped" - dog # Adds todo to the "dog" group - notice the "-" as a date.

• subject whatever

• frequency (optional)

  • no date/frequency/recurring: -
  • recurring: 1d, 1w, 1m, 1y
  • on a specific date: @20/1/2050 or just @20/1 for current year

  • magical string representing a date

    • today
    • tomorrow
    • weekday name recognisable nearest weekday name (mon, mo, monday, sun, fr, ..)
    • +X where X is number of days. For example +5 means "in 5 days".

• group (optional) - if the group doesn't exist eagle creates it for you

If you wanna add a task with no date/frequency to a certain group use - as date/frequency.

eagle -a Task1 - group1

-e, --edit

Edits a task. The user gets prompted for new title, frequency and group. In each prompt you have 3 choices:

• enter a new value
• just hit enter which skips editing of the current property
• enter a space (hit spacebar) which deletes the current property (cannot be used for title)

Example:

~ eagle

Today:
    1. brush yo teeth

~ eagle -e 1

Here you can edit a task be rewriting current values.
If you wanna remove current value (frequency, group) enter one space (hit spacebar) instead.

Enter task title: Do the homework
Enter frequency: today
Enter group (empty space to remove group):

Task was successfully updated.


Today:
        1. Do the homework (09/03/2019)

-d, --del

Deletes a task (can be used multiple times).

Example:

~ eagle -d 2
~ eagle

Today:
    4. brush yo teeth

Your list:

    1. do the laundry (every week)
    2. buy presents (on 24th December)
    3. brush yo teeth (every day)

-c, --clear

Removes all tasks and groups.

Example:

~ eagle

Today:
    4. brush yo teeth

Your list:

    1. do the laundry (every week)
    2. buy presents (24/12/2019)
    3. brush yo teeth (every day)

~ eagle -c
Todo list has been cleared out.

--prune

Prunes all overdue tasks. Overdue task is such task which has a date set as frequency.

Example:

~ eagle

Your list:

    1. go shopping (1/1/2000)
    2. buy presents (24/12/2030)

~ eagle --prune
Task "go shopping 10:30" has been deleted.
~ eagle

Your list:

    1. buy presents (24/12/2030)

--today

Lists only today's tasks.

Example:

~ eagle --today

Today:
    4. brush yo teeth

--overdue

Lists only overdue tasks.

Example:

~ eagle --overdue

Your list:
    1. run (1/9/1939)

--upcoming

Filters upcoming tasks (up to 3 days starting from today).

Example:

~ eagle --upcoming

Today:
    2. Buy booze

Upcoming:
    5. Gym (1/1/2030)

--search

Searches tasks by it's title.

Example:

~ eagle

Your list:

    1. go shopping (1/1/2000)
    2. buy presents (24/12/2030)

~ eagle --search shopping

Your list:
    1. go shopping (1/1/2000)

--other

Lists only "other" tasks - all tasks except today's and overdue tasks.

Example:

~ eagle --other

Your list:
    1. buy presents (24/12/2030)

Note

Filtering tasks with --today, --overdue, --search and --other can be stacked up. For example eagle --overdue --today.

Groups

-A, --add-group

Adds a group (can be used multiple times).

Example:

~ eagle -A "School"

-D, --delete-group

Deletes a group with all attached tasks (can be used multiple times).

Example:

~ eagle

Your list:

    1. do the laundry (every week)
    2. do the homework [School]
    3. set up project [School]

~ eagle -D "School"

Your list:

    1. do the laundry (every week)

-S, --soft-delete-group

Deletes a group without deleting attached tasks (can be used multiple times).

Example:

~ eagle

Your list:

    1. do the laundry (every week)
    2. do the homework [School]
    3. set up project [School]

~ eagle -S "School"

Your list:

    1. do the laundry (every week)
    2. do the homework
    3. set up project

-g, --groups

Lists tasks filtered by a group name (can be used multiple times).

Example:

~ eagle

Your list:

     1. do the laundry (every week)
     2. do the homework [School]
     3. set up project [School]

 ~ eagle -g "School"

 Your list:

     2. do the homework [School]
     3. set up project [School]

Print options

--sort=[groups]

Tasks are sorted by date and time they were created. You can override this option in this parameter.

• groups - sorts alphabetically tasks by groups. First goes the tasks without any group.

Why CLI?

CLI is the best UI ever invented. It's fast, clean, bloat free and you dont have to invest massive effort to make your software looks good. Also you don't have to rewrite or modernize each year (see web apps).

Also you can easily parse the output and chain that into your window manager widget if you want to (i.e. AwesomeWM).

Isn't this just another copycat?

There is a few project around which are pretty good. For example TaskWarrior which is robust and covers pretty much everything. For me it's too heavy and fancy with all the charts and tables. I want something more quiet and more straightforward.

Why you don't use mypy?

From mypy FAQ:

Will static typing make my programs run faster?

Mypy only does static type checking and it does not improve
performance. It has a minimal performance impact. In the
future, there could be other tools that can compile statically
typed mypy code to C modules or to efficient JVM bytecode, for
example, but this is outside the scope of the mypy project.

So static typing is just for a developer not for a machine. Once it will also help a machine to run Python code faster (Cython principle) I will definitely start using that.

Can I contribute?

Absolutely! I would be more than happy to accept any bug-report, improvement, pull request, constructive criticism, etc.