Metadata-Version: 2.4
Name: pytodotxt
Version: 3.1.0
Summary: Library to access todo.txt-like task lists
Author-email: R <contact+pytodotxt@vonshednob.cc>
License-Expression: MIT
Project-URL: Homepage, https://vonshednob.cc/pytodotxt
Project-URL: Documentation, https://vonshednob.cc/pytodotxt/doc/
Project-URL: Repository, https://codeberg.org/pter/pytodotxt
Project-URL: Issues, https://codeberg.org/pter/pytodotxt/issues
Project-URL: Changelog, https://vonshednob.cc/pytodotxt/changelog.html
Keywords: todotxt
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: AUTHORS.md
Dynamic: license-file

# pytodotxt

A tiny library to access `todo.txt`-like task lists.


## Installation

To install pytodotxt, you can follow these steps to clone the repository,
and install the program.

```bash
pip install pytodotxt
```

That’s all there is to do.


## Documentation

You can find the full documentation at <https://vonshednob.cc/pytodotxt/doc/>.


## Example usage

Here’s an example how to open a `todo.txt` file and print the description of all
tasks that are not marked as completed:

```python
import pytodotxt


todotxt = pytodotxt.TodoTxt('todo.txt')
todotxt.parse()

for task in todotxt.tasks:
    if not task.is_completed:
        print(task.description)
```


Here is how you add a new task to an existing `todo.txt` file:

```python
import datetime

import pytodotxt

todotxt = pytodotxt.TodoTxt('todo.txt')
todotxt.parse()

task = pytodotxt.Task()
task.parse('This is a new task')
task.creation_date = datetime.date.today()

todotxt.tasks.append(task)

todotxt.save()
```


# Is this project still active?

You can consider this project actively maintained until: **2026-07-01**.

If _today_ is past that date, please consider this project no longer
maintained and do not expect issues or questions to be answered by the
maintainers.

