new repository

1 files changed, 34 insertions, 0 deletions

diff --git a/devdocs/python~3.12/tutorial%2Findex.html b/devdocs/python~3.12/tutorial%2Findex.html
new file mode 100644
index 00000000..f9960825
--- /dev/null
+++ b/devdocs/python~3.12/tutorial%2Findex.html
@@ -0,0 +1,34 @@
+ <span id="tutorial-index"></span><h1>The Python Tutorial</h1> <p>Python is an easy to learn, powerful programming language. It has efficient high-level data structures and a simple but effective approach to object-oriented programming. Python’s elegant syntax and dynamic typing, together with its interpreted nature, make it an ideal language for scripting and rapid application development in many areas on most platforms.</p> <p>The Python interpreter and the extensive standard library are freely available in source or binary form for all major platforms from the Python web site, <a class="reference external" href="https://www.python.org/">https://www.python.org/</a>, and may be freely distributed. The same site also contains distributions of and pointers to many free third party Python modules, programs and tools, and additional documentation.</p> <p>The Python interpreter is easily extended with new functions and data types implemented in C or C++ (or other languages callable from C). Python is also suitable as an extension language for customizable applications.</p> <p>This tutorial introduces the reader informally to the basic concepts and features of the Python language and system. It helps to have a Python interpreter handy for hands-on experience, but all examples are self-contained, so the tutorial can be read off-line as well.</p> <p>For a description of standard objects and modules, see <a class="reference internal" href="../library/index#library-index"><span class="std std-ref">The Python Standard Library</span></a>. <a class="reference internal" href="../reference/index#reference-index"><span class="std std-ref">The Python Language Reference</span></a> gives a more formal definition of the language. To write extensions in C or C++, read <a class="reference internal" href="../extending/index#extending-index"><span class="std std-ref">Extending and Embedding the Python Interpreter</span></a> and <a class="reference internal" href="../c-api/index#c-api-index"><span class="std std-ref">Python/C API Reference Manual</span></a>. There are also several books covering Python in depth.</p> <p>This tutorial does not attempt to be comprehensive and cover every single feature, or even every commonly used feature. Instead, it introduces many of Python’s most noteworthy features, and will give you a good idea of the language’s flavor and style. After reading it, you will be able to read and write Python modules and programs, and you will be ready to learn more about the various Python library modules described in <a class="reference internal" href="../library/index#library-index"><span class="std std-ref">The Python Standard Library</span></a>.</p> <p>The <a class="reference internal" href="../glossary#glossary"><span class="std std-ref">Glossary</span></a> is also worth going through.</p>  <ul> <li class="toctree-l1"><a class="reference internal" href="appetite">1. Whetting Your Appetite</a></li> <li class="toctree-l1">
+<a class="reference internal" href="interpreter">2. Using the Python Interpreter</a><ul> <li class="toctree-l2">
+<a class="reference internal" href="interpreter#invoking-the-interpreter">2.1. Invoking the Interpreter</a><ul> <li class="toctree-l3"><a class="reference internal" href="interpreter#argument-passing">2.1.1. Argument Passing</a></li> <li class="toctree-l3"><a class="reference internal" href="interpreter#interactive-mode">2.1.2. Interactive Mode</a></li> </ul> </li> <li class="toctree-l2">
+<a class="reference internal" href="interpreter#the-interpreter-and-its-environment">2.2. The Interpreter and Its Environment</a><ul> <li class="toctree-l3"><a class="reference internal" href="interpreter#source-code-encoding">2.2.1. Source Code Encoding</a></li> </ul> </li> </ul> </li> <li class="toctree-l1">
+<a class="reference internal" href="introduction">3. An Informal Introduction to Python</a><ul> <li class="toctree-l2">
+<a class="reference internal" href="introduction#using-python-as-a-calculator">3.1. Using Python as a Calculator</a><ul> <li class="toctree-l3"><a class="reference internal" href="introduction#numbers">3.1.1. Numbers</a></li> <li class="toctree-l3"><a class="reference internal" href="introduction#text">3.1.2. Text</a></li> <li class="toctree-l3"><a class="reference internal" href="introduction#lists">3.1.3. Lists</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="introduction#first-steps-towards-programming">3.2. First Steps Towards Programming</a></li> </ul> </li> <li class="toctree-l1">
+<a class="reference internal" href="controlflow">4. More Control Flow Tools</a><ul> <li class="toctree-l2"><a class="reference internal" href="controlflow#if-statements">4.1. <code>if</code> Statements</a></li> <li class="toctree-l2"><a class="reference internal" href="controlflow#for-statements">4.2. <code>for</code> Statements</a></li> <li class="toctree-l2"><a class="reference internal" href="controlflow#the-range-function">4.3. The <code>range()</code> Function</a></li> <li class="toctree-l2"><a class="reference internal" href="controlflow#break-and-continue-statements-and-else-clauses-on-loops">4.4. <code>break</code> and <code>continue</code> Statements, and <code>else</code> Clauses on Loops</a></li> <li class="toctree-l2"><a class="reference internal" href="controlflow#pass-statements">4.5. <code>pass</code> Statements</a></li> <li class="toctree-l2"><a class="reference internal" href="controlflow#match-statements">4.6. <code>match</code> Statements</a></li> <li class="toctree-l2"><a class="reference internal" href="controlflow#defining-functions">4.7. Defining Functions</a></li> <li class="toctree-l2">
+<a class="reference internal" href="controlflow#more-on-defining-functions">4.8. More on Defining Functions</a><ul> <li class="toctree-l3"><a class="reference internal" href="controlflow#default-argument-values">4.8.1. Default Argument Values</a></li> <li class="toctree-l3"><a class="reference internal" href="controlflow#keyword-arguments">4.8.2. Keyword Arguments</a></li> <li class="toctree-l3">
+<a class="reference internal" href="controlflow#special-parameters">4.8.3. Special parameters</a><ul> <li class="toctree-l4"><a class="reference internal" href="controlflow#positional-or-keyword-arguments">4.8.3.1. Positional-or-Keyword Arguments</a></li> <li class="toctree-l4"><a class="reference internal" href="controlflow#positional-only-parameters">4.8.3.2. Positional-Only Parameters</a></li> <li class="toctree-l4"><a class="reference internal" href="controlflow#keyword-only-arguments">4.8.3.3. Keyword-Only Arguments</a></li> <li class="toctree-l4"><a class="reference internal" href="controlflow#function-examples">4.8.3.4. Function Examples</a></li> <li class="toctree-l4"><a class="reference internal" href="controlflow#recap">4.8.3.5. Recap</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="controlflow#arbitrary-argument-lists">4.8.4. Arbitrary Argument Lists</a></li> <li class="toctree-l3"><a class="reference internal" href="controlflow#unpacking-argument-lists">4.8.5. Unpacking Argument Lists</a></li> <li class="toctree-l3"><a class="reference internal" href="controlflow#lambda-expressions">4.8.6. Lambda Expressions</a></li> <li class="toctree-l3"><a class="reference internal" href="controlflow#documentation-strings">4.8.7. Documentation Strings</a></li> <li class="toctree-l3"><a class="reference internal" href="controlflow#function-annotations">4.8.8. Function Annotations</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="controlflow#intermezzo-coding-style">4.9. Intermezzo: Coding Style</a></li> </ul> </li> <li class="toctree-l1">
+<a class="reference internal" href="datastructures">5. Data Structures</a><ul> <li class="toctree-l2">
+<a class="reference internal" href="datastructures#more-on-lists">5.1. More on Lists</a><ul> <li class="toctree-l3"><a class="reference internal" href="datastructures#using-lists-as-stacks">5.1.1. Using Lists as Stacks</a></li> <li class="toctree-l3"><a class="reference internal" href="datastructures#using-lists-as-queues">5.1.2. Using Lists as Queues</a></li> <li class="toctree-l3"><a class="reference internal" href="datastructures#list-comprehensions">5.1.3. List Comprehensions</a></li> <li class="toctree-l3"><a class="reference internal" href="datastructures#nested-list-comprehensions">5.1.4. Nested List Comprehensions</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="datastructures#the-del-statement">5.2. The <code>del</code> statement</a></li> <li class="toctree-l2"><a class="reference internal" href="datastructures#tuples-and-sequences">5.3. Tuples and Sequences</a></li> <li class="toctree-l2"><a class="reference internal" href="datastructures#sets">5.4. Sets</a></li> <li class="toctree-l2"><a class="reference internal" href="datastructures#dictionaries">5.5. Dictionaries</a></li> <li class="toctree-l2"><a class="reference internal" href="datastructures#looping-techniques">5.6. Looping Techniques</a></li> <li class="toctree-l2"><a class="reference internal" href="datastructures#more-on-conditions">5.7. More on Conditions</a></li> <li class="toctree-l2"><a class="reference internal" href="datastructures#comparing-sequences-and-other-types">5.8. Comparing Sequences and Other Types</a></li> </ul> </li> <li class="toctree-l1">
+<a class="reference internal" href="modules">6. Modules</a><ul> <li class="toctree-l2">
+<a class="reference internal" href="modules#more-on-modules">6.1. More on Modules</a><ul> <li class="toctree-l3"><a class="reference internal" href="modules#executing-modules-as-scripts">6.1.1. Executing modules as scripts</a></li> <li class="toctree-l3"><a class="reference internal" href="modules#the-module-search-path">6.1.2. The Module Search Path</a></li> <li class="toctree-l3"><a class="reference internal" href="modules#compiled-python-files">6.1.3. “Compiled” Python files</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="modules#standard-modules">6.2. Standard Modules</a></li> <li class="toctree-l2"><a class="reference internal" href="modules#the-dir-function">6.3. The <code>dir()</code> Function</a></li> <li class="toctree-l2">
+<a class="reference internal" href="modules#packages">6.4. Packages</a><ul> <li class="toctree-l3"><a class="reference internal" href="modules#importing-from-a-package">6.4.1. Importing * From a Package</a></li> <li class="toctree-l3"><a class="reference internal" href="modules#intra-package-references">6.4.2. Intra-package References</a></li> <li class="toctree-l3"><a class="reference internal" href="modules#packages-in-multiple-directories">6.4.3. Packages in Multiple Directories</a></li> </ul> </li> </ul> </li> <li class="toctree-l1">
+<a class="reference internal" href="inputoutput">7. Input and Output</a><ul> <li class="toctree-l2">
+<a class="reference internal" href="inputoutput#fancier-output-formatting">7.1. Fancier Output Formatting</a><ul> <li class="toctree-l3"><a class="reference internal" href="inputoutput#formatted-string-literals">7.1.1. Formatted String Literals</a></li> <li class="toctree-l3"><a class="reference internal" href="inputoutput#the-string-format-method">7.1.2. The String format() Method</a></li> <li class="toctree-l3"><a class="reference internal" href="inputoutput#manual-string-formatting">7.1.3. Manual String Formatting</a></li> <li class="toctree-l3"><a class="reference internal" href="inputoutput#old-string-formatting">7.1.4. Old string formatting</a></li> </ul> </li> <li class="toctree-l2">
+<a class="reference internal" href="inputoutput#reading-and-writing-files">7.2. Reading and Writing Files</a><ul> <li class="toctree-l3"><a class="reference internal" href="inputoutput#methods-of-file-objects">7.2.1. Methods of File Objects</a></li> <li class="toctree-l3"><a class="reference internal" href="inputoutput#saving-structured-data-with-json">7.2.2. Saving structured data with <code>json</code></a></li> </ul> </li> </ul> </li> <li class="toctree-l1">
+<a class="reference internal" href="errors">8. Errors and Exceptions</a><ul> <li class="toctree-l2"><a class="reference internal" href="errors#syntax-errors">8.1. Syntax Errors</a></li> <li class="toctree-l2"><a class="reference internal" href="errors#exceptions">8.2. Exceptions</a></li> <li class="toctree-l2"><a class="reference internal" href="errors#handling-exceptions">8.3. Handling Exceptions</a></li> <li class="toctree-l2"><a class="reference internal" href="errors#raising-exceptions">8.4. Raising Exceptions</a></li> <li class="toctree-l2"><a class="reference internal" href="errors#exception-chaining">8.5. Exception Chaining</a></li> <li class="toctree-l2"><a class="reference internal" href="errors#user-defined-exceptions">8.6. User-defined Exceptions</a></li> <li class="toctree-l2"><a class="reference internal" href="errors#defining-clean-up-actions">8.7. Defining Clean-up Actions</a></li> <li class="toctree-l2"><a class="reference internal" href="errors#predefined-clean-up-actions">8.8. Predefined Clean-up Actions</a></li> <li class="toctree-l2"><a class="reference internal" href="errors#raising-and-handling-multiple-unrelated-exceptions">8.9. Raising and Handling Multiple Unrelated Exceptions</a></li> <li class="toctree-l2"><a class="reference internal" href="errors#enriching-exceptions-with-notes">8.10. Enriching Exceptions with Notes</a></li> </ul> </li> <li class="toctree-l1">
+<a class="reference internal" href="classes">9. Classes</a><ul> <li class="toctree-l2"><a class="reference internal" href="classes#a-word-about-names-and-objects">9.1. A Word About Names and Objects</a></li> <li class="toctree-l2">
+<a class="reference internal" href="classes#python-scopes-and-namespaces">9.2. Python Scopes and Namespaces</a><ul> <li class="toctree-l3"><a class="reference internal" href="classes#scopes-and-namespaces-example">9.2.1. Scopes and Namespaces Example</a></li> </ul> </li> <li class="toctree-l2">
+<a class="reference internal" href="classes#a-first-look-at-classes">9.3. A First Look at Classes</a><ul> <li class="toctree-l3"><a class="reference internal" href="classes#class-definition-syntax">9.3.1. Class Definition Syntax</a></li> <li class="toctree-l3"><a class="reference internal" href="classes#class-objects">9.3.2. Class Objects</a></li> <li class="toctree-l3"><a class="reference internal" href="classes#instance-objects">9.3.3. Instance Objects</a></li> <li class="toctree-l3"><a class="reference internal" href="classes#method-objects">9.3.4. Method Objects</a></li> <li class="toctree-l3"><a class="reference internal" href="classes#class-and-instance-variables">9.3.5. Class and Instance Variables</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="classes#random-remarks">9.4. Random Remarks</a></li> <li class="toctree-l2">
+<a class="reference internal" href="classes#inheritance">9.5. Inheritance</a><ul> <li class="toctree-l3"><a class="reference internal" href="classes#multiple-inheritance">9.5.1. Multiple Inheritance</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="classes#private-variables">9.6. Private Variables</a></li> <li class="toctree-l2"><a class="reference internal" href="classes#odds-and-ends">9.7. Odds and Ends</a></li> <li class="toctree-l2"><a class="reference internal" href="classes#iterators">9.8. Iterators</a></li> <li class="toctree-l2"><a class="reference internal" href="classes#generators">9.9. Generators</a></li> <li class="toctree-l2"><a class="reference internal" href="classes#generator-expressions">9.10. Generator Expressions</a></li> </ul> </li> <li class="toctree-l1">
+<a class="reference internal" href="stdlib">10. Brief Tour of the Standard Library</a><ul> <li class="toctree-l2"><a class="reference internal" href="stdlib#operating-system-interface">10.1. Operating System Interface</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib#file-wildcards">10.2. File Wildcards</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib#command-line-arguments">10.3. Command Line Arguments</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib#error-output-redirection-and-program-termination">10.4. Error Output Redirection and Program Termination</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib#string-pattern-matching">10.5. String Pattern Matching</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib#mathematics">10.6. Mathematics</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib#internet-access">10.7. Internet Access</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib#dates-and-times">10.8. Dates and Times</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib#data-compression">10.9. Data Compression</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib#performance-measurement">10.10. Performance Measurement</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib#quality-control">10.11. Quality Control</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib#batteries-included">10.12. Batteries Included</a></li> </ul> </li> <li class="toctree-l1">
+<a class="reference internal" href="stdlib2">11. Brief Tour of the Standard Library — Part II</a><ul> <li class="toctree-l2"><a class="reference internal" href="stdlib2#output-formatting">11.1. Output Formatting</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib2#templating">11.2. Templating</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib2#working-with-binary-data-record-layouts">11.3. Working with Binary Data Record Layouts</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib2#multi-threading">11.4. Multi-threading</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib2#logging">11.5. Logging</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib2#weak-references">11.6. Weak References</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib2#tools-for-working-with-lists">11.7. Tools for Working with Lists</a></li> <li class="toctree-l2"><a class="reference internal" href="stdlib2#decimal-floating-point-arithmetic">11.8. Decimal Floating Point Arithmetic</a></li> </ul> </li> <li class="toctree-l1">
+<a class="reference internal" href="venv">12. Virtual Environments and Packages</a><ul> <li class="toctree-l2"><a class="reference internal" href="venv#introduction">12.1. Introduction</a></li> <li class="toctree-l2"><a class="reference internal" href="venv#creating-virtual-environments">12.2. Creating Virtual Environments</a></li> <li class="toctree-l2"><a class="reference internal" href="venv#managing-packages-with-pip">12.3. Managing Packages with pip</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="whatnow">13. What Now?</a></li> <li class="toctree-l1">
+<a class="reference internal" href="interactive">14. Interactive Input Editing and History Substitution</a><ul> <li class="toctree-l2"><a class="reference internal" href="interactive#tab-completion-and-history-editing">14.1. Tab Completion and History Editing</a></li> <li class="toctree-l2"><a class="reference internal" href="interactive#alternatives-to-the-interactive-interpreter">14.2. Alternatives to the Interactive Interpreter</a></li> </ul> </li> <li class="toctree-l1">
+<a class="reference internal" href="floatingpoint">15. Floating Point Arithmetic: Issues and Limitations</a><ul> <li class="toctree-l2"><a class="reference internal" href="floatingpoint#representation-error">15.1. Representation Error</a></li> </ul> </li> <li class="toctree-l1">
+<a class="reference internal" href="appendix">16. Appendix</a><ul> <li class="toctree-l2">
+<a class="reference internal" href="appendix#interactive-mode">16.1. Interactive Mode</a><ul> <li class="toctree-l3"><a class="reference internal" href="appendix#error-handling">16.1.1. Error Handling</a></li> <li class="toctree-l3"><a class="reference internal" href="appendix#executable-python-scripts">16.1.2. Executable Python Scripts</a></li> <li class="toctree-l3"><a class="reference internal" href="appendix#the-interactive-startup-file">16.1.3. The Interactive Startup File</a></li> <li class="toctree-l3"><a class="reference internal" href="appendix#the-customization-modules">16.1.4. The Customization Modules</a></li> </ul> </li> </ul> </li> </ul>  <div class="_attribution">
+  <p class="_attribution-p">
+    &copy; 2001&ndash;2023 Python Software Foundation<br>Licensed under the PSF License.<br>
+    <a href="https://docs.python.org/3.12/tutorial/index.html" class="_attribution-link">https://docs.python.org/3.12/tutorial/index.html</a>
+  </p>
+</div>