# Nextcloud Tasks API
[![Python package](https://github.com/Sinkmanu/nextcloud-tasks/actions/workflows/test-todo.yml/badge.svg?branch=main)](https://github.com/Sinkmanu/nextcloud-tasks/actions/workflows/test-todo.yml)
A [Nextcloud Tasks](https://github.com/nextcloud/tasks) API wrapper with some useful examples for CLI
```py
from nextcloudtasks import *
nextcloud = NextcloudTask("foo.bar.org:443/remote.php/dav/calendars/foobar/", "myList")
nextcloud.connect("username", "password")
nextcloud.printTODOs("summary,categories,created,priority")
nextcloud.close()
```
It is a custom API wrapper that is not developed nor maitained by Nextcloud.
## Installation
```sh
pip install nextcloudtasks
```
## Examples
The following example is a tool that manages the a Nextcloud TODO list from the command line. It can be found in [examples](/examples)
.nc-tasks.rc
```
[DEFAULT]
url=your.nextclouddomain.foo:443/remote.php/dav/calendars/youruser/
user=youruser
password=yourpassword
list=yourlist
```
nc-tasks.py:
```
Welcome to Nextcloud tasks CLI. Type help or ? to list commands.
(Nextcloud Tasks) ?
Documented commands (type help <topic>):
========================================
add complete delete exit list nextcloud print_all
close connect edit help load print
(Nextcloud Tasks) load
(Nextcloud Tasks) print
+---------+--------------------------------------+------------+----------+
| SUMMARY | UID | RELATED-TO | PRIORITY |
+---------+--------------------------------------+------------+----------+
| Task 2 | d4910d0e-e82f-474c-8b96-39d51a078820 | None | 0 |
| Task 3 | e823277e-08da-4e38-a98e-67f6e0301eb3 | None | 0 |
| Task 1 | de92dbda-afba-4bf3-b924-57b4db08f3f2 | None | 3 |
+---------+--------------------------------------+------------+----------+
```
## Hacking
Pull requests are welcome.
## License
[GPL](https://www.gnu.org/licenses/gpl-3.0.txt)
Raw data
{
"_id": null,
"home_page": "https://github.com/sinkmanu/nextcloud-tasks",
"name": "nextcloudtasks",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "nextcloud,todo,nextcloud tasks",
"author": "Manuel Mancera",
"author_email": "Manuel Mancera <manu@unam.re>",
"download_url": "https://files.pythonhosted.org/packages/41/54/d0d1609d0eadb6d9821a5a88394aa66db8756fa470be5de6d5310de35996/nextcloudtasks-0.1.0.tar.gz",
"platform": null,
"description": "# Nextcloud Tasks API\n\n[![Python package](https://github.com/Sinkmanu/nextcloud-tasks/actions/workflows/test-todo.yml/badge.svg?branch=main)](https://github.com/Sinkmanu/nextcloud-tasks/actions/workflows/test-todo.yml)\n\nA [Nextcloud Tasks](https://github.com/nextcloud/tasks) API wrapper with some useful examples for CLI\n\n```py\nfrom nextcloudtasks import *\n\nnextcloud = NextcloudTask(\"foo.bar.org:443/remote.php/dav/calendars/foobar/\", \"myList\")\nnextcloud.connect(\"username\", \"password\")\nnextcloud.printTODOs(\"summary,categories,created,priority\")\nnextcloud.close()\n```\n\nIt is a custom API wrapper that is not developed nor maitained by Nextcloud. \n\n## Installation\n\n```sh\npip install nextcloudtasks\n```\n\n## Examples\n\nThe following example is a tool that manages the a Nextcloud TODO list from the command line. It can be found in [examples](/examples)\n\n.nc-tasks.rc\n```\n[DEFAULT]\nurl=your.nextclouddomain.foo:443/remote.php/dav/calendars/youruser/\nuser=youruser\npassword=yourpassword\nlist=yourlist\n```\n\nnc-tasks.py:\n```\nWelcome to Nextcloud tasks CLI. Type help or ? to list commands.\n(Nextcloud Tasks) ?\n\nDocumented commands (type help <topic>):\n========================================\nadd complete delete exit list nextcloud print_all\nclose connect edit help load print \n\n(Nextcloud Tasks) load\n(Nextcloud Tasks) print\n+---------+--------------------------------------+------------+----------+\n| SUMMARY | UID | RELATED-TO | PRIORITY |\n+---------+--------------------------------------+------------+----------+\n| Task 2 | d4910d0e-e82f-474c-8b96-39d51a078820 | None | 0 |\n| Task 3 | e823277e-08da-4e38-a98e-67f6e0301eb3 | None | 0 |\n| Task 1 | de92dbda-afba-4bf3-b924-57b4db08f3f2 | None | 3 |\n+---------+--------------------------------------+------------+----------+\n```\n\n## Hacking\n\nPull requests are welcome. \n\n## License\n\n[GPL](https://www.gnu.org/licenses/gpl-3.0.txt)\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "A Nextcloud Tasks API wrapper with some useful examples for CLI",
"version": "0.1.0",
"split_keywords": [
"nextcloud",
"todo",
"nextcloud tasks"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "dbeb33d7481d1d99038008f00d6c1a5f2b9149368d97cbe8e844ac01414936fd",
"md5": "0a9c42d93c988bc7410961c4d868eda1",
"sha256": "a43fd6bc76da5f4f4dc97bd67586d318286e8d4206c53409469222c802bb370e"
},
"downloads": -1,
"filename": "nextcloudtasks-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0a9c42d93c988bc7410961c4d868eda1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 19577,
"upload_time": "2023-03-13T22:20:27",
"upload_time_iso_8601": "2023-03-13T22:20:27.022690Z",
"url": "https://files.pythonhosted.org/packages/db/eb/33d7481d1d99038008f00d6c1a5f2b9149368d97cbe8e844ac01414936fd/nextcloudtasks-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4154d0d1609d0eadb6d9821a5a88394aa66db8756fa470be5de6d5310de35996",
"md5": "a721f227677bf5088b1fddbf54cdf49b",
"sha256": "db16ad2ef3bf1937c3fc0a564d4ca4d6853cee54e0eaa327b1098e01494e2650"
},
"downloads": -1,
"filename": "nextcloudtasks-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "a721f227677bf5088b1fddbf54cdf49b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 20450,
"upload_time": "2023-03-13T22:20:28",
"upload_time_iso_8601": "2023-03-13T22:20:28.962258Z",
"url": "https://files.pythonhosted.org/packages/41/54/d0d1609d0eadb6d9821a5a88394aa66db8756fa470be5de6d5310de35996/nextcloudtasks-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-13 22:20:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "sinkmanu",
"github_project": "nextcloud-tasks",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "nextcloudtasks"
}