Metadata-Version: 2.3
Name: noteist
Version: 0.3.0
Summary: Output a Markdown formatted report of completed tasks in Todoist.
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Utilities
Classifier: Development Status :: 3 - Alpha
Requires-Dist: requests>=2.32.4
Requires-Dist: toml>=0.10.2
Requires-Python: >=3.9
Project-URL: Documentation, https://github.com/epicserve/noteist
Project-URL: Source, https://github.com/epicserve/noteist
Description-Content-Type: text/markdown

# Noteist

A script to generate a Markdown report of completed tasks in a Todoist project.


## Features
- Lists completed tasks for a specified project and date range
- Outputs in Markdown format
- Supports sub-tasks and descriptions


## Requirements

1. Get your Todoist API Token
   * Log in to your [Todoist account](https://todoist.com/).
   * Go to **Settings** > **Integrations** > **Developer (tab)**.
   * Copy your **API token** from the "API token" section.
2. Install [UV](https://docs.astral.sh/uv/getting-started/installation/)


## Usage

Print help:

```sh
uvx noteist --help                                                               
```

Out completed tasks for the Todoist project Work with the default of two weeks:
```sh
uvx noteist --project "Work" --token <TOKEN>
```

Save the project "Work" and your token as the defaults:
```sh
uvx noteist --project "Work" --token <TOKEN> --save-project --save-token
```

Specify the time range:
```sh
uvx noteist --since 2025-07-01 --until 2025-07-15
```

## Development

To run the script locally while in development.

1. Clone the repository.
2. Then run the script with: `uv run -m noteist`


## Formatting Code
To format the codebase using [ruff](https://docs.astral.sh/ruff/):

```sh
just format
```

## License
MIT

