Add ability to look up a single mls number

Author: kevin1024

README.md

@@ -67,6 +67,16 @@ evernetpy.get_all_active_mls_numbers(username, password)
 
 This gives you an iterator with all the active MLS numbers in it.
 
+## Get a single property by mls_number
+
+```python
+import evernetpy
+
+evernetpy.get_property(username, password, mls_number)
+```
+
+Returns a dictionary with the information from a single MLS number.  Looks up all the data for the lookup fields for you behind the scenes.
+
 ## Get Photos
 
 Call this with the listing ID and you get an iterator with photos in it.  Each photo is a dictionary with some metadata about the photo.  The BLOB key has the binary of the actual photo.
@@ -96,6 +106,7 @@ logging.getLogger().setLevel(logging.INFO)
 
 # Changelog
 
+* 2.1.0: Add the ability to grab a single listing by MLS number
 * 2.0.3: It turns out that Evernet assumes you only want 'RESI' properties if you don't explicitly specify, so let's do so.
 * 2.0.2: Fixed a bug where items were not being filtered on in the `get_all_active_listings` method
 * 2.0.1: Fixed a bug where status wasn't being filtered correctly

evernetpy/__init__.py

@@ -39,3 +39,14 @@ def get_photos(username, password, listing_id):
         out = dict([(c.tag.replace('{NWMLS:EverNet:ImageData:1.0}', ''), c.text) for c in row.getchildren()])
         out['BLOB'] = base64.b64decode(out['BLOB'])
         yield out
+
+def get_property(username, password, mls_number):
+    criteria = {
+        'MLS':'nwmls',
+        'ListingNumber':mls_number
+    }
+    results = execute_listing_query(username, password, 'RetrieveListingData', criteria)
+    first_result = next(results) # only return first match
+    out = dict([(c.tag.replace('{http://www.nwmls.com/Schemas/Standard/StandardXML1_2.xsd}', ''), c.text) for c in first_result.getchildren()])
+    return look_up_all_fields(username, password, out)
+

setup.py

@@ -19,7 +19,7 @@ def run_tests(self):
         sys.exit(errno)
 
 setup(name='evernetpy',
-      version='2.0.3',
+      version='2.1.0',
       description="A Python library for interacting with the EverNet listing service",
       author='Kevin McCarthy',
       author_email='[email protected]',

tests/integration/test_property_pull.py

@@ -1,4 +1,4 @@
-from evernetpy import get_new_listings, get_all_active_mls_numbers, get_photos, get_new_listings
+from evernetpy import get_new_listings, get_all_active_mls_numbers, get_photos, get_new_listings, get_property
 from os import environ
 import logging
 
@@ -32,3 +32,9 @@ def test_get_all_active_mls_numbers():
 def test_get_photos():
     results = get_photos(username, password, 81796)
     assert len([r for r in results])
+
+def test_get_property():
+    property = get_property(username, password, '611638')
+    # note: this must be an active mls number, if this test stats failing,
+    # try changing it :)
+    assert property