Raise an informative error when docstrings have been stripped

kennknowles · kennknowles · commit c46d04f4099f · 2013-05-29T11:17:05.000-04:00
diff --git a/.gitignore b/.gitignore
@@ -1,4 +1,5 @@
 *.pyc
+*.pyo
 *~
 
 # Emacs
diff --git a/jsonpath_rw/lexer.py b/jsonpath_rw/lexer.py
@@ -13,6 +13,8 @@ class JsonPathLexer(object):
     
     def __init__(self, debug=False):
         self.debug = debug
+        if self.__doc__ == None:
+            raise Exception('Docstrings have been removed! By design of PLY, jsonpath-rw requires docstrings. You must not use PYTHONOPTIMIZE=2 or python -OO.')
 
     def tokenize(self, string):
         '''
diff --git a/jsonpath_rw/parser.py b/jsonpath_rw/parser.py
@@ -14,9 +14,16 @@ def parse(string):
     return JsonPathParser().parse(string)
 
 class JsonPathParser(object):
+    '''
+    An LALR-parser for JsonPath
+    '''
+    
     tokens = JsonPathLexer.tokens
 
     def __init__(self, debug=False, lexer_class=None):
+        if self.__doc__ == None:
+            raise Exception('Docstrings have been removed! By design of PLY, jsonpath-rw requires docstrings. You must not use PYTHONOPTIMIZE=2 or python -OO.')
+
         self.debug = debug
         self.lexer_class = lexer_class or JsonPathLexer # Crufty but works around statefulness in PLY
 
