𝗖𝗨𝗥𝗥𝗘𝗡𝗧 𝗙𝗜𝗟𝗘 : /opt/alt/python33/lib64/python3.3/Tools/scripts/__pycache__//fixdiv.cpython-33.pyc
�
�� f}6 c @ s� d Z d d l Z d d l Z d d l Z d d l Z d a d d � Z d d � Z d Z d d � Z d
d � Z
d d
� Z d d � Z Gd d � d � Z
d d � Z d d � Z e d k r� e j e � � n d S( u fixdiv - tool to fix division operators.
To use this tool, first run `python -Qwarnall yourscript.py 2>warnings'.
This runs the script `yourscript.py' while writing warning messages
about all uses of the classic division operator to the file
`warnings'. The warnings look like this:
<file>:<line>: DeprecationWarning: classic <type> division
The warnings are written to stderr, so you must use `2>' for the I/O
redirect. I know of no way to redirect stderr on Windows in a DOS
box, so you will have to modify the script to set sys.stderr to some
kind of log file if you want to do this on Windows.
The warnings are not limited to the script; modules imported by the
script may also trigger warnings. In fact a useful technique is to
write a test script specifically intended to exercise all code in a
particular module or set of modules.
Then run `python fixdiv.py warnings'. This first reads the warnings,
looking for classic division warnings, and sorts them by file name and
line number. Then, for each file that received at least one warning,
it parses the file and tries to match the warnings up to the division
operators found in the source code. If it is successful, it writes
its findings to stdout, preceded by a line of dashes and a line of the
form:
Index: <file>
If the only findings found are suggestions to change a / operator into
a // operator, the output is acceptable input for the Unix 'patch'
program.
Here are the possible messages on stdout (N stands for a line number):
- A plain-diff-style change ('NcN', a line marked by '<', a line
containing '---', and a line marked by '>'):
A / operator was found that should be changed to //. This is the
recommendation when only int and/or long arguments were seen.
- 'True division / operator at line N' and a line marked by '=':
A / operator was found that can remain unchanged. This is the
recommendation when only float and/or complex arguments were seen.
- 'Ambiguous / operator (..., ...) at line N', line marked by '?':
A / operator was found for which int or long as well as float or
complex arguments were seen. This is highly unlikely; if it occurs,
you may have to restructure the code to keep the classic semantics,
or maybe you don't care about the classic semantics.
- 'No conclusive evidence on line N', line marked by '*':
A / operator was found for which no warnings were seen. This could
be code that was never executed, or code that was only executed
with user-defined objects as arguments. You will have to
investigate further. Note that // can be overloaded separately from
/, using __floordiv__. True division can also be separately
overloaded, using __truediv__. Classic division should be the same
as either of those. (XXX should I add a warning for division on
user-defined objects, to disambiguate this case from code that was
never executed?)
- 'Phantom ... warnings for line N', line marked by '*':
A warning was seen for a line not containing a / operator. The most
likely cause is a warning about code executed by 'exec' or eval()
(see note below), or an indirect invocation of the / operator, for
example via the div() function in the operator module. It could
also be caused by a change to the file between the time the test
script was run to collect warnings and the time fixdiv was run.
- 'More than one / operator in line N'; or
'More than one / operator per statement in lines N-N':
The scanner found more than one / operator on a single line, or in a
statement split across multiple lines. Because the warnings
framework doesn't (and can't) show the offset within the line, and
the code generator doesn't always give the correct line number for
operations in a multi-line statement, we can't be sure whether all
operators in the statement were executed. To be on the safe side,
by default a warning is issued about this case. In practice, these
cases are usually safe, and the -m option suppresses these warning.
- 'Can't find the / operator in line N', line marked by '*':
This really shouldn't happen. It means that the tokenize module
reported a '/' operator but the line it returns didn't contain a '/'
character at the indicated position.
- 'Bad warning for line N: XYZ', line marked by '*':
This really shouldn't happen. It means that a 'classic XYZ
division' warning was read with XYZ being something other than
'int', 'long', 'float', or 'complex'.
Notes:
- The augmented assignment operator /= is handled the same way as the
/ operator.
- This tool never looks at the // operator; no warnings are ever
generated for use of this operator.
- This tool never looks at the / operator when a future division
statement is in effect; no warnings are generated in this case, and
because the tool only looks at files for which at least one classic
division warning was seen, it will never look at files containing a
future division statement.
- Warnings may be issued for code not read from a file, but executed
using the exec() or eval() functions. These may have
<string> in the filename position, in which case the fixdiv script
will attempt and fail to open a file named '<string>' and issue a
warning about this failure; or these may be reported as 'Phantom'
warnings (see above). You're on your own to deal with these. You
could make all recommended changes and add a future division
statement to all affected files, and then re-run the test script; it
should not issue any warnings. If there are any, and you have a
hard time tracking down where they are generated, you can use the
-Werror option to force an error instead of a first warning,
generating a traceback.
- The tool should be run from the same directory as that from which
the original script was run, otherwise it won't be able to open
files given by relative pathnames.
i Nc
C sz y) t j t j d d � d � \ } } Wn6 t j k
ra } z t | � d SWYd d } ~ Xn XxC | D]; \ } } | d k r� t t � d S| d k ri d a qi qi W| s� t d � d S| d d � r� t j j d t j d � n t
| d � } | d k r d St | j
� � } | s6t d | d � d S| j � d } x- | D]% } t | | | � } | po| } qMW| S(
Ni u hmi u -hu -mu& at least one file argument is requiredu! %s: extra file arguments ignored
i u& No classic division warnings read from( u getoptu sysu argvu erroru usageu printu __doc__u multi_oku stderru writeu readwarningsu Noneu listu keysu sortu process(
u optsu argsu msgu ou au warningsu filesu exitu filenameu x( ( u9 /opt/alt/python33/lib64/python3.3/Tools/scripts/fixdiv.pyu main� s: )
u mainc C s[ t j j d t j d | f � t j j d t j d � t j j d t j d � d S( Nu %s: %s
i u Usage: %s [-m] warnings
u" Try `%s -h' for more information.
( u sysu stderru writeu argv( u msg( ( u9 /opt/alt/python33/lib64/python3.3/Tools/scripts/fixdiv.pyu usage� s !u usageuL ^(.+?):(\d+): DeprecationWarning: classic (int|long|float|complex) division$c C s9 t j t � } y t | � } Wn= t k
r^ } z t j j d | � d SWYd d } ~ Xn Xi } x� | j � } | s~ Pn | j | � } | s� | j
d � d k rh t j j d | � qh qh n | j � \ } } } | j | � }
|
d k rg | | <}
n |
j t | � t j | � f � qh | j � | S( Nu can't open: %s
u divisioni u Warning: ignored input ( u reu compileu PATTERNu openu IOErroru sysu stderru writeu readlineu matchu findu groupsu getu Noneu appendu intu internu close( u warningsfileu progu fu msgu warningsu lineu mu filenameu linenou whatu list( ( u9 /opt/alt/python33/lib64/python3.3/Tools/scripts/fixdiv.pyu readwarnings� s. %
u readwarningsc C s� t d d � | s t � y t | � } Wn= t k
ri } z t j j d | � d SWYd d } ~ Xn Xt d | � t | � } | j � d } t j
| j � } x t | � \ } } } }
| d k r� Pn | | k o� d k n s� t � g } xE | t | � k r@| | d | k r@| j | | � | d 7} q� W| rWt | | � n g } xE | t | � k r�| | d | k r�| j | | � | d 7} q`W| r�| r�q� | r�| r�t | d � q� | r�| r�t | | � q� t | � d k r�t s�g }
d } x? | D]7 \ \ } } } | | k r?qn |
j | � | } qW|
sbt � t |
� d k r�t d |
d � q�t d d
d �t d |
d |
d f � q�n g } g } g } xY | D]Q \ } } | d k r�| j | � q�| d k r| j | � q�| j | � q�Wd } xt| D]l\ \ } } } | | k rYq5n | } t | � } | | | d � d k r�t d | � t d | � q5n | r�t d | | � t d | � q5| r1| r1t d | | f � t d | � t d � t d | d | � d | | d � � q5| r\| r\t d | � t d | � q5| r5| r5t d d j | � d j | � | f � t d | � q5q5Wq� | j � d S(! Nu -iF u can't open: %s
i u Index:i u No conclusive evidenceu$ *** More than one / operator in lineu* *** More than one / operator per statementu endu u in lines %d-%du intu longu floatu complexu /u) *** Can't find the / operator in line %d:u *u *** Bad warning for line %d:u %dc%du <u ---u >u$ True division / operator at line %d:u =u- *** Ambiguous / operator (%s, %s) at line %d:u |u ?i����( u intu long( u floatu complex( u printu AssertionErroru openu IOErroru sysu stderru writeu FileContextu sortu tokenizeu generate_tokensu readlineu scanlineu Noneu lenu appendu reportphantomwarningsu reportu multi_oku chopu joinu close( u filenameu listu fpu msgu fu indexu gu startlinenou endlinenou slashesu lineinfou orphansu warningsu rowsu lastrowu rowu colu lineu intlongu floatcomplexu badu linenou what( ( u9 /opt/alt/python33/lib64/python3.3/Tools/scripts/fixdiv.pyu process� s�
"))
"
,
#u processc C s� g } d } d } xF | D]> \ } } | | k rJ | g } | j | � n | j | � q WxX | D]P } | d } d j | d d � � } t d | | f � | j | d d �qb Wd S( Ni u /i u$ *** Phantom %s warnings for line %d:u marku *( u Noneu appendu joinu printu report( u warningsu fu blocksu lastrowu lastblocku rowu whatu blocku whats( ( u9 /opt/alt/python33/lib64/python3.3/Tools/scripts/fixdiv.pyu reportphantomwarnings$ s
u reportphantomwarningsc C sc d } xV | D]N \ \ } } } | | k r
t d | | f � t d t | � � | } q
q
Wd S( Nu *** %s on line %d:u *( u Noneu printu chop( u slashesu messageu lastrowu rowu colu line( ( u9 /opt/alt/python33/lib64/python3.3/Tools/scripts/fixdiv.pyu report3 s u reportc B sh | Ee Z d Z d d d d � Z d d � Z d d � Z d d
� Z d d � Z d d
d d � Z d S( u FileContexti i c C s: | | _ d | _ d | _ d | _ g | _ g | _ d S( Ni i i ( u fpu windowu linenou eoflookaheadu lookaheadu buffer( u selfu fpu windowu lineno( ( u9 /opt/alt/python33/lib64/python3.3/Tools/scripts/fixdiv.pyu __init__< s u FileContext.__init__c C s_ xX t | j � | j k rZ | j rZ | j j � } | sG d | _ Pn | j j | � q Wd S( Ni ( u lenu lookaheadu windowu eoflookaheadu fpu readlineu append( u selfu line( ( u9 /opt/alt/python33/lib64/python3.3/Tools/scripts/fixdiv.pyu fillC s % u FileContext.fillc C sL | j � | j s d S| j j d � } | j j | � | j d 7_ | S( Nu i i ( u fillu lookaheadu popu bufferu appendu lineno( u selfu line( ( u9 /opt/alt/python33/lib64/python3.3/Tools/scripts/fixdiv.pyu readlineJ s
u FileContext.readlinec C s | j t d � =d S( N( u bufferu window( u self( ( u9 /opt/alt/python33/lib64/python3.3/Tools/scripts/fixdiv.pyu truncateR s u FileContext.truncatec C s� | j � | j t | j � } | j t | j � } | | k oP | j k n rd | j | | S| j | k o~ | k n r� | j | | j St � d S( N( u fillu linenou lenu bufferu lookaheadu KeyError( u selfu indexu bufstartu lookend( ( u9 /opt/alt/python33/lib64/python3.3/Tools/scripts/fixdiv.pyu __getitem__T s
u FileContext.__getitem__u *c
C ss | d k r | } n xW t | | d � D]B } y | | } Wn t k
rW d } Yn Xt | t | � � q) Wd S( Ni u <missing line>( u Noneu rangeu KeyErroru printu chop( u selfu firstu lastu marku iu line( ( u9 /opt/alt/python33/lib64/python3.3/Tools/scripts/fixdiv.pyu report] s
u FileContext.reportN(
u __name__u
__module__u __qualname__u __init__u fillu readlineu truncateu __getitem__u Noneu report( u
__locals__( ( u9 /opt/alt/python33/lib64/python3.3/Tools/scripts/fixdiv.pyu FileContext; s u FileContextc C s� g } d } d } xq | D]i \ } } } } } | d } | d k rM | } n | d k ro | j | | f � n | t j k r Pq q W| | | f S( Ni u /u /=( u /u /=( u Noneu appendu tokenizeu NEWLINE( u gu slashesu startlinenou endlinenou typeu tokenu startu endu line( ( u9 /opt/alt/python33/lib64/python3.3/Tools/scripts/fixdiv.pyu scanlineg s
u scanlinec C s% | j d � r | d d � S| Sd S( Nu
i i����( u endswith( u line( ( u9 /opt/alt/python33/lib64/python3.3/Tools/scripts/fixdiv.pyu chopu s u chopu __main__( u __doc__u sysu getoptu reu tokenizeu multi_oku mainu usageu PATTERNu readwarningsu processu reportphantomwarningsu reportu FileContextu scanlineu chopu __name__u exit( ( ( u9 /opt/alt/python33/lib64/python3.3/Tools/scripts/fixdiv.pyu <module>� s" W , 