new version of wrapper

Author: pplonski

README.rst

@@ -1,4 +1,71 @@
 mljar-api-python
 ================
 
-This is a python wrapper over MLJAR API.
+A simple python wrapper over mljar API. It allows MLJAR users to create
+Machine Learning models with few lines of code:
+
+.. code:: python
+
+    import mljar
+
+    model = Mljar(project='My awesome project', experiment='First experiment')
+    model.fit(X,y)
+
+    model.predict(X)
+
+That's all folks! Yeah, I know, this makes Machine Learning super easy!
+You can use this code for following Machine Learning tasks: \* Binary
+classification (your target has only two unique values) \* Regression
+(your target value is continuous) \* More is coming soon!
+
+How to install
+--------------
+
+You can install mljar with **pip**:
+
+::
+
+    pip install -U mljar
+
+or from source code:
+
+::
+
+    python setup.py install
+
+How to use it
+-------------
+
+1. Create an account at mljar.com and login.
+2. Please go to your users settings (top, right corner).
+3. Get your token, for example 'exampleexampleexample'.
+4. Set environment variable ``MLJAR_TOKEN`` with your token value:
+
+   ::
+
+       export MLJAR_TOKEN=exampleexampleexample
+
+5. That's all, you are ready to use MLJAR in your python code!
+
+What's going on?
+----------------
+
+-  This wrapper allows you to search through different Machine Learning
+   algorithms and tune each of the algorithm.
+-  By searching and tuning ML algorithm to your data you will get very
+   accurate model.
+-  By calling method ``fit`` from ``Mljar class`` you create new project
+   and start experiment with models training. All your results will be
+   accessible from your mljar.com account - this makes Machine Learning
+   super easy and keeps all your models and results in beautiful order.
+   So, you will never miss anything.
+-  All computations are done in MLJAR Cloud, they are executed in
+   parallel. So after callgin ``fit`` method you can switch your
+   computer off and MLJAR will do the job for you!
+-  I think this is really amazing! What do you think? Please let us know
+   at ``contact@mljar.com``.
+
+Examples
+--------
+
+Coming soon!

mljar/__init__.py

@@ -0,0 +1,5 @@
+
+API_VERSION = 'v1'
+MLJAR_ENDPOINT = 'http://0.0.0.0:3000/api'
+
+from mljar import Mljar

mljar/client.py

@@ -0,0 +1,135 @@
+import os
+import json, requests
+
+from .. import API_VERSION, MLJAR_ENDPOINT
+from ..exceptions import MljarException, TokenException, DataReadException, BadRequestException
+from ..exceptions import JSONReadException, NotFoundException, AuthenticationException
+
+
+from ..log import logger
+
+class MljarHttpClient(object):
+    '''
+        Mljar Client for HTTP Requests.
+    '''
+
+    def __init__(self):
+        self.TOKEN = os.environ.get('MLJAR_TOKEN', None)
+        if not self.TOKEN:
+            raise TokenException('Please define environment variable MLJAR_TOKEN. \
+                                You can get you MLJAR token by login to mljar.com account. \
+                                It is available in your settings.')
+
+        self.base_url = '/'.join([MLJAR_ENDPOINT, API_VERSION])
+
+    def request(self, method, url, data=None, with_header=True, url_outside_mljar=False, parse_json=True):
+        """
+        Execute the request using requests library.
+        """
+        if url_outside_mljar:
+            request_url = url
+        else:
+            request_url = self.base_url + url
+        logger.debug("Starting request to url: {} with data: {}".format(request_url, data))
+
+        headers = {'Authorization': 'Token '+self.TOKEN }
+        if with_header:
+            response = requests.request(method, request_url, headers=headers, data=data)
+        else:
+            response = requests.request(method, request_url, data=data)
+
+        if parse_json:
+            try:
+                if response.status_code != 204:
+                    logger.debug("Response content: {}, headers: {}".format(response.json(), response.headers))
+            except Exception as e:
+                logger.error("Request failed: {} {}".format(response.content, str(e)))
+        self._check_response_status(response)
+        return response
+
+    def _check_response_status(self, response):
+        """
+        Check if response is successful else raise Exception.
+        """
+        if not (200 <= response.status_code < 300):
+            try:
+                message = response.json()["errors"]
+            except Exception:
+                message = None
+            logger.debug("Error received : status_code: {}, message: {}".format(response.status_code,
+                                                                                      message or response.content))
+
+            if response.status_code == 401:
+                raise AuthenticationException()
+            elif response.status_code == 404:
+                raise NotFoundException()
+            elif response.status_code == 400:
+                raise BadRequestException()
+            else:
+                response.raise_for_status()
+
+
+'''
+def _get_data(self, response):
+    if response is None:
+        return None
+
+    try:
+        data = response.json()
+    except ValueError as e:
+        raise JSONReadException('Get data failed, %s' % str(e) )
+
+    if not response.ok:
+        msg = [data[m] for m in ("id", "message") if m in data][1]
+        raise DataReadException(msg)
+
+    return data
+'''
+
+'''
+
+        self._urls = {
+            'project':      '/'.join([self.API_ENDPOINT, API_VERSION, 'projects']),
+            'dataset':      '/'.join([self.API_ENDPOINT, API_VERSION, 'datasets']),
+            'experiment':   '/'.join([self.API_ENDPOINT, API_VERSION, 'experiments']),
+            'result':       '/'.join([self.API_ENDPOINT, API_VERSION, 'results/']),
+            'predict':      '/'.join([self.API_ENDPOINT, API_VERSION, 'predict/']),
+            'predictions':  '/'.join([self.API_ENDPOINT, API_VERSION, 'predictions']), # it is not a bug, we don't need here '/'
+            'download_prediction': '/'.join([self.API_ENDPOINT, API_VERSION, 'download/prediction/']),
+            's3policy':     '/'.join([self.API_ENDPOINT, API_VERSION, 's3policy/']),
+            'accept_column_usage': '/'.join([self.API_ENDPOINT, API_VERSION, 'accept_column_usage/']),
+        }
+
+
+    def _make_request(self, url_name = '', custom_url = '', request_type = 'get', url_additional = '', input_json = {}, with_header = True):
+        try:
+            response = None
+            headers = {'Authorization': 'Token '+self.TOKEN } #'Content-Type': 'application/json'
+            my_url = ''
+            if url_name in self._urls:
+            if my_url == '':
+                raise Exception('Wrong URL address')
+            if url_additional != '':
+                my_url += url_additional
+
+            #print 'request', my_url, request_type, input_json, with_header, headers
+
+            if request_type == 'get':
+                response = requests.get(my_url, headers=headers)
+            elif request_type == 'post':
+                if with_header:
+                    response = requests.post(my_url, data=input_json, headers=headers)
+                else:
+                    response = requests.post(my_url, data=input_json)
+            elif request_type == 'put':
+                if with_header:
+                    print my_url, 'with header', input_json
+                    response = requests.put(my_url, data=input_json, headers=headers)
+                else:
+                    response = requests.put(my_url, data=input_json)
+
+        except MljarException as e:
+            print 'There was an error during API call, %s' % str(e)
+        finally:
+            return response
+'''