cQ 6dZddlmZmZmZddlmZddlmZm Z m Z m Z m Z m Z mZmZmZ ddlmZmZeecZZn#e$re e cZZYnwxYwedZedkZeZded zzZerd n eZd ed zzZd Zd5dZdZeefdZ eej!e ej"_#e ej_#e ee ee ee ee eeee e fej$_%e ee ee ee ee eeee ee ee ee e f ej&_%e ee ee ee ee eeee e fej'_%e ee ee ee ee eeee ee ee ee e f ej(_%e ee e ee e fej)_%e fej*_%e e fej+_%e e fej,_%e ee ee e e fej-_%e ee ee e e fej._%ede e Z/dej0_#dej1_#e fej1_%dZ2dZ3d6dZ4d7dZ5d6dZ6d7dZ7d8dZ8dZ9dZ:dZ;dZdZ?dZ@d xZAxZBZCd xZDxZEZFdxZGxZHZId ZJd!ZKd"ZLd#ZMd$ZNd%ZOd&ZPd'ZQd(ZRd)ZSd ZTd ZUdZVd"ZWd#ZXd$ZYeYZZd%Z[dZ\d*Z]d+Z^d,Z_d-Z`d.Zad/Zbe\e]e^e_e`eaebfZcedd0kr-eee2eee4d1gd2d34dSdS)9aLiblouis Python ctypes bindings These bindings allow you to use the liblouis braille translator and back-translator library from within Python. This documentation is only related to the Python helper. Please see the liblouis documentation for more information. Most of these functions take a C{tableList} argument which specifies a list of translation tables to use. Please see the liblouis documentation concerning the C{tableList} parameter to the C{lou_translateString} function for information about how liblouis searches for these tables. @author: Michael Curran @author: James Teh @author: Eitan Isaacson @author: Michael Whapples @author: Davy Kager @author: Leonard de Ruijter @author: Babbage B.V. @author: Andre-Abush Clause )getfilesystemencodingplatform version_info)register) c_ushort CFUNCTYPEcdllc_char_pc_charc_intPOINTERbyrefcreate_string_buffer) WINFUNCTYPEwindllzliblouis.so.20win32mbcsz utf_%d_lec@dd|DS)z*Creates a tables string for liblouis calls,cg|]@}t|tr|tnt |AS) isinstancestrencodefileSystemEncodingbytes).0xs 0/usr/lib/python3/dist-packages/louis/__init__.py z'_createTablesString..XsO   -7q#,>,> LAHH' ( ( (E!HH   )join) tablesLists r"_createTablesStringr'Us4 99       r$Nc@|r t|z|nt|zS)z,Creates a typeform buffer for liblouis calls)r)lengthtypeforms r"_createTypeformbufr+_s'-5 PHv  ) )Hv ? ?FKA(x@@ V\ ! $ $Eek! $ $Fi  I  ! !  e  f    i    lyy%%%999dd <   (D!!(;''  1V\M11299 '= :   n n}}  r$c t|}t|}tt|tz}t|jt z}t|jtz}d}|rt|j|}t ||t||t||d|std|d|d|d|t|trt||dd<|jd|jtzt"t$S)aTranslate a string of characters. @param tableList: A list of translation tables. @type tableList: list of str @param inbuf: The string to translate. @type inbuf: str @param typeform: A list of typeform constants indicating the typeform for each position in inbuf, C{None} for no typeform information. @type typeform: list of int @param mode: The translation mode; add multiple values for a combined mode. @type mode: int @return: The translated string. @rtype: str @raise RuntimeError: If a complete translation could not be done. @see: lou_translateString in the liblouis documentation Nr<r=r>r?r@)r'r1r rArBrCrDrr+r4lou_translateStringrrFrrGrHr6rIrJ rLrMr*rOrPrQrRrSrTs r"translateStringr[sL 'y11L #E * *E #e** - . .E 5;!11 2 2F !&,"> ? ?FKA(x@@  ' '  e  f       lyy%%%44 1   (D!!(;'' :4 }44 5 < <#9 =  r$ct|}t|}tt|tz}t|jt z}t|jtz}d} t|trt|j} t|jz} t|jz} t|}t ||t||t|| d| | t|| std|||||fzt|trt| |dd<|jd|jtzt"t$| d|j| d|j|jfS)agBack translates a string of characters, providing position information. @param tableList: A list of translation tables. @type tableList: list of str @param inbuf: Braille to back translate. @type inbuf: str @param typeform: List where typeform constants will be placed. @type typeform: list @param cursorPos: Position of cursor. @type cursorPos: int @param mode: Translation mode. @type mode: int @return: A tuple: A string of the back translation, a list of input positions for each position in the output, a list of the output positions for each position in the input and the position of the cursor in the output. @rtype: (str, list of int, list of int, int) @raise RuntimeError: If a complete back translation could not be done. @see: lou_backTranslate in the liblouis documentation. NzMCan't back translate: tables %s, inbuf %s, typeform %s, cursorPos %d, mode %dr@)r'r1r rArBrCrDrrrGr+r4lou_backTranslaterrFrHr6rIrJrKs r" backTranslater^Fs('y11L #E * *E #e** - . .E 5;!11 2 2F !&,"> ? ?FK(D!!7(66 V\ ! $ $Eek! $ $Fi  I  % %  e  f    i     [%9d; <   (D!!(;''  1V\M11299 '= :   n n}}  r$c t|}t|}tt|tz}t|jt z}t|jtz}d}t|trt|j}t ||t||t||d|std|||fzt|trt||dd<|jd|jtzt"t$S)aMBack translate from Braille. @param tableList: A list of translation tables. @type tableList: list of str @param inbuf: The Braille to back translate. @type inbuf: str @param typeform: List for typeform constants to be put in. If you don't want typeform data then give None @type typeform: list @param mode: The translation mode @type mode: int @return: The back translation of inbuf. @rtype: str @raise RuntimeError: If a complete back translation could not be done. @see: lou_backTranslateString in the liblouis documentation. Nz2Can't back translate: tables %s, inbuf %s, mode %dr@)r'r1r rArBrCrDrrrGr+r4lou_backTranslateStringrrFrHr6rIrJrZs r"backTranslateStringrasG 'y11L #E * *E #e** - . .E 5;!11 2 2F !&,"> ? ?FK(D!!7(66  + +  e  f        @%& '   (D!!(;'' :4 }44 5 < <#9 =  r$cNt|}t|}tt|tz}t |jdz}t|||||std|||fz|j dS)aGet information for hyphenation. @param tableList: A list of translation tables and hyphenation dictionaries. @type tableList: list of str @param inbuf: The text to get hyphenation information about. This should be a single word and leading/trailing whitespace and punctuation is ignored. @type inbuf: str @param mode: Lets liblouis know if inbuf is plain text or Braille. Set to 0 for text and anyother value for Braille. @type mode: int @return: A string with '1' at the beginning of every syllable and '0' elsewhere. @rtype: str @raise RuntimeError: If hyphenation data could not be produced. @see: lou_hyphenate in the liblouis documentation. z-Can't hyphenate: tables %s, inbuf %s, mode %dr3) r'r1r rArBrrCr4 lou_hyphenaterFr6)rLrMrOrPrQ hyphen_strings r" hyphenaterfs$'y11L #E * *E #e** - . .E(q99M  ! !,umT R R  ;y%QU>V V      % %g . ..r$c|t|}t|std|zdS)aCheck if the specified tables can be found and compiled. This can be used to check if a list of tables contains errors before sending it to other liblouis functions that accept a list of tables. @param tableList: A list of translation tables. @type tableList: list of str @raise RuntimeError: If compilation failed. @see: lou_checkTable in the liblouis documentation zCan't compile: tables %sN)r'r4lou_checkTablerF)rLrPs r" checkTablerisH'y11L  " "< 0 0C5 ABBBCCr$ct|}t|tr|dnt |}t ||std|d|dS)aHCompile a table entry on the fly at run-time. @param tableList: A list of translation tables. @type tableList: list of str @param inString: The table entry to be added. @type inString: str @raise RuntimeError: If compilation of the entry failed. @see: lou_compileString in the liblouis documentation r3zCan't compile entry: tables z , inString N)r'rrrrr4lou_compileStringrF)rLinStringrPinBytess r" compileStringrns'y11L*4Xs*C*CXhoog&&&xG  % %lG < < l=FYY Q     r$ct|}tr|d}t||S)aGet the typeform bit for the named emphasis class. @param tableList: A list of translation tables. @type tableList: list of str @param emphClass: An emphasis class name. @type emphClass: str @see: lou_getTypeformForEmphClass in the liblouis documentation r3)r'_is_py3rr4lou_getTypeformForEmphClass)rL emphClassrPs r"getTypeformForEmphClassrssB'y11L.$$W--  / / i H HHr$ct|}t|}tt|tz}t |jtz}t||||dstd|d||j d|jtz ttS)a"Convert a string of dot patterns to a string of characters according to the specifications in tableList. @param tableList: A list of translation tables. @type tableList: list of str @param inbuf: a string of dot patterns, either in liblouis format or Unicode braille. @type inbuf: str @raise RuntimeError: If a complete conversion could not be done. @see: lou_dotsToChar in the liblouis documentation rz#Can't convert dots to char: tables r=Nr@)r'r1r rArBrrCr4lou_dotsToCharrFrHr6rIrJ)rLrMrPr)rSs r" dotsToCharrvs'y11L #E * *E 3u::. / /F !&,"> ? ?F  " "< J J lAJEE R    :4 }44 5 < <#9 =  r$ct|}t|}tt|tz}t |jtz}t|||||std|||fz|j d|jtz ttS)a"Convert a string of characterss to a string of dot patterns according to the specifications in tableList. @param tableList: A list of translation tables. @type tableList: list of str @param inbuf: a string of characters. @type inbuf: str @param mode: The translation mode; add multiple values for a combined mode. @type mode: int @raise RuntimeError: If a complete conversion could not be done. @see: lou_charToDots in the liblouis documentation z8Can't convert char to dots: tables %s, inbuf %s, mode %dNr@)r'r1r rArBrrCr4lou_charToDotsrFrHr6rIrJ)rLrMrOrPr)rSs r" charToDotsrys'y11L #E * *E 3u::. / /F !&,"> ? ?F  " "< M M  F%& '    :4 }44 5 < <#9 =  r$c|At|ts,tdtjt |S)a|Register logging callbacks. Set to C{None} for default callback. @param logCallback: The callback to use. The callback must take two arguments: @param level: The log level on which a message is logged. @type level: int @param message: The logged message. Note that the callback should provide its own ASCII decoding routine. @type message: bytes Example callback: @louis.LogCallback def incomingLouisLog(level, message): print("Message %s logged at level %d" % (message.decode("ASCII"), level)) @type logCallback: L{LogCallback} Nz,logCallback should be of type {} or NoneType)r LogCallback TypeErrorformat__name__r4lou_registerLogCallback) logCallbacks r"registerLogCallbackr)sU&z+{'K'K : A A+BV W W     + +K 8 88r$cl|tvrtd|zt|S)zSet the level for logging callback to be called at. @param level: one of the C{LOG_*} constants. @type level: int @raise ValueError: If an invalid log level is provided. z Level %d is an invalid log level) logLevels ValueErrorr4lou_setLogLevel)levels r" setLogLevelrCs7  I;eCDDD  # #E * **r$rc @iiiii'i Ni0ui@iPi`__main__s../tables/en-us-g2.ctbz Hello world!)rNr.)Nrr)Nr)r)f__doc__sysrrratexitrctypesrrr r r r r rrrr_loader _functype ImportErrorr4 _is_windowsr9rBrDrrIr'r+rJr1lou_freer5restyperYargtypesrEr`r]rdrhrkrqrurxr{rrr7r:rWr[r^rarfrirnrsrvryrr plain_textemph_1 comp_emph_1italicemph_2 comp_emph_2 underlineemph_3 comp_emph_3boldemph_4emph_5emph_6emph_7emph_8emph_9emph_10computer_braille no_translate no_contractnoContractionscompbrlAtCursordotsIOcompbrlLeftCursorucBrl noUndefinednoUndefinedDots partialTransLOG_ALL LOG_DEBUGLOG_INFOLOG_WARN LOG_ERROR LOG_FATALLOG_OFFrr~printrr$r"rs**>=========                      )********GYY)))yGYYY) # $'! %%'' }q(( +GVV0E0E0G0G!MA$56QQQQ )#+A++++   ' %  GFOO GENN GFOO GENN GH GFOO  )%  GFOO GENN GFOO GENN GH GFOO GENN GENN GENN  #  GFOO GENN GFOO GENN GH GFOO  - )  GFOO GENN GFOO GENN GH GFOO GENN GENN GENN  '#  GFOO  GFOO #%-; '/&:#1980D$-  GFOO GFOO  $   GFOO GFOO  $ ieX.. +/ (#' %*H!222###::::z****Z9999x****Z////: C C C   " I I I,29994+++ &&&v#)))y$$$t                    i8Y 7 S  z E'')) E))./1 M M MNNNNNs 8 AA