Initial commit

Author: Juan Rossi

.gitignore

@@ -0,0 +1 @@
+*.pyc

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Mango
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.rst

@@ -0,0 +1,116 @@
+PyMango
+=======
+
+This is a Python library that allows interaction with `Mango API <https://developers.getmango.com/en/api/?platform=python>`_.
+
+
+Install
+=======
+
+You can get the library from our GitHub account and copy the ``pymango`` folder into your project::
+
+    $ git clone https://github.com/Mango/mango-python.git
+
+If you want to use ``pip``, you can point it directly into the repository::
+
+    $ pip install -e https://github.com/Mango/mango-python.git#egg=pymango
+
+We are working out to include ``pymango`` into `PyPI <https://pypi.python.org/pypi>`_.
+
+
+Documentation
+=============
+
+Documentation is available at https://developers.getmango.com/en/api/?platform=python
+
+Usage
+=====
+
+Import the library and set your secret API key::
+
+    >>> import pymango as mango
+    >>> mango.api_key = "your Mango secret API key"
+
+
+Create a charge
+---------------
+
+In order to create a Charge, you must call the ``create()`` method with
+the required arguments (see `API documentation <https://developers.getmango.com/en/api/charges/?platform=python#arguments>`_)::
+
+    >>> charge = mango.Charges.create(amount=2000, email="[email protected]", token="token_mwhushs06o62aruq9n3pmvu7f0ia696y")
+    >>> print charge.get("uid")
+    charge_72t1r7vmb9pknrl4otg6xy3wrkwrrpzt
+    >>> print charge.get("paid")
+    True
+
+
+Get single Charge
+-----------------
+
+When you have a Charge ``uid``, you can get a full detail using the ``get()`` method::
+
+    >>> mango.Charges.get("charge_72t1r7vmb9pknrl4otg6xy3wrkwrrpzt")
+    {
+        u'customer': u'',
+        u'deposit_eta': u'2013-04-09',
+        u'queue_uid': u'',
+        u'fee': 12,
+        u'annual_interest_pct': u'',
+        u'refunded': False,
+        u'created_at': u'2013-09-04 20:23:28',
+        u'live': False,
+        u'amount_gross': 1212,
+        u'paid': False,
+        u'failure_message': u'',
+        u'origin': u'api',
+        u'amount': 1212,
+        u'installments': 1,
+        u'plastic': {
+            u'last4': u'4242',
+            u'exp_year': 2015,
+            u'exp_month': 11,
+            u'type': u'visa',
+            u'holdername': u'Test Test'
+        },
+        u'uid': u'charge_72t1r7vmb9pknrl4otg6xy3wrkwrrpzt',
+        u'email': u'[email protected]',
+        u'card': u'',
+        u'description': u''
+    }
+
+You can also work with all the other resources authenticated with a secret API Key:
+
+* `Charges <https://developers.getmango.com/en/api/charges/?platform=python>`_
+* `Refunds <https://developers.getmango.com/en/api/refunds/?platform=python>`_
+* `Customers <https://developers.getmango.com/en/api/customers/?platform=python>`_
+* `Cards <https://developers.getmango.com/en/api/cards/?platform=python>`_
+* `Queue <https://developers.getmango.com/en/api/queue/?platform=python>`_
+* `Installments <https://developers.getmango.com/en/api/installments/?platform=python>`_
+
+
+Tests
+=====
+
+Install testing dependencies::
+
+    $ pip install nose
+
+To run the tests you'll need Mango API keys (mode Sandbox)::
+
+    $ export MANGO_SECRET_TEST_KEY=secret_test_qawsedrftgyhujikolp
+    $ export MANGO_PUBLIC_TEST_KEY=public_test_aqswdefrgthyjukilon
+
+
+Run the tests
+-------------
+
+Use ``nosetests`` to run the complete tests suite::
+
+    $ nosetests pymango/tests/
+
+
+License
+=======
+
+`MIT <http://opensource.org/licenses/MIT>`_, see LICENSE file.

pymango/__init__.py

@@ -0,0 +1,13 @@
+"""
+Mango Python Library
+"""
+from resources import Charge as Charges
+from resources import Refund as Refunds
+from resources import Customer as Customers
+from resources import Card as Cards
+from resources import Queue
+from resources import Installment as Installments
+
+api_key = ""
+version = 1
+

pymango/client.py

@@ -0,0 +1,89 @@
+"""
+Mango Python Library Client
+"""
+import json
+
+import requests
+from requests.exceptions import ConnectionError
+
+from .error import UnableToConnect, AuthenticationError, NotFound, \
+    InputValidationError, InputValidationGenericError, \
+    UnhandledError, MethodNotAllowed
+
+
+BASE_URL = "https://api.getmango.com"
+HEADERS = {"content-type": "application/json"}
+
+
+def req(api_key, method, endpoint, data=None, params=None):
+    """
+    Make request and return a Python object from the JSON response. If
+    HTTP method is DELETE return True for 204 response, false otherwise.
+
+    :param api_key: String with the API key
+    :param method: String with the HTTP method
+    :param endpoint: String with the URL
+    :param data: Dictionary with data that will be sent
+    :param params: Dictionary with query strings
+    :return: Native python object resulting of the JSON deserialization of the API response
+    """
+    if data:
+        data = json.dumps(data)
+
+    try:
+        response = requests.request(
+            method,
+            build_url(endpoint),
+            data=data,
+            params=params,
+            auth=(api_key, ""),
+            headers=HEADERS
+        )
+    except ConnectionError:
+        raise UnableToConnect
+
+    # Success
+    if 200 <= response.status_code <= 206:
+        if response.request.method == "DELETE":
+            return response.status_code == 204 or response.status_code == 200
+
+        return response.json()
+
+    # Error handling
+    if response.status_code == 400:
+        try:
+            input_validation_error = response.json()
+            errors = input_validation_error.get("errors")[0]
+            error_code, error_message = errors.items()[0]
+        except:
+            raise InputValidationGenericError("{status_code}: {text}".format(
+                status_code=response.status_code,
+                text=response.text
+            ))
+        raise InputValidationError(error_code, error_message)
+    elif response.status_code == 404:
+        raise NotFound
+    elif response.status_code == 401:
+        raise AuthenticationError
+    elif response.status_code == 404:
+        raise NotFound
+    elif response.status_code == 405:
+        raise MethodNotAllowed
+
+    raise UnhandledError("{status_code}: {text}".format(
+        status_code=response.status_code,
+        text=response.text
+    ))
+
+
+def build_url(endpoint):
+    """
+    Build complete URL from API endpoint
+
+    :param endpoint: String with the endpoint, ex: /v1/charges/
+    :return: String with complete URL, ex: https://api.getmango.com/v1/charges/
+    """
+    return "{base_url}/{endpoint}".format(
+        base_url=BASE_URL,
+        endpoint=endpoint
+    )

pymango/error.py

@@ -0,0 +1,56 @@
+"""
+Mango Library Exceptions
+"""
+
+
+class MangoException(Exception):
+    """Base exception"""
+    pass
+
+
+class InvalidApiKey(MangoException):
+    """Invalid API Key"""
+    pass
+
+
+class UnableToConnect(MangoException):
+    """Unable to connect into Mango API"""
+    pass
+
+
+class NotFound(MangoException):
+    """Resource not found"""
+    pass
+
+
+class MethodNotAllowed(MangoException):
+    """Method not allowed"""
+    pass
+
+
+class AuthenticationError(MangoException):
+    """Authentication error"""
+    pass
+
+
+class UnhandledError(MangoException):
+    """Unhandled error"""
+    pass
+
+
+class InputValidationError(MangoException):
+    """Input validation error"""
+    def __init__(self, error_code, error_message):
+        self.code = error_code
+        self.message = error_message
+
+    def __str__(self):
+        return repr("{code}: {message}".format(
+            code=self.code,
+            message=self.message
+        ))
+
+
+class InputValidationGenericError(MangoException):
+    """Input validation generic error"""
+    pass