Test improvements

.gitignore

@@ -0,0 +1,21 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# test files
+shapefiles/test/
+
+# Spyder project settings
+.spyderproject
+
+# Rope project settings
+.ropeproject
+
+# Visual Studio project settings
+*.pyproj
+*.sln
+*.suo

.travis.yml

@@ -0,0 +1,23 @@
+sudo: false
+
+addons:
+  apt:
+    packages:
+      - dos2unix
+
+language: python
+
+python:
+  - "2.6"
+  - "2.7"
+  - "3.2"
+  - "3.3"
+  - "3.4"
+  - "3.5"
+
+
+install: 
+  - dos2unix README.txt
+  - pip install .
+
+script: python shapefile.py

README.txt

@@ -296,8 +296,9 @@ The blockgroup key and population count:
 There is also an iterShapeRecords() method to iterate through large files:
 
 >>> shapeRecs = sf.iterShapeRecords()
->>> for shape, rec in shapeRecs:
+>>> for shapeRec in shapeRecs:
 ...     # do something here
+...     pass
 
 Writing Shapefiles
 ++++++++++++++++++

shapefile.py

@@ -1187,10 +1187,20 @@ def __fieldNorm(self, fieldName):
         fieldName.replace(' ', '_')
 
 # Begin Testing
-def test():
+def test(verbosity):
     import doctest
     doctest.NORMALIZE_WHITESPACE = 1
-    doctest.testfile("README.txt", verbose=1)
+    existing_files = set(os.listdir('.'))
+    if verbosity == 0:
+        print('Running doctests...')
+    failure_count, test_count = doctest.testfile("README.txt", verbose=verbosity)
+    temp_files = set(os.listdir('.')) - existing_files
+    for filename in temp_files:
+        if not os.path.isdir(filename):
+            os.unlink(filename)
+    if verbosity == 0 and failure_count == 0:
+        print('All test passed successfully')
+    return failure_count
 
 if __name__ == "__main__":
     """
@@ -1199,4 +1209,6 @@ def test():
     testing libraries but for now unit testing is done using what's available in
     2.3.
     """
-    test()
+    failure_count = test(0)
+    sys.exit(failure_count)
+