{ "info": { "author": "aarose (Anarosa Paredes)", "author_email": "hello@aarose.red", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.2", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "=============\nToggl Wrapper\n=============\n\nPython library to easily interface with Toggl's API.\n\nImplements all of Toggl's main API. The Reports API is not yet supported (coming soon).\n\nWorks in Python 2.7+ and Python 3+, and uses `requests `_.\n\n\n-----\nToggl\n-----\n\n`Toggl `_ is free time tracking software.\n\n--------\nFeatures\n--------\n- Handles authentication for you: only need to provide your API token once\n- The most complete Python wrapper: implements all of v8 API.\n- Convenient install from PyPI\n- Easy to make requests to custom URLs\n- Python2 and Python3 compatible\n\n-------\nInstall\n-------\n\n.. code-block:: bash\n\n $ pip install togglwrapper\n\n\n----------\nQuickstart\n----------\n\n.. code-block:: python\n\n >>> from togglwrapper import Toggl\n >>> toggl = Toggl('your_api_token')``\n >>> toggl.User.get()\n {u'data': {u'achievements_enabled': True,\n u'api_token': u'your_api_token',\n u'email': u'your_email@domain.com',\n u'fullname': u'Your Name',\n ...\n }\n >>> toggl.Clients.get()\n [{u'at': u'2015-07-02T14:27:59+00:00',\n u'id': 12031893,\n u'name': u'Client Name',\n u'wid': 3928}]\n >>> toggl.Workspaces.get()\n [{u'admin': True,\n u'api_token': u'your_api_token',\n u'id': 1234,\n u'name': u\"Your workspace\",\n ...\n }]\n >>> toggl.Clients.create({\"client\":{\"name\":\"Very Big Company\", \"wid\": 1234}})\n {u'data': {u'id': 294021, u'name': u'Very Big Company', u'wid': 1234}}\n\n--------------\nCustom Request\n--------------\n\nLet's pretend that a new endpoint is released, for a new Toggl object: Addresses. This hypothetical endpoint is located at ``https://www.toggl.com/api/v8/addresses``. We can GET all addresses, GET a specific address by ID, or POST to create a new address.\n\nWe can use the methods on the Toggl client, so we don't have to wait for a new version of togglwrapper that supports the new endpoint:\n\n.. code-block:: python\n\n >>> from togglwrapper import Toggl\n >>> toggl = Toggl('your_api_token')\n >>> toggl.get('/addresses')\n ...\n >>> toggl.get('/addresses/{address_id}')\n ...\n >>> toggl.post('/addresses', data={\"address\": {\"name\": \"Billing Address 1\", \"address\": \"123 Main St.\"}})\n ...\n\n\n``toggl.put`` and ``toggl.delete`` are also available.\n\n\n-------------------\nDocumentation\n-------------------\nFind the full documentation here: http://togglwrapper.readthedocs.org/en/latest/\n\n\n---------------------------\nAPI Endpoints Documentation\n---------------------------\n\nFor full details on what fields are required, and what endpoints are available, see the `Toggl API docs `_\n\n\n---------------------------\nRunning tests locally\n---------------------------\n\nUsing `virtualenv `_ + `virtualenvwrapper `_ to keep the environment isolated:\n\n1. Create a testing virtualenv\n2. Install the test requirements\n3. `python tests.py`\n\nSample command line output:\n\n.. code-block::\n\n $ mkvirtualenv twtests # if creating the virtualenv for the first time\n Running virtualenv [...]\n [...]\n (twtest) $ pip install -r test-requirements.txt\n Collecting [...]\n [...]\n (twtest) $ python tests.py\n .......................................................\n ----------------------------------------------------------------------\n Ran 55 tests in 0.414s\n\n OK\n (twtest) $ deactivate\n $\n\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/aarose/togglwrapper", "keywords": "toggl timetracking API wrapper", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "togglwrapper", "package_url": "https://pypi.org/project/togglwrapper/", "platform": "", "project_url": "https://pypi.org/project/togglwrapper/", "project_urls": { "Homepage": "https://github.com/aarose/togglwrapper" }, "release_url": "https://pypi.org/project/togglwrapper/1.2.0/", "requires_dist": [ "requests (==2.20.0)", "wheel (==0.24.0)", "cookies (==2.2.1) ; extra == 'dev'", "coverage (==3.7.1) ; extra == 'dev'", "mock (==1.3.0) ; extra == 'dev'", "pbr (==1.6.0) ; extra == 'dev'", "responses (==0.4.0) ; extra == 'dev'", "six (==1.9.0) ; extra == 'dev'" ], "requires_python": "", "summary": "", "version": "1.2.0" }, "last_serial": 5680472, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "bf7c0d8ed4fd28efcd01a092c74f1f6f", "sha256": "e3886e032398b8fcb646f7f7a12543557da7f1be522a185b078ab78656d9a70c" }, "downloads": -1, "filename": "togglwrapper-1.0.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "bf7c0d8ed4fd28efcd01a092c74f1f6f", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 8584, "upload_time": "2015-08-31T21:31:27", "url": "https://files.pythonhosted.org/packages/b1/dc/b8fc72214952d628be69bded688f33a5f9c680d0a5c88d8bdf828cb4c30e/togglwrapper-1.0.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "83be204c225eb1ff76ac4677f4ffe1de", "sha256": "a95de6376098f8fa70e2edd2754211425fccd2fe74a141db35c64807c8131fe5" }, "downloads": -1, "filename": "togglwrapper-1.0.0.tar.gz", "has_sig": false, "md5_digest": "83be204c225eb1ff76ac4677f4ffe1de", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11030, "upload_time": "2015-08-31T21:31:33", "url": "https://files.pythonhosted.org/packages/8a/5f/d66446ac3b24bc2cec14ea6602531cec2136bbdfdb631d6aa450080dd01d/togglwrapper-1.0.0.tar.gz" } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "e4bff537343d18bb8f4150b87f0956ef", "sha256": "a9c9e09b6a7587c42ffbade9ca87503cdd6f286e43b6c8bf23b80db4878e9412" }, "downloads": -1, "filename": "togglwrapper-1.0.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "e4bff537343d18bb8f4150b87f0956ef", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 10108, "upload_time": "2015-09-02T22:11:17", "url": "https://files.pythonhosted.org/packages/ad/eb/379881396cf80c0fc7d00c307b7ec5426b58586a57db9fef2ce681804ad0/togglwrapper-1.0.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "66c5b7cec489bb9283f3048b15503ead", "sha256": "df72f15e9f041b1fe350304a4b100ca4a39b4589d52c1d85c96920b03a5c91db" }, "downloads": -1, "filename": "togglwrapper-1.0.1.tar.gz", "has_sig": false, "md5_digest": "66c5b7cec489bb9283f3048b15503ead", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12349, "upload_time": "2015-09-02T22:11:26", "url": "https://files.pythonhosted.org/packages/af/38/3a1bd4a8338ea4ecac6cc88cc68a58f80b2305ab1dff61b34497ca5a2af5/togglwrapper-1.0.1.tar.gz" } ], "1.2.0": [ { "comment_text": "", "digests": { "md5": "c380fd4d30a5053a75f8e2f36f76497c", "sha256": "41c367bb201d75564a1ee92ebf895141294f5111e6b9d93d2932d3346b8affc2" }, "downloads": -1, "filename": "togglwrapper-1.2.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "c380fd4d30a5053a75f8e2f36f76497c", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 9766, "upload_time": "2019-08-15T04:21:39", "url": "https://files.pythonhosted.org/packages/e7/95/a6076e04df9abd616023503c1c1004989c11c9623985d9f58b23c66f5d62/togglwrapper-1.2.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e3a636a7cc7a1d5cb7686ce2f8d10644", "sha256": "edd275ea3a816328796a48cb7b91c7de2cb17aa564ea0b4af3916b8a5ba85d69" }, "downloads": -1, "filename": "togglwrapper-1.2.0.tar.gz", "has_sig": false, "md5_digest": "e3a636a7cc7a1d5cb7686ce2f8d10644", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13371, "upload_time": "2019-08-15T04:21:41", "url": "https://files.pythonhosted.org/packages/bb/6a/b0758c7184e390ccbf4eae009c2345df5af4d2ad3fa5b9f53f0fee23e6b3/togglwrapper-1.2.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "c380fd4d30a5053a75f8e2f36f76497c", "sha256": "41c367bb201d75564a1ee92ebf895141294f5111e6b9d93d2932d3346b8affc2" }, "downloads": -1, "filename": "togglwrapper-1.2.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "c380fd4d30a5053a75f8e2f36f76497c", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 9766, "upload_time": "2019-08-15T04:21:39", "url": "https://files.pythonhosted.org/packages/e7/95/a6076e04df9abd616023503c1c1004989c11c9623985d9f58b23c66f5d62/togglwrapper-1.2.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e3a636a7cc7a1d5cb7686ce2f8d10644", "sha256": "edd275ea3a816328796a48cb7b91c7de2cb17aa564ea0b4af3916b8a5ba85d69" }, "downloads": -1, "filename": "togglwrapper-1.2.0.tar.gz", "has_sig": false, "md5_digest": "e3a636a7cc7a1d5cb7686ce2f8d10644", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13371, "upload_time": "2019-08-15T04:21:41", "url": "https://files.pythonhosted.org/packages/bb/6a/b0758c7184e390ccbf4eae009c2345df5af4d2ad3fa5b9f53f0fee23e6b3/togglwrapper-1.2.0.tar.gz" } ] }