+ h"Rc s,Rt^RIHtHtHtHt^RIHt^RIH t H t H t H t H t HtHtHtHt^RIHtHt]]utt]R,t]R8Ht]R8XdRMR t]P54t^]^,,t]'dR M]!4tR ]^,]3,tR tR.Rlt Rt!]]!3Rlt"]!]PF4] ]PHn%]]P4n%] ]!] 4]!]4]!] 4]!]4]!] 4]!] 4]3]PLn'] ]!] 4]!]4]!] 4]!]4]!] 4]!] 4]!]4]!]4]!]4]3 ]PPn'] ]!] 4]!]4]!] 4]!]4]!] 4]!] 4]3]PRn'] ]!] 4]!]4]!] 4]!]4]!] 4]!] 4]!]4]!]4]!]4]3 ]PTn'] ]!] 4]]!] 4]3]PVn'] 3]PXn'] ] 3]PZn'] ] 3]P\n'] ]!] 4]!] 4]]3]P^n'] ]!] 4]!] 4]]3]P`n']!R ]] 4t1R ]Pdn%R ]Pfn%]3]Pfn'Rt4Rt5R/Rlt6R0Rlt7R/Rlt8R0Rlt9R1Rlt:Rt;RtR1Rlt?Rt@RtA^tB^;tC;tDtE^;tF;tGtH^;tI;tJtK^tL^tM^ tN^@tO^tPRtQR tRR!tSR"tTR#tU^tV^tW^tX^ tY^@tZ^t[][t\Rt]^t^R$t_R%t`R&taR'tbR(tcR)td]^]_]`]a]b]c]d3te]fR*8Xd"]g!]4!44]g!]6!R+.R,^R-74R #R # ]d ] ] uttELYi;i)2aLiblouis 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 ) byteordergetfilesystemencodingplatform version_info)register) c_ushort CFUNCTYPEcdllc_char_pc_charc_intPOINTERbyrefcreate_string_buffer) WINFUNCTYPEwindllzliblouis.so.20Zwin32ZbigZbeZleZmbcsz utf_%d_%sc sRPVUu.uF9p\V\4'dVP\4M \ V4NK; up4#uupi)z*Creates a tables string for liblouis callss,)Zjoin isinstancestrencodefileSystemEncodingbytes)Z tablesListx& 3/usr/lib/python3.14/site-packages/louis/__init__.py_createTablesStringrVsT 99  -7q#,>,>AHH' (E!H L   s?ANcsXV'd\V,!V!#\V,!4#)z,Creates a typeform buffer for liblouis calls)r)lengthtypeforms&&r_createTypeformbufr`s!-5Hv  )PHv ?FK(x@ V\\ ! $Eekk! $Fi I  ! !  e  f    i   %9d <  (D!!;'  1V\\M1299 '= :  n }  rc s\V4p\V4p\\V4\,4p\VP \ ,4p\VP \,4pRpV'd\VP V4p\PVV\V4V\V4VRV4'g\RV: RV: RV: RV: 24h\V\4'd\V4VR&VPRVP \,P!\"\$R7#)aPTranslate 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-)rrr r.r/r0r1r rr!lou_translateStringr r3rr4r5r#r6r7 r9r:rr<r=r>r?r@rA &&&& rtranslateStringrGs  'y1L #E *E #e* - .E 5;;!11 2F !&,,"> ?FK(x@  ' '  e  f     %4 1  (D!!;' ::4 }4 5 < <#9 = rcs\V4p\V4p\\V4\,4p\VP \ ,4p\VP \,4pRp \V\4'd\VP 4p \VP ,!4p \VP ,!4p \V4p\PVV\V4V\V4V RV V \V4V4 'g\RWW#V3,4h\V\4'd\V 4VR&VPRVP \,P!\"\$R7V RVP V RVP VP 3#)aBack 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-)rrr r.r/r0r1r rr4rr!lou_backTranslater r3r5r#r6r7r8rBr backTranslaterIGsz('y1L #E *E #e* - .E 5;;!11 2F !&,,"> ?FK(D!!(6 V\\ ! $Eekk! $Fi I  % %  e  f    i    [d; <  (D!!;'  1V\\M1299 '= :  n }  rc s\V4p\V4p\\V4\,4p\VP \ ,4p\VP \,4pRp\V\4'd\VP 4p\PVV\V4V\V4VRV4'g\RWV3,4h\V\4'd\V4VR&VPRVP \,P!\"\$R7#)aBack 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-)rrr r.r/r0r1r rr4rr!lou_backTranslateStringr r3r5r#r6r7rErFrbackTranslateStringrKs 'y1L #E *E #e* - .E 5;;!11 2F !&,,"> ?FK(D!!(6  + +  e  f      @& '  (D!!;' ::4 }4 5 < <#9 = rcs<\V4p\V4p\\V4\,4p\ VP ^,4p\PW1WEV4'g\RWV3,4hVP PR4#)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 %dr ) rrr r.r/r r0r! lou_hyphenater3r#)r9r:r<r=r>Z hyphen_string&&& r hyphenaterNs$'y1L #E *E #e* - .E(q9M  ! !,uT R R ;yQU>V V      % %g ..rcsv\V4p\PV4'g\RV,4hR#)a{Check 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)rr!lou_checkTabler3)r9r=rr checkTablerPs5'y1L  " "< 0 05 ABB 1rcs\V4p\V\4'dVPR4M \ V4p\ P W#4'g\RV: RV: 24hR#)a,Compile 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 r zCan't compile entry: tables z , inString N)rrrrrr!lou_compileStringr3)r9ZinStringr=ZinBytess&& r compileStringrRsY'y1L*4Xs*C*Choog&xG  % %l < <=F Q   =rcsd\V4pVPR4p\PW!4#)zGet 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 r )rrr!lou_getTypeformForEmphClass)r9Z emphClassr=s&& rgetTypeformForEmphClassrTs/'y1L  )I  / / HHrcs\V4p\V4p\\V4\,4p\ VP \,4p\PW!WC^4'g\RV: RV: 24hVPRVP \,P\\R7#)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 z#Can't convert dots to char: tables r)Nr-)rrr r.r/r r0r!lou_dotsToCharr3r5r#r6r7)r9r:r=rr@s&& r dotsToCharrVs'y1L #E *E 3u:. /F !&,,"> ?F  " "< J JAJE R   ::4 }4 5 < <#9 = rcs\V4p\V4p\\V4\,4p\ VP \,4p\PW1WTV4'g\RWV3,4hVPRVP \,P\\R7#)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-)rrr r.r/r r0r!lou_charToDotsr3r5r#r6r7)r9r:r<r=rr@rMr charToDotsrXs'y1L #E *E 3u:. /F !&,,"> ?F  " "< M M F& '   ::4 }4 5 < <#9 = rcsVe?\V\4'g)\RP\P44h\ P V4#)aDRegister 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} z,logCallback should be of type {} or NoneType)r LogCallbackZ TypeErrorZformat__name__r!lou_registerLogCallback)Z logCallback&rregisterLogCallbackr])sJ&z+{'K'K : A A+BVBV W    + +K 88rcsfV\9d\RV,4h\PV4#)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) logLevelsZ ValueErrorr!lou_setLogLevel)Zlevelr\r setLogLevelr`Cs.  I;eCDD  # #E **riiiiii'i Ni0ui@iPi`Z__main__s../tables/en-us-g2.ctbz Hello world!)r;r)Nra)Nra)ra)hZ__doc__ZsysrrrrZatexitrZctypesrrrrr r r r r rrZ_loaderZ _functypeZ ImportErrorr!Z _is_windowsZ _endiannessr&r/r1rr6rrr7rZlou_freer"ZrestyperDZargtypesr2rJrHrLrOrQrSrUrWrYr[r_r%r'rCrGrIrKrNrPrRrTrVrXr]r`Z plain_textZemph_1Z comp_emph_1ZitalicZemph_2Z comp_emph_2Z underlineZemph_3Z comp_emph_3ZboldZemph_4Zemph_5Zemph_6Zemph_7Zemph_8Zemph_9Zemph_10Zcomputer_brailleZ no_translateZ no_contractZnoContractionsZcompbrlAtCursorZdotsIOZcompbrlLeftCursorZucBrlZ noUndefinedZnoUndefinedDotsZ partialTransZLOG_ALLZ LOG_DEBUGZLOG_INFOZLOG_WARNZ LOG_ERRORZ LOG_FATALZLOG_OFFr^rZZprintr$rrrbs{**IH   )*GY # $'! 5(dd %%' }q(( +V0E0G!MA$5{#CCQ )#+A+    ' %  FO EN FO EN H FO  )%  FO EN FO EN H FO EN EN EN  #  FO EN FO EN H FO  - )  FO EN FO EN H FO EN EN EN  '#  FO  FO #%-; '/&:#1980D$$-  FO FO  $   FO FO  $ eX. +/ (#' %*H!2#:z*Z9x*Z/: C " I,294+ &&&v#)))y$$$t                    i8Y 7 S  z ') )./1 MNw)yGY)s N NN