Invalid includes will no longer throw errors. Added some debug functionality. Bumped version.

Author: jeffrimko

CHANGELOG.adoc

@@ -1,5 +1,16 @@
 = Verace Changelog
 
+== verace-0.3.1 (2018-01-12)
+=== Release highlights
+  - Convenience updates.
+
+=== All additions and changes
+  - Invalid `VerChecker.include()` results will no longer produce errors.
+  - Added `debug` property to `VerChecker`.
+
+=== Bug fixes
+Not applicable.
+
 == verace-0.3.0 (2017-02-16)
 === Release highlights
   - Added convenience function.

README.adoc

@@ -49,7 +49,7 @@ Get the string found by the checker:
 [source,python]
 --------
 print("version found = " + mychk.string())
-# version found = 0.3.0
+# version found = 0.3.1
 --------
 
 The string can be updated in all associated files:

lib/setup.py

@@ -3,7 +3,7 @@
 
 setup(
     name = "verace",
-    version = "0.3.0",
+    version = "0.3.1",
     author = "Jeff Rimko",
     author_email = "jeffrimko@gmail.com",
     description = "Library for checking version strings in project files.",

lib/verace.py

@@ -11,6 +11,7 @@
 from __future__ import print_function
 
 import copy
+import inspect
 import os
 import os.path as op
 from collections import namedtuple
@@ -20,7 +21,7 @@
 ##==============================================================#
 
 #: Library version string.
-__version__ = "0.3.0"
+__version__ = "0.3.1"
 
 #: Contains information for a single checked item.
 VerInfo = namedtuple("VerInfo", "path linenum string")
@@ -47,6 +48,7 @@ def __init__(self, name, root):
         self._vinfos = []
         self._string = None
         self._checks = []
+        self.debug = False
     def string(self):
         """Returns the string if `run()` found no inconsistencies,
         otherwise None is returned. Always calls `run()`."""
@@ -73,16 +75,19 @@ def include(self, path, func=None, opts=None, updatable=True, **kwargs):
     def iter_vinfo(self, get_updatable=False):
         """Iterates over the associated VerInfo objects. Optionally returns if
         the associated file is updatable."""
+        dprint = get_vprint(self.debug)
         for c in self._checks:
             path = c.path
             if not op.isabs(path):
                 path = op.join(self.root, path)
             path = op.normpath(path)
             vinfos = c.func(path, **c.opts)
+            dprint((inspect.stack()[0][3], c, vinfos))
             if list != type(vinfos):
                 vinfos = [vinfos]
             for vi in vinfos:
-                yield (vi, c.updatable) if get_updatable else vi
+                if vi:
+                    yield (vi, c.updatable) if get_updatable else vi
     def run(self, verbose=True):
         """Runs checks on all included items, reports any inconsistencies.
         Returns string if consistent else None."""