Metadata-Version: 2.1
Name: cli_todo_manager
Version: 0.1.1
Summary: A simple command line utility that manages your ToDos
Home-page: https://github.com/timnw2000/todos
Author: Tim Nwungang
Author-email: timnw.dev@gmail.com
Maintainer-email: timnw.dev@gmail.com
License: MIT
Project-URL: Documentation, https://github.com/timnw2000/todos/blob/main/README.md
Requires: setuptools
Description-Content-Type: text/markdown
Requires-Dist: prettytable==3.9.0
Requires-Dist: tabulate==0.9.0
Requires-Dist: wcwidth==0.2.12

# ToDo List Manager
---

A simple command-line utility for managing a ToDo list, using SQLite for storage.

This tool offers a dynamic and collaborative approach to task management. Designed to operate in a team-based environment, it allows for the integration of a hidden file, named todos.db, into a shared repository. This integration is a key feature that enables multiple users to access and update their to-do lists. By adding todos.db to the repository, team members can seamlessly share and synchronize their tasks with each other. This shared access ensures that everyone in the team is on the same page, as they can view, add, modify, and remove tasks using this same command-line tool. This functionality is particularly beneficial in collaborative projects where consistent communication and coordination of tasks are crucial. Furthermore, the use of a command-line interface for this tool makes it versatile and suitable for various environments, including software development, project management, and any other team-oriented workspace where task tracking is essential.

## Features

- Initialize a new ToDo list database
- Add ToDo items with details
- Show ToDo items
- Update Status of ToDo Item
- Remove ToDo items and add them to history
- Show history of completed ToDo items


#### Fields

- `todo`: The name of the ToDo item.
- `weekday`: The day of the week for the ToDo item.
- `description`: A description of the ToDo item.
- `importance`: The importance level of the ToDo item.
- `comments`: A comment left after completing a ToDo.
- `status`: The state the current ToDo is in. It is either `Pending ...`, `In Progress` or `Finished`.
- `action`: An action that has been taken.

## Usage

1. **Initialize the database**: Run the script with `todo init` to a create the database for the current Directory. Therefore each Directory can have their own ToDo-Manager.

    ```
    todo init
    ```
    

2. **Add a ToDo item**: Use `todo add <todo_name> <weekday>` to add a new item.

    ```
    todo add some_todo sunday
    ```

    The next prompts give you the opportunity to further describe your todo

    ```
    Description: some description
    ```

    ```
    Importance: high
    ```


3. **Show ToDo items**: Use `todo show` to display all items or `todo show [criteria]` for specific items. You can search for the `name`, `id`, `day` and `importance`.

    ```
    todo show 
    ```
    or
    ```
    todo show some_todo_name
    ```
    or 
    ```
    todo show 1
    ```
    or
    ```
    todo show sunday
    ```
    or 
    ```
    todo show high
    ```

    Output looks something like this:

        +------+---------------------------------+-----------+--------------+------------------------------------------+-------------+
        |   ID | ToDo                            | Weekday   | Importance   | Description                              | Status      |
        +======+=================================+===========+==============+==========================================+=============+
        |    1 | collaborations                  | sunday    | high         | Implementing collaboration functionality | Pending ... |
        +------+---------------------------------+-----------+--------------+------------------------------------------+-------------+
        |    2 | uploading first version to pypi | friday    | high         | Uploading current version to pypi        | Pending ... |
        +------+---------------------------------+-----------+--------------+------------------------------------------+-------------+





4. **Remove a ToDo item**: Use `todo remove <id_or_name>` to remove an item and add it to the history.

    ```
    todo remove 1 
    ```
    or
    ```
    todo remove some_todo_name
    ```

5. **Updating Status of ToDo**: Use `todo update <id_or_name>` to update the status of a ToDo from `pending` to `in progress`.

    ```
    todo update 1 
    ```
    or
    ```
    todo update some_todo
    ```




5. **Show History of completed ToDos**: Use `todo history` to display all items or `todo history [criteria]` for specific items. You can search for the `id`, `name` and `importance`.

    ```
    todo history 
    ```
    or
    ```
    todo history some_todo
    ```
    or 
    ```
    todo history 1
    ```
    or 
    ```
    todo history high
    ```

    Output looks something like this:

        +------+----------------+------------------+--------------+------------------------------------------+-----------------------------------------------------+----------+
        |   ID | ToDo           | Finished         | Importance   | Description                              | Comment                                             | Status   |
        +======+================+==================+==============+==========================================+=====================================================+==========+
        |    1 | collaborations | 29 December 2023 | high         | Implementing collaboration functionality | I should implement this feature in the next version | Finished |
        +------+----------------+------------------+--------------+------------------------------------------+-----------------------------------------------------+----------+



6. **Show Logs, which includes all actions**: Use `todo logs` to display all actions, that has been taken so far.

    ```
    todo logs
    ```

    Output looks something like this:

        +------+---------------------------------+------------------+-----------------+-------------+
        |   ID | ToDo                            | Time             | Action          | Status      |
        +======+=================================+==================+=================+=============+
        |    1 | collaborations                  | 28 December 2023 | Adding ToDo     | Pending ... |
        +------+---------------------------------+------------------+-----------------+-------------+
        |    2 | uploading first version to pypi | 29 December 2023 | Adding ToDo     | Pending ... |
        +------+---------------------------------+------------------+-----------------+-------------+
        |    3 | uploading first version to pypi | 29 December 2023 | Updating Status | In Progress |
        +------+---------------------------------+------------------+-----------------+-------------+
        |    4 | collaborations                  | 29 December 2023 | Removing ToDo   | Finished    |
        +------+---------------------------------+------------------+-----------------+-------------+



## Limitations

- The script expects command-line arguments for certain operations.
- Database initialization must be performed before any other operations.
- Error handling is primarily done through `sys.exit` with error messages.
