README

-----
stodo - a simple TODO CLI application
-----
Copyright (C) 2013-14 Michał Walczak <mw@michalwalczak.eu>
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
-----

A small organizational application.
Creates a file (~/.stodo by default) and allows you to append, remove, display
and count items. Fully CLI, interface consists of few simple options.
Easy to embedd in a login MoTD, etc.

Basic program is implemented, currently using SQLite database.
Tagging and other improvements are planned.

---

Dependencies:
    * Requires python:
        Written with python3 in mind, and somewhat tested in python2.
        Consider python2 not-supported, but feel free to point out any bugs.
        Hashbang in the script points to /bin/env python by default.

    * Requires sqlite.

---

Installation:
    Put anywhere, set permission to execution and run './stodo'
    OR
    Put anywhere and run with 'python stodo' (or 'python3 stodo')
    OR
    Find on AUR (Arch Linux) and install manually or with your favourite AUR
    pacman wrapper.
    AUR page - <http://aur.archlinux.org/packages/stodo/>

-----

Usage info available via 'stodo -h' or 'stodo --help', copy below.

Usage: stodo OPTION [ARGUMENT]
Only the first option on the command line will execute each run.
Mandatory arguments to long versions are mandatory for short versions too.
-h, --help              print usage summary (this)
-l, --list              list all of the saved items, enumerated
-l, --list (-n,0,n)     list n or all (0) of the saved items from top or bottom
-c, --count             print a simple count of all saved items
-a, --add "item"        add text between quotes as a new item
-r, --remove (1..n)     remove the specified item
-v, --version           show version and license information

-----

Bug reports and developement suggestions:
Create a github issue, or e-mail me at <mw@michalwalczak.eu>

Any AUR package issues - please comment on the AUR page below.
<https://aur.archlinux.org/packages/stodo/>