Add users.current endpoint to v2 api.

Author: theengineear

plotly/api/v2/__init__.py

@@ -1,3 +1,4 @@
 from __future__ import absolute_import
 
-from plotly.api.v2 import files, folders, grids, images, plot_schema, plots
+from plotly.api.v2 import (files, folders, grids, images, plot_schema, plots,
+                           users)

plotly/api/v2/users.py

@@ -0,0 +1,17 @@
+"""Interface to Plotly's /v2/files endpoints."""
+from __future__ import absolute_import
+
+from plotly.api.v2.utils import build_url, request
+
+RESOURCE = 'users'
+
+
+def current():
+    """
+    Retrieve information on the logged-in user from Plotly.
+
+    :returns: (requests.Response) Returns response directly from requests.
+
+    """
+    url = build_url(RESOURCE, route='current')
+    return request('get', url)

plotly/tests/test_core/test_api/test_v2/test_users.py

@@ -0,0 +1,28 @@
+from __future__ import absolute_import
+
+from plotly.api.v2 import users
+from plotly.tests.test_core.test_api import PlotlyApiTestCase
+
+
+class UsersTest(PlotlyApiTestCase):
+
+    def setUp(self):
+        super(UsersTest, self).setUp()
+
+        # Mock the actual api call, we don't want to do network tests here.
+        self.request_mock = self.mock('plotly.api.v2.utils.requests.request')
+        self.request_mock.return_value = self.get_response()
+
+        # Mock the validation function since we can test that elsewhere.
+        self.mock('plotly.api.v2.utils.validate_response')
+
+    def test_current(self):
+        users.current()
+        self.request_mock.assert_called_once()
+        args, kwargs = self.request_mock.call_args
+        method, url = args
+        self.assertEqual(method, 'get')
+        self.assertEqual(
+            url, '{}/v2/users/current'.format(self.plotly_api_domain)
+        )
+        self.assertNotIn('params', kwargs)