Taskwarrior/README.md

55 lines
1.0 KiB
Markdown
Raw Normal View History

2015-02-06 07:26:04 -06:00
# Taskwarrior PHP lib
2015-02-05 13:41:03 -06:00
2015-02-05 13:47:39 -06:00
[![Build Status](https://travis-ci.org/DavidBadura/Taskwarrior.svg?branch=master)](https://travis-ci.org/DavidBadura/Taskwarrior)
2015-02-05 13:44:44 -06:00
2015-02-06 07:26:04 -06:00
![WOW](http://i.imgur.com/mvSQh0M.gif)
2015-02-08 15:08:58 -06:00
## Install
```bash
2015-02-08 15:31:40 -06:00
composer require 'davidbadura/taskwarrior'
2015-02-08 15:08:58 -06:00
```
2015-04-13 02:55:13 -05:00
**Requirements: Taskwarrior >=2.1**
2015-04-13 02:54:44 -05:00
2015-02-08 15:08:58 -06:00
## Usage
2015-02-05 13:41:03 -06:00
```php
2015-02-06 11:31:13 -06:00
use DavidBadura\Taskwarrior\TaskManager;
use DavidBadura\Taskwarrior\Task;
2015-02-08 07:00:15 -06:00
use DavidBadura\Taskwarrior\Recurring;
2015-02-05 13:41:03 -06:00
2015-02-06 11:31:13 -06:00
$tm = TaskManager::create();
$task = new Task();
2015-02-06 06:09:01 -06:00
$task->setDescription('program this lib');
2015-02-06 06:08:13 -06:00
$task->setProject('hobby');
2015-02-08 07:29:44 -06:00
$task->setDue('tomorrow');
2015-02-06 11:31:13 -06:00
$task->setPriority(Task::PRIORITY_HIGH);
$task->addTag('next');
2015-02-08 07:29:44 -06:00
$task->setRecurring(Recurring::DAILY);
2015-02-05 13:41:03 -06:00
2015-02-06 05:38:54 -06:00
$tm->save($task);
2015-02-05 13:41:03 -06:00
2015-02-06 06:14:58 -06:00
$tasks = $tm->filter('project:hobby'); // one task
$tm->done($task);
$tasks = $tm->filter('project:hobby'); // empty
2015-04-23 14:16:31 -05:00
$tasks = $tm->filterByReport('waiting');
2015-02-05 13:41:03 -06:00
```
2015-02-08 15:08:58 -06:00
## API
2015-02-08 15:31:40 -06:00
todo...
2015-04-06 17:03:22 -05:00
### QueryBuilder
```php
$tasks = $taskManager->createQueryBuilder()
->whereProject('hobby')
2015-04-23 12:03:13 -05:00
->orderBy(['entry' => 'DESC'])
2015-04-06 17:03:22 -05:00
->getResult()
2015-04-13 02:54:44 -05:00
```