add 'pinyin' matching method to percol

percol-finder-pinyin.py

# This add a new matching method 'pinyin' to percol(https://github.com/mooz/percol)
# In this matching method, first char of each Chinese character's pinyin sequence is used for matching.
# For example, 'zw' matching '中文' (ZhongWen), '中午'(ZhongWu), '作为' (ZuoWei) etc.

# Usage:
#   percol --match-method pinyin SomeFileContainingChinese.txt

class FinderMultiQueryPinyin(FinderMultiQuery):
    def get_name(self):
        return "pinyin"

    def transform_query(self, needle):
        try:
            import pinyin
            return pinyin.get_initial(needle, "")
        except:
            return None

    def find_query(self, needle, haystack):
        try:
            import pinyin
            haystack_py = pinyin.get_initial(haystack, '')
            needle_len = len(needle)
            start = 0
            result = []

            while True:
               found = haystack_py.find(needle, start)
               if found < 0:
                   break
               result.append((found, needle_len))
               start = found + needle_len

            return result
        except:
            return None

and we need to add some lines into cli.py

def decide_match_method(options):
    if options.match_method == "regex":
        from percol.finder import FinderMultiQueryRegex
        return FinderMultiQueryRegex
    if options.match_method == "migemo":
        from percol.finder import FinderMultiQueryMigemo
        return FinderMultiQueryMigemo
+    if options.match_method == "pinyin":
+        from percol.finder import FinderMultiQueryPinyin
+        return FinderMultiQueryPinyin
    else:
        from percol.finder import FinderMultiQueryString
        return FinderMultiQueryString

hi bamanzi, i am a python newbie and i got a question, i think you are the only person that could help me (please!)
if i have an array like this:
arr = [1, 2, 3, 4]
i want to use a direct call from percol library from my python program,
how do i list it on percol from python?