0.2.2

**Minor Improvements**

- SearchEngine.by_zipcode has a new optional parameter ``zero_padding=True``.

**Bugfixes**

- SearchEngine.by_zipcode should returns any zipcode_type by default. (It used to only return standard zipcode)

Author: MacHu-GWU

Makefile

@@ -1 +1 @@
-include ${shell pwd}/make/python_env.mk
+include ./make/python_env.mk

make/python_env.mk

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Auto generated from pygitrepo 0.0.22
+# Auto generated from pygitrepo 0.0.24
 #
 # This Makefile is a dev-ops tool set.
 # Compatible with:

release-history.rst

@@ -4,17 +4,31 @@ Release and Version History
 ==============================================================================
 
 
-0.2.2 (TODO)
+0.2.3 (TODO)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 **Features and Improvements**
 
+- Get lat lng and more geo info from Google Geocoding API for **Unique** and **PO Box** zipcode.
+
 **Minor Improvements**
 
 **Bugfixes**
 
 **Miscellaneous**
 
 
+0.2.2 (2018-10-15)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**Minor Improvements**
+
+- SearchEngine.by_zipcode has a new optional parameter ``zero_padding=True``.
+
+**Bugfixes**
+
+- SearchEngine.by_zipcode should returns any zipcode_type by default. (It used to only return standard zipcode)
+
+
 0.2.1 (2018-09-29)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 **Features and Improvements**

tests/search/test_census_data.py

@@ -3,7 +3,7 @@
 
 import pytest
 from base import TestSearchEngineBase
-from uszipcode.model import Zipcode
+from uszipcode.model import Zipcode, ZipcodeType
 
 
 class TestSearchEngineCensusData(TestSearchEngineBase):
@@ -15,6 +15,14 @@ def test(self):
             z.head_of_household_by_age
             z.polygon
 
+    def test_by_zipcode_non_standard(self):
+        """
+        Test by_zipcode should return any type zipcode.
+        """
+        z = self.search.by_zipcode(48874)
+        assert z.zipcode_type != ZipcodeType.Standard
+        assert z.lat is not None
+
 
 if __name__ == "__main__":
     import os

uszipcode/__init__.py

@@ -14,7 +14,7 @@
 except Exception as e:  # pragma: no cover
     print(e)
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"
 __short_description__ = ("USA zipcode programmable database, includes "
                          "up-to-date census and geometry information.")
 __license__ = "MIT"

uszipcode/search.py

@@ -333,6 +333,8 @@ def query(self,
         :param median_household_income_lower:
         :param median_household_income_upper:
         :param zipcode_type: str or :class`~uszipcode.model.ZipcodeType` attribute.
+            if None, allows to return any type of zipcode.
+            if specified, only return specified zipcode type.
         :param sort_by: str or :class:`~uszipcode.model.Zipcode` attribute,
             specified which field is used for sorting.
         :param ascending: bool, True means ascending, False means descending.
@@ -531,13 +533,30 @@ def query(self,
             else:
                 return q.all()
 
-    def by_zipcode(self, zipcode):
+    def by_zipcode(self,
+                   zipcode,
+                   zipcode_type=None,
+                   zero_padding=True):
         """
         Search zipcode by exact 5 digits zipcode. No zero padding is needed.
+
+        :param zipcode: int or str, the zipcode will be automatically
+            zero padding to 5 digits.
+        :param zipcode_type: str or :class`~uszipcode.model.ZipcodeType` attribute.
+            by default, it returns any zipcode type.
+        :param zero_padding: bool, toggle on and off automatic zero padding.
         """
-        zipcode = str(zipcode).zfill(5)
+        if zero_padding:
+            zipcode = str(zipcode).zfill(5)
+        else:  # pragma: no cover
+            zipcode = str(zipcode)
 
-        res = self.query(zipcode=zipcode, sort_by=None, returns=1)
+        res = self.query(
+            zipcode=zipcode,
+            sort_by=None,
+            returns=1,
+            zipcode_type=zipcode_type,
+        )
         if len(res):
             return res[0]
         else: