Merge pull request #41 from Qwoyn/master

Created client.ropsten.py.  Merged despite comment from @AndreMiras, this can be refactored, rather have the functionality first.  I do agree that your solution was an easier method.

Author: corpetty

README.md

@@ -7,7 +7,8 @@ EtherScan.io API python bindings
 
 ## Description
 This module is written as an effort to provide python bindings to the EtherScan.io API, which can be found at: 
-https://etherscan.io/apis
+https://etherscan.io/apis. If you are interacting with a contract on the Ropsten Testnet please use 
+https://ropsten.etherscan.io/apis. 
 In order to use this, you must attain an Etherscan user account, and generate an API key.
 
 In order to use the API, you must provide an API key at runtime, which can be found at the Etherscan.io API website.
@@ -22,6 +23,7 @@ with `YourApiKeyToken` is your provided API key token from EtherScan.io
 To install the package to your computer, simply run the following command in the base directory:
 
     python setup.py install
+	
 
 ## Available bindings
 Currently, only the following Etherscan.io API modules are available:

etherscan/client.ropsten.py

@@ -0,0 +1,132 @@
+# coding: utf-8
+import collections
+
+import requests
+
+
+class ClientException(Exception):
+    """Unhandled API client exception"""
+    message = 'unhandled error'
+
+    def __init__(self, message=None):
+        if message is not None:
+            self.message = message
+
+    def __unicode__(self):
+        return u'<Err: {0.message}>'.format(self)
+
+    __str__ = __unicode__
+
+
+class ConnectionRefused(ClientException):
+    """Connection refused by remote host"""
+
+
+class EmptyResponse(ClientException):
+    """Empty response from API"""
+
+
+class BadRequest(ClientException):
+    """Invalid request passed"""
+
+
+#  Assume user puts his API key in the api_key.json file under variable name "key"
+class Client(object):
+    dao_address = '0xbb9bc244d798123fde783fcc1c72d3bb8c189413'
+
+    # Constants
+    PREFIX = 'https://api-ropsten.etherscan.io/api?'  # TESTNET 
+    MODULE = 'module='
+    ACTION = '&action='
+    CONTRACT_ADDRESS = '&contractaddress='
+    ADDRESS = '&address='
+    OFFSET = '&offset='
+    PAGE = '&page='
+    SORT = '&sort='
+    BLOCK_TYPE = '&blocktype='
+    TO = '&to='
+    VALUE = '&value='
+    DATA = '&data='
+    POSITION = '&='
+    HEX = '&hex='
+    GAS_PRICE = '&gasPrice='
+    GAS = '&gas='
+    START_BLOCK = '&startblock='
+    END_BLOCK = '&endblock='
+    BLOCKNO = '&blockno='
+    TXHASH = '&txhash='
+    TAG = '&tag='
+    BOOLEAN = '&boolean='
+    INDEX = '&index='
+    API_KEY = '&apikey='
+
+    url_dict = {}
+
+    def __init__(self, address, api_key=''):
+        self.http = requests.session()
+        self.url_dict = collections.OrderedDict([
+
+            (self.MODULE, ''),
+            (self.ADDRESS, ''),
+            (self.OFFSET, ''),
+            (self.PAGE, ''),
+            (self.SORT, ''),
+            (self.BLOCK_TYPE, ''),
+            (self.TO, ''),
+            (self.VALUE, ''),
+            (self.DATA, ''),
+            (self.POSITION, ''),
+            (self.HEX, ''),
+            (self.GAS_PRICE, ''),
+            (self.GAS, ''),
+            (self.START_BLOCK, ''),
+            (self.END_BLOCK, ''),
+            (self.BLOCKNO, ''),
+            (self.TXHASH, ''),
+            (self.TAG, ''),
+            (self.BOOLEAN, ''),
+            (self.INDEX, ''),
+            (self.API_KEY, api_key)]
+        )
+
+        # self.url_dict[API_KEY] = str(api_key)
+        self.check_and_get_api()
+        # self.key = self.URL_BASES['key'] + self.API_KEY
+
+        if (len(address) > 20) and (type(address) == list):
+            raise BadRequest("Etherscan only takes 20 addresses at a time")
+        elif (type(address) == list) and (len(address) <= 20):
+            self.url_dict[self.ADDRESS] = ','.join(address)
+        else:
+            self.url_dict[self.ADDRESS] = address
+
+    def build_url(self):
+        self.url = self.PREFIX + ''.join([param + val if val else '' for param, val in self.url_dict.items()])
+
+    def connect(self):
+        # TODO: deal with "unknown exception" error
+        try:
+            req = self.http.get(self.url)
+        except requests.exceptions.ConnectionError:
+            raise ConnectionRefused
+
+        if req.status_code == 200:
+            # Check for empty response
+            if req.text:
+                data = req.json()
+                status = data.get('status')
+                if status == '1' or self.check_keys_api(data):
+                    return data
+                else:
+                    raise EmptyResponse(data.get('message', 'no message'))
+        raise BadRequest("Problem with connection, status code: %s" % req.status_code)
+
+    def check_and_get_api(self):
+        if self.url_dict[self.API_KEY]:  # Check if api_key is empty string
+            pass
+        else:
+            self.url_dict[self.API_KEY] = input('Please type your EtherScan.io API key: ')
+
+    def check_keys_api(self, data):
+        return all (k in data for k in ('jsonrpc', 'id', 'result'))
+