feat(us-autocompletions): add USAutocompletions

README.md

@@ -91,6 +91,10 @@ There are simple scripts to demonstrate how to create all the core Lob objects (
     - [Verify a US Address](https://lob.com/docs/python#us_verifications_create)
     - [The US ZIP Lookup Object](https://lob.com/docs/python#us_zip_lookups_object)
     - [Lookup a US ZIP Code](https://lob.com/docs/python#us_zip_lookups_create)
+  - [US Autocompletion API](https://lob.com/docs/python#us_autocompletions)
+    - [The US Autocompletion Object](https://lob.com/docs/python#us_autocompletions_object)
+    - [Autocomplete a US Address](https://lob.com/docs/python#us_autocompletions_create)
+    - [The US Autocompletion Test Environment](https://lob.com/docs/python#us-autocompletions-test-environment)
 - **Int'l Verification API**
   - [International Verifications](https://lob.com/docs/python#intl_verifications)
     - [Verify an International Address](https://lob.com/docs/python#intl_verifications_create)

lob/__init__.py

@@ -1,6 +1,7 @@
 # Resources
 from lob.resource import (Address, Area, BankAccount, Check, Letter, Postcard,
-                          Route, USVerification, USZipLookup, IntlVerification)
+                          Route, USAutocompletion, USVerification, USZipLookup,
+                          IntlVerification)
 
 from lob.version import VERSION
 

lob/resource.py

@@ -203,6 +203,10 @@ class Route(ListableAPIResource):
     endpoint = '/routes'
 
 
+class USAutocompletion(CreateableAPIResource):
+    endpoint = '/us_autocompletions'
+
+
 class USVerification(CreateableAPIResource):
     endpoint = '/us_verifications'
 

tests/test_us_autocompletion.py

@@ -0,0 +1,17 @@
+import unittest
+import lob
+
+
+class TestUSAutocompletionFunctions(unittest.TestCase):
+    def setUp(self):
+        lob.api_key = 'test_fc26575412e92e22a926bc96c857f375f8b'
+
+    def test_us_autocompletion(self):
+        autocompletion = lob.USAutocompletion.create(
+            address_prefix='185 BER',
+            city='SAN FRANCISCO',
+            state='CA'
+        )
+
+        self.assertIn('suggestions', autocompletion)
+        self.assertEqual(autocompletion.suggestions[0].primary_line, 'TEST KEYS DO NOT AUTOCOMPLETE US ADDRESSES')