alphabet-detector's Introduction

alphabet-detector

A library to detect what alphabet something is written in.

Author

Eli Finkelshteyn (founder constructor.io)

Installation

pip install alphabet-detector

Usage

To instantiate an AlphabetDetector (the object is used for speed optimization):

from alphabet_detector import AlphabetDetector
ad = AlphabetDetector()

In general, you can just use the only_alphabet_chars(unicode_str, alphabet) method and expect a boolean response:

ad.only_alphabet_chars(u"ελληνικά means greek", "LATIN") #False
ad.only_alphabet_chars(u"ελληνικά", "GREEK") #True
ad.only_alphabet_chars(u'سماوي يدور', 'ARABIC')
ad.only_alphabet_chars(u'שלום', 'HEBREW')
ad.only_alphabet_chars(u"frappé", "LATIN") #True
ad.only_alphabet_chars(u"hôtel lœwe 67", "LATIN") #True
ad.only_alphabet_chars(u"det forårsaker første", "LATIN") #True
ad.only_alphabet_chars(u"Cyrillic and кириллический", "LATIN") #False
ad.only_alphabet_chars(u"кириллический", "CYRILLIC") #True

You can also request free-style detection of any unicode string:

ad.detect_alphabet(u'Cyrillic and кириллический') #{'CYRILLIC', 'LATIN'}

Convenience methods are also provided for some major languages:

ad.is_cyrillic(u"Привет") #True  
ad.is_latin(u"howdy") #True
ad.is_cjk(u"hi") #False
ad.is_cjk(u'汉字') #True

NOTE: all strings are expected to be unicode to keep things consistent. Conversion is never done for you, and errors are thrown when a string is not unicode.

Recommend Projects