fQ dZddlmZmZmZddlmZddlmZm Z m Z m Z m Z m Z mZmZmZ ddlmZmZeecZZedZedk(Zej1Zded zzZerd neZd ed zzZd Zd5dZdZeefdZ eejBe ejD_#e ej0_#e ee ee ee ee eeee e fejH_%e ee ee ee ee eeee ee ee ee e f ejL_%e ee ee ee ee eeee e fejN_%e ee ee ee ee eeee ee ee ee e f ejP_%e ee e ee e fejR_%e fejT_%e e fejV_%e e fejX_%e ee ee e e fejZ_%e ee ee e e fej\_%ede e Z/dej`_#dejb_#e fejb_%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`eaebfZcedd0k(r eee2eee4d1gd2d34yy#e$r e e cZZY$wxYw)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 dj|Dcgc]2}t|tr|jtn t |4c}Scc}w)z*Creates a tables string for liblouis calls,)join isinstancestrencodefileSystemEncodingbytes) tablesListxs 0/usr/lib/python3/dist-packages/louis/__init__.py_createTablesStringr"UsL 99  -7q#,>AHH' (E!H L   s7ANc6|r t|z|St|zS)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 }  r'c @t|}t|}tt|tz}t|j t z}t|j tz}d}|rt|j |}tj||t||t||d|std|d|d|d|t|trt||dd|jd|j tzj!t"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 Nr9r:r;r<r=)r"r-r r>r?r@rArr&r0lou_translateStringrrCrrDrEr2rFrG rIrJr%rLrMrNrOrPrQs r!translateStringrXs 'y1L #E *E #e* - .E 5;;!11 2F !&,,"> ?FK(x@  ' '  e  f    %4 1  (D!;' ::4 }4 5 < <#9 = r'c,t|}t|}tt|tz}t|j t z}t|j tz}d} t|trt|j } t|j z} t|j z} t|}tj||t||t|| d| | t|| std|||||fzt|trt| |dd|jd|j tzj!t"t$| d|j | d|j |j fS)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"r-r r>r?r@rArrrDr&r0lou_backTranslaterrCrEr2rFrGrHs r! backTranslater[Fss('y1L #E *E #e* - .E 5;;!11 2F !&,,"> ?FK(D!(6 V\\ ! $Eekk! $Fi I  % %  e  f    i   [%9d; <  (D!;'  1V\\M1299 '= :  n }  r'c Nt|}t|}tt|tz}t|j t z}t|j tz}d}t|trt|j }tj||t||t||d|std|||fzt|trt||dd|jd|j tzj!t"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"r-r r>r?r@rArrrDr&r0lou_backTranslateStringrrCrEr2rFrGrWs r!backTranslateStringr^s  'y1L #E *E #e* - .E 5;;!11 2F !&,,"> ?FK(D!(6  + +  e  f     @%& '  (D!;' ::4 }4 5 < <#9 = r'ct|}t|}tt|tz}t |j dz}tj|||||std|||fz|j jdS)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/) r"r-r r>r?rr@r0 lou_hyphenaterCr2)rIrJrLrMrN hyphen_strings r! hyphenatercs$'y1L #E *E #e* - .E(q9M  ! !,umT R ;y%QU>V V      % %g ..r'c`t|}tj|std|zy)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"r0lou_checkTablerC)rIrMs r! checkTablerfs2'y1L  " "< 05 ABB 1r'ct|}t|tr|jdn t |}t j ||std|d|y)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 r/zCan't compile entry: tables z , inString N)r"rrrrr0lou_compileStringrC)rIinStringrMinBytess r! compileStringrksU'y1L*4Xs*Choog&xG  % %lG <=F Q   =r'cft|}|jd}tj||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 r/)r"rr0lou_getTypeformForEmphClass)rI emphClassrMs r!getTypeformForEmphClassros1'y1L  )I  / / i HHr'cbt|}t|}tt|tz}t |j tz}tj||||dstd|d||jd|j tzjttS)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"r-r r>r?rr@r0lou_dotsToCharrCrEr2rFrG)rIrJrMr$rPs r! dotsToCharrrs'y1L #E *E 3u:. /F !&,,"> ?F  " "< JAJE R   ::4 }4 5 < <#9 = r'cbt|}t|}tt|tz}t |j tz}tj|||||std|||fz|jd|j tzjttS)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"r-r r>r?rr@r0lou_charToDotsrCrEr2rFrG)rIrJrLrMr$rPs r! charToDotsrus'y1L #E *E 3u:. /F !&,,"> ?F  " "< M F%& '   ::4 }4 5 < <#9 = r'c|8t|ts(tdjtjt j |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} z,logCallback should be of type {} or NoneType)r LogCallback TypeErrorformat__name__r0lou_registerLogCallback) logCallbacks r!registerLogCallbackr}(sG&z+{'K : A A+BVBV W    + +K 88r'cX|tvrtd|ztj|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 ValueErrorr0lou_setLogLevel)levels r! setLogLevelrBs.  I;eCDD  # #E **r'r` @iiiii'i Ni0ui@iPi`__main__s../tables/en-us-g2.ctbz Hello world!)rKr*)Nrr)Nr)r)f__doc__sysrrratexitrctypesrrr r r r r rrrr_loader _functype ImportErrorr0 _is_windowsr6r?rArrFr"r&rGr-lou_freer1restyperVargtypesrBr]rZrarerhrmrqrtrwr{rr4r7rTrXr[r^rcrfrkrorrrur}r 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_OFFrrzprintr3r'r!rsg**>=   )*GY # $'! %%' }q(( +V0E0G!MA$56Q )#+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 MNu)yGY)s M MM