Skip to content
This repository has been archived by the owner on Sep 25, 2023. It is now read-only.

Commit

Permalink
Docs (#34)
Browse files Browse the repository at this point in the history
  • Loading branch information
leo-alvarenga authored Sep 10, 2022
2 parents 733fa34 + 685d585 commit 2aaabb4
Show file tree
Hide file tree
Showing 3 changed files with 82 additions and 5 deletions.
20 changes: 20 additions & 0 deletions MIT-LICENSE.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
Copyright (c) 2022-Present Leonardo A. Alvarenga

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
67 changes: 62 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,64 @@
# to-go
# _To go_
A simple CLI based To do tracker built with Go

## Package hierarchy/organization
\
\
![Package hierarchy](./imgs/packages.png "Package hierarchy")
# Instalation

Simply download the binary corresponding to your machine, move it to a directory of your preference and add its path to your PATH environment variable.

# Usage

Robust and easy to use, _To go_ supports the following option:

- `to-go help`: Adds a task based of on the users input
- `to-go add`: Adds a task based of on the users input"
- `to-go remove`: Adds a task based of on the users input
- `to-go edit`: Edits a task chosen by you
- `to-go update`: Updates the status of a task chosen by you
- `to-go finish`: Updates the status of a task chosen by you to 'done'
- `to-go list`: Lists all the tasks, including ther titles, priorities, statuses and dates
- `to-go describe`: Displays all the info pertaining to a task chosen by you

# Customization

_To go_ offers a few values for you to play around and change to whatever you think suits you better. In the directory you placed the binary, a config file, seen bellow, will be automatically created after the first execution.

```yaml
// to_go.cfg.yaml

useUnicode: true
storage: sqlite
colors:
priority:
high: red
medium: yellow
low: green
status:
pending: yellow
doing: blue
done: green
attention: purple
success: green
warning: yellow
error: red
reset: "\e[0m"

```

| Option | Description | Values |
| ------ | ------------| --------------- |
| `useUnicode` | Whether or not to use unicode characters to represent the task status | `true` or `false`
| `storage` | Determines the way _To go_ stores data | Anything other than `sqlite` will defaults to using `YAML` files for persistency
| `colors` | Defines the colors to be used in the output | Change the value of its properties to one of [these colors](#colors) |

## Colors

There are 9 different colors to choose from:
- black
- red
- green
- yellow
- blue
- purple
- cyan
- white
- default
Binary file removed imgs/packages.png
Binary file not shown.

0 comments on commit 2aaabb4

Please sign in to comment.