Baoding-FenShuaJiang
/
Green_GoodERP18_FSJ_Standard
Observar 1
Favorito 0
Wiki 捐赠
gooderp18绿色标准版
Você não pode selecionar mais de 25 tópicos Os tópicos devem começar com uma letra ou um número, podem incluir traços ('-') e podem ter até 35 caracteres.
Tag: 0f75e31513
Branches Tags
${ item.name }
Criar branch ${ searchTerm }
de 0f75e31513
${ noResults }
Green_GoodERP18_FSJ_Standard/python/Doc/html/library/2to3.html

910 linhas
73KB
Original Anotar Histórico 

  1. <!DOCTYPE html>

  2. 

  3. <html lang="en" data-content_root="../">

  4.   <head>

  5.     <meta charset="utf-8" />

  6.     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />

  7. <meta property="og:title" content="2to3 — Automated Python 2 to 3 code translation" />

  8. <meta property="og:type" content="website" />

  9. <meta property="og:url" content="https://docs.python.org/3/library/2to3.html" />

  10. <meta property="og:site_name" content="Python documentation" />

  11. <meta property="og:description" content="2to3 is a Python program that reads Python 2.x source code and applies a series of fixers to transform it into valid Python 3.x code. The standard library contains a rich set of fixers that will ha..." />

  12. <meta property="og:image" content="https://docs.python.org/3/_static/og-image.png" />

  13. <meta property="og:image:alt" content="Python documentation" />

  14. <meta name="description" content="2to3 is a Python program that reads Python 2.x source code and applies a series of fixers to transform it into valid Python 3.x code. The standard library contains a rich set of fixers that will ha..." />

  15. <meta property="og:image:width" content="200" />

  16. <meta property="og:image:height" content="200" />

  17. <meta name="theme-color" content="#3776ab" />

  18. 

  19.     <title>2to3 — Automated Python 2 to 3 code translation &#8212; Python 3.12.3 documentation</title><meta name="viewport" content="width=device-width, initial-scale=1.0">

  20.     

  21.     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=80d5e7a1" />

  22.     <link rel="stylesheet" type="text/css" href="../_static/pydoctheme.css?v=bb723527" />

  23.     <link id="pygments_dark_css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css" href="../_static/pygments_dark.css?v=b20cc3f5" />

  24.     

  25.     <script src="../_static/documentation_options.js?v=2c828074"></script>

  26.     <script src="../_static/doctools.js?v=888ff710"></script>

  27.     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>

  28.     

  29.     <script src="../_static/sidebar.js"></script>

  30.     

  31.     <link rel="search" type="application/opensearchdescription+xml"

  32.           title="Search within Python 3.12.3 documentation"

  33.           href="../_static/opensearch.xml"/>

  34.     <link rel="author" title="About these documents" href="../about.html" />

  35.     <link rel="index" title="Index" href="../genindex.html" />

  36.     <link rel="search" title="Search" href="../search.html" />

  37.     <link rel="copyright" title="Copyright" href="../copyright.html" />

  38.     <link rel="next" title="test — Regression tests package for Python" href="test.html" />

  39.     <link rel="prev" title="unittest.mock — getting started" href="unittest.mock-examples.html" />

  40.     <link rel="canonical" href="https://docs.python.org/3/library/2to3.html" />

  41.     

  42.       

  43.     

  44. 

  45.     

  46.     <style>

  47.       @media only screen {

  48.         table.full-width-table {

  49.             width: 100%;

  50.         }

  51.       }

  52.     </style>

  53. <link rel="stylesheet" href="../_static/pydoctheme_dark.css" media="(prefers-color-scheme: dark)" id="pydoctheme_dark_css">

  54.     <link rel="shortcut icon" type="image/png" href="../_static/py.svg" />

  55.             <script type="text/javascript" src="../_static/copybutton.js"></script>

  56.             <script type="text/javascript" src="../_static/menu.js"></script>

  57.             <script type="text/javascript" src="../_static/search-focus.js"></script>

  58.             <script type="text/javascript" src="../_static/themetoggle.js"></script> 

  59. 

  60.   </head>

  61. <body>

  62. <div class="mobile-nav">

  63.     <input type="checkbox" id="menuToggler" class="toggler__input" aria-controls="navigation"

  64.            aria-pressed="false" aria-expanded="false" role="button" aria-label="Menu" />

  65.     <nav class="nav-content" role="navigation">

  66.         <label for="menuToggler" class="toggler__label">

  67.             <span></span>

  68.         </label>

  69.         <span class="nav-items-wrapper">

  70.             <a href="https://www.python.org/" class="nav-logo">

  71.                 <img src="../_static/py.svg" alt="Python logo"/>

  72.             </a>

  73.             <span class="version_switcher_placeholder"></span>

  74.             <form role="search" class="search" action="../search.html" method="get">

  75.                 <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" class="search-icon">

  76.                     <path fill-rule="nonzero" fill="currentColor" d="M15.5 14h-.79l-.28-.27a6.5 6.5 0 001.48-5.34c-.47-2.78-2.79-5-5.59-5.34a6.505 6.505 0 00-7.27 7.27c.34 2.8 2.56 5.12 5.34 5.59a6.5 6.5 0 005.34-1.48l.27.28v.79l4.25 4.25c.41.41 1.08.41 1.49 0 .41-.41.41-1.08 0-1.49L15.5 14zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z"></path>

  77.                 </svg>

  78.                 <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" />

  79.                 <input type="submit" value="Go"/>

  80.             </form>

  81.         </span>

  82.     </nav>

  83.     <div class="menu-wrapper">

  84.         <nav class="menu" role="navigation" aria-label="main navigation">

  85.             <div class="language_switcher_placeholder"></div>

  86.             

  87. <label class="theme-selector-label">

  88.     Theme

  89.     <select class="theme-selector" oninput="activateTheme(this.value)">

  90.         <option value="auto" selected>Auto</option>

  91.         <option value="light">Light</option>

  92.         <option value="dark">Dark</option>

  93.     </select>

  94. </label>

  95.   <div>

  96.     <h3><a href="../contents.html">Table of Contents</a></h3>

  97.     <ul>

  98. <li><a class="reference internal" href="#">2to3 — Automated Python 2 to 3 code translation</a><ul>

  99. <li><a class="reference internal" href="#using-2to3">Using 2to3</a></li>

  100. <li><a class="reference internal" href="#fixers">Fixers</a></li>

  101. <li><a class="reference internal" href="#module-lib2to3"><code class="xref py py-mod docutils literal notranslate"><span class="pre">lib2to3</span></code> — 2to3’s library</a></li>

  102. </ul>

  103. </li>

  104. </ul>

  105. 

  106.   </div>

  107.   <div>

  108.     <h4>Previous topic</h4>

  109.     <p class="topless"><a href="unittest.mock-examples.html"

  110.                           title="previous chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">unittest.mock</span></code> — getting started</a></p>

  111.   </div>

  112.   <div>

  113.     <h4>Next topic</h4>

  114.     <p class="topless"><a href="test.html"

  115.                           title="next chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">test</span></code> — Regression tests package for Python</a></p>

  116.   </div>

  117.   <div role="note" aria-label="source link">

  118.     <h3>This Page</h3>

  119.     <ul class="this-page-menu">

  120.       <li><a href="../bugs.html">Report a Bug</a></li>

  121.       <li>

  122.         <a href="https://github.com/python/cpython/blob/main/Doc/library/2to3.rst"

  123.             rel="nofollow">Show Source

  124.         </a>

  125.       </li>

  126.     </ul>

  127.   </div>

  128.         </nav>

  129.     </div>

  130. </div>

  131. 

  132.   

  133.     <div class="related" role="navigation" aria-label="related navigation">

  134.       <h3>Navigation</h3>

  135.       <ul>

  136.         <li class="right" style="margin-right: 10px">

  137.           <a href="../genindex.html" title="General Index"

  138.              accesskey="I">index</a></li>

  139.         <li class="right" >

  140.           <a href="../py-modindex.html" title="Python Module Index"

  141.              >modules</a> |</li>

  142.         <li class="right" >

  143.           <a href="test.html" title="test — Regression tests package for Python"

  144.              accesskey="N">next</a> |</li>

  145.         <li class="right" >

  146.           <a href="unittest.mock-examples.html" title="unittest.mock — getting started"

  147.              accesskey="P">previous</a> |</li>

  148. 

  149.           <li><img src="../_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"/></li>

  150.           <li><a href="https://www.python.org/">Python</a> &#187;</li>

  151.           <li class="switchers">

  152.             <div class="language_switcher_placeholder"></div>

  153.             <div class="version_switcher_placeholder"></div>

  154.           </li>

  155.           <li>

  156.               

  157.           </li>

  158.     <li id="cpython-language-and-version">

  159.       <a href="../index.html">3.12.3 Documentation</a> &#187;

  160.     </li>

  161. 

  162.           <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> &#187;</li>

  163.           <li class="nav-item nav-item-2"><a href="development.html" accesskey="U">Development Tools</a> &#187;</li>

  164.         <li class="nav-item nav-item-this"><a href="">2to3 — Automated Python 2 to 3 code translation</a></li>

  165.                 <li class="right">

  166.                     

  167. 

  168.     <div class="inline-search" role="search">

  169.         <form class="inline-search" action="../search.html" method="get">

  170.           <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box" />

  171.           <input type="submit" value="Go" />

  172.         </form>

  173.     </div>

  174.                      |

  175.                 </li>

  176.             <li class="right">

  177. <label class="theme-selector-label">

  178.     Theme

  179.     <select class="theme-selector" oninput="activateTheme(this.value)">

  180.         <option value="auto" selected>Auto</option>

  181.         <option value="light">Light</option>

  182.         <option value="dark">Dark</option>

  183.     </select>

  184. </label> |</li>

  185.             

  186.       </ul>

  187.     </div>    

  188. 

  189.     <div class="document">

  190.       <div class="documentwrapper">

  191.         <div class="bodywrapper">

  192.           <div class="body" role="main">

  193.             

  194.   <section id="to3-automated-python-2-to-3-code-translation">

  195. <span id="to3-reference"></span><h1>2to3 — Automated Python 2 to 3 code translation<a class="headerlink" href="#to3-automated-python-2-to-3-code-translation" title="Link to this heading">¶</a></h1>

  196. <p>2to3 is a Python program that reads Python 2.x source code and applies a series

  197. of <em>fixers</em> to transform it into valid Python 3.x code.  The standard library

  198. contains a rich set of fixers that will handle almost all code.  2to3 supporting

  199. library <a class="reference internal" href="#module-lib2to3" title="lib2to3: The 2to3 library"><code class="xref py py-mod docutils literal notranslate"><span class="pre">lib2to3</span></code></a> is, however, a flexible and generic library, so it is

  200. possible to write your own fixers for 2to3.</p>

  201. <div class="deprecated-removed">

  202. <p><span class="versionmodified">Deprecated since version 3.11, will be removed in version 3.13: </span>The <code class="docutils literal notranslate"><span class="pre">lib2to3</span></code> module was marked pending for deprecation in Python 3.9

  203. (raising <a class="reference internal" href="exceptions.html#PendingDeprecationWarning" title="PendingDeprecationWarning"><code class="xref py py-exc docutils literal notranslate"><span class="pre">PendingDeprecationWarning</span></code></a> on import) and fully deprecated

  204. in Python 3.11 (raising <a class="reference internal" href="exceptions.html#DeprecationWarning" title="DeprecationWarning"><code class="xref py py-exc docutils literal notranslate"><span class="pre">DeprecationWarning</span></code></a>).  The <code class="docutils literal notranslate"><span class="pre">2to3</span></code> tool is

  205. part of that.  It will be removed in Python 3.13.</p>

  206. </div>

  207. <section id="using-2to3">

  208. <span id="to3-using"></span><h2>Using 2to3<a class="headerlink" href="#using-2to3" title="Link to this heading">¶</a></h2>

  209. <p>2to3 will usually be installed with the Python interpreter as a script.  It is

  210. also located in the <code class="file docutils literal notranslate"><span class="pre">Tools/scripts</span></code> directory of the Python root.</p>

  211. <p>2to3’s basic arguments are a list of files or directories to transform.  The

  212. directories are recursively traversed for Python sources.</p>

  213. <p>Here is a sample Python 2.x source file, <code class="file docutils literal notranslate"><span class="pre">example.py</span></code>:</p>

  214. <div class="highlight-python3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">greet</span><span class="p">(</span><span class="n">name</span><span class="p">):</span>

  215.     <span class="nb">print</span> <span class="s2">&quot;Hello, </span><span class="si">{0}</span><span class="s2">!&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">name</span><span class="p">)</span>

  216. <span class="nb">print</span> <span class="s2">&quot;What&#39;s your name?&quot;</span>

  217. <span class="n">name</span> <span class="o">=</span> <span class="n">raw_input</span><span class="p">()</span>

  218. <span class="n">greet</span><span class="p">(</span><span class="n">name</span><span class="p">)</span>

  219. </pre></div>

  220. </div>

  221. <p>It can be converted to Python 3.x code via 2to3 on the command line:</p>

  222. <div class="highlight-shell-session notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>2to3<span class="w"> </span>example.py

  223. </pre></div>

  224. </div>

  225. <p>A diff against the original source file is printed.  2to3 can also write the

  226. needed modifications right back to the source file.  (A backup of the original

  227. file is made unless <code class="xref std std-option docutils literal notranslate"><span class="pre">-n</span></code> is also given.)  Writing the changes back is

  228. enabled with the <code class="xref std std-option docutils literal notranslate"><span class="pre">-w</span></code> flag:</p>

  229. <div class="highlight-shell-session notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>2to3<span class="w"> </span>-w<span class="w"> </span>example.py

  230. </pre></div>

  231. </div>

  232. <p>After transformation, <code class="file docutils literal notranslate"><span class="pre">example.py</span></code> looks like this:</p>

  233. <div class="highlight-python3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">greet</span><span class="p">(</span><span class="n">name</span><span class="p">):</span>

  234.     <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Hello, </span><span class="si">{0}</span><span class="s2">!&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">name</span><span class="p">))</span>

  235. <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;What&#39;s your name?&quot;</span><span class="p">)</span>

  236. <span class="n">name</span> <span class="o">=</span> <span class="nb">input</span><span class="p">()</span>

  237. <span class="n">greet</span><span class="p">(</span><span class="n">name</span><span class="p">)</span>

  238. </pre></div>

  239. </div>

  240. <p>Comments and exact indentation are preserved throughout the translation process.</p>

  241. <p>By default, 2to3 runs a set of <a class="reference internal" href="#to3-fixers"><span class="std std-ref">predefined fixers</span></a>.  The

  242. <code class="xref std std-option docutils literal notranslate"><span class="pre">-l</span></code> flag lists all available fixers.  An explicit set of fixers to run

  243. can be given with <code class="xref std std-option docutils literal notranslate"><span class="pre">-f</span></code>.  Likewise the <code class="xref std std-option docutils literal notranslate"><span class="pre">-x</span></code> explicitly disables a

  244. fixer.  The following example runs only the <code class="docutils literal notranslate"><span class="pre">imports</span></code> and <code class="docutils literal notranslate"><span class="pre">has_key</span></code> fixers:</p>

  245. <div class="highlight-shell-session notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>2to3<span class="w"> </span>-f<span class="w"> </span>imports<span class="w"> </span>-f<span class="w"> </span>has_key<span class="w"> </span>example.py

  246. </pre></div>

  247. </div>

  248. <p>This command runs every fixer except the <code class="docutils literal notranslate"><span class="pre">apply</span></code> fixer:</p>

  249. <div class="highlight-shell-session notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>2to3<span class="w"> </span>-x<span class="w"> </span>apply<span class="w"> </span>example.py

  250. </pre></div>

  251. </div>

  252. <p>Some fixers are <em>explicit</em>, meaning they aren’t run by default and must be

  253. listed on the command line to be run.  Here, in addition to the default fixers,

  254. the <code class="docutils literal notranslate"><span class="pre">idioms</span></code> fixer is run:</p>

  255. <div class="highlight-shell-session notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>2to3<span class="w"> </span>-f<span class="w"> </span>all<span class="w"> </span>-f<span class="w"> </span>idioms<span class="w"> </span>example.py

  256. </pre></div>

  257. </div>

  258. <p>Notice how passing <code class="docutils literal notranslate"><span class="pre">all</span></code> enables all default fixers.</p>

  259. <p>Sometimes 2to3 will find a place in your source code that needs to be changed,

  260. but 2to3 cannot fix automatically.  In this case, 2to3 will print a warning

  261. beneath the diff for a file.  You should address the warning in order to have

  262. compliant 3.x code.</p>

  263. <p>2to3 can also refactor doctests.  To enable this mode, use the <code class="xref std std-option docutils literal notranslate"><span class="pre">-d</span></code>

  264. flag.  Note that <em>only</em> doctests will be refactored.  This also doesn’t require

  265. the module to be valid Python.  For example, doctest like examples in a reST

  266. document could also be refactored with this option.</p>

  267. <p>The <code class="xref std std-option docutils literal notranslate"><span class="pre">-v</span></code> option enables output of more information on the translation

  268. process.</p>

  269. <p>Since some print statements can be parsed as function calls or statements, 2to3

  270. cannot always read files containing the print function.  When 2to3 detects the

  271. presence of the <code class="docutils literal notranslate"><span class="pre">from</span> <span class="pre">__future__</span> <span class="pre">import</span> <span class="pre">print_function</span></code> compiler directive, it

  272. modifies its internal grammar to interpret <a class="reference internal" href="functions.html#print" title="print"><code class="xref py py-func docutils literal notranslate"><span class="pre">print()</span></code></a> as a function.  This

  273. change can also be enabled manually with the <code class="xref std std-option docutils literal notranslate"><span class="pre">-p</span></code> flag.  Use

  274. <code class="xref std std-option docutils literal notranslate"><span class="pre">-p</span></code> to run fixers on code that already has had its print statements

  275. converted. Also <code class="xref std std-option docutils literal notranslate"><span class="pre">-e</span></code> can be used to make <a class="reference internal" href="functions.html#exec" title="exec"><code class="xref py py-func docutils literal notranslate"><span class="pre">exec()</span></code></a> a function.</p>

  276. <p>The <code class="xref std std-option docutils literal notranslate"><span class="pre">-o</span></code> or <code class="xref std std-option docutils literal notranslate"><span class="pre">--output-dir</span></code> option allows specification of an

  277. alternate directory for processed output files to be written to.  The

  278. <code class="xref std std-option docutils literal notranslate"><span class="pre">-n</span></code> flag is required when using this as backup files do not make sense

  279. when not overwriting the input files.</p>

  280. <div class="versionadded">

  281. <p><span class="versionmodified added">New in version 3.2.3: </span>The <code class="xref std std-option docutils literal notranslate"><span class="pre">-o</span></code> option was added.</p>

  282. </div>

  283. <p>The <code class="xref std std-option docutils literal notranslate"><span class="pre">-W</span></code> or <code class="xref std std-option docutils literal notranslate"><span class="pre">--write-unchanged-files</span></code> flag tells 2to3 to always

  284. write output files even if no changes were required to the file.  This is most

  285. useful with <code class="xref std std-option docutils literal notranslate"><span class="pre">-o</span></code> so that an entire Python source tree is copied with

  286. translation from one directory to another.

  287. This option implies the <code class="xref std std-option docutils literal notranslate"><span class="pre">-w</span></code> flag as it would not make sense otherwise.</p>

  288. <div class="versionadded">

  289. <p><span class="versionmodified added">New in version 3.2.3: </span>The <code class="xref std std-option docutils literal notranslate"><span class="pre">-W</span></code> flag was added.</p>

  290. </div>

  291. <p>The <code class="xref std std-option docutils literal notranslate"><span class="pre">--add-suffix</span></code> option specifies a string to append to all output

  292. filenames.  The <code class="xref std std-option docutils literal notranslate"><span class="pre">-n</span></code> flag is required when specifying this as backups

  293. are not necessary when writing to different filenames.  Example:</p>

  294. <div class="highlight-shell-session notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>2to3<span class="w"> </span>-n<span class="w"> </span>-W<span class="w"> </span>--add-suffix<span class="o">=</span><span class="m">3</span><span class="w"> </span>example.py

  295. </pre></div>

  296. </div>

  297. <p>Will cause a converted file named <code class="docutils literal notranslate"><span class="pre">example.py3</span></code> to be written.</p>

  298. <div class="versionadded">

  299. <p><span class="versionmodified added">New in version 3.2.3: </span>The <code class="xref std std-option docutils literal notranslate"><span class="pre">--add-suffix</span></code> option was added.</p>

  300. </div>

  301. <p>To translate an entire project from one directory tree to another use:</p>

  302. <div class="highlight-shell-session notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>2to3<span class="w"> </span>--output-dir<span class="o">=</span>python3-version/mycode<span class="w"> </span>-W<span class="w"> </span>-n<span class="w"> </span>python2-version/mycode

  303. </pre></div>

  304. </div>

  305. </section>

  306. <section id="fixers">

  307. <span id="to3-fixers"></span><h2>Fixers<a class="headerlink" href="#fixers" title="Link to this heading">¶</a></h2>

  308. <p>Each step of transforming code is encapsulated in a fixer.  The command <code class="docutils literal notranslate"><span class="pre">2to3</span>

  309. <span class="pre">-l</span></code> lists them.  As <a class="reference internal" href="#to3-using"><span class="std std-ref">documented above</span></a>, each can be turned on

  310. and off individually.  They are described here in more detail.</p>

  311. <dl class="std 2to3fixer">

  312. <dt class="sig sig-object std" id="to3fixer-apply">

  313. <span class="sig-name descname"><span class="pre">apply</span></span><a class="headerlink" href="#to3fixer-apply" title="Link to this definition">¶</a></dt>

  314. <dd><p>Removes usage of <code class="xref py py-func docutils literal notranslate"><span class="pre">apply()</span></code>.  For example <code class="docutils literal notranslate"><span class="pre">apply(function,</span> <span class="pre">*args,</span>

  315. <span class="pre">**kwargs)</span></code> is converted to <code class="docutils literal notranslate"><span class="pre">function(*args,</span> <span class="pre">**kwargs)</span></code>.</p>

  316. </dd></dl>

  317. 

  318. <dl class="std 2to3fixer">

  319. <dt class="sig sig-object std" id="to3fixer-asserts">

  320. <span class="sig-name descname"><span class="pre">asserts</span></span><a class="headerlink" href="#to3fixer-asserts" title="Link to this definition">¶</a></dt>

  321. <dd><p>Replaces deprecated <a class="reference internal" href="unittest.html#module-unittest" title="unittest: Unit testing framework for Python."><code class="xref py py-mod docutils literal notranslate"><span class="pre">unittest</span></code></a> method names with the correct ones.</p>

  322. <table class="docutils align-default">

  323. <thead>

  324. <tr class="row-odd"><th class="head"><p>From</p></th>

  325. <th class="head"><p>To</p></th>

  326. </tr>

  327. </thead>

  328. <tbody>

  329. <tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">failUnlessEqual(a,</span> <span class="pre">b)</span></code></p></td>

  330. <td><p><a class="reference internal" href="unittest.html#unittest.TestCase.assertEqual" title="unittest.TestCase.assertEqual"><code class="xref py py-meth docutils literal notranslate"><span class="pre">assertEqual(a,</span> <span class="pre">b)</span></code></a></p></td>

  331. </tr>

  332. <tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">assertEquals(a,</span> <span class="pre">b)</span></code></p></td>

  333. <td><p><a class="reference internal" href="unittest.html#unittest.TestCase.assertEqual" title="unittest.TestCase.assertEqual"><code class="xref py py-meth docutils literal notranslate"><span class="pre">assertEqual(a,</span> <span class="pre">b)</span></code></a></p></td>

  334. </tr>

  335. <tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">failIfEqual(a,</span> <span class="pre">b)</span></code></p></td>

  336. <td><p><a class="reference internal" href="unittest.html#unittest.TestCase.assertNotEqual" title="unittest.TestCase.assertNotEqual"><code class="xref py py-meth docutils literal notranslate"><span class="pre">assertNotEqual(a,</span> <span class="pre">b)</span></code></a></p></td>

  337. </tr>

  338. <tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">assertNotEquals(a,</span> <span class="pre">b)</span></code></p></td>

  339. <td><p><a class="reference internal" href="unittest.html#unittest.TestCase.assertNotEqual" title="unittest.TestCase.assertNotEqual"><code class="xref py py-meth docutils literal notranslate"><span class="pre">assertNotEqual(a,</span> <span class="pre">b)</span></code></a></p></td>

  340. </tr>

  341. <tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">failUnless(a)</span></code></p></td>

  342. <td><p><a class="reference internal" href="unittest.html#unittest.TestCase.assertTrue" title="unittest.TestCase.assertTrue"><code class="xref py py-meth docutils literal notranslate"><span class="pre">assertTrue(a)</span></code></a></p></td>

  343. </tr>

  344. <tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">assert_(a)</span></code></p></td>

  345. <td><p><a class="reference internal" href="unittest.html#unittest.TestCase.assertTrue" title="unittest.TestCase.assertTrue"><code class="xref py py-meth docutils literal notranslate"><span class="pre">assertTrue(a)</span></code></a></p></td>

  346. </tr>

  347. <tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">failIf(a)</span></code></p></td>

  348. <td><p><a class="reference internal" href="unittest.html#unittest.TestCase.assertFalse" title="unittest.TestCase.assertFalse"><code class="xref py py-meth docutils literal notranslate"><span class="pre">assertFalse(a)</span></code></a></p></td>

  349. </tr>

  350. <tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">failUnlessRaises(exc,</span> <span class="pre">cal)</span></code></p></td>

  351. <td><p><a class="reference internal" href="unittest.html#unittest.TestCase.assertRaises" title="unittest.TestCase.assertRaises"><code class="xref py py-meth docutils literal notranslate"><span class="pre">assertRaises(exc,</span> <span class="pre">cal)</span></code></a></p></td>

  352. </tr>

  353. <tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">failUnlessAlmostEqual(a,</span> <span class="pre">b)</span></code></p></td>

  354. <td><p><a class="reference internal" href="unittest.html#unittest.TestCase.assertAlmostEqual" title="unittest.TestCase.assertAlmostEqual"><code class="xref py py-meth docutils literal notranslate"><span class="pre">assertAlmostEqual(a,</span> <span class="pre">b)</span></code></a></p></td>

  355. </tr>

  356. <tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">assertAlmostEquals(a,</span> <span class="pre">b)</span></code></p></td>

  357. <td><p><a class="reference internal" href="unittest.html#unittest.TestCase.assertAlmostEqual" title="unittest.TestCase.assertAlmostEqual"><code class="xref py py-meth docutils literal notranslate"><span class="pre">assertAlmostEqual(a,</span> <span class="pre">b)</span></code></a></p></td>

  358. </tr>

  359. <tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">failIfAlmostEqual(a,</span> <span class="pre">b)</span></code></p></td>

  360. <td><p><a class="reference internal" href="unittest.html#unittest.TestCase.assertNotAlmostEqual" title="unittest.TestCase.assertNotAlmostEqual"><code class="xref py py-meth docutils literal notranslate"><span class="pre">assertNotAlmostEqual(a,</span> <span class="pre">b)</span></code></a></p></td>

  361. </tr>

  362. <tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">assertNotAlmostEquals(a,</span> <span class="pre">b)</span></code></p></td>

  363. <td><p><a class="reference internal" href="unittest.html#unittest.TestCase.assertNotAlmostEqual" title="unittest.TestCase.assertNotAlmostEqual"><code class="xref py py-meth docutils literal notranslate"><span class="pre">assertNotAlmostEqual(a,</span> <span class="pre">b)</span></code></a></p></td>

  364. </tr>

  365. </tbody>

  366. </table>

  367. </dd></dl>

  368. 

  369. <dl class="std 2to3fixer">

  370. <dt class="sig sig-object std" id="to3fixer-basestring">

  371. <span class="sig-name descname"><span class="pre">basestring</span></span><a class="headerlink" href="#to3fixer-basestring" title="Link to this definition">¶</a></dt>

  372. <dd><p>Converts <code class="xref py py-class docutils literal notranslate"><span class="pre">basestring</span></code> to <a class="reference internal" href="stdtypes.html#str" title="str"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>.</p>

  373. </dd></dl>

  374. 

  375. <dl class="std 2to3fixer">

  376. <dt class="sig sig-object std" id="to3fixer-buffer">

  377. <span class="sig-name descname"><span class="pre">buffer</span></span><a class="headerlink" href="#to3fixer-buffer" title="Link to this definition">¶</a></dt>

  378. <dd><p>Converts <code class="xref py py-class docutils literal notranslate"><span class="pre">buffer</span></code> to <a class="reference internal" href="stdtypes.html#memoryview" title="memoryview"><code class="xref py py-class docutils literal notranslate"><span class="pre">memoryview</span></code></a>.  This fixer is optional

  379. because the <a class="reference internal" href="stdtypes.html#memoryview" title="memoryview"><code class="xref py py-class docutils literal notranslate"><span class="pre">memoryview</span></code></a> API is similar but not exactly the same as

  380. that of <code class="xref py py-class docutils literal notranslate"><span class="pre">buffer</span></code>.</p>

  381. </dd></dl>

  382. 

  383. <dl class="std 2to3fixer">

  384. <dt class="sig sig-object std" id="to3fixer-dict">

  385. <span class="sig-name descname"><span class="pre">dict</span></span><a class="headerlink" href="#to3fixer-dict" title="Link to this definition">¶</a></dt>

  386. <dd><p>Fixes dictionary iteration methods.  <code class="xref py py-meth docutils literal notranslate"><span class="pre">dict.iteritems()</span></code> is converted to

  387. <a class="reference internal" href="stdtypes.html#dict.items" title="dict.items"><code class="xref py py-meth docutils literal notranslate"><span class="pre">dict.items()</span></code></a>, <code class="xref py py-meth docutils literal notranslate"><span class="pre">dict.iterkeys()</span></code> to <a class="reference internal" href="stdtypes.html#dict.keys" title="dict.keys"><code class="xref py py-meth docutils literal notranslate"><span class="pre">dict.keys()</span></code></a>, and

  388. <code class="xref py py-meth docutils literal notranslate"><span class="pre">dict.itervalues()</span></code> to <a class="reference internal" href="stdtypes.html#dict.values" title="dict.values"><code class="xref py py-meth docutils literal notranslate"><span class="pre">dict.values()</span></code></a>.  Similarly,

  389. <code class="xref py py-meth docutils literal notranslate"><span class="pre">dict.viewitems()</span></code>, <code class="xref py py-meth docutils literal notranslate"><span class="pre">dict.viewkeys()</span></code> and <code class="xref py py-meth docutils literal notranslate"><span class="pre">dict.viewvalues()</span></code> are

  390. converted respectively to <a class="reference internal" href="stdtypes.html#dict.items" title="dict.items"><code class="xref py py-meth docutils literal notranslate"><span class="pre">dict.items()</span></code></a>, <a class="reference internal" href="stdtypes.html#dict.keys" title="dict.keys"><code class="xref py py-meth docutils literal notranslate"><span class="pre">dict.keys()</span></code></a> and

  391. <a class="reference internal" href="stdtypes.html#dict.values" title="dict.values"><code class="xref py py-meth docutils literal notranslate"><span class="pre">dict.values()</span></code></a>.  It also wraps existing usages of <a class="reference internal" href="stdtypes.html#dict.items" title="dict.items"><code class="xref py py-meth docutils literal notranslate"><span class="pre">dict.items()</span></code></a>,

  392. <a class="reference internal" href="stdtypes.html#dict.keys" title="dict.keys"><code class="xref py py-meth docutils literal notranslate"><span class="pre">dict.keys()</span></code></a>, and <a class="reference internal" href="stdtypes.html#dict.values" title="dict.values"><code class="xref py py-meth docutils literal notranslate"><span class="pre">dict.values()</span></code></a> in a call to <a class="reference internal" href="stdtypes.html#list" title="list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a>.</p>

  393. </dd></dl>

  394. 

  395. <dl class="std 2to3fixer">

  396. <dt class="sig sig-object std" id="to3fixer-except">

  397. <span class="sig-name descname"><span class="pre">except</span></span><a class="headerlink" href="#to3fixer-except" title="Link to this definition">¶</a></dt>

  398. <dd><p>Converts <code class="docutils literal notranslate"><span class="pre">except</span> <span class="pre">X,</span> <span class="pre">T</span></code> to <code class="docutils literal notranslate"><span class="pre">except</span> <span class="pre">X</span> <span class="pre">as</span> <span class="pre">T</span></code>.</p>

  399. </dd></dl>

  400. 

  401. <dl class="std 2to3fixer">

  402. <dt class="sig sig-object std" id="to3fixer-exec">

  403. <span class="sig-name descname"><span class="pre">exec</span></span><a class="headerlink" href="#to3fixer-exec" title="Link to this definition">¶</a></dt>

  404. <dd><p>Converts the <code class="docutils literal notranslate"><span class="pre">exec</span></code> statement to the <a class="reference internal" href="functions.html#exec" title="exec"><code class="xref py py-func docutils literal notranslate"><span class="pre">exec()</span></code></a> function.</p>

  405. </dd></dl>

  406. 

  407. <dl class="std 2to3fixer">

  408. <dt class="sig sig-object std" id="to3fixer-execfile">

  409. <span class="sig-name descname"><span class="pre">execfile</span></span><a class="headerlink" href="#to3fixer-execfile" title="Link to this definition">¶</a></dt>

  410. <dd><p>Removes usage of <code class="xref py py-func docutils literal notranslate"><span class="pre">execfile()</span></code>.  The argument to <code class="xref py py-func docutils literal notranslate"><span class="pre">execfile()</span></code> is

  411. wrapped in calls to <a class="reference internal" href="functions.html#open" title="open"><code class="xref py py-func docutils literal notranslate"><span class="pre">open()</span></code></a>, <a class="reference internal" href="functions.html#compile" title="compile"><code class="xref py py-func docutils literal notranslate"><span class="pre">compile()</span></code></a>, and <a class="reference internal" href="functions.html#exec" title="exec"><code class="xref py py-func docutils literal notranslate"><span class="pre">exec()</span></code></a>.</p>

  412. </dd></dl>

  413. 

  414. <dl class="std 2to3fixer">

  415. <dt class="sig sig-object std" id="to3fixer-exitfunc">

  416. <span class="sig-name descname"><span class="pre">exitfunc</span></span><a class="headerlink" href="#to3fixer-exitfunc" title="Link to this definition">¶</a></dt>

  417. <dd><p>Changes assignment of <code class="xref py py-attr docutils literal notranslate"><span class="pre">sys.exitfunc</span></code> to use of the <a class="reference internal" href="atexit.html#module-atexit" title="atexit: Register and execute cleanup functions."><code class="xref py py-mod docutils literal notranslate"><span class="pre">atexit</span></code></a>

  418. module.</p>

  419. </dd></dl>

  420. 

  421. <dl class="std 2to3fixer">

  422. <dt class="sig sig-object std" id="to3fixer-filter">

  423. <span class="sig-name descname"><span class="pre">filter</span></span><a class="headerlink" href="#to3fixer-filter" title="Link to this definition">¶</a></dt>

  424. <dd><p>Wraps <a class="reference internal" href="functions.html#filter" title="filter"><code class="xref py py-func docutils literal notranslate"><span class="pre">filter()</span></code></a> usage in a <a class="reference internal" href="stdtypes.html#list" title="list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a> call.</p>

  425. </dd></dl>

  426. 

  427. <dl class="std 2to3fixer">

  428. <dt class="sig sig-object std" id="to3fixer-funcattrs">

  429. <span class="sig-name descname"><span class="pre">funcattrs</span></span><a class="headerlink" href="#to3fixer-funcattrs" title="Link to this definition">¶</a></dt>

  430. <dd><p>Fixes function attributes that have been renamed.  For example,

  431. <code class="docutils literal notranslate"><span class="pre">my_function.func_closure</span></code> is converted to <code class="docutils literal notranslate"><span class="pre">my_function.__closure__</span></code>.</p>

  432. </dd></dl>

  433. 

  434. <dl class="std 2to3fixer">

  435. <dt class="sig sig-object std" id="to3fixer-future">

  436. <span class="sig-name descname"><span class="pre">future</span></span><a class="headerlink" href="#to3fixer-future" title="Link to this definition">¶</a></dt>

  437. <dd><p>Removes <code class="docutils literal notranslate"><span class="pre">from</span> <span class="pre">__future__</span> <span class="pre">import</span> <span class="pre">new_feature</span></code> statements.</p>

  438. </dd></dl>

  439. 

  440. <dl class="std 2to3fixer">

  441. <dt class="sig sig-object std" id="to3fixer-getcwdu">

  442. <span class="sig-name descname"><span class="pre">getcwdu</span></span><a class="headerlink" href="#to3fixer-getcwdu" title="Link to this definition">¶</a></dt>

  443. <dd><p>Renames <code class="xref py py-func docutils literal notranslate"><span class="pre">os.getcwdu()</span></code> to <a class="reference internal" href="os.html#os.getcwd" title="os.getcwd"><code class="xref py py-func docutils literal notranslate"><span class="pre">os.getcwd()</span></code></a>.</p>

  444. </dd></dl>

  445. 

  446. <dl class="std 2to3fixer">

  447. <dt class="sig sig-object std" id="to3fixer-has_key">

  448. <span class="sig-name descname"><span class="pre">has_key</span></span><a class="headerlink" href="#to3fixer-has_key" title="Link to this definition">¶</a></dt>

  449. <dd><p>Changes <code class="docutils literal notranslate"><span class="pre">dict.has_key(key)</span></code> to <code class="docutils literal notranslate"><span class="pre">key</span> <span class="pre">in</span> <span class="pre">dict</span></code>.</p>

  450. </dd></dl>

  451. 

  452. <dl class="std 2to3fixer">

  453. <dt class="sig sig-object std" id="to3fixer-idioms">

  454. <span class="sig-name descname"><span class="pre">idioms</span></span><a class="headerlink" href="#to3fixer-idioms" title="Link to this definition">¶</a></dt>

  455. <dd><p>This optional fixer performs several transformations that make Python code

  456. more idiomatic.  Type comparisons like <code class="docutils literal notranslate"><span class="pre">type(x)</span> <span class="pre">is</span> <span class="pre">SomeClass</span></code> and

  457. <code class="docutils literal notranslate"><span class="pre">type(x)</span> <span class="pre">==</span> <span class="pre">SomeClass</span></code> are converted to <code class="docutils literal notranslate"><span class="pre">isinstance(x,</span> <span class="pre">SomeClass)</span></code>.

  458. <code class="docutils literal notranslate"><span class="pre">while</span> <span class="pre">1</span></code> becomes <code class="docutils literal notranslate"><span class="pre">while</span> <span class="pre">True</span></code>.  This fixer also tries to make use of

  459. <a class="reference internal" href="functions.html#sorted" title="sorted"><code class="xref py py-func docutils literal notranslate"><span class="pre">sorted()</span></code></a> in appropriate places.  For example, this block</p>

  460. <div class="highlight-python3 notranslate"><div class="highlight"><pre><span></span><span class="n">L</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">some_iterable</span><span class="p">)</span>

  461. <span class="n">L</span><span class="o">.</span><span class="n">sort</span><span class="p">()</span>

  462. </pre></div>

  463. </div>

  464. <p>is changed to</p>

  465. <div class="highlight-python3 notranslate"><div class="highlight"><pre><span></span><span class="n">L</span> <span class="o">=</span> <span class="nb">sorted</span><span class="p">(</span><span class="n">some_iterable</span><span class="p">)</span>

  466. </pre></div>

  467. </div>

  468. </dd></dl>

  469. 

  470. <dl class="std 2to3fixer">

  471. <dt class="sig sig-object std" id="to3fixer-import">

  472. <span class="sig-name descname"><span class="pre">import</span></span><a class="headerlink" href="#to3fixer-import" title="Link to this definition">¶</a></dt>

  473. <dd><p>Detects sibling imports and converts them to relative imports.</p>

  474. </dd></dl>

  475. 

  476. <dl class="std 2to3fixer">

  477. <dt class="sig sig-object std" id="to3fixer-imports">

  478. <span class="sig-name descname"><span class="pre">imports</span></span><a class="headerlink" href="#to3fixer-imports" title="Link to this definition">¶</a></dt>

  479. <dd><p>Handles module renames in the standard library.</p>

  480. </dd></dl>

  481. 

  482. <dl class="std 2to3fixer">

  483. <dt class="sig sig-object std" id="to3fixer-imports2">

  484. <span class="sig-name descname"><span class="pre">imports2</span></span><a class="headerlink" href="#to3fixer-imports2" title="Link to this definition">¶</a></dt>

  485. <dd><p>Handles other modules renames in the standard library.  It is separate from

  486. the <a class="reference internal" href="#to3fixer-imports"><code class="xref std std-2to3fixer docutils literal notranslate"><span class="pre">imports</span></code></a> fixer only because of technical limitations.</p>

  487. </dd></dl>

  488. 

  489. <dl class="std 2to3fixer">

  490. <dt class="sig sig-object std" id="to3fixer-input">

  491. <span class="sig-name descname"><span class="pre">input</span></span><a class="headerlink" href="#to3fixer-input" title="Link to this definition">¶</a></dt>

  492. <dd><p>Converts <code class="docutils literal notranslate"><span class="pre">input(prompt)</span></code> to <code class="docutils literal notranslate"><span class="pre">eval(input(prompt))</span></code>.</p>

  493. </dd></dl>

  494. 

  495. <dl class="std 2to3fixer">

  496. <dt class="sig sig-object std" id="to3fixer-intern">

  497. <span class="sig-name descname"><span class="pre">intern</span></span><a class="headerlink" href="#to3fixer-intern" title="Link to this definition">¶</a></dt>

  498. <dd><p>Converts <code class="xref py py-func docutils literal notranslate"><span class="pre">intern()</span></code> to <a class="reference internal" href="sys.html#sys.intern" title="sys.intern"><code class="xref py py-func docutils literal notranslate"><span class="pre">sys.intern()</span></code></a>.</p>

  499. </dd></dl>

  500. 

  501. <dl class="std 2to3fixer">

  502. <dt class="sig sig-object std" id="to3fixer-isinstance">

  503. <span class="sig-name descname"><span class="pre">isinstance</span></span><a class="headerlink" href="#to3fixer-isinstance" title="Link to this definition">¶</a></dt>

  504. <dd><p>Fixes duplicate types in the second argument of <a class="reference internal" href="functions.html#isinstance" title="isinstance"><code class="xref py py-func docutils literal notranslate"><span class="pre">isinstance()</span></code></a>.  For

  505. example, <code class="docutils literal notranslate"><span class="pre">isinstance(x,</span> <span class="pre">(int,</span> <span class="pre">int))</span></code> is converted to <code class="docutils literal notranslate"><span class="pre">isinstance(x,</span>

  506. <span class="pre">int)</span></code> and <code class="docutils literal notranslate"><span class="pre">isinstance(x,</span> <span class="pre">(int,</span> <span class="pre">float,</span> <span class="pre">int))</span></code> is converted to

  507. <code class="docutils literal notranslate"><span class="pre">isinstance(x,</span> <span class="pre">(int,</span> <span class="pre">float))</span></code>.</p>

  508. </dd></dl>

  509. 

  510. <dl class="std 2to3fixer">

  511. <dt class="sig sig-object std" id="to3fixer-itertools_imports">

  512. <span class="sig-name descname"><span class="pre">itertools_imports</span></span><a class="headerlink" href="#to3fixer-itertools_imports" title="Link to this definition">¶</a></dt>

  513. <dd><p>Removes imports of <code class="xref py py-func docutils literal notranslate"><span class="pre">itertools.ifilter()</span></code>, <code class="xref py py-func docutils literal notranslate"><span class="pre">itertools.izip()</span></code>, and

  514. <code class="xref py py-func docutils literal notranslate"><span class="pre">itertools.imap()</span></code>.  Imports of <code class="xref py py-func docutils literal notranslate"><span class="pre">itertools.ifilterfalse()</span></code> are also

  515. changed to <a class="reference internal" href="itertools.html#itertools.filterfalse" title="itertools.filterfalse"><code class="xref py py-func docutils literal notranslate"><span class="pre">itertools.filterfalse()</span></code></a>.</p>

  516. </dd></dl>

  517. 

  518. <dl class="std 2to3fixer">

  519. <dt class="sig sig-object std" id="to3fixer-itertools">

  520. <span class="sig-name descname"><span class="pre">itertools</span></span><a class="headerlink" href="#to3fixer-itertools" title="Link to this definition">¶</a></dt>

  521. <dd><p>Changes usage of <code class="xref py py-func docutils literal notranslate"><span class="pre">itertools.ifilter()</span></code>, <code class="xref py py-func docutils literal notranslate"><span class="pre">itertools.izip()</span></code>, and

  522. <code class="xref py py-func docutils literal notranslate"><span class="pre">itertools.imap()</span></code> to their built-in equivalents.

  523. <code class="xref py py-func docutils literal notranslate"><span class="pre">itertools.ifilterfalse()</span></code> is changed to <a class="reference internal" href="itertools.html#itertools.filterfalse" title="itertools.filterfalse"><code class="xref py py-func docutils literal notranslate"><span class="pre">itertools.filterfalse()</span></code></a>.</p>

  524. </dd></dl>

  525. 

  526. <dl class="std 2to3fixer">

  527. <dt class="sig sig-object std" id="to3fixer-long">

  528. <span class="sig-name descname"><span class="pre">long</span></span><a class="headerlink" href="#to3fixer-long" title="Link to this definition">¶</a></dt>

  529. <dd><p>Renames <code class="xref py py-class docutils literal notranslate"><span class="pre">long</span></code> to <a class="reference internal" href="functions.html#int" title="int"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></a>.</p>

  530. </dd></dl>

  531. 

  532. <dl class="std 2to3fixer">

  533. <dt class="sig sig-object std" id="to3fixer-map">

  534. <span class="sig-name descname"><span class="pre">map</span></span><a class="headerlink" href="#to3fixer-map" title="Link to this definition">¶</a></dt>

  535. <dd><p>Wraps <a class="reference internal" href="functions.html#map" title="map"><code class="xref py py-func docutils literal notranslate"><span class="pre">map()</span></code></a> in a <a class="reference internal" href="stdtypes.html#list" title="list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a> call.  It also changes <code class="docutils literal notranslate"><span class="pre">map(None,</span> <span class="pre">x)</span></code>

  536. to <code class="docutils literal notranslate"><span class="pre">list(x)</span></code>.  Using <code class="docutils literal notranslate"><span class="pre">from</span> <span class="pre">future_builtins</span> <span class="pre">import</span> <span class="pre">map</span></code> disables this

  537. fixer.</p>

  538. </dd></dl>

  539. 

  540. <dl class="std 2to3fixer">

  541. <dt class="sig sig-object std" id="to3fixer-metaclass">

  542. <span class="sig-name descname"><span class="pre">metaclass</span></span><a class="headerlink" href="#to3fixer-metaclass" title="Link to this definition">¶</a></dt>

  543. <dd><p>Converts the old metaclass syntax (<code class="docutils literal notranslate"><span class="pre">__metaclass__</span> <span class="pre">=</span> <span class="pre">Meta</span></code> in the class

  544. body) to the new (<code class="docutils literal notranslate"><span class="pre">class</span> <span class="pre">X(metaclass=Meta)</span></code>).</p>

  545. </dd></dl>

  546. 

  547. <dl class="std 2to3fixer">

  548. <dt class="sig sig-object std" id="to3fixer-methodattrs">

  549. <span class="sig-name descname"><span class="pre">methodattrs</span></span><a class="headerlink" href="#to3fixer-methodattrs" title="Link to this definition">¶</a></dt>

  550. <dd><p>Fixes old method attribute names.  For example, <code class="docutils literal notranslate"><span class="pre">meth.im_func</span></code> is converted

  551. to <code class="docutils literal notranslate"><span class="pre">meth.__func__</span></code>.</p>

  552. </dd></dl>

  553. 

  554. <dl class="std 2to3fixer">

  555. <dt class="sig sig-object std" id="to3fixer-ne">

  556. <span class="sig-name descname"><span class="pre">ne</span></span><a class="headerlink" href="#to3fixer-ne" title="Link to this definition">¶</a></dt>

  557. <dd><p>Converts the old not-equal syntax, <code class="docutils literal notranslate"><span class="pre">&lt;&gt;</span></code>, to <code class="docutils literal notranslate"><span class="pre">!=</span></code>.</p>

  558. </dd></dl>

  559. 

  560. <dl class="std 2to3fixer">

  561. <dt class="sig sig-object std" id="to3fixer-next">

  562. <span class="sig-name descname"><span class="pre">next</span></span><a class="headerlink" href="#to3fixer-next" title="Link to this definition">¶</a></dt>

  563. <dd><p>Converts the use of iterator’s <code class="xref py py-meth docutils literal notranslate"><span class="pre">next()</span></code> methods to the

  564. <a class="reference internal" href="functions.html#next" title="next"><code class="xref py py-func docutils literal notranslate"><span class="pre">next()</span></code></a> function.  It also renames <a class="reference internal" href="functions.html#next" title="next"><code class="xref py py-meth docutils literal notranslate"><span class="pre">next()</span></code></a> methods to

  565. <a class="reference internal" href="stdtypes.html#iterator.__next__" title="iterator.__next__"><code class="xref py py-meth docutils literal notranslate"><span class="pre">__next__()</span></code></a>.</p>

  566. </dd></dl>

  567. 

  568. <dl class="std 2to3fixer">

  569. <dt class="sig sig-object std" id="to3fixer-nonzero">

  570. <span class="sig-name descname"><span class="pre">nonzero</span></span><a class="headerlink" href="#to3fixer-nonzero" title="Link to this definition">¶</a></dt>

  571. <dd><p>Renames definitions of methods called <code class="xref py py-meth docutils literal notranslate"><span class="pre">__nonzero__()</span></code>

  572. to <a class="reference internal" href="../reference/datamodel.html#object.__bool__" title="object.__bool__"><code class="xref py py-meth docutils literal notranslate"><span class="pre">__bool__()</span></code></a>.</p>

  573. </dd></dl>

  574. 

  575. <dl class="std 2to3fixer">

  576. <dt class="sig sig-object std" id="to3fixer-numliterals">

  577. <span class="sig-name descname"><span class="pre">numliterals</span></span><a class="headerlink" href="#to3fixer-numliterals" title="Link to this definition">¶</a></dt>

  578. <dd><p>Converts octal literals into the new syntax.</p>

  579. </dd></dl>

  580. 

  581. <dl class="std 2to3fixer">

  582. <dt class="sig sig-object std" id="to3fixer-operator">

  583. <span class="sig-name descname"><span class="pre">operator</span></span><a class="headerlink" href="#to3fixer-operator" title="Link to this definition">¶</a></dt>

  584. <dd><p>Converts calls to various functions in the <a class="reference internal" href="operator.html#module-operator" title="operator: Functions corresponding to the standard operators."><code class="xref py py-mod docutils literal notranslate"><span class="pre">operator</span></code></a> module to other,

  585. but equivalent, function calls.  When needed, the appropriate <code class="docutils literal notranslate"><span class="pre">import</span></code>

  586. statements are added, e.g. <code class="docutils literal notranslate"><span class="pre">import</span> <span class="pre">collections.abc</span></code>.  The following mapping

  587. are made:</p>

  588. <table class="docutils align-default">

  589. <thead>

  590. <tr class="row-odd"><th class="head"><p>From</p></th>

  591. <th class="head"><p>To</p></th>

  592. </tr>

  593. </thead>

  594. <tbody>

  595. <tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">operator.isCallable(obj)</span></code></p></td>

  596. <td><p><code class="docutils literal notranslate"><span class="pre">callable(obj)</span></code></p></td>

  597. </tr>

  598. <tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">operator.sequenceIncludes(obj)</span></code></p></td>

  599. <td><p><code class="docutils literal notranslate"><span class="pre">operator.contains(obj)</span></code></p></td>

  600. </tr>

  601. <tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">operator.isSequenceType(obj)</span></code></p></td>

  602. <td><p><code class="docutils literal notranslate"><span class="pre">isinstance(obj,</span> <span class="pre">collections.abc.Sequence)</span></code></p></td>

  603. </tr>

  604. <tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">operator.isMappingType(obj)</span></code></p></td>

  605. <td><p><code class="docutils literal notranslate"><span class="pre">isinstance(obj,</span> <span class="pre">collections.abc.Mapping)</span></code></p></td>

  606. </tr>

  607. <tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">operator.isNumberType(obj)</span></code></p></td>

  608. <td><p><code class="docutils literal notranslate"><span class="pre">isinstance(obj,</span> <span class="pre">numbers.Number)</span></code></p></td>

  609. </tr>

  610. <tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">operator.repeat(obj,</span> <span class="pre">n)</span></code></p></td>

  611. <td><p><code class="docutils literal notranslate"><span class="pre">operator.mul(obj,</span> <span class="pre">n)</span></code></p></td>

  612. </tr>

  613. <tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">operator.irepeat(obj,</span> <span class="pre">n)</span></code></p></td>

  614. <td><p><code class="docutils literal notranslate"><span class="pre">operator.imul(obj,</span> <span class="pre">n)</span></code></p></td>

  615. </tr>

  616. </tbody>

  617. </table>

  618. </dd></dl>

  619. 

  620. <dl class="std 2to3fixer">

  621. <dt class="sig sig-object std" id="to3fixer-paren">

  622. <span class="sig-name descname"><span class="pre">paren</span></span><a class="headerlink" href="#to3fixer-paren" title="Link to this definition">¶</a></dt>

  623. <dd><p>Add extra parenthesis where they are required in list comprehensions.  For

  624. example, <code class="docutils literal notranslate"><span class="pre">[x</span> <span class="pre">for</span> <span class="pre">x</span> <span class="pre">in</span> <span class="pre">1,</span> <span class="pre">2]</span></code> becomes <code class="docutils literal notranslate"><span class="pre">[x</span> <span class="pre">for</span> <span class="pre">x</span> <span class="pre">in</span> <span class="pre">(1,</span> <span class="pre">2)]</span></code>.</p>

  625. </dd></dl>

  626. 

  627. <dl class="std 2to3fixer">

  628. <dt class="sig sig-object std" id="to3fixer-print">

  629. <span class="sig-name descname"><span class="pre">print</span></span><a class="headerlink" href="#to3fixer-print" title="Link to this definition">¶</a></dt>

  630. <dd><p>Converts the <code class="docutils literal notranslate"><span class="pre">print</span></code> statement to the <a class="reference internal" href="functions.html#print" title="print"><code class="xref py py-func docutils literal notranslate"><span class="pre">print()</span></code></a> function.</p>

  631. </dd></dl>

  632. 

  633. <dl class="std 2to3fixer">

  634. <dt class="sig sig-object std" id="to3fixer-raise">

  635. <span class="sig-name descname"><span class="pre">raise</span></span><a class="headerlink" href="#to3fixer-raise" title="Link to this definition">¶</a></dt>

  636. <dd><p>Converts <code class="docutils literal notranslate"><span class="pre">raise</span> <span class="pre">E,</span> <span class="pre">V</span></code> to <code class="docutils literal notranslate"><span class="pre">raise</span> <span class="pre">E(V)</span></code>, and <code class="docutils literal notranslate"><span class="pre">raise</span> <span class="pre">E,</span> <span class="pre">V,</span> <span class="pre">T</span></code> to <code class="docutils literal notranslate"><span class="pre">raise</span>

  637. <span class="pre">E(V).with_traceback(T)</span></code>.  If <code class="docutils literal notranslate"><span class="pre">E</span></code> is a tuple, the translation will be

  638. incorrect because substituting tuples for exceptions has been removed in 3.0.</p>

  639. </dd></dl>

  640. 

  641. <dl class="std 2to3fixer">

  642. <dt class="sig sig-object std" id="to3fixer-raw_input">

  643. <span class="sig-name descname"><span class="pre">raw_input</span></span><a class="headerlink" href="#to3fixer-raw_input" title="Link to this definition">¶</a></dt>

  644. <dd><p>Converts <code class="xref py py-func docutils literal notranslate"><span class="pre">raw_input()</span></code> to <a class="reference internal" href="functions.html#input" title="input"><code class="xref py py-func docutils literal notranslate"><span class="pre">input()</span></code></a>.</p>

  645. </dd></dl>

  646. 

  647. <dl class="std 2to3fixer">

  648. <dt class="sig sig-object std" id="to3fixer-reduce">

  649. <span class="sig-name descname"><span class="pre">reduce</span></span><a class="headerlink" href="#to3fixer-reduce" title="Link to this definition">¶</a></dt>

  650. <dd><p>Handles the move of <code class="xref py py-func docutils literal notranslate"><span class="pre">reduce()</span></code> to <a class="reference internal" href="functools.html#functools.reduce" title="functools.reduce"><code class="xref py py-func docutils literal notranslate"><span class="pre">functools.reduce()</span></code></a>.</p>

  651. </dd></dl>

  652. 

  653. <dl class="std 2to3fixer">

  654. <dt class="sig sig-object std" id="to3fixer-reload">

  655. <span class="sig-name descname"><span class="pre">reload</span></span><a class="headerlink" href="#to3fixer-reload" title="Link to this definition">¶</a></dt>

  656. <dd><p>Converts <code class="xref py py-func docutils literal notranslate"><span class="pre">reload()</span></code> to <a class="reference internal" href="importlib.html#importlib.reload" title="importlib.reload"><code class="xref py py-func docutils literal notranslate"><span class="pre">importlib.reload()</span></code></a>.</p>

  657. </dd></dl>

  658. 

  659. <dl class="std 2to3fixer">

  660. <dt class="sig sig-object std" id="to3fixer-renames">

  661. <span class="sig-name descname"><span class="pre">renames</span></span><a class="headerlink" href="#to3fixer-renames" title="Link to this definition">¶</a></dt>

  662. <dd><p>Changes <code class="xref py py-data docutils literal notranslate"><span class="pre">sys.maxint</span></code> to <a class="reference internal" href="sys.html#sys.maxsize" title="sys.maxsize"><code class="xref py py-data docutils literal notranslate"><span class="pre">sys.maxsize</span></code></a>.</p>

  663. </dd></dl>

  664. 

  665. <dl class="std 2to3fixer">

  666. <dt class="sig sig-object std" id="to3fixer-repr">

  667. <span class="sig-name descname"><span class="pre">repr</span></span><a class="headerlink" href="#to3fixer-repr" title="Link to this definition">¶</a></dt>

  668. <dd><p>Replaces backtick repr with the <a class="reference internal" href="functions.html#repr" title="repr"><code class="xref py py-func docutils literal notranslate"><span class="pre">repr()</span></code></a> function.</p>

  669. </dd></dl>

  670. 

  671. <dl class="std 2to3fixer">

  672. <dt class="sig sig-object std" id="to3fixer-set_literal">

  673. <span class="sig-name descname"><span class="pre">set_literal</span></span><a class="headerlink" href="#to3fixer-set_literal" title="Link to this definition">¶</a></dt>

  674. <dd><p>Replaces use of the <a class="reference internal" href="stdtypes.html#set" title="set"><code class="xref py py-class docutils literal notranslate"><span class="pre">set</span></code></a> constructor with set literals.  This fixer

  675. is optional.</p>

  676. </dd></dl>

  677. 

  678. <dl class="std 2to3fixer">

  679. <dt class="sig sig-object std" id="to3fixer-standarderror">

  680. <span class="sig-name descname"><span class="pre">standarderror</span></span><a class="headerlink" href="#to3fixer-standarderror" title="Link to this definition">¶</a></dt>

  681. <dd><p>Renames <code class="xref py py-exc docutils literal notranslate"><span class="pre">StandardError</span></code> to <a class="reference internal" href="exceptions.html#Exception" title="Exception"><code class="xref py py-exc docutils literal notranslate"><span class="pre">Exception</span></code></a>.</p>

  682. </dd></dl>

  683. 

  684. <dl class="std 2to3fixer">

  685. <dt class="sig sig-object std" id="to3fixer-sys_exc">

  686. <span class="sig-name descname"><span class="pre">sys_exc</span></span><a class="headerlink" href="#to3fixer-sys_exc" title="Link to this definition">¶</a></dt>

  687. <dd><p>Changes the deprecated <code class="xref py py-data docutils literal notranslate"><span class="pre">sys.exc_value</span></code>, <code class="xref py py-data docutils literal notranslate"><span class="pre">sys.exc_type</span></code>,

  688. <code class="xref py py-data docutils literal notranslate"><span class="pre">sys.exc_traceback</span></code> to use <a class="reference internal" href="sys.html#sys.exc_info" title="sys.exc_info"><code class="xref py py-func docutils literal notranslate"><span class="pre">sys.exc_info()</span></code></a>.</p>

  689. </dd></dl>

  690. 

  691. <dl class="std 2to3fixer">

  692. <dt class="sig sig-object std" id="to3fixer-throw">

  693. <span class="sig-name descname"><span class="pre">throw</span></span><a class="headerlink" href="#to3fixer-throw" title="Link to this definition">¶</a></dt>

  694. <dd><p>Fixes the API change in generator’s <code class="xref py py-meth docutils literal notranslate"><span class="pre">throw()</span></code> method.</p>

  695. </dd></dl>

  696. 

  697. <dl class="std 2to3fixer">

  698. <dt class="sig sig-object std" id="to3fixer-tuple_params">

  699. <span class="sig-name descname"><span class="pre">tuple_params</span></span><a class="headerlink" href="#to3fixer-tuple_params" title="Link to this definition">¶</a></dt>

  700. <dd><p>Removes implicit tuple parameter unpacking.  This fixer inserts temporary

  701. variables.</p>

  702. </dd></dl>

  703. 

  704. <dl class="std 2to3fixer">

  705. <dt class="sig sig-object std" id="to3fixer-types">

  706. <span class="sig-name descname"><span class="pre">types</span></span><a class="headerlink" href="#to3fixer-types" title="Link to this definition">¶</a></dt>

  707. <dd><p>Fixes code broken from the removal of some members in the <a class="reference internal" href="types.html#module-types" title="types: Names for built-in types."><code class="xref py py-mod docutils literal notranslate"><span class="pre">types</span></code></a>

  708. module.</p>

  709. </dd></dl>

  710. 

  711. <dl class="std 2to3fixer">

  712. <dt class="sig sig-object std" id="to3fixer-unicode">

  713. <span class="sig-name descname"><span class="pre">unicode</span></span><a class="headerlink" href="#to3fixer-unicode" title="Link to this definition">¶</a></dt>

  714. <dd><p>Renames <code class="xref py py-class docutils literal notranslate"><span class="pre">unicode</span></code> to <a class="reference internal" href="stdtypes.html#str" title="str"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>.</p>

  715. </dd></dl>

  716. 

  717. <dl class="std 2to3fixer">

  718. <dt class="sig sig-object std" id="to3fixer-urllib">

  719. <span class="sig-name descname"><span class="pre">urllib</span></span><a class="headerlink" href="#to3fixer-urllib" title="Link to this definition">¶</a></dt>

  720. <dd><p>Handles the rename of <a class="reference internal" href="urllib.html#module-urllib" title="urllib"><code class="xref py py-mod docutils literal notranslate"><span class="pre">urllib</span></code></a> and <code class="xref py py-mod docutils literal notranslate"><span class="pre">urllib2</span></code> to the <a class="reference internal" href="urllib.html#module-urllib" title="urllib"><code class="xref py py-mod docutils literal notranslate"><span class="pre">urllib</span></code></a>

  721. package.</p>

  722. </dd></dl>

  723. 

  724. <dl class="std 2to3fixer">

  725. <dt class="sig sig-object std" id="to3fixer-ws_comma">

  726. <span class="sig-name descname"><span class="pre">ws_comma</span></span><a class="headerlink" href="#to3fixer-ws_comma" title="Link to this definition">¶</a></dt>

  727. <dd><p>Removes excess whitespace from comma separated items.  This fixer is

  728. optional.</p>

  729. </dd></dl>

  730. 

  731. <dl class="std 2to3fixer">

  732. <dt class="sig sig-object std" id="to3fixer-xrange">

  733. <span class="sig-name descname"><span class="pre">xrange</span></span><a class="headerlink" href="#to3fixer-xrange" title="Link to this definition">¶</a></dt>

  734. <dd><p>Renames <code class="xref py py-func docutils literal notranslate"><span class="pre">xrange()</span></code> to <a class="reference internal" href="stdtypes.html#range" title="range"><code class="xref py py-func docutils literal notranslate"><span class="pre">range()</span></code></a> and wraps existing <a class="reference internal" href="stdtypes.html#range" title="range"><code class="xref py py-func docutils literal notranslate"><span class="pre">range()</span></code></a>

  735. calls with <a class="reference internal" href="stdtypes.html#list" title="list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a>.</p>

  736. </dd></dl>

  737. 

  738. <dl class="std 2to3fixer">

  739. <dt class="sig sig-object std" id="to3fixer-xreadlines">

  740. <span class="sig-name descname"><span class="pre">xreadlines</span></span><a class="headerlink" href="#to3fixer-xreadlines" title="Link to this definition">¶</a></dt>

  741. <dd><p>Changes <code class="docutils literal notranslate"><span class="pre">for</span> <span class="pre">x</span> <span class="pre">in</span> <span class="pre">file.xreadlines()</span></code> to <code class="docutils literal notranslate"><span class="pre">for</span> <span class="pre">x</span> <span class="pre">in</span> <span class="pre">file</span></code>.</p>

  742. </dd></dl>

  743. 

  744. <dl class="std 2to3fixer">

  745. <dt class="sig sig-object std" id="to3fixer-zip">

  746. <span class="sig-name descname"><span class="pre">zip</span></span><a class="headerlink" href="#to3fixer-zip" title="Link to this definition">¶</a></dt>

  747. <dd><p>Wraps <a class="reference internal" href="functions.html#zip" title="zip"><code class="xref py py-func docutils literal notranslate"><span class="pre">zip()</span></code></a> usage in a <a class="reference internal" href="stdtypes.html#list" title="list"><code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></a> call.  This is disabled when

  748. <code class="docutils literal notranslate"><span class="pre">from</span> <span class="pre">future_builtins</span> <span class="pre">import</span> <span class="pre">zip</span></code> appears.</p>

  749. </dd></dl>

  750. 

  751. </section>

  752. <section id="module-lib2to3">

  753. <span id="lib2to3-2to3-s-library"></span><h2><a class="reference internal" href="#module-lib2to3" title="lib2to3: The 2to3 library"><code class="xref py py-mod docutils literal notranslate"><span class="pre">lib2to3</span></code></a> — 2to3’s library<a class="headerlink" href="#module-lib2to3" title="Link to this heading">¶</a></h2>

  754. <p><strong>Source code:</strong> <a class="reference external" href="https://github.com/python/cpython/tree/3.12/Lib/lib2to3/">Lib/lib2to3/</a></p>

  755. <hr class="docutils" />

  756. <div class="deprecated-removed">

  757. <p><span class="versionmodified">Deprecated since version 3.11, will be removed in version 3.13: </span>Python 3.9 switched to a PEG parser (see <span class="target" id="index-0"></span><a class="pep reference external" href="https://peps.python.org/pep-0617/"><strong>PEP 617</strong></a>) while lib2to3 is

  758. using a less flexible LL(1) parser.  Python 3.10 includes new language

  759. syntax that is not parsable by lib2to3’s LL(1) parser (see <span class="target" id="index-1"></span><a class="pep reference external" href="https://peps.python.org/pep-0634/"><strong>PEP 634</strong></a>).

  760. The <code class="docutils literal notranslate"><span class="pre">lib2to3</span></code> module was marked pending for deprecation in Python 3.9

  761. (raising <a class="reference internal" href="exceptions.html#PendingDeprecationWarning" title="PendingDeprecationWarning"><code class="xref py py-exc docutils literal notranslate"><span class="pre">PendingDeprecationWarning</span></code></a> on import) and fully deprecated

  762. in Python 3.11 (raising <a class="reference internal" href="exceptions.html#DeprecationWarning" title="DeprecationWarning"><code class="xref py py-exc docutils literal notranslate"><span class="pre">DeprecationWarning</span></code></a>).

  763. It will be removed from the standard library in Python 3.13.

  764. Consider third-party alternatives such as <a class="reference external" href="https://libcst.readthedocs.io/">LibCST</a> or <a class="reference external" href="https://parso.readthedocs.io/">parso</a>.</p>

  765. </div>

  766. <div class="admonition note">

  767. <p class="admonition-title">Note</p>

  768. <p>The <a class="reference internal" href="#module-lib2to3" title="lib2to3: The 2to3 library"><code class="xref py py-mod docutils literal notranslate"><span class="pre">lib2to3</span></code></a> API should be considered unstable and may change

  769. drastically in the future.</p>

  770. </div>

  771. </section>

  772. </section>

  773. 

  774. 

  775.             <div class="clearer"></div>

  776.           </div>

  777.         </div>

  778.       </div>

  779.       <div class="sphinxsidebar" role="navigation" aria-label="main navigation">

  780.         <div class="sphinxsidebarwrapper">

  781.   <div>

  782.     <h3><a href="../contents.html">Table of Contents</a></h3>

  783.     <ul>

  784. <li><a class="reference internal" href="#">2to3 — Automated Python 2 to 3 code translation</a><ul>

  785. <li><a class="reference internal" href="#using-2to3">Using 2to3</a></li>

  786. <li><a class="reference internal" href="#fixers">Fixers</a></li>

  787. <li><a class="reference internal" href="#module-lib2to3"><code class="xref py py-mod docutils literal notranslate"><span class="pre">lib2to3</span></code> — 2to3’s library</a></li>

  788. </ul>

  789. </li>

  790. </ul>

  791. 

  792.   </div>

  793.   <div>

  794.     <h4>Previous topic</h4>

  795.     <p class="topless"><a href="unittest.mock-examples.html"

  796.                           title="previous chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">unittest.mock</span></code> — getting started</a></p>

  797.   </div>

  798.   <div>

  799.     <h4>Next topic</h4>

  800.     <p class="topless"><a href="test.html"

  801.                           title="next chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">test</span></code> — Regression tests package for Python</a></p>

  802.   </div>

  803.   <div role="note" aria-label="source link">

  804.     <h3>This Page</h3>

  805.     <ul class="this-page-menu">

  806.       <li><a href="../bugs.html">Report a Bug</a></li>

  807.       <li>

  808.         <a href="https://github.com/python/cpython/blob/main/Doc/library/2to3.rst"

  809.             rel="nofollow">Show Source

  810.         </a>

  811.       </li>

  812.     </ul>

  813.   </div>

  814.         </div>

  815. <div id="sidebarbutton" title="Collapse sidebar">

  816. <span>«</span>

  817. </div>

  818. 

  819.       </div>

  820.       <div class="clearer"></div>

  821.     </div>  

  822.     <div class="related" role="navigation" aria-label="related navigation">

  823.       <h3>Navigation</h3>

  824.       <ul>

  825.         <li class="right" style="margin-right: 10px">

  826.           <a href="../genindex.html" title="General Index"

  827.              >index</a></li>

  828.         <li class="right" >

  829.           <a href="../py-modindex.html" title="Python Module Index"

  830.              >modules</a> |</li>

  831.         <li class="right" >

  832.           <a href="test.html" title="test — Regression tests package for Python"

  833.              >next</a> |</li>

  834.         <li class="right" >

  835.           <a href="unittest.mock-examples.html" title="unittest.mock — getting started"

  836.              >previous</a> |</li>

  837. 

  838.           <li><img src="../_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"/></li>

  839.           <li><a href="https://www.python.org/">Python</a> &#187;</li>

  840.           <li class="switchers">

  841.             <div class="language_switcher_placeholder"></div>

  842.             <div class="version_switcher_placeholder"></div>

  843.           </li>

  844.           <li>

  845.               

  846.           </li>

  847.     <li id="cpython-language-and-version">

  848.       <a href="../index.html">3.12.3 Documentation</a> &#187;

  849.     </li>

  850. 

  851.           <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> &#187;</li>

  852.           <li class="nav-item nav-item-2"><a href="development.html" >Development Tools</a> &#187;</li>

  853.         <li class="nav-item nav-item-this"><a href="">2to3 — Automated Python 2 to 3 code translation</a></li>

  854.                 <li class="right">

  855.                     

  856. 

  857.     <div class="inline-search" role="search">

  858.         <form class="inline-search" action="../search.html" method="get">

  859.           <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box" />

  860.           <input type="submit" value="Go" />

  861.         </form>

  862.     </div>

  863.                      |

  864.                 </li>

  865.             <li class="right">

  866. <label class="theme-selector-label">

  867.     Theme

  868.     <select class="theme-selector" oninput="activateTheme(this.value)">

  869.         <option value="auto" selected>Auto</option>

  870.         <option value="light">Light</option>

  871.         <option value="dark">Dark</option>

  872.     </select>

  873. </label> |</li>

  874.             

  875.       </ul>

  876.     </div>  

  877.     <div class="footer">

  878.     &copy; 

  879.       <a href="../copyright.html">

  880.     

  881.     Copyright

  882.     

  883.       </a>

  884.      2001-2024, Python Software Foundation.

  885.     <br />

  886.     This page is licensed under the Python Software Foundation License Version 2.

  887.     <br />

  888.     Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License.

  889.     <br />

  890.     

  891.       See <a href="/license.html">History and License</a> for more information.<br />

  892.     

  893.     

  894.     <br />

  895. 

  896.     The Python Software Foundation is a non-profit corporation.

  897. <a href="https://www.python.org/psf/donations/">Please donate.</a>

  898. <br />

  899.     <br />

  900.       Last updated on Apr 09, 2024 (13:47 UTC).

  901.     

  902.       <a href="/bugs.html">Found a bug</a>?

  903.     

  904.     <br />

  905. 

  906.     Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.2.6.

  907.     </div>

  908. 

  909.   </body>

  910. </html>
上海开阖软件有限公司 沪ICP备12045867号-1