nextcloudtasks


Namenextcloudtasks JSON
Version 0.1.0 PyPI version JSON
download
home_pagehttps://github.com/sinkmanu/nextcloud-tasks
SummaryA Nextcloud Tasks API wrapper with some useful examples for CLI
upload_time2023-03-13 22:20:28
maintainer
docs_urlNone
authorManuel Mancera
requires_python>=3.6
licenseGPL-3.0-or-later
keywords nextcloud todo nextcloud tasks
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 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"
}
        
Elapsed time: 0.51753s