Add python module; supports LM querying

README.md

@@ -0,0 +1,3 @@
+# python-kenlm
+
+A python interface to [kenlm](http://kheafield.com/code/kenlm/)

examples/example.py

@@ -0,0 +1,25 @@
+import os
+import kenlm
+
+LM = os.path.join(os.path.dirname(__file__), 'mini.klm')
+model = kenlm.LanguageModel(LM)
+print '%d-gram model' % model.order
+
+sentence = u'language modeling is fun .'
+print sentence, model.score(sentence)
+
+# Check that total full score = direct score
+def score(s):
+    return sum(prob for prob, _ in model.full_scores(s))
+
+assert (abs(score(sentence) - model.score(sentence)) < 1e-3)
+
+# Show scores and n-gram matches
+words = ['<s>'] + sentence.split() + ['</s>']
+for i, (prob, length) in enumerate(model.full_scores(sentence)):
+    print prob, length, ':', ' '.join(words[i+2-length:i+2])
+
+# Find out-of-vocabulary words
+for w in words:
+    if not w in model:
+        print '"%s" is an OOV' % w