Baoding-FenShuaJiang
/
Green_GoodERP18_FSJ_Standard
Следить 1
В избранное 0
Вики 捐赠
gooderp18绿色标准版
Вы не можете выбрать более 25 тем Темы должны начинаться с буквы или цифры, могут содержать дефисы(-) и должны содержать не более 35 символов.
Дерево: 0f75e31513
Ветки Теги
${ item.name }
Создать ветку ${ searchTerm }
из '0f75e31513'
${ noResults }
Green_GoodERP18_FSJ_Standard/python/Doc/html/library/bdb.html

826 lines
69KB
Исходник Blame История 

  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="bdb — Debugger framework" />

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

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

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

  11. <meta property="og:description" content="Source code: Lib/bdb.py The bdb module handles basic debugger functions, like setting breakpoints or managing execution via the debugger. The following exception is defined: The bdb module also def..." />

  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="Source code: Lib/bdb.py The bdb module handles basic debugger functions, like setting breakpoints or managing execution via the debugger. The following exception is defined: The bdb module also def..." />

  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>bdb — Debugger framework &#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="faulthandler — Dump the Python traceback" href="faulthandler.html" />

  39.     <link rel="prev" title="Audit events table" href="audit_events.html" />

  40.     <link rel="canonical" href="https://docs.python.org/3/library/bdb.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.     <h4>Previous topic</h4>

  97.     <p class="topless"><a href="audit_events.html"

  98.                           title="previous chapter">Audit events table</a></p>

  99.   </div>

  100.   <div>

  101.     <h4>Next topic</h4>

  102.     <p class="topless"><a href="faulthandler.html"

  103.                           title="next chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">faulthandler</span></code> — Dump the Python traceback</a></p>

  104.   </div>

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

  106.     <h3>This Page</h3>

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

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

  109.       <li>

  110.         <a href="https://github.com/python/cpython/blob/main/Doc/library/bdb.rst"

  111.             rel="nofollow">Show Source

  112.         </a>

  113.       </li>

  114.     </ul>

  115.   </div>

  116.         </nav>

  117.     </div>

  118. </div>

  119. 

  120.   

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

  122.       <h3>Navigation</h3>

  123.       <ul>

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

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

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

  127.         <li class="right" >

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

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

  130.         <li class="right" >

  131.           <a href="faulthandler.html" title="faulthandler — Dump the Python traceback"

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

  133.         <li class="right" >

  134.           <a href="audit_events.html" title="Audit events table"

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

  136. 

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

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

  139.           <li class="switchers">

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

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

  142.           </li>

  143.           <li>

  144.               

  145.           </li>

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

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

  148.     </li>

  149. 

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

  151.           <li class="nav-item nav-item-2"><a href="debug.html" accesskey="U">Debugging and Profiling</a> &#187;</li>

  152.         <li class="nav-item nav-item-this"><a href=""><code class="xref py py-mod docutils literal notranslate"><span class="pre">bdb</span></code> — Debugger framework</a></li>

  153.                 <li class="right">

  154.                     

  155. 

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

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

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

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

  160.         </form>

  161.     </div>

  162.                      |

  163.                 </li>

  164.             <li class="right">

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

  166.     Theme

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

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

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

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

  171.     </select>

  172. </label> |</li>

  173.             

  174.       </ul>

  175.     </div>    

  176. 

  177.     <div class="document">

  178.       <div class="documentwrapper">

  179.         <div class="bodywrapper">

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

  181.             

  182.   <section id="module-bdb">

  183. <span id="bdb-debugger-framework"></span><h1><a class="reference internal" href="#module-bdb" title="bdb: Debugger framework."><code class="xref py py-mod docutils literal notranslate"><span class="pre">bdb</span></code></a> — Debugger framework<a class="headerlink" href="#module-bdb" title="Link to this heading">¶</a></h1>

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

  185. <hr class="docutils" />

  186. <p>The <a class="reference internal" href="#module-bdb" title="bdb: Debugger framework."><code class="xref py py-mod docutils literal notranslate"><span class="pre">bdb</span></code></a> module handles basic debugger functions, like setting breakpoints

  187. or managing execution via the debugger.</p>

  188. <p>The following exception is defined:</p>

  189. <dl class="py exception">

  190. <dt class="sig sig-object py" id="bdb.BdbQuit">

  191. <em class="property"><span class="pre">exception</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">bdb.</span></span><span class="sig-name descname"><span class="pre">BdbQuit</span></span><a class="headerlink" href="#bdb.BdbQuit" title="Link to this definition">¶</a></dt>

  192. <dd><p>Exception raised by the <a class="reference internal" href="#bdb.Bdb" title="bdb.Bdb"><code class="xref py py-class docutils literal notranslate"><span class="pre">Bdb</span></code></a> class for quitting the debugger.</p>

  193. </dd></dl>

  194. 

  195. <p>The <a class="reference internal" href="#module-bdb" title="bdb: Debugger framework."><code class="xref py py-mod docutils literal notranslate"><span class="pre">bdb</span></code></a> module also defines two classes:</p>

  196. <dl class="py class">

  197. <dt class="sig sig-object py" id="bdb.Breakpoint">

  198. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">bdb.</span></span><span class="sig-name descname"><span class="pre">Breakpoint</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">file</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">line</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">temporary</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">cond</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">funcname</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Breakpoint" title="Link to this definition">¶</a></dt>

  199. <dd><p>This class implements temporary breakpoints, ignore counts, disabling and

  200. (re-)enabling, and conditionals.</p>

  201. <p>Breakpoints are indexed by number through a list called <a class="reference internal" href="#bdb.Breakpoint.bpbynumber" title="bdb.Breakpoint.bpbynumber"><code class="xref py py-attr docutils literal notranslate"><span class="pre">bpbynumber</span></code></a>

  202. and by <code class="docutils literal notranslate"><span class="pre">(file,</span> <span class="pre">line)</span></code> pairs through <a class="reference internal" href="#bdb.Breakpoint.bplist" title="bdb.Breakpoint.bplist"><code class="xref py py-attr docutils literal notranslate"><span class="pre">bplist</span></code></a>.  The former points to

  203. a single instance of class <a class="reference internal" href="#bdb.Breakpoint" title="bdb.Breakpoint"><code class="xref py py-class docutils literal notranslate"><span class="pre">Breakpoint</span></code></a>.  The latter points to a list

  204. of such instances since there may be more than one breakpoint per line.</p>

  205. <p>When creating a breakpoint, its associated <a class="reference internal" href="#bdb.Breakpoint.file" title="bdb.Breakpoint.file"><code class="xref py py-attr docutils literal notranslate"><span class="pre">file</span> <span class="pre">name</span></code></a> should

  206. be in canonical form.  If a <a class="reference internal" href="#bdb.Breakpoint.funcname" title="bdb.Breakpoint.funcname"><code class="xref py py-attr docutils literal notranslate"><span class="pre">funcname</span></code></a> is defined, a breakpoint

  207. <a class="reference internal" href="#bdb.Breakpoint.hits" title="bdb.Breakpoint.hits"><code class="xref py py-attr docutils literal notranslate"><span class="pre">hit</span></code></a> will be counted when the first line of that function is

  208. executed.  A <a class="reference internal" href="#bdb.Breakpoint.cond" title="bdb.Breakpoint.cond"><code class="xref py py-attr docutils literal notranslate"><span class="pre">conditional</span></code></a> breakpoint always counts a

  209. <a class="reference internal" href="#bdb.Breakpoint.hits" title="bdb.Breakpoint.hits"><code class="xref py py-attr docutils literal notranslate"><span class="pre">hit</span></code></a>.</p>

  210. <p><a class="reference internal" href="#bdb.Breakpoint" title="bdb.Breakpoint"><code class="xref py py-class docutils literal notranslate"><span class="pre">Breakpoint</span></code></a> instances have the following methods:</p>

  211. <dl class="py method">

  212. <dt class="sig sig-object py" id="bdb.Breakpoint.deleteMe">

  213. <span class="sig-name descname"><span class="pre">deleteMe</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Breakpoint.deleteMe" title="Link to this definition">¶</a></dt>

  214. <dd><p>Delete the breakpoint from the list associated to a file/line.  If it is

  215. the last breakpoint in that position, it also deletes the entry for the

  216. file/line.</p>

  217. </dd></dl>

  218. 

  219. <dl class="py method">

  220. <dt class="sig sig-object py" id="bdb.Breakpoint.enable">

  221. <span class="sig-name descname"><span class="pre">enable</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Breakpoint.enable" title="Link to this definition">¶</a></dt>

  222. <dd><p>Mark the breakpoint as enabled.</p>

  223. </dd></dl>

  224. 

  225. <dl class="py method">

  226. <dt class="sig sig-object py" id="bdb.Breakpoint.disable">

  227. <span class="sig-name descname"><span class="pre">disable</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Breakpoint.disable" title="Link to this definition">¶</a></dt>

  228. <dd><p>Mark the breakpoint as disabled.</p>

  229. </dd></dl>

  230. 

  231. <dl class="py method">

  232. <dt class="sig sig-object py" id="bdb.Breakpoint.bpformat">

  233. <span class="sig-name descname"><span class="pre">bpformat</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Breakpoint.bpformat" title="Link to this definition">¶</a></dt>

  234. <dd><p>Return a string with all the information about the breakpoint, nicely

  235. formatted:</p>

  236. <ul class="simple">

  237. <li><p>Breakpoint number.</p></li>

  238. <li><p>Temporary status (del or keep).</p></li>

  239. <li><p>File/line position.</p></li>

  240. <li><p>Break condition.</p></li>

  241. <li><p>Number of times to ignore.</p></li>

  242. <li><p>Number of times hit.</p></li>

  243. </ul>

  244. <div class="versionadded">

  245. <p><span class="versionmodified added">New in version 3.2.</span></p>

  246. </div>

  247. </dd></dl>

  248. 

  249. <dl class="py method">

  250. <dt class="sig sig-object py" id="bdb.Breakpoint.bpprint">

  251. <span class="sig-name descname"><span class="pre">bpprint</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">out</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Breakpoint.bpprint" title="Link to this definition">¶</a></dt>

  252. <dd><p>Print the output of <a class="reference internal" href="#bdb.Breakpoint.bpformat" title="bdb.Breakpoint.bpformat"><code class="xref py py-meth docutils literal notranslate"><span class="pre">bpformat()</span></code></a> to the file <em>out</em>, or if it is

  253. <code class="docutils literal notranslate"><span class="pre">None</span></code>, to standard output.</p>

  254. </dd></dl>

  255. 

  256. <p><a class="reference internal" href="#bdb.Breakpoint" title="bdb.Breakpoint"><code class="xref py py-class docutils literal notranslate"><span class="pre">Breakpoint</span></code></a> instances have the following attributes:</p>

  257. <dl class="py attribute">

  258. <dt class="sig sig-object py" id="bdb.Breakpoint.file">

  259. <span class="sig-name descname"><span class="pre">file</span></span><a class="headerlink" href="#bdb.Breakpoint.file" title="Link to this definition">¶</a></dt>

  260. <dd><p>File name of the <a class="reference internal" href="#bdb.Breakpoint" title="bdb.Breakpoint"><code class="xref py py-class docutils literal notranslate"><span class="pre">Breakpoint</span></code></a>.</p>

  261. </dd></dl>

  262. 

  263. <dl class="py attribute">

  264. <dt class="sig sig-object py" id="bdb.Breakpoint.line">

  265. <span class="sig-name descname"><span class="pre">line</span></span><a class="headerlink" href="#bdb.Breakpoint.line" title="Link to this definition">¶</a></dt>

  266. <dd><p>Line number of the <a class="reference internal" href="#bdb.Breakpoint" title="bdb.Breakpoint"><code class="xref py py-class docutils literal notranslate"><span class="pre">Breakpoint</span></code></a> within <a class="reference internal" href="#bdb.Breakpoint.file" title="bdb.Breakpoint.file"><code class="xref py py-attr docutils literal notranslate"><span class="pre">file</span></code></a>.</p>

  267. </dd></dl>

  268. 

  269. <dl class="py attribute">

  270. <dt class="sig sig-object py" id="bdb.Breakpoint.temporary">

  271. <span class="sig-name descname"><span class="pre">temporary</span></span><a class="headerlink" href="#bdb.Breakpoint.temporary" title="Link to this definition">¶</a></dt>

  272. <dd><p>True if a <a class="reference internal" href="#bdb.Breakpoint" title="bdb.Breakpoint"><code class="xref py py-class docutils literal notranslate"><span class="pre">Breakpoint</span></code></a> at (file, line) is temporary.</p>

  273. </dd></dl>

  274. 

  275. <dl class="py attribute">

  276. <dt class="sig sig-object py" id="bdb.Breakpoint.cond">

  277. <span class="sig-name descname"><span class="pre">cond</span></span><a class="headerlink" href="#bdb.Breakpoint.cond" title="Link to this definition">¶</a></dt>

  278. <dd><p>Condition for evaluating a <a class="reference internal" href="#bdb.Breakpoint" title="bdb.Breakpoint"><code class="xref py py-class docutils literal notranslate"><span class="pre">Breakpoint</span></code></a> at (file, line).</p>

  279. </dd></dl>

  280. 

  281. <dl class="py attribute">

  282. <dt class="sig sig-object py" id="bdb.Breakpoint.funcname">

  283. <span class="sig-name descname"><span class="pre">funcname</span></span><a class="headerlink" href="#bdb.Breakpoint.funcname" title="Link to this definition">¶</a></dt>

  284. <dd><p>Function name that defines whether a <a class="reference internal" href="#bdb.Breakpoint" title="bdb.Breakpoint"><code class="xref py py-class docutils literal notranslate"><span class="pre">Breakpoint</span></code></a> is hit upon

  285. entering the function.</p>

  286. </dd></dl>

  287. 

  288. <dl class="py attribute">

  289. <dt class="sig sig-object py" id="bdb.Breakpoint.enabled">

  290. <span class="sig-name descname"><span class="pre">enabled</span></span><a class="headerlink" href="#bdb.Breakpoint.enabled" title="Link to this definition">¶</a></dt>

  291. <dd><p>True if <a class="reference internal" href="#bdb.Breakpoint" title="bdb.Breakpoint"><code class="xref py py-class docutils literal notranslate"><span class="pre">Breakpoint</span></code></a> is enabled.</p>

  292. </dd></dl>

  293. 

  294. <dl class="py attribute">

  295. <dt class="sig sig-object py" id="bdb.Breakpoint.bpbynumber">

  296. <span class="sig-name descname"><span class="pre">bpbynumber</span></span><a class="headerlink" href="#bdb.Breakpoint.bpbynumber" title="Link to this definition">¶</a></dt>

  297. <dd><p>Numeric index for a single instance of a <a class="reference internal" href="#bdb.Breakpoint" title="bdb.Breakpoint"><code class="xref py py-class docutils literal notranslate"><span class="pre">Breakpoint</span></code></a>.</p>

  298. </dd></dl>

  299. 

  300. <dl class="py attribute">

  301. <dt class="sig sig-object py" id="bdb.Breakpoint.bplist">

  302. <span class="sig-name descname"><span class="pre">bplist</span></span><a class="headerlink" href="#bdb.Breakpoint.bplist" title="Link to this definition">¶</a></dt>

  303. <dd><p>Dictionary of <a class="reference internal" href="#bdb.Breakpoint" title="bdb.Breakpoint"><code class="xref py py-class docutils literal notranslate"><span class="pre">Breakpoint</span></code></a> instances indexed by

  304. (<a class="reference internal" href="#bdb.Breakpoint.file" title="bdb.Breakpoint.file"><code class="xref py py-attr docutils literal notranslate"><span class="pre">file</span></code></a>, <a class="reference internal" href="#bdb.Breakpoint.line" title="bdb.Breakpoint.line"><code class="xref py py-attr docutils literal notranslate"><span class="pre">line</span></code></a>) tuples.</p>

  305. </dd></dl>

  306. 

  307. <dl class="py attribute">

  308. <dt class="sig sig-object py" id="bdb.Breakpoint.ignore">

  309. <span class="sig-name descname"><span class="pre">ignore</span></span><a class="headerlink" href="#bdb.Breakpoint.ignore" title="Link to this definition">¶</a></dt>

  310. <dd><p>Number of times to ignore a <a class="reference internal" href="#bdb.Breakpoint" title="bdb.Breakpoint"><code class="xref py py-class docutils literal notranslate"><span class="pre">Breakpoint</span></code></a>.</p>

  311. </dd></dl>

  312. 

  313. <dl class="py attribute">

  314. <dt class="sig sig-object py" id="bdb.Breakpoint.hits">

  315. <span class="sig-name descname"><span class="pre">hits</span></span><a class="headerlink" href="#bdb.Breakpoint.hits" title="Link to this definition">¶</a></dt>

  316. <dd><p>Count of the number of times a <a class="reference internal" href="#bdb.Breakpoint" title="bdb.Breakpoint"><code class="xref py py-class docutils literal notranslate"><span class="pre">Breakpoint</span></code></a> has been hit.</p>

  317. </dd></dl>

  318. 

  319. </dd></dl>

  320. 

  321. <dl class="py class">

  322. <dt class="sig sig-object py" id="bdb.Bdb">

  323. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">bdb.</span></span><span class="sig-name descname"><span class="pre">Bdb</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">skip</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb" title="Link to this definition">¶</a></dt>

  324. <dd><p>The <a class="reference internal" href="#bdb.Bdb" title="bdb.Bdb"><code class="xref py py-class docutils literal notranslate"><span class="pre">Bdb</span></code></a> class acts as a generic Python debugger base class.</p>

  325. <p>This class takes care of the details of the trace facility; a derived class

  326. should implement user interaction.  The standard debugger class

  327. (<a class="reference internal" href="pdb.html#pdb.Pdb" title="pdb.Pdb"><code class="xref py py-class docutils literal notranslate"><span class="pre">pdb.Pdb</span></code></a>) is an example.</p>

  328. <p>The <em>skip</em> argument, if given, must be an iterable of glob-style

  329. module name patterns.  The debugger will not step into frames that

  330. originate in a module that matches one of these patterns. Whether a

  331. frame is considered to originate in a certain module is determined

  332. by the <code class="docutils literal notranslate"><span class="pre">__name__</span></code> in the frame globals.</p>

  333. <div class="versionchanged">

  334. <p><span class="versionmodified changed">Changed in version 3.1: </span>Added the <em>skip</em> parameter.</p>

  335. </div>

  336. <p>The following methods of <a class="reference internal" href="#bdb.Bdb" title="bdb.Bdb"><code class="xref py py-class docutils literal notranslate"><span class="pre">Bdb</span></code></a> normally don’t need to be overridden.</p>

  337. <dl class="py method">

  338. <dt class="sig sig-object py" id="bdb.Bdb.canonic">

  339. <span class="sig-name descname"><span class="pre">canonic</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">filename</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.canonic" title="Link to this definition">¶</a></dt>

  340. <dd><p>Return canonical form of <em>filename</em>.</p>

  341. <p>For real file names, the canonical form is an operating-system-dependent,

  342. <a class="reference internal" href="os.path.html#os.path.normcase" title="os.path.normcase"><code class="xref py py-func docutils literal notranslate"><span class="pre">case-normalized</span></code></a> <a class="reference internal" href="os.path.html#os.path.abspath" title="os.path.abspath"><code class="xref py py-func docutils literal notranslate"><span class="pre">absolute</span> <span class="pre">path</span></code></a>. A <em>filename</em> with angle brackets, such as <code class="docutils literal notranslate"><span class="pre">&quot;&lt;stdin&gt;&quot;</span></code>

  343. generated in interactive mode, is returned unchanged.</p>

  344. </dd></dl>

  345. 

  346. <dl class="py method">

  347. <dt class="sig sig-object py" id="bdb.Bdb.reset">

  348. <span class="sig-name descname"><span class="pre">reset</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.reset" title="Link to this definition">¶</a></dt>

  349. <dd><p>Set the <code class="xref py py-attr docutils literal notranslate"><span class="pre">botframe</span></code>, <code class="xref py py-attr docutils literal notranslate"><span class="pre">stopframe</span></code>, <code class="xref py py-attr docutils literal notranslate"><span class="pre">returnframe</span></code> and

  350. <a class="reference internal" href="#bdb.Bdb.set_quit" title="bdb.Bdb.set_quit"><code class="xref py py-attr docutils literal notranslate"><span class="pre">quitting</span></code></a> attributes with values ready to start debugging.</p>

  351. </dd></dl>

  352. 

  353. <dl class="py method">

  354. <dt class="sig sig-object py" id="bdb.Bdb.trace_dispatch">

  355. <span class="sig-name descname"><span class="pre">trace_dispatch</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">frame</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">event</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.trace_dispatch" title="Link to this definition">¶</a></dt>

  356. <dd><p>This function is installed as the trace function of debugged frames.  Its

  357. return value is the new trace function (in most cases, that is, itself).</p>

  358. <p>The default implementation decides how to dispatch a frame, depending on

  359. the type of event (passed as a string) that is about to be executed.

  360. <em>event</em> can be one of the following:</p>

  361. <ul class="simple">

  362. <li><p><code class="docutils literal notranslate"><span class="pre">&quot;line&quot;</span></code>: A new line of code is going to be executed.</p></li>

  363. <li><p><code class="docutils literal notranslate"><span class="pre">&quot;call&quot;</span></code>: A function is about to be called, or another code block

  364. entered.</p></li>

  365. <li><p><code class="docutils literal notranslate"><span class="pre">&quot;return&quot;</span></code>: A function or other code block is about to return.</p></li>

  366. <li><p><code class="docutils literal notranslate"><span class="pre">&quot;exception&quot;</span></code>: An exception has occurred.</p></li>

  367. <li><p><code class="docutils literal notranslate"><span class="pre">&quot;c_call&quot;</span></code>: A C function is about to be called.</p></li>

  368. <li><p><code class="docutils literal notranslate"><span class="pre">&quot;c_return&quot;</span></code>: A C function has returned.</p></li>

  369. <li><p><code class="docutils literal notranslate"><span class="pre">&quot;c_exception&quot;</span></code>: A C function has raised an exception.</p></li>

  370. </ul>

  371. <p>For the Python events, specialized functions (see below) are called.  For

  372. the C events, no action is taken.</p>

  373. <p>The <em>arg</em> parameter depends on the previous event.</p>

  374. <p>See the documentation for <a class="reference internal" href="sys.html#sys.settrace" title="sys.settrace"><code class="xref py py-func docutils literal notranslate"><span class="pre">sys.settrace()</span></code></a> for more information on the

  375. trace function.  For more information on code and frame objects, refer to

  376. <a class="reference internal" href="../reference/datamodel.html#types"><span class="std std-ref">The standard type hierarchy</span></a>.</p>

  377. </dd></dl>

  378. 

  379. <dl class="py method">

  380. <dt class="sig sig-object py" id="bdb.Bdb.dispatch_line">

  381. <span class="sig-name descname"><span class="pre">dispatch_line</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">frame</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.dispatch_line" title="Link to this definition">¶</a></dt>

  382. <dd><p>If the debugger should stop on the current line, invoke the

  383. <a class="reference internal" href="#bdb.Bdb.user_line" title="bdb.Bdb.user_line"><code class="xref py py-meth docutils literal notranslate"><span class="pre">user_line()</span></code></a> method (which should be overridden in subclasses).

  384. Raise a <a class="reference internal" href="#bdb.BdbQuit" title="bdb.BdbQuit"><code class="xref py py-exc docutils literal notranslate"><span class="pre">BdbQuit</span></code></a> exception if the <a class="reference internal" href="#bdb.Bdb.set_quit" title="bdb.Bdb.set_quit"><code class="xref py py-attr docutils literal notranslate"><span class="pre">quitting</span></code></a> flag is set

  385. (which can be set from <a class="reference internal" href="#bdb.Bdb.user_line" title="bdb.Bdb.user_line"><code class="xref py py-meth docutils literal notranslate"><span class="pre">user_line()</span></code></a>).  Return a reference to the

  386. <a class="reference internal" href="#bdb.Bdb.trace_dispatch" title="bdb.Bdb.trace_dispatch"><code class="xref py py-meth docutils literal notranslate"><span class="pre">trace_dispatch()</span></code></a> method for further tracing in that scope.</p>

  387. </dd></dl>

  388. 

  389. <dl class="py method">

  390. <dt class="sig sig-object py" id="bdb.Bdb.dispatch_call">

  391. <span class="sig-name descname"><span class="pre">dispatch_call</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">frame</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.dispatch_call" title="Link to this definition">¶</a></dt>

  392. <dd><p>If the debugger should stop on this function call, invoke the

  393. <a class="reference internal" href="#bdb.Bdb.user_call" title="bdb.Bdb.user_call"><code class="xref py py-meth docutils literal notranslate"><span class="pre">user_call()</span></code></a> method (which should be overridden in subclasses).

  394. Raise a <a class="reference internal" href="#bdb.BdbQuit" title="bdb.BdbQuit"><code class="xref py py-exc docutils literal notranslate"><span class="pre">BdbQuit</span></code></a> exception if the <a class="reference internal" href="#bdb.Bdb.set_quit" title="bdb.Bdb.set_quit"><code class="xref py py-attr docutils literal notranslate"><span class="pre">quitting</span></code></a> flag is set

  395. (which can be set from <a class="reference internal" href="#bdb.Bdb.user_call" title="bdb.Bdb.user_call"><code class="xref py py-meth docutils literal notranslate"><span class="pre">user_call()</span></code></a>).  Return a reference to the

  396. <a class="reference internal" href="#bdb.Bdb.trace_dispatch" title="bdb.Bdb.trace_dispatch"><code class="xref py py-meth docutils literal notranslate"><span class="pre">trace_dispatch()</span></code></a> method for further tracing in that scope.</p>

  397. </dd></dl>

  398. 

  399. <dl class="py method">

  400. <dt class="sig sig-object py" id="bdb.Bdb.dispatch_return">

  401. <span class="sig-name descname"><span class="pre">dispatch_return</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">frame</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.dispatch_return" title="Link to this definition">¶</a></dt>

  402. <dd><p>If the debugger should stop on this function return, invoke the

  403. <a class="reference internal" href="#bdb.Bdb.user_return" title="bdb.Bdb.user_return"><code class="xref py py-meth docutils literal notranslate"><span class="pre">user_return()</span></code></a> method (which should be overridden in subclasses).

  404. Raise a <a class="reference internal" href="#bdb.BdbQuit" title="bdb.BdbQuit"><code class="xref py py-exc docutils literal notranslate"><span class="pre">BdbQuit</span></code></a> exception if the <a class="reference internal" href="#bdb.Bdb.set_quit" title="bdb.Bdb.set_quit"><code class="xref py py-attr docutils literal notranslate"><span class="pre">quitting</span></code></a> flag is set

  405. (which can be set from <a class="reference internal" href="#bdb.Bdb.user_return" title="bdb.Bdb.user_return"><code class="xref py py-meth docutils literal notranslate"><span class="pre">user_return()</span></code></a>).  Return a reference to the

  406. <a class="reference internal" href="#bdb.Bdb.trace_dispatch" title="bdb.Bdb.trace_dispatch"><code class="xref py py-meth docutils literal notranslate"><span class="pre">trace_dispatch()</span></code></a> method for further tracing in that scope.</p>

  407. </dd></dl>

  408. 

  409. <dl class="py method">

  410. <dt class="sig sig-object py" id="bdb.Bdb.dispatch_exception">

  411. <span class="sig-name descname"><span class="pre">dispatch_exception</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">frame</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.dispatch_exception" title="Link to this definition">¶</a></dt>

  412. <dd><p>If the debugger should stop at this exception, invokes the

  413. <a class="reference internal" href="#bdb.Bdb.user_exception" title="bdb.Bdb.user_exception"><code class="xref py py-meth docutils literal notranslate"><span class="pre">user_exception()</span></code></a> method (which should be overridden in subclasses).

  414. Raise a <a class="reference internal" href="#bdb.BdbQuit" title="bdb.BdbQuit"><code class="xref py py-exc docutils literal notranslate"><span class="pre">BdbQuit</span></code></a> exception if the <a class="reference internal" href="#bdb.Bdb.set_quit" title="bdb.Bdb.set_quit"><code class="xref py py-attr docutils literal notranslate"><span class="pre">quitting</span></code></a> flag is set

  415. (which can be set from <a class="reference internal" href="#bdb.Bdb.user_exception" title="bdb.Bdb.user_exception"><code class="xref py py-meth docutils literal notranslate"><span class="pre">user_exception()</span></code></a>).  Return a reference to the

  416. <a class="reference internal" href="#bdb.Bdb.trace_dispatch" title="bdb.Bdb.trace_dispatch"><code class="xref py py-meth docutils literal notranslate"><span class="pre">trace_dispatch()</span></code></a> method for further tracing in that scope.</p>

  417. </dd></dl>

  418. 

  419. <p>Normally derived classes don’t override the following methods, but they may

  420. if they want to redefine the definition of stopping and breakpoints.</p>

  421. <dl class="py method">

  422. <dt class="sig sig-object py" id="bdb.Bdb.is_skipped_line">

  423. <span class="sig-name descname"><span class="pre">is_skipped_line</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">module_name</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.is_skipped_line" title="Link to this definition">¶</a></dt>

  424. <dd><p>Return True if <em>module_name</em> matches any skip pattern.</p>

  425. </dd></dl>

  426. 

  427. <dl class="py method">

  428. <dt class="sig sig-object py" id="bdb.Bdb.stop_here">

  429. <span class="sig-name descname"><span class="pre">stop_here</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">frame</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.stop_here" title="Link to this definition">¶</a></dt>

  430. <dd><p>Return True if <em>frame</em> is below the starting frame in the stack.</p>

  431. </dd></dl>

  432. 

  433. <dl class="py method">

  434. <dt class="sig sig-object py" id="bdb.Bdb.break_here">

  435. <span class="sig-name descname"><span class="pre">break_here</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">frame</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.break_here" title="Link to this definition">¶</a></dt>

  436. <dd><p>Return True if there is an effective breakpoint for this line.</p>

  437. <p>Check whether a line or function breakpoint exists and is in effect.  Delete temporary

  438. breakpoints based on information from <a class="reference internal" href="#bdb.effective" title="bdb.effective"><code class="xref py py-func docutils literal notranslate"><span class="pre">effective()</span></code></a>.</p>

  439. </dd></dl>

  440. 

  441. <dl class="py method">

  442. <dt class="sig sig-object py" id="bdb.Bdb.break_anywhere">

  443. <span class="sig-name descname"><span class="pre">break_anywhere</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">frame</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.break_anywhere" title="Link to this definition">¶</a></dt>

  444. <dd><p>Return True if any breakpoint exists for <em>frame</em>’s filename.</p>

  445. </dd></dl>

  446. 

  447. <p>Derived classes should override these methods to gain control over debugger

  448. operation.</p>

  449. <dl class="py method">

  450. <dt class="sig sig-object py" id="bdb.Bdb.user_call">

  451. <span class="sig-name descname"><span class="pre">user_call</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">frame</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">argument_list</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.user_call" title="Link to this definition">¶</a></dt>

  452. <dd><p>Called from <a class="reference internal" href="#bdb.Bdb.dispatch_call" title="bdb.Bdb.dispatch_call"><code class="xref py py-meth docutils literal notranslate"><span class="pre">dispatch_call()</span></code></a> if a break might stop inside the

  453. called function.</p>

  454. </dd></dl>

  455. 

  456. <dl class="py method">

  457. <dt class="sig sig-object py" id="bdb.Bdb.user_line">

  458. <span class="sig-name descname"><span class="pre">user_line</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">frame</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.user_line" title="Link to this definition">¶</a></dt>

  459. <dd><p>Called from <a class="reference internal" href="#bdb.Bdb.dispatch_line" title="bdb.Bdb.dispatch_line"><code class="xref py py-meth docutils literal notranslate"><span class="pre">dispatch_line()</span></code></a> when either <a class="reference internal" href="#bdb.Bdb.stop_here" title="bdb.Bdb.stop_here"><code class="xref py py-meth docutils literal notranslate"><span class="pre">stop_here()</span></code></a> or

  460. <a class="reference internal" href="#bdb.Bdb.break_here" title="bdb.Bdb.break_here"><code class="xref py py-meth docutils literal notranslate"><span class="pre">break_here()</span></code></a> returns <code class="docutils literal notranslate"><span class="pre">True</span></code>.</p>

  461. </dd></dl>

  462. 

  463. <dl class="py method">

  464. <dt class="sig sig-object py" id="bdb.Bdb.user_return">

  465. <span class="sig-name descname"><span class="pre">user_return</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">frame</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">return_value</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.user_return" title="Link to this definition">¶</a></dt>

  466. <dd><p>Called from <a class="reference internal" href="#bdb.Bdb.dispatch_return" title="bdb.Bdb.dispatch_return"><code class="xref py py-meth docutils literal notranslate"><span class="pre">dispatch_return()</span></code></a> when <a class="reference internal" href="#bdb.Bdb.stop_here" title="bdb.Bdb.stop_here"><code class="xref py py-meth docutils literal notranslate"><span class="pre">stop_here()</span></code></a> returns <code class="docutils literal notranslate"><span class="pre">True</span></code>.</p>

  467. </dd></dl>

  468. 

  469. <dl class="py method">

  470. <dt class="sig sig-object py" id="bdb.Bdb.user_exception">

  471. <span class="sig-name descname"><span class="pre">user_exception</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">frame</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">exc_info</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.user_exception" title="Link to this definition">¶</a></dt>

  472. <dd><p>Called from <a class="reference internal" href="#bdb.Bdb.dispatch_exception" title="bdb.Bdb.dispatch_exception"><code class="xref py py-meth docutils literal notranslate"><span class="pre">dispatch_exception()</span></code></a> when <a class="reference internal" href="#bdb.Bdb.stop_here" title="bdb.Bdb.stop_here"><code class="xref py py-meth docutils literal notranslate"><span class="pre">stop_here()</span></code></a>

  473. returns <code class="docutils literal notranslate"><span class="pre">True</span></code>.</p>

  474. </dd></dl>

  475. 

  476. <dl class="py method">

  477. <dt class="sig sig-object py" id="bdb.Bdb.do_clear">

  478. <span class="sig-name descname"><span class="pre">do_clear</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.do_clear" title="Link to this definition">¶</a></dt>

  479. <dd><p>Handle how a breakpoint must be removed when it is a temporary one.</p>

  480. <p>This method must be implemented by derived classes.</p>

  481. </dd></dl>

  482. 

  483. <p>Derived classes and clients can call the following methods to affect the

  484. stepping state.</p>

  485. <dl class="py method">

  486. <dt class="sig sig-object py" id="bdb.Bdb.set_step">

  487. <span class="sig-name descname"><span class="pre">set_step</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.set_step" title="Link to this definition">¶</a></dt>

  488. <dd><p>Stop after one line of code.</p>

  489. </dd></dl>

  490. 

  491. <dl class="py method">

  492. <dt class="sig sig-object py" id="bdb.Bdb.set_next">

  493. <span class="sig-name descname"><span class="pre">set_next</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">frame</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.set_next" title="Link to this definition">¶</a></dt>

  494. <dd><p>Stop on the next line in or below the given frame.</p>

  495. </dd></dl>

  496. 

  497. <dl class="py method">

  498. <dt class="sig sig-object py" id="bdb.Bdb.set_return">

  499. <span class="sig-name descname"><span class="pre">set_return</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">frame</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.set_return" title="Link to this definition">¶</a></dt>

  500. <dd><p>Stop when returning from the given frame.</p>

  501. </dd></dl>

  502. 

  503. <dl class="py method">

  504. <dt class="sig sig-object py" id="bdb.Bdb.set_until">

  505. <span class="sig-name descname"><span class="pre">set_until</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">frame</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">lineno</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.set_until" title="Link to this definition">¶</a></dt>

  506. <dd><p>Stop when the line with the <em>lineno</em> greater than the current one is

  507. reached or when returning from current frame.</p>

  508. </dd></dl>

  509. 

  510. <dl class="py method">

  511. <dt class="sig sig-object py" id="bdb.Bdb.set_trace">

  512. <span class="sig-name descname"><span class="pre">set_trace</span></span><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param"><span class="n"><span class="pre">frame</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.set_trace" title="Link to this definition">¶</a></dt>

  513. <dd><p>Start debugging from <em>frame</em>.  If <em>frame</em> is not specified, debugging

  514. starts from caller’s frame.</p>

  515. </dd></dl>

  516. 

  517. <dl class="py method">

  518. <dt class="sig sig-object py" id="bdb.Bdb.set_continue">

  519. <span class="sig-name descname"><span class="pre">set_continue</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.set_continue" title="Link to this definition">¶</a></dt>

  520. <dd><p>Stop only at breakpoints or when finished.  If there are no breakpoints,

  521. set the system trace function to <code class="docutils literal notranslate"><span class="pre">None</span></code>.</p>

  522. </dd></dl>

  523. 

  524. <dl class="py method">

  525. <dt class="sig sig-object py" id="bdb.Bdb.set_quit">

  526. <span class="sig-name descname"><span class="pre">set_quit</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.set_quit" title="Link to this definition">¶</a></dt>

  527. <dd><p id="index-0">Set the <code class="xref py py-attr docutils literal notranslate"><span class="pre">quitting</span></code> attribute to <code class="docutils literal notranslate"><span class="pre">True</span></code>.  This raises <a class="reference internal" href="#bdb.BdbQuit" title="bdb.BdbQuit"><code class="xref py py-exc docutils literal notranslate"><span class="pre">BdbQuit</span></code></a> in

  528. the next call to one of the <code class="xref py py-meth docutils literal notranslate"><span class="pre">dispatch_*()</span></code> methods.</p>

  529. </dd></dl>

  530. 

  531. <p>Derived classes and clients can call the following methods to manipulate

  532. breakpoints.  These methods return a string containing an error message if

  533. something went wrong, or <code class="docutils literal notranslate"><span class="pre">None</span></code> if all is well.</p>

  534. <dl class="py method">

  535. <dt class="sig sig-object py" id="bdb.Bdb.set_break">

  536. <span class="sig-name descname"><span class="pre">set_break</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">filename</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">lineno</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">temporary</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">cond</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">funcname</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.set_break" title="Link to this definition">¶</a></dt>

  537. <dd><p>Set a new breakpoint.  If the <em>lineno</em> line doesn’t exist for the

  538. <em>filename</em> passed as argument, return an error message.  The <em>filename</em>

  539. should be in canonical form, as described in the <a class="reference internal" href="#bdb.Bdb.canonic" title="bdb.Bdb.canonic"><code class="xref py py-meth docutils literal notranslate"><span class="pre">canonic()</span></code></a> method.</p>

  540. </dd></dl>

  541. 

  542. <dl class="py method">

  543. <dt class="sig sig-object py" id="bdb.Bdb.clear_break">

  544. <span class="sig-name descname"><span class="pre">clear_break</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">filename</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">lineno</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.clear_break" title="Link to this definition">¶</a></dt>

  545. <dd><p>Delete the breakpoints in <em>filename</em> and <em>lineno</em>.  If none were set,

  546. return an error message.</p>

  547. </dd></dl>

  548. 

  549. <dl class="py method">

  550. <dt class="sig sig-object py" id="bdb.Bdb.clear_bpbynumber">

  551. <span class="sig-name descname"><span class="pre">clear_bpbynumber</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.clear_bpbynumber" title="Link to this definition">¶</a></dt>

  552. <dd><p>Delete the breakpoint which has the index <em>arg</em> in the

  553. <a class="reference internal" href="#bdb.Breakpoint.bpbynumber" title="bdb.Breakpoint.bpbynumber"><code class="xref py py-attr docutils literal notranslate"><span class="pre">Breakpoint.bpbynumber</span></code></a>.  If <em>arg</em> is not numeric or out of range,

  554. return an error message.</p>

  555. </dd></dl>

  556. 

  557. <dl class="py method">

  558. <dt class="sig sig-object py" id="bdb.Bdb.clear_all_file_breaks">

  559. <span class="sig-name descname"><span class="pre">clear_all_file_breaks</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">filename</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.clear_all_file_breaks" title="Link to this definition">¶</a></dt>

  560. <dd><p>Delete all breakpoints in <em>filename</em>.  If none were set, return an error

  561. message.</p>

  562. </dd></dl>

  563. 

  564. <dl class="py method">

  565. <dt class="sig sig-object py" id="bdb.Bdb.clear_all_breaks">

  566. <span class="sig-name descname"><span class="pre">clear_all_breaks</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.clear_all_breaks" title="Link to this definition">¶</a></dt>

  567. <dd><p>Delete all existing breakpoints.  If none were set, return an error

  568. message.</p>

  569. </dd></dl>

  570. 

  571. <dl class="py method">

  572. <dt class="sig sig-object py" id="bdb.Bdb.get_bpbynumber">

  573. <span class="sig-name descname"><span class="pre">get_bpbynumber</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.get_bpbynumber" title="Link to this definition">¶</a></dt>

  574. <dd><p>Return a breakpoint specified by the given number.  If <em>arg</em> is a string,

  575. it will be converted to a number.  If <em>arg</em> is a non-numeric string, if

  576. the given breakpoint never existed or has been deleted, a

  577. <a class="reference internal" href="exceptions.html#ValueError" title="ValueError"><code class="xref py py-exc docutils literal notranslate"><span class="pre">ValueError</span></code></a> is raised.</p>

  578. <div class="versionadded">

  579. <p><span class="versionmodified added">New in version 3.2.</span></p>

  580. </div>

  581. </dd></dl>

  582. 

  583. <dl class="py method">

  584. <dt class="sig sig-object py" id="bdb.Bdb.get_break">

  585. <span class="sig-name descname"><span class="pre">get_break</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">filename</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">lineno</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.get_break" title="Link to this definition">¶</a></dt>

  586. <dd><p>Return True if there is a breakpoint for <em>lineno</em> in <em>filename</em>.</p>

  587. </dd></dl>

  588. 

  589. <dl class="py method">

  590. <dt class="sig sig-object py" id="bdb.Bdb.get_breaks">

  591. <span class="sig-name descname"><span class="pre">get_breaks</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">filename</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">lineno</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.get_breaks" title="Link to this definition">¶</a></dt>

  592. <dd><p>Return all breakpoints for <em>lineno</em> in <em>filename</em>, or an empty list if

  593. none are set.</p>

  594. </dd></dl>

  595. 

  596. <dl class="py method">

  597. <dt class="sig sig-object py" id="bdb.Bdb.get_file_breaks">

  598. <span class="sig-name descname"><span class="pre">get_file_breaks</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">filename</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.get_file_breaks" title="Link to this definition">¶</a></dt>

  599. <dd><p>Return all breakpoints in <em>filename</em>, or an empty list if none are set.</p>

  600. </dd></dl>

  601. 

  602. <dl class="py method">

  603. <dt class="sig sig-object py" id="bdb.Bdb.get_all_breaks">

  604. <span class="sig-name descname"><span class="pre">get_all_breaks</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.get_all_breaks" title="Link to this definition">¶</a></dt>

  605. <dd><p>Return all breakpoints that are set.</p>

  606. </dd></dl>

  607. 

  608. <p>Derived classes and clients can call the following methods to get a data

  609. structure representing a stack trace.</p>

  610. <dl class="py method">

  611. <dt class="sig sig-object py" id="bdb.Bdb.get_stack">

  612. <span class="sig-name descname"><span class="pre">get_stack</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">f</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">t</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.get_stack" title="Link to this definition">¶</a></dt>

  613. <dd><p>Return a list of (frame, lineno) tuples in a stack trace, and a size.</p>

  614. <p>The most recently called frame is last in the list. The size is the number

  615. of frames below the frame where the debugger was invoked.</p>

  616. </dd></dl>

  617. 

  618. <dl class="py method">

  619. <dt class="sig sig-object py" id="bdb.Bdb.format_stack_entry">

  620. <span class="sig-name descname"><span class="pre">format_stack_entry</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">frame_lineno</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">lprefix</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">':</span> <span class="pre">'</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.format_stack_entry" title="Link to this definition">¶</a></dt>

  621. <dd><p>Return a string with information about a stack entry, which is a

  622. <code class="docutils literal notranslate"><span class="pre">(frame,</span> <span class="pre">lineno)</span></code> tuple.  The return string contains:</p>

  623. <ul class="simple">

  624. <li><p>The canonical filename which contains the frame.</p></li>

  625. <li><p>The function name or <code class="docutils literal notranslate"><span class="pre">&quot;&lt;lambda&gt;&quot;</span></code>.</p></li>

  626. <li><p>The input arguments.</p></li>

  627. <li><p>The return value.</p></li>

  628. <li><p>The line of code (if it exists).</p></li>

  629. </ul>

  630. </dd></dl>

  631. 

  632. <p>The following two methods can be called by clients to use a debugger to debug

  633. a <a class="reference internal" href="../glossary.html#term-statement"><span class="xref std std-term">statement</span></a>, given as a string.</p>

  634. <dl class="py method">

  635. <dt class="sig sig-object py" id="bdb.Bdb.run">

  636. <span class="sig-name descname"><span class="pre">run</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">cmd</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">globals</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">locals</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.run" title="Link to this definition">¶</a></dt>

  637. <dd><p>Debug a statement executed via 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.  <em>globals</em>

  638. defaults to <code class="xref py py-attr docutils literal notranslate"><span class="pre">__main__.__dict__</span></code>, <em>locals</em> defaults to <em>globals</em>.</p>

  639. </dd></dl>

  640. 

  641. <dl class="py method">

  642. <dt class="sig sig-object py" id="bdb.Bdb.runeval">

  643. <span class="sig-name descname"><span class="pre">runeval</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">expr</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">globals</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">locals</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.runeval" title="Link to this definition">¶</a></dt>

  644. <dd><p>Debug an expression executed via the <a class="reference internal" href="functions.html#eval" title="eval"><code class="xref py py-func docutils literal notranslate"><span class="pre">eval()</span></code></a> function.  <em>globals</em> and

  645. <em>locals</em> have the same meaning as in <a class="reference internal" href="#bdb.Bdb.run" title="bdb.Bdb.run"><code class="xref py py-meth docutils literal notranslate"><span class="pre">run()</span></code></a>.</p>

  646. </dd></dl>

  647. 

  648. <dl class="py method">

  649. <dt class="sig sig-object py" id="bdb.Bdb.runctx">

  650. <span class="sig-name descname"><span class="pre">runctx</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">cmd</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">globals</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">locals</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.runctx" title="Link to this definition">¶</a></dt>

  651. <dd><p>For backwards compatibility.  Calls the <a class="reference internal" href="#bdb.Bdb.run" title="bdb.Bdb.run"><code class="xref py py-meth docutils literal notranslate"><span class="pre">run()</span></code></a> method.</p>

  652. </dd></dl>

  653. 

  654. <dl class="py method">

  655. <dt class="sig sig-object py" id="bdb.Bdb.runcall">

  656. <span class="sig-name descname"><span class="pre">runcall</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">/</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwds</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.Bdb.runcall" title="Link to this definition">¶</a></dt>

  657. <dd><p>Debug a single function call, and return its result.</p>

  658. </dd></dl>

  659. 

  660. </dd></dl>

  661. 

  662. <p>Finally, the module defines the following functions:</p>

  663. <dl class="py function">

  664. <dt class="sig sig-object py" id="bdb.checkfuncname">

  665. <span class="sig-prename descclassname"><span class="pre">bdb.</span></span><span class="sig-name descname"><span class="pre">checkfuncname</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">b</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">frame</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.checkfuncname" title="Link to this definition">¶</a></dt>

  666. <dd><p>Return True if we should break here, depending on the way the

  667. <a class="reference internal" href="#bdb.Breakpoint" title="bdb.Breakpoint"><code class="xref py py-class docutils literal notranslate"><span class="pre">Breakpoint</span></code></a> <em>b</em> was set.</p>

  668. <p>If it was set via line number, it checks if

  669. <a class="reference internal" href="#bdb.Breakpoint.line" title="bdb.Breakpoint.line"><code class="xref py py-attr docutils literal notranslate"><span class="pre">b.line</span></code></a> is the same as the one in <em>frame</em>.

  670. If the breakpoint was set via

  671. <a class="reference internal" href="#bdb.Breakpoint.funcname" title="bdb.Breakpoint.funcname"><code class="xref py py-attr docutils literal notranslate"><span class="pre">function</span> <span class="pre">name</span></code></a>, we have to check we are in

  672. the right <em>frame</em> (the right function) and if we are on its first executable

  673. line.</p>

  674. </dd></dl>

  675. 

  676. <dl class="py function">

  677. <dt class="sig sig-object py" id="bdb.effective">

  678. <span class="sig-prename descclassname"><span class="pre">bdb.</span></span><span class="sig-name descname"><span class="pre">effective</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">file</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">line</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">frame</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#bdb.effective" title="Link to this definition">¶</a></dt>

  679. <dd><p>Return <code class="docutils literal notranslate"><span class="pre">(active</span> <span class="pre">breakpoint,</span> <span class="pre">delete</span> <span class="pre">temporary</span> <span class="pre">flag)</span></code> or <code class="docutils literal notranslate"><span class="pre">(None,</span> <span class="pre">None)</span></code> as the

  680. breakpoint to act upon.</p>

  681. <p>The <em>active breakpoint</em> is the first entry in

  682. <a class="reference internal" href="#bdb.Breakpoint.bplist" title="bdb.Breakpoint.bplist"><code class="xref py py-attr docutils literal notranslate"><span class="pre">bplist</span></code></a> for the

  683. (<a class="reference internal" href="#bdb.Breakpoint.file" title="bdb.Breakpoint.file"><code class="xref py py-attr docutils literal notranslate"><span class="pre">file</span></code></a>, <a class="reference internal" href="#bdb.Breakpoint.line" title="bdb.Breakpoint.line"><code class="xref py py-attr docutils literal notranslate"><span class="pre">line</span></code></a>)

  684. (which must exist) that is <a class="reference internal" href="#bdb.Breakpoint.enabled" title="bdb.Breakpoint.enabled"><code class="xref py py-attr docutils literal notranslate"><span class="pre">enabled</span></code></a>, for

  685. which <a class="reference internal" href="#bdb.checkfuncname" title="bdb.checkfuncname"><code class="xref py py-func docutils literal notranslate"><span class="pre">checkfuncname()</span></code></a> is True, and that has neither a False

  686. <a class="reference internal" href="#bdb.Breakpoint.cond" title="bdb.Breakpoint.cond"><code class="xref py py-attr docutils literal notranslate"><span class="pre">condition</span></code></a> nor positive

  687. <a class="reference internal" href="#bdb.Breakpoint.ignore" title="bdb.Breakpoint.ignore"><code class="xref py py-attr docutils literal notranslate"><span class="pre">ignore</span></code></a> count.  The <em>flag</em>, meaning that a

  688. temporary breakpoint should be deleted, is False only when the

  689. <a class="reference internal" href="#bdb.Breakpoint.cond" title="bdb.Breakpoint.cond"><code class="xref py py-attr docutils literal notranslate"><span class="pre">cond</span></code></a> cannot be evaluated (in which case,

  690. <a class="reference internal" href="#bdb.Breakpoint.ignore" title="bdb.Breakpoint.ignore"><code class="xref py py-attr docutils literal notranslate"><span class="pre">ignore</span></code></a> count is ignored).</p>

  691. <p>If no such entry exists, then (None, None) is returned.</p>

  692. </dd></dl>

  693. 

  694. <dl class="py function">

  695. <dt class="sig sig-object py" id="bdb.set_trace">

  696. <span class="sig-prename descclassname"><span class="pre">bdb.</span></span><span class="sig-name descname"><span class="pre">set_trace</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#bdb.set_trace" title="Link to this definition">¶</a></dt>

  697. <dd><p>Start debugging with a <a class="reference internal" href="#bdb.Bdb" title="bdb.Bdb"><code class="xref py py-class docutils literal notranslate"><span class="pre">Bdb</span></code></a> instance from caller’s frame.</p>

  698. </dd></dl>

  699. 

  700. </section>

  701. 

  702. 

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

  704.           </div>

  705.         </div>

  706.       </div>

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

  708.         <div class="sphinxsidebarwrapper">

  709.   <div>

  710.     <h4>Previous topic</h4>

  711.     <p class="topless"><a href="audit_events.html"

  712.                           title="previous chapter">Audit events table</a></p>

  713.   </div>

  714.   <div>

  715.     <h4>Next topic</h4>

  716.     <p class="topless"><a href="faulthandler.html"

  717.                           title="next chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">faulthandler</span></code> — Dump the Python traceback</a></p>

  718.   </div>

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

  720.     <h3>This Page</h3>

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

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

  723.       <li>

  724.         <a href="https://github.com/python/cpython/blob/main/Doc/library/bdb.rst"

  725.             rel="nofollow">Show Source

  726.         </a>

  727.       </li>

  728.     </ul>

  729.   </div>

  730.         </div>

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

  732. <span>«</span>

  733. </div>

  734. 

  735.       </div>

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

  737.     </div>  

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

  739.       <h3>Navigation</h3>

  740.       <ul>

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

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

  743.              >index</a></li>

  744.         <li class="right" >

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

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

  747.         <li class="right" >

  748.           <a href="faulthandler.html" title="faulthandler — Dump the Python traceback"

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

  750.         <li class="right" >

  751.           <a href="audit_events.html" title="Audit events table"

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

  753. 

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

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

  756.           <li class="switchers">

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

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

  759.           </li>

  760.           <li>

  761.               

  762.           </li>

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

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

  765.     </li>

  766. 

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

  768.           <li class="nav-item nav-item-2"><a href="debug.html" >Debugging and Profiling</a> &#187;</li>

  769.         <li class="nav-item nav-item-this"><a href=""><code class="xref py py-mod docutils literal notranslate"><span class="pre">bdb</span></code> — Debugger framework</a></li>

  770.                 <li class="right">

  771.                     

  772. 

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

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

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

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

  777.         </form>

  778.     </div>

  779.                      |

  780.                 </li>

  781.             <li class="right">

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

  783.     Theme

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

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

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

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

  788.     </select>

  789. </label> |</li>

  790.             

  791.       </ul>

  792.     </div>  

  793.     <div class="footer">

  794.     &copy; 

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

  796.     

  797.     Copyright

  798.     

  799.       </a>

  800.      2001-2024, Python Software Foundation.

  801.     <br />

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

  803.     <br />

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

  805.     <br />

  806.     

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

  808.     

  809.     

  810.     <br />

  811. 

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

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

  814. <br />

  815.     <br />

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

  817.     

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

  819.     

  820.     <br />

  821. 

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

  823.     </div>

  824. 

  825.   </body>

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