smartystreets-python-sdk 7.0.0__tar.gz → 7.2.0__tar.gz

{smartystreets_python_sdk-7.0.0 → smartystreets_python_sdk-7.2.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: smartystreets_python_sdk
-Version: 7.0.0
+Version: 7.2.0
 Summary: An official library to help Python developers easily access the SmartyStreets APIs
 Home-page: https://github.com/smartystreets/smartystreets-python-sdk
-Download-URL: https://github.com/smartystreets/smartystreets-python-sdk/tarball/7.0.0
+Download-URL: https://github.com/smartystreets/smartystreets-python-sdk/tarball/7.2.0
 Author: SmartyStreets SDK Team
 Author-email: support@smartystreets.com
 License: Apache 2

{smartystreets_python_sdk-7.0.0 → smartystreets_python_sdk-7.2.0}/smartystreets_python_sdk/client_builder.py

@@ -3,6 +3,7 @@ from smartystreets_python_sdk.us_street import Client as USStreetClient
 from smartystreets_python_sdk.us_zipcode import Client as USZIPClient
 from smartystreets_python_sdk.us_extract import Client as USExtractClient
 from smartystreets_python_sdk.us_autocomplete_pro import Client as USAutocompleteProClient
+from smartystreets_python_sdk.us_autocomplete import Client as USAutocompleteClient
 from smartystreets_python_sdk.us_reverse_geo import Client as USReverseGeoClient
 from smartystreets_python_sdk.international_street import Client as InternationalStreetClient
 from smartystreets_python_sdk.international_autocomplete import Client as InternationalAutocompleteClient
@@ -34,6 +35,7 @@ class ClientBuilder:
         self.INTERNATIONAL_STREET_API_URL = "https://international-street.api.smarty.com/verify"
         self.INTERNATIONAL_AUTOCOMPLETE_API_URL = "https://international-autocomplete.api.smarty.com/v2/lookup"
         self.US_AUTOCOMPLETE_PRO_API_URL = "https://us-autocomplete-pro.api.smarty.com/lookup"
+        self.US_AUTOCOMPLETE_API_URL = "https://us-autocomplete.api.smarty.com/v2/lookup"
         self.US_EXTRACT_API_URL = "https://us-extract.api.smarty.com"
         self.US_STREET_API_URL = "https://us-street.api.smarty.com/street-address"
         self.US_ZIP_CODE_API_URL = "https://us-zipcode.api.smarty.com/lookup"
@@ -229,6 +231,10 @@ class ClientBuilder:
         self.ensure_url_prefix_not_null(self.US_AUTOCOMPLETE_PRO_API_URL)
         return USAutocompleteProClient(self.build_sender(), self.serializer)
 
+    def build_us_autocomplete_api_client(self):
+        self.ensure_url_prefix_not_null(self.US_AUTOCOMPLETE_API_URL)
+        return USAutocompleteClient(self.build_sender(), self.serializer)
+
     def build_us_extract_api_client(self):
         self.ensure_url_prefix_not_null(self.US_EXTRACT_API_URL)
         return USExtractClient(self.build_sender(), self.serializer)

smartystreets_python_sdk-7.2.0/smartystreets_python_sdk/us_autocomplete/client.py

@@ -0,0 +1,70 @@
+from enum import Enum
+
+from smartystreets_python_sdk import Request
+from smartystreets_python_sdk.exceptions import SmartyException
+from smartystreets_python_sdk.us_autocomplete import Suggestion, geolocation_type
+
+
+class Client:
+    def __init__(self, sender, serializer):
+        """
+        It is recommended to instantiate this class using ClientBuilder.build_us_autocomplete_api_client()
+        """
+        self.sender = sender
+        self.serializer = serializer
+
+    def send(self, lookup):
+        """
+        Sends a Lookup object to the US Autocomplete API and stores the result in the Lookup's result field.
+        """
+        if not lookup or not lookup.search:
+            raise SmartyException('Send() must be passed a Lookup with the search field set.')
+
+        request = self.build_request(lookup)
+
+        response = self.sender.send(request)
+
+        if response.error:
+            raise response.error
+
+        result = self.serializer.deserialize(response.payload)
+        suggestions = self.convert_suggestions(result.get('suggestions') or [])
+        lookup.result = suggestions
+
+        return suggestions
+
+    def build_request(self, lookup):
+        request = Request()
+
+        self.add_parameter(request, 'search', lookup.search)
+        self.add_parameter(request, 'max_results', lookup.max_results)
+        self.add_parameter(request, 'include_only_cities', self.build_filter_string(lookup.city_filter))
+        self.add_parameter(request, 'include_only_states', self.build_filter_string(lookup.state_filter))
+        self.add_parameter(request, 'include_only_zip_codes', self.build_filter_string(lookup.zip_filter))
+        self.add_parameter(request, 'exclude_states', self.build_filter_string(lookup.exclude_states))
+        self.add_parameter(request, 'prefer_cities', self.build_filter_string(lookup.prefer_cities))
+        self.add_parameter(request, 'prefer_states', self.build_filter_string(lookup.prefer_states))
+        self.add_parameter(request, 'prefer_zip_codes', self.build_filter_string(lookup.prefer_zips))
+        self.add_parameter(request, 'prefer_ratio', lookup.prefer_ratio)
+        self.add_parameter(request, 'prefer_geolocation', lookup.prefer_geolocation)
+        self.add_parameter(request, 'source', lookup.source)
+        self.add_parameter(request, 'selected', lookup.selected)
+        self.add_parameter(request, 'exclude', self.build_filter_string(lookup.exclude, ','))
+
+        for parameter in lookup.custom_parameter_array:
+            self.add_parameter(request, parameter, lookup.custom_parameter_array[parameter])
+
+        return request
+
+    @staticmethod
+    def build_filter_string(filter_list, separator=';'):
+        return separator.join(filter_list or []) or None
+
+    @staticmethod
+    def convert_suggestions(suggestion_dictionaries):
+        return [Suggestion(suggestion) for suggestion in suggestion_dictionaries]
+
+    @staticmethod
+    def add_parameter(request, key, value):
+        if value and value != 'none':
+            request.parameters[key] = value.value if isinstance(value, Enum) else value

smartystreets_python_sdk-7.2.0/smartystreets_python_sdk/us_autocomplete/lookup.py

@@ -0,0 +1,83 @@
+from smartystreets_python_sdk.us_autocomplete import geolocation_type
+
+
+class Lookup:
+    def __init__(self, search=None, max_results=None, city_filter=None, state_filter=None, zip_filter=None,
+                 exclude_states=None, prefer_cities=None, prefer_states=None, prefer_zips=None, prefer_ratio=None,
+                 prefer_geolocation=None, selected=None, exclude=None, source=None):
+
+        """
+        In addition to holding all of the input data for this lookup, this class also will contain the result
+        of the lookup after it comes back from the API.
+
+        See "https://www.smarty.com/docs/apis/us-autocomplete-v2/reference#http-request-input-fields"
+
+        :param search: The part of the address that has already been typed (required)
+        :param max_results: Maximum number of address suggestions to return
+        :param city_filter: Limit the results to only those cities listed, as well as those in state_filter
+        :param state_filter: Limit the results to only those states listed, as well as those in city_filter
+        :param zip_filter: Limit the result to only those ZIP Codes listed. When this parameter is used,
+                            no other _cities, _states parameters can be used
+        :param exclude_states: Exclude the following states from the results. When this parameter is used,
+                            no other include_ parameters can be used
+        :param prefer_cities: Display suggestions with the listed cities and states at the top of the suggestion list
+        :param prefer_states: Display suggestions with the listed states at the top of the suggestion list
+        :param prefer_zips: Display suggestions with the listed ZIP Codes at the top of the suggestion list.
+                                When this parameter is used, no other _cities or _state parameters can be used
+        :param prefer_ratio: Specifies the percentage of address suggestions that should be preferred
+                                and will appear at the top of the suggestion list
+        :param prefer_geolocation: If omitted or set to city it uses the sender's IP address to determine location,
+                            then automatically adds the city and state to the prefer_cities value.
+                            This parameter takes precedence over other _include or exclude parameters,
+                            meaning that if it is not set to none, you may see addresses from the customer's area
+                            when you may not desire it
+        :param selected: Used by UI components to request a list of secondaries (up to 100) for the specified address
+        :param exclude: Removes the given partial address from the suggestion results
+        :param source: Include results from alternate data sources. Defaults to None (API default: postal).
+                            Use Source.ALL to include non-postal addresses, Source.POSTAL to limit to postal only.
+        """
+        self.result = []
+        self.custom_parameter_array = {}
+        self.search = search
+        self.max_results = max_results
+        self.city_filter = city_filter or []
+        self.state_filter = state_filter or []
+        self.zip_filter = zip_filter or []
+        self.exclude_states = exclude_states or []
+        self.prefer_cities = prefer_cities or []
+        self.prefer_states = prefer_states or []
+        self.prefer_zips = prefer_zips or []
+        self.prefer_ratio = prefer_ratio
+        self.prefer_geolocation = prefer_geolocation
+        self.selected = selected
+        self.exclude = exclude or []
+        self.source = source
+
+    def add_city_filter(self, city):
+        self.city_filter.append(city)
+
+    def add_state_filter(self, state):
+        self.state_filter.append(state)
+
+    def add_zip_filter(self, zipcode):
+        self.prefer_geolocation = geolocation_type.NONE
+        self.zip_filter.append(zipcode)
+
+    def add_state_exclusion(self, state):
+        self.exclude_states.append(state)
+
+    def add_city_preference(self, city):
+        self.prefer_cities.append(city)
+
+    def add_state_preference(self, state):
+        self.prefer_states.append(state)
+
+    def add_zip_preference(self, zipcode):
+        self.prefer_geolocation = geolocation_type.NONE
+        self.prefer_zips.append(zipcode)
+
+    def add_exclude(self, exclude_type):
+        self.exclude.append(exclude_type)
+
+    def add_custom_parameter(self, parameter, value):
+        self.custom_parameter_array[parameter] = value

smartystreets_python_sdk-7.2.0/smartystreets_python_sdk/us_autocomplete/suggestion.py

@@ -0,0 +1,15 @@
+class Suggestion:
+    def __init__(self, obj=None):
+        """
+        See "https://www.smarty.com/docs/apis/us-autocomplete-v2/reference#http-response-status"
+        """
+        self.smarty_key = obj.get('smarty_key', None)
+        self.entry_id = obj.get('entry_id', None)
+        self.urbanization = obj.get('urbanization', None)
+        self.street_line = obj.get('street_line', None)
+        self.secondary = obj.get('secondary', None)
+        self.city = obj.get('city', None)
+        self.state = obj.get('state', None)
+        self.zipcode = obj.get('zipcode', None)
+        self.entries = obj.get('entries', None)
+        self.source = obj.get('source', None)

smartystreets_python_sdk-7.2.0/smartystreets_python_sdk/us_autocomplete_pro/__init__.py

@@ -0,0 +1,4 @@
+from .suggestion import Suggestion
+from .lookup import Lookup
+from .client import Client
+from .source import Source

smartystreets_python_sdk-7.2.0/smartystreets_python_sdk/us_autocomplete_pro/geolocation_type.py

@@ -0,0 +1,3 @@
+CITY = 'city'
+
+NONE = 'none'

smartystreets_python_sdk-7.2.0/smartystreets_python_sdk/us_reverse_geo/source.py

@@ -0,0 +1,6 @@
+from enum import Enum
+
+
+class Source(str, Enum):
+    ALL = "all"
+    POSTAL = "postal"

{smartystreets_python_sdk-7.0.0 → smartystreets_python_sdk-7.2.0}/smartystreets_python_sdk.egg-info/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: smartystreets_python_sdk
-Version: 7.0.0
+Version: 7.2.0
 Summary: An official library to help Python developers easily access the SmartyStreets APIs
 Home-page: https://github.com/smartystreets/smartystreets-python-sdk
-Download-URL: https://github.com/smartystreets/smartystreets-python-sdk/tarball/7.0.0
+Download-URL: https://github.com/smartystreets/smartystreets-python-sdk/tarball/7.2.0
 Author: SmartyStreets SDK Team
 Author-email: support@smartystreets.com
 License: Apache 2

{smartystreets_python_sdk-7.0.0 → smartystreets_python_sdk-7.2.0}/smartystreets_python_sdk.egg-info/SOURCES.txt

@@ -45,6 +45,12 @@ smartystreets_python_sdk/international_street/language_mode.py
 smartystreets_python_sdk/international_street/lookup.py
 smartystreets_python_sdk/international_street/metadata.py
 smartystreets_python_sdk/international_street/rootlevel.py
+smartystreets_python_sdk/us_autocomplete/__init__.py
+smartystreets_python_sdk/us_autocomplete/client.py
+smartystreets_python_sdk/us_autocomplete/geolocation_type.py
+smartystreets_python_sdk/us_autocomplete/lookup.py
+smartystreets_python_sdk/us_autocomplete/source.py
+smartystreets_python_sdk/us_autocomplete/suggestion.py
 smartystreets_python_sdk/us_autocomplete_pro/__init__.py
 smartystreets_python_sdk/us_autocomplete_pro/client.py
 smartystreets_python_sdk/us_autocomplete_pro/geolocation_type.py

{smartystreets_python_sdk-7.0.0 → smartystreets_python_sdk-7.2.0}/smartystreets_python_sdk_version/__init__.py

@@ -1,2 +1,2 @@
 __version__ = '0.0.0'  # DO NOT EDIT (this is updated by a build job when a new release is published)
-__version__="7.0.0"
+__version__="7.2.0"