├── README.md
└── docs
    ├── Makefile
    ├── build
        ├── doctrees
        │   ├── appendix.doctree
        │   ├── appetite.doctree
        │   ├── classes.doctree
        │   ├── controlflow.doctree
        │   ├── datastructures.doctree
        │   ├── environment.pickle
        │   ├── errors.doctree
        │   ├── floatingpoint.doctree
        │   ├── index.doctree
        │   ├── inputoutput.doctree
        │   ├── interactive.doctree
        │   ├── interpreter.doctree
        │   ├── introduction.doctree
        │   ├── modules.doctree
        │   ├── stdlib.doctree
        │   ├── stdlib2.doctree
        │   ├── venv.doctree
        │   └── whatnow.doctree
        └── html
        │   ├── .buildinfo
        │   ├── _sources
        │       ├── appendix.rst.txt
        │       ├── appetite.rst.txt
        │       ├── classes.rst.txt
        │       ├── controlflow.rst.txt
        │       ├── datastructures.rst.txt
        │       ├── errors.rst.txt
        │       ├── floatingpoint.rst.txt
        │       ├── index.rst.txt
        │       ├── inputoutput.rst.txt
        │       ├── interactive.rst.txt
        │       ├── interpreter.rst.txt
        │       ├── introduction.rst.txt
        │       ├── modules.rst.txt
        │       ├── stdlib.rst.txt
        │       ├── stdlib2.rst.txt
        │       ├── venv.rst.txt
        │       └── whatnow.rst.txt
        │   ├── _static
        │       ├── ajax-loader.gif
        │       ├── basic.css
        │       ├── comment-bright.png
        │       ├── comment-close.png
        │       ├── comment.png
        │       ├── css
        │       │   ├── badge_only.css
        │       │   └── theme.css
        │       ├── doctools.js
        │       ├── down-pressed.png
        │       ├── down.png
        │       ├── file.png
        │       ├── fonts
        │       │   ├── FontAwesome.otf
        │       │   ├── fontawesome-webfont.eot
        │       │   ├── fontawesome-webfont.svg
        │       │   ├── fontawesome-webfont.ttf
        │       │   └── fontawesome-webfont.woff
        │       ├── jquery-3.1.0.js
        │       ├── jquery.js
        │       ├── js
        │       │   └── theme.js
        │       ├── minus.png
        │       ├── plus.png
        │       ├── pygments.css
        │       ├── searchtools.js
        │       ├── underscore-1.3.1.js
        │       ├── underscore.js
        │       ├── up-pressed.png
        │       ├── up.png
        │       └── websupport.js
        │   ├── appendix.html
        │   ├── appetite.html
        │   ├── classes.html
        │   ├── controlflow.html
        │   ├── datastructures.html
        │   ├── errors.html
        │   ├── floatingpoint.html
        │   ├── genindex.html
        │   ├── index.html
        │   ├── inputoutput.html
        │   ├── interactive.html
        │   ├── interpreter.html
        │   ├── introduction.html
        │   ├── modules.html
        │   ├── objects.inv
        │   ├── search.html
        │   ├── searchindex.js
        │   ├── stdlib.html
        │   ├── stdlib2.html
        │   ├── venv.html
        │   └── whatnow.html
    ├── html
        ├── .buildinfo
        ├── _sources
        │   ├── appendix.rst.txt
        │   ├── appendix.txt
        │   ├── appetite.rst.txt
        │   ├── appetite.txt
        │   ├── classes.rst.txt
        │   ├── classes.txt
        │   ├── controlflow.rst.txt
        │   ├── controlflow.txt
        │   ├── datastructures.rst.txt
        │   ├── datastructures.txt
        │   ├── errors.rst.txt
        │   ├── errors.txt
        │   ├── floatingpoint.rst.txt
        │   ├── floatingpoint.txt
        │   ├── index.rst.txt
        │   ├── index.txt
        │   ├── inputoutput.rst.txt
        │   ├── inputoutput.txt
        │   ├── interactive.rst.txt
        │   ├── interactive.txt
        │   ├── interpreter.rst.txt
        │   ├── interpreter.txt
        │   ├── introduction.rst.txt
        │   ├── introduction.txt
        │   ├── modules.rst.txt
        │   ├── modules.txt
        │   ├── stdlib.rst.txt
        │   ├── stdlib.txt
        │   ├── stdlib2.rst.txt
        │   ├── stdlib2.txt
        │   ├── venv.rst.txt
        │   ├── venv.txt
        │   ├── whatnow.rst.txt
        │   └── whatnow.txt
        ├── _static
        │   ├── ajax-loader.gif
        │   ├── basic.css
        │   ├── comment-bright.png
        │   ├── comment-close.png
        │   ├── comment.png
        │   ├── css
        │   │   ├── badge_only.css
        │   │   └── theme.css
        │   ├── doctools.js
        │   ├── down-pressed.png
        │   ├── down.png
        │   ├── file.png
        │   ├── fonts
        │   │   ├── FontAwesome.otf
        │   │   ├── fontawesome-webfont.eot
        │   │   ├── fontawesome-webfont.svg
        │   │   ├── fontawesome-webfont.ttf
        │   │   └── fontawesome-webfont.woff
        │   ├── jquery-1.11.1.js
        │   ├── jquery-3.1.0.js
        │   ├── jquery.js
        │   ├── js
        │   │   └── theme.js
        │   ├── minus.png
        │   ├── plus.png
        │   ├── pygments.css
        │   ├── searchtools.js
        │   ├── underscore-1.3.1.js
        │   ├── underscore.js
        │   ├── up-pressed.png
        │   ├── up.png
        │   └── websupport.js
        ├── appendix.html
        ├── appetite.html
        ├── classes.html
        ├── controlflow.html
        ├── datastructures.html
        ├── errors.html
        ├── floatingpoint.html
        ├── genindex.html
        ├── index.html
        ├── inputoutput.html
        ├── interactive.html
        ├── interpreter.html
        ├── introduction.html
        ├── modules.html
        ├── objects.inv
        ├── search.html
        ├── searchindex.js
        ├── stdlib.html
        ├── stdlib2.html
        ├── venv.html
        └── whatnow.html
    ├── make.bat
    └── source
        ├── _templates
            └── layout_web.html
        ├── _themes
            └── sphinx_rtd_theme
            │   ├── __init__.py
            │   ├── breadcrumbs.html
            │   ├── footer.html
            │   ├── layout.html
            │   ├── layout_old.html
            │   ├── search.html
            │   ├── searchbox.html
            │   ├── static
            │       ├── css
            │       │   ├── badge_only.css
            │       │   └── theme.css
            │       ├── fonts
            │       │   ├── FontAwesome.otf
            │       │   ├── fontawesome-webfont.eot
            │       │   ├── fontawesome-webfont.svg
            │       │   ├── fontawesome-webfont.ttf
            │       │   └── fontawesome-webfont.woff
            │       └── js
            │       │   └── theme.js
            │   ├── theme.conf
            │   └── versions.html
        ├── appendix.rst
        ├── appetite.rst
        ├── classes.rst
        ├── conf.py
        ├── controlflow.rst
        ├── datastructures.rst
        ├── errors.rst
        ├── floatingpoint.rst
        ├── index.rst
        ├── inputoutput.rst
        ├── interactive.rst
        ├── interpreter.rst
        ├── introduction.rst
        ├── modules.rst
        ├── stdlib.rst
        ├── stdlib2.rst
        ├── venv.rst
        └── whatnow.rst


/README.md:
--------------------------------------------------------------------------------
 1 | pythontutorial3
 2 | ===============
 3 | 
 4 | python 3.5.1 tutorial中文版
 5 | 
 6 | 原地址：http://docs.python.org/3/tutorial/index.html
 7 | 
 8 | 中文地址：http://www.pythondoc.com/pythontutorial3/index.html
 9 | 
10 | **source** 文件夹下为 rst 格式的文档；
11 | 
12 | **html** 文件夹下为使用 Sphinx 生成的 html 格式的文档； 
13 | 
14 | **docs** 文件夹为原始版中文翻译；
15 | 
16 | 
17 | 备注：因为平时工作比较忙，如果版本有更新的话，请直接提交 issues，谢谢！
18 | 


--------------------------------------------------------------------------------
/docs/Makefile:
--------------------------------------------------------------------------------
  1 | # Makefile for Sphinx documentation
  2 | #
  3 | 
  4 | # You can set these variables from the command line.
  5 | SPHINXOPTS    =
  6 | SPHINXBUILD   = sphinx-build
  7 | PAPER         =
  8 | BUILDDIR      = build
  9 | 
 10 | # Internal variables.
 11 | PAPEROPT_a4     = -D latex_paper_size=a4
 12 | PAPEROPT_letter = -D latex_paper_size=letter
 13 | ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
 14 | # the i18n builder cannot share the environment and doctrees with the others
 15 | I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
 16 | 
 17 | .PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
 18 | 
 19 | help:
 20 | 	@echo "Please use \`make <target>' where <target> is one of"
 21 | 	@echo "  html       to make standalone HTML files"
 22 | 	@echo "  dirhtml    to make HTML files named index.html in directories"
 23 | 	@echo "  singlehtml to make a single large HTML file"
 24 | 	@echo "  pickle     to make pickle files"
 25 | 	@echo "  json       to make JSON files"
 26 | 	@echo "  htmlhelp   to make HTML files and a HTML help project"
 27 | 	@echo "  qthelp     to make HTML files and a qthelp project"
 28 | 	@echo "  devhelp    to make HTML files and a Devhelp project"
 29 | 	@echo "  epub       to make an epub"
 30 | 	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
 31 | 	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
 32 | 	@echo "  text       to make text files"
 33 | 	@echo "  man        to make manual pages"
 34 | 	@echo "  texinfo    to make Texinfo files"
 35 | 	@echo "  info       to make Texinfo files and run them through makeinfo"
 36 | 	@echo "  gettext    to make PO message catalogs"
 37 | 	@echo "  changes    to make an overview of all changed/added/deprecated items"
 38 | 	@echo "  linkcheck  to check all external links for integrity"
 39 | 	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
 40 | 
 41 | clean:
 42 | 	-rm -rf $(BUILDDIR)/*
 43 | 
 44 | html:
 45 | 	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
 46 | 	@echo
 47 | 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
 48 | 
 49 | dirhtml:
 50 | 	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
 51 | 	@echo
 52 | 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
 53 | 
 54 | singlehtml:
 55 | 	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
 56 | 	@echo
 57 | 	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
 58 | 
 59 | pickle:
 60 | 	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
 61 | 	@echo
 62 | 	@echo "Build finished; now you can process the pickle files."
 63 | 
 64 | json:
 65 | 	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
 66 | 	@echo
 67 | 	@echo "Build finished; now you can process the JSON files."
 68 | 
 69 | htmlhelp:
 70 | 	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
 71 | 	@echo
 72 | 	@echo "Build finished; now you can run HTML Help Workshop with the" \
 73 | 	      ".hhp project file in $(BUILDDIR)/htmlhelp."
 74 | 
 75 | qthelp:
 76 | 	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
 77 | 	@echo
 78 | 	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
 79 | 	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
 80 | 	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/Pythontutorial.qhcp"
 81 | 	@echo "To view the help file:"
 82 | 	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/Pythontutorial.qhc"
 83 | 
 84 | devhelp:
 85 | 	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
 86 | 	@echo
 87 | 	@echo "Build finished."
 88 | 	@echo "To view the help file:"
 89 | 	@echo "# mkdir -p $$HOME/.local/share/devhelp/Pythontutorial"
 90 | 	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/Pythontutorial"
 91 | 	@echo "# devhelp"
 92 | 
 93 | epub:
 94 | 	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
 95 | 	@echo
 96 | 	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
 97 | 
 98 | latex:
 99 | 	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
100 | 	@echo
101 | 	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
102 | 	@echo "Run \`make' in that directory to run these through (pdf)latex" \
103 | 	      "(use \`make latexpdf' here to do that automatically)."
104 | 
105 | latexpdf:
106 | 	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
107 | 	@echo "Running LaTeX files through pdflatex..."
108 | 	$(MAKE) -C $(BUILDDIR)/latex all-pdf
109 | 	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
110 | 
111 | text:
112 | 	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
113 | 	@echo
114 | 	@echo "Build finished. The text files are in $(BUILDDIR)/text."
115 | 
116 | man:
117 | 	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
118 | 	@echo
119 | 	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
120 | 
121 | texinfo:
122 | 	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
123 | 	@echo
124 | 	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
125 | 	@echo "Run \`make' in that directory to run these through makeinfo" \
126 | 	      "(use \`make info' here to do that automatically)."
127 | 
128 | info:
129 | 	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
130 | 	@echo "Running Texinfo files through makeinfo..."
131 | 	make -C $(BUILDDIR)/texinfo info
132 | 	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
133 | 
134 | gettext:
135 | 	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
136 | 	@echo
137 | 	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
138 | 
139 | changes:
140 | 	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
141 | 	@echo
142 | 	@echo "The overview file is in $(BUILDDIR)/changes."
143 | 
144 | linkcheck:
145 | 	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
146 | 	@echo
147 | 	@echo "Link check complete; look for any errors in the above output " \
148 | 	      "or in $(BUILDDIR)/linkcheck/output.txt."
149 | 
150 | doctest:
151 | 	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
152 | 	@echo "Testing of doctests in the sources finished, look at the " \
153 | 	      "results in $(BUILDDIR)/doctest/output.txt."
154 | 


--------------------------------------------------------------------------------
/docs/build/doctrees/appendix.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/appendix.doctree


--------------------------------------------------------------------------------
/docs/build/doctrees/appetite.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/appetite.doctree


--------------------------------------------------------------------------------
/docs/build/doctrees/classes.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/classes.doctree


--------------------------------------------------------------------------------
/docs/build/doctrees/controlflow.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/controlflow.doctree


--------------------------------------------------------------------------------
/docs/build/doctrees/datastructures.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/datastructures.doctree


--------------------------------------------------------------------------------
/docs/build/doctrees/environment.pickle:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/environment.pickle


--------------------------------------------------------------------------------
/docs/build/doctrees/errors.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/errors.doctree


--------------------------------------------------------------------------------
/docs/build/doctrees/floatingpoint.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/floatingpoint.doctree


--------------------------------------------------------------------------------
/docs/build/doctrees/index.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/index.doctree


--------------------------------------------------------------------------------
/docs/build/doctrees/inputoutput.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/inputoutput.doctree


--------------------------------------------------------------------------------
/docs/build/doctrees/interactive.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/interactive.doctree


--------------------------------------------------------------------------------
/docs/build/doctrees/interpreter.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/interpreter.doctree


--------------------------------------------------------------------------------
/docs/build/doctrees/introduction.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/introduction.doctree


--------------------------------------------------------------------------------
/docs/build/doctrees/modules.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/modules.doctree


--------------------------------------------------------------------------------
/docs/build/doctrees/stdlib.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/stdlib.doctree


--------------------------------------------------------------------------------
/docs/build/doctrees/stdlib2.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/stdlib2.doctree


--------------------------------------------------------------------------------
/docs/build/doctrees/venv.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/venv.doctree


--------------------------------------------------------------------------------
/docs/build/doctrees/whatnow.doctree:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/doctrees/whatnow.doctree


--------------------------------------------------------------------------------
/docs/build/html/.buildinfo:
--------------------------------------------------------------------------------
1 | # Sphinx build info version 1
2 | # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3 | config: b1a91b39ded23837a5135bfa0fbc7bee
4 | tags: 645f666f9bcd5a90fca523b33c5a78b7
5 | 


--------------------------------------------------------------------------------
/docs/build/html/_sources/appendix.rst.txt:
--------------------------------------------------------------------------------
 1 | .. _tut-appendix:
 2 | 
 3 | ********
 4 | 附录
 5 | ********
 6 | 
 7 | 
 8 | .. _tut-interac:
 9 | 
10 | 交互模式
11 | ================
12 | 
13 | .. _tut-error:
14 | 
15 | 错误处理
16 | --------------
17 | 
18 | 当错误发生时，解释器打印一个错误信息和堆栈跟踪。在交互模式下，它返回主提示符；当输入来自文件的时候，在打印堆栈跟踪后以非零退出(a nonzero exit)状态退出。（在 `try <https://docs.python.org/3/reference/compound_stmts.html#try>`_ 声明中被 `except <https://docs.python.org/3/reference/compound_stmts.html#except>`_ 子句捕捉到的异常在这种情况下不是错误。）有些错误是非常致命的会导致一个非零状态的退出；这也适用于内部错误以及某些情况的内存耗尽。所有的错误信息都写入到标准错误流；来自执行的命令的普通输出写入到标准输出。
19 | 
20 | 输入中断符（通常是 Control-C 或者 DEL）到主或者从提示符中会取消输入并且返回到主提示。[#]_ 当命令执行中输入中断符会引起 `KeyboardInterrupt <https://docs.python.org/3/library/exceptions.html#KeyboardInterrupt>`_ 异常，这个异常能够被一个 `try <https://docs.python.org/3/reference/compound_stmts.html#try>`_ 声明处理。
21 | 
22 | 
23 | .. _tut-scripts:
24 | 
25 | 可执行 Python 脚本
26 | -------------------------
27 | 
28 | 在 BSD'ish Unix 系统上，Python 脚本可直接执行，像 shell 脚本一样，只需要把下面内容加入到 ::
29 | 
30 |    #!/usr/bin/env python3.5
31 | 
32 | （假设 python 解释器在用户的 :envvar:`PATH` 中）脚本的开头，并给予该文件的可执行模式。``#!`` 必须是文件的头两个字符。在一些系统上，第一行必须以 Unix-style 的行结束符（``'\n'``）结束，不能以 Windows 的行结束符（``'\r\n'``）。 注意 ``'#'`` 在 Python 中是用于注释的。
33 | 
34 | 使用 :program:`chmod` 命令能够给予脚本执行模式或者权限。
35 | 
36 | .. code-block:: bash
37 | 
38 |    $ chmod +x myscript.py
39 | 
40 | 在 Windows 系统上，没有一个 “可执行模式” 的概念。Python 安装器会自动地把 ``.py``  文件和 ``python.exe`` 关联起来，因此双击 Python 将会把它当成一个脚本运行。文件扩展名也可以是 ``.pyw``，在这种情况下，运行时不会出现控制台窗口。
41 | 
42 | 
43 | .. _tut-startup:
44 | 
45 | 交互式启动文件
46 | ----------------------------
47 | 
48 | 当你使用交互式 Python 的时候，它常常很方便地执行一些命令在每次解释器启动时。你可以这样做：设置一个名为 `PYTHONSTARTUP <https://docs.python.org/3/using/cmdline.html#envvar-PYTHONSTARTUP>`_ 的环境变量为包含你的启动命令的文件名。这跟 Unix shells 的 :file:`.profile` 特点有些类似。
49 | 
50 | 这个文件在交互式会话中是只读的，在当 Python 从脚本中读取命令，以及在当 :file:`/dev/tty` 被作为明确的命令源的时候不只是可读的。该文件在交互式命令被执行的时候在相同的命名空间中能够被执行，因此在交互式会话中定义或者导入的对象能够无需授权就能使用。你也能在文件中更改提示 ``sys.ps1`` 和 ``sys.ps2``。
51 | 
52 | 如果你想要从当前目录中读取一个附加的启动文件，你可以在全局启动文件中编写代码像这样：``if
53 | os.path.isfile('.pythonrc.py'): exec(open('.pythonrc.py').read())``。如果你想要在脚本中使用启动文件的话，你必须在脚本中明确要这么做::
54 | 
55 |    import os
56 |    filename = os.environ.get('PYTHONSTARTUP')
57 |    if filename and os.path.isfile(filename):
58 |        with open(filename) as fobj:
59 |           startup_file = fobj.read()
60 |        exec(startup_file)
61 | 
62 | 
63 | .. _tut-customize:
64 | 
65 | 定制模块
66 | -------------------------
67 | 
68 | Python 提供两个钩子为了让你们定制 :mod:`sitecustomize` 和 :mod:`usercustomize`。为了看看它的工作机制的话，你必须首先找到你的用户 site-packages 目录的位置。启动 Python 并且运行这段代码::
69 | 
70 |    >>> import site
71 |    >>> site.getusersitepackages()
72 |    '/home/user/.local/lib/python3.4/site-packages'
73 | 
74 | 现在你可以创建一个名为 :file:`usercustomize.py` 的文件在你的用户 site-packages 目录，并且在里面放置你想要的任何内容。它会影响 Python 的每一次调用，除非它以 `-s <https://docs.python.org/3/using/cmdline.html#cmdoption-s>`_ （禁用自动导入）选项启动。
75 | 
76 | :mod:`sitecustomize` 以同样地方式工作，但是通常由是机器的管理员创建在全局的 site-packages 目录中，并且是在 :mod:`usercustomize` 之前导入。请参阅 `site <https://docs.python.org/3/library/site.html#module-site>`_ 模块获取更多信息。
77 | 
78 | 
79 | .. rubric:: Footnotes
80 | 
81 | .. [#] GNU 的 Readline 包的问题可能会阻止这种做法。
82 | 


--------------------------------------------------------------------------------
/docs/build/html/_sources/appetite.rst.txt:
--------------------------------------------------------------------------------
 1 | .. _tut-intro:
 2 | 
 3 | **********************
 4 | 开胃菜
 5 | **********************
 6 | 
 7 | 如果你要用计算机做很多工作，最后你会发现有一些任务你更希望用自动化的方式进行处理。比如，你想要在大量的文本文件中执行查找/替换，或者以复杂的方式对大量的图片进行重命名和整理。也许你想要编写一个小型的自定义数据库、一个特殊的 GUI 应用程序或一个简单的小游戏。
 8 | 
 9 | 如果你是一名专业的软件开发者，可能你必须使用几种 C/C++/JAVA 类库，并且发现通常编写/编译/测试/重新编译的周期是如此漫长。也许你正在为这些类库编写测试用例，但是发现这是一个让人烦躁的工作。又或者你已经完成了一个可以使用扩展语言的程序，但你并不想为此重新设计并实现一套全新的语言。
10 | 
11 | 那么 Python 正是你所需要的语言。
12 | 
13 | 虽然你能够通过编写 Unix shell 脚本或 Windows 批处理文件来处理其中的某些任务，但 Shell 脚本更适合移动文件或修改文本数据，并不适合编写 GUI 应用程序或游戏；虽然你能够使用 C/C++/JAVA 编写程序，但即使编写一个简单的 first-draft 程序也有可能耗费大量的开发时间。相比之下，Python 更易于使用，无论在 Windows、Mac OS X 或 Unix 操作系统上它都会帮助你更快地完成任务。
14 | 
15 | 虽然 Python 易于使用，但它却是一门完整的编程语言；与 Shell 脚本或批处理文件相比，它为编写大型程序提供了更多的结构和支持。另一方面，Python 提供了比 C 更多的错误检查，并且作为一门 *高级语言*，它内置支持高级的数据结构类型，例如：灵活的数组和字典。因其更多的通用数据类型，Python 比 Awk 甚至 Perl 都适用于更多问题领域，至少大多数事情在 Python 中与其他语言同样简单。
16 | 
17 | Python 允许你将程序分割为不同的模块，以便在其他的 Python 程序中重用。Python 内置提供了大量的标准模块，你可以将其用作程序的基础，或者作为学习 Python 编程的示例。这些模块提供了诸如文件 I/O、系统调用、Socket 支持，甚至类似 Tk 的用户图形界面（GUI）工具包接口。
18 | 
19 | Python 是一门解释型语言，因为无需编译和链接，你可以在程序开发中节省宝贵的时间。Python 解释器可以交互的使用，这使得试验语言的特性、编写临时程序或在自底向上的程序开发中测试方法非常容易。你甚至还可以把它当做一个桌面计算器。
20 | 
21 | Python 让程序编写的紧凑和可读。用 Python 编写的程序通常比同样的 C、C++ 或 Java 程序更短小，这是因为以下几个原因::
22 | 
23 | 	* 高级数据结构使你可以在一条语句中表达复杂的操作；
24 | 
25 | 	* 语句组使用缩进代替开始和结束大括号来组织；
26 | 
27 | 	* 变量或参数无需声明。
28 | 
29 | Python 是 *可扩展* 的：如果你会 C 语言编程便可以轻易地为解释器添加内置函数或模块，或者为了对性能瓶颈作优化，或者将 Python 程序与只有二进制形式的库（比如某个专业的商业图形库）连接起来。一旦你真正掌握了它，你可以将 Python 解释器集成进某个 C 应用程序，并把它当作那个程序的扩展或命令行语言。
30 | 
31 | 顺便说一句，这个语言的名字来自于 BBC 的 “Monty Python’s Flying Cirecus” 节目，和爬行类动物没有任何关系。在文档中引用 Monty Python 的典故不仅可行，而且值得鼓励！
32 | 
33 | 现在你已经为 Python 兴奋不已了吧，大概想要领略一些更多的细节！学习一门语言最好的方法就是使用它，本指南推荐你边读边使用 Python 解释器练习。
34 | 
35 | 下一节中，我们将解释 Python 解释器的用法。这是很简单的一件事情，但它有助于试验后面的例子。
36 | 
37 | 本手册剩下的部分将通过示例介绍 Python 语言及系统的诸多特性，开始是简单的语法、数据类型和表达式，接着介绍函数与模块，最后涉及异常和自定义类这样的高级内容。
38 | 


--------------------------------------------------------------------------------
/docs/build/html/_sources/floatingpoint.rst.txt:
--------------------------------------------------------------------------------
  1 | .. _tut-fp-issues:
  2 | 
  3 | **************************************************
  4 | 浮点数算法：争议和限制
  5 | **************************************************
  6 | 
  7 | .. sectionauthor:: Tim Peters <tim_one@users.sourceforge.net>
  8 | 
  9 | 
 10 | 浮点数在计算机中表达为二进制（binary）小数。例如：十进制小数::
 11 | 
 12 |    0.125
 13 | 
 14 | 是 1/10 + 2/100 + 5/1000 的值，同样二进制小数::
 15 | 
 16 |    0.001
 17 | 
 18 | 是 0/2 + 0/4 + 1/8。这两个数值相同。唯一的实质区别是第一个写为十进制小数记法，第二个是二进制。 
 19 | 
 20 | 不幸的是，大多数十进制小数不能完全用二进制小数表示。结果是，一般情况下，你输入的十进制浮点数仅由实际存储在计算机中的近似的二进制浮点数表示。
 21 | 
 22 | 这个问题更早的时候首先在十进制中发现。考虑小数形式的 1/3 ，你可以来个十进制的近似值。 ::
 23 | 
 24 |    0.3
 25 | 
 26 | 或者更进一步的, ::
 27 | 
 28 |    0.33
 29 | 
 30 | 或者更进一步的, ::
 31 | 
 32 |    0.333
 33 | 
 34 | 诸如此类。如果你写多少位，这个结果永远不是精确的 1/3 ，但是可以无限接近 1/3 。 
 35 | 
 36 | 同样，无论在二进制中写多少位，十进制数 0.1 都不能精确表达为二进制小数。二进制来表达 1/10 是一个无限循环小数::
 37 | 
 38 |    0.0001100110011001100110011001100110011001100110011...
 39 | 
 40 | 在任何有限数量的位停下来，你得到的都是近似值。今天在大多数机器上，浮点数的近似使用的小数以最高的 53 位为分子，2 的幂为分母。至于 1/10 这种情况，其二进制小数是  ``3602879701896397 / 2 ** 55``，它非常接近但不完全等于1/10真实的值。
 41 | 
 42 | 由于显示方式的原因，许多使用者意识不到是近似值。Python 只打印机器中存储的二进制值的十进制近似值。在大多数机器上，如果 Python 要打印 0.1 存储的二进制的真正近似值，将会显示::
 43 | 
 44 |    >>> 0.1
 45 |    0.1000000000000000055511151231257827021181583404541015625
 46 | 
 47 | 这么多位的数字对大多数人是没有用的，所以 Python 显示一个舍入的值 ::
 48 | 
 49 |    >>> 1 / 10
 50 |    0.1
 51 | 
 52 | 只要记住即使打印的结果看上去是精确的 1/10，真正存储的值是最近似的二进制小数。
 53 | 
 54 | 有趣地是，存在许多不同的十进制数共享着相同的近似二进制小数。例如，数字 ``0.1`` 和 ``0.10000000000000001`` 以及 ``0.1000000000000000055511151231257827021181583404541015625`` 都是 ``3602879701896397 / 2 ** 55`` 的近似值。因为所有这些十进制数共享相同的近似值，在保持恒等式 ``eval(repr(x)) == x`` 的同时，显示的可能是它们中的任何一个。
 55 | 
 56 | 历史上，Python 提示符和内置的 `repr() <https://docs.python.org/3/library/functions.html#repr>`_ 函数选择一个 17 位精度的数字，``0.10000000000000001``。从 Python 3.1 开始，Python（在大多数系统上）能够从这些数字当中选择最短的一个并简单地显示 ``0.1``。
 57 | 
 58 | 注意，这是二进制浮点数的自然性质：它不是 Python 中的一个 bug，也不是你的代码中的 bug。你会看到所有支持硬件浮点数算法的语言都会有这个现象（尽管有些语言默认情况下或者在所有输出模式下可能不会 *显示* 出差异）。
 59 | 
 60 | 为了输出更好看，你可能想用字符串格式化来生成固定位数的有效数字::
 61 | 
 62 |    >>> format(math.pi, '.12g')  # give 12 significant digits
 63 |    '3.14159265359'
 64 | 
 65 |    >>> format(math.pi, '.2f')   # give 2 digits after the point
 66 |    '3.14'
 67 | 
 68 |    >>> repr(math.pi)
 69 |    '3.141592653589793'
 70 | 
 71 | 认识到这，在真正意义上，是一种错觉是很重要的：你在简单地舍入真实机器值的 *显示*。
 72 | 
 73 | 例如，既然 0.1 不是精确的 1/10，3 个 0.1 的值相加可能也不会得到精确的 0.3::
 74 | 
 75 |    >>> .1 + .1 + .1 == .3
 76 |    False
 77 | 
 78 | 另外，既然 0.1 不能更接近 1/10 的精确值而且 0.3 不能更接近 3/10 的精确值，使用 `round() <https://docs.python.org/3/library/functions.html#round>`_ 函数提前舍入也没有帮助::
 79 | 
 80 |    >>> round(.1, 1) + round(.1, 1) + round(.1, 1) == round(.3, 1)
 81 |    False
 82 | 
 83 | 虽然这些数字不可能再更接近它们想要的精确值，`round() <https://docs.python.org/3/library/functions.html#round>`_  函数可以用于在计算之后进行舍入，这样的话不精确的结果就可以和另外一个相比较了::
 84 | 
 85 |     >>> round(.1 + .1 + .1, 10) == round(.3, 10)
 86 |     True
 87 | 
 88 | 二进制浮点数计算有很多这样意想不到的结果。“0.1”的问题在下面"误差的表示"一节中有准确详细的解释。更完整的常见怪异现象请参见 `浮点数的危险 <http://www.lahey.com/float.htm>`_。
 89 | 
 90 | 最后我要说，“没有简单的答案”。也不要过分小心浮点数！Python 浮点数计算中的误差源之于浮点数硬件，大多数机器上每次计算误差不超过 2\*\*53 分之一。对于大多数任务这已经足够了，但是你要在心中记住这不是十进制算法，每个浮点数计算可能会带来一个新的舍入错误。
 91 | 
 92 | 虽然确实有问题存在，对于大多数平常的浮点数运算，你只要简单地将最终显示的结果舍入到你期望的十进制位数，你就会得到你期望的最终结果。`str() <https://docs.python.org/3/library/stdtypes.html#str>`_ 通常已经足够用了，对于更好的控制可以参阅 `格式化字符串语法 <https://docs.python.org/3/library/string.html#formatstrings>`_ 中 `str.format() <https://docs.python.org/3/library/stdtypes.html#str.format>`_ 方法的格式说明符。
 93 | 
 94 | 对于需要精确十进制表示的情况，可以尝试使用 `decimal <https://docs.python.org/3/library/decimal.html#module-decimal>`_ 模块，它实现的十进制运算适合会计方面的应用和高精度要求的应用。
 95 | 
 96 | `fractions <https://docs.python.org/3/library/fractions.html#module-fractions>`_ 模块支持另外一种形式的运算，它实现的运算基于有理数（因此像1/3这样的数字可以精确地表示）。
 97 | 
 98 | 如果你是浮点数操作的重度使用者，你应该看一下由 SciPy 项目提供的 Numerical Python 包和其它用于数学和统计学的包。参看 <http://scipy.org>。
 99 | 
100 | 当你真的 *真* 想要知道浮点数精确值的时候，Python 提供这样的工具可以帮助你。`float.as_integer_ratio() <https://docs.python.org/3/library/stdtypes.html#float.as_integer_ratio>`_ 方法以分数的形式表示一个浮点数的值::
101 | 
102 |    >>> x = 3.14159
103 |    >>> x.as_integer_ratio()
104 |    (3537115888337719, 1125899906842624)
105 | 
106 | 因为比值是精确的，它可以用来无损地重新生成初始值::
107 | 
108 |     >>> x == 3537115888337719 / 1125899906842624
109 |     True
110 | 
111 | `float.hex() <https://docs.python.org/3/library/stdtypes.html#float.hex>`_ 方法以十六进制表示浮点数，给出的同样是计算机存储的精确值::
112 | 
113 |    >>> x.hex()
114 |    '0x1.921f9f01b866ep+1'
115 | 
116 | 精确的十六进制表示可以用来准确地重新构建浮点数::
117 | 
118 |     >>> x == float.fromhex('0x1.921f9f01b866ep+1')
119 |     True
120 | 
121 | 因为可以精确表示，所以可以用在不同版本的 Python（与平台相关）之间可靠地移植数据以及与支持同样格式的其它语言（例如 Java 和 C99）交换数据。
122 | 
123 | 另外一个有用的工具是 `math.fsum() <https://docs.python.org/3/library/math.html#math.fsum>`_ 函数，它帮助求和过程中减少精度的损失。当数值在不停地相加的时候，它会跟踪“丢弃的数字”。这可以给总体的准确度带来不同，以至于错误不会累积到影响最终结果的点::
124 | 
125 |    >>> sum([0.1] * 10) == 1.0
126 |    False
127 |    >>> math.fsum([0.1] * 10) == 1.0
128 |    True
129 | 
130 | 
131 | .. _tut-fp-error:
132 | 
133 | 表达错误
134 | ====================
135 | 
136 | 这一节详细说明 “0.1” 示例，教你怎样自己去精确的分析此类案例。假设这里你已经对浮点数表示有基本的了解。 
137 | 
138 | :dfn:`Representation error` 提及事实上有些（实际是大多数）十进制小数不能精确的表示为二进制小数。这是 Python （或 Perl，C，C++，Java，Fortran 以及其它很多）语言往往不能按你期待的样子显示十进制数值的根本原因。
139 | 
140 | 这是为什么？ 1/10 不能精确的表示为二进制小数。大多数今天的机器（2000年十一月）使用 IEEE-754 浮点数算法，大多数平台上 Python 将浮点数映射为 IEEE-754 “双精度浮点数”。754 双精度包含 53 位精度，所以计算机努力将输入的 0.1 转为 *J*/2**\ *N* 最接近的二进制小数。*J* 是一个 53 位的整数。改写::
141 | 
142 |    1 / 10 ~= J / (2**N)
143 | 
144 | 为::
145 | 
146 |    J ~= 2**N / 10
147 | 
148 | *J* 重现时正是 53 位（是 ``>= 2**52`` 而非 ``< 2**53`` ）， *N* 的最佳值是 56::
149 | 
150 |     >>> 2**52 <=  2**56 // 10  < 2**53
151 |     True
152 | 
153 | 因此，56 是保持 *J* 精度的唯一 *N* 值。*J* 最好的近似值是整除的商::
154 | 
155 |    >>> q, r = divmod(2**56, 10)
156 |    >>> r
157 |    6
158 | 
159 | 因为余数大于 10 的一半，最好的近似是取上界::
160 | 
161 |    >>> q+1
162 |    7205759403792794
163 | 
164 | 因此在 754 双精度中 1/10 最好的近似值是是 2**56，或::
165 | 
166 |    7205759403792794 / 2 ** 56
167 | 
168 | 分子和分母都除以2将小数缩小到::
169 | 
170 |    3602879701896397 / 2 ** 55
171 | 
172 | 要注意因为我们向上舍入，它其实比 1/10 稍大一点点。如果我们没有向上舍入，它会比 1/10 稍小一点。但是没办法让它 *恰好* 是 1/10！ 
173 | 
174 | 所以计算机永远也不 “知道” 1/10：它遇到上面这个小数，给出它所能得到的最佳的 754 双精度实数::
175 | 
176 |    >>> .1 * 2**55
177 |    7205759403792794.0
178 | 
179 | 如果我们把这小数乘以 10\*\*55，我们可以看到其55位十进制数的值::
180 | 
181 |    >>> 3602879701896397 * 10 ** 55 // 2 ** 55
182 |    1000000000000000055511151231257827021181583404541015625
183 | 
184 | 这表示存储在计算机中的实际值近似等于十进制值 0.1000000000000000055511151231257827021181583404541015625。许多语言（包括旧版本的Python）会把结果舍入到 17 位有效数字，而不是显示全部的十进制值::
185 | 
186 |    >>> format(0.1, '.17f')
187 |    '0.10000000000000001'
188 | 
189 | `fractions <https://docs.python.org/3/library/fractions.html#module-fractions>`_ 和 `decimal <https://docs.python.org/3/library/decimal.html#module-decimal>`_ 模块使得这些计算很简单::
190 | 
191 |    >>> from decimal import Decimal
192 |    >>> from fractions import Fraction
193 | 
194 |    >>> Fraction.from_float(0.1)
195 |    Fraction(3602879701896397, 36028797018963968)
196 | 
197 |    >>> (0.1).as_integer_ratio()
198 |    (3602879701896397, 36028797018963968)
199 | 
200 |    >>> Decimal.from_float(0.1)
201 |    Decimal('0.1000000000000000055511151231257827021181583404541015625')
202 | 
203 |    >>> format(Decimal.from_float(0.1), '.17')
204 |    '0.10000000000000001'
205 | 


--------------------------------------------------------------------------------
/docs/build/html/_sources/index.rst.txt:
--------------------------------------------------------------------------------
 1 | .. _tutorial-index:
 2 | 
 3 | ######################
 4 | Python 入门指南
 5 | ######################
 6 | 
 7 | :Release: |version|
 8 | :Date: |today|
 9 | 
10 | Python 是一门简单易学且功能强大的编程语言。它拥有高效的高级数据结构，并且能够用简单而又高效的方式进行面向对象编程。Python 优雅的语法和动态类型，再结合它的解释性，使其在大多数平台的许多领域成为编写脚本或开发应用程序的理想语言。
11 | 
12 | 你可以自由地从 Python 官方点: http://www.python.org，以源代码或二进制形式获取 Python 解释器及其标准扩展库，并可以自由的分发。此站点同时也提供了大量的第三方 Python 模块、程序和工具，及其附加文档。
13 | 
14 | 你可以很容易的使用 C 或 C++（其他可以通过 C 调用的语言）为 Python 解释器扩展新函数和数据类型。Python 还可以被用作定制应用程序的一门扩展语言。
15 | 
16 | 本手册非正式的向读者介绍了 Python 语言及其体系相关的基本知识与概念。在学习实践中结合使用 Python 解释器是很有帮助的，不过所有的例子都是完整的，所以本手册亦可离线阅读。
17 | 
18 | 如果需要了解相关标准库或对象的详细介绍，请查阅 `Python 参考文档`_ 。`Python 参考手册`_ 提供了更多语言相关的正式说明。如果想要使用 C 或 C++ 编写扩展，请查阅 `Python 解释器扩展和集成章节`_ 和 `C API 参考手册`_ 。当然也可阅读一些深入介绍 Python 知识的图书。
19 | 
20 | 本手册不会尝试涵盖 Python 的全部知识和每个特性，甚至不会涵盖所有常用的特性。相反地，它介绍了 Python 中许多最引人瞩目的特性，并且会给你一个关于语言特色和风格的认识。读完之后，你将能够阅读和编写 Python 模块或程序，并为以后使用 
21 | `Python 参考手册`_ 继续学习诸多 Python 模块库做好准备。
22 | 
23 | 
24 | `词汇表`_ 也值得浏览一下。
25 | 
26 | .. toctree::
27 |    :numbered:
28 | 
29 |    appetite.rst
30 |    interpreter.rst
31 |    introduction.rst
32 |    controlflow.rst
33 |    datastructures.rst
34 |    modules.rst
35 |    inputoutput.rst
36 |    errors.rst
37 |    classes.rst
38 |    stdlib.rst
39 |    stdlib2.rst
40 |    venv.rst
41 |    whatnow.rst
42 |    interactive.rst
43 |    floatingpoint.rst
44 |    appendix.rst
45 | 
46 | 
47 | .. _Python 参考文档: https://docs.python.org/3/library/index.html#library-index
48 | .. _Python 参考手册: https://docs.python.org/3/reference/index.html#reference-index
49 | .. _Python 解释器扩展和集成章节: https://docs.python.org/3/extending/index.html#extending-index
50 | .. _C API 参考手册: https://docs.python.org/3/c-api/index.html#c-api-index
51 | .. _词汇表: https://docs.python.org/3/glossary.html#glossary


--------------------------------------------------------------------------------
/docs/build/html/_sources/interactive.rst.txt:
--------------------------------------------------------------------------------
 1 | .. _tut-interacting:
 2 | 
 3 | **************************************************
 4 | 交互式输入行编辑历史回溯
 5 | **************************************************
 6 | 
 7 | 某些版本的 Python 解释器支持编辑当前的输入行和历史记录，类似于在 Korn shell 和 GNU Bash shell 中看到的功能。这是使用 `GNU Readline`_ 库实现的，它支持各种编辑风格。 这个库有它自己的文档，在这里我们不就重复了。
 8 | 
 9 | 
10 | .. _tut-keybindings:
11 | 
12 | Tab 补全和历史记录
13 | ==================================
14 | 
15 | 变量和模块名的补全在解释器启动时 `自动打开 <https://docs.python.org/3/library/site.html#rlcompleter-config>`_ 以便 :kbd:`Tab` 键调用补全功能；它会查看Python语句的名字，当前局部变量以及可以访问的模块名。对于点分表达式如 ``string.a``，它将求出表达式最后一个 ``'.'`` 之前的值，然后根据结果的属性给出补全的建议。注意，如果一个具有 `__getattr__() <https://docs.python.org/3/reference/datamodel.html#object.__getattr__>`_ 方法的对象是表达式的某部分，这可能执行应用程序定义的代码。默认的配置同时会把历史记录保存在你的用户目录下一个名为 :file:`.python_history` 的文件中。在下次与交互式解释器的会话中，历史记录将还可以访问。
16 | 
17 | 
18 | .. _tut-commentary:
19 | 
20 | 其它交互式解释器
21 | ===========================================
22 | 
23 | 与早期版本的解释器相比，现在是向前巨大的进步；然而，有些愿望还是没有实现：如果能对连续的行给出正确的建议就更好了（解析器知道下一行是否需要缩进）。补全机制可以使用解释器的符号表。检查（或者只是建议）匹配的括号、 引号的命令等也会非常有用。
24 | 
25 | 一个增强的交互式解释器是 IPython_，它已经存在相当一段时间，具有 tab 补全、 对象 exploration 和高级的历史记录功能。它也可以彻底定制并嵌入到其他应用程序中。另一个类似的增强的交互式环境是 bpython_。
26 | 
27 | 
28 | 
29 | .. _GNU Readline: http://tiswww.case.edu/php/chet/readline/rltop.html
30 | .. _IPython: http://ipython.scipy.org/
31 | .. _bpython: http://www.bpython-interpreter.org/
32 | 


--------------------------------------------------------------------------------
/docs/build/html/_sources/interpreter.rst.txt:
--------------------------------------------------------------------------------
  1 | .. _tut-using:
  2 | 
  3 | ****************************
  4 | 使用 Python 解释器
  5 | ****************************
  6 | 
  7 | 
  8 | .. _tut-invoking:
  9 | 
 10 | 调用 Python 解释器
 11 | ========================
 12 | 
 13 | Python 解释器通常被安装在目标机器的 :file:`/usr/local/bin/python3.5` 目录下。将 :file:`/usr/local/bin` 目录包含进 Unix shell 的搜索路径里，以确保可以通过输入:
 14 | 
 15 | .. code-block:: text
 16 | 
 17 |    python3.5
 18 | 
 19 | 命令来启动他。[#]_ 由于 Python 解释器的安装路径是可选的，这也可能是其它路径，你可以联系安装 Python 的用户或系统管理员确认（例如，:file:`/usr/local/python` 就是一个常见的选择）。
 20 | 
 21 | 在 Windows 机器上，Python 通常安装在 :file:`C:\\Python35` 位置，当然你可以在运行安装向导时修改此值。要想把此目录添加到你的 PATH 环境变量中，你可以在 DOS 窗口中输入以下命令::
 22 | 
 23 |    set path=%path%;C:\python35
 24 | 
 25 | 通常你可以在主窗口输入一个文件结束符（Unix 系统是 :kbd:`Control-D`，Windows 系统是 :kbd:`Control-Z`）让解释器以 0 状态码退出。如果那没有作用，你可以通过输入 ``quit()`` 命令退出解释器。
 26 | 
 27 | Python 解释器具有简单的行编辑功能。在 Unix 系统上，任何 Python 解释器都可能已经添加了 GNU readline 库支持，这样就具备了精巧的交互编辑和历史记录等功能。在 Python 主窗口中输入 Control-P 可能是检查是否支持命令行编辑的最简单的方法。如果发出嘟嘟声（计算机扬声器），则说明你可以使用命令行编辑功能；更多快捷键的介绍请参考 :ref:`tut-interacting`。如果没有任何声音，或者显示 ``^P`` 字符，则说明命令行编辑功能不可用；你只能通过退格键从当前行删除已键入的字符并重新输入。
 28 | 
 29 | Python 解释器有些操作类似 Unix shell：当使用终端设备（tty）作为标准输入调用时，它交互的解释并执行命令；当使用文件名参数或以文件作为标准输入调用时，它读取文件并将文件作为 *脚本* 执行。
 30 | 
 31 | 第二种启动 Python 解释器的方法是 ``python -c command [arg] ...``，这种方法可以在 *命令行* 执行 Python 语句，类似于 shell 中的 `-c`_ 选项。由于 Python 语句通常会包含空格或其他特殊 shell 字符，一般建议将 *命令* 用单引号包裹起来。
 32 | 
 33 | 有一些 Python 模块也可以当作脚本使用。你可以使用 ``python -m module [arg] ...`` 命令调用它们，这类似在命令行中键入完整的路径名执行 *模块* 源文件一样。
 34 | 
 35 | 使用脚本文件时，经常会运行脚本然后进入交互模式。这也可以通过在脚本之前加上 `-i`_ 参数来实现。
 36 | 
 37 | 
 38 | .. _tut-argpassing:
 39 | 
 40 | 参数传递
 41 | ----------------
 42 | 
 43 | 调用解释器时，脚本名和附加参数传入一个名为 ``sys.argv`` 的字符串列表。你能够获取这个列表通过执行 ``import
 44 | sys``，列表的长度大于等于1；没有给定脚本和参数时，它至少也有一个元素：``sys.argv[0]`` 此时为空字符串。脚本名指定为 ``'-'`` （表示标准输入）时， ``sys.argv[0]`` 被设定为 ``'-'``，使用 `-c`_ *指令* 时，``sys.argv[0]`` 被设定为 ``'-c'``。使用 `-m`_ *模块* 参数时，``sys.argv[0]`` 被设定为指定模块的全名。`-c`_ *指令* 或者 `-m`_ *模块* 之后的参数不会被 Python 解释器的选项处理机制所截获，而是留在 ``sys.argv`` 中，供脚本命令操作。
 45 | 
 46 | 
 47 | .. _tut-interactive:
 48 | 
 49 | 交互模式
 50 | ----------------
 51 | 
 52 | 从 tty 读取命令时，我们称解释器工作于 *交互模式*。这种模式下它根据主提示符来执行，主提示符通常标识为三个大于号(``>>>``)；继续的部分被称为 *从属提示符*，由三个点标识(``...``)。在第一行之前，解释器打印欢迎信息、版本号和授权提示::
 53 | 
 54 |    $ python3.5
 55 |    Python 3.5.2 (default, Mar 16 2014, 09:25:04)
 56 |    [GCC 4.8.2] on linux
 57 |    Type "help", "copyright", "credits" or "license" for more information.
 58 |    >>>
 59 | 
 60 | .. XXX update for new releases
 61 | 
 62 | 输入多行结构时需要从属提示符了，例如，下面这个 `if`_ 语句::
 63 | 
 64 |    >>> the_world_is_flat = 1
 65 |    >>> if the_world_is_flat:
 66 |    ...     print("Be careful not to fall off!")
 67 |    ...
 68 |    Be careful not to fall off!
 69 | 
 70 | 
 71 | 关于交互模式更多的内容，请参见 :ref:`tut-interac`。
 72 | 
 73 | 
 74 | .. _tut-interp:
 75 | 
 76 | 解释器及其环境
 77 | ===================================
 78 | 
 79 | .. _tut-source-encoding:
 80 | 
 81 | 源程序编码
 82 | --------------------
 83 | 
 84 | 默认情况下，Python 源文件是 UTF-8 编码。在此编码下，全世界大多数语言的字符可以同时用在字符串、标识符和注释中 — 尽管 Python 标准库仅使用 ASCII 字符做为标识符，这只是任何可移植代码应该遵守的约定。如果要正确的显示所有的字符，你的编辑器必须能识别出文件是 UTF-8 编码，并且它使用的字体能支持文件中所有的字符。
 85 | 
 86 | 你也可以为源文件指定不同的字符编码。为此，在 ``#!`` 行（首行）后插入至少一行特殊的注释行来定义源文件的编码::
 87 | 
 88 |    # -*- coding: encoding -*-
 89 | 
 90 | 通过此声明，源文件中所有的东西都会被当做用 *encoding* 指代的 UTF-8 编码对待。在 Python 库参考手册 `codecs`_ 一节中你可以找到一张可用的编码列表。
 91 | 
 92 | 例如，如果你的编辑器不支持 UTF-8 编码的文件，但支持像 Windows-1252 的其他一些编码，你可以定义::
 93 | 
 94 |    # -*- coding: cp-1252 -*-
 95 | 
 96 | 这样就可以在源文件中使用 Windows-1252 字符集中的所有字符了。这个特殊的编码注释必须在文件中的 *第一或第二* 行定义。
 97 | 
 98 | 
 99 | 
100 | .. rubric:: Footnotes
101 | 
102 | .. [#] 在 Unix 系统上，Python 3.X 解释器默认未被安装成名为 ``python`` 的命令，所以它不会与同时安装在系统中的 Python 2.x 命令冲突。
103 | 
104 | 
105 | 
106 | .. _-c: https://docs.python.org/3/using/cmdline.html#cmdoption-c
107 | .. _-i: https://docs.python.org/3/using/cmdline.html#cmdoption-i
108 | .. _-m: https://docs.python.org/3/using/cmdline.html#cmdoption-m
109 | .. _if: https://docs.python.org/3/reference/compound_stmts.html#if
110 | .. _codecs: https://docs.python.org/3/library/codecs.html#module-codecs
111 | 


--------------------------------------------------------------------------------
/docs/build/html/_sources/venv.rst.txt:
--------------------------------------------------------------------------------
  1 | 
  2 | .. _tut-venv:
  3 | 
  4 | *********************************
  5 | 虚拟环境和包
  6 | *********************************
  7 | 
  8 | 简介
  9 | ============
 10 | 
 11 | Python 应用程序经常会使用一些不属于标准库的包和模块。应用程序有时候需要某个特定版本的库，因为它需要一个特定的 bug 已得到修复的库或者它是使用了一个过时版本的库的接口编写的。
 12 | 
 13 | 这就意味着可能无法安装一个 Python 来满足每个应用程序的要求。如果应用程序 A 需要一个特定模块的 1.0 版本但是应用程序 B 需要该模块的 2.0 版本，这两个应用程序的要求是冲突的，安装版本 1.0 或者版本 2.0 将会导致其中一个应用程序不能运行。
 14 | 
 15 | 这个问题的解决方案就是创建一个 `虚拟环境 <https://docs.python.org/3/glossary.html#term-virtual-environment>`_ （通常简称为 “virtualenv”），包含一个特定版本的 Python，以及一些附加的包的独立的目录树。
 16 | 
 17 | 不同的应用程序可以使用不同的虚拟环境。为了解决前面例子中的冲突，应用程序 A 可以有自己的虚拟环境，其中安装了特定模块的 1.0 版本。而应用程序 B 拥有另外一个安装了特定模块 2.0 版本的虚拟环境。如果应用程序 B 需求一个库升级到 3.0 的话，这也不会影响到应用程序 A 的环境。
 18 | 
 19 | 
 20 | 创建虚拟环境
 21 | =============================
 22 | 
 23 | 用于创建和管理虚拟环境的脚本叫做 :program:`pyvenv`。:program:`pyvenv` 通常会安装你可用的 Python 中最新的版本。这个脚本也能指定安装一个特定的版本的 Python，因此如果在你的系统中有多个版本的 Python 的话，你可以运行 ``pyvenv-3.5`` 或者你想要的任何版本来选择一个指定的 Python 版本。
 24 | 
 25 | 要创建一个 virtualenv，首先决定一个你想要存放的目录接着运行 :program:`pyvenv` 后面携带着目录名::
 26 | 
 27 |    pyvenv tutorial-env
 28 | 
 29 | 如果目录不存在的话，这将会创建一个 ``tutorial-env`` 目录，并且也在目录里面创建一个包含 Python 解释器，标准库，以及各种配套文件的 Python “副本”。
 30 | 
 31 | 一旦你已经创建了一个虚拟环境，你必须激活它。
 32 | 
 33 | 在 Windows 上，运行::
 34 | 
 35 |   tutorial-env/Scripts/activate
 36 | 
 37 | 在 Unix 或者 MacOS 上，运行::
 38 | 
 39 |   source tutorial-env/bin/activate
 40 | 
 41 | （这个脚本是用 bash shell 编写的。如果你使用 :program:`csh` 或者 :program:`fish` shell，你应该使用 ``activate.csh`` 和 ``activate.fish`` 来替代。）
 42 | 
 43 | 激活了虚拟环境会改变你的 shell 提示符，显示你正在使用的虚拟环境，并且修改了环境以致运行 ``python`` 将会让你得到了特定的 Python 版本。例如::
 44 | 
 45 |   -> source ~/envs/tutorial-env/bin/activate
 46 |   (tutorial-env) -> python
 47 |   Python 3.5.2+ (3.4:c7b9645a6f35+, May 22 2015, 09:31:25)
 48 |     ...
 49 |   >>> import sys
 50 |   >>> sys.path
 51 |   ['', '/usr/local/lib/python35.zip', ...,
 52 |   '~/envs/tutorial-env/lib/python3.5/site-packages']
 53 |   >>>
 54 | 
 55 | 
 56 | 使用 pip 管理包
 57 | ==========================
 58 | 
 59 | 一旦你激活了一个虚拟环境，可以使用一个叫做 :program:`pip` 程序来安装，升级以及删除包。默认情况下 ``pip`` 将会从 Python Package Index，<https://pypi.python.org/pypi>， 中安装包。你可以通过 web 浏览器浏览它们，或者你也能使用 ``pip`` 有限的搜索功能::
 60 | 
 61 |   (tutorial-env) -> pip search astronomy
 62 |   skyfield               - Elegant astronomy for Python
 63 |   gary                   - Galactic astronomy and gravitational dynamics.
 64 |   novas                  - The United States Naval Observatory NOVAS astronomy library
 65 |   astroobs               - Provides astronomy ephemeris to plan telescope observations
 66 |   PyAstronomy            - A collection of astronomy related tools for Python.
 67 |   ...
 68 | 
 69 | ``pip`` 有许多子命令：“搜索”，“安装”，“卸载”，“freeze”（译者注：这个词语暂时没有合适的词语来翻译），等等。（请参考 `installing-index <https://docs.python.org/3/installing/index.html#installing-index>`_ 指南获取 ``pip`` 更多完整的文档。）
 70 | 
 71 | 你可以安装一个包最新的版本，通过指定包的名称::
 72 | 
 73 |   -> pip install novas
 74 |   Collecting novas
 75 |     Downloading novas-3.1.1.3.tar.gz (136kB)
 76 |   Installing collected packages: novas
 77 |     Running setup.py install for novas
 78 |   Successfully installed novas-3.1.1.3
 79 | 
 80 | 你也能安装一个指定版本的包，通过给出包名后面紧跟着 ``==`` 和版本号::
 81 | 
 82 |   -> pip install requests==2.6.0
 83 |   Collecting requests==2.6.0
 84 |     Using cached requests-2.6.0-py2.py3-none-any.whl
 85 |   Installing collected packages: requests
 86 |   Successfully installed requests-2.6.0
 87 | 
 88 | 如果你重新运行命令（pip install requests==2.6.0），``pip`` 会注意到要求的版本已经安装，不会去做任何事情。你也可以提供一个不同的版本号来安装，或者运行 ``pip
 89 | install --upgrade`` 来升级包到最新版本::
 90 | 
 91 |   -> pip install --upgrade requests
 92 |   Collecting requests
 93 |   Installing collected packages: requests
 94 |     Found existing installation: requests 2.6.0
 95 |       Uninstalling requests-2.6.0:
 96 |         Successfully uninstalled requests-2.6.0
 97 |   Successfully installed requests-2.7.0
 98 | 
 99 | ``pip uninstall`` 后跟一个或者多个包名将会从虚拟环境中移除这些包。
100 | 
101 | ``pip show`` 将会显示一个指定的包的信息::
102 | 
103 |   (tutorial-env) -> pip show requests
104 |   ---
105 |   Metadata-Version: 2.0
106 |   Name: requests
107 |   Version: 2.7.0
108 |   Summary: Python HTTP for Humans.
109 |   Home-page: http://python-requests.org
110 |   Author: Kenneth Reitz
111 |   Author-email: me@kennethreitz.com
112 |   License: Apache 2.0
113 |   Location: /Users/akuchling/envs/tutorial-env/lib/python3.4/site-packages
114 |   Requires:
115 | 
116 | ``pip list`` 将会列出所有安装在虚拟环境中的包::
117 | 
118 |   (tutorial-env) -> pip list
119 |   novas (3.1.1.3)
120 |   numpy (1.9.2)
121 |   pip (7.0.3)
122 |   requests (2.7.0)
123 |   setuptools (16.0)
124 |  
125 | ``pip freeze`` 将会生成一个类似需要安装的包的列表，但是输出采用了 ``pip install`` 期望的格式。常见的做法就是把它们放在一个 ``requirements.txt`` 文件::
126 | 
127 |   (tutorial-env) -> pip freeze > requirements.txt
128 |   (tutorial-env) -> cat requirements.txt
129 |   novas==3.1.1.3
130 |   numpy==1.9.2
131 |   requests==2.7.0
132 | 
133 | ``requirements.txt`` 能够被提交到版本控制中并且作为一个应用程序的一部分。用户们可以使用 ``install -r`` 安装所有必须的包::
134 | 
135 |   -> pip install -r requirements.txt
136 |   Collecting novas==3.1.1.3 (from -r requirements.txt (line 1))
137 |     ...
138 |   Collecting numpy==1.9.2 (from -r requirements.txt (line 2))
139 |     ...
140 |   Collecting requests==2.7.0 (from -r requirements.txt (line 3))
141 |     ...
142 |   Installing collected packages: novas, numpy, requests
143 |     Running setup.py install for novas
144 |   Successfully installed novas-3.1.1.3 numpy-1.9.2 requests-2.7.0
145 | 
146 | ``pip`` 还有更多的选项。请参考 `installing-index <https://docs.python.org/3/installing/index.html#installing-index>`_ 指南获取关于 ``pip`` 完整的文档。当你编写一个包并且在 Python Package Index 中也出现的话，请参考 `distributing-index <https://docs.python.org/3/distributing/index.html#distributing-index>`_ 指南。
147 | 


--------------------------------------------------------------------------------
/docs/build/html/_sources/whatnow.rst.txt:
--------------------------------------------------------------------------------
 1 | .. _tut-whatnow:
 2 | 
 3 | *********
 4 | 接下来？
 5 | *********
 6 | 
 7 | 读过这本指南应该会让你有兴趣使用 Python —— 可能你已经期待着用 Python 解决你的实际问题了。可以在哪里进行一步学习？ 
 8 | 
 9 | 入门指南是 Python 文档集的一部分。其中的另一些文档包括：
10 | 
11 | * `Python 标准库 <https://docs.python.org/3/library/index.html#library-index>`_：
12 | 
13 |   应该浏览一下这份文档，它为标准库中的类型、函数和模块提供了完整（尽管很简略）的参考资料。标准的 Python 发布版包括了 大量 的附加模块。其中有针对读取 Unix 邮箱、接收 HTTP 文档、生成随机数、解析命令行选项、写 CGI 程序、压缩数据以及很多其它任务的模块。略读一下库参考会给你很多解决问题的思路。
14 | 
15 | * `安装 Python 模块 <https://docs.python.org/3/installing/index.html#installing-index>`_ 展示了如何安装其他 Python 用户编写的附加模块。
16 | 
17 | * `Python 语言参考 <https://docs.python.org/3/reference/index.html#reference-index>`_： 詳細说明了 Python 语法和语义。
18 |   
19 |   它读起来很累，不过对于语言本身，有份完整的手册很有用。
20 | 
21 | 其它 Python 资源：
22 | 
23 | * http://www.python.org： Python 官方网站。它包含代码、文档和 Web 上与 Python 有关的页面链接该网站镜像于全世界的几处其它问题，类似欧洲、日本和澳大利亚。
24 |   
25 |   镜像可能会比主站快，这取决于你的地理位置。
26 | 
27 | * http://docs.python.org： 快速访问 Python 的文档。
28 | 
29 | * http://pypi.python.org： Python 包索引，以前昵称为奶酪店，索引了可供下载的，用户创建的 Python 模块。如果你发布了代码，可以注册到这里，这样别人可以找到它。
30 | 
31 | * http://code.activestate.com/recipes/langs/python/： Python 食谱是大量的示例代码、大型的集合，和有用的脚本。
32 |   
33 |   值得关注的是这次资源已经结集成书，名为《Python 食谱》（O’Reilly & Associates, ISBN 0-596-00797-3。）
34 | 
35 | * http://scipy.org: The Scientific Python 项目包括数组快速计算和处理模块，和大量线性代数、傅里叶变换、非线性solvers、随机数分布，统计分析以及类似的包。
36 | 
37 | 与 Python 有关的问题，以及问题报告，可以发到新闻组 :newsgroup:`comp.lang.python` ，或者发送到邮件组 python-list@python.org 。新闻组和邮件组是开放的，所以发送的消息可以自动的跟到另一个之后。每天有超过 120 个投递（高峰时有数百）,提问（以及回答）问题，为新功能提建议，发布新模块。在发信之前，请查阅 `常见问题
38 | <http://www.python.org/doc/faq/>`_ (亦称 FAQ)，或者在 Python 源码发布包的 :file:`Misc/` 目录中查阅。邮件组也可以在 http://mail.python.org/pipermail/ 访问。FAQ回答了很多被反复提到的问题，很可能已经解答了你的问题。
39 | 
40 | .. Postings figure based on average of last six months activity as
41 |    最近六个月的提交数在 www.egroups.com 有报告；2000年六月：21272 封 / 182 天 ＝ 116.9 封／天，并且还在平稳的上升。（现在是多少？）
42 | 
43 | 
44 | 
45 | 


--------------------------------------------------------------------------------
/docs/build/html/_static/ajax-loader.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/html/_static/ajax-loader.gif


--------------------------------------------------------------------------------
/docs/build/html/_static/comment-bright.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/html/_static/comment-bright.png


--------------------------------------------------------------------------------
/docs/build/html/_static/comment-close.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/html/_static/comment-close.png


--------------------------------------------------------------------------------
/docs/build/html/_static/comment.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/html/_static/comment.png


--------------------------------------------------------------------------------
/docs/build/html/_static/css/badge_only.css:
--------------------------------------------------------------------------------
1 | .fa:before{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:before,.clearfix:after{display:table;content:""}.clearfix:after{clear:both}@font-face{font-family:FontAwesome;font-weight:normal;font-style:normal;src:url("../font/fontawesome_webfont.eot");src:url("../font/fontawesome_webfont.eot?#iefix") format("embedded-opentype"),url("../font/fontawesome_webfont.woff") format("woff"),url("../font/fontawesome_webfont.ttf") format("truetype"),url("../font/fontawesome_webfont.svg#FontAwesome") format("svg")}.fa:before{display:inline-block;font-family:FontAwesome;font-style:normal;font-weight:normal;line-height:1;text-decoration:inherit}a .fa{display:inline-block;text-decoration:inherit}li .fa{display:inline-block}li .fa-large:before,li .fa-large:before{width:1.875em}ul.fas{list-style-type:none;margin-left:2em;text-indent:-0.8em}ul.fas li .fa{width:0.8em}ul.fas li .fa-large:before,ul.fas li .fa-large:before{vertical-align:baseline}.fa-book:before{content:""}.icon-book:before{content:""}.fa-caret-down:before{content:""}.icon-caret-down:before{content:""}.fa-caret-up:before{content:""}.icon-caret-up:before{content:""}.fa-caret-left:before{content:""}.icon-caret-left:before{content:""}.fa-caret-right:before{content:""}.icon-caret-right:before{content:""}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;border-top:solid 10px #343131;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;z-index:400}.rst-versions a{color:#2980B9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27AE60;*zoom:1}.rst-versions .rst-current-version:before,.rst-versions .rst-current-version:after{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-versions .rst-current-version .fa{color:#fcfcfc}.rst-versions .rst-current-version .fa-book{float:left}.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#E74C3C;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#F1C40F;color:#000}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:gray;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:solid 1px #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px}.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge .fa-book{float:none}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book{float:left}.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge .rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width: 768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}img{width:100%;height:auto}}
2 | /*# sourceMappingURL=badge_only.css.map */
3 | 


--------------------------------------------------------------------------------
/docs/build/html/_static/doctools.js:
--------------------------------------------------------------------------------
  1 | /*
  2 |  * doctools.js
  3 |  * ~~~~~~~~~~~
  4 |  *
  5 |  * Sphinx JavaScript utilities for all documentation.
  6 |  *
  7 |  * :copyright: Copyright 2007-2017 by the Sphinx team, see AUTHORS.
  8 |  * :license: BSD, see LICENSE for details.
  9 |  *
 10 |  */
 11 | 
 12 | /**
 13 |  * select a different prefix for underscore
 14 |  */
 15 | $u = _.noConflict();
 16 | 
 17 | /**
 18 |  * make the code below compatible with browsers without
 19 |  * an installed firebug like debugger
 20 | if (!window.console || !console.firebug) {
 21 |   var names = ["log", "debug", "info", "warn", "error", "assert", "dir",
 22 |     "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace",
 23 |     "profile", "profileEnd"];
 24 |   window.console = {};
 25 |   for (var i = 0; i < names.length; ++i)
 26 |     window.console[names[i]] = function() {};
 27 | }
 28 |  */
 29 | 
 30 | /**
 31 |  * small helper function to urldecode strings
 32 |  */
 33 | jQuery.urldecode = function(x) {
 34 |   return decodeURIComponent(x).replace(/\+/g, ' ');
 35 | };
 36 | 
 37 | /**
 38 |  * small helper function to urlencode strings
 39 |  */
 40 | jQuery.urlencode = encodeURIComponent;
 41 | 
 42 | /**
 43 |  * This function returns the parsed url parameters of the
 44 |  * current request. Multiple values per key are supported,
 45 |  * it will always return arrays of strings for the value parts.
 46 |  */
 47 | jQuery.getQueryParameters = function(s) {
 48 |   if (typeof s === 'undefined')
 49 |     s = document.location.search;
 50 |   var parts = s.substr(s.indexOf('?') + 1).split('&');
 51 |   var result = {};
 52 |   for (var i = 0; i < parts.length; i++) {
 53 |     var tmp = parts[i].split('=', 2);
 54 |     var key = jQuery.urldecode(tmp[0]);
 55 |     var value = jQuery.urldecode(tmp[1]);
 56 |     if (key in result)
 57 |       result[key].push(value);
 58 |     else
 59 |       result[key] = [value];
 60 |   }
 61 |   return result;
 62 | };
 63 | 
 64 | /**
 65 |  * highlight a given string on a jquery object by wrapping it in
 66 |  * span elements with the given class name.
 67 |  */
 68 | jQuery.fn.highlightText = function(text, className) {
 69 |   function highlight(node, addItems) {
 70 |     if (node.nodeType === 3) {
 71 |       var val = node.nodeValue;
 72 |       var pos = val.toLowerCase().indexOf(text);
 73 |       if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) {
 74 |         var span;
 75 |         var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg");
 76 |         if (isInSVG) {
 77 |           span = document.createElementNS("http://www.w3.org/2000/svg", "tspan");
 78 |         } else {
 79 |           span = document.createElement("span");
 80 |           span.className = className;
 81 |         }
 82 |         span.appendChild(document.createTextNode(val.substr(pos, text.length)));
 83 |         node.parentNode.insertBefore(span, node.parentNode.insertBefore(
 84 |           document.createTextNode(val.substr(pos + text.length)),
 85 |           node.nextSibling));
 86 |         node.nodeValue = val.substr(0, pos);
 87 |         if (isInSVG) {
 88 |           var bbox = span.getBBox();
 89 |           var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect");
 90 |        	  rect.x.baseVal.value = bbox.x;
 91 |           rect.y.baseVal.value = bbox.y;
 92 |           rect.width.baseVal.value = bbox.width;
 93 |           rect.height.baseVal.value = bbox.height;
 94 |           rect.setAttribute('class', className);
 95 |           var parentOfText = node.parentNode.parentNode;
 96 |           addItems.push({
 97 |               "parent": node.parentNode,
 98 |               "target": rect});
 99 |         }
100 |       }
101 |     }
102 |     else if (!jQuery(node).is("button, select, textarea")) {
103 |       jQuery.each(node.childNodes, function() {
104 |         highlight(this, addItems);
105 |       });
106 |     }
107 |   }
108 |   var addItems = [];
109 |   var result = this.each(function() {
110 |     highlight(this, addItems);
111 |   });
112 |   for (var i = 0; i < addItems.length; ++i) {
113 |     jQuery(addItems[i].parent).before(addItems[i].target);
114 |   }
115 |   return result;
116 | };
117 | 
118 | /*
119 |  * backward compatibility for jQuery.browser
120 |  * This will be supported until firefox bug is fixed.
121 |  */
122 | if (!jQuery.browser) {
123 |   jQuery.uaMatch = function(ua) {
124 |     ua = ua.toLowerCase();
125 | 
126 |     var match = /(chrome)[ \/]([\w.]+)/.exec(ua) ||
127 |       /(webkit)[ \/]([\w.]+)/.exec(ua) ||
128 |       /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) ||
129 |       /(msie) ([\w.]+)/.exec(ua) ||
130 |       ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) ||
131 |       [];
132 | 
133 |     return {
134 |       browser: match[ 1 ] || "",
135 |       version: match[ 2 ] || "0"
136 |     };
137 |   };
138 |   jQuery.browser = {};
139 |   jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true;
140 | }
141 | 
142 | /**
143 |  * Small JavaScript module for the documentation.
144 |  */
145 | var Documentation = {
146 | 
147 |   init : function() {
148 |     this.fixFirefoxAnchorBug();
149 |     this.highlightSearchWords();
150 |     this.initIndexTable();
151 |     
152 |   },
153 | 
154 |   /**
155 |    * i18n support
156 |    */
157 |   TRANSLATIONS : {},
158 |   PLURAL_EXPR : function(n) { return n === 1 ? 0 : 1; },
159 |   LOCALE : 'unknown',
160 | 
161 |   // gettext and ngettext don't access this so that the functions
162 |   // can safely bound to a different name (_ = Documentation.gettext)
163 |   gettext : function(string) {
164 |     var translated = Documentation.TRANSLATIONS[string];
165 |     if (typeof translated === 'undefined')
166 |       return string;
167 |     return (typeof translated === 'string') ? translated : translated[0];
168 |   },
169 | 
170 |   ngettext : function(singular, plural, n) {
171 |     var translated = Documentation.TRANSLATIONS[singular];
172 |     if (typeof translated === 'undefined')
173 |       return (n == 1) ? singular : plural;
174 |     return translated[Documentation.PLURALEXPR(n)];
175 |   },
176 | 
177 |   addTranslations : function(catalog) {
178 |     for (var key in catalog.messages)
179 |       this.TRANSLATIONS[key] = catalog.messages[key];
180 |     this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')');
181 |     this.LOCALE = catalog.locale;
182 |   },
183 | 
184 |   /**
185 |    * add context elements like header anchor links
186 |    */
187 |   addContextElements : function() {
188 |     $('div[id] > :header:first').each(function() {
189 |       $('<a class="headerlink">\u00B6</a>').
190 |       attr('href', '#' + this.id).
191 |       attr('title', _('Permalink to this headline')).
192 |       appendTo(this);
193 |     });
194 |     $('dt[id]').each(function() {
195 |       $('<a class="headerlink">\u00B6</a>').
196 |       attr('href', '#' + this.id).
197 |       attr('title', _('Permalink to this definition')).
198 |       appendTo(this);
199 |     });
200 |   },
201 | 
202 |   /**
203 |    * workaround a firefox stupidity
204 |    * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075
205 |    */
206 |   fixFirefoxAnchorBug : function() {
207 |     if (document.location.hash)
208 |       window.setTimeout(function() {
209 |         document.location.href += '';
210 |       }, 10);
211 |   },
212 | 
213 |   /**
214 |    * highlight the search words provided in the url in the text
215 |    */
216 |   highlightSearchWords : function() {
217 |     var params = $.getQueryParameters();
218 |     var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : [];
219 |     if (terms.length) {
220 |       var body = $('div.body');
221 |       if (!body.length) {
222 |         body = $('body');
223 |       }
224 |       window.setTimeout(function() {
225 |         $.each(terms, function() {
226 |           body.highlightText(this.toLowerCase(), 'highlighted');
227 |         });
228 |       }, 10);
229 |       $('<p class="highlight-link"><a href="javascript:Documentation.' +
230 |         'hideSearchWords()">' + _('Hide Search Matches') + '</a></p>')
231 |           .appendTo($('#searchbox'));
232 |     }
233 |   },
234 | 
235 |   /**
236 |    * init the domain index toggle buttons
237 |    */
238 |   initIndexTable : function() {
239 |     var togglers = $('img.toggler').click(function() {
240 |       var src = $(this).attr('src');
241 |       var idnum = $(this).attr('id').substr(7);
242 |       $('tr.cg-' + idnum).toggle();
243 |       if (src.substr(-9) === 'minus.png')
244 |         $(this).attr('src', src.substr(0, src.length-9) + 'plus.png');
245 |       else
246 |         $(this).attr('src', src.substr(0, src.length-8) + 'minus.png');
247 |     }).css('display', '');
248 |     if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) {
249 |         togglers.click();
250 |     }
251 |   },
252 | 
253 |   /**
254 |    * helper function to hide the search marks again
255 |    */
256 |   hideSearchWords : function() {
257 |     $('#searchbox .highlight-link').fadeOut(300);
258 |     $('span.highlighted').removeClass('highlighted');
259 |   },
260 | 
261 |   /**
262 |    * make the url absolute
263 |    */
264 |   makeURL : function(relativeURL) {
265 |     return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL;
266 |   },
267 | 
268 |   /**
269 |    * get the current relative url
270 |    */
271 |   getCurrentURL : function() {
272 |     var path = document.location.pathname;
273 |     var parts = path.split(/\//);
274 |     $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() {
275 |       if (this === '..')
276 |         parts.pop();
277 |     });
278 |     var url = parts.join('/');
279 |     return path.substring(url.lastIndexOf('/') + 1, path.length - 1);
280 |   },
281 | 
282 |   initOnKeyListeners: function() {
283 |     $(document).keyup(function(event) {
284 |       var activeElementType = document.activeElement.tagName;
285 |       // don't navigate when in search box or textarea
286 |       if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT') {
287 |         switch (event.keyCode) {
288 |           case 37: // left
289 |             var prevHref = $('link[rel="prev"]').prop('href');
290 |             if (prevHref) {
291 |               window.location.href = prevHref;
292 |               return false;
293 |             }
294 |           case 39: // right
295 |             var nextHref = $('link[rel="next"]').prop('href');
296 |             if (nextHref) {
297 |               window.location.href = nextHref;
298 |               return false;
299 |             }
300 |         }
301 |       }
302 |     });
303 |   }
304 | };
305 | 
306 | // quick alias for translations
307 | _ = Documentation.gettext;
308 | 
309 | $(document).ready(function() {
310 |   Documentation.init();
311 | });


--------------------------------------------------------------------------------
/docs/build/html/_static/down-pressed.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/html/_static/down-pressed.png


--------------------------------------------------------------------------------
/docs/build/html/_static/down.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/html/_static/down.png


--------------------------------------------------------------------------------
/docs/build/html/_static/file.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/html/_static/file.png


--------------------------------------------------------------------------------
/docs/build/html/_static/fonts/FontAwesome.otf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/html/_static/fonts/FontAwesome.otf


--------------------------------------------------------------------------------
/docs/build/html/_static/fonts/fontawesome-webfont.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/html/_static/fonts/fontawesome-webfont.eot


--------------------------------------------------------------------------------
/docs/build/html/_static/fonts/fontawesome-webfont.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/html/_static/fonts/fontawesome-webfont.ttf


--------------------------------------------------------------------------------
/docs/build/html/_static/fonts/fontawesome-webfont.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/html/_static/fonts/fontawesome-webfont.woff


--------------------------------------------------------------------------------
/docs/build/html/_static/js/theme.js:
--------------------------------------------------------------------------------
 1 | $( document ).ready(function() {
 2 |     // Shift nav in mobile when clicking the menu.
 3 |     $(document).on('click', "[data-toggle='wy-nav-top']", function() {
 4 |       $("[data-toggle='wy-nav-shift']").toggleClass("shift");
 5 |       $("[data-toggle='rst-versions']").toggleClass("shift");
 6 |     });
 7 |     // Close menu when you click a link.
 8 |     $(document).on('click', ".wy-menu-vertical .current ul li a", function() {
 9 |       $("[data-toggle='wy-nav-shift']").removeClass("shift");
10 |       $("[data-toggle='rst-versions']").toggleClass("shift");
11 |     });
12 |     $(document).on('click', "[data-toggle='rst-current-version']", function() {
13 |       $("[data-toggle='rst-versions']").toggleClass("shift-up");
14 |     });  
15 |     // Make tables responsive
16 |     $("table.docutils:not(.field-list)").wrap("<div class='wy-table-responsive'></div>");
17 | });
18 | 
19 | window.SphinxRtdTheme = (function (jquery) {
20 |     var stickyNav = (function () {
21 |         var navBar,
22 |             win,
23 |             stickyNavCssClass = 'stickynav',
24 |             applyStickNav = function () {
25 |                 if (navBar.height() <= win.height()) {
26 |                     navBar.addClass(stickyNavCssClass);
27 |                 } else {
28 |                     navBar.removeClass(stickyNavCssClass);
29 |                 }
30 |             },
31 |             enable = function () {
32 |                 applyStickNav();
33 |                 win.on('resize', applyStickNav);
34 |             },
35 |             init = function () {
36 |                 navBar = jquery('nav.wy-nav-side:first');
37 |                 win    = jquery(window);
38 |             };
39 |         jquery(init);
40 |         return {
41 |             enable : enable
42 |         };
43 |     }());
44 |     return {
45 |         StickyNav : stickyNav
46 |     };
47 | }($));
48 | 


--------------------------------------------------------------------------------
/docs/build/html/_static/minus.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/html/_static/minus.png


--------------------------------------------------------------------------------
/docs/build/html/_static/plus.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/html/_static/plus.png


--------------------------------------------------------------------------------
/docs/build/html/_static/pygments.css:
--------------------------------------------------------------------------------
 1 | .highlight .hll { background-color: #ffffcc }
 2 | .highlight  { background: #eeffcc; }
 3 | .highlight .c { color: #408090; font-style: italic } /* Comment */
 4 | .highlight .err { border: 1px solid #FF0000 } /* Error */
 5 | .highlight .k { color: #007020; font-weight: bold } /* Keyword */
 6 | .highlight .o { color: #666666 } /* Operator */
 7 | .highlight .ch { color: #408090; font-style: italic } /* Comment.Hashbang */
 8 | .highlight .cm { color: #408090; font-style: italic } /* Comment.Multiline */
 9 | .highlight .cp { color: #007020 } /* Comment.Preproc */
10 | .highlight .cpf { color: #408090; font-style: italic } /* Comment.PreprocFile */
11 | .highlight .c1 { color: #408090; font-style: italic } /* Comment.Single */
12 | .highlight .cs { color: #408090; background-color: #fff0f0 } /* Comment.Special */
13 | .highlight .gd { color: #A00000 } /* Generic.Deleted */
14 | .highlight .ge { font-style: italic } /* Generic.Emph */
15 | .highlight .gr { color: #FF0000 } /* Generic.Error */
16 | .highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */
17 | .highlight .gi { color: #00A000 } /* Generic.Inserted */
18 | .highlight .go { color: #333333 } /* Generic.Output */
19 | .highlight .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */
20 | .highlight .gs { font-weight: bold } /* Generic.Strong */
21 | .highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */
22 | .highlight .gt { color: #0044DD } /* Generic.Traceback */
23 | .highlight .kc { color: #007020; font-weight: bold } /* Keyword.Constant */
24 | .highlight .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */
25 | .highlight .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */
26 | .highlight .kp { color: #007020 } /* Keyword.Pseudo */
27 | .highlight .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */
28 | .highlight .kt { color: #902000 } /* Keyword.Type */
29 | .highlight .m { color: #208050 } /* Literal.Number */
30 | .highlight .s { color: #4070a0 } /* Literal.String */
31 | .highlight .na { color: #4070a0 } /* Name.Attribute */
32 | .highlight .nb { color: #007020 } /* Name.Builtin */
33 | .highlight .nc { color: #0e84b5; font-weight: bold } /* Name.Class */
34 | .highlight .no { color: #60add5 } /* Name.Constant */
35 | .highlight .nd { color: #555555; font-weight: bold } /* Name.Decorator */
36 | .highlight .ni { color: #d55537; font-weight: bold } /* Name.Entity */
37 | .highlight .ne { color: #007020 } /* Name.Exception */
38 | .highlight .nf { color: #06287e } /* Name.Function */
39 | .highlight .nl { color: #002070; font-weight: bold } /* Name.Label */
40 | .highlight .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */
41 | .highlight .nt { color: #062873; font-weight: bold } /* Name.Tag */
42 | .highlight .nv { color: #bb60d5 } /* Name.Variable */
43 | .highlight .ow { color: #007020; font-weight: bold } /* Operator.Word */
44 | .highlight .w { color: #bbbbbb } /* Text.Whitespace */
45 | .highlight .mb { color: #208050 } /* Literal.Number.Bin */
46 | .highlight .mf { color: #208050 } /* Literal.Number.Float */
47 | .highlight .mh { color: #208050 } /* Literal.Number.Hex */
48 | .highlight .mi { color: #208050 } /* Literal.Number.Integer */
49 | .highlight .mo { color: #208050 } /* Literal.Number.Oct */
50 | .highlight .sa { color: #4070a0 } /* Literal.String.Affix */
51 | .highlight .sb { color: #4070a0 } /* Literal.String.Backtick */
52 | .highlight .sc { color: #4070a0 } /* Literal.String.Char */
53 | .highlight .dl { color: #4070a0 } /* Literal.String.Delimiter */
54 | .highlight .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */
55 | .highlight .s2 { color: #4070a0 } /* Literal.String.Double */
56 | .highlight .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */
57 | .highlight .sh { color: #4070a0 } /* Literal.String.Heredoc */
58 | .highlight .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */
59 | .highlight .sx { color: #c65d09 } /* Literal.String.Other */
60 | .highlight .sr { color: #235388 } /* Literal.String.Regex */
61 | .highlight .s1 { color: #4070a0 } /* Literal.String.Single */
62 | .highlight .ss { color: #517918 } /* Literal.String.Symbol */
63 | .highlight .bp { color: #007020 } /* Name.Builtin.Pseudo */
64 | .highlight .fm { color: #06287e } /* Name.Function.Magic */
65 | .highlight .vc { color: #bb60d5 } /* Name.Variable.Class */
66 | .highlight .vg { color: #bb60d5 } /* Name.Variable.Global */
67 | .highlight .vi { color: #bb60d5 } /* Name.Variable.Instance */
68 | .highlight .vm { color: #bb60d5 } /* Name.Variable.Magic */
69 | .highlight .il { color: #208050 } /* Literal.Number.Integer.Long */


--------------------------------------------------------------------------------
/docs/build/html/_static/up-pressed.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/html/_static/up-pressed.png


--------------------------------------------------------------------------------
/docs/build/html/_static/up.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/html/_static/up.png


--------------------------------------------------------------------------------
/docs/build/html/objects.inv:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/build/html/objects.inv


--------------------------------------------------------------------------------
/docs/html/.buildinfo:
--------------------------------------------------------------------------------
1 | # Sphinx build info version 1
2 | # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3 | config: b1a91b39ded23837a5135bfa0fbc7bee
4 | tags: 645f666f9bcd5a90fca523b33c5a78b7
5 | 


--------------------------------------------------------------------------------
/docs/html/_sources/appendix.rst.txt:
--------------------------------------------------------------------------------
 1 | .. _tut-appendix:
 2 | 
 3 | ********
 4 | 附录
 5 | ********
 6 | 
 7 | 
 8 | .. _tut-interac:
 9 | 
10 | 交互模式
11 | ================
12 | 
13 | .. _tut-error:
14 | 
15 | 错误处理
16 | --------------
17 | 
18 | 当错误发生时，解释器打印一个错误信息和堆栈跟踪。在交互模式下，它返回主提示符；当输入来自文件的时候，在打印堆栈跟踪后以非零退出(a nonzero exit)状态退出。（在 `try <https://docs.python.org/3/reference/compound_stmts.html#try>`_ 声明中被 `except <https://docs.python.org/3/reference/compound_stmts.html#except>`_ 子句捕捉到的异常在这种情况下不是错误。）有些错误是非常致命的会导致一个非零状态的退出；这也适用于内部错误以及某些情况的内存耗尽。所有的错误信息都写入到标准错误流；来自执行的命令的普通输出写入到标准输出。
19 | 
20 | 输入中断符（通常是 Control-C 或者 DEL）到主或者从提示符中会取消输入并且返回到主提示。[#]_ 当命令执行中输入中断符会引起 `KeyboardInterrupt <https://docs.python.org/3/library/exceptions.html#KeyboardInterrupt>`_ 异常，这个异常能够被一个 `try <https://docs.python.org/3/reference/compound_stmts.html#try>`_ 声明处理。
21 | 
22 | 
23 | .. _tut-scripts:
24 | 
25 | 可执行 Python 脚本
26 | -------------------------
27 | 
28 | 在 BSD'ish Unix 系统上，Python 脚本可直接执行，像 shell 脚本一样，只需要把下面内容加入到 ::
29 | 
30 |    #!/usr/bin/env python3.5
31 | 
32 | （假设 python 解释器在用户的 :envvar:`PATH` 中）脚本的开头，并给予该文件的可执行模式。``#!`` 必须是文件的头两个字符。在一些系统上，第一行必须以 Unix-style 的行结束符（``'\n'``）结束，不能以 Windows 的行结束符（``'\r\n'``）。 注意 ``'#'`` 在 Python 中是用于注释的。
33 | 
34 | 使用 :program:`chmod` 命令能够给予脚本执行模式或者权限。
35 | 
36 | .. code-block:: bash
37 | 
38 |    $ chmod +x myscript.py
39 | 
40 | 在 Windows 系统上，没有一个 “可执行模式” 的概念。Python 安装器会自动地把 ``.py``  文件和 ``python.exe`` 关联起来，因此双击 Python 将会把它当成一个脚本运行。文件扩展名也可以是 ``.pyw``，在这种情况下，运行时不会出现控制台窗口。
41 | 
42 | 
43 | .. _tut-startup:
44 | 
45 | 交互式启动文件
46 | ----------------------------
47 | 
48 | 当你使用交互式 Python 的时候，它常常很方便地执行一些命令在每次解释器启动时。你可以这样做：设置一个名为 `PYTHONSTARTUP <https://docs.python.org/3/using/cmdline.html#envvar-PYTHONSTARTUP>`_ 的环境变量为包含你的启动命令的文件名。这跟 Unix shells 的 :file:`.profile` 特点有些类似。
49 | 
50 | 这个文件在交互式会话中是只读的，在当 Python 从脚本中读取命令，以及在当 :file:`/dev/tty` 被作为明确的命令源的时候不只是可读的。该文件在交互式命令被执行的时候在相同的命名空间中能够被执行，因此在交互式会话中定义或者导入的对象能够无需授权就能使用。你也能在文件中更改提示 ``sys.ps1`` 和 ``sys.ps2``。
51 | 
52 | 如果你想要从当前目录中读取一个附加的启动文件，你可以在全局启动文件中编写代码像这样：``if
53 | os.path.isfile('.pythonrc.py'): exec(open('.pythonrc.py').read())``。如果你想要在脚本中使用启动文件的话，你必须在脚本中明确要这么做::
54 | 
55 |    import os
56 |    filename = os.environ.get('PYTHONSTARTUP')
57 |    if filename and os.path.isfile(filename):
58 |        with open(filename) as fobj:
59 |           startup_file = fobj.read()
60 |        exec(startup_file)
61 | 
62 | 
63 | .. _tut-customize:
64 | 
65 | 定制模块
66 | -------------------------
67 | 
68 | Python 提供两个钩子为了让你们定制 :mod:`sitecustomize` 和 :mod:`usercustomize`。为了看看它的工作机制的话，你必须首先找到你的用户 site-packages 目录的位置。启动 Python 并且运行这段代码::
69 | 
70 |    >>> import site
71 |    >>> site.getusersitepackages()
72 |    '/home/user/.local/lib/python3.4/site-packages'
73 | 
74 | 现在你可以创建一个名为 :file:`usercustomize.py` 的文件在你的用户 site-packages 目录，并且在里面放置你想要的任何内容。它会影响 Python 的每一次调用，除非它以 `-s <https://docs.python.org/3/using/cmdline.html#cmdoption-s>`_ （禁用自动导入）选项启动。
75 | 
76 | :mod:`sitecustomize` 以同样地方式工作，但是通常由是机器的管理员创建在全局的 site-packages 目录中，并且是在 :mod:`usercustomize` 之前导入。请参阅 `site <https://docs.python.org/3/library/site.html#module-site>`_ 模块获取更多信息。
77 | 
78 | 
79 | .. rubric:: Footnotes
80 | 
81 | .. [#] GNU 的 Readline 包的问题可能会阻止这种做法。
82 | 


--------------------------------------------------------------------------------
/docs/html/_sources/appendix.txt:
--------------------------------------------------------------------------------
 1 | .. _tut-appendix:
 2 | 
 3 | ********
 4 | 附录
 5 | ********
 6 | 
 7 | 
 8 | .. _tut-interac:
 9 | 
10 | 交互模式
11 | ================
12 | 
13 | .. _tut-error:
14 | 
15 | 错误处理
16 | --------------
17 | 
18 | 当错误发生时，解释器打印一个错误信息和堆栈跟踪。在交互模式下，它返回主提示符；当输入来自文件的时候，在打印堆栈跟踪后以非零退出(a nonzero exit)状态退出。（在 `try <https://docs.python.org/3/reference/compound_stmts.html#try>`_ 声明中被 `except <https://docs.python.org/3/reference/compound_stmts.html#except>`_ 子句捕捉到的异常在这种情况下不是错误。）有些错误是非常致命的会导致一个非零状态的退出；这也适用于内部错误以及某些情况的内存耗尽。所有的错误信息都写入到标准错误流；来自执行的命令的普通输出写入到标准输出。
19 | 
20 | 输入中断符（通常是 Control-C 或者 DEL）到主或者从提示符中会取消输入并且返回到主提示。[#]_ 当命令执行中输入中断符会引起 `KeyboardInterrupt <https://docs.python.org/3/library/exceptions.html#KeyboardInterrupt>`_ 异常，这个异常能够被一个 `try <https://docs.python.org/3/reference/compound_stmts.html#try>`_ 声明处理。
21 | 
22 | 
23 | .. _tut-scripts:
24 | 
25 | 可执行 Python 脚本
26 | -------------------------
27 | 
28 | 在 BSD'ish Unix 系统上，Python 脚本可直接执行，像 shell 脚本一样，只需要把下面内容加入到 ::
29 | 
30 |    #!/usr/bin/env python3.5
31 | 
32 | （假设 python 解释器在用户的 :envvar:`PATH` 中）脚本的开头，并给予该文件的可执行模式。``#!`` 必须是文件的头两个字符。在一些系统上，第一行必须以 Unix-style 的行结束符（``'\n'``）结束，不能以 Windows 的行结束符（``'\r\n'``）。 注意 ``'#'`` 在 Python 中是用于注释的。
33 | 
34 | 使用 :program:`chmod` 命令能够给予脚本执行模式或者权限。
35 | 
36 | .. code-block:: bash
37 | 
38 |    $ chmod +x myscript.py
39 | 
40 | 在 Windows 系统上，没有一个 “可执行模式” 的概念。Python 安装器会自动地把 ``.py``  文件和 ``python.exe`` 关联起来，因此双击 Python 将会把它当成一个脚本运行。文件扩展名也可以是 ``.pyw``，在这种情况下，运行时不会出现控制台窗口。
41 | 
42 | 
43 | .. _tut-startup:
44 | 
45 | 交互式启动文件
46 | ----------------------------
47 | 
48 | 当你使用交互式 Python 的时候，它常常很方便地执行一些命令在每次解释器启动时。你可以这样做：设置一个名为 `PYTHONSTARTUP <https://docs.python.org/3/using/cmdline.html#envvar-PYTHONSTARTUP>`_ 的环境变量为包含你的启动命令的文件名。这跟 Unix shells 的 :file:`.profile` 特点有些类似。
49 | 
50 | 这个文件在交互式会话中是只读的，在当 Python 从脚本中读取命令，以及在当 :file:`/dev/tty` 被作为明确的命令源的时候不只是可读的。该文件在交互式命令被执行的时候在相同的命名空间中能够被执行，因此在交互式会话中定义或者导入的对象能够无需授权就能使用。你也能在文件中更改提示 ``sys.ps1`` 和 ``sys.ps2``。
51 | 
52 | 如果你想要从当前目录中读取一个附加的启动文件，你可以在全局启动文件中编写代码像这样：``if
53 | os.path.isfile('.pythonrc.py'): exec(open('.pythonrc.py').read())``。如果你想要在脚本中使用启动文件的话，你必须在脚本中明确要这么做::
54 | 
55 |    import os
56 |    filename = os.environ.get('PYTHONSTARTUP')
57 |    if filename and os.path.isfile(filename):
58 |        with open(filename) as fobj:
59 |           startup_file = fobj.read()
60 |        exec(startup_file)
61 | 
62 | 
63 | .. _tut-customize:
64 | 
65 | 定制模块
66 | -------------------------
67 | 
68 | Python 提供两个钩子为了让你们定制 :mod:`sitecustomize` 和 :mod:`usercustomize`。为了看看它的工作机制的话，你必须首先找到你的用户 site-packages 目录的位置。启动 Python 并且运行这段代码::
69 | 
70 |    >>> import site
71 |    >>> site.getusersitepackages()
72 |    '/home/user/.local/lib/python3.4/site-packages'
73 | 
74 | 现在你可以创建一个名为 :file:`usercustomize.py` 的文件在你的用户 site-packages 目录，并且在里面放置你想要的任何内容。它会影响 Python 的每一次调用，除非它以 `-s <https://docs.python.org/3/using/cmdline.html#cmdoption-s>`_ （禁用自动导入）选项启动。
75 | 
76 | :mod:`sitecustomize` 以同样地方式工作，但是通常由是机器的管理员创建在全局的 site-packages 目录中，并且是在 :mod:`usercustomize` 之前导入。请参阅 `site <https://docs.python.org/3/library/site.html#module-site>`_ 模块获取更多信息。
77 | 
78 | 
79 | .. rubric:: Footnotes
80 | 
81 | .. [#] GNU 的 Readline 包的问题可能会阻止这种做法。
82 | 


--------------------------------------------------------------------------------
/docs/html/_sources/appetite.rst.txt:
--------------------------------------------------------------------------------
 1 | .. _tut-intro:
 2 | 
 3 | **********************
 4 | 开胃菜
 5 | **********************
 6 | 
 7 | 如果你要用计算机做很多工作，最后你会发现有一些任务你更希望用自动化的方式进行处理。比如，你想要在大量的文本文件中执行查找/替换，或者以复杂的方式对大量的图片进行重命名和整理。也许你想要编写一个小型的自定义数据库、一个特殊的 GUI 应用程序或一个简单的小游戏。
 8 | 
 9 | 如果你是一名专业的软件开发者，可能你必须使用几种 C/C++/JAVA 类库，并且发现通常编写/编译/测试/重新编译的周期是如此漫长。也许你正在为这些类库编写测试用例，但是发现这是一个让人烦躁的工作。又或者你已经完成了一个可以使用扩展语言的程序，但你并不想为此重新设计并实现一套全新的语言。
10 | 
11 | 那么 Python 正是你所需要的语言。
12 | 
13 | 虽然你能够通过编写 Unix shell 脚本或 Windows 批处理文件来处理其中的某些任务，但 Shell 脚本更适合移动文件或修改文本数据，并不适合编写 GUI 应用程序或游戏；虽然你能够使用 C/C++/JAVA 编写程序，但即使编写一个简单的 first-draft 程序也有可能耗费大量的开发时间。相比之下，Python 更易于使用，无论在 Windows、Mac OS X 或 Unix 操作系统上它都会帮助你更快地完成任务。
14 | 
15 | 虽然 Python 易于使用，但它却是一门完整的编程语言；与 Shell 脚本或批处理文件相比，它为编写大型程序提供了更多的结构和支持。另一方面，Python 提供了比 C 更多的错误检查，并且作为一门 *高级语言*，它内置支持高级的数据结构类型，例如：灵活的数组和字典。因其更多的通用数据类型，Python 比 Awk 甚至 Perl 都适用于更多问题领域，至少大多数事情在 Python 中与其他语言同样简单。
16 | 
17 | Python 允许你将程序分割为不同的模块，以便在其他的 Python 程序中重用。Python 内置提供了大量的标准模块，你可以将其用作程序的基础，或者作为学习 Python 编程的示例。这些模块提供了诸如文件 I/O、系统调用、Socket 支持，甚至类似 Tk 的用户图形界面（GUI）工具包接口。
18 | 
19 | Python 是一门解释型语言，因为无需编译和链接，你可以在程序开发中节省宝贵的时间。Python 解释器可以交互的使用，这使得试验语言的特性、编写临时程序或在自底向上的程序开发中测试方法非常容易。你甚至还可以把它当做一个桌面计算器。
20 | 
21 | Python 让程序编写的紧凑和可读。用 Python 编写的程序通常比同样的 C、C++ 或 Java 程序更短小，这是因为以下几个原因::
22 | 
23 | 	* 高级数据结构使你可以在一条语句中表达复杂的操作；
24 | 
25 | 	* 语句组使用缩进代替开始和结束大括号来组织；
26 | 
27 | 	* 变量或参数无需声明。
28 | 
29 | Python 是 *可扩展* 的：如果你会 C 语言编程便可以轻易地为解释器添加内置函数或模块，或者为了对性能瓶颈作优化，或者将 Python 程序与只有二进制形式的库（比如某个专业的商业图形库）连接起来。一旦你真正掌握了它，你可以将 Python 解释器集成进某个 C 应用程序，并把它当作那个程序的扩展或命令行语言。
30 | 
31 | 顺便说一句，这个语言的名字来自于 BBC 的 “Monty Python’s Flying Cirecus” 节目，和爬行类动物没有任何关系。在文档中引用 Monty Python 的典故不仅可行，而且值得鼓励！
32 | 
33 | 现在你已经为 Python 兴奋不已了吧，大概想要领略一些更多的细节！学习一门语言最好的方法就是使用它，本指南推荐你边读边使用 Python 解释器练习。
34 | 
35 | 下一节中，我们将解释 Python 解释器的用法。这是很简单的一件事情，但它有助于试验后面的例子。
36 | 
37 | 本手册剩下的部分将通过示例介绍 Python 语言及系统的诸多特性，开始是简单的语法、数据类型和表达式，接着介绍函数与模块，最后涉及异常和自定义类这样的高级内容。
38 | 


--------------------------------------------------------------------------------
/docs/html/_sources/appetite.txt:
--------------------------------------------------------------------------------
 1 | .. _tut-intro:
 2 | 
 3 | **********************
 4 | 开胃菜
 5 | **********************
 6 | 
 7 | 如果你要用计算机做很多工作，最后你会发现有一些任务你更希望用自动化的方式进行处理。比如，你想要在大量的文本文件中执行查找/替换，或者以复杂的方式对大量的图片进行重命名和整理。也许你想要编写一个小型的自定义数据库、一个特殊的 GUI 应用程序或一个简单的小游戏。
 8 | 
 9 | 如果你是一名专业的软件开发者，可能你必须使用几种 C/C++/JAVA 类库，并且发现通常编写/编译/测试/重新编译的周期是如此漫长。也许你正在为这些类库编写测试用例，但是发现这是一个让人烦躁的工作。又或者你已经完成了一个可以使用扩展语言的程序，但你并不想为此重新设计并实现一套全新的语言。
10 | 
11 | 那么 Python 正是你所需要的语言。
12 | 
13 | 虽然你能够通过编写 Unix shell 脚本或 Windows 批处理文件来处理其中的某些任务，但 Shell 脚本更适合移动文件或修改文本数据，并不适合编写 GUI 应用程序或游戏；虽然你能够使用 C/C++/JAVA 编写程序，但即使编写一个简单的 first-draft 程序也有可能耗费大量的开发时间。相比之下，Python 更易于使用，无论在 Windows、Mac OS X 或 Unix 操作系统上它都会帮助你更快地完成任务。
14 | 
15 | 虽然 Python 易于使用，但它却是一门完整的编程语言；与 Shell 脚本或批处理文件相比，它为编写大型程序提供了更多的结构和支持。另一方面，Python 提供了比 C 更多的错误检查，并且作为一门 *高级语言*，它内置支持高级的数据结构类型，例如：灵活的数组和字典。因其更多的通用数据类型，Python 比 Awk 甚至 Perl 都适用于更多问题领域，至少大多数事情在 Python 中与其他语言同样简单。
16 | 
17 | Python 允许你将程序分割为不同的模块，以便在其他的 Python 程序中重用。Python 内置提供了大量的标准模块，你可以将其用作程序的基础，或者作为学习 Python 编程的示例。这些模块提供了诸如文件 I/O、系统调用、Socket 支持，甚至类似 Tk 的用户图形界面（GUI）工具包接口。
18 | 
19 | Python 是一门解释型语言，因为无需编译和链接，你可以在程序开发中节省宝贵的时间。Python 解释器可以交互的使用，这使得试验语言的特性、编写临时程序或在自底向上的程序开发中测试方法非常容易。你甚至还可以把它当做一个桌面计算器。
20 | 
21 | Python 让程序编写的紧凑和可读。用 Python 编写的程序通常比同样的 C、C++ 或 Java 程序更短小，这是因为以下几个原因::
22 | 
23 | 	* 高级数据结构使你可以在一条语句中表达复杂的操作；
24 | 
25 | 	* 语句组使用缩进代替开始和结束大括号来组织；
26 | 
27 | 	* 变量或参数无需声明。
28 | 
29 | Python 是 *可扩展* 的：如果你会 C 语言编程便可以轻易地为解释器添加内置函数或模块，或者为了对性能瓶颈作优化，或者将 Python 程序与只有二进制形式的库（比如某个专业的商业图形库）连接起来。一旦你真正掌握了它，你可以将 Python 解释器集成进某个 C 应用程序，并把它当作那个程序的扩展或命令行语言。
30 | 
31 | 顺便说一句，这个语言的名字来自于 BBC 的 “Monty Python’s Flying Cirecus” 节目，和爬行类动物没有任何关系。在文档中引用 Monty Python 的典故不仅可行，而且值得鼓励！
32 | 
33 | 现在你已经为 Python 兴奋不已了吧，大概想要领略一些更多的细节！学习一门语言最好的方法就是使用它，本指南推荐你边读边使用 Python 解释器练习。
34 | 
35 | 下一节中，我们将解释 Python 解释器的用法。这是很简单的一件事情，但它有助于试验后面的例子。
36 | 
37 | 本手册剩下的部分将通过示例介绍 Python 语言及系统的诸多特性，开始是简单的语法、数据类型和表达式，接着介绍函数与模块，最后涉及异常和自定义类这样的高级内容。
38 | 


--------------------------------------------------------------------------------
/docs/html/_sources/floatingpoint.rst.txt:
--------------------------------------------------------------------------------
  1 | .. _tut-fp-issues:
  2 | 
  3 | **************************************************
  4 | 浮点数算法：争议和限制
  5 | **************************************************
  6 | 
  7 | .. sectionauthor:: Tim Peters <tim_one@users.sourceforge.net>
  8 | 
  9 | 
 10 | 浮点数在计算机中表达为二进制（binary）小数。例如：十进制小数::
 11 | 
 12 |    0.125
 13 | 
 14 | 是 1/10 + 2/100 + 5/1000 的值，同样二进制小数::
 15 | 
 16 |    0.001
 17 | 
 18 | 是 0/2 + 0/4 + 1/8。这两个数值相同。唯一的实质区别是第一个写为十进制小数记法，第二个是二进制。 
 19 | 
 20 | 不幸的是，大多数十进制小数不能完全用二进制小数表示。结果是，一般情况下，你输入的十进制浮点数仅由实际存储在计算机中的近似的二进制浮点数表示。
 21 | 
 22 | 这个问题更早的时候首先在十进制中发现。考虑小数形式的 1/3 ，你可以来个十进制的近似值。 ::
 23 | 
 24 |    0.3
 25 | 
 26 | 或者更进一步的, ::
 27 | 
 28 |    0.33
 29 | 
 30 | 或者更进一步的, ::
 31 | 
 32 |    0.333
 33 | 
 34 | 诸如此类。如果你写多少位，这个结果永远不是精确的 1/3 ，但是可以无限接近 1/3 。 
 35 | 
 36 | 同样，无论在二进制中写多少位，十进制数 0.1 都不能精确表达为二进制小数。二进制来表达 1/10 是一个无限循环小数::
 37 | 
 38 |    0.0001100110011001100110011001100110011001100110011...
 39 | 
 40 | 在任何有限数量的位停下来，你得到的都是近似值。今天在大多数机器上，浮点数的近似使用的小数以最高的 53 位为分子，2 的幂为分母。至于 1/10 这种情况，其二进制小数是  ``3602879701896397 / 2 ** 55``，它非常接近但不完全等于1/10真实的值。
 41 | 
 42 | 由于显示方式的原因，许多使用者意识不到是近似值。Python 只打印机器中存储的二进制值的十进制近似值。在大多数机器上，如果 Python 要打印 0.1 存储的二进制的真正近似值，将会显示::
 43 | 
 44 |    >>> 0.1
 45 |    0.1000000000000000055511151231257827021181583404541015625
 46 | 
 47 | 这么多位的数字对大多数人是没有用的，所以 Python 显示一个舍入的值 ::
 48 | 
 49 |    >>> 1 / 10
 50 |    0.1
 51 | 
 52 | 只要记住即使打印的结果看上去是精确的 1/10，真正存储的值是最近似的二进制小数。
 53 | 
 54 | 有趣地是，存在许多不同的十进制数共享着相同的近似二进制小数。例如，数字 ``0.1`` 和 ``0.10000000000000001`` 以及 ``0.1000000000000000055511151231257827021181583404541015625`` 都是 ``3602879701896397 / 2 ** 55`` 的近似值。因为所有这些十进制数共享相同的近似值，在保持恒等式 ``eval(repr(x)) == x`` 的同时，显示的可能是它们中的任何一个。
 55 | 
 56 | 历史上，Python 提示符和内置的 `repr() <https://docs.python.org/3/library/functions.html#repr>`_ 函数选择一个 17 位精度的数字，``0.10000000000000001``。从 Python 3.1 开始，Python（在大多数系统上）能够从这些数字当中选择最短的一个并简单地显示 ``0.1``。
 57 | 
 58 | 注意，这是二进制浮点数的自然性质：它不是 Python 中的一个 bug，也不是你的代码中的 bug。你会看到所有支持硬件浮点数算法的语言都会有这个现象（尽管有些语言默认情况下或者在所有输出模式下可能不会 *显示* 出差异）。
 59 | 
 60 | 为了输出更好看，你可能想用字符串格式化来生成固定位数的有效数字::
 61 | 
 62 |    >>> format(math.pi, '.12g')  # give 12 significant digits
 63 |    '3.14159265359'
 64 | 
 65 |    >>> format(math.pi, '.2f')   # give 2 digits after the point
 66 |    '3.14'
 67 | 
 68 |    >>> repr(math.pi)
 69 |    '3.141592653589793'
 70 | 
 71 | 认识到这，在真正意义上，是一种错觉是很重要的：你在简单地舍入真实机器值的 *显示*。
 72 | 
 73 | 例如，既然 0.1 不是精确的 1/10，3 个 0.1 的值相加可能也不会得到精确的 0.3::
 74 | 
 75 |    >>> .1 + .1 + .1 == .3
 76 |    False
 77 | 
 78 | 另外，既然 0.1 不能更接近 1/10 的精确值而且 0.3 不能更接近 3/10 的精确值，使用 `round() <https://docs.python.org/3/library/functions.html#round>`_ 函数提前舍入也没有帮助::
 79 | 
 80 |    >>> round(.1, 1) + round(.1, 1) + round(.1, 1) == round(.3, 1)
 81 |    False
 82 | 
 83 | 虽然这些数字不可能再更接近它们想要的精确值，`round() <https://docs.python.org/3/library/functions.html#round>`_  函数可以用于在计算之后进行舍入，这样的话不精确的结果就可以和另外一个相比较了::
 84 | 
 85 |     >>> round(.1 + .1 + .1, 10) == round(.3, 10)
 86 |     True
 87 | 
 88 | 二进制浮点数计算有很多这样意想不到的结果。“0.1”的问题在下面"误差的表示"一节中有准确详细的解释。更完整的常见怪异现象请参见 `浮点数的危险 <http://www.lahey.com/float.htm>`_。
 89 | 
 90 | 最后我要说，“没有简单的答案”。也不要过分小心浮点数！Python 浮点数计算中的误差源之于浮点数硬件，大多数机器上每次计算误差不超过 2\*\*53 分之一。对于大多数任务这已经足够了，但是你要在心中记住这不是十进制算法，每个浮点数计算可能会带来一个新的舍入错误。
 91 | 
 92 | 虽然确实有问题存在，对于大多数平常的浮点数运算，你只要简单地将最终显示的结果舍入到你期望的十进制位数，你就会得到你期望的最终结果。`str() <https://docs.python.org/3/library/stdtypes.html#str>`_ 通常已经足够用了，对于更好的控制可以参阅 `格式化字符串语法 <https://docs.python.org/3/library/string.html#formatstrings>`_ 中 `str.format() <https://docs.python.org/3/library/stdtypes.html#str.format>`_ 方法的格式说明符。
 93 | 
 94 | 对于需要精确十进制表示的情况，可以尝试使用 `decimal <https://docs.python.org/3/library/decimal.html#module-decimal>`_ 模块，它实现的十进制运算适合会计方面的应用和高精度要求的应用。
 95 | 
 96 | `fractions <https://docs.python.org/3/library/fractions.html#module-fractions>`_ 模块支持另外一种形式的运算，它实现的运算基于有理数（因此像1/3这样的数字可以精确地表示）。
 97 | 
 98 | 如果你是浮点数操作的重度使用者，你应该看一下由 SciPy 项目提供的 Numerical Python 包和其它用于数学和统计学的包。参看 <http://scipy.org>。
 99 | 
100 | 当你真的 *真* 想要知道浮点数精确值的时候，Python 提供这样的工具可以帮助你。`float.as_integer_ratio() <https://docs.python.org/3/library/stdtypes.html#float.as_integer_ratio>`_ 方法以分数的形式表示一个浮点数的值::
101 | 
102 |    >>> x = 3.14159
103 |    >>> x.as_integer_ratio()
104 |    (3537115888337719, 1125899906842624)
105 | 
106 | 因为比值是精确的，它可以用来无损地重新生成初始值::
107 | 
108 |     >>> x == 3537115888337719 / 1125899906842624
109 |     True
110 | 
111 | `float.hex() <https://docs.python.org/3/library/stdtypes.html#float.hex>`_ 方法以十六进制表示浮点数，给出的同样是计算机存储的精确值::
112 | 
113 |    >>> x.hex()
114 |    '0x1.921f9f01b866ep+1'
115 | 
116 | 精确的十六进制表示可以用来准确地重新构建浮点数::
117 | 
118 |     >>> x == float.fromhex('0x1.921f9f01b866ep+1')
119 |     True
120 | 
121 | 因为可以精确表示，所以可以用在不同版本的 Python（与平台相关）之间可靠地移植数据以及与支持同样格式的其它语言（例如 Java 和 C99）交换数据。
122 | 
123 | 另外一个有用的工具是 `math.fsum() <https://docs.python.org/3/library/math.html#math.fsum>`_ 函数，它帮助求和过程中减少精度的损失。当数值在不停地相加的时候，它会跟踪“丢弃的数字”。这可以给总体的准确度带来不同，以至于错误不会累积到影响最终结果的点::
124 | 
125 |    >>> sum([0.1] * 10) == 1.0
126 |    False
127 |    >>> math.fsum([0.1] * 10) == 1.0
128 |    True
129 | 
130 | 
131 | .. _tut-fp-error:
132 | 
133 | 表达错误
134 | ====================
135 | 
136 | 这一节详细说明 “0.1” 示例，教你怎样自己去精确的分析此类案例。假设这里你已经对浮点数表示有基本的了解。 
137 | 
138 | :dfn:`Representation error` 提及事实上有些（实际是大多数）十进制小数不能精确的表示为二进制小数。这是 Python （或 Perl，C，C++，Java，Fortran 以及其它很多）语言往往不能按你期待的样子显示十进制数值的根本原因。
139 | 
140 | 这是为什么？ 1/10 不能精确的表示为二进制小数。大多数今天的机器（2000年十一月）使用 IEEE-754 浮点数算法，大多数平台上 Python 将浮点数映射为 IEEE-754 “双精度浮点数”。754 双精度包含 53 位精度，所以计算机努力将输入的 0.1 转为 *J*/2**\ *N* 最接近的二进制小数。*J* 是一个 53 位的整数。改写::
141 | 
142 |    1 / 10 ~= J / (2**N)
143 | 
144 | 为::
145 | 
146 |    J ~= 2**N / 10
147 | 
148 | *J* 重现时正是 53 位（是 ``>= 2**52`` 而非 ``< 2**53`` ）， *N* 的最佳值是 56::
149 | 
150 |     >>> 2**52 <=  2**56 // 10  < 2**53
151 |     True
152 | 
153 | 因此，56 是保持 *J* 精度的唯一 *N* 值。*J* 最好的近似值是整除的商::
154 | 
155 |    >>> q, r = divmod(2**56, 10)
156 |    >>> r
157 |    6
158 | 
159 | 因为余数大于 10 的一半，最好的近似是取上界::
160 | 
161 |    >>> q+1
162 |    7205759403792794
163 | 
164 | 因此在 754 双精度中 1/10 最好的近似值是是 2**56，或::
165 | 
166 |    7205759403792794 / 2 ** 56
167 | 
168 | 分子和分母都除以2将小数缩小到::
169 | 
170 |    3602879701896397 / 2 ** 55
171 | 
172 | 要注意因为我们向上舍入，它其实比 1/10 稍大一点点。如果我们没有向上舍入，它会比 1/10 稍小一点。但是没办法让它 *恰好* 是 1/10！ 
173 | 
174 | 所以计算机永远也不 “知道” 1/10：它遇到上面这个小数，给出它所能得到的最佳的 754 双精度实数::
175 | 
176 |    >>> .1 * 2**55
177 |    7205759403792794.0
178 | 
179 | 如果我们把这小数乘以 10\*\*55，我们可以看到其55位十进制数的值::
180 | 
181 |    >>> 3602879701896397 * 10 ** 55 // 2 ** 55
182 |    1000000000000000055511151231257827021181583404541015625
183 | 
184 | 这表示存储在计算机中的实际值近似等于十进制值 0.1000000000000000055511151231257827021181583404541015625。许多语言（包括旧版本的Python）会把结果舍入到 17 位有效数字，而不是显示全部的十进制值::
185 | 
186 |    >>> format(0.1, '.17f')
187 |    '0.10000000000000001'
188 | 
189 | `fractions <https://docs.python.org/3/library/fractions.html#module-fractions>`_ 和 `decimal <https://docs.python.org/3/library/decimal.html#module-decimal>`_ 模块使得这些计算很简单::
190 | 
191 |    >>> from decimal import Decimal
192 |    >>> from fractions import Fraction
193 | 
194 |    >>> Fraction.from_float(0.1)
195 |    Fraction(3602879701896397, 36028797018963968)
196 | 
197 |    >>> (0.1).as_integer_ratio()
198 |    (3602879701896397, 36028797018963968)
199 | 
200 |    >>> Decimal.from_float(0.1)
201 |    Decimal('0.1000000000000000055511151231257827021181583404541015625')
202 | 
203 |    >>> format(Decimal.from_float(0.1), '.17')
204 |    '0.10000000000000001'
205 | 


--------------------------------------------------------------------------------
/docs/html/_sources/floatingpoint.txt:
--------------------------------------------------------------------------------
  1 | .. _tut-fp-issues:
  2 | 
  3 | **************************************************
  4 | 浮点数算法：争议和限制
  5 | **************************************************
  6 | 
  7 | .. sectionauthor:: Tim Peters <tim_one@users.sourceforge.net>
  8 | 
  9 | 
 10 | 浮点数在计算机中表达为二进制（binary）小数。例如：十进制小数::
 11 | 
 12 |    0.125
 13 | 
 14 | 是 1/10 + 2/100 + 5/1000 的值，同样二进制小数::
 15 | 
 16 |    0.001
 17 | 
 18 | 是 0/2 + 0/4 + 1/8。这两个数值相同。唯一的实质区别是第一个写为十进制小数记法，第二个是二进制。 
 19 | 
 20 | 不幸的是，大多数十进制小数不能完全用二进制小数表示。结果是，一般情况下，你输入的十进制浮点数仅由实际存储在计算机中的近似的二进制浮点数表示。
 21 | 
 22 | 这个问题更早的时候首先在十进制中发现。考虑小数形式的 1/3 ，你可以来个十进制的近似值。 ::
 23 | 
 24 |    0.3
 25 | 
 26 | 或者更进一步的, ::
 27 | 
 28 |    0.33
 29 | 
 30 | 或者更进一步的, ::
 31 | 
 32 |    0.333
 33 | 
 34 | 诸如此类。如果你写多少位，这个结果永远不是精确的 1/3 ，但是可以无限接近 1/3 。 
 35 | 
 36 | 同样，无论在二进制中写多少位，十进制数 0.1 都不能精确表达为二进制小数。二进制来表达 1/10 是一个无限循环小数::
 37 | 
 38 |    0.0001100110011001100110011001100110011001100110011...
 39 | 
 40 | 在任何有限数量的位停下来，你得到的都是近似值。今天在大多数机器上，浮点数的近似使用的小数以最高的 53 位为分子，2 的幂为分母。至于 1/10 这种情况，其二进制小数是  ``3602879701896397 / 2 ** 55``，它非常接近但不完全等于1/10真实的值。
 41 | 
 42 | 由于显示方式的原因，许多使用者意识不到是近似值。Python 只打印机器中存储的二进制值的十进制近似值。在大多数机器上，如果 Python 要打印 0.1 存储的二进制的真正近似值，将会显示::
 43 | 
 44 |    >>> 0.1
 45 |    0.1000000000000000055511151231257827021181583404541015625
 46 | 
 47 | 这么多位的数字对大多数人是没有用的，所以 Python 显示一个舍入的值 ::
 48 | 
 49 |    >>> 1 / 10
 50 |    0.1
 51 | 
 52 | 只要记住即使打印的结果看上去是精确的 1/10，真正存储的值是最近似的二进制小数。
 53 | 
 54 | 有趣地是，存在许多不同的十进制数共享着相同的近似二进制小数。例如，数字 ``0.1`` 和 ``0.10000000000000001`` 以及 ``0.1000000000000000055511151231257827021181583404541015625`` 都是 ``3602879701896397 / 2 ** 55`` 的近似值。因为所有这些十进制数共享相同的近似值，在保持恒等式 ``eval(repr(x)) == x`` 的同时，显示的可能是它们中的任何一个。
 55 | 
 56 | 历史上，Python 提示符和内置的 `repr() <https://docs.python.org/3/library/functions.html#repr>`_ 函数选择一个 17 位精度的数字，``0.10000000000000001``。从 Python 3.1 开始，Python（在大多数系统上）能够从这些数字当中选择最短的一个并简单地显示 ``0.1``。
 57 | 
 58 | 注意，这是二进制浮点数的自然性质：它不是 Python 中的一个 bug，也不是你的代码中的 bug。你会看到所有支持硬件浮点数算法的语言都会有这个现象（尽管有些语言默认情况下或者在所有输出模式下可能不会 *显示* 出差异）。
 59 | 
 60 | 为了输出更好看，你可能想用字符串格式化来生成固定位数的有效数字::
 61 | 
 62 |    >>> format(math.pi, '.12g')  # give 12 significant digits
 63 |    '3.14159265359'
 64 | 
 65 |    >>> format(math.pi, '.2f')   # give 2 digits after the point
 66 |    '3.14'
 67 | 
 68 |    >>> repr(math.pi)
 69 |    '3.141592653589793'
 70 | 
 71 | 认识到这，在真正意义上，是一种错觉是很重要的：你在简单地舍入真实机器值的 *显示*。
 72 | 
 73 | 例如，既然 0.1 不是精确的 1/10，3 个 0.1 的值相加可能也不会得到精确的 0.3::
 74 | 
 75 |    >>> .1 + .1 + .1 == .3
 76 |    False
 77 | 
 78 | 另外，既然 0.1 不能更接近 1/10 的精确值而且 0.3 不能更接近 3/10 的精确值，使用 `round() <https://docs.python.org/3/library/functions.html#round>`_ 函数提前舍入也没有帮助::
 79 | 
 80 |    >>> round(.1, 1) + round(.1, 1) + round(.1, 1) == round(.3, 1)
 81 |    False
 82 | 
 83 | 虽然这些数字不可能再更接近它们想要的精确值，`round() <https://docs.python.org/3/library/functions.html#round>`_  函数可以用于在计算之后进行舍入，这样的话不精确的结果就可以和另外一个相比较了::
 84 | 
 85 |     >>> round(.1 + .1 + .1, 10) == round(.3, 10)
 86 |     True
 87 | 
 88 | 二进制浮点数计算有很多这样意想不到的结果。“0.1”的问题在下面"误差的表示"一节中有准确详细的解释。更完整的常见怪异现象请参见 `浮点数的危险 <http://www.lahey.com/float.htm>`_。
 89 | 
 90 | 最后我要说，“没有简单的答案”。也不要过分小心浮点数！Python 浮点数计算中的误差源之于浮点数硬件，大多数机器上每次计算误差不超过 2\*\*53 分之一。对于大多数任务这已经足够了，但是你要在心中记住这不是十进制算法，每个浮点数计算可能会带来一个新的舍入错误。
 91 | 
 92 | 虽然确实有问题存在，对于大多数平常的浮点数运算，你只要简单地将最终显示的结果舍入到你期望的十进制位数，你就会得到你期望的最终结果。`str() <https://docs.python.org/3/library/stdtypes.html#str>`_ 通常已经足够用了，对于更好的控制可以参阅 `格式化字符串语法 <https://docs.python.org/3/library/string.html#formatstrings>`_ 中 `str.format() <https://docs.python.org/3/library/stdtypes.html#str.format>`_ 方法的格式说明符。
 93 | 
 94 | 对于需要精确十进制表示的情况，可以尝试使用 `decimal <https://docs.python.org/3/library/decimal.html#module-decimal>`_ 模块，它实现的十进制运算适合会计方面的应用和高精度要求的应用。
 95 | 
 96 | `fractions <https://docs.python.org/3/library/fractions.html#module-fractions>`_ 模块支持另外一种形式的运算，它实现的运算基于有理数（因此像1/3这样的数字可以精确地表示）。
 97 | 
 98 | 如果你是浮点数操作的重度使用者，你应该看一下由 SciPy 项目提供的 Numerical Python 包和其它用于数学和统计学的包。参看 <http://scipy.org>。
 99 | 
100 | 当你真的 *真* 想要知道浮点数精确值的时候，Python 提供这样的工具可以帮助你。`float.as_integer_ratio() <https://docs.python.org/3/library/stdtypes.html#float.as_integer_ratio>`_ 方法以分数的形式表示一个浮点数的值::
101 | 
102 |    >>> x = 3.14159
103 |    >>> x.as_integer_ratio()
104 |    (3537115888337719, 1125899906842624)
105 | 
106 | 因为比值是精确的，它可以用来无损地重新生成初始值::
107 | 
108 |     >>> x == 3537115888337719 / 1125899906842624
109 |     True
110 | 
111 | `float.hex() <https://docs.python.org/3/library/stdtypes.html#float.hex>`_ 方法以十六进制表示浮点数，给出的同样是计算机存储的精确值::
112 | 
113 |    >>> x.hex()
114 |    '0x1.921f9f01b866ep+1'
115 | 
116 | 精确的十六进制表示可以用来准确地重新构建浮点数::
117 | 
118 |     >>> x == float.fromhex('0x1.921f9f01b866ep+1')
119 |     True
120 | 
121 | 因为可以精确表示，所以可以用在不同版本的 Python（与平台相关）之间可靠地移植数据以及与支持同样格式的其它语言（例如 Java 和 C99）交换数据。
122 | 
123 | 另外一个有用的工具是 `math.fsum() <https://docs.python.org/3/library/math.html#math.fsum>`_ 函数，它帮助求和过程中减少精度的损失。当数值在不停地相加的时候，它会跟踪“丢弃的数字”。这可以给总体的准确度带来不同，以至于错误不会累积到影响最终结果的点::
124 | 
125 |    >>> sum([0.1] * 10) == 1.0
126 |    False
127 |    >>> math.fsum([0.1] * 10) == 1.0
128 |    True
129 | 
130 | 
131 | .. _tut-fp-error:
132 | 
133 | 表达错误
134 | ====================
135 | 
136 | 这一节详细说明 “0.1” 示例，教你怎样自己去精确的分析此类案例。假设这里你已经对浮点数表示有基本的了解。 
137 | 
138 | :dfn:`Representation error` 提及事实上有些（实际是大多数）十进制小数不能精确的表示为二进制小数。这是 Python （或 Perl，C，C++，Java，Fortran 以及其它很多）语言往往不能按你期待的样子显示十进制数值的根本原因。
139 | 
140 | 这是为什么？ 1/10 不能精确的表示为二进制小数。大多数今天的机器（2000年十一月）使用 IEEE-754 浮点数算法，大多数平台上 Python 将浮点数映射为 IEEE-754 “双精度浮点数”。754 双精度包含 53 位精度，所以计算机努力将输入的 0.1 转为 *J*/2**\ *N* 最接近的二进制小数。*J* 是一个 53 位的整数。改写::
141 | 
142 |    1 / 10 ~= J / (2**N)
143 | 
144 | 为::
145 | 
146 |    J ~= 2**N / 10
147 | 
148 | *J* 重现时正是 53 位（是 ``>= 2**52`` 而非 ``< 2**53`` ）， *N* 的最佳值是 56::
149 | 
150 |     >>> 2**52 <=  2**56 // 10  < 2**53
151 |     True
152 | 
153 | 因此，56 是保持 *J* 精度的唯一 *N* 值。*J* 最好的近似值是整除的商::
154 | 
155 |    >>> q, r = divmod(2**56, 10)
156 |    >>> r
157 |    6
158 | 
159 | 因为余数大于 10 的一半，最好的近似是取上界::
160 | 
161 |    >>> q+1
162 |    7205759403792794
163 | 
164 | 因此在 754 双精度中 1/10 最好的近似值是是 2**56，或::
165 | 
166 |    7205759403792794 / 2 ** 56
167 | 
168 | 分子和分母都除以2将小数缩小到::
169 | 
170 |    3602879701896397 / 2 ** 55
171 | 
172 | 要注意因为我们向上舍入，它其实比 1/10 稍大一点点。如果我们没有向上舍入，它会比 1/10 稍小一点。但是没办法让它 *恰好* 是 1/10！ 
173 | 
174 | 所以计算机永远也不 “知道” 1/10：它遇到上面这个小数，给出它所能得到的最佳的 754 双精度实数::
175 | 
176 |    >>> .1 * 2**55
177 |    7205759403792794.0
178 | 
179 | 如果我们把这小数乘以 10\*\*55，我们可以看到其55位十进制数的值::
180 | 
181 |    >>> 3602879701896397 * 10 ** 55 // 2 ** 55
182 |    1000000000000000055511151231257827021181583404541015625
183 | 
184 | 这表示存储在计算机中的实际值近似等于十进制值 0.1000000000000000055511151231257827021181583404541015625。许多语言（包括旧版本的Python）会把结果舍入到 17 位有效数字，而不是显示全部的十进制值::
185 | 
186 |    >>> format(0.1, '.17f')
187 |    '0.10000000000000001'
188 | 
189 | `fractions <https://docs.python.org/3/library/fractions.html#module-fractions>`_ 和 `decimal <https://docs.python.org/3/library/decimal.html#module-decimal>`_ 模块使得这些计算很简单::
190 | 
191 |    >>> from decimal import Decimal
192 |    >>> from fractions import Fraction
193 | 
194 |    >>> Fraction.from_float(0.1)
195 |    Fraction(3602879701896397, 36028797018963968)
196 | 
197 |    >>> (0.1).as_integer_ratio()
198 |    (3602879701896397, 36028797018963968)
199 | 
200 |    >>> Decimal.from_float(0.1)
201 |    Decimal('0.1000000000000000055511151231257827021181583404541015625')
202 | 
203 |    >>> format(Decimal.from_float(0.1), '.17')
204 |    '0.10000000000000001'
205 | 


--------------------------------------------------------------------------------
/docs/html/_sources/index.rst.txt:
--------------------------------------------------------------------------------
 1 | .. _tutorial-index:
 2 | 
 3 | ######################
 4 | Python 入门指南
 5 | ######################
 6 | 
 7 | :Release: |version|
 8 | :Date: |today|
 9 | 
10 | Python 是一门简单易学且功能强大的编程语言。它拥有高效的高级数据结构，并且能够用简单而又高效的方式进行面向对象编程。Python 优雅的语法和动态类型，再结合它的解释性，使其在大多数平台的许多领域成为编写脚本或开发应用程序的理想语言。
11 | 
12 | 你可以自由地从 Python 官方点: http://www.python.org，以源代码或二进制形式获取 Python 解释器及其标准扩展库，并可以自由的分发。此站点同时也提供了大量的第三方 Python 模块、程序和工具，及其附加文档。
13 | 
14 | 你可以很容易的使用 C 或 C++（其他可以通过 C 调用的语言）为 Python 解释器扩展新函数和数据类型。Python 还可以被用作定制应用程序的一门扩展语言。
15 | 
16 | 本手册非正式的向读者介绍了 Python 语言及其体系相关的基本知识与概念。在学习实践中结合使用 Python 解释器是很有帮助的，不过所有的例子都是完整的，所以本手册亦可离线阅读。
17 | 
18 | 如果需要了解相关标准库或对象的详细介绍，请查阅 `Python 参考文档`_ 。`Python 参考手册`_ 提供了更多语言相关的正式说明。如果想要使用 C 或 C++ 编写扩展，请查阅 `Python 解释器扩展和集成章节`_ 和 `C API 参考手册`_ 。当然也可阅读一些深入介绍 Python 知识的图书。
19 | 
20 | 本手册不会尝试涵盖 Python 的全部知识和每个特性，甚至不会涵盖所有常用的特性。相反地，它介绍了 Python 中许多最引人瞩目的特性，并且会给你一个关于语言特色和风格的认识。读完之后，你将能够阅读和编写 Python 模块或程序，并为以后使用 
21 | `Python 参考手册`_ 继续学习诸多 Python 模块库做好准备。
22 | 
23 | 
24 | `词汇表`_ 也值得浏览一下。
25 | 
26 | .. toctree::
27 |    :numbered:
28 | 
29 |    appetite.rst
30 |    interpreter.rst
31 |    introduction.rst
32 |    controlflow.rst
33 |    datastructures.rst
34 |    modules.rst
35 |    inputoutput.rst
36 |    errors.rst
37 |    classes.rst
38 |    stdlib.rst
39 |    stdlib2.rst
40 |    venv.rst
41 |    whatnow.rst
42 |    interactive.rst
43 |    floatingpoint.rst
44 |    appendix.rst
45 | 
46 | 
47 | .. _Python 参考文档: https://docs.python.org/3/library/index.html#library-index
48 | .. _Python 参考手册: https://docs.python.org/3/reference/index.html#reference-index
49 | .. _Python 解释器扩展和集成章节: https://docs.python.org/3/extending/index.html#extending-index
50 | .. _C API 参考手册: https://docs.python.org/3/c-api/index.html#c-api-index
51 | .. _词汇表: https://docs.python.org/3/glossary.html#glossary


--------------------------------------------------------------------------------
/docs/html/_sources/index.txt:
--------------------------------------------------------------------------------
 1 | .. _tutorial-index:
 2 | 
 3 | ######################
 4 | Python 入门指南
 5 | ######################
 6 | 
 7 | :Release: |version|
 8 | :Date: |today|
 9 | 
10 | Python 是一门简单易学且功能强大的编程语言。它拥有高效的高级数据结构，并且能够用简单而又高效的方式进行面向对象编程。Python 优雅的语法和动态类型，再结合它的解释性，使其在大多数平台的许多领域成为编写脚本或开发应用程序的理想语言。
11 | 
12 | 你可以自由地从 Python 官方点: http://www.python.org，以源代码或二进制形式获取 Python 解释器及其标准扩展库，并可以自由的分发。此站点同时也提供了大量的第三方 Python 模块、程序和工具，及其附加文档。
13 | 
14 | 你可以很容易的使用 C 或 C++（其他可以通过 C 调用的语言）为 Python 解释器扩展新函数和数据类型。Python 还可以被用作定制应用程序的一门扩展语言。
15 | 
16 | 本手册非正式的向读者介绍了 Python 语言及其体系相关的基本知识与概念。在学习实践中结合使用 Python 解释器是很有帮助的，不过所有的例子都是完整的，所以本手册亦可离线阅读。
17 | 
18 | 如果需要了解相关标准库或对象的详细介绍，请查阅 `Python 参考文档`_ 。`Python 参考手册`_ 提供了更多语言相关的正式说明。如果想要使用 C 或 C++ 编写扩展，请查阅 `Python 解释器扩展和集成章节`_ 和 `C API 参考手册`_ 。当然也可阅读一些深入介绍 Python 知识的图书。
19 | 
20 | 本手册不会尝试涵盖 Python 的全部知识和每个特性，甚至不会涵盖所有常用的特性。相反地，它介绍了 Python 中许多最引人瞩目的特性，并且会给你一个关于语言特色和风格的认识。读完之后，你将能够阅读和编写 Python 模块或程序，并为以后使用 
21 | `Python 参考手册`_ 继续学习诸多 Python 模块库做好准备。
22 | 
23 | 
24 | `词汇表`_ 也值得浏览一下。
25 | 
26 | .. toctree::
27 |    :numbered:
28 | 
29 |    appetite.rst
30 |    interpreter.rst
31 |    introduction.rst
32 |    controlflow.rst
33 |    datastructures.rst
34 |    modules.rst
35 |    inputoutput.rst
36 |    errors.rst
37 |    classes.rst
38 |    stdlib.rst
39 |    stdlib2.rst
40 |    venv.rst
41 |    whatnow.rst
42 |    interactive.rst
43 |    floatingpoint.rst
44 |    appendix.rst
45 | 
46 | 
47 | .. _Python 参考文档: https://docs.python.org/3/library/index.html#library-index
48 | .. _Python 参考手册: https://docs.python.org/3/reference/index.html#reference-index
49 | .. _Python 解释器扩展和集成章节: https://docs.python.org/3/extending/index.html#extending-index
50 | .. _C API 参考手册: https://docs.python.org/3/c-api/index.html#c-api-index
51 | .. _词汇表: https://docs.python.org/3/glossary.html#glossary


--------------------------------------------------------------------------------
/docs/html/_sources/interactive.rst.txt:
--------------------------------------------------------------------------------
 1 | .. _tut-interacting:
 2 | 
 3 | **************************************************
 4 | 交互式输入行编辑历史回溯
 5 | **************************************************
 6 | 
 7 | 某些版本的 Python 解释器支持编辑当前的输入行和历史记录，类似于在 Korn shell 和 GNU Bash shell 中看到的功能。这是使用 `GNU Readline`_ 库实现的，它支持各种编辑风格。 这个库有它自己的文档，在这里我们不就重复了。
 8 | 
 9 | 
10 | .. _tut-keybindings:
11 | 
12 | Tab 补全和历史记录
13 | ==================================
14 | 
15 | 变量和模块名的补全在解释器启动时 `自动打开 <https://docs.python.org/3/library/site.html#rlcompleter-config>`_ 以便 :kbd:`Tab` 键调用补全功能；它会查看Python语句的名字，当前局部变量以及可以访问的模块名。对于点分表达式如 ``string.a``，它将求出表达式最后一个 ``'.'`` 之前的值，然后根据结果的属性给出补全的建议。注意，如果一个具有 `__getattr__() <https://docs.python.org/3/reference/datamodel.html#object.__getattr__>`_ 方法的对象是表达式的某部分，这可能执行应用程序定义的代码。默认的配置同时会把历史记录保存在你的用户目录下一个名为 :file:`.python_history` 的文件中。在下次与交互式解释器的会话中，历史记录将还可以访问。
16 | 
17 | 
18 | .. _tut-commentary:
19 | 
20 | 其它交互式解释器
21 | ===========================================
22 | 
23 | 与早期版本的解释器相比，现在是向前巨大的进步；然而，有些愿望还是没有实现：如果能对连续的行给出正确的建议就更好了（解析器知道下一行是否需要缩进）。补全机制可以使用解释器的符号表。检查（或者只是建议）匹配的括号、 引号的命令等也会非常有用。
24 | 
25 | 一个增强的交互式解释器是 IPython_，它已经存在相当一段时间，具有 tab 补全、 对象 exploration 和高级的历史记录功能。它也可以彻底定制并嵌入到其他应用程序中。另一个类似的增强的交互式环境是 bpython_。
26 | 
27 | 
28 | 
29 | .. _GNU Readline: http://tiswww.case.edu/php/chet/readline/rltop.html
30 | .. _IPython: http://ipython.scipy.org/
31 | .. _bpython: http://www.bpython-interpreter.org/
32 | 


--------------------------------------------------------------------------------
/docs/html/_sources/interactive.txt:
--------------------------------------------------------------------------------
 1 | .. _tut-interacting:
 2 | 
 3 | **************************************************
 4 | 交互式输入行编辑历史回溯
 5 | **************************************************
 6 | 
 7 | 某些版本的 Python 解释器支持编辑当前的输入行和历史记录，类似于在 Korn shell 和 GNU Bash shell 中看到的功能。这是使用 `GNU Readline`_ 库实现的，它支持各种编辑风格。 这个库有它自己的文档，在这里我们不就重复了。
 8 | 
 9 | 
10 | .. _tut-keybindings:
11 | 
12 | Tab 补全和历史记录
13 | ==================================
14 | 
15 | 变量和模块名的补全在解释器启动时 `自动打开 <https://docs.python.org/3/library/site.html#rlcompleter-config>`_ 以便 :kbd:`Tab` 键调用补全功能；它会查看Python语句的名字，当前局部变量以及可以访问的模块名。对于点分表达式如 ``string.a``，它将求出表达式最后一个 ``'.'`` 之前的值，然后根据结果的属性给出补全的建议。注意，如果一个具有 `__getattr__() <https://docs.python.org/3/reference/datamodel.html#object.__getattr__>`_ 方法的对象是表达式的某部分，这可能执行应用程序定义的代码。默认的配置同时会把历史记录保存在你的用户目录下一个名为 :file:`.python_history` 的文件中。在下次与交互式解释器的会话中，历史记录将还可以访问。
16 | 
17 | 
18 | .. _tut-commentary:
19 | 
20 | 其它交互式解释器
21 | ===========================================
22 | 
23 | 与早期版本的解释器相比，现在是向前巨大的进步；然而，有些愿望还是没有实现：如果能对连续的行给出正确的建议就更好了（解析器知道下一行是否需要缩进）。补全机制可以使用解释器的符号表。检查（或者只是建议）匹配的括号、 引号的命令等也会非常有用。
24 | 
25 | 一个增强的交互式解释器是 IPython_，它已经存在相当一段时间，具有 tab 补全、 对象 exploration 和高级的历史记录功能。它也可以彻底定制并嵌入到其他应用程序中。另一个类似的增强的交互式环境是 bpython_。
26 | 
27 | 
28 | 
29 | .. _GNU Readline: http://tiswww.case.edu/php/chet/readline/rltop.html
30 | .. _IPython: http://ipython.scipy.org/
31 | .. _bpython: http://www.bpython-interpreter.org/
32 | 


--------------------------------------------------------------------------------
/docs/html/_sources/interpreter.rst.txt:
--------------------------------------------------------------------------------
  1 | .. _tut-using:
  2 | 
  3 | ****************************
  4 | 使用 Python 解释器
  5 | ****************************
  6 | 
  7 | 
  8 | .. _tut-invoking:
  9 | 
 10 | 调用 Python 解释器
 11 | ========================
 12 | 
 13 | Python 解释器通常被安装在目标机器的 :file:`/usr/local/bin/python3.5` 目录下。将 :file:`/usr/local/bin` 目录包含进 Unix shell 的搜索路径里，以确保可以通过输入:
 14 | 
 15 | .. code-block:: text
 16 | 
 17 |    python3.5
 18 | 
 19 | 命令来启动他。[#]_ 由于 Python 解释器的安装路径是可选的，这也可能是其它路径，你可以联系安装 Python 的用户或系统管理员确认（例如，:file:`/usr/local/python` 就是一个常见的选择）。
 20 | 
 21 | 在 Windows 机器上，Python 通常安装在 :file:`C:\\Python35` 位置，当然你可以在运行安装向导时修改此值。要想把此目录添加到你的 PATH 环境变量中，你可以在 DOS 窗口中输入以下命令::
 22 | 
 23 |    set path=%path%;C:\python35
 24 | 
 25 | 通常你可以在主窗口输入一个文件结束符（Unix 系统是 :kbd:`Control-D`，Windows 系统是 :kbd:`Control-Z`）让解释器以 0 状态码退出。如果那没有作用，你可以通过输入 ``quit()`` 命令退出解释器。
 26 | 
 27 | Python 解释器具有简单的行编辑功能。在 Unix 系统上，任何 Python 解释器都可能已经添加了 GNU readline 库支持，这样就具备了精巧的交互编辑和历史记录等功能。在 Python 主窗口中输入 Control-P 可能是检查是否支持命令行编辑的最简单的方法。如果发出嘟嘟声（计算机扬声器），则说明你可以使用命令行编辑功能；更多快捷键的介绍请参考 :ref:`tut-interacting`。如果没有任何声音，或者显示 ``^P`` 字符，则说明命令行编辑功能不可用；你只能通过退格键从当前行删除已键入的字符并重新输入。
 28 | 
 29 | Python 解释器有些操作类似 Unix shell：当使用终端设备（tty）作为标准输入调用时，它交互的解释并执行命令；当使用文件名参数或以文件作为标准输入调用时，它读取文件并将文件作为 *脚本* 执行。
 30 | 
 31 | 第二种启动 Python 解释器的方法是 ``python -c command [arg] ...``，这种方法可以在 *命令行* 执行 Python 语句，类似于 shell 中的 `-c`_ 选项。由于 Python 语句通常会包含空格或其他特殊 shell 字符，一般建议将 *命令* 用单引号包裹起来。
 32 | 
 33 | 有一些 Python 模块也可以当作脚本使用。你可以使用 ``python -m module [arg] ...`` 命令调用它们，这类似在命令行中键入完整的路径名执行 *模块* 源文件一样。
 34 | 
 35 | 使用脚本文件时，经常会运行脚本然后进入交互模式。这也可以通过在脚本之前加上 `-i`_ 参数来实现。
 36 | 
 37 | 
 38 | .. _tut-argpassing:
 39 | 
 40 | 参数传递
 41 | ----------------
 42 | 
 43 | 调用解释器时，脚本名和附加参数传入一个名为 ``sys.argv`` 的字符串列表。你能够获取这个列表通过执行 ``import
 44 | sys``，列表的长度大于等于1；没有给定脚本和参数时，它至少也有一个元素：``sys.argv[0]`` 此时为空字符串。脚本名指定为 ``'-'`` （表示标准输入）时， ``sys.argv[0]`` 被设定为 ``'-'``，使用 `-c`_ *指令* 时，``sys.argv[0]`` 被设定为 ``'-c'``。使用 `-m`_ *模块* 参数时，``sys.argv[0]`` 被设定为指定模块的全名。`-c`_ *指令* 或者 `-m`_ *模块* 之后的参数不会被 Python 解释器的选项处理机制所截获，而是留在 ``sys.argv`` 中，供脚本命令操作。
 45 | 
 46 | 
 47 | .. _tut-interactive:
 48 | 
 49 | 交互模式
 50 | ----------------
 51 | 
 52 | 从 tty 读取命令时，我们称解释器工作于 *交互模式*。这种模式下它根据主提示符来执行，主提示符通常标识为三个大于号(``>>>``)；继续的部分被称为 *从属提示符*，由三个点标识(``...``)。在第一行之前，解释器打印欢迎信息、版本号和授权提示::
 53 | 
 54 |    $ python3.5
 55 |    Python 3.5.2 (default, Mar 16 2014, 09:25:04)
 56 |    [GCC 4.8.2] on linux
 57 |    Type "help", "copyright", "credits" or "license" for more information.
 58 |    >>>
 59 | 
 60 | .. XXX update for new releases
 61 | 
 62 | 输入多行结构时需要从属提示符了，例如，下面这个 `if`_ 语句::
 63 | 
 64 |    >>> the_world_is_flat = 1
 65 |    >>> if the_world_is_flat:
 66 |    ...     print("Be careful not to fall off!")
 67 |    ...
 68 |    Be careful not to fall off!
 69 | 
 70 | 
 71 | 关于交互模式更多的内容，请参见 :ref:`tut-interac`。
 72 | 
 73 | 
 74 | .. _tut-interp:
 75 | 
 76 | 解释器及其环境
 77 | ===================================
 78 | 
 79 | .. _tut-source-encoding:
 80 | 
 81 | 源程序编码
 82 | --------------------
 83 | 
 84 | 默认情况下，Python 源文件是 UTF-8 编码。在此编码下，全世界大多数语言的字符可以同时用在字符串、标识符和注释中 — 尽管 Python 标准库仅使用 ASCII 字符做为标识符，这只是任何可移植代码应该遵守的约定。如果要正确的显示所有的字符，你的编辑器必须能识别出文件是 UTF-8 编码，并且它使用的字体能支持文件中所有的字符。
 85 | 
 86 | 你也可以为源文件指定不同的字符编码。为此，在 ``#!`` 行（首行）后插入至少一行特殊的注释行来定义源文件的编码::
 87 | 
 88 |    # -*- coding: encoding -*-
 89 | 
 90 | 通过此声明，源文件中所有的东西都会被当做用 *encoding* 指代的 UTF-8 编码对待。在 Python 库参考手册 `codecs`_ 一节中你可以找到一张可用的编码列表。
 91 | 
 92 | 例如，如果你的编辑器不支持 UTF-8 编码的文件，但支持像 Windows-1252 的其他一些编码，你可以定义::
 93 | 
 94 |    # -*- coding: cp-1252 -*-
 95 | 
 96 | 这样就可以在源文件中使用 Windows-1252 字符集中的所有字符了。这个特殊的编码注释必须在文件中的 *第一或第二* 行定义。
 97 | 
 98 | 
 99 | 
100 | .. rubric:: Footnotes
101 | 
102 | .. [#] 在 Unix 系统上，Python 3.X 解释器默认未被安装成名为 ``python`` 的命令，所以它不会与同时安装在系统中的 Python 2.x 命令冲突。
103 | 
104 | 
105 | 
106 | .. _-c: https://docs.python.org/3/using/cmdline.html#cmdoption-c
107 | .. _-i: https://docs.python.org/3/using/cmdline.html#cmdoption-i
108 | .. _-m: https://docs.python.org/3/using/cmdline.html#cmdoption-m
109 | .. _if: https://docs.python.org/3/reference/compound_stmts.html#if
110 | .. _codecs: https://docs.python.org/3/library/codecs.html#module-codecs
111 | 


--------------------------------------------------------------------------------
/docs/html/_sources/interpreter.txt:
--------------------------------------------------------------------------------
  1 | .. _tut-using:
  2 | 
  3 | ****************************
  4 | 使用 Python 解释器
  5 | ****************************
  6 | 
  7 | 
  8 | .. _tut-invoking:
  9 | 
 10 | 调用 Python 解释器
 11 | ========================
 12 | 
 13 | Python 解释器通常被安装在目标机器的 :file:`/usr/local/bin/python3.5` 目录下。将 :file:`/usr/local/bin` 目录包含进 Unix shell 的搜索路径里，以确保可以通过输入:
 14 | 
 15 | .. code-block:: text
 16 | 
 17 |    python3.5
 18 | 
 19 | 命令来启动他。[#]_ 由于 Python 解释器的安装路径是可选的，这也可能是其它路径，你可以联系安装 Python 的用户或系统管理员确认（例如，:file:`/usr/local/python` 就是一个常见的选择）。
 20 | 
 21 | 在 Windows 机器上，Python 通常安装在 :file:`C:\\Python35` 位置，当然你可以在运行安装向导时修改此值。要想把此目录添加到你的 PATH 环境变量中，你可以在 DOS 窗口中输入以下命令::
 22 | 
 23 |    set path=%path%;C:\python35
 24 | 
 25 | 通常你可以在主窗口输入一个文件结束符（Unix 系统是 :kbd:`Control-D`，Windows 系统是 :kbd:`Control-Z`）让解释器以 0 状态码退出。如果那没有作用，你可以通过输入 ``quit()`` 命令退出解释器。
 26 | 
 27 | Python 解释器具有简单的行编辑功能。在 Unix 系统上，任何 Python 解释器都可能已经添加了 GNU readline 库支持，这样就具备了精巧的交互编辑和历史记录等功能。在 Python 主窗口中输入 Control-P 可能是检查是否支持命令行编辑的最简单的方法。如果发出嘟嘟声（计算机扬声器），则说明你可以使用命令行编辑功能；更多快捷键的介绍请参考 :ref:`tut-interacting`。如果没有任何声音，或者显示 ``^P`` 字符，则说明命令行编辑功能不可用；你只能通过退格键从当前行删除已键入的字符并重新输入。
 28 | 
 29 | Python 解释器有些操作类似 Unix shell：当使用终端设备（tty）作为标准输入调用时，它交互的解释并执行命令；当使用文件名参数或以文件作为标准输入调用时，它读取文件并将文件作为 *脚本* 执行。
 30 | 
 31 | 第二种启动 Python 解释器的方法是 ``python -c command [arg] ...``，这种方法可以在 *命令行* 执行 Python 语句，类似于 shell 中的 `-c`_ 选项。由于 Python 语句通常会包含空格或其他特殊 shell 字符，一般建议将 *命令* 用单引号包裹起来。
 32 | 
 33 | 有一些 Python 模块也可以当作脚本使用。你可以使用 ``python -m module [arg] ...`` 命令调用它们，这类似在命令行中键入完整的路径名执行 *模块* 源文件一样。
 34 | 
 35 | 使用脚本文件时，经常会运行脚本然后进入交互模式。这也可以通过在脚本之前加上 `-i`_ 参数来实现。
 36 | 
 37 | 
 38 | .. _tut-argpassing:
 39 | 
 40 | 参数传递
 41 | ----------------
 42 | 
 43 | 调用解释器时，脚本名和附加参数传入一个名为 ``sys.argv`` 的字符串列表。你能够获取这个列表通过执行 ``import
 44 | sys``，列表的长度大于等于1；没有给定脚本和参数时，它至少也有一个元素：``sys.argv[0]`` 此时为空字符串。脚本名指定为 ``'-'`` （表示标准输入）时， ``sys.argv[0]`` 被设定为 ``'-'``，使用 `-c`_ *指令* 时，``sys.argv[0]`` 被设定为 ``'-c'``。使用 `-m`_ *模块* 参数时，``sys.argv[0]`` 被设定为指定模块的全名。`-c`_ *指令* 或者 `-m`_ *模块* 之后的参数不会被 Python 解释器的选项处理机制所截获，而是留在 ``sys.argv`` 中，供脚本命令操作。
 45 | 
 46 | 
 47 | .. _tut-interactive:
 48 | 
 49 | 交互模式
 50 | ----------------
 51 | 
 52 | 从 tty 读取命令时，我们称解释器工作于 *交互模式*。这种模式下它根据主提示符来执行，主提示符通常标识为三个大于号(``>>>``)；继续的部分被称为 *从属提示符*，由三个点标识(``...``)。在第一行之前，解释器打印欢迎信息、版本号和授权提示::
 53 | 
 54 |    $ python3.5
 55 |    Python 3.5.2 (default, Mar 16 2014, 09:25:04)
 56 |    [GCC 4.8.2] on linux
 57 |    Type "help", "copyright", "credits" or "license" for more information.
 58 |    >>>
 59 | 
 60 | .. XXX update for new releases
 61 | 
 62 | 输入多行结构时需要从属提示符了，例如，下面这个 `if`_ 语句::
 63 | 
 64 |    >>> the_world_is_flat = 1
 65 |    >>> if the_world_is_flat:
 66 |    ...     print("Be careful not to fall off!")
 67 |    ...
 68 |    Be careful not to fall off!
 69 | 
 70 | 
 71 | 关于交互模式更多的内容，请参见 :ref:`tut-interac`。
 72 | 
 73 | 
 74 | .. _tut-interp:
 75 | 
 76 | 解释器及其环境
 77 | ===================================
 78 | 
 79 | .. _tut-source-encoding:
 80 | 
 81 | 源程序编码
 82 | --------------------
 83 | 
 84 | 默认情况下，Python 源文件是 UTF-8 编码。在此编码下，全世界大多数语言的字符可以同时用在字符串、标识符和注释中 — 尽管 Python 标准库仅使用 ASCII 字符做为标识符，这只是任何可移植代码应该遵守的约定。如果要正确的显示所有的字符，你的编辑器必须能识别出文件是 UTF-8 编码，并且它使用的字体能支持文件中所有的字符。
 85 | 
 86 | 你也可以为源文件指定不同的字符编码。为此，在 ``#!`` 行（首行）后插入至少一行特殊的注释行来定义源文件的编码::
 87 | 
 88 |    # -*- coding: encoding -*-
 89 | 
 90 | 通过此声明，源文件中所有的东西都会被当做用 *encoding* 指代的 UTF-8 编码对待。在 Python 库参考手册 `codecs`_ 一节中你可以找到一张可用的编码列表。
 91 | 
 92 | 例如，如果你的编辑器不支持 UTF-8 编码的文件，但支持像 Windows-1252 的其他一些编码，你可以定义::
 93 | 
 94 |    # -*- coding: cp-1252 -*-
 95 | 
 96 | 这样就可以在源文件中使用 Windows-1252 字符集中的所有字符了。这个特殊的编码注释必须在文件中的 *第一或第二* 行定义。
 97 | 
 98 | 
 99 | 
100 | .. rubric:: Footnotes
101 | 
102 | .. [#] 在 Unix 系统上，Python 3.X 解释器默认未被安装成名为 ``python`` 的命令，所以它不会与同时安装在系统中的 Python 2.x 命令冲突。
103 | 
104 | 
105 | 
106 | .. _-c: https://docs.python.org/3/using/cmdline.html#cmdoption-c
107 | .. _-i: https://docs.python.org/3/using/cmdline.html#cmdoption-i
108 | .. _-m: https://docs.python.org/3/using/cmdline.html#cmdoption-m
109 | .. _if: https://docs.python.org/3/reference/compound_stmts.html#if
110 | .. _codecs: https://docs.python.org/3/library/codecs.html#module-codecs
111 | 


--------------------------------------------------------------------------------
/docs/html/_sources/venv.rst.txt:
--------------------------------------------------------------------------------
  1 | 
  2 | .. _tut-venv:
  3 | 
  4 | *********************************
  5 | 虚拟环境和包
  6 | *********************************
  7 | 
  8 | 简介
  9 | ============
 10 | 
 11 | Python 应用程序经常会使用一些不属于标准库的包和模块。应用程序有时候需要某个特定版本的库，因为它需要一个特定的 bug 已得到修复的库或者它是使用了一个过时版本的库的接口编写的。
 12 | 
 13 | 这就意味着可能无法安装一个 Python 来满足每个应用程序的要求。如果应用程序 A 需要一个特定模块的 1.0 版本但是应用程序 B 需要该模块的 2.0 版本，这两个应用程序的要求是冲突的，安装版本 1.0 或者版本 2.0 将会导致其中一个应用程序不能运行。
 14 | 
 15 | 这个问题的解决方案就是创建一个 `虚拟环境 <https://docs.python.org/3/glossary.html#term-virtual-environment>`_ （通常简称为 “virtualenv”），包含一个特定版本的 Python，以及一些附加的包的独立的目录树。
 16 | 
 17 | 不同的应用程序可以使用不同的虚拟环境。为了解决前面例子中的冲突，应用程序 A 可以有自己的虚拟环境，其中安装了特定模块的 1.0 版本。而应用程序 B 拥有另外一个安装了特定模块 2.0 版本的虚拟环境。如果应用程序 B 需求一个库升级到 3.0 的话，这也不会影响到应用程序 A 的环境。
 18 | 
 19 | 
 20 | 创建虚拟环境
 21 | =============================
 22 | 
 23 | 用于创建和管理虚拟环境的脚本叫做 :program:`pyvenv`。:program:`pyvenv` 通常会安装你可用的 Python 中最新的版本。这个脚本也能指定安装一个特定的版本的 Python，因此如果在你的系统中有多个版本的 Python 的话，你可以运行 ``pyvenv-3.5`` 或者你想要的任何版本来选择一个指定的 Python 版本。
 24 | 
 25 | 要创建一个 virtualenv，首先决定一个你想要存放的目录接着运行 :program:`pyvenv` 后面携带着目录名::
 26 | 
 27 |    pyvenv tutorial-env
 28 | 
 29 | 如果目录不存在的话，这将会创建一个 ``tutorial-env`` 目录，并且也在目录里面创建一个包含 Python 解释器，标准库，以及各种配套文件的 Python “副本”。
 30 | 
 31 | 一旦你已经创建了一个虚拟环境，你必须激活它。
 32 | 
 33 | 在 Windows 上，运行::
 34 | 
 35 |   tutorial-env/Scripts/activate
 36 | 
 37 | 在 Unix 或者 MacOS 上，运行::
 38 | 
 39 |   source tutorial-env/bin/activate
 40 | 
 41 | （这个脚本是用 bash shell 编写的。如果你使用 :program:`csh` 或者 :program:`fish` shell，你应该使用 ``activate.csh`` 和 ``activate.fish`` 来替代。）
 42 | 
 43 | 激活了虚拟环境会改变你的 shell 提示符，显示你正在使用的虚拟环境，并且修改了环境以致运行 ``python`` 将会让你得到了特定的 Python 版本。例如::
 44 | 
 45 |   -> source ~/envs/tutorial-env/bin/activate
 46 |   (tutorial-env) -> python
 47 |   Python 3.5.2+ (3.4:c7b9645a6f35+, May 22 2015, 09:31:25)
 48 |     ...
 49 |   >>> import sys
 50 |   >>> sys.path
 51 |   ['', '/usr/local/lib/python35.zip', ...,
 52 |   '~/envs/tutorial-env/lib/python3.5/site-packages']
 53 |   >>>
 54 | 
 55 | 
 56 | 使用 pip 管理包
 57 | ==========================
 58 | 
 59 | 一旦你激活了一个虚拟环境，可以使用一个叫做 :program:`pip` 程序来安装，升级以及删除包。默认情况下 ``pip`` 将会从 Python Package Index，<https://pypi.python.org/pypi>， 中安装包。你可以通过 web 浏览器浏览它们，或者你也能使用 ``pip`` 有限的搜索功能::
 60 | 
 61 |   (tutorial-env) -> pip search astronomy
 62 |   skyfield               - Elegant astronomy for Python
 63 |   gary                   - Galactic astronomy and gravitational dynamics.
 64 |   novas                  - The United States Naval Observatory NOVAS astronomy library
 65 |   astroobs               - Provides astronomy ephemeris to plan telescope observations
 66 |   PyAstronomy            - A collection of astronomy related tools for Python.
 67 |   ...
 68 | 
 69 | ``pip`` 有许多子命令：“搜索”，“安装”，“卸载”，“freeze”（译者注：这个词语暂时没有合适的词语来翻译），等等。（请参考 `installing-index <https://docs.python.org/3/installing/index.html#installing-index>`_ 指南获取 ``pip`` 更多完整的文档。）
 70 | 
 71 | 你可以安装一个包最新的版本，通过指定包的名称::
 72 | 
 73 |   -> pip install novas
 74 |   Collecting novas
 75 |     Downloading novas-3.1.1.3.tar.gz (136kB)
 76 |   Installing collected packages: novas
 77 |     Running setup.py install for novas
 78 |   Successfully installed novas-3.1.1.3
 79 | 
 80 | 你也能安装一个指定版本的包，通过给出包名后面紧跟着 ``==`` 和版本号::
 81 | 
 82 |   -> pip install requests==2.6.0
 83 |   Collecting requests==2.6.0
 84 |     Using cached requests-2.6.0-py2.py3-none-any.whl
 85 |   Installing collected packages: requests
 86 |   Successfully installed requests-2.6.0
 87 | 
 88 | 如果你重新运行命令（pip install requests==2.6.0），``pip`` 会注意到要求的版本已经安装，不会去做任何事情。你也可以提供一个不同的版本号来安装，或者运行 ``pip
 89 | install --upgrade`` 来升级包到最新版本::
 90 | 
 91 |   -> pip install --upgrade requests
 92 |   Collecting requests
 93 |   Installing collected packages: requests
 94 |     Found existing installation: requests 2.6.0
 95 |       Uninstalling requests-2.6.0:
 96 |         Successfully uninstalled requests-2.6.0
 97 |   Successfully installed requests-2.7.0
 98 | 
 99 | ``pip uninstall`` 后跟一个或者多个包名将会从虚拟环境中移除这些包。
100 | 
101 | ``pip show`` 将会显示一个指定的包的信息::
102 | 
103 |   (tutorial-env) -> pip show requests
104 |   ---
105 |   Metadata-Version: 2.0
106 |   Name: requests
107 |   Version: 2.7.0
108 |   Summary: Python HTTP for Humans.
109 |   Home-page: http://python-requests.org
110 |   Author: Kenneth Reitz
111 |   Author-email: me@kennethreitz.com
112 |   License: Apache 2.0
113 |   Location: /Users/akuchling/envs/tutorial-env/lib/python3.4/site-packages
114 |   Requires:
115 | 
116 | ``pip list`` 将会列出所有安装在虚拟环境中的包::
117 | 
118 |   (tutorial-env) -> pip list
119 |   novas (3.1.1.3)
120 |   numpy (1.9.2)
121 |   pip (7.0.3)
122 |   requests (2.7.0)
123 |   setuptools (16.0)
124 |  
125 | ``pip freeze`` 将会生成一个类似需要安装的包的列表，但是输出采用了 ``pip install`` 期望的格式。常见的做法就是把它们放在一个 ``requirements.txt`` 文件::
126 | 
127 |   (tutorial-env) -> pip freeze > requirements.txt
128 |   (tutorial-env) -> cat requirements.txt
129 |   novas==3.1.1.3
130 |   numpy==1.9.2
131 |   requests==2.7.0
132 | 
133 | ``requirements.txt`` 能够被提交到版本控制中并且作为一个应用程序的一部分。用户们可以使用 ``install -r`` 安装所有必须的包::
134 | 
135 |   -> pip install -r requirements.txt
136 |   Collecting novas==3.1.1.3 (from -r requirements.txt (line 1))
137 |     ...
138 |   Collecting numpy==1.9.2 (from -r requirements.txt (line 2))
139 |     ...
140 |   Collecting requests==2.7.0 (from -r requirements.txt (line 3))
141 |     ...
142 |   Installing collected packages: novas, numpy, requests
143 |     Running setup.py install for novas
144 |   Successfully installed novas-3.1.1.3 numpy-1.9.2 requests-2.7.0
145 | 
146 | ``pip`` 还有更多的选项。请参考 `installing-index <https://docs.python.org/3/installing/index.html#installing-index>`_ 指南获取关于 ``pip`` 完整的文档。当你编写一个包并且在 Python Package Index 中也出现的话，请参考 `distributing-index <https://docs.python.org/3/distributing/index.html#distributing-index>`_ 指南。
147 | 


--------------------------------------------------------------------------------
/docs/html/_sources/venv.txt:
--------------------------------------------------------------------------------
  1 | 
  2 | .. _tut-venv:
  3 | 
  4 | *********************************
  5 | 虚拟环境和包
  6 | *********************************
  7 | 
  8 | 简介
  9 | ============
 10 | 
 11 | Python 应用程序经常会使用一些不属于标准库的包和模块。应用程序有时候需要某个特定版本的库，因为它需要一个特定的 bug 已得到修复的库或者它是使用了一个过时版本的库的接口编写的。
 12 | 
 13 | 这就意味着可能无法安装一个 Python 来满足每个应用程序的要求。如果应用程序 A 需要一个特定模块的 1.0 版本但是应用程序 B 需要该模块的 2.0 版本，这两个应用程序的要求是冲突的，安装版本 1.0 或者版本 2.0 将会导致其中一个应用程序不能运行。
 14 | 
 15 | 这个问题的解决方案就是创建一个 `虚拟环境 <https://docs.python.org/3/glossary.html#term-virtual-environment>`_ （通常简称为 “virtualenv”），包含一个特定版本的 Python，以及一些附加的包的独立的目录树。
 16 | 
 17 | 不同的应用程序可以使用不同的虚拟环境。为了解决前面例子中的冲突，应用程序 A 可以有自己的虚拟环境，其中安装了特定模块的 1.0 版本。而应用程序 B 拥有另外一个安装了特定模块 2.0 版本的虚拟环境。如果应用程序 B 需求一个库升级到 3.0 的话，这也不会影响到应用程序 A 的环境。
 18 | 
 19 | 
 20 | 创建虚拟环境
 21 | =============================
 22 | 
 23 | 用于创建和管理虚拟环境的脚本叫做 :program:`pyvenv`。:program:`pyvenv` 通常会安装你可用的 Python 中最新的版本。这个脚本也能指定安装一个特定的版本的 Python，因此如果在你的系统中有多个版本的 Python 的话，你可以运行 ``pyvenv-3.5`` 或者你想要的任何版本来选择一个指定的 Python 版本。
 24 | 
 25 | 要创建一个 virtualenv，首先决定一个你想要存放的目录接着运行 :program:`pyvenv` 后面携带着目录名::
 26 | 
 27 |    pyvenv tutorial-env
 28 | 
 29 | 如果目录不存在的话，这将会创建一个 ``tutorial-env`` 目录，并且也在目录里面创建一个包含 Python 解释器，标准库，以及各种配套文件的 Python “副本”。
 30 | 
 31 | 一旦你已经创建了一个虚拟环境，你必须激活它。
 32 | 
 33 | 在 Windows 上，运行::
 34 | 
 35 |   tutorial-env/Scripts/activate
 36 | 
 37 | 在 Unix 或者 MacOS 上，运行::
 38 | 
 39 |   source tutorial-env/bin/activate
 40 | 
 41 | （这个脚本是用 bash shell 编写的。如果你使用 :program:`csh` 或者 :program:`fish` shell，你应该使用 ``activate.csh`` 和 ``activate.fish`` 来替代。）
 42 | 
 43 | 激活了虚拟环境会改变你的 shell 提示符，显示你正在使用的虚拟环境，并且修改了环境以致运行 ``python`` 将会让你得到了特定的 Python 版本。例如::
 44 | 
 45 |   -> source ~/envs/tutorial-env/bin/activate
 46 |   (tutorial-env) -> python
 47 |   Python 3.5.2+ (3.4:c7b9645a6f35+, May 22 2015, 09:31:25)
 48 |     ...
 49 |   >>> import sys
 50 |   >>> sys.path
 51 |   ['', '/usr/local/lib/python35.zip', ...,
 52 |   '~/envs/tutorial-env/lib/python3.5/site-packages']
 53 |   >>>
 54 | 
 55 | 
 56 | 使用 pip 管理包
 57 | ==========================
 58 | 
 59 | 一旦你激活了一个虚拟环境，可以使用一个叫做 :program:`pip` 程序来安装，升级以及删除包。默认情况下 ``pip`` 将会从 Python Package Index，<https://pypi.python.org/pypi>， 中安装包。你可以通过 web 浏览器浏览它们，或者你也能使用 ``pip`` 有限的搜索功能::
 60 | 
 61 |   (tutorial-env) -> pip search astronomy
 62 |   skyfield               - Elegant astronomy for Python
 63 |   gary                   - Galactic astronomy and gravitational dynamics.
 64 |   novas                  - The United States Naval Observatory NOVAS astronomy library
 65 |   astroobs               - Provides astronomy ephemeris to plan telescope observations
 66 |   PyAstronomy            - A collection of astronomy related tools for Python.
 67 |   ...
 68 | 
 69 | ``pip`` 有许多子命令：“搜索”，“安装”，“卸载”，“freeze”（译者注：这个词语暂时没有合适的词语来翻译），等等。（请参考 `installing-index <https://docs.python.org/3/installing/index.html#installing-index>`_ 指南获取 ``pip`` 更多完整的文档。）
 70 | 
 71 | 你可以安装一个包最新的版本，通过指定包的名称::
 72 | 
 73 |   -> pip install novas
 74 |   Collecting novas
 75 |     Downloading novas-3.1.1.3.tar.gz (136kB)
 76 |   Installing collected packages: novas
 77 |     Running setup.py install for novas
 78 |   Successfully installed novas-3.1.1.3
 79 | 
 80 | 你也能安装一个指定版本的包，通过给出包名后面紧跟着 ``==`` 和版本号::
 81 | 
 82 |   -> pip install requests==2.6.0
 83 |   Collecting requests==2.6.0
 84 |     Using cached requests-2.6.0-py2.py3-none-any.whl
 85 |   Installing collected packages: requests
 86 |   Successfully installed requests-2.6.0
 87 | 
 88 | 如果你重新运行命令（pip install requests==2.6.0），``pip`` 会注意到要求的版本已经安装，不会去做任何事情。你也可以提供一个不同的版本号来安装，或者运行 ``pip
 89 | install --upgrade`` 来升级包到最新版本::
 90 | 
 91 |   -> pip install --upgrade requests
 92 |   Collecting requests
 93 |   Installing collected packages: requests
 94 |     Found existing installation: requests 2.6.0
 95 |       Uninstalling requests-2.6.0:
 96 |         Successfully uninstalled requests-2.6.0
 97 |   Successfully installed requests-2.7.0
 98 | 
 99 | ``pip uninstall`` 后跟一个或者多个包名将会从虚拟环境中移除这些包。
100 | 
101 | ``pip show`` 将会显示一个指定的包的信息::
102 | 
103 |   (tutorial-env) -> pip show requests
104 |   ---
105 |   Metadata-Version: 2.0
106 |   Name: requests
107 |   Version: 2.7.0
108 |   Summary: Python HTTP for Humans.
109 |   Home-page: http://python-requests.org
110 |   Author: Kenneth Reitz
111 |   Author-email: me@kennethreitz.com
112 |   License: Apache 2.0
113 |   Location: /Users/akuchling/envs/tutorial-env/lib/python3.4/site-packages
114 |   Requires:
115 | 
116 | ``pip list`` 将会列出所有安装在虚拟环境中的包::
117 | 
118 |   (tutorial-env) -> pip list
119 |   novas (3.1.1.3)
120 |   numpy (1.9.2)
121 |   pip (7.0.3)
122 |   requests (2.7.0)
123 |   setuptools (16.0)
124 |  
125 | ``pip freeze`` 将会生成一个类似需要安装的包的列表，但是输出采用了 ``pip install`` 期望的格式。常见的做法就是把它们放在一个 ``requirements.txt`` 文件::
126 | 
127 |   (tutorial-env) -> pip freeze > requirements.txt
128 |   (tutorial-env) -> cat requirements.txt
129 |   novas==3.1.1.3
130 |   numpy==1.9.2
131 |   requests==2.7.0
132 | 
133 | ``requirements.txt`` 能够被提交到版本控制中并且作为一个应用程序的一部分。用户们可以使用 ``install -r`` 安装所有必须的包::
134 | 
135 |   -> pip install -r requirements.txt
136 |   Collecting novas==3.1.1.3 (from -r requirements.txt (line 1))
137 |     ...
138 |   Collecting numpy==1.9.2 (from -r requirements.txt (line 2))
139 |     ...
140 |   Collecting requests==2.7.0 (from -r requirements.txt (line 3))
141 |     ...
142 |   Installing collected packages: novas, numpy, requests
143 |     Running setup.py install for novas
144 |   Successfully installed novas-3.1.1.3 numpy-1.9.2 requests-2.7.0
145 | 
146 | ``pip`` 还有更多的选项。请参考 `installing-index <https://docs.python.org/3/installing/index.html#installing-index>`_ 指南获取关于 ``pip`` 完整的文档。当你编写一个包并且在 Python Package Index 中也出现的话，请参考 `distributing-index <https://docs.python.org/3/distributing/index.html#distributing-index>`_ 指南。
147 | 


--------------------------------------------------------------------------------
/docs/html/_sources/whatnow.rst.txt:
--------------------------------------------------------------------------------
 1 | .. _tut-whatnow:
 2 | 
 3 | *********
 4 | 接下来？
 5 | *********
 6 | 
 7 | 读过这本指南应该会让你有兴趣使用 Python —— 可能你已经期待着用 Python 解决你的实际问题了。可以在哪里进行一步学习？ 
 8 | 
 9 | 入门指南是 Python 文档集的一部分。其中的另一些文档包括：
10 | 
11 | * `Python 标准库 <https://docs.python.org/3/library/index.html#library-index>`_：
12 | 
13 |   应该浏览一下这份文档，它为标准库中的类型、函数和模块提供了完整（尽管很简略）的参考资料。标准的 Python 发布版包括了 大量 的附加模块。其中有针对读取 Unix 邮箱、接收 HTTP 文档、生成随机数、解析命令行选项、写 CGI 程序、压缩数据以及很多其它任务的模块。略读一下库参考会给你很多解决问题的思路。
14 | 
15 | * `安装 Python 模块 <https://docs.python.org/3/installing/index.html#installing-index>`_ 展示了如何安装其他 Python 用户编写的附加模块。
16 | 
17 | * `Python 语言参考 <https://docs.python.org/3/reference/index.html#reference-index>`_： 詳細说明了 Python 语法和语义。
18 |   
19 |   它读起来很累，不过对于语言本身，有份完整的手册很有用。
20 | 
21 | 其它 Python 资源：
22 | 
23 | * http://www.python.org： Python 官方网站。它包含代码、文档和 Web 上与 Python 有关的页面链接该网站镜像于全世界的几处其它问题，类似欧洲、日本和澳大利亚。
24 |   
25 |   镜像可能会比主站快，这取决于你的地理位置。
26 | 
27 | * http://docs.python.org： 快速访问 Python 的文档。
28 | 
29 | * http://pypi.python.org： Python 包索引，以前昵称为奶酪店，索引了可供下载的，用户创建的 Python 模块。如果你发布了代码，可以注册到这里，这样别人可以找到它。
30 | 
31 | * http://code.activestate.com/recipes/langs/python/： Python 食谱是大量的示例代码、大型的集合，和有用的脚本。
32 |   
33 |   值得关注的是这次资源已经结集成书，名为《Python 食谱》（O’Reilly & Associates, ISBN 0-596-00797-3。）
34 | 
35 | * http://scipy.org: The Scientific Python 项目包括数组快速计算和处理模块，和大量线性代数、傅里叶变换、非线性solvers、随机数分布，统计分析以及类似的包。
36 | 
37 | 与 Python 有关的问题，以及问题报告，可以发到新闻组 :newsgroup:`comp.lang.python` ，或者发送到邮件组 python-list@python.org 。新闻组和邮件组是开放的，所以发送的消息可以自动的跟到另一个之后。每天有超过 120 个投递（高峰时有数百）,提问（以及回答）问题，为新功能提建议，发布新模块。在发信之前，请查阅 `常见问题
38 | <http://www.python.org/doc/faq/>`_ (亦称 FAQ)，或者在 Python 源码发布包的 :file:`Misc/` 目录中查阅。邮件组也可以在 http://mail.python.org/pipermail/ 访问。FAQ回答了很多被反复提到的问题，很可能已经解答了你的问题。
39 | 
40 | .. Postings figure based on average of last six months activity as
41 |    最近六个月的提交数在 www.egroups.com 有报告；2000年六月：21272 封 / 182 天 ＝ 116.9 封／天，并且还在平稳的上升。（现在是多少？）
42 | 
43 | 
44 | 
45 | 


--------------------------------------------------------------------------------
/docs/html/_sources/whatnow.txt:
--------------------------------------------------------------------------------
 1 | .. _tut-whatnow:
 2 | 
 3 | *********
 4 | 接下来？
 5 | *********
 6 | 
 7 | 读过这本指南应该会让你有兴趣使用 Python —— 可能你已经期待着用 Python 解决你的实际问题了。可以在哪里进行一步学习？ 
 8 | 
 9 | 入门指南是 Python 文档集的一部分。其中的另一些文档包括：
10 | 
11 | * `Python 标准库 <https://docs.python.org/3/library/index.html#library-index>`_：
12 | 
13 |   应该浏览一下这份文档，它为标准库中的类型、函数和模块提供了完整（尽管很简略）的参考资料。标准的 Python 发布版包括了 大量 的附加模块。其中有针对读取 Unix 邮箱、接收 HTTP 文档、生成随机数、解析命令行选项、写 CGI 程序、压缩数据以及很多其它任务的模块。略读一下库参考会给你很多解决问题的思路。
14 | 
15 | * `安装 Python 模块 <https://docs.python.org/3/installing/index.html#installing-index>`_ 展示了如何安装其他 Python 用户编写的附加模块。
16 | 
17 | * `Python 语言参考 <https://docs.python.org/3/reference/index.html#reference-index>`_： 詳細说明了 Python 语法和语义。
18 |   
19 |   它读起来很累，不过对于语言本身，有份完整的手册很有用。
20 | 
21 | 其它 Python 资源：
22 | 
23 | * http://www.python.org： Python 官方网站。它包含代码、文档和 Web 上与 Python 有关的页面链接该网站镜像于全世界的几处其它问题，类似欧洲、日本和澳大利亚。
24 |   
25 |   镜像可能会比主站快，这取决于你的地理位置。
26 | 
27 | * http://docs.python.org： 快速访问 Python 的文档。
28 | 
29 | * http://pypi.python.org： Python 包索引，以前昵称为奶酪店，索引了可供下载的，用户创建的 Python 模块。如果你发布了代码，可以注册到这里，这样别人可以找到它。
30 | 
31 | * http://code.activestate.com/recipes/langs/python/： Python 食谱是大量的示例代码、大型的集合，和有用的脚本。
32 |   
33 |   值得关注的是这次资源已经结集成书，名为《Python 食谱》（O’Reilly & Associates, ISBN 0-596-00797-3。）
34 | 
35 | * http://scipy.org: The Scientific Python 项目包括数组快速计算和处理模块，和大量线性代数、傅里叶变换、非线性solvers、随机数分布，统计分析以及类似的包。
36 | 
37 | 与 Python 有关的问题，以及问题报告，可以发到新闻组 :newsgroup:`comp.lang.python` ，或者发送到邮件组 python-list@python.org 。新闻组和邮件组是开放的，所以发送的消息可以自动的跟到另一个之后。每天有超过 120 个投递（高峰时有数百）,提问（以及回答）问题，为新功能提建议，发布新模块。在发信之前，请查阅 `常见问题
38 | <http://www.python.org/doc/faq/>`_ (亦称 FAQ)，或者在 Python 源码发布包的 :file:`Misc/` 目录中查阅。邮件组也可以在 http://mail.python.org/pipermail/ 访问。FAQ回答了很多被反复提到的问题，很可能已经解答了你的问题。
39 | 
40 | .. Postings figure based on average of last six months activity as
41 |    最近六个月的提交数在 www.egroups.com 有报告；2000年六月：21272 封 / 182 天 ＝ 116.9 封／天，并且还在平稳的上升。（现在是多少？）
42 | 
43 | 
44 | 
45 | 


--------------------------------------------------------------------------------
/docs/html/_static/ajax-loader.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/html/_static/ajax-loader.gif


--------------------------------------------------------------------------------
/docs/html/_static/comment-bright.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/html/_static/comment-bright.png


--------------------------------------------------------------------------------
/docs/html/_static/comment-close.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/html/_static/comment-close.png


--------------------------------------------------------------------------------
/docs/html/_static/comment.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/html/_static/comment.png


--------------------------------------------------------------------------------
/docs/html/_static/css/badge_only.css:
--------------------------------------------------------------------------------
1 | .fa:before{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:before,.clearfix:after{display:table;content:""}.clearfix:after{clear:both}@font-face{font-family:FontAwesome;font-weight:normal;font-style:normal;src:url("../font/fontawesome_webfont.eot");src:url("../font/fontawesome_webfont.eot?#iefix") format("embedded-opentype"),url("../font/fontawesome_webfont.woff") format("woff"),url("../font/fontawesome_webfont.ttf") format("truetype"),url("../font/fontawesome_webfont.svg#FontAwesome") format("svg")}.fa:before{display:inline-block;font-family:FontAwesome;font-style:normal;font-weight:normal;line-height:1;text-decoration:inherit}a .fa{display:inline-block;text-decoration:inherit}li .fa{display:inline-block}li .fa-large:before,li .fa-large:before{width:1.875em}ul.fas{list-style-type:none;margin-left:2em;text-indent:-0.8em}ul.fas li .fa{width:0.8em}ul.fas li .fa-large:before,ul.fas li .fa-large:before{vertical-align:baseline}.fa-book:before{content:""}.icon-book:before{content:""}.fa-caret-down:before{content:""}.icon-caret-down:before{content:""}.fa-caret-up:before{content:""}.icon-caret-up:before{content:""}.fa-caret-left:before{content:""}.icon-caret-left:before{content:""}.fa-caret-right:before{content:""}.icon-caret-right:before{content:""}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;border-top:solid 10px #343131;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;z-index:400}.rst-versions a{color:#2980B9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27AE60;*zoom:1}.rst-versions .rst-current-version:before,.rst-versions .rst-current-version:after{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-versions .rst-current-version .fa{color:#fcfcfc}.rst-versions .rst-current-version .fa-book{float:left}.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#E74C3C;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#F1C40F;color:#000}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:gray;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:solid 1px #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px}.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge .fa-book{float:none}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book{float:left}.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge .rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width: 768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}img{width:100%;height:auto}}
2 | /*# sourceMappingURL=badge_only.css.map */
3 | 


--------------------------------------------------------------------------------
/docs/html/_static/doctools.js:
--------------------------------------------------------------------------------
  1 | /*
  2 |  * doctools.js
  3 |  * ~~~~~~~~~~~
  4 |  *
  5 |  * Sphinx JavaScript utilities for all documentation.
  6 |  *
  7 |  * :copyright: Copyright 2007-2017 by the Sphinx team, see AUTHORS.
  8 |  * :license: BSD, see LICENSE for details.
  9 |  *
 10 |  */
 11 | 
 12 | /**
 13 |  * select a different prefix for underscore
 14 |  */
 15 | $u = _.noConflict();
 16 | 
 17 | /**
 18 |  * make the code below compatible with browsers without
 19 |  * an installed firebug like debugger
 20 | if (!window.console || !console.firebug) {
 21 |   var names = ["log", "debug", "info", "warn", "error", "assert", "dir",
 22 |     "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace",
 23 |     "profile", "profileEnd"];
 24 |   window.console = {};
 25 |   for (var i = 0; i < names.length; ++i)
 26 |     window.console[names[i]] = function() {};
 27 | }
 28 |  */
 29 | 
 30 | /**
 31 |  * small helper function to urldecode strings
 32 |  */
 33 | jQuery.urldecode = function(x) {
 34 |   return decodeURIComponent(x).replace(/\+/g, ' ');
 35 | };
 36 | 
 37 | /**
 38 |  * small helper function to urlencode strings
 39 |  */
 40 | jQuery.urlencode = encodeURIComponent;
 41 | 
 42 | /**
 43 |  * This function returns the parsed url parameters of the
 44 |  * current request. Multiple values per key are supported,
 45 |  * it will always return arrays of strings for the value parts.
 46 |  */
 47 | jQuery.getQueryParameters = function(s) {
 48 |   if (typeof s === 'undefined')
 49 |     s = document.location.search;
 50 |   var parts = s.substr(s.indexOf('?') + 1).split('&');
 51 |   var result = {};
 52 |   for (var i = 0; i < parts.length; i++) {
 53 |     var tmp = parts[i].split('=', 2);
 54 |     var key = jQuery.urldecode(tmp[0]);
 55 |     var value = jQuery.urldecode(tmp[1]);
 56 |     if (key in result)
 57 |       result[key].push(value);
 58 |     else
 59 |       result[key] = [value];
 60 |   }
 61 |   return result;
 62 | };
 63 | 
 64 | /**
 65 |  * highlight a given string on a jquery object by wrapping it in
 66 |  * span elements with the given class name.
 67 |  */
 68 | jQuery.fn.highlightText = function(text, className) {
 69 |   function highlight(node, addItems) {
 70 |     if (node.nodeType === 3) {
 71 |       var val = node.nodeValue;
 72 |       var pos = val.toLowerCase().indexOf(text);
 73 |       if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) {
 74 |         var span;
 75 |         var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg");
 76 |         if (isInSVG) {
 77 |           span = document.createElementNS("http://www.w3.org/2000/svg", "tspan");
 78 |         } else {
 79 |           span = document.createElement("span");
 80 |           span.className = className;
 81 |         }
 82 |         span.appendChild(document.createTextNode(val.substr(pos, text.length)));
 83 |         node.parentNode.insertBefore(span, node.parentNode.insertBefore(
 84 |           document.createTextNode(val.substr(pos + text.length)),
 85 |           node.nextSibling));
 86 |         node.nodeValue = val.substr(0, pos);
 87 |         if (isInSVG) {
 88 |           var bbox = span.getBBox();
 89 |           var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect");
 90 |        	  rect.x.baseVal.value = bbox.x;
 91 |           rect.y.baseVal.value = bbox.y;
 92 |           rect.width.baseVal.value = bbox.width;
 93 |           rect.height.baseVal.value = bbox.height;
 94 |           rect.setAttribute('class', className);
 95 |           var parentOfText = node.parentNode.parentNode;
 96 |           addItems.push({
 97 |               "parent": node.parentNode,
 98 |               "target": rect});
 99 |         }
100 |       }
101 |     }
102 |     else if (!jQuery(node).is("button, select, textarea")) {
103 |       jQuery.each(node.childNodes, function() {
104 |         highlight(this, addItems);
105 |       });
106 |     }
107 |   }
108 |   var addItems = [];
109 |   var result = this.each(function() {
110 |     highlight(this, addItems);
111 |   });
112 |   for (var i = 0; i < addItems.length; ++i) {
113 |     jQuery(addItems[i].parent).before(addItems[i].target);
114 |   }
115 |   return result;
116 | };
117 | 
118 | /*
119 |  * backward compatibility for jQuery.browser
120 |  * This will be supported until firefox bug is fixed.
121 |  */
122 | if (!jQuery.browser) {
123 |   jQuery.uaMatch = function(ua) {
124 |     ua = ua.toLowerCase();
125 | 
126 |     var match = /(chrome)[ \/]([\w.]+)/.exec(ua) ||
127 |       /(webkit)[ \/]([\w.]+)/.exec(ua) ||
128 |       /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) ||
129 |       /(msie) ([\w.]+)/.exec(ua) ||
130 |       ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) ||
131 |       [];
132 | 
133 |     return {
134 |       browser: match[ 1 ] || "",
135 |       version: match[ 2 ] || "0"
136 |     };
137 |   };
138 |   jQuery.browser = {};
139 |   jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true;
140 | }
141 | 
142 | /**
143 |  * Small JavaScript module for the documentation.
144 |  */
145 | var Documentation = {
146 | 
147 |   init : function() {
148 |     this.fixFirefoxAnchorBug();
149 |     this.highlightSearchWords();
150 |     this.initIndexTable();
151 |     
152 |   },
153 | 
154 |   /**
155 |    * i18n support
156 |    */
157 |   TRANSLATIONS : {},
158 |   PLURAL_EXPR : function(n) { return n === 1 ? 0 : 1; },
159 |   LOCALE : 'unknown',
160 | 
161 |   // gettext and ngettext don't access this so that the functions
162 |   // can safely bound to a different name (_ = Documentation.gettext)
163 |   gettext : function(string) {
164 |     var translated = Documentation.TRANSLATIONS[string];
165 |     if (typeof translated === 'undefined')
166 |       return string;
167 |     return (typeof translated === 'string') ? translated : translated[0];
168 |   },
169 | 
170 |   ngettext : function(singular, plural, n) {
171 |     var translated = Documentation.TRANSLATIONS[singular];
172 |     if (typeof translated === 'undefined')
173 |       return (n == 1) ? singular : plural;
174 |     return translated[Documentation.PLURALEXPR(n)];
175 |   },
176 | 
177 |   addTranslations : function(catalog) {
178 |     for (var key in catalog.messages)
179 |       this.TRANSLATIONS[key] = catalog.messages[key];
180 |     this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')');
181 |     this.LOCALE = catalog.locale;
182 |   },
183 | 
184 |   /**
185 |    * add context elements like header anchor links
186 |    */
187 |   addContextElements : function() {
188 |     $('div[id] > :header:first').each(function() {
189 |       $('<a class="headerlink">\u00B6</a>').
190 |       attr('href', '#' + this.id).
191 |       attr('title', _('Permalink to this headline')).
192 |       appendTo(this);
193 |     });
194 |     $('dt[id]').each(function() {
195 |       $('<a class="headerlink">\u00B6</a>').
196 |       attr('href', '#' + this.id).
197 |       attr('title', _('Permalink to this definition')).
198 |       appendTo(this);
199 |     });
200 |   },
201 | 
202 |   /**
203 |    * workaround a firefox stupidity
204 |    * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075
205 |    */
206 |   fixFirefoxAnchorBug : function() {
207 |     if (document.location.hash)
208 |       window.setTimeout(function() {
209 |         document.location.href += '';
210 |       }, 10);
211 |   },
212 | 
213 |   /**
214 |    * highlight the search words provided in the url in the text
215 |    */
216 |   highlightSearchWords : function() {
217 |     var params = $.getQueryParameters();
218 |     var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : [];
219 |     if (terms.length) {
220 |       var body = $('div.body');
221 |       if (!body.length) {
222 |         body = $('body');
223 |       }
224 |       window.setTimeout(function() {
225 |         $.each(terms, function() {
226 |           body.highlightText(this.toLowerCase(), 'highlighted');
227 |         });
228 |       }, 10);
229 |       $('<p class="highlight-link"><a href="javascript:Documentation.' +
230 |         'hideSearchWords()">' + _('Hide Search Matches') + '</a></p>')
231 |           .appendTo($('#searchbox'));
232 |     }
233 |   },
234 | 
235 |   /**
236 |    * init the domain index toggle buttons
237 |    */
238 |   initIndexTable : function() {
239 |     var togglers = $('img.toggler').click(function() {
240 |       var src = $(this).attr('src');
241 |       var idnum = $(this).attr('id').substr(7);
242 |       $('tr.cg-' + idnum).toggle();
243 |       if (src.substr(-9) === 'minus.png')
244 |         $(this).attr('src', src.substr(0, src.length-9) + 'plus.png');
245 |       else
246 |         $(this).attr('src', src.substr(0, src.length-8) + 'minus.png');
247 |     }).css('display', '');
248 |     if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) {
249 |         togglers.click();
250 |     }
251 |   },
252 | 
253 |   /**
254 |    * helper function to hide the search marks again
255 |    */
256 |   hideSearchWords : function() {
257 |     $('#searchbox .highlight-link').fadeOut(300);
258 |     $('span.highlighted').removeClass('highlighted');
259 |   },
260 | 
261 |   /**
262 |    * make the url absolute
263 |    */
264 |   makeURL : function(relativeURL) {
265 |     return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL;
266 |   },
267 | 
268 |   /**
269 |    * get the current relative url
270 |    */
271 |   getCurrentURL : function() {
272 |     var path = document.location.pathname;
273 |     var parts = path.split(/\//);
274 |     $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() {
275 |       if (this === '..')
276 |         parts.pop();
277 |     });
278 |     var url = parts.join('/');
279 |     return path.substring(url.lastIndexOf('/') + 1, path.length - 1);
280 |   },
281 | 
282 |   initOnKeyListeners: function() {
283 |     $(document).keyup(function(event) {
284 |       var activeElementType = document.activeElement.tagName;
285 |       // don't navigate when in search box or textarea
286 |       if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT') {
287 |         switch (event.keyCode) {
288 |           case 37: // left
289 |             var prevHref = $('link[rel="prev"]').prop('href');
290 |             if (prevHref) {
291 |               window.location.href = prevHref;
292 |               return false;
293 |             }
294 |           case 39: // right
295 |             var nextHref = $('link[rel="next"]').prop('href');
296 |             if (nextHref) {
297 |               window.location.href = nextHref;
298 |               return false;
299 |             }
300 |         }
301 |       }
302 |     });
303 |   }
304 | };
305 | 
306 | // quick alias for translations
307 | _ = Documentation.gettext;
308 | 
309 | $(document).ready(function() {
310 |   Documentation.init();
311 | });


--------------------------------------------------------------------------------
/docs/html/_static/down-pressed.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/html/_static/down-pressed.png


--------------------------------------------------------------------------------
/docs/html/_static/down.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/html/_static/down.png


--------------------------------------------------------------------------------
/docs/html/_static/file.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/html/_static/file.png


--------------------------------------------------------------------------------
/docs/html/_static/fonts/FontAwesome.otf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/html/_static/fonts/FontAwesome.otf


--------------------------------------------------------------------------------
/docs/html/_static/fonts/fontawesome-webfont.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/html/_static/fonts/fontawesome-webfont.eot


--------------------------------------------------------------------------------
/docs/html/_static/fonts/fontawesome-webfont.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/html/_static/fonts/fontawesome-webfont.ttf


--------------------------------------------------------------------------------
/docs/html/_static/fonts/fontawesome-webfont.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/html/_static/fonts/fontawesome-webfont.woff


--------------------------------------------------------------------------------
/docs/html/_static/js/theme.js:
--------------------------------------------------------------------------------
 1 | $( document ).ready(function() {
 2 |     // Shift nav in mobile when clicking the menu.
 3 |     $(document).on('click', "[data-toggle='wy-nav-top']", function() {
 4 |       $("[data-toggle='wy-nav-shift']").toggleClass("shift");
 5 |       $("[data-toggle='rst-versions']").toggleClass("shift");
 6 |     });
 7 |     // Close menu when you click a link.
 8 |     $(document).on('click', ".wy-menu-vertical .current ul li a", function() {
 9 |       $("[data-toggle='wy-nav-shift']").removeClass("shift");
10 |       $("[data-toggle='rst-versions']").toggleClass("shift");
11 |     });
12 |     $(document).on('click', "[data-toggle='rst-current-version']", function() {
13 |       $("[data-toggle='rst-versions']").toggleClass("shift-up");
14 |     });  
15 |     // Make tables responsive
16 |     $("table.docutils:not(.field-list)").wrap("<div class='wy-table-responsive'></div>");
17 | });
18 | 
19 | window.SphinxRtdTheme = (function (jquery) {
20 |     var stickyNav = (function () {
21 |         var navBar,
22 |             win,
23 |             stickyNavCssClass = 'stickynav',
24 |             applyStickNav = function () {
25 |                 if (navBar.height() <= win.height()) {
26 |                     navBar.addClass(stickyNavCssClass);
27 |                 } else {
28 |                     navBar.removeClass(stickyNavCssClass);
29 |                 }
30 |             },
31 |             enable = function () {
32 |                 applyStickNav();
33 |                 win.on('resize', applyStickNav);
34 |             },
35 |             init = function () {
36 |                 navBar = jquery('nav.wy-nav-side:first');
37 |                 win    = jquery(window);
38 |             };
39 |         jquery(init);
40 |         return {
41 |             enable : enable
42 |         };
43 |     }());
44 |     return {
45 |         StickyNav : stickyNav
46 |     };
47 | }($));
48 | 


--------------------------------------------------------------------------------
/docs/html/_static/minus.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/html/_static/minus.png


--------------------------------------------------------------------------------
/docs/html/_static/plus.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/html/_static/plus.png


--------------------------------------------------------------------------------
/docs/html/_static/pygments.css:
--------------------------------------------------------------------------------
 1 | .highlight .hll { background-color: #ffffcc }
 2 | .highlight  { background: #eeffcc; }
 3 | .highlight .c { color: #408090; font-style: italic } /* Comment */
 4 | .highlight .err { border: 1px solid #FF0000 } /* Error */
 5 | .highlight .k { color: #007020; font-weight: bold } /* Keyword */
 6 | .highlight .o { color: #666666 } /* Operator */
 7 | .highlight .ch { color: #408090; font-style: italic } /* Comment.Hashbang */
 8 | .highlight .cm { color: #408090; font-style: italic } /* Comment.Multiline */
 9 | .highlight .cp { color: #007020 } /* Comment.Preproc */
10 | .highlight .cpf { color: #408090; font-style: italic } /* Comment.PreprocFile */
11 | .highlight .c1 { color: #408090; font-style: italic } /* Comment.Single */
12 | .highlight .cs { color: #408090; background-color: #fff0f0 } /* Comment.Special */
13 | .highlight .gd { color: #A00000 } /* Generic.Deleted */
14 | .highlight .ge { font-style: italic } /* Generic.Emph */
15 | .highlight .gr { color: #FF0000 } /* Generic.Error */
16 | .highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */
17 | .highlight .gi { color: #00A000 } /* Generic.Inserted */
18 | .highlight .go { color: #333333 } /* Generic.Output */
19 | .highlight .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */
20 | .highlight .gs { font-weight: bold } /* Generic.Strong */
21 | .highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */
22 | .highlight .gt { color: #0044DD } /* Generic.Traceback */
23 | .highlight .kc { color: #007020; font-weight: bold } /* Keyword.Constant */
24 | .highlight .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */
25 | .highlight .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */
26 | .highlight .kp { color: #007020 } /* Keyword.Pseudo */
27 | .highlight .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */
28 | .highlight .kt { color: #902000 } /* Keyword.Type */
29 | .highlight .m { color: #208050 } /* Literal.Number */
30 | .highlight .s { color: #4070a0 } /* Literal.String */
31 | .highlight .na { color: #4070a0 } /* Name.Attribute */
32 | .highlight .nb { color: #007020 } /* Name.Builtin */
33 | .highlight .nc { color: #0e84b5; font-weight: bold } /* Name.Class */
34 | .highlight .no { color: #60add5 } /* Name.Constant */
35 | .highlight .nd { color: #555555; font-weight: bold } /* Name.Decorator */
36 | .highlight .ni { color: #d55537; font-weight: bold } /* Name.Entity */
37 | .highlight .ne { color: #007020 } /* Name.Exception */
38 | .highlight .nf { color: #06287e } /* Name.Function */
39 | .highlight .nl { color: #002070; font-weight: bold } /* Name.Label */
40 | .highlight .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */
41 | .highlight .nt { color: #062873; font-weight: bold } /* Name.Tag */
42 | .highlight .nv { color: #bb60d5 } /* Name.Variable */
43 | .highlight .ow { color: #007020; font-weight: bold } /* Operator.Word */
44 | .highlight .w { color: #bbbbbb } /* Text.Whitespace */
45 | .highlight .mb { color: #208050 } /* Literal.Number.Bin */
46 | .highlight .mf { color: #208050 } /* Literal.Number.Float */
47 | .highlight .mh { color: #208050 } /* Literal.Number.Hex */
48 | .highlight .mi { color: #208050 } /* Literal.Number.Integer */
49 | .highlight .mo { color: #208050 } /* Literal.Number.Oct */
50 | .highlight .sa { color: #4070a0 } /* Literal.String.Affix */
51 | .highlight .sb { color: #4070a0 } /* Literal.String.Backtick */
52 | .highlight .sc { color: #4070a0 } /* Literal.String.Char */
53 | .highlight .dl { color: #4070a0 } /* Literal.String.Delimiter */
54 | .highlight .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */
55 | .highlight .s2 { color: #4070a0 } /* Literal.String.Double */
56 | .highlight .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */
57 | .highlight .sh { color: #4070a0 } /* Literal.String.Heredoc */
58 | .highlight .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */
59 | .highlight .sx { color: #c65d09 } /* Literal.String.Other */
60 | .highlight .sr { color: #235388 } /* Literal.String.Regex */
61 | .highlight .s1 { color: #4070a0 } /* Literal.String.Single */
62 | .highlight .ss { color: #517918 } /* Literal.String.Symbol */
63 | .highlight .bp { color: #007020 } /* Name.Builtin.Pseudo */
64 | .highlight .fm { color: #06287e } /* Name.Function.Magic */
65 | .highlight .vc { color: #bb60d5 } /* Name.Variable.Class */
66 | .highlight .vg { color: #bb60d5 } /* Name.Variable.Global */
67 | .highlight .vi { color: #bb60d5 } /* Name.Variable.Instance */
68 | .highlight .vm { color: #bb60d5 } /* Name.Variable.Magic */
69 | .highlight .il { color: #208050 } /* Literal.Number.Integer.Long */


--------------------------------------------------------------------------------
/docs/html/_static/up-pressed.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/html/_static/up-pressed.png


--------------------------------------------------------------------------------
/docs/html/_static/up.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/html/_static/up.png


--------------------------------------------------------------------------------
/docs/html/objects.inv:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/html/objects.inv


--------------------------------------------------------------------------------
/docs/make.bat:
--------------------------------------------------------------------------------
  1 | @ECHO OFF
  2 | 
  3 | REM Command file for Sphinx documentation
  4 | 
  5 | if "%SPHINXBUILD%" == "" (
  6 | 	set SPHINXBUILD=sphinx-build
  7 | )
  8 | set BUILDDIR=build
  9 | set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% source
 10 | set I18NSPHINXOPTS=%SPHINXOPTS% source
 11 | if NOT "%PAPER%" == "" (
 12 | 	set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
 13 | 	set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
 14 | )
 15 | 
 16 | if "%1" == "" goto help
 17 | 
 18 | if "%1" == "help" (
 19 | 	:help
 20 | 	echo.Please use `make ^<target^>` where ^<target^> is one of
 21 | 	echo.  html       to make standalone HTML files
 22 | 	echo.  dirhtml    to make HTML files named index.html in directories
 23 | 	echo.  singlehtml to make a single large HTML file
 24 | 	echo.  pickle     to make pickle files
 25 | 	echo.  json       to make JSON files
 26 | 	echo.  htmlhelp   to make HTML files and a HTML help project
 27 | 	echo.  qthelp     to make HTML files and a qthelp project
 28 | 	echo.  devhelp    to make HTML files and a Devhelp project
 29 | 	echo.  epub       to make an epub
 30 | 	echo.  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
 31 | 	echo.  text       to make text files
 32 | 	echo.  man        to make manual pages
 33 | 	echo.  texinfo    to make Texinfo files
 34 | 	echo.  gettext    to make PO message catalogs
 35 | 	echo.  changes    to make an overview over all changed/added/deprecated items
 36 | 	echo.  linkcheck  to check all external links for integrity
 37 | 	echo.  doctest    to run all doctests embedded in the documentation if enabled
 38 | 	goto end
 39 | )
 40 | 
 41 | if "%1" == "clean" (
 42 | 	for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
 43 | 	del /q /s %BUILDDIR%\*
 44 | 	goto end
 45 | )
 46 | 
 47 | if "%1" == "html" (
 48 | 	%SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
 49 | 	if errorlevel 1 exit /b 1
 50 | 	echo.
 51 | 	echo.Build finished. The HTML pages are in %BUILDDIR%/html.
 52 | 	goto end
 53 | )
 54 | 
 55 | if "%1" == "dirhtml" (
 56 | 	%SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
 57 | 	if errorlevel 1 exit /b 1
 58 | 	echo.
 59 | 	echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
 60 | 	goto end
 61 | )
 62 | 
 63 | if "%1" == "singlehtml" (
 64 | 	%SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
 65 | 	if errorlevel 1 exit /b 1
 66 | 	echo.
 67 | 	echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
 68 | 	goto end
 69 | )
 70 | 
 71 | if "%1" == "pickle" (
 72 | 	%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
 73 | 	if errorlevel 1 exit /b 1
 74 | 	echo.
 75 | 	echo.Build finished; now you can process the pickle files.
 76 | 	goto end
 77 | )
 78 | 
 79 | if "%1" == "json" (
 80 | 	%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
 81 | 	if errorlevel 1 exit /b 1
 82 | 	echo.
 83 | 	echo.Build finished; now you can process the JSON files.
 84 | 	goto end
 85 | )
 86 | 
 87 | if "%1" == "htmlhelp" (
 88 | 	%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
 89 | 	if errorlevel 1 exit /b 1
 90 | 	echo.
 91 | 	echo.Build finished; now you can run HTML Help Workshop with the ^
 92 | .hhp project file in %BUILDDIR%/htmlhelp.
 93 | 	goto end
 94 | )
 95 | 
 96 | if "%1" == "qthelp" (
 97 | 	%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
 98 | 	if errorlevel 1 exit /b 1
 99 | 	echo.
100 | 	echo.Build finished; now you can run "qcollectiongenerator" with the ^
101 | .qhcp project file in %BUILDDIR%/qthelp, like this:
102 | 	echo.^> qcollectiongenerator %BUILDDIR%\qthelp\Pythontutorial.qhcp
103 | 	echo.To view the help file:
104 | 	echo.^> assistant -collectionFile %BUILDDIR%\qthelp\Pythontutorial.ghc
105 | 	goto end
106 | )
107 | 
108 | if "%1" == "devhelp" (
109 | 	%SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
110 | 	if errorlevel 1 exit /b 1
111 | 	echo.
112 | 	echo.Build finished.
113 | 	goto end
114 | )
115 | 
116 | if "%1" == "epub" (
117 | 	%SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
118 | 	if errorlevel 1 exit /b 1
119 | 	echo.
120 | 	echo.Build finished. The epub file is in %BUILDDIR%/epub.
121 | 	goto end
122 | )
123 | 
124 | if "%1" == "latex" (
125 | 	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
126 | 	if errorlevel 1 exit /b 1
127 | 	echo.
128 | 	echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
129 | 	goto end
130 | )
131 | 
132 | if "%1" == "text" (
133 | 	%SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
134 | 	if errorlevel 1 exit /b 1
135 | 	echo.
136 | 	echo.Build finished. The text files are in %BUILDDIR%/text.
137 | 	goto end
138 | )
139 | 
140 | if "%1" == "man" (
141 | 	%SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
142 | 	if errorlevel 1 exit /b 1
143 | 	echo.
144 | 	echo.Build finished. The manual pages are in %BUILDDIR%/man.
145 | 	goto end
146 | )
147 | 
148 | if "%1" == "texinfo" (
149 | 	%SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
150 | 	if errorlevel 1 exit /b 1
151 | 	echo.
152 | 	echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
153 | 	goto end
154 | )
155 | 
156 | if "%1" == "gettext" (
157 | 	%SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
158 | 	if errorlevel 1 exit /b 1
159 | 	echo.
160 | 	echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
161 | 	goto end
162 | )
163 | 
164 | if "%1" == "changes" (
165 | 	%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
166 | 	if errorlevel 1 exit /b 1
167 | 	echo.
168 | 	echo.The overview file is in %BUILDDIR%/changes.
169 | 	goto end
170 | )
171 | 
172 | if "%1" == "linkcheck" (
173 | 	%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
174 | 	if errorlevel 1 exit /b 1
175 | 	echo.
176 | 	echo.Link check complete; look for any errors in the above output ^
177 | or in %BUILDDIR%/linkcheck/output.txt.
178 | 	goto end
179 | )
180 | 
181 | if "%1" == "doctest" (
182 | 	%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
183 | 	if errorlevel 1 exit /b 1
184 | 	echo.
185 | 	echo.Testing of doctests in the sources finished, look at the ^
186 | results in %BUILDDIR%/doctest/output.txt.
187 | 	goto end
188 | )
189 | 
190 | :end
191 | 


--------------------------------------------------------------------------------
/docs/source/_templates/layout_web.html:
--------------------------------------------------------------------------------
 1 | {% extends "!layout.html" %}
 2 | 
 3 | {% block sidebarsearch %}
 4 | {{ super() }}
 5 | 
 6 | <script async src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
 7 | <!-- 首页侧边 -->
 8 | <ins class="adsbygoogle"
 9 |      style="display:inline-block;width:200px;height:200px"
10 |      data-ad-client="ca-pub-3421553373953599"
11 |      data-ad-slot="3551838308"></ins>
12 | <script>
13 | (adsbygoogle = window.adsbygoogle || []).push({});
14 | </script>
15 | 
16 | {% endblock %}
17 | 
18 | {% block footer %}
19 | <div class="footer">
20 |     <p>
21 |  © Copyright Translate by march.liu, Reorganize by D.D 2013. Created using
22 | <a href="http://sphinx.pocoo.org/">Sphinx</a>
23 | 1.2. 
24 | </p>
25 | 
26 | <script>
27 | var _hmt = _hmt || [];
28 | (function() {
29 |   var hm = document.createElement("script");
30 |   hm.src = "//hm.baidu.com/hm.js?9adc7a1c86496c8e2bc61c4f8fc92d30";
31 |   var s = document.getElementsByTagName("script")[0]; 
32 |   s.parentNode.insertBefore(hm, s);
33 | })();
34 | </script>
35 | 
36 | <p><a href="http://www.miitbeian.gov.cn/">京ICP备14002119号-1</a></p>
37 | <hr/>
38 | 
39 | 
40 | <script async src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
41 | <!-- pythondoc 首页下方 -->
42 | <ins class="adsbygoogle"
43 |      style="display:inline-block;width:970px;height:90px"
44 |      data-ad-client="ca-pub-3421553373953599"
45 |      data-ad-slot="6985889234"></ins>
46 | <script>
47 | (adsbygoogle = window.adsbygoogle || []).push({});
48 | </script>
49 | 
50 | 
51 | </div>
52 | 
53 | 
54 | 
55 | {% endblock %}
56 | 


--------------------------------------------------------------------------------
/docs/source/_themes/sphinx_rtd_theme/__init__.py:
--------------------------------------------------------------------------------
 1 | """Sphinx ReadTheDocs theme.
 2 | 
 3 | From https://github.com/ryan-roemer/sphinx-bootstrap-theme.
 4 | 
 5 | """
 6 | import os
 7 | 
 8 | VERSION = (0, 1, 5)
 9 | 
10 | __version__ = ".".join(str(v) for v in VERSION)
11 | __version_full__ = __version__
12 | 
13 | 
14 | def get_html_theme_path():
15 |     """Return list of HTML theme paths."""
16 |     cur_dir = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))
17 |     return cur_dir
18 | 


--------------------------------------------------------------------------------
/docs/source/_themes/sphinx_rtd_theme/breadcrumbs.html:
--------------------------------------------------------------------------------
 1 | <div role="navigation" aria-label="breadcrumbs navigation">
 2 |   <ul class="wy-breadcrumbs">
 3 |     <li><a href="{{ pathto(master_doc) }}">Docs</a> &raquo;</li>
 4 |       {% for doc in parents %}
 5 |           <li><a href="{{ doc.link|e }}">{{ doc.title }}</a> &raquo;</li>
 6 |       {% endfor %}
 7 |     <li>{{ title }}</li>
 8 |       <li class="wy-breadcrumbs-aside">
 9 |         {% if display_github %}
10 |           <a href="https://github.com/{{ github_user }}/{{ github_repo }}/blob/{{ github_version }}{{ conf_py_path }}{{ pagename }}{{ source_suffix }}" class="fa fa-github"> Edit on GitHub</a>
11 |         {% elif display_bitbucket %}
12 |           <a href="https://bitbucket.org/{{ bitbucket_user }}/{{ bitbucket_repo }}/src/{{ bitbucket_version}}{{ conf_py_path }}{{ pagename }}{{ source_suffix }}" class="fa fa-bitbucket"> Edit on Bitbucket</a>
13 |         {% elif show_source and has_source and sourcename %}
14 |           <a href="{{ pathto('_sources/' + sourcename, true)|e }}" rel="nofollow"> View page source</a>
15 |         {% endif %}
16 |       </li>
17 |   </ul>
18 |   <hr/>
19 | </div>
20 | 


--------------------------------------------------------------------------------
/docs/source/_themes/sphinx_rtd_theme/footer.html:
--------------------------------------------------------------------------------
 1 | <footer>
 2 |   {% if next or prev %}
 3 |     <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
 4 |       {% if next %}
 5 |         <a href="{{ next.link|e }}" class="btn btn-neutral float-right" title="{{ next.title|striptags|e }}">Next <span class="fa fa-arrow-circle-right"></span></a>
 6 |       {% endif %}
 7 |       {% if prev %}
 8 |         <a href="{{ prev.link|e }}" class="btn btn-neutral" title="{{ prev.title|striptags|e }}"><span class="fa fa-arrow-circle-left"></span> Previous</a>
 9 |       {% endif %}
10 |     </div>
11 |   {% endif %}
12 | 
13 |   <hr/>
14 | 
15 |   <div role="contentinfo">
16 |     <p>
17 |     {%- if show_copyright %}
18 |       {%- if hasdoc('copyright') %}
19 |         {% trans path=pathto('copyright'), copyright=copyright|e %}&copy; <a href="{{ path }}">Copyright</a> {{ copyright }}.{% endtrans %}
20 |       {%- else %}
21 |         {% trans copyright=copyright|e %}&copy; Copyright {{ copyright }}.{% endtrans %}
22 |       {%- endif %}
23 |     {%- endif %}
24 | 
25 |     {%- if last_updated %}
26 |       {% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %}
27 |     {%- endif %}
28 |     </p>
29 |   </div>
30 | 
31 |   {% trans %}Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>{% endtrans %}.
32 | 
33 | 
34 |     &nbsp;
35 |   &nbsp;
36 |   <div class="footer-ad">
37 | <!--谷歌广告-->
38 | <script async src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
39 | <!-- pythondoc 首页下方测试版 -->
40 | <ins class="adsbygoogle"
41 |      style="display:block"
42 |      data-ad-client="ca-pub-3421553373953599"
43 |      data-ad-slot="2952943639"
44 |      data-ad-format="auto"></ins>
45 | <script>
46 | (adsbygoogle = window.adsbygoogle || []).push({});
47 | </script>
48 | <!--百度统计-->
49 | <script>
50 | var _hmt = _hmt || [];
51 | (function() {
52 |   var hm = document.createElement("script");
53 |   hm.src = "//hm.baidu.com/hm.js?9adc7a1c86496c8e2bc61c4f8fc92d30";
54 |   var s = document.getElementsByTagName("script")[0]; 
55 |   s.parentNode.insertBefore(hm, s);
56 | })();
57 | </script>
58 | 
59 | 
60 | </div>
61 |   
62 | </footer>
63 | 


--------------------------------------------------------------------------------
/docs/source/_themes/sphinx_rtd_theme/layout.html:
--------------------------------------------------------------------------------
  1 | {# TEMPLATE VAR SETTINGS #}
  2 | {%- set url_root = pathto('', 1) %}
  3 | {%- if url_root == '#' %}{% set url_root = '' %}{% endif %}
  4 | {%- if not embedded and docstitle %}
  5 |   {%- set titlesuffix = " &mdash; "|safe + docstitle|e %}
  6 | {%- else %}
  7 |   {%- set titlesuffix = "" %}
  8 | {%- endif %}
  9 | 
 10 | <!DOCTYPE html>
 11 | <!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 12 | <!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 13 | <head>
 14 |   <meta charset="utf-8">
 15 |   <meta name="viewport" content="width=device-width, initial-scale=1.0">
 16 |   {% block htmltitle %}
 17 |   <title>{{ title|striptags|e }}{{ titlesuffix }}</title>
 18 |   {% endblock %}
 19 | 
 20 |   {# FAVICON #}
 21 |   {% if favicon %}
 22 |     <link rel="shortcut icon" href="{{ pathto('_static/' + favicon, 1) }}"/>
 23 |   {% endif %}
 24 | 
 25 |   {# CSS #}
 26 |   <link href='https://fonts.googleapis.com/css?family=Lato:400,700,400italic,700italic|Roboto+Slab:400,700|Inconsolata:400,700&subset=latin,cyrillic' rel='stylesheet' type='text/css'>
 27 | 
 28 |   {# OPENSEARCH #}
 29 |   {% if not embedded %}
 30 |     {% if use_opensearch %}
 31 |       <link rel="search" type="application/opensearchdescription+xml" title="{% trans docstitle=docstitle|e %}Search within {{ docstitle }}{% endtrans %}" href="{{ pathto('_static/opensearch.xml', 1) }}"/>
 32 |     {% endif %}
 33 | 
 34 |   {% endif %}
 35 | 
 36 |   {# RTD hosts this file, so just load on non RTD builds #}
 37 |   {% if not READTHEDOCS %}
 38 |     <link rel="stylesheet" href="{{ pathto('_static/' + style, 1) }}" type="text/css" />
 39 |   {% endif %}
 40 | 
 41 |   {% for cssfile in css_files %}
 42 |     <link rel="stylesheet" href="{{ pathto(cssfile, 1) }}" type="text/css" />
 43 |   {% endfor %}
 44 | 
 45 |   {%- block linktags %}
 46 |     {%- if hasdoc('about') %}
 47 |         <link rel="author" title="{{ _('About these documents') }}"
 48 |               href="{{ pathto('about') }}"/>
 49 |     {%- endif %}
 50 |     {%- if hasdoc('genindex') %}
 51 |         <link rel="index" title="{{ _('Index') }}"
 52 |               href="{{ pathto('genindex') }}"/>
 53 |     {%- endif %}
 54 |     {%- if hasdoc('search') %}
 55 |         <link rel="search" title="{{ _('Search') }}" href="{{ pathto('search') }}"/>
 56 |     {%- endif %}
 57 |     {%- if hasdoc('copyright') %}
 58 |         <link rel="copyright" title="{{ _('Copyright') }}" href="{{ pathto('copyright') }}"/>
 59 |     {%- endif %}
 60 |     <link rel="top" title="{{ docstitle|e }}" href="{{ pathto('index') }}"/>
 61 |     {%- if parents %}
 62 |         <link rel="up" title="{{ parents[-1].title|striptags|e }}" href="{{ parents[-1].link|e }}"/>
 63 |     {%- endif %}
 64 |     {%- if next %}
 65 |         <link rel="next" title="{{ next.title|striptags|e }}" href="{{ next.link|e }}"/>
 66 |     {%- endif %}
 67 |     {%- if prev %}
 68 |         <link rel="prev" title="{{ prev.title|striptags|e }}" href="{{ prev.link|e }}"/>
 69 |     {%- endif %}
 70 |   {%- endblock %}
 71 |   {%- block extrahead %} {% endblock %}
 72 | 
 73 |   {# Keep modernizr in head - http://modernizr.com/docs/#installing #}
 74 |   <script src="https://cdnjs.cloudflare.com/ajax/libs/modernizr/2.6.2/modernizr.min.js"></script>
 75 | 
 76 | </head>
 77 | 
 78 | <body class="wy-body-for-nav" role="document">
 79 | 
 80 |   <div class="wy-grid-for-nav">
 81 | 
 82 |     {# SIDE NAV, TOGGLES ON MOBILE #}
 83 |     <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 84 |       <div class="wy-side-nav-search">
 85 |         {% block sidebartitle %}
 86 |           <a href="{{ pathto(master_doc) }}" class="fa fa-home"> {{ project }}</a>
 87 |         {% endblock %}
 88 |         {% include "searchbox.html" %}
 89 |       </div>
 90 | 
 91 |       <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 92 |         {% block menu %}
 93 |           {% set toctree = toctree(maxdepth=2, collapse=False, includehidden=True) %}
 94 |           {% if toctree %}
 95 |               {{ toctree }}
 96 |           {% else %}
 97 |               <!-- Local TOC -->
 98 |               <div class="local-toc">{{ toc }}</div>
 99 |           {% endif %}
100 |         {% endblock %}
101 |       </div>
102 |           &nbsp;
103 |         &nbsp;
104 |       <div>
105 |         <script type="text/javascript"><!--
106 | google_ad_client = "ca-pub-3421553373953599";
107 | /* 首页侧边 */
108 | google_ad_slot = "3551838308";
109 | google_ad_width = 200;
110 | google_ad_height = 200;
111 | //-->
112 | </script>
113 | <script type="text/javascript"
114 | src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
115 | </script>
116 |       </div>
117 |       &nbsp;
118 | 
119 |     </nav>
120 | 
121 |     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
122 | 
123 |       {# MOBILE NAV, TRIGGLES SIDE NAV ON TOGGLE #}
124 |       <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
125 |         <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
126 |         <a href="{{ pathto(master_doc) }}">{{ project }}</a>
127 |       </nav>
128 | 
129 | 
130 |       {# PAGE CONTENT #}
131 |       <div class="wy-nav-content">
132 |         <div class="rst-content">
133 |           {% include "breadcrumbs.html" %}
134 |           <div role="main" class="document">
135 |             {% block body %}{% endblock %}
136 |           </div>
137 |           {% include "footer.html" %}
138 |         </div>
139 |       </div>
140 | 
141 |     </section>
142 | 
143 |   </div>
144 |   {% include "versions.html" %}
145 | 
146 |   {% if not embedded %}
147 | 
148 |     <script type="text/javascript">
149 |         var DOCUMENTATION_OPTIONS = {
150 |             URL_ROOT:'{{ url_root }}',
151 |             VERSION:'{{ release|e }}',
152 |             COLLAPSE_INDEX:false,
153 |             FILE_SUFFIX:'{{ '' if no_search_suffix else file_suffix }}',
154 |             HAS_SOURCE:  {{ has_source|lower }}
155 |         };
156 |     </script>
157 |     {%- for scriptfile in script_files %}
158 |       <script type="text/javascript" src="{{ pathto(scriptfile, 1) }}"></script>
159 |     {%- endfor %}
160 | 
161 |   {% endif %}
162 | 
163 |   {# RTD hosts this file, so just load on non RTD builds #}
164 |   {% if not READTHEDOCS %}
165 |     <script type="text/javascript" src="{{ pathto('_static/js/theme.js', 1) }}"></script>
166 |   {% endif %}
167 | 
168 |   {# STICKY NAVIGATION #}
169 |   {% if theme_sticky_navigation %}
170 |   <script type="text/javascript">
171 |       jQuery(function () {
172 |           SphinxRtdTheme.StickyNav.enable();
173 |       });
174 |   </script>
175 |   {% endif %}
176 | 
177 |   {%- block footer %} {% endblock %}
178 | 
179 | </body>
180 | </html>
181 | 


--------------------------------------------------------------------------------
/docs/source/_themes/sphinx_rtd_theme/layout_old.html:
--------------------------------------------------------------------------------
  1 | {#
  2 |     basic/layout.html
  3 |     ~~~~~~~~~~~~~~~~~
  4 | 
  5 |     Master layout template for Sphinx themes.
  6 | 
  7 |     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
  8 |     :license: BSD, see LICENSE for details.
  9 | #}
 10 | {%- block doctype -%}
 11 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 12 |   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 13 | {%- endblock %}
 14 | {%- set reldelim1 = reldelim1 is not defined and ' &raquo;' or reldelim1 %}
 15 | {%- set reldelim2 = reldelim2 is not defined and ' |' or reldelim2 %}
 16 | {%- set render_sidebar = (not embedded) and (not theme_nosidebar|tobool) and
 17 |                          (sidebars != []) %}
 18 | {%- set url_root = pathto('', 1) %}
 19 | {# XXX necessary? #}
 20 | {%- if url_root == '#' %}{% set url_root = '' %}{% endif %}
 21 | {%- if not embedded and docstitle %}
 22 |   {%- set titlesuffix = " &mdash; "|safe + docstitle|e %}
 23 | {%- else %}
 24 |   {%- set titlesuffix = "" %}
 25 | {%- endif %}
 26 | 
 27 | {%- macro relbar() %}
 28 |     <div class="related">
 29 |       <h3>{{ _('Navigation') }}</h3>
 30 |       <ul>
 31 |         {%- for rellink in rellinks %}
 32 |         <li class="right" {% if loop.first %}style="margin-right: 10px"{% endif %}>
 33 |           <a href="{{ pathto(rellink[0]) }}" title="{{ rellink[1]|striptags|e }}"
 34 |              {{ accesskey(rellink[2]) }}>{{ rellink[3] }}</a>
 35 |           {%- if not loop.first %}{{ reldelim2 }}{% endif %}</li>
 36 |         {%- endfor %}
 37 |         {%- block rootrellink %}
 38 |         <li><a href="{{ pathto(master_doc) }}">{{ shorttitle|e }}</a>{{ reldelim1 }}</li>
 39 |         {%- endblock %}
 40 |         {%- for parent in parents %}
 41 |           <li><a href="{{ parent.link|e }}" {% if loop.last %}{{ accesskey("U") }}{% endif %}>{{ parent.title }}</a>{{ reldelim1 }}</li>
 42 |         {%- endfor %}
 43 |         {%- block relbaritems %} {% endblock %}
 44 |       </ul>
 45 |     </div>
 46 | {%- endmacro %}
 47 | 
 48 | {%- macro sidebar() %}
 49 |       {%- if render_sidebar %}
 50 |       <div class="sphinxsidebar">
 51 |         <div class="sphinxsidebarwrapper">
 52 |           {%- block sidebarlogo %}
 53 |           {%- if logo %}
 54 |             <p class="logo"><a href="{{ pathto(master_doc) }}">
 55 |               <img class="logo" src="{{ pathto('_static/' + logo, 1) }}" alt="Logo"/>
 56 |             </a></p>
 57 |           {%- endif %}
 58 |           {%- endblock %}
 59 |           {%- if sidebars != None %}
 60 |             {#- new style sidebar: explicitly include/exclude templates #}
 61 |             {%- for sidebartemplate in sidebars %}
 62 |             {%- include sidebartemplate %}
 63 |             {%- endfor %}
 64 |           {%- else %}
 65 |             {#- old style sidebars: using blocks -- should be deprecated #}
 66 |             {%- block sidebartoc %}
 67 |             {%- include "localtoc.html" %}
 68 |             {%- endblock %}
 69 |             {%- block sidebarrel %}
 70 |             {%- include "relations.html" %}
 71 |             {%- endblock %}
 72 |             {%- block sidebarsourcelink %}
 73 |             {%- include "sourcelink.html" %}
 74 |             {%- endblock %}
 75 |             {%- if customsidebar %}
 76 |             {%- include customsidebar %}
 77 |             {%- endif %}
 78 |             {%- block sidebarsearch %}
 79 |             {%- include "searchbox.html" %}
 80 |             {%- endblock %}
 81 |           {%- endif %}
 82 |         </div>
 83 |       </div>
 84 |       {%- endif %}
 85 | {%- endmacro %}
 86 | 
 87 | {%- macro script() %}
 88 |     <script type="text/javascript">
 89 |       var DOCUMENTATION_OPTIONS = {
 90 |         URL_ROOT:    '{{ url_root }}',
 91 |         VERSION:     '{{ release|e }}',
 92 |         COLLAPSE_INDEX: false,
 93 |         FILE_SUFFIX: '{{ '' if no_search_suffix else file_suffix }}',
 94 |         HAS_SOURCE:  {{ has_source|lower }}
 95 |       };
 96 |     </script>
 97 |     {%- for scriptfile in script_files %}
 98 |     <script type="text/javascript" src="{{ pathto(scriptfile, 1) }}"></script>
 99 |     {%- endfor %}
100 | {%- endmacro %}
101 | 
102 | {%- macro css() %}
103 |     <link rel="stylesheet" href="{{ pathto('_static/' + style, 1) }}" type="text/css" />
104 |     <link rel="stylesheet" href="{{ pathto('_static/pygments.css', 1) }}" type="text/css" />
105 |     {%- for cssfile in css_files %}
106 |     <link rel="stylesheet" href="{{ pathto(cssfile, 1) }}" type="text/css" />
107 |     {%- endfor %}
108 | {%- endmacro %}
109 | 
110 | <html xmlns="http://www.w3.org/1999/xhtml">
111 |   <head>
112 |     <meta http-equiv="Content-Type" content="text/html; charset={{ encoding }}" />
113 |     {{ metatags }}
114 |     {%- block htmltitle %}
115 |     <title>{{ title|striptags|e }}{{ titlesuffix }}</title>
116 |     {%- endblock %}
117 |     {{ css() }}
118 |     {%- if not embedded %}
119 |     {{ script() }}
120 |     {%- if use_opensearch %}
121 |     <link rel="search" type="application/opensearchdescription+xml"
122 |           title="{% trans docstitle=docstitle|e %}Search within {{ docstitle }}{% endtrans %}"
123 |           href="{{ pathto('_static/opensearch.xml', 1) }}"/>
124 |     {%- endif %}
125 |     {%- if favicon %}
126 |     <link rel="shortcut icon" href="{{ pathto('_static/' + favicon, 1) }}"/>
127 |     {%- endif %}
128 |     {%- endif %}
129 | {%- block linktags %}
130 |     {%- if hasdoc('about') %}
131 |     <link rel="author" title="{{ _('About these documents') }}" href="{{ pathto('about') }}" />
132 |     {%- endif %}
133 |     {%- if hasdoc('genindex') %}
134 |     <link rel="index" title="{{ _('Index') }}" href="{{ pathto('genindex') }}" />
135 |     {%- endif %}
136 |     {%- if hasdoc('search') %}
137 |     <link rel="search" title="{{ _('Search') }}" href="{{ pathto('search') }}" />
138 |     {%- endif %}
139 |     {%- if hasdoc('copyright') %}
140 |     <link rel="copyright" title="{{ _('Copyright') }}" href="{{ pathto('copyright') }}" />
141 |     {%- endif %}
142 |     <link rel="top" title="{{ docstitle|e }}" href="{{ pathto('index') }}" />
143 |     {%- if parents %}
144 |     <link rel="up" title="{{ parents[-1].title|striptags|e }}" href="{{ parents[-1].link|e }}" />
145 |     {%- endif %}
146 |     {%- if next %}
147 |     <link rel="next" title="{{ next.title|striptags|e }}" href="{{ next.link|e }}" />
148 |     {%- endif %}
149 |     {%- if prev %}
150 |     <link rel="prev" title="{{ prev.title|striptags|e }}" href="{{ prev.link|e }}" />
151 |     {%- endif %}
152 | {%- endblock %}
153 | {%- block extrahead %} {% endblock %}
154 |   </head>
155 |   <body>
156 | {%- block header %}{% endblock %}
157 | 
158 | {%- block relbar1 %}{{ relbar() }}{% endblock %}
159 | 
160 | {%- block content %}
161 |   {%- block sidebar1 %} {# possible location for sidebar #} {% endblock %}
162 | 
163 |     <div class="document">
164 |   {%- block document %}
165 |       <div class="documentwrapper">
166 |       {%- if render_sidebar %}
167 |         <div class="bodywrapper">
168 |       {%- endif %}
169 |           <div class="body">
170 |             {% block body %} {% endblock %}
171 |           </div>
172 |       {%- if render_sidebar %}
173 |         </div>
174 |       {%- endif %}
175 |       </div>
176 |   {%- endblock %}
177 | 
178 |   {%- block sidebar2 %}{{ sidebar() }}{% endblock %}
179 |       <div class="clearer"></div>
180 |     </div>
181 | {%- endblock %}
182 | 
183 | {%- block relbar2 %}{{ relbar() }}{% endblock %}
184 | 
185 | {%- block footer %}
186 |     <div class="footer">
187 |     {%- if show_copyright %}
188 |       {%- if hasdoc('copyright') %}
189 |         {% trans path=pathto('copyright'), copyright=copyright|e %}&copy; <a href="{{ path }}">Copyright</a> {{ copyright }}.{% endtrans %}
190 |       {%- else %}
191 |         {% trans copyright=copyright|e %}&copy; Copyright {{ copyright }}.{% endtrans %}
192 |       {%- endif %}
193 |     {%- endif %}
194 |     {%- if last_updated %}
195 |       {% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %}
196 |     {%- endif %}
197 |     {%- if show_sphinx %}
198 |       {% trans sphinx_version=sphinx_version|e %}Created using <a href="http://sphinx-doc.org/">Sphinx</a> {{ sphinx_version }}.{% endtrans %}
199 |     {%- endif %}
200 |     </div>
201 |     <p>asdf asdf asdf asdf 22</p>
202 | {%- endblock %}
203 |   </body>
204 | </html>
205 | 
206 | 


--------------------------------------------------------------------------------
/docs/source/_themes/sphinx_rtd_theme/search.html:
--------------------------------------------------------------------------------
 1 | {#
 2 |     basic/search.html
 3 |     ~~~~~~~~~~~~~~~~~
 4 | 
 5 |     Template for the search page.
 6 | 
 7 |     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
 8 |     :license: BSD, see LICENSE for details.
 9 | #}
10 | {%- extends "layout.html" %}
11 | {% set title = _('Search') %}
12 | {% set script_files = script_files + ['_static/searchtools.js'] %}
13 | {% block footer %}
14 |   <script type="text/javascript">
15 |     jQuery(function() { Search.loadIndex("{{ pathto('searchindex.js', 1) }}"); });
16 |   </script>
17 |   {# this is used when loading the search index using $.ajax fails,
18 |      such as on Chrome for documents on localhost #}
19 |   <script type="text/javascript" id="searchindexloader"></script>
20 |   {{ super() }}
21 | {% endblock %}
22 | {% block body %}
23 |   <noscript>
24 |   <div id="fallback" class="admonition warning">
25 |     <p class="last">
26 |       {% trans %}Please activate JavaScript to enable the search
27 |       functionality.{% endtrans %}
28 |     </p>
29 |   </div>
30 |   </noscript>
31 | 
32 |   {% if search_performed %}
33 |     <h2>{{ _('Search Results') }}</h2>
34 |     {% if not search_results %}
35 |       <p>{{ _('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.') }}</p>
36 |     {% endif %}
37 |   {% endif %}
38 |   <div id="search-results">
39 |   {% if search_results %}
40 |     <ul>
41 |     {% for href, caption, context in search_results %}
42 |       <li>
43 |         <a href="{{ pathto(item.href) }}">{{ caption }}</a>
44 |         <p class="context">{{ context|e }}</p>
45 |       </li>
46 |     {% endfor %}
47 |     </ul>
48 |   {% endif %}
49 |   </div>
50 | {% endblock %}
51 | 


--------------------------------------------------------------------------------
/docs/source/_themes/sphinx_rtd_theme/searchbox.html:
--------------------------------------------------------------------------------
 1 | {%- if builder != 'singlehtml' %}
 2 | <div role="search">
 3 |   <form id="rtd-search-form" class="wy-form" action="{{ pathto('search') }}" method="get">
 4 |     <input type="text" name="q" placeholder="Search docs" />
 5 |     <input type="hidden" name="check_keywords" value="yes" />
 6 |     <input type="hidden" name="area" value="default" />
 7 |   </form>
 8 | </div>
 9 | {%- endif %}
10 | 


--------------------------------------------------------------------------------
/docs/source/_themes/sphinx_rtd_theme/static/css/badge_only.css:
--------------------------------------------------------------------------------
1 | .fa:before{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:before,.clearfix:after{display:table;content:""}.clearfix:after{clear:both}@font-face{font-family:FontAwesome;font-weight:normal;font-style:normal;src:url("../font/fontawesome_webfont.eot");src:url("../font/fontawesome_webfont.eot?#iefix") format("embedded-opentype"),url("../font/fontawesome_webfont.woff") format("woff"),url("../font/fontawesome_webfont.ttf") format("truetype"),url("../font/fontawesome_webfont.svg#FontAwesome") format("svg")}.fa:before{display:inline-block;font-family:FontAwesome;font-style:normal;font-weight:normal;line-height:1;text-decoration:inherit}a .fa{display:inline-block;text-decoration:inherit}li .fa{display:inline-block}li .fa-large:before,li .fa-large:before{width:1.875em}ul.fas{list-style-type:none;margin-left:2em;text-indent:-0.8em}ul.fas li .fa{width:0.8em}ul.fas li .fa-large:before,ul.fas li .fa-large:before{vertical-align:baseline}.fa-book:before{content:""}.icon-book:before{content:""}.fa-caret-down:before{content:""}.icon-caret-down:before{content:""}.fa-caret-up:before{content:""}.icon-caret-up:before{content:""}.fa-caret-left:before{content:""}.icon-caret-left:before{content:""}.fa-caret-right:before{content:""}.icon-caret-right:before{content:""}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;border-top:solid 10px #343131;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;z-index:400}.rst-versions a{color:#2980B9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27AE60;*zoom:1}.rst-versions .rst-current-version:before,.rst-versions .rst-current-version:after{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-versions .rst-current-version .fa{color:#fcfcfc}.rst-versions .rst-current-version .fa-book{float:left}.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#E74C3C;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#F1C40F;color:#000}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:gray;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:solid 1px #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px}.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge .fa-book{float:none}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book{float:left}.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge .rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width: 768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}img{width:100%;height:auto}}
2 | /*# sourceMappingURL=badge_only.css.map */
3 | 


--------------------------------------------------------------------------------
/docs/source/_themes/sphinx_rtd_theme/static/fonts/FontAwesome.otf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/source/_themes/sphinx_rtd_theme/static/fonts/FontAwesome.otf


--------------------------------------------------------------------------------
/docs/source/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/source/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.eot


--------------------------------------------------------------------------------
/docs/source/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/source/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.ttf


--------------------------------------------------------------------------------
/docs/source/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sixu05202004/pythontutorial3/691bc33ba84580404052d7c722f0526b8e0325f0/docs/source/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff


--------------------------------------------------------------------------------
/docs/source/_themes/sphinx_rtd_theme/static/js/theme.js:
--------------------------------------------------------------------------------
 1 | $( document ).ready(function() {
 2 |     // Shift nav in mobile when clicking the menu.
 3 |     $(document).on('click', "[data-toggle='wy-nav-top']", function() {
 4 |       $("[data-toggle='wy-nav-shift']").toggleClass("shift");
 5 |       $("[data-toggle='rst-versions']").toggleClass("shift");
 6 |     });
 7 |     // Close menu when you click a link.
 8 |     $(document).on('click', ".wy-menu-vertical .current ul li a", function() {
 9 |       $("[data-toggle='wy-nav-shift']").removeClass("shift");
10 |       $("[data-toggle='rst-versions']").toggleClass("shift");
11 |     });
12 |     $(document).on('click', "[data-toggle='rst-current-version']", function() {
13 |       $("[data-toggle='rst-versions']").toggleClass("shift-up");
14 |     });  
15 |     // Make tables responsive
16 |     $("table.docutils:not(.field-list)").wrap("<div class='wy-table-responsive'></div>");
17 | });
18 | 
19 | window.SphinxRtdTheme = (function (jquery) {
20 |     var stickyNav = (function () {
21 |         var navBar,
22 |             win,
23 |             stickyNavCssClass = 'stickynav',
24 |             applyStickNav = function () {
25 |                 if (navBar.height() <= win.height()) {
26 |                     navBar.addClass(stickyNavCssClass);
27 |                 } else {
28 |                     navBar.removeClass(stickyNavCssClass);
29 |                 }
30 |             },
31 |             enable = function () {
32 |                 applyStickNav();
33 |                 win.on('resize', applyStickNav);
34 |             },
35 |             init = function () {
36 |                 navBar = jquery('nav.wy-nav-side:first');
37 |                 win    = jquery(window);
38 |             };
39 |         jquery(init);
40 |         return {
41 |             enable : enable
42 |         };
43 |     }());
44 |     return {
45 |         StickyNav : stickyNav
46 |     };
47 | }($));
48 | 


--------------------------------------------------------------------------------
/docs/source/_themes/sphinx_rtd_theme/theme.conf:
--------------------------------------------------------------------------------
1 | [theme]
2 | inherit = basic
3 | stylesheet = css/theme.css
4 | 
5 | [options]
6 | typekit_id = hiw1hhg
7 | analytics_id = 
8 | sticky_navigation = False
9 | 


--------------------------------------------------------------------------------
/docs/source/_themes/sphinx_rtd_theme/versions.html:
--------------------------------------------------------------------------------
 1 | {% if READTHEDOCS %}
 2 | {# Add rst-badge after rst-versions for small badge style. #}
 3 |   <div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
 4 |     <span class="rst-current-version" data-toggle="rst-current-version">
 5 |       <span class="fa fa-book"> Read the Docs</span>
 6 |       v: {{ current_version }}
 7 |       <span class="fa fa-caret-down"></span>
 8 |     </span>
 9 |     <div class="rst-other-versions">
10 |       <dl>
11 |         <dt>Versions</dt>
12 |         {% for slug, url in versions %}
13 |           <dd><a href="{{ url }}">{{ slug }}</a></dd>
14 |         {% endfor %}
15 |       </dl>
16 |       <dl>
17 |         <dt>Downloads</dt>
18 |         {% for type, url in downloads %}
19 |           <dd><a href="{{ url }}">{{ type }}</a></dd>
20 |         {% endfor %}
21 |       </dl>
22 |       <dl>
23 |         <dt>On Read the Docs</dt>
24 |           <dd>
25 |             <a href="//{{ PRODUCTION_DOMAIN }}/projects/{{ slug }}/?fromdocs={{ slug }}">Project Home</a>
26 |           </dd>
27 |           <dd>
28 |             <a href="//{{ PRODUCTION_DOMAIN }}/builds/{{ slug }}/?fromdocs={{ slug }}">Builds</a>
29 |           </dd>
30 |       </dl>
31 |       <hr/>
32 |       Free document hosting provided by <a href="http://www.readthedocs.org">Read the Docs</a>.
33 | 
34 |     </div>
35 |   </div>
36 | {% endif %}
37 | 
38 | 


--------------------------------------------------------------------------------
/docs/source/appendix.rst:
--------------------------------------------------------------------------------
 1 | .. _tut-appendix:
 2 | 
 3 | ********
 4 | 附录
 5 | ********
 6 | 
 7 | 
 8 | .. _tut-interac:
 9 | 
10 | 交互模式
11 | ================
12 | 
13 | .. _tut-error:
14 | 
15 | 错误处理
16 | --------------
17 | 
18 | 当错误发生时，解释器打印一个错误信息和堆栈跟踪。在交互模式下，它返回主提示符；当输入来自文件的时候，在打印堆栈跟踪后以非零退出(a nonzero exit)状态退出。（在 `try <https://docs.python.org/3/reference/compound_stmts.html#try>`_ 声明中被 `except <https://docs.python.org/3/reference/compound_stmts.html#except>`_ 子句捕捉到的异常在这种情况下不是错误。）有些错误是非常致命的会导致一个非零状态的退出；这也适用于内部错误以及某些情况的内存耗尽。所有的错误信息都写入到标准错误流；来自执行的命令的普通输出写入到标准输出。
19 | 
20 | 输入中断符（通常是 Control-C 或者 DEL）到主或者从提示符中会取消输入并且返回到主提示。[#]_ 当命令执行中输入中断符会引起 `KeyboardInterrupt <https://docs.python.org/3/library/exceptions.html#KeyboardInterrupt>`_ 异常，这个异常能够被一个 `try <https://docs.python.org/3/reference/compound_stmts.html#try>`_ 声明处理。
21 | 
22 | 
23 | .. _tut-scripts:
24 | 
25 | 可执行 Python 脚本
26 | -------------------------
27 | 
28 | 在 BSD'ish Unix 系统上，Python 脚本可直接执行，像 shell 脚本一样，只需要把下面内容加入到 ::
29 | 
30 |    #!/usr/bin/env python3.5
31 | 
32 | （假设 python 解释器在用户的 :envvar:`PATH` 中）脚本的开头，并给予该文件的可执行模式。``#!`` 必须是文件的头两个字符。在一些系统上，第一行必须以 Unix-style 的行结束符（``'\n'``）结束，不能以 Windows 的行结束符（``'\r\n'``）。 注意 ``'#'`` 在 Python 中是用于注释的。
33 | 
34 | 使用 :program:`chmod` 命令能够给予脚本执行模式或者权限。
35 | 
36 | .. code-block:: bash
37 | 
38 |    $ chmod +x myscript.py
39 | 
40 | 在 Windows 系统上，没有一个 “可执行模式” 的概念。Python 安装器会自动地把 ``.py``  文件和 ``python.exe`` 关联起来，因此双击 Python 将会把它当成一个脚本运行。文件扩展名也可以是 ``.pyw``，在这种情况下，运行时不会出现控制台窗口。
41 | 
42 | 
43 | .. _tut-startup:
44 | 
45 | 交互式启动文件
46 | ----------------------------
47 | 
48 | 当你使用交互式 Python 的时候，它常常很方便地执行一些命令在每次解释器启动时。你可以这样做：设置一个名为 `PYTHONSTARTUP <https://docs.python.org/3/using/cmdline.html#envvar-PYTHONSTARTUP>`_ 的环境变量为包含你的启动命令的文件名。这跟 Unix shells 的 :file:`.profile` 特点有些类似。
49 | 
50 | 这个文件在交互式会话中是只读的，在当 Python 从脚本中读取命令，以及在当 :file:`/dev/tty` 被作为明确的命令源的时候不只是可读的。该文件在交互式命令被执行的时候在相同的命名空间中能够被执行，因此在交互式会话中定义或者导入的对象能够无需授权就能使用。你也能在文件中更改提示 ``sys.ps1`` 和 ``sys.ps2``。
51 | 
52 | 如果你想要从当前目录中读取一个附加的启动文件，你可以在全局启动文件中编写代码像这样：``if
53 | os.path.isfile('.pythonrc.py'): exec(open('.pythonrc.py').read())``。如果你想要在脚本中使用启动文件的话，你必须在脚本中明确要这么做::
54 | 
55 |    import os
56 |    filename = os.environ.get('PYTHONSTARTUP')
57 |    if filename and os.path.isfile(filename):
58 |        with open(filename) as fobj:
59 |           startup_file = fobj.read()
60 |        exec(startup_file)
61 | 
62 | 
63 | .. _tut-customize:
64 | 
65 | 定制模块
66 | -------------------------
67 | 
68 | Python 提供两个钩子为了让你们定制 :mod:`sitecustomize` 和 :mod:`usercustomize`。为了看看它的工作机制的话，你必须首先找到你的用户 site-packages 目录的位置。启动 Python 并且运行这段代码::
69 | 
70 |    >>> import site
71 |    >>> site.getusersitepackages()
72 |    '/home/user/.local/lib/python3.4/site-packages'
73 | 
74 | 现在你可以创建一个名为 :file:`usercustomize.py` 的文件在你的用户 site-packages 目录，并且在里面放置你想要的任何内容。它会影响 Python 的每一次调用，除非它以 `-s <https://docs.python.org/3/using/cmdline.html#cmdoption-s>`_ （禁用自动导入）选项启动。
75 | 
76 | :mod:`sitecustomize` 以同样地方式工作，但是通常由是机器的管理员创建在全局的 site-packages 目录中，并且是在 :mod:`usercustomize` 之前导入。请参阅 `site <https://docs.python.org/3/library/site.html#module-site>`_ 模块获取更多信息。
77 | 
78 | 
79 | .. rubric:: Footnotes
80 | 
81 | .. [#] GNU 的 Readline 包的问题可能会阻止这种做法。
82 | 


--------------------------------------------------------------------------------
/docs/source/appetite.rst:
--------------------------------------------------------------------------------
 1 | .. _tut-intro:
 2 | 
 3 | **********************
 4 | 开胃菜
 5 | **********************
 6 | 
 7 | 如果你要用计算机做很多工作，最后你会发现有一些任务你更希望用自动化的方式进行处理。比如，你想要在大量的文本文件中执行查找/替换，或者以复杂的方式对大量的图片进行重命名和整理。也许你想要编写一个小型的自定义数据库、一个特殊的 GUI 应用程序或一个简单的小游戏。
 8 | 
 9 | 如果你是一名专业的软件开发者，可能你必须使用几种 C/C++/JAVA 类库，并且发现通常编写/编译/测试/重新编译的周期是如此漫长。也许你正在为这些类库编写测试用例，但是发现这是一个让人烦躁的工作。又或者你已经完成了一个可以使用扩展语言的程序，但你并不想为此重新设计并实现一套全新的语言。
10 | 
11 | 那么 Python 正是你所需要的语言。
12 | 
13 | 虽然你能够通过编写 Unix shell 脚本或 Windows 批处理文件来处理其中的某些任务，但 Shell 脚本更适合移动文件或修改文本数据，并不适合编写 GUI 应用程序或游戏；虽然你能够使用 C/C++/JAVA 编写程序，但即使编写一个简单的 first-draft 程序也有可能耗费大量的开发时间。相比之下，Python 更易于使用，无论在 Windows、Mac OS X 或 Unix 操作系统上它都会帮助你更快地完成任务。
14 | 
15 | 虽然 Python 易于使用，但它却是一门完整的编程语言；与 Shell 脚本或批处理文件相比，它为编写大型程序提供了更多的结构和支持。另一方面，Python 提供了比 C 更多的错误检查，并且作为一门 *高级语言*，它内置支持高级的数据结构类型，例如：灵活的数组和字典。因其更多的通用数据类型，Python 比 Awk 甚至 Perl 都适用于更多问题领域，至少大多数事情在 Python 中与其他语言同样简单。
16 | 
17 | Python 允许你将程序分割为不同的模块，以便在其他的 Python 程序中重用。Python 内置提供了大量的标准模块，你可以将其用作程序的基础，或者作为学习 Python 编程的示例。这些模块提供了诸如文件 I/O、系统调用、Socket 支持，甚至类似 Tk 的用户图形界面（GUI）工具包接口。
18 | 
19 | Python 是一门解释型语言，因为无需编译和链接，你可以在程序开发中节省宝贵的时间。Python 解释器可以交互的使用，这使得试验语言的特性、编写临时程序或在自底向上的程序开发中测试方法非常容易。你甚至还可以把它当做一个桌面计算器。
20 | 
21 | Python 让程序编写的紧凑和可读。用 Python 编写的程序通常比同样的 C、C++ 或 Java 程序更短小，这是因为以下几个原因::
22 | 
23 | 	* 高级数据结构使你可以在一条语句中表达复杂的操作；
24 | 
25 | 	* 语句组使用缩进代替开始和结束大括号来组织；
26 | 
27 | 	* 变量或参数无需声明。
28 | 
29 | Python 是 *可扩展* 的：如果你会 C 语言编程便可以轻易地为解释器添加内置函数或模块，或者为了对性能瓶颈作优化，或者将 Python 程序与只有二进制形式的库（比如某个专业的商业图形库）连接起来。一旦你真正掌握了它，你可以将 Python 解释器集成进某个 C 应用程序，并把它当作那个程序的扩展或命令行语言。
30 | 
31 | 顺便说一句，这个语言的名字来自于 BBC 的 “Monty Python’s Flying Cirecus” 节目，和爬行类动物没有任何关系。在文档中引用 Monty Python 的典故不仅可行，而且值得鼓励！
32 | 
33 | 现在你已经为 Python 兴奋不已了吧，大概想要领略一些更多的细节！学习一门语言最好的方法就是使用它，本指南推荐你边读边使用 Python 解释器练习。
34 | 
35 | 下一节中，我们将解释 Python 解释器的用法。这是很简单的一件事情，但它有助于试验后面的例子。
36 | 
37 | 本手册剩下的部分将通过示例介绍 Python 语言及系统的诸多特性，开始是简单的语法、数据类型和表达式，接着介绍函数与模块，最后涉及异常和自定义类这样的高级内容。
38 | 


--------------------------------------------------------------------------------
/docs/source/conf.py:
--------------------------------------------------------------------------------
  1 | #!/usr/bin/env python
  2 | # -*- coding: utf-8 -*-
  3 | 
  4 | # -*- coding: utf-8 -*-
  5 | #
  6 | # Python tutorial documentation build configuration file, created by
  7 | # sphinx-quickstart on Fri Jan 18 10:43:59 2013.
  8 | #
  9 | # This file is execfile()d with the current directory set to its containing dir.
 10 | #
 11 | # Note that not all possible configuration values are present in this
 12 | # autogenerated file.
 13 | #
 14 | # All configuration values have a default; values that are commented out
 15 | # serve to show the default.
 16 | 
 17 | import sys, os
 18 | import sphinx_rtd_theme
 19 | 
 20 | # If extensions (or modules to document with autodoc) are in another directory,
 21 | # add these directories to sys.path here. If the directory is relative to the
 22 | # documentation root, use os.path.abspath to make it absolute, like shown here.
 23 | #sys.path.insert(0, os.path.abspath('.'))
 24 | 
 25 | # -- General configuration -----------------------------------------------------
 26 | 
 27 | # If your documentation needs a minimal Sphinx version, state it here.
 28 | #needs_sphinx = '1.0'
 29 | 
 30 | # Add any Sphinx extension module names here, as strings. They can be extensions
 31 | # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 32 | extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest']
 33 | 
 34 | # Add any paths that contain templates here, relative to this directory.
 35 | templates_path = ['_templates']
 36 | 
 37 | # The suffix of source filenames.
 38 | source_suffix = '.rst'
 39 | 
 40 | # The encoding of source files.
 41 | #source_encoding = 'utf-8-sig'
 42 | 
 43 | # The master toctree document.
 44 | master_doc = 'index'
 45 | 
 46 | # General information about the project.
 47 | project = u'Python tutorial'
 48 | copyright = u'2013, D.D'
 49 | 
 50 | # The version info for the project you're documenting, acts as replacement for
 51 | # |version| and |release|, also used in various other places throughout the
 52 | # built documents.
 53 | #
 54 | # The short X.Y version.
 55 | version = '3.6.3'
 56 | # The full version, including alpha/beta/rc tags.
 57 | release = '3.6.3'
 58 | 
 59 | # The language for content autogenerated by Sphinx. Refer to documentation
 60 | # for a list of supported languages.
 61 | #language = None
 62 | 
 63 | # There are two options for replacing |today|: either, you set today to some
 64 | # non-false value, then it is used:
 65 | #today = ''
 66 | # Else, today_fmt is used as the format for a strftime call.
 67 | #today_fmt = '%B %d, %Y'
 68 | 
 69 | # List of patterns, relative to source directory, that match files and
 70 | # directories to ignore when looking for source files.
 71 | exclude_patterns = []
 72 | 
 73 | # The reST default role (used for this markup: `text`) to use for all documents.
 74 | #default_role = None
 75 | 
 76 | # If true, '()' will be appended to :func: etc. cross-reference text.
 77 | #add_function_parentheses = True
 78 | 
 79 | # If true, the current module name will be prepended to all description
 80 | # unit titles (such as .. function::).
 81 | #add_module_names = True
 82 | 
 83 | # If true, sectionauthor and moduleauthor directives will be shown in the
 84 | # output. They are ignored by default.
 85 | #show_authors = False
 86 | 
 87 | # The name of the Pygments (syntax highlighting) style to use.
 88 | pygments_style = 'sphinx'
 89 | 
 90 | # A list of ignored prefixes for module index sorting.
 91 | #modindex_common_prefix = []
 92 | 
 93 | 
 94 | # -- Options for HTML output ---------------------------------------------------
 95 | 
 96 | # The theme to use for HTML and HTML Help pages.  See the documentation for
 97 | # a list of builtin themes.
 98 | html_theme = "sphinx_rtd_theme"
 99 | 
100 | html_theme_path = ["_themes", ]
101 | 
102 | # Theme options are theme-specific and customize the look and feel of a theme
103 | # further.  For a list of options available for each theme, see the
104 | # documentation.
105 | #html_theme_options = {}
106 | 
107 | # Add any paths that contain custom themes here, relative to this directory.
108 | #html_theme_path = []
109 | 
110 | # The name for this set of Sphinx documents.  If None, it defaults to
111 | # "<project> v<release> documentation".
112 | #html_title = None
113 | 
114 | # A shorter title for the navigation bar.  Default is the same as html_title.
115 | #html_short_title = None
116 | 
117 | # The name of an image file (relative to this directory) to place at the top
118 | # of the sidebar.
119 | #html_logo = None
120 | 
121 | # The name of an image file (within the static path) to use as favicon of the
122 | # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
123 | # pixels large.
124 | #html_favicon = None
125 | 
126 | # Add any paths that contain custom static files (such as style sheets) here,
127 | # relative to this directory. They are copied after the builtin static files,
128 | # so a file named "default.css" will overwrite the builtin "default.css".
129 | html_static_path = ['_static']
130 | 
131 | # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
132 | # using the given strftime format.
133 | #html_last_updated_fmt = '%b %d, %Y'
134 | 
135 | # If true, SmartyPants will be used to convert quotes and dashes to
136 | # typographically correct entities.
137 | #html_use_smartypants = True
138 | 
139 | # Custom sidebar templates, maps document names to template names.
140 | #html_sidebars = {}
141 | 
142 | # Additional templates that should be rendered to pages, maps page names to
143 | # template names.
144 | #html_additional_pages = {}
145 | 
146 | # If false, no module index is generated.
147 | #html_domain_indices = True
148 | 
149 | # If false, no index is generated.
150 | #html_use_index = True
151 | 
152 | # If true, the index is split into individual pages for each letter.
153 | #html_split_index = False
154 | 
155 | # If true, links to the reST sources are added to the pages.
156 | #html_show_sourcelink = True
157 | 
158 | # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
159 | #html_show_sphinx = True
160 | 
161 | # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
162 | #html_show_copyright = True
163 | 
164 | # If true, an OpenSearch description file will be output, and all pages will
165 | # contain a <link> tag referring to it.  The value of this option must be the
166 | # base URL from which the finished HTML is served.
167 | #html_use_opensearch = ''
168 | 
169 | # This is the file name suffix for HTML files (e.g. ".xhtml").
170 | #html_file_suffix = None
171 | 
172 | # Output file base name for HTML help builder.
173 | htmlhelp_basename = 'Pythontutorialdoc'
174 | 
175 | 
176 | # -- Options for LaTeX output --------------------------------------------------
177 | 
178 | latex_elements = {
179 | # The paper size ('letterpaper' or 'a4paper').
180 | #'papersize': 'letterpaper',
181 | 
182 | # The font size ('10pt', '11pt' or '12pt').
183 | #'pointsize': '10pt',
184 | 
185 | # Additional stuff for the LaTeX preamble.
186 | #'preamble': '',
187 | }
188 | 
189 | # Grouping the document tree into LaTeX files. List of tuples
190 | # (source start file, target name, title, author, documentclass [howto/manual]).
191 | latex_documents = [
192 |   ('index', 'Pythontutorial.tex', u'Python tutorial Documentation',
193 |    u'D.D', 'manual'),
194 | ]
195 | 
196 | # The name of an image file (relative to this directory) to place at the top of
197 | # the title page.
198 | #latex_logo = None
199 | 
200 | # For "manual" documents, if this is true, then toplevel headings are parts,
201 | # not chapters.
202 | #latex_use_parts = False
203 | 
204 | # If true, show page references after internal links.
205 | #latex_show_pagerefs = False
206 | 
207 | # If true, show URL addresses after external links.
208 | #latex_show_urls = False
209 | 
210 | # Documents to append as an appendix to all manuals.
211 | #latex_appendices = []
212 | 
213 | # If false, no module index is generated.
214 | #latex_domain_indices = True
215 | 
216 | 
217 | # -- Options for manual page output --------------------------------------------
218 | 
219 | # One entry per manual page. List of tuples
220 | # (source start file, name, description, authors, manual section).
221 | man_pages = [
222 |     ('index', 'pythontutorial', u'Python tutorial Documentation',
223 |      [u'D.D'], 1)
224 | ]
225 | 
226 | # If true, show URL addresses after external links.
227 | #man_show_urls = False
228 | 
229 | 
230 | # -- Options for Texinfo output ------------------------------------------------
231 | 
232 | # Grouping the document tree into Texinfo files. List of tuples
233 | # (source start file, target name, title, author,
234 | #  dir menu entry, description, category)
235 | texinfo_documents = [
236 |   ('index', 'Pythontutorial', u'Python tutorial Documentation',
237 |    u'D.D', 'Pythontutorial', 'One line description of project.',
238 |    'Miscellaneous'),
239 | ]
240 | 
241 | # Documents to append as an appendix to all manuals.
242 | #texinfo_appendices = []
243 | 
244 | # If false, no module index is generated.
245 | #texinfo_domain_indices = True
246 | 
247 | # How to display URL addresses: 'footnote', 'no', or 'inline'.
248 | #texinfo_show_urls = 'footnote'
249 | 


--------------------------------------------------------------------------------
/docs/source/floatingpoint.rst:
--------------------------------------------------------------------------------
  1 | .. _tut-fp-issues:
  2 | 
  3 | **************************************************
  4 | 浮点数算法：争议和限制
  5 | **************************************************
  6 | 
  7 | .. sectionauthor:: Tim Peters <tim_one@users.sourceforge.net>
  8 | 
  9 | 
 10 | 浮点数在计算机中表达为二进制（binary）小数。例如：十进制小数::
 11 | 
 12 |    0.125
 13 | 
 14 | 是 1/10 + 2/100 + 5/1000 的值，同样二进制小数::
 15 | 
 16 |    0.001
 17 | 
 18 | 是 0/2 + 0/4 + 1/8。这两个数值相同。唯一的实质区别是第一个写为十进制小数记法，第二个是二进制。 
 19 | 
 20 | 不幸的是，大多数十进制小数不能完全用二进制小数表示。结果是，一般情况下，你输入的十进制浮点数仅由实际存储在计算机中的近似的二进制浮点数表示。
 21 | 
 22 | 这个问题更早的时候首先在十进制中发现。考虑小数形式的 1/3 ，你可以来个十进制的近似值。 ::
 23 | 
 24 |    0.3
 25 | 
 26 | 或者更进一步的, ::
 27 | 
 28 |    0.33
 29 | 
 30 | 或者更进一步的, ::
 31 | 
 32 |    0.333
 33 | 
 34 | 诸如此类。如果你写多少位，这个结果永远不是精确的 1/3 ，但是可以无限接近 1/3 。 
 35 | 
 36 | 同样，无论在二进制中写多少位，十进制数 0.1 都不能精确表达为二进制小数。二进制来表达 1/10 是一个无限循环小数::
 37 | 
 38 |    0.0001100110011001100110011001100110011001100110011...
 39 | 
 40 | 在任何有限数量的位停下来，你得到的都是近似值。今天在大多数机器上，浮点数的近似使用的小数以最高的 53 位为分子，2 的幂为分母。至于 1/10 这种情况，其二进制小数是  ``3602879701896397 / 2 ** 55``，它非常接近但不完全等于1/10真实的值。
 41 | 
 42 | 由于显示方式的原因，许多使用者意识不到是近似值。Python 只打印机器中存储的二进制值的十进制近似值。在大多数机器上，如果 Python 要打印 0.1 存储的二进制的真正近似值，将会显示::
 43 | 
 44 |    >>> 0.1
 45 |    0.1000000000000000055511151231257827021181583404541015625
 46 | 
 47 | 这么多位的数字对大多数人是没有用的，所以 Python 显示一个舍入的值 ::
 48 | 
 49 |    >>> 1 / 10
 50 |    0.1
 51 | 
 52 | 只要记住即使打印的结果看上去是精确的 1/10，真正存储的值是最近似的二进制小数。
 53 | 
 54 | 有趣地是，存在许多不同的十进制数共享着相同的近似二进制小数。例如，数字 ``0.1`` 和 ``0.10000000000000001`` 以及 ``0.1000000000000000055511151231257827021181583404541015625`` 都是 ``3602879701896397 / 2 ** 55`` 的近似值。因为所有这些十进制数共享相同的近似值，在保持恒等式 ``eval(repr(x)) == x`` 的同时，显示的可能是它们中的任何一个。
 55 | 
 56 | 历史上，Python 提示符和内置的 `repr() <https://docs.python.org/3/library/functions.html#repr>`_ 函数选择一个 17 位精度的数字，``0.10000000000000001``。从 Python 3.1 开始，Python（在大多数系统上）能够从这些数字当中选择最短的一个并简单地显示 ``0.1``。
 57 | 
 58 | 注意，这是二进制浮点数的自然性质：它不是 Python 中的一个 bug，也不是你的代码中的 bug。你会看到所有支持硬件浮点数算法的语言都会有这个现象（尽管有些语言默认情况下或者在所有输出模式下可能不会 *显示* 出差异）。
 59 | 
 60 | 为了输出更好看，你可能想用字符串格式化来生成固定位数的有效数字::
 61 | 
 62 |    >>> format(math.pi, '.12g')  # give 12 significant digits
 63 |    '3.14159265359'
 64 | 
 65 |    >>> format(math.pi, '.2f')   # give 2 digits after the point
 66 |    '3.14'
 67 | 
 68 |    >>> repr(math.pi)
 69 |    '3.141592653589793'
 70 | 
 71 | 认识到这，在真正意义上，是一种错觉是很重要的：你在简单地舍入真实机器值的 *显示*。
 72 | 
 73 | 例如，既然 0.1 不是精确的 1/10，3 个 0.1 的值相加可能也不会得到精确的 0.3::
 74 | 
 75 |    >>> .1 + .1 + .1 == .3
 76 |    False
 77 | 
 78 | 另外，既然 0.1 不能更接近 1/10 的精确值而且 0.3 不能更接近 3/10 的精确值，使用 `round() <https://docs.python.org/3/library/functions.html#round>`_ 函数提前舍入也没有帮助::
 79 | 
 80 |    >>> round(.1, 1) + round(.1, 1) + round(.1, 1) == round(.3, 1)
 81 |    False
 82 | 
 83 | 虽然这些数字不可能再更接近它们想要的精确值，`round() <https://docs.python.org/3/library/functions.html#round>`_  函数可以用于在计算之后进行舍入，这样的话不精确的结果就可以和另外一个相比较了::
 84 | 
 85 |     >>> round(.1 + .1 + .1, 10) == round(.3, 10)
 86 |     True
 87 | 
 88 | 二进制浮点数计算有很多这样意想不到的结果。“0.1”的问题在下面"误差的表示"一节中有准确详细的解释。更完整的常见怪异现象请参见 `浮点数的危险 <http://www.lahey.com/float.htm>`_。
 89 | 
 90 | 最后我要说，“没有简单的答案”。也不要过分小心浮点数！Python 浮点数计算中的误差源之于浮点数硬件，大多数机器上每次计算误差不超过 2\*\*53 分之一。对于大多数任务这已经足够了，但是你要在心中记住这不是十进制算法，每个浮点数计算可能会带来一个新的舍入错误。
 91 | 
 92 | 虽然确实有问题存在，对于大多数平常的浮点数运算，你只要简单地将最终显示的结果舍入到你期望的十进制位数，你就会得到你期望的最终结果。`str() <https://docs.python.org/3/library/stdtypes.html#str>`_ 通常已经足够用了，对于更好的控制可以参阅 `格式化字符串语法 <https://docs.python.org/3/library/string.html#formatstrings>`_ 中 `str.format() <https://docs.python.org/3/library/stdtypes.html#str.format>`_ 方法的格式说明符。
 93 | 
 94 | 对于需要精确十进制表示的情况，可以尝试使用 `decimal <https://docs.python.org/3/library/decimal.html#module-decimal>`_ 模块，它实现的十进制运算适合会计方面的应用和高精度要求的应用。
 95 | 
 96 | `fractions <https://docs.python.org/3/library/fractions.html#module-fractions>`_ 模块支持另外一种形式的运算，它实现的运算基于有理数（因此像1/3这样的数字可以精确地表示）。
 97 | 
 98 | 如果你是浮点数操作的重度使用者，你应该看一下由 SciPy 项目提供的 Numerical Python 包和其它用于数学和统计学的包。参看 <http://scipy.org>。
 99 | 
100 | 当你真的 *真* 想要知道浮点数精确值的时候，Python 提供这样的工具可以帮助你。`float.as_integer_ratio() <https://docs.python.org/3/library/stdtypes.html#float.as_integer_ratio>`_ 方法以分数的形式表示一个浮点数的值::
101 | 
102 |    >>> x = 3.14159
103 |    >>> x.as_integer_ratio()
104 |    (3537115888337719, 1125899906842624)
105 | 
106 | 因为比值是精确的，它可以用来无损地重新生成初始值::
107 | 
108 |     >>> x == 3537115888337719 / 1125899906842624
109 |     True
110 | 
111 | `float.hex() <https://docs.python.org/3/library/stdtypes.html#float.hex>`_ 方法以十六进制表示浮点数，给出的同样是计算机存储的精确值::
112 | 
113 |    >>> x.hex()
114 |    '0x1.921f9f01b866ep+1'
115 | 
116 | 精确的十六进制表示可以用来准确地重新构建浮点数::
117 | 
118 |     >>> x == float.fromhex('0x1.921f9f01b866ep+1')
119 |     True
120 | 
121 | 因为可以精确表示，所以可以用在不同版本的 Python（与平台相关）之间可靠地移植数据以及与支持同样格式的其它语言（例如 Java 和 C99）交换数据。
122 | 
123 | 另外一个有用的工具是 `math.fsum() <https://docs.python.org/3/library/math.html#math.fsum>`_ 函数，它帮助求和过程中减少精度的损失。当数值在不停地相加的时候，它会跟踪“丢弃的数字”。这可以给总体的准确度带来不同，以至于错误不会累积到影响最终结果的点::
124 | 
125 |    >>> sum([0.1] * 10) == 1.0
126 |    False
127 |    >>> math.fsum([0.1] * 10) == 1.0
128 |    True
129 | 
130 | 
131 | .. _tut-fp-error:
132 | 
133 | 表达错误
134 | ====================
135 | 
136 | 这一节详细说明 “0.1” 示例，教你怎样自己去精确的分析此类案例。假设这里你已经对浮点数表示有基本的了解。 
137 | 
138 | :dfn:`Representation error` 提及事实上有些（实际是大多数）十进制小数不能精确的表示为二进制小数。这是 Python （或 Perl，C，C++，Java，Fortran 以及其它很多）语言往往不能按你期待的样子显示十进制数值的根本原因。
139 | 
140 | 这是为什么？ 1/10 不能精确的表示为二进制小数。大多数今天的机器（2000年十一月）使用 IEEE-754 浮点数算法，大多数平台上 Python 将浮点数映射为 IEEE-754 “双精度浮点数”。754 双精度包含 53 位精度，所以计算机努力将输入的 0.1 转为 *J*/2**\ *N* 最接近的二进制小数。*J* 是一个 53 位的整数。改写::
141 | 
142 |    1 / 10 ~= J / (2**N)
143 | 
144 | 为::
145 | 
146 |    J ~= 2**N / 10
147 | 
148 | *J* 重现时正是 53 位（是 ``>= 2**52`` 而非 ``< 2**53`` ）， *N* 的最佳值是 56::
149 | 
150 |     >>> 2**52 <=  2**56 // 10  < 2**53
151 |     True
152 | 
153 | 因此，56 是保持 *J* 精度的唯一 *N* 值。*J* 最好的近似值是整除的商::
154 | 
155 |    >>> q, r = divmod(2**56, 10)
156 |    >>> r
157 |    6
158 | 
159 | 因为余数大于 10 的一半，最好的近似是取上界::
160 | 
161 |    >>> q+1
162 |    7205759403792794
163 | 
164 | 因此在 754 双精度中 1/10 最好的近似值是是 2**56，或::
165 | 
166 |    7205759403792794 / 2 ** 56
167 | 
168 | 分子和分母都除以2将小数缩小到::
169 | 
170 |    3602879701896397 / 2 ** 55
171 | 
172 | 要注意因为我们向上舍入，它其实比 1/10 稍大一点点。如果我们没有向上舍入，它会比 1/10 稍小一点。但是没办法让它 *恰好* 是 1/10！ 
173 | 
174 | 所以计算机永远也不 “知道” 1/10：它遇到上面这个小数，给出它所能得到的最佳的 754 双精度实数::
175 | 
176 |    >>> .1 * 2**55
177 |    7205759403792794.0
178 | 
179 | 如果我们把这小数乘以 10\*\*55，我们可以看到其55位十进制数的值::
180 | 
181 |    >>> 3602879701896397 * 10 ** 55 // 2 ** 55
182 |    1000000000000000055511151231257827021181583404541015625
183 | 
184 | 这表示存储在计算机中的实际值近似等于十进制值 0.1000000000000000055511151231257827021181583404541015625。许多语言（包括旧版本的Python）会把结果舍入到 17 位有效数字，而不是显示全部的十进制值::
185 | 
186 |    >>> format(0.1, '.17f')
187 |    '0.10000000000000001'
188 | 
189 | `fractions <https://docs.python.org/3/library/fractions.html#module-fractions>`_ 和 `decimal <https://docs.python.org/3/library/decimal.html#module-decimal>`_ 模块使得这些计算很简单::
190 | 
191 |    >>> from decimal import Decimal
192 |    >>> from fractions import Fraction
193 | 
194 |    >>> Fraction.from_float(0.1)
195 |    Fraction(3602879701896397, 36028797018963968)
196 | 
197 |    >>> (0.1).as_integer_ratio()
198 |    (3602879701896397, 36028797018963968)
199 | 
200 |    >>> Decimal.from_float(0.1)
201 |    Decimal('0.1000000000000000055511151231257827021181583404541015625')
202 | 
203 |    >>> format(Decimal.from_float(0.1), '.17')
204 |    '0.10000000000000001'
205 | 


--------------------------------------------------------------------------------
/docs/source/index.rst:
--------------------------------------------------------------------------------
 1 | .. _tutorial-index:
 2 | 
 3 | ######################
 4 | Python 入门指南
 5 | ######################
 6 | 
 7 | :Release: |version|
 8 | :Date: |today|
 9 | 
10 | Python 是一门简单易学且功能强大的编程语言。它拥有高效的高级数据结构，并且能够用简单而又高效的方式进行面向对象编程。Python 优雅的语法和动态类型，再结合它的解释性，使其在大多数平台的许多领域成为编写脚本或开发应用程序的理想语言。
11 | 
12 | 你可以自由地从 Python 官方点: http://www.python.org，以源代码或二进制形式获取 Python 解释器及其标准扩展库，并可以自由的分发。此站点同时也提供了大量的第三方 Python 模块、程序和工具，及其附加文档。
13 | 
14 | 你可以很容易的使用 C 或 C++（其他可以通过 C 调用的语言）为 Python 解释器扩展新函数和数据类型。Python 还可以被用作定制应用程序的一门扩展语言。
15 | 
16 | 本手册非正式的向读者介绍了 Python 语言及其体系相关的基本知识与概念。在学习实践中结合使用 Python 解释器是很有帮助的，不过所有的例子都是完整的，所以本手册亦可离线阅读。
17 | 
18 | 如果需要了解相关标准库或对象的详细介绍，请查阅 `Python 参考文档`_ 。`Python 参考手册`_ 提供了更多语言相关的正式说明。如果想要使用 C 或 C++ 编写扩展，请查阅 `Python 解释器扩展和集成章节`_ 和 `C API 参考手册`_ 。当然也可阅读一些深入介绍 Python 知识的图书。
19 | 
20 | 本手册不会尝试涵盖 Python 的全部知识和每个特性，甚至不会涵盖所有常用的特性。相反地，它介绍了 Python 中许多最引人瞩目的特性，并且会给你一个关于语言特色和风格的认识。读完之后，你将能够阅读和编写 Python 模块或程序，并为以后使用 
21 | `Python 参考手册`_ 继续学习诸多 Python 模块库做好准备。
22 | 
23 | 
24 | `词汇表`_ 也值得浏览一下。
25 | 
26 | .. toctree::
27 |    :numbered:
28 | 
29 |    appetite.rst
30 |    interpreter.rst
31 |    introduction.rst
32 |    controlflow.rst
33 |    datastructures.rst
34 |    modules.rst
35 |    inputoutput.rst
36 |    errors.rst
37 |    classes.rst
38 |    stdlib.rst
39 |    stdlib2.rst
40 |    venv.rst
41 |    whatnow.rst
42 |    interactive.rst
43 |    floatingpoint.rst
44 |    appendix.rst
45 | 
46 | 
47 | .. _Python 参考文档: https://docs.python.org/3/library/index.html#library-index
48 | .. _Python 参考手册: https://docs.python.org/3/reference/index.html#reference-index
49 | .. _Python 解释器扩展和集成章节: https://docs.python.org/3/extending/index.html#extending-index
50 | .. _C API 参考手册: https://docs.python.org/3/c-api/index.html#c-api-index
51 | .. _词汇表: https://docs.python.org/3/glossary.html#glossary


--------------------------------------------------------------------------------
/docs/source/interactive.rst:
--------------------------------------------------------------------------------
 1 | .. _tut-interacting:
 2 | 
 3 | **************************************************
 4 | 交互式输入行编辑历史回溯
 5 | **************************************************
 6 | 
 7 | 某些版本的 Python 解释器支持编辑当前的输入行和历史记录，类似于在 Korn shell 和 GNU Bash shell 中看到的功能。这是使用 `GNU Readline`_ 库实现的，它支持各种编辑风格。 这个库有它自己的文档，在这里我们不就重复了。
 8 | 
 9 | 
10 | .. _tut-keybindings:
11 | 
12 | Tab 补全和历史记录
13 | ==================================
14 | 
15 | 变量和模块名的补全在解释器启动时 `自动打开 <https://docs.python.org/3/library/site.html#rlcompleter-config>`_ 以便 :kbd:`Tab` 键调用补全功能；它会查看Python语句的名字，当前局部变量以及可以访问的模块名。对于点分表达式如 ``string.a``，它将求出表达式最后一个 ``'.'`` 之前的值，然后根据结果的属性给出补全的建议。注意，如果一个具有 `__getattr__() <https://docs.python.org/3/reference/datamodel.html#object.__getattr__>`_ 方法的对象是表达式的某部分，这可能执行应用程序定义的代码。默认的配置同时会把历史记录保存在你的用户目录下一个名为 :file:`.python_history` 的文件中。在下次与交互式解释器的会话中，历史记录将还可以访问。
16 | 
17 | 
18 | .. _tut-commentary:
19 | 
20 | 其它交互式解释器
21 | ===========================================
22 | 
23 | 与早期版本的解释器相比，现在是向前巨大的进步；然而，有些愿望还是没有实现：如果能对连续的行给出正确的建议就更好了（解析器知道下一行是否需要缩进）。补全机制可以使用解释器的符号表。检查（或者只是建议）匹配的括号、 引号的命令等也会非常有用。
24 | 
25 | 一个增强的交互式解释器是 IPython_，它已经存在相当一段时间，具有 tab 补全、 对象 exploration 和高级的历史记录功能。它也可以彻底定制并嵌入到其他应用程序中。另一个类似的增强的交互式环境是 bpython_。
26 | 
27 | 
28 | 
29 | .. _GNU Readline: http://tiswww.case.edu/php/chet/readline/rltop.html
30 | .. _IPython: http://ipython.scipy.org/
31 | .. _bpython: http://www.bpython-interpreter.org/
32 | 


--------------------------------------------------------------------------------
/docs/source/interpreter.rst:
--------------------------------------------------------------------------------
  1 | .. _tut-using:
  2 | 
  3 | ****************************
  4 | 使用 Python 解释器
  5 | ****************************
  6 | 
  7 | 
  8 | .. _tut-invoking:
  9 | 
 10 | 调用 Python 解释器
 11 | ========================
 12 | 
 13 | Python 解释器通常被安装在目标机器的 :file:`/usr/local/bin/python3.5` 目录下。将 :file:`/usr/local/bin` 目录包含进 Unix shell 的搜索路径里，以确保可以通过输入:
 14 | 
 15 | .. code-block:: text
 16 | 
 17 |    python3.5
 18 | 
 19 | 命令来启动他。[#]_ 由于 Python 解释器的安装路径是可选的，这也可能是其它路径，你可以联系安装 Python 的用户或系统管理员确认（例如，:file:`/usr/local/python` 就是一个常见的选择）。
 20 | 
 21 | 在 Windows 机器上，Python 通常安装在 :file:`C:\\Python35` 位置，当然你可以在运行安装向导时修改此值。要想把此目录添加到你的 PATH 环境变量中，你可以在 DOS 窗口中输入以下命令::
 22 | 
 23 |    set path=%path%;C:\python35
 24 | 
 25 | 通常你可以在主窗口输入一个文件结束符（Unix 系统是 :kbd:`Control-D`，Windows 系统是 :kbd:`Control-Z`）让解释器以 0 状态码退出。如果那没有作用，你可以通过输入 ``quit()`` 命令退出解释器。
 26 | 
 27 | Python 解释器具有简单的行编辑功能。在 Unix 系统上，任何 Python 解释器都可能已经添加了 GNU readline 库支持，这样就具备了精巧的交互编辑和历史记录等功能。在 Python 主窗口中输入 Control-P 可能是检查是否支持命令行编辑的最简单的方法。如果发出嘟嘟声（计算机扬声器），则说明你可以使用命令行编辑功能；更多快捷键的介绍请参考 :ref:`tut-interacting`。如果没有任何声音，或者显示 ``^P`` 字符，则说明命令行编辑功能不可用；你只能通过退格键从当前行删除已键入的字符并重新输入。
 28 | 
 29 | Python 解释器有些操作类似 Unix shell：当使用终端设备（tty）作为标准输入调用时，它交互的解释并执行命令；当使用文件名参数或以文件作为标准输入调用时，它读取文件并将文件作为 *脚本* 执行。
 30 | 
 31 | 第二种启动 Python 解释器的方法是 ``python -c command [arg] ...``，这种方法可以在 *命令行* 执行 Python 语句，类似于 shell 中的 `-c`_ 选项。由于 Python 语句通常会包含空格或其他特殊 shell 字符，一般建议将 *命令* 用单引号包裹起来。
 32 | 
 33 | 有一些 Python 模块也可以当作脚本使用。你可以使用 ``python -m module [arg] ...`` 命令调用它们，这类似在命令行中键入完整的路径名执行 *模块* 源文件一样。
 34 | 
 35 | 使用脚本文件时，经常会运行脚本然后进入交互模式。这也可以通过在脚本之前加上 `-i`_ 参数来实现。
 36 | 
 37 | 
 38 | .. _tut-argpassing:
 39 | 
 40 | 参数传递
 41 | ----------------
 42 | 
 43 | 调用解释器时，脚本名和附加参数传入一个名为 ``sys.argv`` 的字符串列表。你能够获取这个列表通过执行 ``import
 44 | sys``，列表的长度大于等于1；没有给定脚本和参数时，它至少也有一个元素：``sys.argv[0]`` 此时为空字符串。脚本名指定为 ``'-'`` （表示标准输入）时， ``sys.argv[0]`` 被设定为 ``'-'``，使用 `-c`_ *指令* 时，``sys.argv[0]`` 被设定为 ``'-c'``。使用 `-m`_ *模块* 参数时，``sys.argv[0]`` 被设定为指定模块的全名。`-c`_ *指令* 或者 `-m`_ *模块* 之后的参数不会被 Python 解释器的选项处理机制所截获，而是留在 ``sys.argv`` 中，供脚本命令操作。
 45 | 
 46 | 
 47 | .. _tut-interactive:
 48 | 
 49 | 交互模式
 50 | ----------------
 51 | 
 52 | 从 tty 读取命令时，我们称解释器工作于 *交互模式*。这种模式下它根据主提示符来执行，主提示符通常标识为三个大于号(``>>>``)；继续的部分被称为 *从属提示符*，由三个点标识(``...``)。在第一行之前，解释器打印欢迎信息、版本号和授权提示::
 53 | 
 54 |    $ python3.5
 55 |    Python 3.5.2 (default, Mar 16 2014, 09:25:04)
 56 |    [GCC 4.8.2] on linux
 57 |    Type "help", "copyright", "credits" or "license" for more information.
 58 |    >>>
 59 | 
 60 | .. XXX update for new releases
 61 | 
 62 | 输入多行结构时需要从属提示符了，例如，下面这个 `if`_ 语句::
 63 | 
 64 |    >>> the_world_is_flat = 1
 65 |    >>> if the_world_is_flat:
 66 |    ...     print("Be careful not to fall off!")
 67 |    ...
 68 |    Be careful not to fall off!
 69 | 
 70 | 
 71 | 关于交互模式更多的内容，请参见 :ref:`tut-interac`。
 72 | 
 73 | 
 74 | .. _tut-interp:
 75 | 
 76 | 解释器及其环境
 77 | ===================================
 78 | 
 79 | .. _tut-source-encoding:
 80 | 
 81 | 源程序编码
 82 | --------------------
 83 | 
 84 | 默认情况下，Python 源文件是 UTF-8 编码。在此编码下，全世界大多数语言的字符可以同时用在字符串、标识符和注释中 — 尽管 Python 标准库仅使用 ASCII 字符做为标识符，这只是任何可移植代码应该遵守的约定。如果要正确的显示所有的字符，你的编辑器必须能识别出文件是 UTF-8 编码，并且它使用的字体能支持文件中所有的字符。
 85 | 
 86 | 你也可以为源文件指定不同的字符编码。为此，在 ``#!`` 行（首行）后插入至少一行特殊的注释行来定义源文件的编码::
 87 | 
 88 |    # -*- coding: encoding -*-
 89 | 
 90 | 通过此声明，源文件中所有的东西都会被当做用 *encoding* 指代的 UTF-8 编码对待。在 Python 库参考手册 `codecs`_ 一节中你可以找到一张可用的编码列表。
 91 | 
 92 | 例如，如果你的编辑器不支持 UTF-8 编码的文件，但支持像 Windows-1252 的其他一些编码，你可以定义::
 93 | 
 94 |    # -*- coding: cp-1252 -*-
 95 | 
 96 | 这样就可以在源文件中使用 Windows-1252 字符集中的所有字符了。这个特殊的编码注释必须在文件中的 *第一或第二* 行定义。
 97 | 
 98 | 
 99 | 
100 | .. rubric:: Footnotes
101 | 
102 | .. [#] 在 Unix 系统上，Python 3.X 解释器默认未被安装成名为 ``python`` 的命令，所以它不会与同时安装在系统中的 Python 2.x 命令冲突。
103 | 
104 | 
105 | 
106 | .. _-c: https://docs.python.org/3/using/cmdline.html#cmdoption-c
107 | .. _-i: https://docs.python.org/3/using/cmdline.html#cmdoption-i
108 | .. _-m: https://docs.python.org/3/using/cmdline.html#cmdoption-m
109 | .. _if: https://docs.python.org/3/reference/compound_stmts.html#if
110 | .. _codecs: https://docs.python.org/3/library/codecs.html#module-codecs
111 | 


--------------------------------------------------------------------------------
/docs/source/stdlib.rst:
--------------------------------------------------------------------------------
  1 | .. _tut-brieftour:
  2 | 
  3 | **********************************
  4 | Python 标准库概览
  5 | **********************************
  6 | 
  7 | 
  8 | .. _tut-os-interface:
  9 | 
 10 | 操作系统接口
 11 | ==========================
 12 | 
 13 | `os`_ 模块提供了很多与操作系统交互的函数::
 14 | 
 15 |    >>> import os
 16 |    >>> os.getcwd()      # Return the current working directory
 17 |    'C:\\Python35'
 18 |    >>> os.chdir('/server/accesslogs')   # Change current working directory
 19 |    >>> os.system('mkdir today')   # Run the command mkdir in the system shell
 20 |    0
 21 | 
 22 | 应该用 ``import os`` 风格而非 ``from os import *``。这样可以保证随操作系统不同而有所变化的 `os.open()`_ 不会覆盖内置函数 `open()`_。
 23 | 
 24 | .. index:: builtin: help
 25 | 
 26 | 在使用一些像 `os`_ 这样的大型模块时内置的 `dir()`_ 和 `help()`_ 函数非常有用::
 27 | 
 28 |    >>> import os
 29 |    >>> dir(os)
 30 |    <returns a list of all module functions>
 31 |    >>> help(os)
 32 |    <returns an extensive manual page created from the module's docstrings>
 33 | 
 34 | 针对日常的文件和目录管理任务，`shutil`_ 模块提供了一个易于使用的高级接口::
 35 | 
 36 |    >>> import shutil
 37 |    >>> shutil.copyfile('data.db', 'archive.db')
 38 |    'archive.db'
 39 |    >>> shutil.move('/build/executables', 'installdir')
 40 |    'installdir'
 41 | 
 42 | 
 43 | .. _tut-file-wildcards:
 44 | 
 45 | 文件通配符
 46 | ==============
 47 | 
 48 | `glob`_ 模块提供了一个函数用于从目录通配符搜索中生成文件列表::
 49 | 
 50 |    >>> import glob
 51 |    >>> glob.glob('*.py')
 52 |    ['primes.py', 'random.py', 'quote.py']
 53 | 
 54 | 
 55 | .. _tut-command-line-arguments:
 56 | 
 57 | 命令行参数
 58 | ======================
 59 | 
 60 | 通用工具脚本经常调用命令行参数。这些命令行参数以链表形式存储于 `sys`_ 模块的 *argv* 变量。例如在命令行中执行 ``python demo.py one two three`` 后可以得到以下输出结果::
 61 | 
 62 |    >>> import sys
 63 |    >>> print(sys.argv)
 64 |    ['demo.py', 'one', 'two', 'three']
 65 | 
 66 | `getopt`_ 模块使用 Unix `getopt()`_ 函数处理 *sys.argv*。更多的复杂命令行处理由 `argparse`_ 模块提供。
 67 | 
 68 | 
 69 | .. _tut-stderr:
 70 | 
 71 | 错误输出重定向和程序终止
 72 | ================================================
 73 | 
 74 | `sys`_ 还有 *stdin*， *stdout* 和 *stderr* 属性，即使在 *stdout* 被重定向时，后者也可以用于显示警告和错误信息::
 75 | 
 76 |    >>> sys.stderr.write('Warning, log file not found starting a new one\n')
 77 |    Warning, log file not found starting a new one
 78 | 
 79 | 大多脚本的直接终止都使用 ``sys.exit()``。
 80 | 
 81 | 
 82 | .. _tut-string-pattern-matching:
 83 | 
 84 | 字符串正则匹配
 85 | =======================
 86 | 
 87 | `re`_ 模块为高级字符串处理提供了正则表达式工具。对于复杂的匹配和处理，正则表达式提供了简洁、优化的解决方案::
 88 | 
 89 |    >>> import re
 90 |    >>> re.findall(r'\bf[a-z]*', 'which foot or hand fell fastest')
 91 |    ['foot', 'fell', 'fastest']
 92 |    >>> re.sub(r'(\b[a-z]+) \1', r'\1', 'cat in the the hat')
 93 |    'cat in the hat'
 94 | 
 95 | 只需简单的操作时，字符串方法最好用，因为它们易读，又容易调试::
 96 | 
 97 |    >>> 'tea for too'.replace('too', 'two')
 98 |    'tea for two'
 99 | 
100 | 
101 | .. _tut-mathematics:
102 | 
103 | 数学
104 | ===========
105 | 
106 | `math`_ 模块为浮点运算提供了对底层C函数库的访问::
107 | 
108 |    >>> import math
109 |    >>> math.cos(math.pi / 4.0)
110 |    0.70710678118654757
111 |    >>> math.log(1024, 2)
112 |    10.0
113 | 
114 | `random`_ 提供了生成随机数的工具::
115 | 
116 |    >>> import random
117 |    >>> random.choice(['apple', 'pear', 'banana'])
118 |    'apple'
119 |    >>> random.sample(range(100), 10)   # sampling without replacement
120 |    [30, 83, 16, 4, 8, 81, 41, 50, 18, 33]
121 |    >>> random.random()    # random float
122 |    0.17970987693706186
123 |    >>> random.randrange(6)    # random integer chosen from range(6)
124 |    4
125 | 
126 | SciPy <http://scipy.org> 项目提供了许多数值计算的模块。
127 | 
128 | 
129 | .. _tut-internet-access:
130 | 
131 | 互联网访问
132 | ===============
133 | 
134 | 有几个模块用于访问互联网以及处理网络通信协议。其中最简单的两个是用于处理从 urls 接收的数据的 `urllib.request`_ 以及用于发送电子邮件的 `smtplib`_::
135 | 
136 |    >>> from urllib.request import urlopen
137 |    >>> for line in urlopen('http://tycho.usno.navy.mil/cgi-bin/timer.pl'):
138 |    ...     line = line.decode('utf-8')  # Decoding the binary data to text.
139 |    ...     if 'EST' in line or 'EDT' in line:  # look for Eastern Time
140 |    ...         print(line)
141 | 
142 |    <BR>Nov. 25, 09:43:32 PM EST
143 | 
144 |    >>> import smtplib
145 |    >>> server = smtplib.SMTP('localhost')
146 |    >>> server.sendmail('soothsayer@example.org', 'jcaesar@example.org',
147 |    ... """To: jcaesar@example.org
148 |    ... From: soothsayer@example.org
149 |    ...
150 |    ... Beware the Ides of March.
151 |    ... """)
152 |    >>> server.quit()
153 | 
154 | (注意第二个例子需要在 localhost 运行一个邮件服务器。)
155 | 
156 | 
157 | .. _tut-dates-and-times:
158 | 
159 | 日期和时间
160 | ===============
161 | 
162 | `datetime`_ 模块为日期和时间处理同时提供了简单和复杂的方法。支持日期和时间算法的同时，实现的重点放在更有效的处理和格式化输出。该模块还支持时区处理。 ::
163 | 
164 |    >>> # dates are easily constructed and formatted
165 |    >>> from datetime import date
166 |    >>> now = date.today()
167 |    >>> now
168 |    datetime.date(2003, 12, 2)
169 |    >>> now.strftime("%m-%d-%y. %d %b %Y is a %A on the %d day of %B.")
170 |    '12-02-03. 02 Dec 2003 is a Tuesday on the 02 day of December.'
171 | 
172 |    >>> # dates support calendar arithmetic
173 |    >>> birthday = date(1964, 7, 31)
174 |    >>> age = now - birthday
175 |    >>> age.days
176 |    14368
177 | 
178 | 
179 | 
180 | .. _tut-data-compression:
181 | 
182 | 数据压缩
183 | ================
184 | 
185 | 以下模块直接支持通用的数据打包和压缩格式：`zlib`_， `gzip`_， `bz2`_， `lzma`_， `zipfile`_ 以及 
186 | `tarfile`_。 ::
187 | 
188 |    >>> import zlib
189 |    >>> s = b'witch which has which witches wrist watch'
190 |    >>> len(s)
191 |    41
192 |    >>> t = zlib.compress(s)
193 |    >>> len(t)
194 |    37
195 |    >>> zlib.decompress(t)
196 |    b'witch which has which witches wrist watch'
197 |    >>> zlib.crc32(s)
198 |    226805979
199 | 
200 | 
201 | .. _tut-performance-measurement:
202 | 
203 | 性能度量
204 | =======================
205 | 
206 | 有些用户对了解解决同一问题的不同方法之间的性能差异很感兴趣。Python 提供了一个度量工具，为这些问题提供了直接答案。
207 | 
208 | 例如，使用元组封装和拆封来交换元素看起来要比使用传统的方法要诱人的多。`timeit`_ 证明了后者更快一些::
209 | 
210 |    >>> from timeit import Timer
211 |    >>> Timer('t=a; a=b; b=t', 'a=1; b=2').timeit()
212 |    0.57535828626024577
213 |    >>> Timer('a,b = b,a', 'a=1; b=2').timeit()
214 |    0.54962537085770791
215 | 
216 | 相对于 `timeit`_ 的细粒度，`profile`_ 和 `pstats`_ 模块提供了针对更大代码块的时间度量工具。
217 | 
218 | 
219 | .. _tut-quality-control:
220 | 
221 | 质量控制
222 | ===============
223 | 
224 | 开发高质量软件的方法之一是为每一个函数开发测试代码，并且在开发过程中经常进行测试。 
225 | 
226 | `doctest`_ 模块提供了一个工具，扫描模块并根据程序中内嵌的文档字符串执行测试。测试构造如同简单的将它的输出结果剪切并粘贴到文档字符串中。通过用户提供的例子，它发展了文档，允许 doctest 模块确认代码的结果是否与文档一致::
227 | 
228 |    def average(values):
229 |        """Computes the arithmetic mean of a list of numbers.
230 | 
231 |        >>> print(average([20, 30, 70]))
232 |        40.0
233 |        """
234 |        return sum(values) / len(values)
235 | 
236 |    import doctest
237 |    doctest.testmod()   # automatically validate the embedded tests
238 | 
239 | 
240 | `unittest`_ 模块不像 `doctest`_ 模块那么容易使用，不过它可以在一个独立的文件里提供一个更全面的测试集::
241 | 
242 |    import unittest
243 | 
244 |    class TestStatisticalFunctions(unittest.TestCase):
245 | 
246 |        def test_average(self):
247 |            self.assertEqual(average([20, 30, 70]), 40.0)
248 |            self.assertEqual(round(average([1, 5, 7]), 1), 4.3)
249 |            with self.assertRaises(ZeroDivisionError):
250 |                average([])
251 |            with self.assertRaises(TypeError):
252 |                average(20, 30, 70)
253 | 
254 |    unittest.main() # Calling from the command line invokes all tests
255 | 
256 | 
257 | .. _tut-batteries-included:
258 | 
259 | “瑞士军刀”
260 | ==================
261 | 
262 | Python 展现了“瑞士军刀”的哲学。这可以通过它更大的包的高级和健壮的功能来得到最好的展现。列如:
263 | 
264 | * `xmlrpc.client`_ 和 `xmlrpc.server`_ 模块让远程过程调用变得轻而易举。尽管模块有这样的名字，用户无需拥有 XML 的知识或处理 XML。
265 | 
266 | * `email`_ 包是一个管理邮件信息的库，包括MIME和其它基于 RFC2822 的信息文档。
267 |   
268 |   不同于实际发送和接收信息的 `smtplib`_ 和 `poplib`_ 模块，email 包包含一个构造或解析复杂消息结构（包括附件）及实现互联网编码和头协议的完整工具集。
269 | 
270 | * `xml.dom`_ 和 `xml.sax`_ 包为流行的信息交换格式提供了强大的支持。同样， `csv`_  模块支持在通用数据库格式中直接读写。
271 |   
272 |   综合起来，这些模块和包大大简化了 Python 应用程序和其它工具之间的数据交换。
273 | 
274 | * 国际化由 `gettext`_， `locale`_ 和 `codecs`_ 包支持。
275 | 
276 | 
277 | 
278 | .. _os: https://docs.python.org/3/library/os.html#module-os
279 | .. _os.open(): https://docs.python.org/3/library/os.html#os.open
280 | .. _open(): https://docs.python.org/3/library/functions.html#open
281 | .. _dir(): https://docs.python.org/3/library/functions.html#dir
282 | .. _help(): https://docs.python.org/3/library/functions.html#help
283 | .. _shutil: https://docs.python.org/3/library/shutil.html#module-shutil
284 | .. _glob: https://docs.python.org/3/library/glob.html#module-glob
285 | .. _sys: https://docs.python.org/3/library/sys.html#module-sys
286 | .. _getopt: https://docs.python.org/3/library/getopt.html#module-getopt
287 | .. _getopt(): https://docs.python.org/3/library/getopt.html#module-getopt
288 | .. _argparse: https://docs.python.org/3/library/argparse.html#module-argparse
289 | .. _re: https://docs.python.org/3/library/re.html#module-re
290 | .. _math: https://docs.python.org/3/library/math.html#module-math
291 | .. _random: https://docs.python.org/3/library/random.html#module-random
292 | .. _urllib.request: https://docs.python.org/3/library/urllib.request.html#module-urllib.request
293 | .. _smtplib: https://docs.python.org/3/library/smtplib.html#module-smtplib
294 | .. _datetime: https://docs.python.org/3/library/datetime.html#module-datetime
295 | .. _zlib: https://docs.python.org/3/library/zlib.html#module-zlib
296 | .. _gzip: https://docs.python.org/3/library/gzip.html#module-gzip
297 | .. _bz2: https://docs.python.org/3/library/bz2.html#module-bz2
298 | .. _lzma: https://docs.python.org/3/library/lzma.html#module-lzma
299 | .. _zipfile: https://docs.python.org/3/library/zipfile.html#module-zipfile
300 | .. _tarfile: https://docs.python.org/3/library/tarfile.html#module-tarfile
301 | .. _timeit: https://docs.python.org/3/library/timeit.html#module-timeit
302 | .. _profile: https://docs.python.org/3/library/profile.html#module-profile
303 | .. _pstats: https://docs.python.org/3/library/profile.html#module-pstats
304 | .. _doctest: https://docs.python.org/3/library/doctest.html#module-doctest
305 | .. _unittest: https://docs.python.org/3/library/unittest.html#module-unittest
306 | .. _xmlrpc.client: https://docs.python.org/3/library/xmlrpc.client.html#module-xmlrpc.client
307 | .. _xmlrpc.server: https://docs.python.org/3/library/xmlrpc.server.html#module-xmlrpc.server
308 | .. _email: https://docs.python.org/3/library/email.html#module-email
309 | .. _poplib: https://docs.python.org/3/library/poplib.html#module-poplib
310 | .. _xml.dom: https://docs.python.org/3/library/xml.dom.html#module-xml.dom
311 | .. _xml.sax: https://docs.python.org/3/library/xml.sax.html#module-xml.sax
312 | .. _csv: https://docs.python.org/3/library/csv.html#module-csv
313 | .. _gettext: https://docs.python.org/3/library/gettext.html#module-gettext
314 | .. _locale: https://docs.python.org/3/library/locale.html#module-locale
315 | .. _codecs: https://docs.python.org/3/library/codecs.html#module-codecs


--------------------------------------------------------------------------------
/docs/source/venv.rst:
--------------------------------------------------------------------------------
  1 | 
  2 | .. _tut-venv:
  3 | 
  4 | *********************************
  5 | 虚拟环境和包
  6 | *********************************
  7 | 
  8 | 简介
  9 | ============
 10 | 
 11 | Python 应用程序经常会使用一些不属于标准库的包和模块。应用程序有时候需要某个特定版本的库，因为它需要一个特定的 bug 已得到修复的库或者它是使用了一个过时版本的库的接口编写的。
 12 | 
 13 | 这就意味着可能无法安装一个 Python 来满足每个应用程序的要求。如果应用程序 A 需要一个特定模块的 1.0 版本但是应用程序 B 需要该模块的 2.0 版本，这两个应用程序的要求是冲突的，安装版本 1.0 或者版本 2.0 将会导致其中一个应用程序不能运行。
 14 | 
 15 | 这个问题的解决方案就是创建一个 `虚拟环境 <https://docs.python.org/3/glossary.html#term-virtual-environment>`_ （通常简称为 “virtualenv”），包含一个特定版本的 Python，以及一些附加的包的独立的目录树。
 16 | 
 17 | 不同的应用程序可以使用不同的虚拟环境。为了解决前面例子中的冲突，应用程序 A 可以有自己的虚拟环境，其中安装了特定模块的 1.0 版本。而应用程序 B 拥有另外一个安装了特定模块 2.0 版本的虚拟环境。如果应用程序 B 需求一个库升级到 3.0 的话，这也不会影响到应用程序 A 的环境。
 18 | 
 19 | 
 20 | 创建虚拟环境
 21 | =============================
 22 | 
 23 | 用于创建和管理虚拟环境的脚本叫做 :program:`pyvenv`。:program:`pyvenv` 通常会安装你可用的 Python 中最新的版本。这个脚本也能指定安装一个特定的版本的 Python，因此如果在你的系统中有多个版本的 Python 的话，你可以运行 ``pyvenv-3.5`` 或者你想要的任何版本来选择一个指定的 Python 版本。
 24 | 
 25 | 要创建一个 virtualenv，首先决定一个你想要存放的目录接着运行 :program:`pyvenv` 后面携带着目录名::
 26 | 
 27 |    pyvenv tutorial-env
 28 | 
 29 | 如果目录不存在的话，这将会创建一个 ``tutorial-env`` 目录，并且也在目录里面创建一个包含 Python 解释器，标准库，以及各种配套文件的 Python “副本”。
 30 | 
 31 | 一旦你已经创建了一个虚拟环境，你必须激活它。
 32 | 
 33 | 在 Windows 上，运行::
 34 | 
 35 |   tutorial-env/Scripts/activate
 36 | 
 37 | 在 Unix 或者 MacOS 上，运行::
 38 | 
 39 |   source tutorial-env/bin/activate
 40 | 
 41 | （这个脚本是用 bash shell 编写的。如果你使用 :program:`csh` 或者 :program:`fish` shell，你应该使用 ``activate.csh`` 和 ``activate.fish`` 来替代。）
 42 | 
 43 | 激活了虚拟环境会改变你的 shell 提示符，显示你正在使用的虚拟环境，并且修改了环境以致运行 ``python`` 将会让你得到了特定的 Python 版本。例如::
 44 | 
 45 |   -> source ~/envs/tutorial-env/bin/activate
 46 |   (tutorial-env) -> python
 47 |   Python 3.5.2+ (3.4:c7b9645a6f35+, May 22 2015, 09:31:25)
 48 |     ...
 49 |   >>> import sys
 50 |   >>> sys.path
 51 |   ['', '/usr/local/lib/python35.zip', ...,
 52 |   '~/envs/tutorial-env/lib/python3.5/site-packages']
 53 |   >>>
 54 | 
 55 | 
 56 | 使用 pip 管理包
 57 | ==========================
 58 | 
 59 | 一旦你激活了一个虚拟环境，可以使用一个叫做 :program:`pip` 程序来安装，升级以及删除包。默认情况下 ``pip`` 将会从 Python Package Index，<https://pypi.python.org/pypi>， 中安装包。你可以通过 web 浏览器浏览它们，或者你也能使用 ``pip`` 有限的搜索功能::
 60 | 
 61 |   (tutorial-env) -> pip search astronomy
 62 |   skyfield               - Elegant astronomy for Python
 63 |   gary                   - Galactic astronomy and gravitational dynamics.
 64 |   novas                  - The United States Naval Observatory NOVAS astronomy library
 65 |   astroobs               - Provides astronomy ephemeris to plan telescope observations
 66 |   PyAstronomy            - A collection of astronomy related tools for Python.
 67 |   ...
 68 | 
 69 | ``pip`` 有许多子命令：“搜索”，“安装”，“卸载”，“freeze”（译者注：这个词语暂时没有合适的词语来翻译），等等。（请参考 `installing-index <https://docs.python.org/3/installing/index.html#installing-index>`_ 指南获取 ``pip`` 更多完整的文档。）
 70 | 
 71 | 你可以安装一个包最新的版本，通过指定包的名称::
 72 | 
 73 |   -> pip install novas
 74 |   Collecting novas
 75 |     Downloading novas-3.1.1.3.tar.gz (136kB)
 76 |   Installing collected packages: novas
 77 |     Running setup.py install for novas
 78 |   Successfully installed novas-3.1.1.3
 79 | 
 80 | 你也能安装一个指定版本的包，通过给出包名后面紧跟着 ``==`` 和版本号::
 81 | 
 82 |   -> pip install requests==2.6.0
 83 |   Collecting requests==2.6.0
 84 |     Using cached requests-2.6.0-py2.py3-none-any.whl
 85 |   Installing collected packages: requests
 86 |   Successfully installed requests-2.6.0
 87 | 
 88 | 如果你重新运行命令（pip install requests==2.6.0），``pip`` 会注意到要求的版本已经安装，不会去做任何事情。你也可以提供一个不同的版本号来安装，或者运行 ``pip
 89 | install --upgrade`` 来升级包到最新版本::
 90 | 
 91 |   -> pip install --upgrade requests
 92 |   Collecting requests
 93 |   Installing collected packages: requests
 94 |     Found existing installation: requests 2.6.0
 95 |       Uninstalling requests-2.6.0:
 96 |         Successfully uninstalled requests-2.6.0
 97 |   Successfully installed requests-2.7.0
 98 | 
 99 | ``pip uninstall`` 后跟一个或者多个包名将会从虚拟环境中移除这些包。
100 | 
101 | ``pip show`` 将会显示一个指定的包的信息::
102 | 
103 |   (tutorial-env) -> pip show requests
104 |   ---
105 |   Metadata-Version: 2.0
106 |   Name: requests
107 |   Version: 2.7.0
108 |   Summary: Python HTTP for Humans.
109 |   Home-page: http://python-requests.org
110 |   Author: Kenneth Reitz
111 |   Author-email: me@kennethreitz.com
112 |   License: Apache 2.0
113 |   Location: /Users/akuchling/envs/tutorial-env/lib/python3.4/site-packages
114 |   Requires:
115 | 
116 | ``pip list`` 将会列出所有安装在虚拟环境中的包::
117 | 
118 |   (tutorial-env) -> pip list
119 |   novas (3.1.1.3)
120 |   numpy (1.9.2)
121 |   pip (7.0.3)
122 |   requests (2.7.0)
123 |   setuptools (16.0)
124 |  
125 | ``pip freeze`` 将会生成一个类似需要安装的包的列表，但是输出采用了 ``pip install`` 期望的格式。常见的做法就是把它们放在一个 ``requirements.txt`` 文件::
126 | 
127 |   (tutorial-env) -> pip freeze > requirements.txt
128 |   (tutorial-env) -> cat requirements.txt
129 |   novas==3.1.1.3
130 |   numpy==1.9.2
131 |   requests==2.7.0
132 | 
133 | ``requirements.txt`` 能够被提交到版本控制中并且作为一个应用程序的一部分。用户们可以使用 ``install -r`` 安装所有必须的包::
134 | 
135 |   -> pip install -r requirements.txt
136 |   Collecting novas==3.1.1.3 (from -r requirements.txt (line 1))
137 |     ...
138 |   Collecting numpy==1.9.2 (from -r requirements.txt (line 2))
139 |     ...
140 |   Collecting requests==2.7.0 (from -r requirements.txt (line 3))
141 |     ...
142 |   Installing collected packages: novas, numpy, requests
143 |     Running setup.py install for novas
144 |   Successfully installed novas-3.1.1.3 numpy-1.9.2 requests-2.7.0
145 | 
146 | ``pip`` 还有更多的选项。请参考 `installing-index <https://docs.python.org/3/installing/index.html#installing-index>`_ 指南获取关于 ``pip`` 完整的文档。当你编写一个包并且在 Python Package Index 中也出现的话，请参考 `distributing-index <https://docs.python.org/3/distributing/index.html#distributing-index>`_ 指南。
147 | 


--------------------------------------------------------------------------------
/docs/source/whatnow.rst:
--------------------------------------------------------------------------------
 1 | .. _tut-whatnow:
 2 | 
 3 | *********
 4 | 接下来？
 5 | *********
 6 | 
 7 | 读过这本指南应该会让你有兴趣使用 Python —— 可能你已经期待着用 Python 解决你的实际问题了。可以在哪里进行一步学习？ 
 8 | 
 9 | 入门指南是 Python 文档集的一部分。其中的另一些文档包括：
10 | 
11 | * `Python 标准库 <https://docs.python.org/3/library/index.html#library-index>`_：
12 | 
13 |   应该浏览一下这份文档，它为标准库中的类型、函数和模块提供了完整（尽管很简略）的参考资料。标准的 Python 发布版包括了 大量 的附加模块。其中有针对读取 Unix 邮箱、接收 HTTP 文档、生成随机数、解析命令行选项、写 CGI 程序、压缩数据以及很多其它任务的模块。略读一下库参考会给你很多解决问题的思路。
14 | 
15 | * `安装 Python 模块 <https://docs.python.org/3/installing/index.html#installing-index>`_ 展示了如何安装其他 Python 用户编写的附加模块。
16 | 
17 | * `Python 语言参考 <https://docs.python.org/3/reference/index.html#reference-index>`_： 詳細说明了 Python 语法和语义。
18 |   
19 |   它读起来很累，不过对于语言本身，有份完整的手册很有用。
20 | 
21 | 其它 Python 资源：
22 | 
23 | * http://www.python.org： Python 官方网站。它包含代码、文档和 Web 上与 Python 有关的页面链接该网站镜像于全世界的几处其它问题，类似欧洲、日本和澳大利亚。
24 |   
25 |   镜像可能会比主站快，这取决于你的地理位置。
26 | 
27 | * http://docs.python.org： 快速访问 Python 的文档。
28 | 
29 | * http://pypi.python.org： Python 包索引，以前昵称为奶酪店，索引了可供下载的，用户创建的 Python 模块。如果你发布了代码，可以注册到这里，这样别人可以找到它。
30 | 
31 | * http://code.activestate.com/recipes/langs/python/： Python 食谱是大量的示例代码、大型的集合，和有用的脚本。
32 |   
33 |   值得关注的是这次资源已经结集成书，名为《Python 食谱》（O’Reilly & Associates, ISBN 0-596-00797-3。）
34 | 
35 | * http://scipy.org: The Scientific Python 项目包括数组快速计算和处理模块，和大量线性代数、傅里叶变换、非线性solvers、随机数分布，统计分析以及类似的包。
36 | 
37 | 与 Python 有关的问题，以及问题报告，可以发到新闻组 :newsgroup:`comp.lang.python` ，或者发送到邮件组 python-list@python.org 。新闻组和邮件组是开放的，所以发送的消息可以自动的跟到另一个之后。每天有超过 120 个投递（高峰时有数百）,提问（以及回答）问题，为新功能提建议，发布新模块。在发信之前，请查阅 `常见问题
38 | <http://www.python.org/doc/faq/>`_ (亦称 FAQ)，或者在 Python 源码发布包的 :file:`Misc/` 目录中查阅。邮件组也可以在 http://mail.python.org/pipermail/ 访问。FAQ回答了很多被反复提到的问题，很可能已经解答了你的问题。
39 | 
40 | .. Postings figure based on average of last six months activity as
41 |    最近六个月的提交数在 www.egroups.com 有报告；2000年六月：21272 封 / 182 天 ＝ 116.9 封／天，并且还在平稳的上升。（现在是多少？）
42 | 
43 | 
44 | 
45 | 


--------------------------------------------------------------------------------