OfSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK J r Sq /q S$SjrS%Sjr"SS\5r\R$"S5rSr\R$"S 5rS r\R$"S 5rS rS rSrSrSr"SS5r"SS5rS&SjrS'Sjr S'Sjr!S(Sjr"S(Sjr#S)Sjr$S)Sjr%Sr&Sr'Sr("SS 5r)S*S!jr*S"r+S#r,g)+N) ElementTreec[SUSS/US/S9qUb1[U[5(aUR 5n[ U5qgg)a Configure nltk's java interface, by letting nltk know where it can find the Java binary, and what extra options (if any) should be passed to Java when it is run. :param bin: The full path to the Java binary. If not specified, then nltk will search the system for a Java binary; and if one is not found, it will raise a ``LookupError`` exception. :type bin: str :param options: A list of options that should be passed to the Java binary when it is called. A common value is ``'-Xmx512m'``, which tells Java binary to increase the maximum heap size to 512 megabytes. If no options are specified, then do not modify the options list. :type options: list(str) javaJAVAHOME JAVA_HOMEzjava.exe)env_varsverbose binary_namesN) find_binary _java_bin isinstancestrsplitlist _java_options)binoptionsr s 0/usr/lib/python3/dist-packages/nltk/internals.py config_javarsR$ k* \ I gs # #mmoGW c[R[R[RS.nUR X"5nUR X35nUR XD5n[ U[ 5(a [S5e[c [5 [ U[ 5(aU/nO [U5n[RRRU5n[U5nSU/U-n[/[-U-n[R "XX4S9nU(dU$UR#5up4UR$S:wa+['[)U55 [+S[ U5-5eX44$)a Execute the given java command, by opening a subprocess that calls Java. If java has not yet been configured, it will be configured by calling ``config_java()`` with no arguments. :param cmd: The java command that should be called, formatted as a list of strings. Typically, the first string will be the name of the java class; and the remaining strings will be arguments for that java class. :type cmd: list(str) :param classpath: A ``':'`` separated list of directories, JAR archives, and ZIP archives to search for class files. :type classpath: str :param stdin: Specify the executed program's standard input file handles, respectively. Valid values are ``subprocess.PIPE``, an existing file descriptor (a positive integer), an existing file object, 'pipe', 'stdout', 'devnull' and None. ``subprocess.PIPE`` indicates that a new pipe to the child should be created. With None, no redirection will occur; the child's file handles will be inherited from the parent. Additionally, stderr can be ``subprocess.STDOUT``, which indicates that the stderr data from the applications should be captured into the same file handle as for stdout. :param stdout: Specify the executed program's standard output file handle. See ``stdin`` for valid values. :param stderr: Specify the executed program's standard error file handle. See ``stdin`` for valid values. :param blocking: If ``false``, then return immediately after spawning the subprocess. In this case, the return value is the ``Popen`` object, and not a ``(stdout, stderr)`` tuple. :return: If ``blocking=True``, then return a tuple ``(stdout, stderr)``, containing the stdout and stderr outputs generated by the java command if the ``stdout`` and ``stderr`` parameters were set to ``subprocess.PIPE``; or None otherwise. If ``blocking=False``, then return a ``subprocess.Popen`` object. :raise OSError: If the java command returns a nonzero return code. )pipestdoutdevnullzcmd should be a list of stringsz-cp)stdinrstderrrzJava command failed : ) subprocessPIPESTDOUTDEVNULLgetr r TypeErrorr rrospathpathsepjoinrPopen communicate returncodeprint_decode_stdoutdataOSError) cmd classpathrrrblockingsubprocess_output_dict classpathsps rrr?sD`##%% # & &u 4E # ' ' 7F # ' ' 7F#s9:: )S!![ )_ $$Z0I s)C ) s "C + % +C &HA }}V ||q  ().S9::  rc$\rSrSrSrSrSrSrg) ReadErrorz Exception raised by read_* functions when they fail. :param position: The index in the input string where an error occurred. :param expected: What was expected when an error occurred. cH[RXU5 XlX lgN) ValueError__init__expectedposition)selfr:r;s rr9ReadError.__init__sDH5  rc:SURSUR3$)Nz Expected z at r:r;r<s r__str__ReadError.__str__s4==/dmm_==rr?N)__name__ __module__ __qualname____firstlineno____doc__r9rA__static_attributes__rrr4r4s ! >rr4z[uU]?[rR]?(\"\"\"|\'\'\'|\"|\')c[RX5nU(d [SU5eURS5n[R "SU-5nUR 5nURX5nU(d [SU5eURS5S:XaUR 5S-nOOMP[XUR 55UR 54$![an[SU5UeSnAff=f) aM If a Python string literal begins at the specified position in the given string, then return a tuple ``(val, end_position)`` containing the value of the string literal and the position where it ends. Otherwise, raise a ``ReadError``. :param s: A string that will be checked to see if within which a Python string literal exists. :type s: str :param start_position: The specified beginning position of the string ``s`` to begin regex matching. :type start_position: int :return: A tuple containing the matched string literal evaluated as a string and the end position of the string literal. :rtype: tuple(str, int) :raise ReadError: If the ``_STRING_START_RE`` regex doesn't return a match in ``s`` at ``start_position``, i.e., open quote. If the ``_STRING_END_RE`` regex doesn't return a match in ``s`` at the end of the first match, i.e., close quote. :raise ValueError: If an invalid string (i.e., contains an invalid escape sequence) is passed into the ``eval``. :Example: >>> from nltk.internals import read_str >>> read_str('"Hello", World!', 0) ('Hello', 7) z open quotez\\|%sz close quoter\zvalid escape sequenceN) _STRING_START_REmatchr4grouprecompileendsearchevalr8)sstart_positionm quotemark_STRING_END_REr;rNes rread_strr[sD q1A  n55 IZZ9 45NuuwH %%a2M84 4 ;;q>T !yy{QH  HAuyy{34eiikAA H/@aGHs5*C C<* C77C<z-?\d+c[RX5nU(d [SU5e[UR 55UR 54$)a If an integer begins at the specified position in the given string, then return a tuple ``(val, end_position)`` containing the value of the integer and the position where it ends. Otherwise, raise a ``ReadError``. :param s: A string that will be checked to see if within which a Python integer exists. :type s: str :param start_position: The specified beginning position of the string ``s`` to begin regex matching. :type start_position: int :return: A tuple containing the matched integer casted to an int, and the end position of the int in ``s``. :rtype: tuple(int, int) :raise ReadError: If the ``_READ_INT_RE`` regex doesn't return a match in ``s`` at ``start_position``. :Example: >>> from nltk.internals import read_int >>> read_int('42 is the answer', 0) (42, 2) integer) _READ_INT_RErNr4intrOrRrUrVrWs rread_intras?: 1-A  >22 qwwy>1557 ""rz-?(\d*)([.]?\d*)?cz[RX5nU(a,URS5(d"URS5(d [SU5eURS5(a)[ UR55UR 54$[ UR55UR 54$)a: If an integer or float begins at the specified position in the given string, then return a tuple ``(val, end_position)`` containing the value of the number and the position where it ends. Otherwise, raise a ``ReadError``. :param s: A string that will be checked to see if within which a Python number exists. :type s: str :param start_position: The specified beginning position of the string ``s`` to begin regex matching. :type start_position: int :return: A tuple containing the matched number casted to a ``float``, and the end position of the number in ``s``. :rtype: tuple(float, int) :raise ReadError: If the ``_READ_NUMBER_VALUE`` regex doesn't return a match in ``s`` at ``start_position``. :Example: >>> from nltk.internals import read_number >>> read_number('Pi is 3.14159', 6) (3.14159, 13) rKnumber)_READ_NUMBER_VALUErNrOr4floatrRr_r`s r read_numberrgs:   3A QWWQZZ1771::.11wwqzzQWWY((1779~quuw&&rc\[U[R5(a~URRbgUR n[ URR5Vs/sH#nXR;dMURUPM% nn[U5S:$[S5es snf)a :return: True if ``method`` overrides some method with the same name in a base class. This is typically used when defining abstract base classes or interfaces, to allow subclasses to define either of two related methods: >>> class EaterI: ... '''Subclass must define eat() or batch_eat().''' ... def eat(self, food): ... if overridden(self.batch_eat): ... return self.batch_eat([food])[0] ... else: ... raise NotImplementedError() ... def batch_eat(self, foods): ... return [self.eat(food) for food in foods] :type method: instance method rKzExpected an instance method.) r types MethodType__self__ __class__rC_mro__dict__lenr")methodnameclsfuncss r overriddenrt@s&&%**++0I0I0UFOO556 6||# CLL 6  5zA~677 s $B);B)c[U[5(a UR$U/nURHnUR [ U55 M U$)aA Return the method resolution order for ``cls`` -- i.e., a list containing ``cls`` and all its base classes, in the order in which they would be checked by ``getattr``. For new-style classes, this is just cls.__mro__. For classic classes, this can be obtained by a depth-first left-to-right traversal of ``__bases__``. )r type__mro__ __bases__extendrm)rrmrobases rrmrm_sE#t{{eMMD JJtDz "" rcdSnUR(adURR5S-Ul[R"SURR 55nU(a [ U5nOSUlU=R[ R"SUSU3UUS-S9- slg) z4Add an epytext @field to a given object's docstring. z(?<=\n)[ ]+(?!\s)@:  initial_indentsubsequent_indentN)rGrstriprPfindall expandtabsmintextwrapfill)objfieldmessageindentindentss r_add_epytext_fieldrvs F {{kk((*V3 **13;;3I3I3KL \F KK8== E7"WI 6/Krc^U4SjnU$)a A decorator used to mark functions as deprecated. This will cause a warning to be printed the when the function is used. Usage: >>> from nltk.internals import deprecated >>> @deprecated('Use foo() instead') ... def bar(x): ... print(x/10) c&>^^STRST3mS[R"TSSS9-mUU4SjnURR TR5 TRUlTR UlSUl[UST5 U$) Nz Function z() has been deprecated.   rcH>[R"T[SS9 T"U0UD6$)Nrccategory stacklevel)warningswarnDeprecationWarning)argskwargsfuncmsgs rnewFunc.deprecated..decorator..newFuncs$ MM#(:q I(( (rT deprecated)rCrrrnupdaterG__deprecated__r)rrrrs` @r decoratordeprecated..decorators$--(A'KX]]3ttTT )  .==,,!%7L':rrI)rrs` rrrs" rc\rSrSrSrSrSrg) Deprecatedia A base class used to mark deprecated classes. A typical usage is to alert users that the name of a class has changed: >>> from nltk.internals import Deprecated >>> class NewClassName: ... pass # All logic goes here. ... >>> class OldClassName(Deprecated, NewClassName): ... "Use NewClassName instead." The docstring of the deprecated class will be used in the deprecation warning message. cSn[U5Hn[UR;dMUn O U(dS5eUR=(d SR 5n[ R "SSU5n[ R "SSU5nSUR-nX:waUSUR-- nUSU3nS[R"US S S 9-n[R"U[S S 9 [RU5$) Nz-Unable to determine which base is deprecated.r}z\A\s*@deprecated:z(?m)^\s*zClass %sz (base class for %s)z has been deprecated. rrrrcr)rmrrxrGstriprPsubrCrrrrrobject__new__)rrrrdep_clsr{docrqrs rrDeprecated.__new__sIDT^^+GGGwoo+ff)34ff["c*G,,, > *S\\9 9D-cU3X]]3vQWXX c$61E~~c""rrIN)rCrDrErFrGrrHrIrrrrs  #rrc(\rSrSrSrSSjrSrSrg)Counteriz= A counter that auto-increments each time its value is read. cXlgr7_value)r< initial_values rr9Counter.__init__s# rcDU=RS- slUR$NrKrr@s rr! Counter.gets q {{rrN)r)rCrDrErFrGr9r!rHrIrrrrs$rrc # # U/U=(d /-n[U[5(de[U[5(ae[U[5(ae[U[5(aUR5nSnUGHn[RR X5n [RR U 5(aU(a[SUSU S35 SnU v [RR U5(aU(a[SUSUS35 SnUv [RR USU5n [RR U 5(dMU(a[SUSU S35 SnU v GM UGHn U [R;dMU(aSn[RU v [RU R[R5GHn [RR U 5(aU(a[SUSU S35 SnU v UHn[RR X5n [RR U 5(aU(a[SUSU S35 SnU v [RR U SU5n [RR U 5(dMU(a[SUSU S35 SnU v M GM GM UHWn UHNn[RR X5n [RR U 5(dMHSnU v MP MY [RS:XaUHn[R"S U/[R[RS 9n U R5up[U5R!5nUR#U5(aC[RR%U5(aU(a[SUSUS35 SnUv M U(dlS U-nU(a US US -- nUS- nU(a US- nUSR SU55- nU(a USUSUS3- nSn[-SUSUSU35eg![&[([*4a ef=f!f=f7f)a Search for a file to be used by nltk. :param filename: The name or path of the file. :param env_vars: A list of environment variable names to check. :param file_names: A list of alternative file names to check. :param searchpath: List of directories to search. :param url: URL presented to user for download help. :param verbose: Whether or not to print path when a file is found. F[Found r]Tfilerposixwhich)rrzSNLTK was unable to find the %s file! Use software specific configuration parametersz# or set the %s environment variabler. Searched in:r}c3,# UH nSU-v M g7fz - %sNrI.0ds r !find_file_iter..j@ZK===========================================================================r~rN)r rrr#r$r&isfiler*environr%rqrr'rr(r+rendswithexistsKeyboardInterrupt SystemExitr, LookupError)filenamer searchpath file_namesurlr finding_diryielded alternative path_to_fileenv_varenv_dir directoryr2rrr$rdivs rfind_file_iterrs3&z/R0J h $ $$ $*c*** **c*** *(C  >>#G" ww||H: 77>>, ' 'zL>;<G  77>>+ & &zK=:;G ww||HfkB 77>>, ' 'zL>;<G '", bjj jj))::g.44RZZ@77>>'**zG9A>?"G!M#-K#%77<<#ELww~~l33"!GH:R ~Q"GH"&** $&77<< #LLww~~l33"!GH:R ~Q"GH"&**#$.A D %K77<< ?Lww~~l++"" &  ww'%K $$k*%??%?? "#)&1779==--"''..2F2FzD6;<"GJ#&&  ')1 2  88A;F FC s   ' 'C 277@Z@@ @C  3H:]3%qQ QCDRuBse455  &z7;  sFE*S&0# UH%n[RRTU5v M' g7fr7)r#r$r&)r path_to_jarjar_envs rr find_jar_iter..s*+>K Wk::+>s-0zNLTK was unable to find %s!z Set the %s environment variablerrrrrr}c3,# UH nSU-v M g7frrIrs rrr0rrz. For more information, on {}, see: <{}>rr~r)r rrrr#r$rrrr% expanduserbasenamerPrNr*isdirr&listdirrrformat) name_patternrrrrr is_regexrrr.cpr file_namejar_iterrrrrs @r find_jar_iterrsu* lC ( (( (*c*** *(C  >>#G}tH~-H 77>>+ & &G !,}[MJ   bjj +%JJ{3 #//"''//:B++B/Bww~~b))#%77#3#3B#7$ " @ @$,1I& % ~Rt1&E F&*G"$Hww}}R(('!ww~~bggll2.LMM#*$)GL>B4q*I$J*.&(ggll2&D D N.0ZZ^ #%88L#D#D'.(-1=02 R0K-.)*/3G*,'',,r*E$E. " $,Kww~~k22#%77#3#3K#@$ " @ @$,H1I& % ~R }A&N O&*G"--$,e@ JJy1 ggll9? 77>>+..xx 77"!GH:R }A"FG!!2'',,y?Kww~~k**GL>K=BC!!! $ +l:  5 C CCmmC#IddS  ' 'C 277@Z@@ @C  FMM CDRuBse455 s6B )> %DIy':H  T$: %)>  sA A- c[U[5(dU$[[RS[ R "55nUcUR5$URU5$)z/Convert data read from stdout/stderr to unicodeencoding)r bytesgetattrsys __stdout__localegetpreferredencodingdecode) stdoutdatar s rr+r+RsV j% ( (s~~z63N3N3PQH  ""   X &&rc[Rn[RVs/sH o"S;dM UPM sn[l[U5nU[lU$s snf)a When python is run from within the nltk/ directory tree, the current directory is included at the beginning of the search path. Unfortunately, that means that modules within nltk can sometimes shadow standard library modules. As an example, the stdlib 'inspect' module will attempt to import the stdlib 'tokenize' module, but will instead end up importing NLTK's 'tokenize' module instead (causing the import to fail). )r}r)rr$ __import__)moduleold_pathrrWs rimport_from_stdlibrbsGxxH88:8a '98:CH6ACH H;s AAc\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSrSrSrSrSSjrSrSrSrSrg)ElementWrapperixa~ A wrapper around ElementTree Element objects whose main purpose is to provide nicer __repr__ and __str__ methods. In addition, any of the wrapped Element's methods that return other Element objects are overridden to wrap those values before returning them. This makes Elements more convenient to work with in interactive sessions and doctests, at the expense of some efficiency. cb[U[5(aU$[R[5$)z Create and return a wrapper around a given Element object. If ``etree`` is an ``ElementWrapper``, then ``etree`` is returned as-is. )r rrr)rretrees rrElementWrapper.__new__s% e^ , ,L>>.1 1rcv[U[5(a[R"U5nXRS'g)a Initialize a new Element wrapper for ``etree``. If ``etree`` is a string, then it will be converted to an Element object using ``ElementTree.fromstring()`` first: >>> ElementWrapper("") \n"> _etreeN)r rr fromstringrn)r<rs rr9ElementWrapper.__init__s- eS ! !**51E"' hrcUR$)z4 Return the Element object wrapped by this wrapper. r r@s runwrapElementWrapper.unwraps{{rc[R"URSS9RS5n[ U5S:a1UR S5n[ U5U- S:aSnUSSSXS3nSU-$) Nutf8r <<iz...z )rtostringr rrorfind)r<rUrZs r__repr__ElementWrapper.__repr__su  v > E Ef M q6B; AA b Sb6(#aeW%A!!rcz[R"URSS9RS5R 5$)z[ :return: the result of applying ``ElementTree.tostring()`` to the wrapped Element object. r(r))rr-r rrr@s rrAElementWrapper.__str__s1  v > E Ef M T T V rc.[URU5$r7)rr )r<attribs r __getattr__ElementWrapper.__getattr__st{{F++rc.[URX5$r7)setattrr )r<attrvalues r __setattr__ElementWrapper.__setattr__st{{D00rc.[URU5$r7)delattrr )r<r9s r __delattr__ElementWrapper.__delattr__st{{D))rc X RU'gr7r$)r<indexelements r __setitem__ElementWrapper.__setitem__s$ ErcURU gr7r$r<rBs r __delitem__ElementWrapper.__delitem__s KK rcX0RX&gr7r$)r<startstopelementss r __setslice__ElementWrapper.__setslice__s"* Erc URX2 gr7r$)r<rKrLs r __delslice__ElementWrapper.__delslice__s KK #rc,[UR5$r7)ror r@s r__len__ElementWrapper.__len__s4;;rc2[URU5$r7)rr rGs r __getitem__ElementWrapper.__getitem__sdkk%011rc\URXVs/sHn[U5PM sn$s snfr7r r)r<rKrLelts r __getslice__ElementWrapper.__getslice__s*/3{{5/FG/Fs#/FGGGs)cXURVs/sHn[U5PM sn$s snfr7rZ)r<r[s r getchildrenElementWrapper.getchildrens#/3{{;{s#{;;;s'NcFSURRU55$)Nc38# UHn[U5v M g7fr7)r)rr[s rr-ElementWrapper.getiterator..sL/Ks##/Ks)r  getiterator)r<tags rrdElementWrapper.getiteratorsLt{{/F/Fs/KLLrcJ[URRX55$r7)rr  makeelement)r<rer4s rrhElementWrapper.makeelementsdkk55cBCCrcXURRU5nUcU$[U5$r7)r findrr<r$r[s rrkElementWrapper.finds+kkt$ ;J!#& &rcvURRU5Vs/sHn[U5PM sn$s snfr7)r rrrls rrElementWrapper.findalls0/3{{/B/B4/HI/Hs#/HIIIs6rIr7)rCrDrErFrGrr9r%r/rAr5r;r?rDrHrNrQrTrWr\r_rdrhrkrrHrIrrrrxso  2 (" ,1*%+$ 2H<MD'JrrcBURURpCU(aJURnUcSnUS:a[U[ XC55up4O[U[ X455up4X4U4$URS;a"[ SUR R-5eUcSnUc [U5nUS:a[S[U5U-5nUS:a[S[U5U-5nUS:aXS-  [X45nX44$![a [U5nN%f=f)a Given a slice, return the corresponding (start, stop) bounds, taking into account None indices and negative indices. The following guarantees are made for the returned start and stop values: - 0 <= start <= len(sequence) - 0 <= stop <= len(sequence) - start <= stop :raise ValueError: If ``slice_obj.step`` is not None. :param allow_step: If true, then the slice object may have a non-None step. If it does, then return a tuple (start, stop, step). rKrrz)slices with steps are not supported by %s) rKrLstep slice_boundsslicer8rlrCromax IndexErrorr)sequence slice_obj allow_steprKrLrqs rrrrrs2??INN4~~ <D !8&xt1CDKE4&xu1CDKED   y ( 7(:L:L:U:U U   } |8} qyAs8}u,- ax1c(md*+  ax ! AX   E ; !x=D !s1DDDc[RRU5(dg[[S5(a[R"U5n[R "UR 5nUS-(agUR[R"5:Xa US-(agUR[R"5/[R"5-;a US-(aggg)NFgetuidrcT) r#r$rhasattrstatS_IMODEst_modest_uidrzst_gidgetgid getgroups)r$statdataperms r is_writablerAs 77>>$  r8774=||H,,- %< __ +oo"))+!??dUl rc ~[S[U5R<SU<S[U5R<S35e)Nzunorderable types: z()  z())r"rvrC)orderingabs rraise_unorderable_typesras/  7  XtAw'7'7 9 r)NNF)NNNNT)rIrINNFF)rIrINNF)NrIrINNF)NrIrINFF)F)-rrr#rPr~rrrrir xml.etreerr rrrr8r4rQrMr[r^rarergrtrmrrrrrrrrr rrr r+rrrrrrrIrrrs   !   &@W~ > > ::@A8Hvzz(#  #FZZ 45#'V8>.*@)#)#b  ( @6HNSNS  6   $   K6`     '  ,zJzJD?N@r