update test and readme

Author: MacHu-GWU

README.rst

@@ -151,11 +151,22 @@ Example Usage
 
 **NOTE**:
 
-    ``uszipcode`` has two backend database, ``SimpleZipcode`` and ``Zipcode``. ``Zipcode`` has more info, but the database file is 450MB (takes more time to download). ``SimpleZipcode`` doesn't has all data points listed above, but the database file is smaller (9MB). By default ``uszipcode`` use ``SimpleZipcode``. You can use this code to choose to use the rich info ``Zipcode``::
+    ``uszipcode`` has two backend database, ``SimpleZipcode`` and ``Zipcode``. ``Zipcode`` has more info, but the database file is 450MB (takes more time to download). ``SimpleZipcode`` doesn't has all data points listed above, but the database file is smaller (9MB). By default ``uszipcode`` use ``SimpleZipcode``. You can use this code to choose to use the rich info ``Zipcode``:
+
+    .. code-block:: python
 
         >>> from uszipcode import SearchEngine
         >>> search = SearchEngine(simple_zipcode=False)
 
+    From 0.2.4, ``uszipcode`` **allows developer to choose which directory you want to use to download the database file**. By default, it is ``$HOME/.uszipcode``, but you can easily change it.:
+
+    .. code-block:: python
+
+        >>> search = SearchENgine(db_file_dir="/tmp")
+
+    For example, AWS Lambda doesn't allow to download file to $HOME directory, but allows to download to ``/tmp`` folder.
+
+
 **Examples**:
 
 .. code-block:: python
@@ -253,6 +264,19 @@ You can **easily sort your results** by any field, or distance from a coordinate
     ...     # do whatever you want...
 
 
+Deploy Uszipcode as a Web Service
+------------------------------------------------------------------------------
+
+If you want to build a private uszipcode API server you have two choice:
+
+1. Use a VM like EC2 machine, and deploy a web api server with the machine.
+2. (RECOMMEND) Dump the sqlite database to any relational database like Postgres, MySQL, and inject the database connection info in your application server.
+
+In the feature release, I will provide an easy way that allow you to deploy uszipcode as a private web api service.
+
+Thank you.
+
+
 .. _install:
 
 Install

release-history.rst

@@ -4,11 +4,12 @@ Release and Version History
 ==============================================================================
 
 
-0.2.3 (TODO)
+0.2.5 (TODO)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 **Features and Improvements**
 
 - Get lat lng and more geo info from Google Geocoding API for **Unique** and **PO Box** zipcode.
+- Allow user to dump the data to any relational database easily and use self-hosted database to query.
 
 **Minor Improvements**
 
@@ -17,6 +18,26 @@ Release and Version History
 **Miscellaneous**
 
 
+0.2.4 (2019-10-16)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+**Features and Improvements**
+
+- Now you can use ``SearchEngine(..., db_file_dir="/tmp")`` to specify where you want to put your database. By default it is ``${HOME}/.uszipcode``.
+
+**Minor Improvements**
+
+**Bugfixes**
+
+**Miscellaneous**
+
+
+0.2.3 (2019-10-07)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+**Miscellaneous**
+
+- move the default download dir to /tmp folder, so this database can be used in AWS Lambda.
+
+
 0.2.2 (2018-10-15)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

tests/all.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
 if __name__ == "__main__":

tests/pkg/test_fuzzywuzzy.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
 from uszipcode.pkg.fuzzywuzzy import process

tests/pkg/test_haversine.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
 import pytest

tests/search/all.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
 if __name__ == "__main__":

tests/search/base.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
 from uszipcode.search import SearchEngine
@@ -40,3 +39,15 @@ def setup_class(cls):
     @classmethod
     def teardown_class(cls):
         cls.search.close()
+
+
+class TestComplexSearchEngineBase(object):
+    search = None
+
+    @classmethod
+    def setup_class(cls):
+        cls.search = SearchEngine(simple_zipcode=False)
+
+    @classmethod
+    def teardown_class(cls):
+        cls.search.close()

tests/search/test_census_data.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
 import pytest

tests/search/test_search_by_city_and_state.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
 import pytest

tests/search/test_search_by_coordinate.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
 import pytest