add method to get usage of a word in sentences

PyDictionary/core.py

@@ -137,6 +137,35 @@ def meaning(term, disable_errors=False):
                 if disable_errors == False:
                     print("Error: The Following Error occured: %s" % e)
 
+    @staticmethod
+    def usage(term, min_length= 5, disable_errors=False):
+        """
+        :param term: The word we are looking for meanings and usages
+        :param min_length: minimum length of the sentence to filter on
+        :param disable_errors: if False, print errors if there is some error
+        :return: returns a dictionary with keys begin (noun, verb). One with meanings and other with usages
+        """
+        if len(term.split()) > 1:
+            print("Error: A Term must be only a single word")
+        else:
+            try:
+                html = _get_soup_object("http://wordnetweb.princeton.edu/perl/webwn?s={0}".format(term))
+                types = html.findAll("h3")
+                length = len(types)
+                lists = html.findAll("ul")
+                usage_out = []
+                for a in types:
+                    reg = str(lists[types.index(a)])
+                    for x in re.findall(r"<i>\"(.*?)\"", reg):
+                        if 'often followed by' in x:
+                            pass
+                        elif len(x) >= min_length and term in str(x):
+                            usage_out.append(x)
+                return usage_out
+            except Exception as e:
+                if disable_errors == False:
+                    print("Error: The Following Error occured: %s" % e)
+
 if __name__ == '__main__':
     d = PyDictionary('honest','happy')
     d.printSynonyms()