Package: pycld2
PYCLD2 - Python Bindings to CLD2Python bindings for the Compact Langauge Detect 2 (CLD2).This package contains forks of:Thecld2C++ library, developed by Dick SitesThechromium-compact-language-detectorC++ extension module,
originally created by Mike McCandless, which has been modified post-fork.
These bindings, among other changes, make the support of over 165 languages
the default.The goal of this project is to consolidate the upstream library with its bindings, so the user canpip installone package instead of two.The LICENSE is the same as Chromium's LICENSE and is included in the
LICENSE file for reference.Installing$python-mpipinstall-Upycld2Exampleimportpycld2ascld2isReliable,textBytesFound,details=cld2.detect("а неправильный формат идентификатора дн назад")print(isReliable)# Truedetails[0]# ('RUSSIAN', 'ru', 98, 404.0)fr_en_Latn="""\France is the largest country in Western Europe and the third-largest in Europe as a whole.A accès aux chiens et aux frontaux qui lui ont été il peut consulter et modifier ses collectionset exporter Cet article concerne le pays européen aujourd’hui appelé République française.Pour d’autres usages du nom France, Pour une aide rapide et effective, veuiller trouver votre aidedans le menu ci-dessus.Motoring events began soon after the construction of the first successful gasoline-fueled automobiles.The quick brown fox jumped over the lazy dog."""isReliable,textBytesFound,details,vectors=cld2.detect(fr_en_Latn,returnVectors=True)print(vectors)# ((0, 94, 'ENGLISH', 'en'), (94, 329, 'FRENCH', 'fr'), (423, 139, 'ENGLISH', 'en'))APIThis package exports one function,detect(). Seehelp(detect)for the full docstring.The first parameter (utf8Bytes) is the text for which you want to detect language.utf8Bytesmay be either:str(example:"¼ cup of flour")bytesthat have been encoded using UTF-8 (example:"¼ cup of flour".encode("utf-8"))Bytes that arenotUTF-8 encoded will raise apycld2.error.  For example, passing
b"\xbc cup of flour" (which is"¼ cup of flour".encode("latin-1")) will raise.All other parameters are optional:ParameterType/DefaultUseutf8Bytesstrorbytes*The text to detect language for.isPlainTextbool, defaultFalseIfFalse, then the input is HTML and CLD will skip HTML tags, expand HTML entities, detect HTML<lang ...>tags, etc.hintTopLevelDomainstrE.g.,'id'boosts Indonesian.hintLanguagestrE.g.,'ITALIAN'or'it'boosts Italian; seecld.LANGUAGESfor all known languages.hintLanguageHTTPHeadersstrE.g.,'mi,en'boosts Maori and English.hintEncodingstrE.g,'SJS'boosts Japanese; seecld.ENCODINGSfor all known encodings.returnVectorsbool, defaultFalseIfTrue, then the vectors indicating which language was detected in which byte range are returned in addition to details.  The vectors are a sequence of(bytesOffset, bytesLength, languageName, languageCode), in order.bytesOffsetis the start of the vector,bytesLengthis the length of the vector.  Note that there is some added CPU cost if this is True.  (Approx. 2x performance hit.)debugScoreAsQuadsbool, defaultFalseNormally, several languages are detected solely by their Unicode script.  Combined with appropritate lookup tables, this flag forces them instead to be detected via quadgrams. This can be a useful refinement when looking for meaningful text in these languages, instead of just character sets. The default tables do not support this use.debugHTMLbool, defaultFalseFor each detection call, write an HTML file to stderr, showing the text chunks and their detected languages. Seecld2/docs/InterpretingCLD2UnitTestOutput.pdfto interpret this output.debugCRbool, defaultFalseIn that HTML file, force a new line for each chunk.debugVerbosebool, defaultFalseIn that HTML file, show every lookup entry.debugQuietbool, defaultFalseIn that HTML file, suppress most of the output detail.debugEchobool, defaultFalseEcho every input buffer to stderr.bestEffortbool, defaultFalseIfTrue, then allow low-quality results for short text, rather than forcing the result to"UNKNOWN_LANGUAGE".  This may be of use for those desiring approximate results on short input text, but there is no claim that these result are very good.*Ifbytes, must be UTF-8 encoded bytes.ConstantsThis package exports these global constants:ConstantDescriptionpycld2.ENCODINGSlist of the encoding names CLD recognizes (if you providehintEncoding, it must be one of these names).pycld2.LANGUAGESlist of languages and their codes (if you providehintLanguageCode, it must be one of the codes from these codes).pycld2.EXTERNAL_LANGUAGESlist of external languages and their codes.pycld2.DETECTED_LANGUAGESlist of all detectable languages.What About CLD3?Python bindings forCLD3are available as a separate project,pycld3.