{"action":"created","comment":{"url":"https://api.github.com/repos/osuosl/pymesync/pulls/comments/47572980","id":47572980,"diff_hunk":"@@ -98,44 +135,106 @@ TimeSync.\\ **create_time(parameter_dict)**\n \n ------------------------------------------\n \n-TimeSync.\\ **get_times([\\**kwargs])**\n+TimeSync.\\ **update_time(parameter_dict, uuid)**\n \n-    Request time entries filtered by parameters passed to ``kwargs``. Returns a\n-    list of python objects representing the JSON time information returned by\n-    TimeSync or an error message if unsuccessful.\n+    Update a time entry by uuid on the TimeSync instance specified by the\n+    baseurl provided when instantiating the TimeSync object. This method will\n+    return a list with a single python dictionary containing the updated entry\n+    if successful. The dictionary will contain error information if\n+    ``update_time()`` was unsuccessful.\n+\n+    ``parameter_dict`` is a python dictionary containing the time information to\n+    send to TimeSync. The syntax is ``\"string_key\": \"string_value\"`` with the\n+    exception of the key ``\"duration\"`` which takes an integer value, and the\n+    key ``\"activities\"``, which takes a list of strings containing activity\n+    slugs. You only need to send the fields that you want to update.\n+\n+    ``uuid`` is a string containing the uuid of the time to be updated.\n+\n+    ``update_time()`` accepts the following fields in ``parameter dict``:\n+\n+    * ``\"duration\"`` - duration of time spent working on project in seconds (per\n+      TimeSync API)\n+    * ``\"project\"`` - slug of project worked on\n+    * ``\"user\"`` - username of user that did the work, must match ``user``\n+      specified in instantiation\n+    * ``\"activities\"`` - list of slugs identifying the activies worked on for\n+      this time entry\n+    * ``\"date_worked\"`` - date worked for this time entry in the form\n+      ``\"yyyy-mm-dd\"``\n+    * ``\"notes\"`` - optional notes about this time entry\n+    * ``\"issue_uri\"`` - optional uri to issue worked on\n+\n+    Example ``parameter_dict`` to update the date_worked of a time entry:\n+\n+    .. code-block:: python\n+\n+      params = {\n+          \"date_worked\": \"2015-04-17\",\n+      }\n+\n+------------------------------------------\n+\n+TimeSync.\\ **get_times(\\**kwargs)**\n+\n+    Request time entries from the TimeSync instance specified by the baseurl\n+    provided when instantiating the TimeSync object. The time entries are\n+    filtered by parameters passed to ``kwargs``. Returns a list of python\n+    dictionaries containing the time information returned by TimeSync or an\n+    error message if unsuccessful.\n \n     ``kwargs`` contains the optional query parameters described in the\n     `TimeSync documentation`_. If ``kwargs`` is empty, ``get_times()`` will\n     return all times in the database. The syntax for each argument is\n-    ``query=[\"parameter\"]`` except for the ``id`` parameter which is\n-    ``id=<integer-id>``.\n+    ``query=[\"parameter1\", \"parameter2\"]`` except for the ``id`` parameter which","path":"docs/source/usage.rst","position":195,"original_position":195,"commit_id":"d7e364e7cc94a7879db3702cabff4452a3109d78","original_commit_id":"d7e364e7cc94a7879db3702cabff4452a3109d78","user":{"login":"ElijahCaine","id":1897147,"avatar_url":"https://avatars.githubusercontent.com/u/1897147?v=3","gravatar_id":"","url":"https://api.github.com/users/ElijahCaine","html_url":"https://github.com/ElijahCaine","followers_url":"https://api.github.com/users/ElijahCaine/followers","following_url":"https://api.github.com/users/ElijahCaine/following{/other_user}","gists_url":"https://api.github.com/users/ElijahCaine/gists{/gist_id}","starred_url":"https://api.github.com/users/ElijahCaine/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ElijahCaine/subscriptions","organizations_url":"https://api.github.com/users/ElijahCaine/orgs","repos_url":"https://api.github.com/users/ElijahCaine/repos","events_url":"https://api.github.com/users/ElijahCaine/events{/privacy}","received_events_url":"https://api.github.com/users/ElijahCaine/received_events","type":"User","site_admin":false},"body":"There is no id parameter. There *is* a **uuid** parameter.","created_at":"2015-12-14T23:02:26Z","updated_at":"2015-12-14T23:02:26Z","html_url":"https://github.com/osuosl/pymesync/pull/54#discussion_r47572980","pull_request_url":"https://api.github.com/repos/osuosl/pymesync/pulls/54","_links":{"self":{"href":"https://api.github.com/repos/osuosl/pymesync/pulls/comments/47572980"},"html":{"href":"https://github.com/osuosl/pymesync/pull/54#discussion_r47572980"},"pull_request":{"href":"https://api.github.com/repos/osuosl/pymesync/pulls/54"}}},"pull_request":{"url":"https://api.github.com/repos/osuosl/pymesync/pulls/54","id":53448645,"html_url":"https://github.com/osuosl/pymesync/pull/54","diff_url":"https://github.com/osuosl/pymesync/pull/54.diff","patch_url":"https://github.com/osuosl/pymesync/pull/54.patch","issue_url":"https://api.github.com/repos/osuosl/pymesync/issues/54","number":54,"state":"open","locked":false,"title":"Refactor Documentation","user":{"login":"matthewrsj","id":12090084,"avatar_url":"https://avatars.githubusercontent.com/u/12090084?v=3","gravatar_id":"","url":"https://api.github.com/users/matthewrsj","html_url":"https://github.com/matthewrsj","followers_url":"https://api.github.com/users/matthewrsj/followers","following_url":"https://api.github.com/users/matthewrsj/following{/other_user}","gists_url":"https://api.github.com/users/matthewrsj/gists{/gist_id}","starred_url":"https://api.github.com/users/matthewrsj/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/matthewrsj/subscriptions","organizations_url":"https://api.github.com/users/matthewrsj/orgs","repos_url":"https://api.github.com/users/matthewrsj/repos","events_url":"https://api.github.com/users/matthewrsj/events{/privacy}","received_events_url":"https://api.github.com/users/matthewrsj/received_events","type":"User","site_admin":false},"body":"#37 #39 #40 #45","created_at":"2015-12-11T21:51:06Z","updated_at":"2015-12-14T23:02:26Z","closed_at":null,"merged_at":null,"merge_commit_sha":"7dec18a2415881e1960fbd9120a1aaa3eb511d8c","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/osuosl/pymesync/pulls/54/commits","review_comments_url":"https://api.github.com/repos/osuosl/pymesync/pulls/54/comments","review_comment_url":"https://api.github.com/repos/osuosl/pymesync/pulls/comments{/number}","comments_url":"https://api.github.com/repos/osuosl/pymesync/issues/54/comments","statuses_url":"https://api.github.com/repos/osuosl/pymesync/statuses/d7e364e7cc94a7879db3702cabff4452a3109d78","head":{"label":"osuosl:mrsj/documentation-refactor","ref":"mrsj/documentation-refactor","sha":"d7e364e7cc94a7879db3702cabff4452a3109d78","user":{"login":"osuosl","id":1380625,"avatar_url":"https://avatars.githubusercontent.com/u/1380625?v=3","gravatar_id":"","url":"https://api.github.com/users/osuosl","html_url":"https://github.com/osuosl","followers_url":"https://api.github.com/users/osuosl/followers","following_url":"https://api.github.com/users/osuosl/following{/other_user}","gists_url":"https://api.github.com/users/osuosl/gists{/gist_id}","starred_url":"https://api.github.com/users/osuosl/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/osuosl/subscriptions","organizations_url":"https://api.github.com/users/osuosl/orgs","repos_url":"https://api.github.com/users/osuosl/repos","events_url":"https://api.github.com/users/osuosl/events{/privacy}","received_events_url":"https://api.github.com/users/osuosl/received_events","type":"Organization","site_admin":false},"repo":{"id":44197569,"name":"pymesync","full_name":"osuosl/pymesync","owner":{"login":"osuosl","id":1380625,"avatar_url":"https://avatars.githubusercontent.com/u/1380625?v=3","gravatar_id":"","url":"https://api.github.com/users/osuosl","html_url":"https://github.com/osuosl","followers_url":"https://api.github.com/users/osuosl/followers","following_url":"https://api.github.com/users/osuosl/following{/other_user}","gists_url":"https://api.github.com/users/osuosl/gists{/gist_id}","starred_url":"https://api.github.com/users/osuosl/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/osuosl/subscriptions","organizations_url":"https://api.github.com/users/osuosl/orgs","repos_url":"https://api.github.com/users/osuosl/repos","events_url":"https://api.github.com/users/osuosl/events{/privacy}","received_events_url":"https://api.github.com/users/osuosl/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/osuosl/pymesync","description":"Python module to interface with the TimeSync API","fork":false,"url":"https://api.github.com/repos/osuosl/pymesync","forks_url":"https://api.github.com/repos/osuosl/pymesync/forks","keys_url":"https://api.github.com/repos/osuosl/pymesync/keys{/key_id}","collaborators_url":"https://api.github.com/repos/osuosl/pymesync/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/osuosl/pymesync/teams","hooks_url":"https://api.github.com/repos/osuosl/pymesync/hooks","issue_events_url":"https://api.github.com/repos/osuosl/pymesync/issues/events{/number}","events_url":"https://api.github.com/repos/osuosl/pymesync/events","assignees_url":"https://api.github.com/repos/osuosl/pymesync/assignees{/user}","branches_url":"https://api.github.com/repos/osuosl/pymesync/branches{/branch}","tags_url":"https://api.github.com/repos/osuosl/pymesync/tags","blobs_url":"https://api.github.com/repos/osuosl/pymesync/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/osuosl/pymesync/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/osuosl/pymesync/git/refs{/sha}","trees_url":"https://api.github.com/repos/osuosl/pymesync/git/trees{/sha}","statuses_url":"https://api.github.com/repos/osuosl/pymesync/statuses/{sha}","languages_url":"https://api.github.com/repos/osuosl/pymesync/languages","stargazers_url":"https://api.github.com/repos/osuosl/pymesync/stargazers","contributors_url":"https://api.github.com/repos/osuosl/pymesync/contributors","subscribers_url":"https://api.github.com/repos/osuosl/pymesync/subscribers","subscription_url":"https://api.github.com/repos/osuosl/pymesync/subscription","commits_url":"https://api.github.com/repos/osuosl/pymesync/commits{/sha}","git_commits_url":"https://api.github.com/repos/osuosl/pymesync/git/commits{/sha}","comments_url":"https://api.github.com/repos/osuosl/pymesync/comments{/number}","issue_comment_url":"https://api.github.com/repos/osuosl/pymesync/issues/comments{/number}","contents_url":"https://api.github.com/repos/osuosl/pymesync/contents/{+path}","compare_url":"https://api.github.com/repos/osuosl/pymesync/compare/{base}...{head}","merges_url":"https://api.github.com/repos/osuosl/pymesync/merges","archive_url":"https://api.github.com/repos/osuosl/pymesync/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/osuosl/pymesync/downloads","issues_url":"https://api.github.com/repos/osuosl/pymesync/issues{/number}","pulls_url":"https://api.github.com/repos/osuosl/pymesync/pulls{/number}","milestones_url":"https://api.github.com/repos/osuosl/pymesync/milestones{/number}","notifications_url":"https://api.github.com/repos/osuosl/pymesync/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/osuosl/pymesync/labels{/name}","releases_url":"https://api.github.com/repos/osuosl/pymesync/releases{/id}","created_at":"2015-10-13T18:50:03Z","updated_at":"2015-10-23T20:52:41Z","pushed_at":"2015-12-11T21:51:06Z","git_url":"git://github.com/osuosl/pymesync.git","ssh_url":"git@github.com:osuosl/pymesync.git","clone_url":"https://github.com/osuosl/pymesync.git","svn_url":"https://github.com/osuosl/pymesync","homepage":null,"size":939,"stargazers_count":0,"watchers_count":0,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":9,"forks":0,"open_issues":9,"watchers":0,"default_branch":"develop"}},"base":{"label":"osuosl:develop","ref":"develop","sha":"8609d5c4d6218cd1a2238bf1b2b3fad114cdcf21","user":{"login":"osuosl","id":1380625,"avatar_url":"https://avatars.githubusercontent.com/u/1380625?v=3","gravatar_id":"","url":"https://api.github.com/users/osuosl","html_url":"https://github.com/osuosl","followers_url":"https://api.github.com/users/osuosl/followers","following_url":"https://api.github.com/users/osuosl/following{/other_user}","gists_url":"https://api.github.com/users/osuosl/gists{/gist_id}","starred_url":"https://api.github.com/users/osuosl/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/osuosl/subscriptions","organizations_url":"https://api.github.com/users/osuosl/orgs","repos_url":"https://api.github.com/users/osuosl/repos","events_url":"https://api.github.com/users/osuosl/events{/privacy}","received_events_url":"https://api.github.com/users/osuosl/received_events","type":"Organization","site_admin":false},"repo":{"id":44197569,"name":"pymesync","full_name":"osuosl/pymesync","owner":{"login":"osuosl","id":1380625,"avatar_url":"https://avatars.githubusercontent.com/u/1380625?v=3","gravatar_id":"","url":"https://api.github.com/users/osuosl","html_url":"https://github.com/osuosl","followers_url":"https://api.github.com/users/osuosl/followers","following_url":"https://api.github.com/users/osuosl/following{/other_user}","gists_url":"https://api.github.com/users/osuosl/gists{/gist_id}","starred_url":"https://api.github.com/users/osuosl/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/osuosl/subscriptions","organizations_url":"https://api.github.com/users/osuosl/orgs","repos_url":"https://api.github.com/users/osuosl/repos","events_url":"https://api.github.com/users/osuosl/events{/privacy}","received_events_url":"https://api.github.com/users/osuosl/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/osuosl/pymesync","description":"Python module to interface with the TimeSync API","fork":false,"url":"https://api.github.com/repos/osuosl/pymesync","forks_url":"https://api.github.com/repos/osuosl/pymesync/forks","keys_url":"https://api.github.com/repos/osuosl/pymesync/keys{/key_id}","collaborators_url":"https://api.github.com/repos/osuosl/pymesync/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/osuosl/pymesync/teams","hooks_url":"https://api.github.com/repos/osuosl/pymesync/hooks","issue_events_url":"https://api.github.com/repos/osuosl/pymesync/issues/events{/number}","events_url":"https://api.github.com/repos/osuosl/pymesync/events","assignees_url":"https://api.github.com/repos/osuosl/pymesync/assignees{/user}","branches_url":"https://api.github.com/repos/osuosl/pymesync/branches{/branch}","tags_url":"https://api.github.com/repos/osuosl/pymesync/tags","blobs_url":"https://api.github.com/repos/osuosl/pymesync/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/osuosl/pymesync/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/osuosl/pymesync/git/refs{/sha}","trees_url":"https://api.github.com/repos/osuosl/pymesync/git/trees{/sha}","statuses_url":"https://api.github.com/repos/osuosl/pymesync/statuses/{sha}","languages_url":"https://api.github.com/repos/osuosl/pymesync/languages","stargazers_url":"https://api.github.com/repos/osuosl/pymesync/stargazers","contributors_url":"https://api.github.com/repos/osuosl/pymesync/contributors","subscribers_url":"https://api.github.com/repos/osuosl/pymesync/subscribers","subscription_url":"https://api.github.com/repos/osuosl/pymesync/subscription","commits_url":"https://api.github.com/repos/osuosl/pymesync/commits{/sha}","git_commits_url":"https://api.github.com/repos/osuosl/pymesync/git/commits{/sha}","comments_url":"https://api.github.com/repos/osuosl/pymesync/comments{/number}","issue_comment_url":"https://api.github.com/repos/osuosl/pymesync/issues/comments{/number}","contents_url":"https://api.github.com/repos/osuosl/pymesync/contents/{+path}","compare_url":"https://api.github.com/repos/osuosl/pymesync/compare/{base}...{head}","merges_url":"https://api.github.com/repos/osuosl/pymesync/merges","archive_url":"https://api.github.com/repos/osuosl/pymesync/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/osuosl/pymesync/downloads","issues_url":"https://api.github.com/repos/osuosl/pymesync/issues{/number}","pulls_url":"https://api.github.com/repos/osuosl/pymesync/pulls{/number}","milestones_url":"https://api.github.com/repos/osuosl/pymesync/milestones{/number}","notifications_url":"https://api.github.com/repos/osuosl/pymesync/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/osuosl/pymesync/labels{/name}","releases_url":"https://api.github.com/repos/osuosl/pymesync/releases{/id}","created_at":"2015-10-13T18:50:03Z","updated_at":"2015-10-23T20:52:41Z","pushed_at":"2015-12-11T21:51:06Z","git_url":"git://github.com/osuosl/pymesync.git","ssh_url":"git@github.com:osuosl/pymesync.git","clone_url":"https://github.com/osuosl/pymesync.git","svn_url":"https://github.com/osuosl/pymesync","homepage":null,"size":939,"stargazers_count":0,"watchers_count":0,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":9,"forks":0,"open_issues":9,"watchers":0,"default_branch":"develop"}},"_links":{"self":{"href":"https://api.github.com/repos/osuosl/pymesync/pulls/54"},"html":{"href":"https://github.com/osuosl/pymesync/pull/54"},"issue":{"href":"https://api.github.com/repos/osuosl/pymesync/issues/54"},"comments":{"href":"https://api.github.com/repos/osuosl/pymesync/issues/54/comments"},"review_comments":{"href":"https://api.github.com/repos/osuosl/pymesync/pulls/54/comments"},"review_comment":{"href":"https://api.github.com/repos/osuosl/pymesync/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/osuosl/pymesync/pulls/54/commits"},"statuses":{"href":"https://api.github.com/repos/osuosl/pymesync/statuses/d7e364e7cc94a7879db3702cabff4452a3109d78"}}}}