Skip to main content
# todo.python

[![](https://img.shields.io/pypi/v/todo.python.svg)](https://pypi.python.org/pypi/todo.python)
[![](https://travis-ci.org/wkentaro/todo.python.svg?branch=master)](https://travis-ci.org/wkentaro/todo.python)

Manage todo on git repo.

It uses Git repo for the database,
and has feature of automated **sync** and **archive**.
The sample database is here: https://github.com/wkentaro/todo.python.sample.

The difference from its alternatives such as Evernote and iOS todo list
is the feature of auto archiving.
*todo.python* is designed for use of daily report on your work,
and you can easily look back **what you completed at each day**
[as shown in the sample](https://github.com/wkentaro/todo.python.sample/blob/master/archive.yaml).


## Installation

```bash
pip install todo.python
```


## Usage


```bash
GITHUB_NAME=<YOUR GITHUB NAME>
REPO=todo
# https://github.com/github/hub
hub create -p $REPO # Or create it on browser (private repo is recommended)

todo init https://github.com/$GITHUB_NAME/$REPO.git

todo edit # pull -> archive -> edit -> push
EDITOR=emacs todo edit # default is vim

todo show # pull -> archive -> push -> show

todo open # pull -> archive -> push -> open
```


## Demonstration

Here, we demonstrate its feature with [the sample database](https://github.com/wkentaro/todo.python.sample).

```bash
$ todo deinit

$ todo init https://github.com/wkentaro/todo.python.sample.git
Remote URL: https://github.com/wkentaro/todo.python.sample.git
Pulling from remote: https://github.com/wkentaro/todo.python.sample.git
+ git clone https://github.com/wkentaro/todo.python.sample.git /Users/minerva/.cache/todo
Cloning into '/Users/minerva/.cache/todo'...
remote: Counting objects: 46, done.
remote: Total 46 (delta 0), reused 0 (delta 0), pack-reused 46
Unpacking objects: 100% (46/46), done.
```

![](static/todo.show.gif) ![](static/todo.edit.gif)

Metadata

Release files for todo.python 0.4.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for todo.python 0.4.4
File Size Uploaded Provenance Actions
todo.python-0.4.4.tar.gz 5.7 kB Without provenance Details for todo.python-0.4.4.tar.gz

Release files / todo.python-0.4.4.tar.gz

Download URL todo.python-0.4.4.tar.gz
Size 5.7 kB
Tags Source
SHA-256 checksum
How to use checksums
504abb47179afca47baa93ecf7ea02635fef50952b1655dccf2c48f543efe56d
BLAKE2b-256 checksum
How to use checksums
cd36681d8e31960e2dd868543cf5cd94d354e8bc1c464b1a0fda5df6b50aa797
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for todo.python 0.4.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page