Merge pull request #70 from Kinto/add-server-info-method

Add a server info method

Author: Natim

README.rst

@@ -82,6 +82,20 @@ at creation time, so that this value will be used by default.
     client = Client(bucket="payments", collection="receipts", auth=auth)
 
 
+Getting server information
+--------------------------
+
+You can use the ``server_info`` methods to get the server information::
+
+.. code-block:: python
+
+    from kinto_client import Client
+
+    client = Client(server_url='http://localhost:8888/v1')
+    infos = client.server_info()
+    assert 'schema' in infos['capabilities'], "Server doesn't supports schema validation."
+
+
 Handling buckets
 ----------------
 

kinto_client/__init__.py

@@ -148,6 +148,13 @@ def _create_if_not_exists(self, resource, **kwargs):
             get_method = getattr(self, 'get_%s' % resource)
             return get_method(**get_kwargs)
 
+    # Server Info
+
+    def server_info(self):
+        endpoint = self._get_endpoint('root')
+        resp, _ = self.session.request('get', endpoint)
+        return resp
+
     # Buckets
 
     def create_bucket(self, bucket=None, data=None, permissions=None,

kinto_client/tests/test_client.py

@@ -12,6 +12,10 @@ def setUp(self):
         self.client = Client(session=self.session)
         mock_response(self.session)
 
+    def test_server_info(self):
+        self.client.server_info()
+        self.session.request.assert_called_with('get', '/')
+
     def test_context_manager_works_as_expected(self):
         settings = {"batch_max_requests": 25}
         self.session.request.side_effect = [({"settings": settings}, []),