From b6506a8cf071655cc799e6d9f084ee9c3e5568ac Mon Sep 17 00:00:00 2001 From: Muhammad Atif <221024@students.au.edu.pk> Date: Tue, 22 Oct 2024 00:22:15 +0500 Subject: [PATCH] add these changes --- .gitignore | 16 - ...41\347\220\206\346\250\241\345\235\227.md" | 429 ------ ...41\347\220\206\346\250\241\345\235\227.md" | 38 - Article/PythonBasis/python0/WhyStudyPython.md | 43 - Article/PythonBasis/python1/IDE.md | 9 - Article/PythonBasis/python1/Installation.md | 68 - Article/PythonBasis/python1/Introduction.md | 25 - Article/PythonBasis/python1/Preface.md | 8 - .../python1/The_first_procedure.md | 28 - Article/PythonBasis/python10/1.md | 33 - Article/PythonBasis/python10/2.md | 65 - Article/PythonBasis/python10/3.md | 74 -- Article/PythonBasis/python10/4.md | 143 -- Article/PythonBasis/python10/5.md | 86 -- Article/PythonBasis/python10/6.md | 116 -- Article/PythonBasis/python10/Preface.md | 11 - Article/PythonBasis/python11/1.md | 52 - Article/PythonBasis/python11/2.md | 36 - Article/PythonBasis/python11/3.md | 47 - Article/PythonBasis/python11/4.md | 75 -- Article/PythonBasis/python11/Preface.md | 11 - Article/PythonBasis/python12/1.md | 69 - Article/PythonBasis/python12/2.md | 115 -- Article/PythonBasis/python12/3.md | 102 -- Article/PythonBasis/python12/4.md | 163 --- Article/PythonBasis/python12/5.md | 37 - Article/PythonBasis/python12/Preface.md | 13 - Article/PythonBasis/python13/1.md | 57 - Article/PythonBasis/python13/2.md | 394 ------ Article/PythonBasis/python13/3.md | 317 ----- Article/PythonBasis/python13/Preface.md | 9 - Article/PythonBasis/python14/1.md | 91 -- Article/PythonBasis/python14/2.md | 81 -- Article/PythonBasis/python14/3.md | 76 -- Article/PythonBasis/python14/4.md | 18 - Article/PythonBasis/python14/5.md | 56 - Article/PythonBasis/python14/6.md | 95 -- Article/PythonBasis/python14/Preface.md | 5 - ...31\350\241\250\350\276\276\345\274\217.md" | 86 -- ...1\350\241\250\350\276\276\345\274\217.png" | Bin 189841 -> 0 bytes ...1\350\241\250\350\276\276\345\274\217.png" | Bin 20029 -> 0 bytes Article/PythonBasis/python15/1.md | 150 --- Article/PythonBasis/python16/1.md | 213 --- Article/PythonBasis/python2/Grammar.md | 16 - Article/PythonBasis/python2/Preface.md | 10 - Article/PythonBasis/python2/StringCoding.md | 30 - .../PythonBasis/python2/Type_conversion.md | 69 - Article/PythonBasis/python2/Type_of_data.md | 180 --- Article/PythonBasis/python2/Variable.md | 47 - Article/PythonBasis/python2/print.md | 52 - Article/PythonBasis/python3/List.md | 268 ---- Article/PythonBasis/python3/Preface.md | 12 - Article/PythonBasis/python3/tuple.md | 196 --- Article/PythonBasis/python4/Dict.md | 201 --- Article/PythonBasis/python4/Preface.md | 15 - Article/PythonBasis/python4/Set.md | 141 -- Article/PythonBasis/python5/Cycle.md | 313 ----- Article/PythonBasis/python5/Example.md | 45 - Article/PythonBasis/python5/If.md | 178 --- Article/PythonBasis/python5/Preface.md | 16 - Article/PythonBasis/python6/1.md | 101 -- Article/PythonBasis/python6/2.md | 68 - Article/PythonBasis/python6/3.md | 266 ---- Article/PythonBasis/python6/4.md | 96 -- Article/PythonBasis/python6/5.md | 63 - Article/PythonBasis/python6/Preface.md | 13 - Article/PythonBasis/python7/1.md | 65 - Article/PythonBasis/python7/2.md | 50 - Article/PythonBasis/python7/3.md | 110 -- Article/PythonBasis/python7/4.md | 207 --- Article/PythonBasis/python7/5.md | 102 -- Article/PythonBasis/python7/Preface.md | 11 - Article/PythonBasis/python8/1.md | 54 - Article/PythonBasis/python8/2.md | 83 -- Article/PythonBasis/python8/3.md | 57 - Article/PythonBasis/python8/4.md | 32 - Article/PythonBasis/python8/5.md | 171 --- Article/PythonBasis/python8/6.md | 146 -- Article/PythonBasis/python8/7.md | 181 --- Article/PythonBasis/python8/8.md | 70 - Article/PythonBasis/python8/9.md | 118 -- Article/PythonBasis/python8/Preface.md | 30 - Article/PythonBasis/python9/1.md | 50 - Article/PythonBasis/python9/2.md | 117 -- Article/PythonBasis/python9/3.md | 25 - Article/PythonBasis/python9/4.md | 21 - Article/PythonBasis/python9/5.md | 57 - Article/PythonBasis/python9/Preface.md | 9 - ...irtualenv\345\222\214virtualenvwrapper.md" | 140 -- ...66\345\217\221\351\202\256\344\273\266.md" | 66 - Article/advanced/advanced.md | 2 - ...32\346\213\237\347\216\257\345\242\203.md" | 130 -- .../codeSpecification_Preface.md | 10 - .../codeSpecification_first.md | 257 ---- .../codeSpecification_second.md | 128 -- .../codeSpecification_third.md | 82 -- Article/django/Django.md | 12 - ...05\346\214\207\345\215\227Django-part1.md" | 472 ------- ...05\346\214\207\345\215\227Django-part2.md" | 1182 ----------------- ...5\205\263\351\224\256\345\255\227yield.md" | 279 ---- README.md | 169 --- Res/FQ.md | 28 - ...21\347\253\231\350\265\204\346\272\220.md" | 47 - ...sr\346\234\215\345\212\241\345\231\250.md" | 293 ---- SUMMARY.md | 96 -- TwoWater-Python.json | 6 - book.json | 13 - feature.txt | 1 + 108 files changed, 1 insertion(+), 11134 deletions(-) delete mode 100644 .gitignore delete mode 100644 "Article/Linux/Linux\345\221\275\344\273\244-\346\226\207\344\273\266\347\256\241\347\220\206\346\250\241\345\235\227.md" delete mode 100644 "Article/Linux/Linux\345\221\275\344\273\244-\347\224\250\346\210\267,\346\235\203\351\231\220\347\256\241\347\220\206\346\250\241\345\235\227.md" delete mode 100644 Article/PythonBasis/python0/WhyStudyPython.md delete mode 100644 Article/PythonBasis/python1/IDE.md delete mode 100644 Article/PythonBasis/python1/Installation.md delete mode 100644 Article/PythonBasis/python1/Introduction.md delete mode 100644 Article/PythonBasis/python1/Preface.md delete mode 100644 Article/PythonBasis/python1/The_first_procedure.md delete mode 100644 Article/PythonBasis/python10/1.md delete mode 100644 Article/PythonBasis/python10/2.md delete mode 100644 Article/PythonBasis/python10/3.md delete mode 100644 Article/PythonBasis/python10/4.md delete mode 100644 Article/PythonBasis/python10/5.md delete mode 100644 Article/PythonBasis/python10/6.md delete mode 100644 Article/PythonBasis/python10/Preface.md delete mode 100644 Article/PythonBasis/python11/1.md delete mode 100644 Article/PythonBasis/python11/2.md delete mode 100644 Article/PythonBasis/python11/3.md delete mode 100644 Article/PythonBasis/python11/4.md delete mode 100644 Article/PythonBasis/python11/Preface.md delete mode 100644 Article/PythonBasis/python12/1.md delete mode 100644 Article/PythonBasis/python12/2.md delete mode 100644 Article/PythonBasis/python12/3.md delete mode 100644 Article/PythonBasis/python12/4.md delete mode 100644 Article/PythonBasis/python12/5.md delete mode 100644 Article/PythonBasis/python12/Preface.md delete mode 100644 Article/PythonBasis/python13/1.md delete mode 100644 Article/PythonBasis/python13/2.md delete mode 100644 Article/PythonBasis/python13/3.md delete mode 100644 Article/PythonBasis/python13/Preface.md delete mode 100644 Article/PythonBasis/python14/1.md delete mode 100644 Article/PythonBasis/python14/2.md delete mode 100644 Article/PythonBasis/python14/3.md delete mode 100644 Article/PythonBasis/python14/4.md delete mode 100644 Article/PythonBasis/python14/5.md delete mode 100644 Article/PythonBasis/python14/6.md delete mode 100644 Article/PythonBasis/python14/Preface.md delete mode 100644 "Article/PythonBasis/python14/\345\270\270\347\224\250\347\232\204\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217.md" delete mode 100644 "Article/PythonBasis/python14/\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217.png" delete mode 100644 "Article/PythonBasis/python14/\350\215\211\346\240\271\345\255\246Python\357\274\210\345\215\201\345\233\233\357\274\211 \344\270\200\346\255\245\344\270\200\346\255\245\344\272\206\350\247\243\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217.png" delete mode 100644 Article/PythonBasis/python15/1.md delete mode 100644 Article/PythonBasis/python16/1.md delete mode 100644 Article/PythonBasis/python2/Grammar.md delete mode 100644 Article/PythonBasis/python2/Preface.md delete mode 100644 Article/PythonBasis/python2/StringCoding.md delete mode 100644 Article/PythonBasis/python2/Type_conversion.md delete mode 100644 Article/PythonBasis/python2/Type_of_data.md delete mode 100644 Article/PythonBasis/python2/Variable.md delete mode 100644 Article/PythonBasis/python2/print.md delete mode 100644 Article/PythonBasis/python3/List.md delete mode 100644 Article/PythonBasis/python3/Preface.md delete mode 100644 Article/PythonBasis/python3/tuple.md delete mode 100644 Article/PythonBasis/python4/Dict.md delete mode 100644 Article/PythonBasis/python4/Preface.md delete mode 100644 Article/PythonBasis/python4/Set.md delete mode 100644 Article/PythonBasis/python5/Cycle.md delete mode 100644 Article/PythonBasis/python5/Example.md delete mode 100644 Article/PythonBasis/python5/If.md delete mode 100644 Article/PythonBasis/python5/Preface.md delete mode 100644 Article/PythonBasis/python6/1.md delete mode 100644 Article/PythonBasis/python6/2.md delete mode 100644 Article/PythonBasis/python6/3.md delete mode 100644 Article/PythonBasis/python6/4.md delete mode 100644 Article/PythonBasis/python6/5.md delete mode 100644 Article/PythonBasis/python6/Preface.md delete mode 100644 Article/PythonBasis/python7/1.md delete mode 100644 Article/PythonBasis/python7/2.md delete mode 100644 Article/PythonBasis/python7/3.md delete mode 100644 Article/PythonBasis/python7/4.md delete mode 100644 Article/PythonBasis/python7/5.md delete mode 100644 Article/PythonBasis/python7/Preface.md delete mode 100644 Article/PythonBasis/python8/1.md delete mode 100644 Article/PythonBasis/python8/2.md delete mode 100644 Article/PythonBasis/python8/3.md delete mode 100644 Article/PythonBasis/python8/4.md delete mode 100644 Article/PythonBasis/python8/5.md delete mode 100644 Article/PythonBasis/python8/6.md delete mode 100644 Article/PythonBasis/python8/7.md delete mode 100644 Article/PythonBasis/python8/8.md delete mode 100644 Article/PythonBasis/python8/9.md delete mode 100644 Article/PythonBasis/python8/Preface.md delete mode 100644 Article/PythonBasis/python9/1.md delete mode 100644 Article/PythonBasis/python9/2.md delete mode 100644 Article/PythonBasis/python9/3.md delete mode 100644 Article/PythonBasis/python9/4.md delete mode 100644 Article/PythonBasis/python9/5.md delete mode 100644 Article/PythonBasis/python9/Preface.md delete mode 100644 "Article/advanced/Mac\344\270\255\344\275\277\347\224\250virtualenv\345\222\214virtualenvwrapper.md" delete mode 100644 "Article/advanced/Python\345\256\236\347\216\260\346\224\266\345\217\221\351\202\256\344\273\266.md" delete mode 100644 Article/advanced/advanced.md delete mode 100644 "Article/advanced/\344\275\277\347\224\250Python\350\231\232\346\213\237\347\216\257\345\242\203.md" delete mode 100644 Article/codeSpecification/codeSpecification_Preface.md delete mode 100644 Article/codeSpecification/codeSpecification_first.md delete mode 100644 Article/codeSpecification/codeSpecification_second.md delete mode 100644 Article/codeSpecification/codeSpecification_third.md delete mode 100644 Article/django/Django.md delete mode 100644 "Article/django/\344\270\200\344\270\252\345\256\214\346\225\264\347\232\204\345\210\235\345\255\246\350\200\205\346\214\207\345\215\227Django-part1.md" delete mode 100644 "Article/django/\344\270\200\344\270\252\345\256\214\346\225\264\347\232\204\345\210\235\345\255\246\350\200\205\346\214\207\345\215\227Django-part2.md" delete mode 100644 "Article/supplement/Python\345\205\263\351\224\256\345\255\227yield.md" delete mode 100644 README.md delete mode 100644 Res/FQ.md delete mode 100644 "Res/Python\345\215\232\345\256\242\347\275\221\347\253\231\350\265\204\346\272\220.md" delete mode 100644 "Res/\350\207\252\345\267\261\346\220\255\345\273\272ss:ssr\346\234\215\345\212\241\345\231\250.md" delete mode 100644 SUMMARY.md delete mode 100644 TwoWater-Python.json delete mode 100644 book.json create mode 100644 feature.txt diff --git a/.gitignore b/.gitignore deleted file mode 100644 index 1a366fb0..00000000 --- a/.gitignore +++ /dev/null @@ -1,16 +0,0 @@ -# Node rules: -## Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files) -.grunt - -## Dependency directory -## Commenting this out is preferred by some people, see -## https://docs.npmjs.com/misc/faq#should-i-check-my-node_modules-folder-into-git -node_modules - -# Book build output -_book - -# eBook build output -*.epub -*.mobi -*.pdf \ No newline at end of file diff --git "a/Article/Linux/Linux\345\221\275\344\273\244-\346\226\207\344\273\266\347\256\241\347\220\206\346\250\241\345\235\227.md" "b/Article/Linux/Linux\345\221\275\344\273\244-\346\226\207\344\273\266\347\256\241\347\220\206\346\250\241\345\235\227.md" deleted file mode 100644 index 1533c35f..00000000 --- "a/Article/Linux/Linux\345\221\275\344\273\244-\346\226\207\344\273\266\347\256\241\347\220\206\346\250\241\345\235\227.md" +++ /dev/null @@ -1,429 +0,0 @@ - -## 文件管理 - -#### 1.查看文件信息：`ls` - - -**简介：** - -`ls` 是英文单词 list 的简写，其功能为列出目录的内容，是用户最常用的命令之一。 - -Linux 文件或者目录名称最长可以有 265 个字符，“.” 代表当前目录，“..” 代表上一级目录，以 “.” 开头的文件为隐藏文件，需要用 -a 参数才能显示。 - - -**ls常用参数：** - -| 参数 | 含义 | -| --- | --- | -| -a | 显示指定目录下所有子目录与文件，包括隐藏文件 | -| -l | 以列表方式显示文件的详细信息 | -| -h | 配合 -l 以人性化的方式显示文件大小 | - - -**ls 匹配通配符：** - -与 DOS 下的文件操作类似，在 Unix/Linux 系统中，也同样允许使用特殊字符来同时引用多个文件名，这些特殊字符被称为通配符。 - -| 通配符 | 含义 | -| ------- | ----- | -| * | 文件代表文件名中所有字符 | -| ls te* | 查找以 `te` 开头的文件 | -| ls *html | 查找结尾为 `html` 的文件 | -| ？ | 代表文件名中任意一个字符 | -| ls ?.c | 只找第一个字符任意，后缀为 `.c` 的文件 | -| ls a.? | 只找只有 3 个字符，前 2 字符为 `a.` ，最后一个字符任意的文件 | -| [] | `"[”` 和 `“]”` 将字符组括起来，表示可以匹配字符组中的任意一个。`“-”` 用于表示字符范围。 | -| [abc] | 匹配 a、b、c 中的任意一个 | -| [a-f] | 匹配从 a 到 f 范围内的的任意一个字符 | -| ls [a-f]* | 找到从 a 到 f 范围内的的任意一个字符开头的文件 | -| ls a-f | 查找文件名为 a-f 的文件,当 `“-”` 处于方括号之外失去通配符的作用 | -| \ | 如果要使通配符作为普通字符使用，可以在其前面加上转义字符。`“?”` 和 `“*”` 处于方括号内时不用使用转义字符就失去通配符的作用。 | -| ls \*a | 查找文件名为 `*a` 的文件 | - - -![](http://p1ceh5usj.bkt.clouddn.com/linux/%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E6%A8%A1%E5%9D%97/ls.jpeg) - - -#### 2. 输出重定向命令：`>` - -**简介：** - -Linux 允许将命令执行结果重定向到一个文件，本应显示在终端上的内容保存到指定文件中。 - -如：ls > test.txt ( test.txt 如果不存在，则创建，存在则覆盖其内容 ) - -注意： `> 输出重定向会覆盖原来的内容， >> 输出重定向则会追加到文件的尾部。` - - -![](http://p1ceh5usj.bkt.clouddn.com/linux/%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E6%A8%A1%E5%9D%97/%E9%87%8D%E5%AE%9A%E5%90%91.jpeg) - - - -#### 3. 分屏显示：`more` - -**简介：** - -查看内容时，在信息过长无法在一屏上显示时，会出现快速滚屏，使得用户无法看清文件的内容，此时可以使用 `more` 命令，每次只显示一页，按下空格键可以显示下一页，按下 `q` 键退出显示，按下 `h` 键可以获取帮助。 - - - - - -#### 4. 管道：`|` - -**简介：** - -管道：一个命令的输出可以通过管道做为另一个命令的输入。 - -管道我们可以理解现实生活中的管子，管子的一头塞东西进去，另一头取出来，这里 `|` 的左右分为两端，左端塞东西(写)，右端取东西(读)。 - - -![](http://p1ceh5usj.bkt.clouddn.com/linux/%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E6%A8%A1%E5%9D%97/%E7%AE%A1%E9%81%93.png) - - -#### 5. 清屏：`clear` - -`clear` 作用为清除终端上的显示(类似于 DOS 的 cls 清屏功能)，也可使用快捷键：Ctrl + l ( “l” 为字母 “L” 的小写 )。 - - - - -#### 6. 切换工作目录：`cd` - - -**简介：** - -在使用 Unix/Linux 的时候，经常需要更换工作目录。`cd` 命令可以帮助用户切换工作目录。`Linux 所有的目录和文件名大小写敏感` - -`cd` 后面可跟绝对路径，也可以跟相对路径。如果省略目录，则默认切换到当前用户的主目录。 - - -**cd 常用命令：** - -| 命令 | 含义 | -| --- | --- | -| `cd` | 切换到当前用户的主目录(/home/用户目录)，用户登陆的时候，默认的目录就是用户的主目录。 | -| `cd ~` | 切换到当前用户的主目录(/home/用户目录) | -| `cd .` | 切换到当前目录 | -| `cd ..` | 切换到上级目录 | -| `cd -` | 可进入上次所在的目录 | - - -注意： - -* 如果路径是从根路径开始的，则路径的前面需要加上 “ / ”，如 “ /mnt ”，通常进入某个目录里的文件夹，前面不用加 “ / ”。 - - -![](http://p1ceh5usj.bkt.clouddn.com/linux/%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E6%A8%A1%E5%9D%97/cd.png) - - - - -#### 7. 显示当前路径：`pwd` - -**简介：** - -使用 `pwd` 命令可以显示当前的工作目录，该命令很简单，直接输入 `pwd` 即可，后面不带参数。 - - - - - - - - -#### 8. 创建目录：`mkdir` - -**简介：** - -通过 `mkdir` 命令可以创建一个新的目录。参数 -p 可递归创建目录。 - -需要注意的是新建目录的名称不能与当前目录中已有的目录或文件同名，并且目录创建者必须对当前目录具有写权限。 - -![](http://p1ceh5usj.bkt.clouddn.com/linux/%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E6%A8%A1%E5%9D%97/mkdir.png) - - -#### 9. 删除目录：`rmdir` - -**简介：** - -可使用 `rmdir` 命令删除一个目录。必须离开目录，并且目录必须为空目录，不然提示删除失败。 - -![](http://p1ceh5usj.bkt.clouddn.com/linux/%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E6%A8%A1%E5%9D%97/rmdir.png) - - -#### 10. 删除文件：`rm` - -**简介：** - -可通过 `rm` 删除文件或目录。使用 `rm` 命令要小心，因为文件删除后不能恢复。为了防止文件误删，可以在 `rm` 后使用 `-i` 参数以逐个确认要删除的文件。 - - -**`rm` 常用参数：** - -| 参数 | 含义 | -| --- | --- | -| -i | 以进行交互式方式执行 | -| -f | 强制删除，忽略不存在的文件，无需提示 | -| -r | 递归地删除目录下的内容，删除文件夹时必须加此参数 | - -![](http://p1ceh5usj.bkt.clouddn.com/linux/%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E6%A8%A1%E5%9D%97/rm.png) - - - -#### 11. 建立链接文件：`ln` - - -**简介：** - - -Linux 链接文件类似于 Windows 下的快捷方式。 - -链接文件分为软链接和硬链接。 - -软链接：软链接不占用磁盘空间，源文件删除则软链接失效。 - -硬链接：硬链接只能链接普通文件，不能链接目录。 - -使用格式： - -``` -ln 源文件 链接文件 -ln -s 源文件 链接文件 -``` - - -如果`没有-s`选项代表建立一个硬链接文件，两个文件占用相同大小的硬盘空间，即使删除了源文件，链接文件还是存在，所以-s选项是更常见的形式。 - -注意：如果软链接文件和源文件不在同一个目录，源文件要使用绝对路径，不能使用相对路径。 - - -![](http://p1ceh5usj.bkt.clouddn.com/linux/%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E6%A8%A1%E5%9D%97/ln.png) - - - - - -#### 12. 查看或者合并文件内容：`cat` - - -**简介：** - -查看文件内容 - - - - -#### 13. 文本搜索：`grep` - - -**简介：** - -Linux 系统中 grep 命令是一种强大的文本搜索工具，grep 允许对文本文件进行模式查找。如果找到匹配模式， grep 打印包含模式的所有行。 - -grep一般格式为： - -``` -grep [-选项] ‘搜索内容串’文件名 -``` - - -在 grep 命令中输入字符串参数时，最好引号或双引号括起来。例如：grep‘a ’1.txt。 - - -**`grep` 常用参数：** - -| 选项 | 含义 | -| --- | --- | -| -v | 显示不包含匹配文本的所有行（相当于求反） | -| -n | 显示匹配行及行号 | -| -i | 忽略大小写 | - -grep 搜索内容串可以是正则表达式。 - - -**grep 常用正则表达式：** - -| 参数 | 含义 | -| --- | --- | -| ^a | 行首,搜寻以 m 开头的行；grep -n '^a' 1.txt | -| ke$ | 行尾,搜寻以 ke 结束的行；grep -n 'ke$' 1.txt | -| [Ss]igna[Ll] | 匹配 [] 里中一系列字符中的一个；搜寻匹配单词signal、signaL、Signal、SignaL的行；grep -n '[Ss]igna[Ll]' 1.txt | -| . | (点)匹配一个非换行符的字符；匹配 e 和 e 之间有任意一个字符，可以匹配 eee，eae，eve，但是不匹配 ee，eaae；grep -n 'e.e' 1.txt | - - -![](http://p1ceh5usj.bkt.clouddn.com/linux/%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E6%A8%A1%E5%9D%97/grep.png) - - - -#### 14. 查找文件：`find` - -**简介：** - -find 命令功能非常强大，通常用来在特定的目录下搜索符合条件的文件，也可以用来搜索特定用户属主的文件。 - -**常用用法：** - -| 命令 | 含义 | -| --- | --- | -| find ./ -name test.sh | 查找当前目录下所有名为test.sh的文件 | -| find ./ -name '*.sh' | 查找当前目录下所有后缀为.sh的文件 | -| find ./ -name "[A-Z]*" | 查找当前目录下所有以大写字母开头的文件 | -| find /tmp -size 2M | 查找在/tmp 目录下等于2M的文件 | -| find /tmp -size +2M | 查找在/tmp 目录下大于2M的文件 | -| find /tmp -size -2M | 查找在/tmp 目录下小于2M的文件 | -| find ./ -size +4k -size -5M | 查找当前目录下大于4k，小于5M的文件 | -| find ./ -perm 0777 | 查找当前目录下权限为 777 的文件或目录 | - - - - - -#### 1.15 拷贝文件：`cp` - -**简介：** - -`cp` 命令的功能是将给出的文件或目录复制到另一个文件或目录中，相当于 DOS 下的 copy 命令。 - -**常用参数说明：** - -| 选项 | 含义 | -| --- | --- | -| -a | 该选项通常在复制目录时使用，它保留链接、文件属性，并递归地复制目录，简单而言，保持文件原有属性。 | -| -f | 已经存在的目标文件而不提示 | -| -i | 交互式复制，在覆盖目标文件之前将给出提示要求用户确认 | -| -r | 若给出的源文件是目录文件，则cp将递归复制该目录下的所有子目录和文件，目标文件必须为一个目录名。 | -| -v | 显示拷贝进度 | - -![](http://p1ceh5usj.bkt.clouddn.com/linux/%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E6%A8%A1%E5%9D%97/find.png) - - -#### 16. 移动文件：`mv` - -**简介：** - -用户可以使用 `mv` 命令来移动文件或目录，也可以给文件或目录重命名。 - -**常用参数说明：** - -| 选项 | 含义 | -| --- | --- | -| -f | 禁止交互式操作，如有覆盖也不会给出提示 | -| -i | 确认交互方式操作，如果mv操作将导致对已存在的目标文件的覆盖，系统会询问是否重写，要求用户回答以避免误覆盖文件 | -| -v | 显示移动进度 | - -![](http://p1ceh5usj.bkt.clouddn.com/linux/%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E6%A8%A1%E5%9D%97/mv.png) - - -#### 17. 归档管理：`tar` - - -**简介：** - -计算机中的数据经常需要备份，tar 是 Unix/Linux 中最常用的备份工具，此命令可以把一系列文件归档到一个大文件中，也可以把档案文件解开以恢复数据。其实说白了，就是打包。 - - - -**`tar` 使用格式：** - -``` -tar [参数] 打包文件名 文件 -``` - - -**`tar` 常用参数：** - -tar 命令很特殊，其参数前面可以使用“-”，也可以不使用。 - -| 参数 | 含义 | -| --- | --- | -| -c | 生成档案文件，创建打包文件 | -| -v | 列出归档解档的详细过程，显示进度 | -| -f | 指定档案文件名称，f后面一定是.tar文件，所以必须放选项最后 | -| -t | 列出档案中包含的文件 | -| -x | 解开档案文件 | - -注意：除了f需要放在参数的最后，其它参数的顺序任意。 - - - - - - -#### 18. 文件压缩解压：`gzip` - -**简介：** - -tar 与 gzip 命令结合使用实现文件打包、压缩。 tar 只负责打包文件，但不压缩，用 gzip 压缩 tar 打包后的文件，其扩展名一般用xxxx.tar.gz。 - -**`gzip` 使用格式如下：** - -``` -gzip [选项] 被压缩文件 -``` - -**常用选项：** - -| 选项 | 含义 | -| --- | --- | -| -d | 解压 | -| -r | 压缩所有子目录 | - - -tar这个命令并没有压缩的功能，它只是一个打包的命令，但是在tar命令中增加一个选项(-z)可以调用gzip实现了一个压缩的功能，实行一个先打包后压缩的过程。 - -压缩用法：tar cvzf 压缩包包名 文件1 文件2 ... - -```-z ：指定压缩包的格式为：file.tar.gz``` - - -解压用法： tar zxvf 压缩包包名 - -```-z:指定压缩包的格式为：file.tar.gz``` - - -解压到指定目录：-C （大写字母“C”） - - - - -#### 19. 文件压缩解压：`bzip2` - -**简介：** - -tar与bzip2命令结合使用实现文件打包、压缩(用法和gzip一样)。 - -tar只负责打包文件，但不压缩，用bzip2压缩tar打包后的文件，其扩展名一般用xxxx.tar.gz2。 - -在tar命令中增加一个选项(-j)可以调用bzip2实现了一个压缩的功能，实行一个先打包后压缩的过程。 - -压缩用法：tar -jcvf 压缩包包名 文件...(tar jcvf bk.tar.bz2 *.c) - -解压用法：tar -jxvf 压缩包包名 (tar jxvf bk.tar.bz2) - - - - -#### 20. 文件压缩解压：`zip` 、`unzip` - -通过zip压缩文件的目标文件不需要指定扩展名，默认扩展名为zip。 - -压缩文件：zip [-r] 目标文件(没有扩展名) 源文件 - -解压文件：unzip -d 解压后目录文件 压缩文件 - - - - - -#### 21. 查看命令位置：`which` - -**简介：** - -查看命令的路径 - -![](http://p1ceh5usj.bkt.clouddn.com/linux/%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E6%A8%A1%E5%9D%97/which.png) - - - - diff --git "a/Article/Linux/Linux\345\221\275\344\273\244-\347\224\250\346\210\267,\346\235\203\351\231\220\347\256\241\347\220\206\346\250\241\345\235\227.md" "b/Article/Linux/Linux\345\221\275\344\273\244-\347\224\250\346\210\267,\346\235\203\351\231\220\347\256\241\347\220\206\346\250\241\345\235\227.md" deleted file mode 100644 index fe569e7b..00000000 --- "a/Article/Linux/Linux\345\221\275\344\273\244-\347\224\250\346\210\267,\346\235\203\351\231\220\347\256\241\347\220\206\346\250\241\345\235\227.md" +++ /dev/null @@ -1,38 +0,0 @@ -## 用户，权限管理 - -用户是 Unix/Linux 系统工作中重要的一环，用户管理包括用户与组账号的管理。 - -在 Unix/Linux 系统中，不论是由本机或是远程登录系统，每个系统都必须拥有一个账号，并且对于不同的系统资源拥有不同的使用权限。 - -Unix/Linux 系统中的 root 账号通常用于系统的维护和管理，它对 Unix/Linux 操作系统的所有部分具有不受限制的访问权限。 - -在 Unix/Linux 安装的过程中，系统会自动创建许多用户账号，而这些默认的用户就称为“标准用户”。 - -在大多数版本的 Unix/Linux 中，都不推荐直接使用 root 账号登录系统。 - -#### 1.多用户系统 - -> 什么是多用户呢？ - -「多用户」指允许多个用户（逻辑上的账户），同时使用的操作系统或应用软件。 - -而 Linux 就是多用户操作系统，允许多个用户通过远程登录的方式访问一台机器并同时进行使用，相互之间互不影响。 - -> 那我们经常使用的 Windows 是不是多用户操作系统呢？ - -Windows 系列的话，Windows 1.x、2.x、3.x（不含NT 3.x）、9x、Me 均为单用户操作系统，其中 9x 虽然有多用户的雏形但基本形同虚设，Windows Me 是最后一个非 NT 内核的 Windows 系统，同样不具备实用性的多用户设计。 - -有人会问， Windows 不是可以创建多个账号吗？为什么不是多用户操作系统呢？ - -其实 Windows 的多用户不是真正的多用户，就好比你在家里远程登录了你公司的电脑，你公司的电脑会立刻进入到锁屏状态，而且被人是不可以操作的。这就说明不能多账号同时操作一台电脑了。 - - - - - - - - - - - diff --git a/Article/PythonBasis/python0/WhyStudyPython.md b/Article/PythonBasis/python0/WhyStudyPython.md deleted file mode 100644 index 511cbab4..00000000 --- a/Article/PythonBasis/python0/WhyStudyPython.md +++ /dev/null @@ -1,43 +0,0 @@ -### Python 越来越火爆 - -Python 在诞生之初，因为其功能不好，运转功率低，不支持多核，根本没有并发性可言，在计算功能不那么好的年代，一直没有火爆起来，甚至很多人根本不知道有这门语言。 - -随着时代的发展，物理硬件功能不断提高，而软件的复杂性也不断增大，开发效率越来越被企业重视。因此就有了不一样的声音，在软件开发的初始阶段，性能并没有开发效率重要，没必然为了节省不到 1ms 的时间却让开发量增加好几倍，这样划不过来。也就是开发效率比机器效率更为重要，那么 Python 就逐渐得到越来越多开发者的亲睐了。 - -在 12-14 年，云计算升温，大量创业公司和互联网巨头挤进云计算领域，而最著名的云核算开源渠道 OpenStack 就是基于 Python 开发的。 - -随后几年的备受关注的人工智能，机器学习首选开发语言也是 Python。 - -至此，Python 已经成为互联网开发的焦点。在「Top 10 的编程语言走势图」可以看到，Python 已经跃居第三位，而且在 2017 年还成为了最受欢迎的语言。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-07-06-084240.png) - -### Python 开发薪资高 - -Python 开发人员是收入最高的开发人员之一，特别是在数据科学，机器学习和 Web 开发方面。 - -在北上广深一线城市上，Python 开发的薪资都达到了 2w+ 。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-07-06-090549.jpg) - -### Python 容易入门且功能强大 - -如果你是一名初学者，学习 Python 就是你最好的选择，因为它容易学，功能强大，很容易就能构建 Web 应用，非常适合初学者作为入门的开发语言。 - -Python 还一度被爆纳入高考，收编到小学课本。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-07-06-091204.png) - -如果你有一定的编程语言基础，学习 Python 也是不错的选择，因为 Python 很可能就是未来开发的主流方向，多学一门语言，多一个防身技能。而且 Python 有强大的功能库，能非常快速的开发工具，为你的本职开发工作提供护航。 - - - - - - - - - - - - diff --git a/Article/PythonBasis/python1/IDE.md b/Article/PythonBasis/python1/IDE.md deleted file mode 100644 index 724b7cf0..00000000 --- a/Article/PythonBasis/python1/IDE.md +++ /dev/null @@ -1,9 +0,0 @@ -# 四、集成开发环境（IDE）: PyCharm # - -我本人一直是建议在学习周期使用文本编辑器或者是[Sublime Text](http://www.sublimetext.com/) 这个工具来写 Python 程序的，因为这样有利于我们了解整个流程。 - -当然，如果你有一定的编程基础，是可以使用集成的开发环境的，这样可以提高效率。这时，你可以选择 PyCharm ，PyCharm 是由 JetBrains 打造的一款 Python IDE，支持 macOS、 Windows、 Linux 系统。 - -PyCharm 下载地址 : [https://www.jetbrains.com/pycharm/download/](https://www.jetbrains.com/pycharm/download/) - - diff --git a/Article/PythonBasis/python1/Installation.md b/Article/PythonBasis/python1/Installation.md deleted file mode 100644 index 9c26e821..00000000 --- a/Article/PythonBasis/python1/Installation.md +++ /dev/null @@ -1,68 +0,0 @@ -# 二、Python 的安装 # - -因为 Python 是跨平台的，它可以运行在 Windows、Mac 和各种 Linux/Unix 系统上。目前，Python 有两个版本，一个是 2.x 版，一个是 3.x版，这两个版本是不兼容的。本草根安装的是 3.6.1 版本的。 - -至于在哪里下载，草根我建议大家最好直接官网下载，随时下载下来的都是最新版本。官网地址：[https://www.python.org/](https://www.python.org/) - -## 1、windows 系统下安装配置 ## - -如果是 windows 系统，下载完后，直接安装，不过这里记得勾上Add Python 3.6 to PATH，然后点 「Install Now」 即可完成安装。 - -这里要注意了，记得把「Add Python 3.6 to Path」勾上，勾上之后就不需要自己配置环境变量了，如果没勾上，就要自己手动配置。 - -![Python安装.png](http://upload-images.jianshu.io/upload_images/2136918-2bf6591f0a12e80b.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) - -如果你一时手快，忘记了勾上 「Add Python 3.6 to Path」，那也不要紧，只需要手动配置一下环境变量就好了。 - -在命令提示框中 cmd 上输入 ： - -``` -path=%path%;C:\Python -``` - -特别特别注意： `C:\Python` 是 Python 的安装目录，如果你的安装目录是其他地方，就得填上你对应的目录。 - -安装完成后，打开命令提示符窗口，敲入 python 后，出现下面的情况，证明 Python 安装成功了。 - -![运行python.png](http://upload-images.jianshu.io/upload_images/2136918-817c22f802e8cfce.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) - -而你看到提示符 `>>>` 就表示我们已经在 Python 交互式环境中了，可以输入任何 Python 代码，回车后会立刻得到执行结果。 - - -## 2、Mac 系统下安装配置 ## - -MAC 系统一般都自带有 Python2.x 版本的环境，不过现在都不用 2.x 的版本了，所以建议你在 https://www.python.org/downloads/mac-osx/ 上下载最新版安装。 - -安装完成之后，如何配置环境变量呢？ - -先查看当前环境变量： - -``` -echo $PATH -``` - -然后打开 ``` ~/.bash_profile(没有请新建) ``` - -``` -vi ~/.bash_profile -``` - -我装的是 Python3.7 ，Python 执行路径为：`/Library/Frameworks/Python. Framework/Versions/3.7/bin` 。于是写入 - -``` -export PATH="/Library/Frameworks/Python. Framework/Versions/3.7/bin:$PATH" -``` - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-07-22-084149.png) - -最后保存退出，激活运行一下文件： - -``` -source ~/.bash_profile -``` - - - - - - diff --git a/Article/PythonBasis/python1/Introduction.md b/Article/PythonBasis/python1/Introduction.md deleted file mode 100644 index 3093e3b0..00000000 --- a/Article/PythonBasis/python1/Introduction.md +++ /dev/null @@ -1,25 +0,0 @@ -# 一、Python 简介 # - -Python 是著名的“龟叔” Guido van Rossum 在 1989 年圣诞节期间，为了打发无聊的圣诞节而编写的一个编程语言。牛人就是牛人，为了打发无聊时间竟然写了一个这么牛皮的编程语言。 - -现在，全世界差不多有 600 多种编程语言，但流行的编程语言也就那么 20 来种。不知道你有没有听说过 TIOBE 排行榜。 - -这是 2017 年 2 月编程语言排行榜 TOP20 榜单： - -![2 月编程语言排行榜 TOP20 榜单.png](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-07-22-080118.jpg) - -还有就是 Top 10 编程语言 TIOBE 指数走势： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-07-22-080145.jpg) - -总的来说，这几种编程语言各有千秋，但不难看出，最近几年 Python 的发展非常的快，特别最近流行的机器学习，数据分析，更让 python 快速的发展起来。 - -Python 是高级编程语言，它有一个特点就是能快速的开发。Python 为我们提供了非常完善的基础代码库，覆盖了网络、文件、GUI、数据库、文本等大量内容，被形象地称作“内置电池（batteries included）”。用 Python 开发，许多功能不必从零编写，直接使用现成的即可。而且 Python 还能开发网站，多大型网站就是用 Python 开发的，例如 YouTube、Instagram，还有国内的豆瓣。很多大公司，包括 Google、Yahoo 等，甚至 NASA（美国航空航天局）都大量地使用 Python。 - -当然，任何编程语言有有点，也有缺点，Python 也不例外。那么 Python 有哪些缺点呢？ - -第一个缺点就是运行速度慢，和C程序相比非常慢，因为Python是解释型语言，你的代码在执行时会一行一行地翻译成CPU能理解的机器码，这个翻译过程非常耗时，所以很慢。而C程序是运行前直接编译成CPU能执行的机器码，所以非常快。 - -第二个缺点就是代码不能加密。如果要发布你的 Python 程序，实际上就是发布源代码。像 JAVA , C 这些编译型的语言，都没有这个问题，而解释型的语言，则必须把源码发布出去。 - - diff --git a/Article/PythonBasis/python1/Preface.md b/Article/PythonBasis/python1/Preface.md deleted file mode 100644 index de40b80a..00000000 --- a/Article/PythonBasis/python1/Preface.md +++ /dev/null @@ -1,8 +0,0 @@ -# 前言 # - -每个编程语言的学习，第一个程序都是先向世界问好，Python 也不例外，这节我们先写下第一个 Python 程序 —— Hello World 。 - -# 目录 # - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-16-%E7%AC%AC%E4%B8%80%E4%B8%AA%20Python%20%E7%A8%8B%E5%BA%8F.png) - diff --git a/Article/PythonBasis/python1/The_first_procedure.md b/Article/PythonBasis/python1/The_first_procedure.md deleted file mode 100644 index 2561c52b..00000000 --- a/Article/PythonBasis/python1/The_first_procedure.md +++ /dev/null @@ -1,28 +0,0 @@ -# 三、第一个 Python 程序 # - -好了，说了那么多，现在我们可以来写一下第一个 Python 程序了。 - -一开始写 Python 程序，个人不太建议用专门的工具来写，不方便熟悉语法，所以这里我先用 [Sublime Text](http://www.sublimetext.com/) 来写，后期可以改为用 PyCharm 。 - -第一个 Python 程序当然是打印 Hello Python 啦。 - -如果你没编程经验，什么都不懂，没关系，第一个 Python 程序，只要跟着做，留下个印象，尝试一下就好。 - -新建一个文件，命名为 `HelloPython.py` , 注意，这里是以 `.py` 为后缀的文件。 - -然后打开文件，输入 `print('Hello Python')` - - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-17-075948.jpg) - - -最后就可以打开命令行窗口，把当前目录切换到 HelloPython.py 所在目录，就可以运行这个程序了，下面就是运行的结果。 - - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-17-075956.jpg) - - -当然，如果你是使用 [Sublime Text](http://www.sublimetext.com/) ，并且在安装 Python 的时候配置好了环境变量，直接按 Ctrl + B 就可以运行了，运行结果如下： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-17-080018.jpg) - diff --git a/Article/PythonBasis/python10/1.md b/Article/PythonBasis/python10/1.md deleted file mode 100644 index 42a13271..00000000 --- a/Article/PythonBasis/python10/1.md +++ /dev/null @@ -1,33 +0,0 @@ -# 一、Python 的 Magic Method # - -在 Python 中，所有以 "__" 双下划线包起来的方法，都统称为"魔术方法"。比如我们接触最多的 `__init__` 。 - -魔术方法有什么作用呢？ - -使用这些魔术方法，我们可以构造出优美的代码，将复杂的逻辑封装成简单的方法。 - -那么一个类中有哪些魔术方法呢？ - -我们可以使用 Python 内置的方法 `dir()` 来列出类中所有的魔术方法.示例如下： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -class User(object): - pass - - -if __name__ == '__main__': - print(dir(User())) -``` - -输出的结果： - -``` -['__class__', '__delattr__', '__dict__', '__dir__', '__doc__', '__eq__', '__format__', '__ge__', '__getattribute__', '__gt__', '__hash__', '__init__', '__init_subclass__', '__le__', '__lt__', '__module__', '__ne__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__', '__weakref__'] -``` - -可以看到，一个类的魔术方法还是挺多的，不过我们只需要了解一些常见和常用的魔术方法就好了。 - - diff --git a/Article/PythonBasis/python10/2.md b/Article/PythonBasis/python10/2.md deleted file mode 100644 index db00b527..00000000 --- a/Article/PythonBasis/python10/2.md +++ /dev/null @@ -1,65 +0,0 @@ -# 二、构造(`__new__`)和初始化(`__init__`) # - -通过之前的学习，我们已经知道定义一个类时，我们经常会通过 `__init__(self)` 的方法在实例化对象的时候，对属性进行设置。 - -比如下面的例子： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -class User(object): - def __init__(self, name, age): - self.name = name; - self.age = age; - -user=User('两点水',23) -``` - -实际上，创建一个类的过程是分为两步的，一步是创建类的对象，还有一步就是对类进行初始化。 - -`__new__` 是用来创建类并返回这个类的实例, 而`__init__` 只是将传入的参数来初始化该实例.`__new__` 在创建一个实例的过程中必定会被调用,但 `__init__` 就不一定，比如通过 pickle.load 的方式反序列化一个实例时就不会调用 `__init__` 方法。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-Python%E7%B1%BB%E5%88%9B%E5%BB%BA%E7%9A%84%E8%BF%87%E7%A8%8B.png) - -`def __new__(cls)` 是在 `def __init__(self)` 方法之前调用的，作用是返回一个实例对象。还有一点需要注意的是：`__new__` 方法总是需要返回该类的一个实例，而 `__init__` 不能返回除了 `None` 的任何值 - -具体的示例： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -class User(object): - def __new__(cls, *args, **kwargs): - # 打印 __new__方法中的相关信息 - print('调用了 def __new__ 方法') - print(args) - # 最后返回父类的方法 - return super(User, cls).__new__(cls) - - def __init__(self, name, age): - print('调用了 def __init__ 方法') - self.name = name - self.age = age - - -if __name__ == '__main__': - usr = User('两点水', 23) -``` - -看看输出的结果： - -```txt -调用了 def __new__ 方法 -('两点水', 23) -调用了 def __init__ 方法 -``` - -通过打印的结果来看，我们就可以知道一个类创建的过程是怎样的了，先是调用了 `__new__` 方法来创建一个对象，把参数传给 `__init__` 方法进行实例化。 - -其实在实际开发中，很少会用到 `__new__` 方法，除非你希望能够控制类的创建。通常讲到 `__new__` ，都是牵扯到 `metaclass`(元类)的。 - -当然当一个对象的生命周期结束的时候，析构函数 `__del__` 方法会被调用。但是这个方法是 Python 自己对对象进行垃圾回收的。 - - diff --git a/Article/PythonBasis/python10/3.md b/Article/PythonBasis/python10/3.md deleted file mode 100644 index 4d5a972d..00000000 --- a/Article/PythonBasis/python10/3.md +++ /dev/null @@ -1,74 +0,0 @@ -# 三、属性的访问控制 # - -之前也有讲到过，Python 没有真正意义上的私有属性。然后这就导致了对 Python 类的封装性比较差。我们有时候会希望 Python 能够定义私有属性，然后提供公共可访问的 get 方法和 set 方法。Python 其实可以通过魔术方法来实现封装。 - -|方法|说明| -| ---| --- | -|`__getattr__(self, name)`|该方法定义了你试图访问一个不存在的属性时的行为。因此，重载该方法可以实现捕获错误拼写然后进行重定向, 或者对一些废弃的属性进行警告。| -|`__setattr__(self, name, value)`|定义了对属性进行赋值和修改操作时的行为。不管对象的某个属性是否存在,都允许为该属性进行赋值.有一点需要注意，实现 `__setattr__` 时要避免"无限递归"的错误，| -|`__delattr__(self, name)`|`__delattr__` 与 `__setattr__` 很像，只是它定义的是你删除属性时的行为。实现 `__delattr__` 是同时要避免"无限递归"的错误| -|`__getattribute__(self, name)`|`__getattribute__` 定义了你的属性被访问时的行为，相比较，`__getattr__` 只有该属性不存在时才会起作用。因此，在支持 `__getattribute__ `的 Python 版本,调用`__getattr__` 前必定会调用 `__getattribute__``__getattribute__` 同样要避免"无限递归"的错误。| - -通过上面的方法表可以知道，在进行属性访问控制定义的时候你可能会很容易的引起一个错误，可以看看下面的示例： - -```python -def __setattr__(self, name, value): - self.name = value - # 每当属性被赋值的时候， ``__setattr__()`` 会被调用，这样就造成了递归调用。 - # 这意味这会调用 ``self.__setattr__('name', value)`` ，每次方法会调用自己。这样会造成程序崩溃。 - -def __setattr__(self, name, value): - # 给类中的属性名分配值 - self.__dict__[name] = value - # 定制特有属性 -``` - -上面方法的调用具体示例如下： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -class User(object): - def __getattr__(self, name): - print('调用了 __getattr__ 方法') - return super(User, self).__getattr__(name) - - def __setattr__(self, name, value): - print('调用了 __setattr__ 方法') - return super(User, self).__setattr__(name, value) - - def __delattr__(self, name): - print('调用了 __delattr__ 方法') - return super(User, self).__delattr__(name) - - def __getattribute__(self, name): - print('调用了 __getattribute__ 方法') - return super(User, self).__getattribute__(name) - - -if __name__ == '__main__': - user = User() - # 设置属性值，会调用 __setattr__ - user.attr1 = True - # 属性存在,只有__getattribute__调用 - user.attr1 - try: - # 属性不存在, 先调用__getattribute__, 后调用__getattr__ - user.attr2 - except AttributeError: - pass - # __delattr__调用 - del user.attr1 - -``` - -输出的结果： - -```txt -调用了 __setattr__ 方法 -调用了 __getattribute__ 方法 -调用了 __getattribute__ 方法 -调用了 __getattr__ 方法 -调用了 __delattr__ 方法 -``` diff --git a/Article/PythonBasis/python10/4.md b/Article/PythonBasis/python10/4.md deleted file mode 100644 index 49eb1b00..00000000 --- a/Article/PythonBasis/python10/4.md +++ /dev/null @@ -1,143 +0,0 @@ -# 四、对象的描述器 # - -一般来说，一个描述器是一个有“绑定行为”的对象属性 (object attribute)，它的访问控制被描述器协议方法重写。 - -这些方法是 `__get__()`, `__set__()` , 和 `__delete__()` 。 - -有这些方法的对象叫做描述器。 - -默认对属性的访问控制是从对象的字典里面 (`__dict__`) 中获取 (get) , 设置 (set) 和删除 (delete) 。 - -举例来说， `a.x` 的查找顺序是, `a.__dict__['x']` , 然后 `type(a).__dict__['x']` , 然后找 `type(a)` 的父类 ( 不包括元类 (metaclass) ).如果查找到的值是一个描述器, Python 就会调用描述器的方法来重写默认的控制行为。 - -这个重写发生在这个查找环节的哪里取决于定义了哪个描述器方法。 - -注意, 只有在新式类中时描述器才会起作用。在之前的篇节中已经提到新式类和旧式类的，有兴趣可以查看之前的篇节来看看，至于新式类最大的特点就是所有类都继承自 type 或者 object 的类。 - -在面向对象编程时，如果一个类的属性有相互依赖的关系时，使用描述器来编写代码可以很巧妙的组织逻辑。在 Django 的 ORM 中,models.Model 中的 InterField 等字段, 就是通过描述器来实现功能的。 - -我们先看下下面的例子： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -class User(object): - def __init__(self, name='两点水', sex='男'): - self.sex = sex - self.name = name - - def __get__(self, obj, objtype): - print('获取 name 值') - return self.name - - def __set__(self, obj, val): - print('设置 name 值') - self.name = val - - -class MyClass(object): - x = User('两点水', '男') - y = 5 - - -if __name__ == '__main__': - m = MyClass() - print(m.x) - - print('\n') - - m.x = '三点水' - print(m.x) - - print('\n') - - print(m.x) - - print('\n') - - print(m.y) - -``` - -输出的结果如下： - -```txt -获取 name 值 -两点水 - - -设置 name 值 -获取 name 值 -三点水 - - -获取 name 值 -三点水 - - -5 - -``` - -通过这个例子，可以很好的观察到这 `__get__()` 和 `__set__()` 这些方法的调用。 - -再看一个经典的例子 - -我们知道，距离既可以用单位"米"表示,也可以用单位"英尺"表示。 -现在我们定义一个类来表示距离,它有两个属性: 米和英尺。 - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - - -class Meter(object): - def __init__(self, value=0.0): - self.value = float(value) - - def __get__(self, instance, owner): - return self.value - - def __set__(self, instance, value): - self.value = float(value) - - -class Foot(object): - def __get__(self, instance, owner): - return instance.meter * 3.2808 - - def __set__(self, instance, value): - instance.meter = float(value) / 3.2808 - - -class Distance(object): - meter = Meter() - foot = Foot() - - -if __name__ == '__main__': - d = Distance() - print(d.meter, d.foot) - d.meter = 1 - print(d.meter, d.foot) - d.meter = 2 - print(d.meter, d.foot) - -``` - -输出的结果： - -```txt -0.0 0.0 -1.0 3.2808 -2.0 6.5616 -``` - -在上面例子中,在还没有对 Distance 的实例赋值前, 我们认为 meter 和 foot 应该是各自类的实例对象, 但是输出却是数值。这是因为 `__get__` 发挥了作用. - -我们只是修改了 meter ,并且将其赋值成为 int ，但 foot 也修改了。这是 `__set__` 发挥了作用. - -描述器对象 (Meter、Foot) 不能独立存在, 它需要被另一个所有者类 (Distance) 所持有。描述器对象可以访问到其拥有者实例的属性，比如例子中 Foot 的 `instance.meter` 。 - - diff --git a/Article/PythonBasis/python10/5.md b/Article/PythonBasis/python10/5.md deleted file mode 100644 index 90cf5251..00000000 --- a/Article/PythonBasis/python10/5.md +++ /dev/null @@ -1,86 +0,0 @@ -# 五、自定义容器（Container） # - -经过之前编章的介绍，我们知道在 Python 中，常见的容器类型有: dict, tuple, list, string。其中也提到过可容器和不可变容器的概念。其中 tuple, string 是不可变容器，dict, list 是可变容器。 - -可变容器和不可变容器的区别在于，不可变容器一旦赋值后，不可对其中的某个元素进行修改。当然具体的介绍，可以看回之前的文章，有图文介绍。 - -那么这里先提出一个问题，这些数据结构就够我们开发使用吗？ - -不够的时候，或者说有些特殊的需求不能单单只使用这些基本的容器解决的时候，该怎么办呢？ - -这个时候就需要自定义容器了，那么具体我们该怎么做呢？ - -|功能|说明| -|------|------| -|自定义不可变容器类型|需要定义 `__len__` 和 `__getitem__` 方法| -|自定义可变类型容器|在不可变容器类型的基础上增加定义 `__setitem__` 和 `__delitem__` | -|自定义的数据类型需要迭代|需定义 `__iter__` | -|返回自定义容器的长度|需实现 `__len__(self)` | -|自定义容器可以调用 `self[key]` ，如果 key 类型错误，抛出TypeError ，如果没法返回key对应的数值时,该方法应该抛出ValueError|需要实现 `__getitem__(self, key)`| -|当执行 `self[key] = value` 时|调用是 `__setitem__(self, key, value)`这个方法| -|当执行 `del self[key]` 方法 |其实调用的方法是 `__delitem__(self, key)`| -|当你想你的容器可以执行 `for x in container:` 或者使用 `iter(container)` 时|需要实现 `__iter__(self)` ，该方法返回的是一个迭代器| - -来看一下使用上面魔术方法实现 Haskell 语言中的一个数据结构： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -class FunctionalList: - ''' 实现了内置类型list的功能,并丰富了一些其他方法: head, tail, init, last, drop, take''' - - def __init__(self, values=None): - if values is None: - self.values = [] - else: - self.values = values - - def __len__(self): - return len(self.values) - - def __getitem__(self, key): - return self.values[key] - - def __setitem__(self, key, value): - self.values[key] = value - - def __delitem__(self, key): - del self.values[key] - - def __iter__(self): - return iter(self.values) - - def __reversed__(self): - return FunctionalList(reversed(self.values)) - - def append(self, value): - self.values.append(value) - - def head(self): - # 获取第一个元素 - return self.values[0] - - def tail(self): - # 获取第一个元素之后的所有元素 - return self.values[1:] - - def init(self): - # 获取最后一个元素之前的所有元素 - return self.values[:-1] - - def last(self): - # 获取最后一个元素 - return self.values[-1] - - def drop(self, n): - # 获取所有元素，除了前N个 - return self.values[n:] - - def take(self, n): - # 获取前N个元素 - return self.values[:n] - -``` - - diff --git a/Article/PythonBasis/python10/6.md b/Article/PythonBasis/python10/6.md deleted file mode 100644 index 22ab4b42..00000000 --- a/Article/PythonBasis/python10/6.md +++ /dev/null @@ -1,116 +0,0 @@ -# 六、运算符相关的魔术方法 # - - -运算符相关的魔术方法实在太多了,j就大概列举下面两类： - - -## 1、比较运算符 ## - -|魔术方法|说明| -|-----|-----| -|`__cmp__(self, other)`|如果该方法返回负数，说明 `self < other`; 返回正数，说明 `self > other`; 返回 0 说明 `self == other `。强烈不推荐来定义 `__cmp__` , 取而代之, 最好分别定义 `__lt__`, `__eq__` 等方法从而实现比较功能。 `__cmp__` 在 Python3 中被废弃了。| -|`__eq__(self, other)`|定义了比较操作符 == 的行为| -|`__ne__(self, other)`|定义了比较操作符 != 的行为| -|`__lt__(self, other)`|定义了比较操作符 < 的行为| -|`__gt__(self, other)`|定义了比较操作符 > 的行为| -|`__le__(self, other)`|定义了比较操作符 <= 的行为| -|`__ge__(self, other)`|定义了比较操作符 >= 的行为| - - -来看个简单的例子就能理解了： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -class Number(object): - def __init__(self, value): - self.value = value - - def __eq__(self, other): - print('__eq__') - return self.value == other.value - - def __ne__(self, other): - print('__ne__') - return self.value != other.value - - def __lt__(self, other): - print('__lt__') - return self.value < other.value - - def __gt__(self, other): - print('__gt__') - return self.value > other.value - - def __le__(self, other): - print('__le__') - return self.value <= other.value - - def __ge__(self, other): - print('__ge__') - return self.value >= other.value - - -if __name__ == '__main__': - num1 = Number(2) - num2 = Number(3) - print('num1 == num2 ? --------> {} \n'.format(num1 == num2)) - print('num1 != num2 ? --------> {} \n'.format(num1 == num2)) - print('num1 < num2 ? --------> {} \n'.format(num1 < num2)) - print('num1 > num2 ? --------> {} \n'.format(num1 > num2)) - print('num1 <= num2 ? --------> {} \n'.format(num1 <= num2)) - print('num1 >= num2 ? --------> {} \n'.format(num1 >= num2)) - -``` - -输出的结果为： - -```txt -__eq__ -num1 == num2 ? --------> False - -__eq__ -num1 != num2 ? --------> False - -__lt__ -num1 < num2 ? --------> True - -__gt__ -num1 > num2 ? --------> False - -__le__ -num1 <= num2 ? --------> True - -__ge__ -num1 >= num2 ? --------> False - -``` - -## 2、算术运算符 ## - -|魔术方法|说明| -|-----|-----| -|`__add__(self, other)`|实现了加号运算| -|`__sub__(self, other)`|实现了减号运算| -|`__mul__(self, other)`|实现了乘法运算| -|`__floordiv__(self, other)`|实现了 // 运算符| -|`___div__(self, other)`|实现了/运算符. 该方法在 Python3 中废弃. 原因是 Python3 中，division 默认就是 true division| -|`__truediv__(self, other)`|实现了 true division. 只有你声明了 `from __future__ import division` 该方法才会生效| -|`__mod__(self, other)`|实现了 % 运算符, 取余运算| -|`__divmod__(self, other)`|实现了 divmod() 內建函数| -|`__pow__(self, other)`|实现了 `**` 操作. N 次方操作| -|`__lshift__(self, other)`|实现了位操作 `<<`| -|`__rshift__(self, other)`|实现了位操作 `>>`| -|`__and__(self, other)`|实现了位操作 `&`| -|`__or__(self, other)`|实现了位操作 `|`| -|`__xor__(self, other)`|实现了位操作 `^`| - - -可以关注下公众号： - -这个公号可能很少更新，但是一更新，就是把整理的一系列文章更新上去。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-WechatIMG697.jpeg) - - diff --git a/Article/PythonBasis/python10/Preface.md b/Article/PythonBasis/python10/Preface.md deleted file mode 100644 index a1cd4e08..00000000 --- a/Article/PythonBasis/python10/Preface.md +++ /dev/null @@ -1,11 +0,0 @@ -# 前言 # - -有时候修改文章，真的修改到想死。真的很耗时间，很烦的。 - -好吧，每次都是安慰自己，快完结了，快更新完了。 - -# 目录 # - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-Python%20%E7%9A%84%20Magic%20Method.png) - - diff --git a/Article/PythonBasis/python11/1.md b/Article/PythonBasis/python11/1.md deleted file mode 100644 index 0ebc3eeb..00000000 --- a/Article/PythonBasis/python11/1.md +++ /dev/null @@ -1,52 +0,0 @@ -# 一、枚举类的使用 # - -实际开发中，我们离不开定义常量，当我们需要定义常量时，其中一个办法是用大写变量通过整数来定义，例如月份： - -```python -JAN = 1 -FEB = 2 -MAR = 3 -... -NOV = 11 -DEC = 12 -``` - -当然这样做简单快捷，缺点是类型是 `int` ，并且仍然是变量。 - -那有没有什么好的方法呢？ - -这时候我们定义一个 class 类型，每个常量都是 class 里面唯一的实例。 - -正好 Python 提供了 Enum 类来实现这个功能如下： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -from enum import Enum - -Month = Enum('Month', ('Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec')) - -# 遍历枚举类型 -for name, member in Month.__members__.items(): - print(name, '---------', member, '----------', member.value) - -# 直接引用一个常量 -print('\n', Month.Jan) - -``` - -输出的结果如下： - - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-Python3%20%E6%9E%9A%E4%B8%BE%E7%B1%BB%E5%9E%8B%E7%9A%84%E4%BD%BF%E7%94%A8.png) - -我们使用 `Enum` 来定义了一个枚举类。 - -上面的代码，我们创建了一个有关月份的枚举类型 Month ，这里要注意的是构造参数，第一个参数 Month 表示的是该枚举类的类名，第二个 tuple 参数，表示的是枚举类的值；当然，枚举类通过 `__members__` 遍历它的所有成员的方法。 - -注意的一点是 ， `member.value` 是自动赋给成员的 `int` 类型的常量，默认是从 1 开始的。 - -**而且 Enum 的成员均为单例（Singleton），并且不可实例化，不可更改** - - diff --git a/Article/PythonBasis/python11/2.md b/Article/PythonBasis/python11/2.md deleted file mode 100644 index 105cff44..00000000 --- a/Article/PythonBasis/python11/2.md +++ /dev/null @@ -1,36 +0,0 @@ -# 二、Enum 的源码 # - -通过上面的实例可以知道通过 `__members__` 可以遍历枚举类的所有成员。 - -那有没有想过为什么呢？ - -当你看到那段代码的时候，有没有想过为什么通过 `__members__` 就能遍历枚举类型的所有成员出来？ - - -我们可以先来大致看看 Enum 的源码是如何实现的； - -Enum 在模块 enum.py 中，先来看看 Enum 类的片段 - -```python -class Enum(metaclass=EnumMeta): - """Generic enumeration. - Derive from this class to define new enumerations. - """ -``` - -可以看到，Enum 是继承元类 EnumMeta 的；再看看 EnumMeta 的相关片段 - -```python -class EnumMeta(type): - """Metaclass for Enum""" - @property - def __members__(cls): - """Returns a mapping of member name->value. - This mapping lists all enum members, including aliases. Note that this - is a read-only view of the internal mapping. - """ - return MappingProxyType(cls._member_map_) -``` - -首先 `__members__` 方法返回的是一个包含一个 Dict 既 Map 的 MappingProxyType，并且通过 @property 将方法 `__members__(cls)` 的访问方式改变为了变量的的形式，那么就可以直接通过 `__members__` 来进行访问了 - diff --git a/Article/PythonBasis/python11/3.md b/Article/PythonBasis/python11/3.md deleted file mode 100644 index ea4a78da..00000000 --- a/Article/PythonBasis/python11/3.md +++ /dev/null @@ -1,47 +0,0 @@ -# 三、自定义类型的枚举 # - -但有些时候我们需要控制枚举的类型，那么我们可以 Enum 派生出自定义类来满足这种需要。通过修改上面的例子： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- -from enum import Enum, unique - -Enum('Month', ('Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec')) - - -# @unique 装饰器可以帮助我们检查保证没有重复值 -@unique -class Month(Enum): - Jan = 'January' - Feb = 'February' - Mar = 'March' - Apr = 'April' - May = 'May' - Jun = 'June' - Jul = 'July' - Aug = 'August' - Sep = 'September ' - Oct = 'October' - Nov = 'November' - Dec = 'December' - - -if __name__ == '__main__': - print(Month.Jan, '----------', - Month.Jan.name, '----------', Month.Jan.value) - for name, member in Month.__members__.items(): - print(name, '----------', member, '----------', member.value) - -``` - - -输出的结果如下： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-Python3%20%E8%87%AA%E5%AE%9A%E4%B9%89%E7%B1%BB%E5%9E%8B%E7%9A%84%E6%9E%9A%E4%B8%BE%E7%B1%BB.png) - - - -通过上面的例子，可以知道枚举模块定义了具有迭代 (interator) 和比较(comparison) 功能的枚举类型。 它可以用来为值创建明确定义的符号，而不是使用具体的整数或字符串。 - - diff --git a/Article/PythonBasis/python11/4.md b/Article/PythonBasis/python11/4.md deleted file mode 100644 index ec27763e..00000000 --- a/Article/PythonBasis/python11/4.md +++ /dev/null @@ -1,75 +0,0 @@ -# 四、枚举的比较 # - -因为枚举成员不是有序的，所以它们只支持通过标识(identity) 和相等性 (equality) 进行比较。下面来看看 `==` 和 `is` 的使用： - -```python - -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- -from enum import Enum - - -class User(Enum): - Twowater = 98 - Liangdianshui = 30 - Tom = 12 - - -Twowater = User.Twowater -Liangdianshui = User.Liangdianshui - -print(Twowater == Liangdianshui, Twowater == User.Twowater) -print(Twowater is Liangdianshui, Twowater is User.Twowater) - -try: - print('\n'.join(' ' + s.name for s in sorted(User))) -except TypeError as err: - print(' Error : {}'.format(err)) - -``` - -输出的结果： - -```txt - -False True -False True - Error : '<' not supported between instances of 'User' and 'User' - -``` - -可以看看最后的输出结果，报了个异常，那是因为大于和小于比较运算符引发 TypeError 异常。也就是 `Enum` 类的枚举是不支持大小运算符的比较的。 - -那么能不能让枚举类进行大小的比较呢？ - -当然是可以的，使用 IntEnum 类进行枚举，就支持比较功能。 - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- -import enum - - -class User(enum.IntEnum): - Twowater = 98 - Liangdianshui = 30 - Tom = 12 - - -try: - print('\n'.join(s.name for s in sorted(User))) -except TypeError as err: - print(' Error : {}'.format(err)) - - -``` - -看看输出的结果： - -```txt -Tom -Liangdianshui -Twowater -``` - -通过输出的结果可以看到，枚举类的成员通过其值得大小进行了排序。也就是说可以进行大小的比较。 diff --git a/Article/PythonBasis/python11/Preface.md b/Article/PythonBasis/python11/Preface.md deleted file mode 100644 index 3d40a7ea..00000000 --- a/Article/PythonBasis/python11/Preface.md +++ /dev/null @@ -1,11 +0,0 @@ -# 前言 # - -2019年10月14日16:59:38 看了一下，还有五个章节就修改完基础部分了。 - -干就完事了。 - -# 目录 # - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-%E6%9E%9A%E4%B8%BE%E7%B1%BB.png) - - diff --git a/Article/PythonBasis/python12/1.md b/Article/PythonBasis/python12/1.md deleted file mode 100644 index 782a61a7..00000000 --- a/Article/PythonBasis/python12/1.md +++ /dev/null @@ -1,69 +0,0 @@ -# 一、Python 中类也是对象 # - -在了解元类之前，我们先进一步理解 Python 中的类，在大多数编程语言中，类就是一组用来描述如何生成一个对象的代码段。在 Python 中这一点也是一样的。 - -这点在学习类的章节也强调过了，下面可以通过例子回忆一下： - -```python -class ObjectCreator(object): - pass - - -mObject = ObjectCreator() -print(mObject) -``` - -输出结果： - -``` -<__main__.ObjectCreator object at 0x00000000023EE048> -``` - -但是，Python 中的类有一点跟大多数的编程语言不同，在 Python 中，可以把类理解成也是一种对象。对的，这里没有写错，就是对象。 - -为什么呢？ - -因为只要使用关键字 `class` ，Python 解释器在执行的时候就会创建一个对象。 - -如： - -```python -class ObjectCreator(object): - pass -``` - -当程序运行这段代码的时候，就会在内存中创建一个对象，名字就是ObjectCreator。这个对象（类）自身拥有创建对象（类实例）的能力，而这就是为什么它是一个类的原因。 - -但是，它的本质仍然是一个对象，于是我们可以对它做如下的操作： - -```python -class ObjectCreator(object): - pass - - -def echo(ob): - print(ob) - - -mObject = ObjectCreator() -print(mObject) - -# 可以直接打印一个类，因为它其实也是一个对象 -print(ObjectCreator) -# 可以直接把一个类作为参数传给函数（注意这里是类，是没有实例化的） -echo(ObjectCreator) -# 也可以直接把类赋值给一个变量 -objectCreator = ObjectCreator -print(objectCreator) -``` - -输出的结果如下： - -``` -<__main__.ObjectCreator object at 0x000000000240E358> - - - -``` - - diff --git a/Article/PythonBasis/python12/2.md b/Article/PythonBasis/python12/2.md deleted file mode 100644 index fa5715c3..00000000 --- a/Article/PythonBasis/python12/2.md +++ /dev/null @@ -1,115 +0,0 @@ -# 二、使用 `type()` 动态创建类 # - -因为类也是对象，所以我们可以在程序运行的时候创建类。 - -Python 是动态语言。 - -**动态语言和静态语言最大的不同，就是函数和类的定义，不是编译时定义的，而是运行时动态创建的。** - -在之前，我们先了了解下 `type()` 函数。 - - -首先我们新建一个 `hello.py` 的模块，然后定义一个 Hello 的 class ， - -```python -class Hello(object): - def hello(self, name='Py'): - print('Hello,', name) -``` - -然后在另一个模块中引用 hello 模块，并输出相应的信息。 - -其中 `type()` 函数的作用是可以查看一个类型和变量的类型。 - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -from com.twowater.hello import Hello - -h = Hello() -h.hello() - -print(type(Hello)) -print(type(h)) - -``` - -输出的结果是怎样的呢？ - -``` -Hello, Py - - -``` - -上面也提到过，`type()` 函数可以查看一个类型或变量的类型，`Hello` 是一个 `class` ，它的类型就是 `type` ，而 `h` 是一个实例，它的类型就是 `com.twowater.hello.Hello`。 - -前面的 `com.twowater` 是我的包名，`hello` 模块在该包名下。 - -在这里还要细想一下，上面的例子中，我们使用 `type()` 函数查看一个类型或者变量的类型。 - -其中查看了一个 `Hello` class 的类型，打印的结果是： `` 。 - -**其实 `type()` 函数不仅可以返回一个对象的类型，也可以创建出新的类型。** - -class 的定义是运行时动态创建的，而创建 class 的方法就是使用 `type()` 函数。 - -比如我们可以通过 `type()` 函数创建出上面例子中的 `Hello` 类，具体看下面的代码： - -```python -# -*- coding: UTF-8 -*- - -def printHello(self, name='Py'): - # 定义一个打印 Hello 的函数 - print('Hello,', name) - - -# 创建一个 Hello 类 -Hello = type('Hello', (object,), dict(hello=printHello)) - -# 实例化 Hello 类 -h = Hello() -# 调用 Hello 类的方法 -h.hello() -# 查看 Hello class 的类型 -print(type(Hello)) -# 查看实例 h 的类型 -print(type(h)) - -``` - -输出的结果如下： - -``` -Hello, Py - - -``` - -在这里，需先了解下通过 `type()` 函数创建 class 对象的参数说明： - -1、class 的名称，比如例子中的起名为 `Hello` - -2、继承的父类集合，注意 Python 支持多重继承，如果只有一个父类，tuple 要使用单元素写法；例子中继承 object 类，因为是单元素的 tuple ，所以写成 `(object,)` - -3、class 的方法名称与函数绑定；例子中将函数 `printHello` 绑定在方法名 `hello` 中 - -具体的模式如下： - -```python -type(类名, 父类的元组（针对继承的情况，可以为空），包含属性的字典（名称和值）) -``` - -好了，了解完具体的参数使用之外，我们看看输出的结果，可以看到，通过 `type()` 函数创建的类和直接写 class 是完全一样的。 - -这是因为Python 解释器遇到 class 定义时，仅仅是扫描一下 class 定义的语法，然后调用 `type()` 函数创建出 class 的。 - -不过一般的情况下，我们都是使用 `class ***...` 的方法来定义类的，不过 `type()` 函数也可以让我们创建出类来。 - -也就是说，动态语言本身支持运行期动态创建类，这和静态语言有非常大的不同，要在静态语言运行期创建类，必须构造源代码字符串再调用编译器，或者借助一些工具生成字节码实现，本质上都是动态编译，会非常复杂。 - -**可以看到，在 Python 中，类也是对象，你可以动态的创建类。** - -其实这也就是当你使用关键字 class 时 Python 在幕后做的事情，而这就是通过元类来实现的。 - diff --git a/Article/PythonBasis/python12/3.md b/Article/PythonBasis/python12/3.md deleted file mode 100644 index 0db692d4..00000000 --- a/Article/PythonBasis/python12/3.md +++ /dev/null @@ -1,102 +0,0 @@ -# 三、什么是元类 # - -通过上面的介绍，终于模模糊糊的带到元类这里来了。可是我们到现在还不知道元类是什么鬼东西。 - -我们创建类的时候，大多数是为了创建类的实例对象。 - -那么元类呢？ - -**元类就是用来创建类的。也可以换个理解方式就是：元类就是类的类。** - -通过上面 `type()` 函数的介绍，我们知道可以通过 `type()` 函数创建类： - -```python -MyClass = type('MyClass', (), {}) -``` - -**实际上 `type()` 函数是一个元类。** - -`type()` 就是 Python 在背后用来创建所有类的元类。 - -那么现在我们也可以猜到一下为什么 `type()` 函数是 type 而不是 Type呢？ - -这可能是为了和 str 保持一致性，str 是用来创建字符串对象的类，而 int 是用来创建整数对象的类。 - -type 就是创建类对象的类。 - -你可以通过检查 `__class__` 属性来看到这一点。 - -Python 中所有的东西，注意喔，这里是说所有的东西，他们都是对象。 - -这包括整数、字符串、函数以及类。它们全部都是对象，而且它们都是从一个类创建而来。 - -```python -# 整形 -age = 23 -print(age.__class__) -# 字符串 -name = '两点水' -print(name.__class__) - - -# 函数 -def fu(): - pass - - -print(fu.__class__) - - -# 实例 -class eat(object): - pass - - -mEat = eat() - -print(mEat.__class__) -``` - -输出的结果如下： - -``` - - - - -``` - -可以看到，上面的所有东西，也就是所有对象都是通过类来创建的，那么我们可能会好奇，`__class__` 的 `__class__` 会是什么呢？ - -**换个说法就是，创建这些类的类是什么呢？** - -我们可以继续在上面的代码基础上新增下面的代码： - -```python -print(age.__class__.__class__) -print(name.__class__.__class__) -print(fu.__class__.__class__) -print(mEat.__class__.__class__) -``` - -输出的结果如下： - -``` - - - - -``` - -认真观察，再理清一下，上面输出的结果是我们把整形 `age` ,字符创 `name` ,函数 `fu` 和对象实例 `mEat` 里 `__class__` 的 `__class__` 打印出来的结果。 - -也可以说是他们类的类打印结果。发现打印出来的 class 都是 type 。 - -一开始也提到了，元类就是类的类。 - -也就是元类就是负责创建类的一种东西。 - -你也可以理解为，元类就是负责生成类的。 - -**而 type 就是内建的元类。也就是 Python 自带的元类。** - diff --git a/Article/PythonBasis/python12/4.md b/Article/PythonBasis/python12/4.md deleted file mode 100644 index 2376a9b6..00000000 --- a/Article/PythonBasis/python12/4.md +++ /dev/null @@ -1,163 +0,0 @@ -# 四、自定义元类 # - -到现在，我们已经知道元类是什么鬼东西了。 - -那么，从始至终我们还不知道元类到底有啥用。 - -只是了解了一下元类。 - -在了解它有啥用的时候，我们先来了解下怎么自定义元类。 - -因为只有了解了怎么自定义才能更好的理解它的作用。 - -首先我们来了解下 `__metaclass__` 属性 - -metaclass，直译为元类，简单的解释就是： - -当我们定义了类以后，就可以根据这个类创建出实例，所以：先定义类，然后创建实例。 - -但是如果我们想创建出类呢？ - -那就必须根据metaclass创建出类，所以：先定义metaclass，然后创建类。 - -连接起来就是：先定义metaclass，就可以创建类，最后创建实例。 - -所以，metaclass 允许你创建类或者修改类。 - -换句话说，你可以把类看成是 metaclass 创建出来的“实例”。 - -```python -class MyObject(object): - __metaclass__ = something… -[…] -``` - -如果是这样写的话，Python 就会用元类来创建类 MyObject。 - -当你写下 `class MyObject(object)`，但是类对象 MyObject 还没有在内存中创建。P - -ython 会在类的定义中寻找 `__metaclass__` 属性，如果找到了，Python 就会用它来创建类 MyObject，如果没有找到，就会用内建的 type 函数来创建这个类。如果还不怎么理解，看下下面的流程图： - -![__metaclass__的介绍](https://user-gold-cdn.xitu.io/2017/9/6/06c5a4390887abd3d79401848742f5ce) - - -再举个实例： - -```python -class Foo(Bar): - pass -``` - -它的判断流程是怎样的呢？ - -首先判断 Foo 中是否有 `__metaclass__` 这个属性？如果有，Python 会在内存中通过 `__metaclass__` 创建一个名字为 Foo 的类对象（注意，这里是类对象）。如果 Python 没有找到`__metaclass__` ，它会继续在 Bar（父类）中寻找`__metaclass__` 属性，并尝试做和前面同样的操作。如果 Python在任何父类中都找不到 `__metaclass__` ，它就会在模块层次中去寻找 `__metaclass__` ，并尝试做同样的操作。如果还是找不到` ` `__metaclass__` ,Python 就会用内置的 type 来创建这个类对象。 - -其实 `__metaclass__` 就是定义了 class 的行为。类似于 class 定义了 instance 的行为，metaclass 则定义了 class 的行为。可以说，class 是 metaclass 的 instance。 - - -现在，我们基本了解了 `__metaclass__` 属性，但是，也没讲过如何使用这个属性，或者说这个属性可以放些什么？ - -答案就是：可以创建一个类的东西。那么什么可以用来创建一个类呢？type，或者任何使用到 type 或者子类化 type 的东东都可以。 - -**元类的主要目的就是为了当创建类时能够自动地改变类。** - -通常，你会为API 做这样的事情，你希望可以创建符合当前上下文的类。假想一个很傻的例子，你决定在你的模块里所有的类的属性都应该是大写形式。有好几种方法可以办到，但其中一种就是通过在模块级别设定`__metaclass__` 。采用这种方法，这个模块中的所有类都会通过这个元类来创建，我们只需要告诉元类把所有的属性都改成大写形式就万事大吉了。 - -幸运的是，`__metaclass__` 实际上可以被任意调用，它并不需要是一个正式的类。所以，我们这里就先以一个简单的函数作为例子开始。 - -```python -# 元类会自动将你通常传给‘type’的参数作为自己的参数传入 -def upper_attr(future_class_name, future_class_parents, future_class_attr): - '''返回一个类对象，将属性都转为大写形式''' - # 选择所有不以'__'开头的属性 - attrs = ((name, value) for name, value in future_class_attr.items() if not name.startswith('__')) -``` - - -```python -# 将它们转为大写形式 -uppercase_attr = dict((name.upper(), value) for name, value in attrs) - -# 通过'type'来做类对象的创建 -return type(future_class_name, future_class_parents, uppercase_attr) - -__metaclass__ = upper_attr -# 这会作用到这个模块中的所有类 - -class Foo(object): - # 我们也可以只在这里定义__metaclass__，这样就只会作用于这个类中 - bar = 'bip' -``` - -```python -print hasattr(Foo, 'bar') -# 输出: False -print hasattr(Foo, 'BAR') -# 输出:True - -f = Foo() -print f.BAR -# 输出:'bip' -``` - -用 class 当做元类的做法： - -```python -# 请记住，'type'实际上是一个类，就像'str'和'int'一样 -# 所以，你可以从type继承 -class UpperAttrMetaClass(type): - # __new__ 是在__init__之前被调用的特殊方法 - # __new__是用来创建对象并返回之的方法 - # 而__init__只是用来将传入的参数初始化给对象 - # 你很少用到__new__，除非你希望能够控制对象的创建 - # 这里，创建的对象是类，我们希望能够自定义它，所以我们这里改写__new__ - # 如果你希望的话，你也可以在__init__中做些事情 - # 还有一些高级的用法会涉及到改写__call__特殊方法，但是我们这里不用 - def __new__(upperattr_metaclass, future_class_name, future_class_parents, future_class_attr): - attrs = ((name, value) for name, value in future_class_attr.items() if not name.startswith('__')) - uppercase_attr = dict((name.upper(), value) for name, value in attrs) - return type(future_class_name, future_class_parents, uppercase_attr) - -``` - -但是，这种方式其实不是 OOP。我们直接调用了 type，而且我们没有改写父类的 `__new__` 方法。现在让我们这样去处理: - -```python - -class UpperAttrMetaclass(type): - def __new__(upperattr_metaclass, future_class_name, future_class_parents, future_class_attr): - attrs = ((name, value) for name, value in future_class_attr.items() if not name.startswith('__')) - uppercase_attr = dict((name.upper(), value) for name, value in attrs) - - # 复用type.__new__方法 - # 这就是基本的OOP编程，没什么魔法 - return type.__new__(upperattr_metaclass, future_class_name, future_class_parents, uppercase_attr) -``` - -你可能已经注意到了有个额外的参数 `upperattr_metaclass` ，这并没有什么特别的。类方法的第一个参数总是表示当前的实例，就像在普通的类方法中的 self 参数一样。当然了，为了清晰起见，这里的名字我起的比较长。但是就像 self 一样，所有的参数都有它们的传统名称。因此，在真实的产品代码中一个元类应该是像这样的： - -```python -class UpperAttrMetaclass(type): - def __new__(cls, name, bases, dct): - attrs = ((name, value) for name, value in dct.items() if not name.startswith('__') - uppercase_attr = dict((name.upper(), value) for name, value in attrs) - return type.__new__(cls, name, bases, uppercase_attr) - -``` - -如果使用 super 方法的话，我们还可以使它变得更清晰一些，这会缓解继承（是的，你可以拥有元类，从元类继承，从 type 继承） - -```python -class UpperAttrMetaclass(type): - def __new__(cls, name, bases, dct): - attrs = ((name, value) for name, value in dct.items() if not name.startswith('__')) - uppercase_attr = dict((name.upper(), value) for name, value in attrs) - return super(UpperAttrMetaclass, cls).__new__(cls, name, bases, uppercase_attr) -``` - -通常我们都会使用元类去做一些晦涩的事情，依赖于自省，控制继承等等。确实，用元类来搞些“黑暗魔法”是特别有用的，因而会搞出些复杂的东西来。但就元类本身而言，它们其实是很简单的： - -* 拦截类的创建 -* 修改类 -* 返回修改之后的类 - diff --git a/Article/PythonBasis/python12/5.md b/Article/PythonBasis/python12/5.md deleted file mode 100644 index c6a0ad7a..00000000 --- a/Article/PythonBasis/python12/5.md +++ /dev/null @@ -1,37 +0,0 @@ -# 五、使用元类 # - -终于到了使用元类了，可是一般来说，我们根本就用不上它，就像Python 界的领袖 Tim Peters 说的： - -> 元类就是深度的魔法，99% 的用户应该根本不必为此操心。如果你想搞清楚究竟是否需要用到元类，那么你就不需要它。那些实际用到元类的人都非常清楚地知道他们需要做什么，而且根本不需要解释为什么要用元类。 - -元类的主要用途是创建 API。一个典型的例子是 Django ORM。它允许你像这样定义： - -```python -class Person(models.Model): - name = models.CharField(max_length=30) - age = models.IntegerField() -``` - -但是如果你这样做的话： - -```python -guy = Person(name='bob', age='35') -print guy.age -``` - -这并不会返回一个 IntegerField 对象，而是会返回一个 int，甚至可以直接从数据库中取出数据。 - -这是有可能的，因为 models.Model 定义了 `__metaclass__` ， 并且使用了一些魔法能够将你刚刚定义的简单的Person类转变成对数据库的一个复杂 hook。 - -Django 框架将这些看起来很复杂的东西通过暴露出一个简单的使用元类的 API 将其化简，通过这个 API 重新创建代码，在背后完成真正的工作。 - -Python 中的一切都是对象，它们要么是类的实例，要么是元类的实例，除了 type。type 实际上是它自己的元类，在纯 Python 环境中这可不是你能够做到的，这是通过在实现层面耍一些小手段做到的。 - -参考： - -[https://stackoverflow.com/questions/100003/what-is-a-metaclass-in-python](https://stackoverflow.com/questions/100003/what-is-a-metaclass-in-python) - - - - - diff --git a/Article/PythonBasis/python12/Preface.md b/Article/PythonBasis/python12/Preface.md deleted file mode 100644 index 327c0790..00000000 --- a/Article/PythonBasis/python12/Preface.md +++ /dev/null @@ -1,13 +0,0 @@ -# 前言 # - -Python 界的领袖 Tim Peters 说的： - -> 元类就是深度的魔法，99% 的用户应该根本不必为此操心。如果你想搞清楚究竟是否需要用到元类，那么你就不需要它。那些实际用到元类的人都非常清楚地知道他们需要做什么，而且根本不需要解释为什么要用元类。 - - -所以，这篇文章，认真阅读一遍就好了。 - -# 目录 # - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-%E5%85%83%E7%B1%BB.png) - diff --git a/Article/PythonBasis/python13/1.md b/Article/PythonBasis/python13/1.md deleted file mode 100644 index 65392887..00000000 --- a/Article/PythonBasis/python13/1.md +++ /dev/null @@ -1,57 +0,0 @@ -# 线程与进程 # - -线程与进程是操作系统里面的术语，简单来讲，每一个应用程序都有一个自己的进程。 - -操作系统会为这些进程分配一些执行资源，例如内存空间等。 - -在进程中，又可以创建一些线程，他们共享这些内存空间，并由操作系统调用，以便并行计算。 - -我们都知道现代操作系统比如 Mac OS X，UNIX，Linux，Windows 等可以同时运行多个任务。 - -打个比方，你一边在用浏览器上网，一边在听敲代码，一边用 Markdown 写博客，这就是多任务，至少同时有 3 个任务正在运行。 - -当然还有很多任务悄悄地在后台同时运行着，只是桌面上没有显示而已。 - -对于操作系统来说，一个任务就是一个进程（Process），比如打开一个浏览器就是启动一个浏览器进程，打开 PyCharm 就是一个启动了一个 PtCharm 进程，打开 Markdown 就是启动了一个 Md 的进程。 - -虽然现在多核 CPU 已经非常普及了。 - -可是由于 CPU 执行代码都是顺序执行的，这时候我们就会有疑问，单核 CPU 是怎么执行多任务的呢？ - -其实就是操作系统轮流让各个任务交替执行，任务 1 执行 0.01 秒，切换到任务 2 ，任务 2 执行 0.01 秒，再切换到任务 3 ，执行 0.01秒……这样反复执行下去。 - -表面上看，每个任务都是交替执行的，但是，由于 CPU的执行速度实在是太快了，我们肉眼和感觉上没法识别出来，就像所有任务都在同时执行一样。 - -真正的并行执行多任务只能在多核 CPU 上实现，但是，由于任务数量远远多于 CPU 的核心数量，所以，操作系统也会自动把很多任务轮流调度到每个核心上执行。 - - -有些进程不仅仅只是干一件事的啊，比如浏览器，我们可以播放时视频，播放音频，看文章，编辑文章等等，其实这些都是在浏览器进程中的子任务。在一个进程内部，要同时干多件事，就需要同时运行多个“子任务”，我们把进程内的这些“子任务”称为线程（Thread）。 - -由于每个进程至少要干一件事，所以，一个进程至少有一个线程。 - -当然，一个进程也可以有多个线程，多个线程可以同时执行，多线程的执行方式和多进程是一样的，也是由操作系统在多个线程之间快速切换，让每个线程都短暂地交替运行，看起来就像同时执行一样。 - -那么在 Python 中我们要同时执行多个任务怎么办？ - -有两种解决方案： - -一种是启动多个进程，每个进程虽然只有一个线程，但多个进程可以一块执行多个任务。 - -还有一种方法是启动一个进程，在一个进程内启动多个线程，这样，多个线程也可以一块执行多个任务。 - -当然还有第三种方法，就是启动多个进程，每个进程再启动多个线程，这样同时执行的任务就更多了，当然这种模型更复杂，实际很少采用。 - -总结一下就是，多任务的实现有3种方式： - -* 多进程模式； -* 多线程模式； -* 多进程+多线程模式。 - -同时执行多个任务通常各个任务之间并不是没有关联的，而是需要相互通信和协调，有时，任务 1 必须暂停等待任务 2 完成后才能继续执行，有时，任务 3 和任务 4 又不能同时执行，所以，多进程和多线程的程序的复杂度要远远高于我们前面写的单进程单线程的程序。 - -因为复杂度高，调试困难，所以，不是迫不得已，我们也不想编写多任务。 - -但是，有很多时候，没有多任务还真不行。 - -想想在电脑上看电影，就必须由一个线程播放视频，另一个线程播放音频，否则，单线程实现的话就只能先把视频播放完再播放音频，或者先把音频播放完再播放视频，这显然是不行的。 - diff --git a/Article/PythonBasis/python13/2.md b/Article/PythonBasis/python13/2.md deleted file mode 100644 index 19b1d413..00000000 --- a/Article/PythonBasis/python13/2.md +++ /dev/null @@ -1,394 +0,0 @@ -# 多线程编程 # - -其实创建线程之后，线程并不是始终保持一个状态的，其状态大概如下： - -* New 创建 -* Runnable 就绪。等待调度 -* Running 运行 -* Blocked 阻塞。阻塞可能在 Wait Locked Sleeping -* Dead 消亡 - -线程有着不同的状态，也有不同的类型。大致可分为： - -* 主线程 -* 子线程 -* 守护线程（后台线程） -* 前台线程 - -简单了解完这些之后，我们开始看看具体的代码使用了。 - -## 1、线程的创建 ## - -Python 提供两个模块进行多线程的操作，分别是 `thread` 和 `threading` - -前者是比较低级的模块，用于更底层的操作，一般应用级别的开发不常用。 - -因此，我们使用 `threading` 来举个例子： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -import time -import threading - - -class MyThread(threading.Thread): - def run(self): - for i in range(5): - print('thread {}, @number: {}'.format(self.name, i)) - time.sleep(1) - - -def main(): - print("Start main threading") - - # 创建三个线程 - threads = [MyThread() for i in range(3)] - # 启动三个线程 - for t in threads: - t.start() - - print("End Main threading") - - -if __name__ == '__main__': - main() - -``` - -运行结果： - -```txt -Start main threading -thread Thread-1, @number: 0 -thread Thread-2, @number: 0 -thread Thread-3, @number: 0 -End Main threading -thread Thread-2, @number: 1 -thread Thread-1, @number: 1 -thread Thread-3, @number: 1 -thread Thread-1, @number: 2 -thread Thread-3, @number: 2 -thread Thread-2, @number: 2 -thread Thread-2, @number: 3 -thread Thread-3, @number: 3 -thread Thread-1, @number: 3 -thread Thread-3, @number: 4 -thread Thread-2, @number: 4 -thread Thread-1, @number: 4 -``` - -注意喔，这里不同的环境输出的结果肯定是不一样的。 - -## 2、线程合并（join方法） ## - -上面的示例打印出来的结果来看，主线程结束后，子线程还在运行。那么我们需要主线程要等待子线程运行完后，再退出，要怎么办呢？ - -这时候，就需要用到 `join` 方法了。 - -在上面的例子，新增一段代码，具体如下： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -import time -import threading - - -class MyThread(threading.Thread): - def run(self): - for i in range(5): - print('thread {}, @number: {}'.format(self.name, i)) - time.sleep(1) - - -def main(): - print("Start main threading") - - # 创建三个线程 - threads = [MyThread() for i in range(3)] - # 启动三个线程 - for t in threads: - t.start() - - # 一次让新创建的线程执行 join - for t in threads: - t.join() - - print("End Main threading") - - -if __name__ == '__main__': - main() - -``` - - -从打印的结果，可以清楚看到，相比上面示例打印出来的结果，主线程是在等待子线程运行结束后才结束的。 - -```txt -Start main threading -thread Thread-1, @number: 0 -thread Thread-2, @number: 0 -thread Thread-3, @number: 0 -thread Thread-1, @number: 1 -thread Thread-3, @number: 1 -thread Thread-2, @number: 1 -thread Thread-2, @number: 2 -thread Thread-1, @number: 2 -thread Thread-3, @number: 2 -thread Thread-2, @number: 3 -thread Thread-1, @number: 3 -thread Thread-3, @number: 3 -thread Thread-3, @number: 4 -thread Thread-2, @number: 4 -thread Thread-1, @number: 4 -End Main threading - -``` -## 3、线程同步与互斥锁 ## - -使用线程加载获取数据，通常都会造成数据不同步的情况。当然，这时候我们可以给资源进行加锁，也就是访问资源的线程需要获得锁才能访问。 - -其中 `threading` 模块给我们提供了一个 Lock 功能。 - -```python -lock = threading.Lock() -``` - -在线程中获取锁 - -```python -lock.acquire() -``` - -使用完成后，我们肯定需要释放锁 - -```python -lock.release() -``` - -当然为了支持在同一线程中多次请求同一资源，Python 提供了可重入锁（RLock）。RLock 内部维护着一个 Lock 和一个 counter 变量，counter 记录了 acquire 的次数，从而使得资源可以被多次 require。直到一个线程所有的 acquire 都被 release，其他的线程才能获得资源。 - -那么怎么创建重入锁呢？也是一句代码的事情： - -```python -r_lock = threading.RLock() -``` - -## 4、Condition 条件变量 ## - -实用锁可以达到线程同步，但是在更复杂的环境，需要针对锁进行一些条件判断。 - -Python 提供了 Condition 对象。 - -**使用 Condition 对象可以在某些事件触发或者达到特定的条件后才处理数据，Condition 除了具有 Lock 对象的 acquire 方法和 release 方法外，还提供了 wait 和 notify 方法。** - -线程首先 acquire 一个条件变量锁。如果条件不足，则该线程 wait，如果满足就执行线程，甚至可以 notify 其他线程。其他处于 wait 状态的线程接到通知后会重新判断条件。 - -其中条件变量可以看成不同的线程先后 acquire 获得锁，如果不满足条件，可以理解为被扔到一个（ Lock 或 RLock ）的 waiting 池。直到其他线程 notify 之后再重新判断条件。不断的重复这一过程，从而解决复杂的同步问题。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-Condition.png) - -该模式常用于生产者消费者模式，具体看看下面在线购物买家和卖家的示例： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -import threading, time - - -class Consumer(threading.Thread): - def __init__(self, cond, name): - # 初始化 - super(Consumer, self).__init__() - self.cond = cond - self.name = name - - def run(self): - # 确保先运行Seeker中的方法 - time.sleep(1) - self.cond.acquire() - print(self.name + ': 我这两件商品一起买，可以便宜点吗') - self.cond.notify() - self.cond.wait() - print(self.name + ': 我已经提交订单了，你修改下价格') - self.cond.notify() - self.cond.wait() - print(self.name + ': 收到，我支付成功了') - self.cond.notify() - self.cond.release() - print(self.name + ': 等待收货') - - -class Producer(threading.Thread): - def __init__(self, cond, name): - super(Producer, self).__init__() - self.cond = cond - self.name = name - - def run(self): - self.cond.acquire() - # 释放对琐的占用，同时线程挂起在这里，直到被 notify 并重新占有琐。 - self.cond.wait() - print(self.name + ': 可以的，你提交订单吧') - self.cond.notify() - self.cond.wait() - print(self.name + ': 好了，已经修改了') - self.cond.notify() - self.cond.wait() - print(self.name + ': 嗯，收款成功，马上给你发货') - self.cond.release() - print(self.name + ': 发货商品') - - -cond = threading.Condition() -consumer = Consumer(cond, '买家（两点水）') -producer = Producer(cond, '卖家（三点水）') -consumer.start() -producer.start() - -``` - -输出的结果如下： - -```txt -买家（两点水）: 我这两件商品一起买，可以便宜点吗 -卖家（三点水）: 可以的，你提交订单吧 -买家（两点水）: 我已经提交订单了，你修改下价格 -卖家（三点水）: 好了，已经修改了 -买家（两点水）: 收到，我支付成功了 -买家（两点水）: 等待收货 -卖家（三点水）: 嗯，收款成功，马上给你发货 -卖家（三点水）: 发货商品 -``` - -## 5、线程间通信 ## - -如果程序中有多个线程，这些线程避免不了需要相互通信的。那么我们怎样在这些线程之间安全地交换信息或数据呢？ - -从一个线程向另一个线程发送数据最安全的方式可能就是使用 queue 库中的队列了。创建一个被多个线程共享的 `Queue` 对象，这些线程通过使用 `put()` 和 `get()` 操作来向队列中添加或者删除元素。 - -```python -# -*- coding: UTF-8 -*- -from queue import Queue -from threading import Thread - -isRead = True - - -def write(q): - # 写数据进程 - for value in ['两点水', '三点水', '四点水']: - print('写进 Queue 的值为：{0}'.format(value)) - q.put(value) - - -def read(q): - # 读取数据进程 - while isRead: - value = q.get(True) - print('从 Queue 读取的值为：{0}'.format(value)) - - -if __name__ == '__main__': - q = Queue() - t1 = Thread(target=write, args=(q,)) - t2 = Thread(target=read, args=(q,)) - t1.start() - t2.start() -``` - -输出的结果如下： - -```txt -写进 Queue 的值为：两点水 -写进 Queue 的值为：三点水 -从 Queue 读取的值为：两点水 -写进 Queue 的值为：四点水 -从 Queue 读取的值为：三点水 -从 Queue 读取的值为：四点水 -``` - -Python 还提供了 Event 对象用于线程间通信，它是由线程设置的信号标志，如果信号标志位真，则其他线程等待直到信号接触。 - -Event 对象实现了简单的线程通信机制，它提供了设置信号，清楚信号，等待等用于实现线程间的通信。 - -* 设置信号 - -使用 Event 的 `set()` 方法可以设置 Event 对象内部的信号标志为真。Event 对象提供了 `isSe()` 方法来判断其内部信号标志的状态。当使用 event 对象的 `set()` 方法后，`isSet()` 方法返回真 - -* 清除信号 - -使用 Event 对象的 `clear()` 方法可以清除 Event 对象内部的信号标志，即将其设为假，当使用 Event 的 clear 方法后，isSet() 方法返回假 - -* 等待 - -Event 对象 wait 的方法只有在内部信号为真的时候才会很快的执行并完成返回。当 Event 对象的内部信号标志位假时，则 wait 方法一直等待到其为真时才返回。 - -示例： - -```python -# -*- coding: UTF-8 -*- - -import threading - - -class mThread(threading.Thread): - def __init__(self, threadname): - threading.Thread.__init__(self, name=threadname) - - def run(self): - # 使用全局Event对象 - global event - # 判断Event对象内部信号标志 - if event.isSet(): - event.clear() - event.wait() - print(self.getName()) - else: - print(self.getName()) - # 设置Event对象内部信号标志 - event.set() - -# 生成Event对象 -event = threading.Event() -# 设置Event对象内部信号标志 -event.set() -t1 = [] -for i in range(10): - t = mThread(str(i)) - # 生成线程列表 - t1.append(t) - -for i in t1: - # 运行线程 - i.start() - -``` - - -输出的结果如下： - -```txt -1 -0 -3 -2 -5 -4 -7 -6 -9 -8 -``` - - -## 6、后台线程 ## - -默认情况下，主线程退出之后，即使子线程没有 join。那么主线程结束后，子线程也依然会继续执行。如果希望主线程退出后，其子线程也退出而不再执行，则需要设置子线程为后台线程。Python 提供了 `setDeamon` 方法。 - - diff --git a/Article/PythonBasis/python13/3.md b/Article/PythonBasis/python13/3.md deleted file mode 100644 index eddfdce5..00000000 --- a/Article/PythonBasis/python13/3.md +++ /dev/null @@ -1,317 +0,0 @@ -# 进程 # - -Python 中的多线程其实并不是真正的多线程，如果想要充分地使用多核 CPU 的资源，在 Python 中大部分情况需要使用多进程。 - -Python 提供了非常好用的多进程包 multiprocessing，只需要定义一个函数，Python 会完成其他所有事情。 - -借助这个包，可以轻松完成从单进程到并发执行的转换。multiprocessing 支持子进程、通信和共享数据、执行不同形式的同步，提供了 Process、Queue、Pipe、Lock 等组件。 - - -## 1、类 Process ## - -创建进程的类：`Process([group [, target [, name [, args [, kwargs]]]]])` - -* target 表示调用对象 -* args 表示调用对象的位置参数元组 -* kwargs表示调用对象的字典 -* name为别名 -* group实质上不使用 - -下面看一个创建函数并将其作为多个进程的例子： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -import multiprocessing -import time - - -def worker(interval, name): - print(name + '【start】') - time.sleep(interval) - print(name + '【end】') - - -if __name__ == "__main__": - p1 = multiprocessing.Process(target=worker, args=(2, '两点水1')) - p2 = multiprocessing.Process(target=worker, args=(3, '两点水2')) - p3 = multiprocessing.Process(target=worker, args=(4, '两点水3')) - - p1.start() - p2.start() - p3.start() - - print("The number of CPU is:" + str(multiprocessing.cpu_count())) - for p in multiprocessing.active_children(): - print("child p.name:" + p.name + "\tp.id" + str(p.pid)) - print("END!!!!!!!!!!!!!!!!!") - -``` - -输出的结果： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-%E5%A4%9A%E8%BF%9B%E7%A8%8B%E8%BE%93%E5%87%BA%E7%BB%93%E6%9E%9C.gif) - - -## 2、把进程创建成类 ## - -当然我们也可以把进程创建成一个类，如下面的例子，当进程 p 调用 start() 时，自动调用 run() 方法。 - - -```python -# -*- coding: UTF-8 -*- - -import multiprocessing -import time - - -class ClockProcess(multiprocessing.Process): - def __init__(self, interval): - multiprocessing.Process.__init__(self) - self.interval = interval - - def run(self): - n = 5 - while n > 0: - print("当前时间: {0}".format(time.ctime())) - time.sleep(self.interval) - n -= 1 - - -if __name__ == '__main__': - p = ClockProcess(3) - p.start() - -``` - -输出结果如下： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-%E5%88%9B%E5%BB%BA%E8%BF%9B%E7%A8%8B%E7%B1%BB.gif) - -## 3、daemon 属性 ## - -想知道 daemon 属性有什么用，看下下面两个例子吧，一个加了 daemon 属性，一个没有加，对比输出的结果： - -没有加 deamon 属性的例子： - -```python -# -*- coding: UTF-8 -*- -import multiprocessing -import time - - -def worker(interval): - print('工作开始时间：{0}'.format(time.ctime())) - time.sleep(interval) - print('工作结果时间：{0}'.format(time.ctime())) - - -if __name__ == '__main__': - p = multiprocessing.Process(target=worker, args=(3,)) - p.start() - print('【EMD】') - -``` - -输出结果： - -```txt -【EMD】 -工作开始时间：Mon Oct 9 17:47:06 2017 -工作结果时间：Mon Oct 9 17:47:09 2017 -``` - -在上面示例中，进程 p 添加 daemon 属性： - -```python -# -*- coding: UTF-8 -*- - -import multiprocessing -import time - - -def worker(interval): - print('工作开始时间：{0}'.format(time.ctime())) - time.sleep(interval) - print('工作结果时间：{0}'.format(time.ctime())) - - -if __name__ == '__main__': - p = multiprocessing.Process(target=worker, args=(3,)) - p.daemon = True - p.start() - print('【EMD】') -``` - -输出结果： - -```txt -【EMD】 -``` - - -根据输出结果可见，如果在子进程中添加了 daemon 属性，那么当主进程结束的时候，子进程也会跟着结束。所以没有打印子进程的信息。 - - -## 4、join 方法 ## - -结合上面的例子继续，如果我们想要让子线程执行完该怎么做呢？ - -那么我们可以用到 join 方法，join 方法的主要作用是：阻塞当前进程，直到调用 join 方法的那个进程执行完，再继续执行当前进程。 - -因此看下加了 join 方法的例子： - -```python -import multiprocessing -import time - - -def worker(interval): - print('工作开始时间：{0}'.format(time.ctime())) - time.sleep(interval) - print('工作结果时间：{0}'.format(time.ctime())) - - -if __name__ == '__main__': - p = multiprocessing.Process(target=worker, args=(3,)) - p.daemon = True - p.start() - p.join() - print('【EMD】') -``` - -输出的结果： - -```txt -工作开始时间：Tue Oct 10 11:30:08 2017 -工作结果时间：Tue Oct 10 11:30:11 2017 -【EMD】 -``` - -## 5、Pool ## - -如果需要很多的子进程，难道我们需要一个一个的去创建吗？ - -当然不用，我们可以使用进程池的方法批量创建子进程。 - -例子如下： - -```python -# -*- coding: UTF-8 -*- - -from multiprocessing import Pool -import os, time, random - - -def long_time_task(name): - print('进程的名称：{0} ；进程的PID: {1} '.format(name, os.getpid())) - start = time.time() - time.sleep(random.random() * 3) - end = time.time() - print('进程 {0} 运行了 {1} 秒'.format(name, (end - start))) - - -if __name__ == '__main__': - print('主进程的 PID：{0}'.format(os.getpid())) - p = Pool(4) - for i in range(6): - p.apply_async(long_time_task, args=(i,)) - p.close() - # 等待所有子进程结束后在关闭主进程 - p.join() - print('【End】') -``` - -输出的结果如下： - -```txt -主进程的 PID：7256 -进程的名称：0 ；进程的PID: 1492 -进程的名称：1 ；进程的PID: 12232 -进程的名称：2 ；进程的PID: 4332 -进程的名称：3 ；进程的PID: 11604 -进程 2 运行了 0.6500370502471924 秒 -进程的名称：4 ；进程的PID: 4332 -进程 1 运行了 1.0830621719360352 秒 -进程的名称：5 ；进程的PID: 12232 -进程 5 运行了 0.029001712799072266 秒 -进程 4 运行了 0.9720554351806641 秒 -进程 0 运行了 2.3181326389312744 秒 -进程 3 运行了 2.5331451892852783 秒 -【End】 -``` - -这里有一点需要注意： `Pool` 对象调用 `join()` 方法会等待所有子进程执行完毕，调用 `join()` 之前必须先调用 `close()` ，调用`close()` 之后就不能继续添加新的 Process 了。 - -请注意输出的结果，子进程 0，1，2，3是立刻执行的，而子进程 4 要等待前面某个子进程完成后才执行，这是因为 Pool 的默认大小在我的电脑上是 4，因此，最多同时执行 4 个进程。这是 Pool 有意设计的限制，并不是操作系统的限制。如果改成： - -```python -p = Pool(5) -``` - -就可以同时跑 5 个进程。 - - - -## 6、进程间通信 ## - -Process 之间肯定是需要通信的，操作系统提供了很多机制来实现进程间的通信。Python 的 multiprocessing 模块包装了底层的机制，提供了Queue、Pipes 等多种方式来交换数据。 - -以 Queue 为例，在父进程中创建两个子进程，一个往 Queue 里写数据，一个从 Queue 里读数据： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -from multiprocessing import Process, Queue -import os, time, random - - -def write(q): - # 写数据进程 - print('写进程的PID:{0}'.format(os.getpid())) - for value in ['两点水', '三点水', '四点水']: - print('写进 Queue 的值为：{0}'.format(value)) - q.put(value) - time.sleep(random.random()) - - -def read(q): - # 读取数据进程 - print('读进程的PID:{0}'.format(os.getpid())) - while True: - value = q.get(True) - print('从 Queue 读取的值为：{0}'.format(value)) - - -if __name__ == '__main__': - # 父进程创建 Queue，并传给各个子进程 - q = Queue() - pw = Process(target=write, args=(q,)) - pr = Process(target=read, args=(q,)) - # 启动子进程 pw - pw.start() - # 启动子进程pr - pr.start() - # 等待pw结束: - pw.join() - # pr 进程里是死循环，无法等待其结束，只能强行终止 - pr.terminate() - -``` - -输出的结果为： - -```txt -读进程的PID:13208 -写进程的PID:10864 -写进 Queue 的值为：两点水 -从 Queue 读取的值为：两点水 -写进 Queue 的值为：三点水 -从 Queue 读取的值为：三点水 -写进 Queue 的值为：四点水 -从 Queue 读取的值为：四点水 -``` - - diff --git a/Article/PythonBasis/python13/Preface.md b/Article/PythonBasis/python13/Preface.md deleted file mode 100644 index c5cc5c9e..00000000 --- a/Article/PythonBasis/python13/Preface.md +++ /dev/null @@ -1,9 +0,0 @@ -# 前言 # - -学编程，谁没有为线程折腾过啊。 - -# 目录 # - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-%E8%8D%89%E6%A0%B9%E5%AD%A6Python%EF%BC%88%E5%8D%81%E4%B8%89%EF%BC%89%20%E7%BA%BF%E7%A8%8B%E5%92%8C%E8%BF%9B%E7%A8%8B.png) - - diff --git a/Article/PythonBasis/python14/1.md b/Article/PythonBasis/python14/1.md deleted file mode 100644 index 32a0961a..00000000 --- a/Article/PythonBasis/python14/1.md +++ /dev/null @@ -1,91 +0,0 @@ -# 初识 Python 正则表达式 - -正则表达式是一个特殊的字符序列，用于判断一个字符串是否与我们所设定的字符序列是否匹配，也就是说检查一个字符串是否与某种模式匹配。 - -Python 自 1.5 版本起增加了re 模块，它提供 Perl 风格的正则表达式模式。re 模块使 Python 语言拥有全部的正则表达式功能。 - -下面通过实例，一步一步来初步认识正则表达式。 - -比如在一段字符串中寻找是否含有某个字符或某些字符，通常我们使用内置函数来实现，如下： - -```python -# 设定一个常量 -a = '两点水|twowater|liangdianshui|草根程序员|ReadingWithU' - -# 判断是否有 “两点水” 这个字符串，使用 PY 自带函数 - -print('是否含有“两点水”这个字符串：{0}'.format(a.index('两点水') > -1)) -print('是否含有“两点水”这个字符串：{0}'.format('两点水' in a)) -``` - -输出的结果如下： - -```txt -是否含有“两点水”这个字符串：True -是否含有“两点水”这个字符串：True -``` - -那么，如果使用正则表达式呢？ - -刚刚提到过，Python 给我们提供了 re 模块来实现正则表达式的所有功能，那么我们先使用其中的一个函数： - -```python -re.findall(pattern, string[, flags]) -``` - -该函数实现了在字符串中找到正则表达式所匹配的所有子串，并组成一个列表返回,具体操作如下： - -```python - -import re - -# 设定一个常量 -a = '两点水|twowater|liangdianshui|草根程序员|ReadingWithU' - -# 正则表达式 - -findall = re.findall('两点水', a) -print(findall) - -if len(findall) > 0: - print('a 含有“两点水”这个字符串') -else: - print('a 不含有“两点水”这个字符串') - -``` - -输出的结果： - -```txt -['两点水'] -a 含有“两点水”这个字符串 -``` - -从输出结果可以看到，可以实现和内置函数一样的功能，可是在这里也要强调一点，上面这个例子只是方便我们理解正则表达式，这个正则表达式的写法是毫无意义的。为什么这样说呢？ - -因为用 Python 自带函数就能解决的问题，我们就没必要使用正则表达式了，这样做多此一举。而且上面例子中的正则表达式设置成为了一个常量，并不是一个正则表达式的规则，正则表达式的灵魂在于规则，所以这样做意义不大。 - -那么正则表达式的规则怎么写呢？先不急，我们一步一步来，先来一个简单的，找出字符串中的所有小写字母。首先我们在 `findall` 函数中第一个参数写正则表达式的规则，其中 `[a-z]` 就是匹配任何小写字母，第二个参数只要填写要匹配的字符串就行了。具体如下： - -```python - -import re - -# 设定一个常量 -a = '两点水|twowater|liangdianshui|草根程序员|ReadingWithU' - -# 选择 a 里面的所有小写英文字母 - -re_findall = re.findall('[a-z]', a) - -print(re_findall) - -``` - -输出的结果： - -```txt -['t', 'w', 'o', 'w', 'a', 't', 'e', 'r', 'l', 'i', 'a', 'n', 'g', 'd', 'i', 'a', 'n', 's', 'h', 'u', 'i', 'e', 'a', 'd', 'i', 'n', 'g', 'i', 't', 'h'] -``` - -这样我们就拿到了字符串中的所有小写字母了。 diff --git a/Article/PythonBasis/python14/2.md b/Article/PythonBasis/python14/2.md deleted file mode 100644 index 8f8e8d59..00000000 --- a/Article/PythonBasis/python14/2.md +++ /dev/null @@ -1,81 +0,0 @@ -# 字符集 - - -好了，通过上面的几个实例我们初步认识了 Python 的正则表达式，可能你就会问，正则表达式还有什么规则，什么字母代表什么意思呢？ - -其实，这些都不急，在本章后面会给出对应的正则表达式规则列表，而且这些东西在网上随便都能 Google 到。所以现在，我们还是进一步加深对正则表达式的理解，讲一下正则表达式的字符集。 - -字符集是由一对方括号 “[]” 括起来的字符集合。使用字符集，可以匹配多个字符中的一个。 - -举个例子，比如你使用 `C[ET]O` 匹配到的是 CEO 或 CTO ，也就是说 `[ET]` 代表的是一个 E 或者一个 T 。像上面提到的 `[a-z]` ,就是所有小写字母中的其中一个，这里使用了连字符 “-” 定义一个连续字符的字符范围。当然，像这种写法，里面可以包含多个字符范围的，比如：`[0-9a-fA-F]` ,匹配单个的十六进制数字，且不分大小写。注意了，字符和范围定义的先后顺序对匹配的结果是没有任何影响的。 - -其实说了那么多，只是想证明，字符集一对方括号 “[]” 里面的字符关系是"或（OR）"关系，下面看一个例子： - -```Python - -import re -a = 'uav,ubv,ucv,uwv,uzv,ucv,uov' - -# 字符集 - -# 取 u 和 v 中间是 a 或 b 或 c 的字符 -findall = re.findall('u[abc]v', a) -print(findall) -# 如果是连续的字母，数字可以使用 - 来代替 -l = re.findall('u[a-c]v', a) -print(l) - -# 取 u 和 v 中间不是 a 或 b 或 c 的字符 -re_findall = re.findall('u[^abc]v', a) -print(re_findall) - -``` - -输出的结果： - -```txt -['uav', 'ubv', 'ucv', 'ucv'] -['uav', 'ubv', 'ucv', 'ucv'] -['uwv', 'uzv', 'uov'] -``` - -在例子中，使用了取反字符集，也就是在左方括号 “[” 后面紧跟一个尖括号 “^”，就会对字符集取反。需要记住的一点是，取反字符集必须要匹配一个字符。比如：`q[^u]` 并不意味着：匹配一个 q，后面没有 u 跟着。它意味着：匹配一个 q，后面跟着一个不是 u 的字符。具体可以对比上面例子中输出的结果来理解。 - -我们都知道，正则表达式本身就定义了一些规则，比如 `\d`,匹配所有数字字符,其实它是等价于 [0-9]，下面也写了个例子，通过字符集的形式解释了这些特殊字符。 - -```Python -import re - -a = 'uav_ubv_ucv_uwv_uzv_ucv_uov&123-456-789' - -# 概括字符集 - -# \d 相当于 [0-9] ,匹配所有数字字符 -# \D 相当于 [^0-9] ， 匹配所有非数字字符 -findall1 = re.findall('\d', a) -findall2 = re.findall('[0-9]', a) -findall3 = re.findall('\D', a) -findall4 = re.findall('[^0-9]', a) -print(findall1) -print(findall2) -print(findall3) -print(findall4) - -# \w 匹配包括下划线的任何单词字符，等价于 [A-Za-z0-9_] -findall5 = re.findall('\w', a) -findall6 = re.findall('[A-Za-z0-9_]', a) -print(findall5) -print(findall6) - -``` - -输出结果： - -```txt -['1', '2', '3', '4', '5', '6', '7', '8', '9'] -['1', '2', '3', '4', '5', '6', '7', '8', '9'] -['u', 'a', 'v', '_', 'u', 'b', 'v', '_', 'u', 'c', 'v', '_', 'u', 'w', 'v', '_', 'u', 'z', 'v', '_', 'u', 'c', 'v', '_', 'u', 'o', 'v', '&', '-', '-'] -['u', 'a', 'v', '_', 'u', 'b', 'v', '_', 'u', 'c', 'v', '_', 'u', 'w', 'v', '_', 'u', 'z', 'v', '_', 'u', 'c', 'v', '_', 'u', 'o', 'v', '&', '-', '-'] -['u', 'a', 'v', '_', 'u', 'b', 'v', '_', 'u', 'c', 'v', '_', 'u', 'w', 'v', '_', 'u', 'z', 'v', '_', 'u', 'c', 'v', '_', 'u', 'o', 'v', '1', '2', '3', '4', '5', '6', '7', '8', '9'] -['u', 'a', 'v', '_', 'u', 'b', 'v', '_', 'u', 'c', 'v', '_', 'u', 'w', 'v', '_', 'u', 'z', 'v', '_', 'u', 'c', 'v', '_', 'u', 'o', 'v', '1', '2', '3', '4', '5', '6', '7', '8', '9'] -``` diff --git a/Article/PythonBasis/python14/3.md b/Article/PythonBasis/python14/3.md deleted file mode 100644 index 130136d8..00000000 --- a/Article/PythonBasis/python14/3.md +++ /dev/null @@ -1,76 +0,0 @@ -# 数量词 - -来，继续加深对正则表达式的理解，这部分理解一下数量词，为什么要用数量词，想想都知道，如果你要匹配几十上百的字符时，难道你要一个一个的写，所以就出现了数量词。 - -数量词的词法是：{min,max} 。min 和 max 都是非负整数。如果逗号有而 max 被忽略了，则 max 没有限制。如果逗号和 max 都被忽略了，则重复 min 次。比如，`\b[1-9][0-9]{3}\b`,匹配的是 1000 ~ 9999 之间的数字( “\b” 表示单词边界），而 `\b[1-9][0-9]{2,4}\b`，匹配的是一个在 100 ~ 99999 之间的数字。 - -下面看一个实例，匹配出字符串中 4 到 7 个字母的英文 - -```Python -import re - -a = 'java*&39android##@@python' - -# 数量词 - -findall = re.findall('[a-z]{4,7}', a) -print(findall) -``` - -输出结果： - -```txt -['java', 'android', 'python'] -``` - -注意，这里有贪婪和非贪婪之分。那么我们先看下相关的概念： - - -贪婪模式：它的特性是一次性地读入整个字符串，如果不匹配就吐掉最右边的一个字符再匹配，直到找到匹配的字符串或字符串的长度为 0 为止。它的宗旨是读尽可能多的字符，所以当读到第一个匹配时就立刻返回。 - -懒惰模式：它的特性是从字符串的左边开始，试图不读入字符串中的字符进行匹配，失败，则多读一个字符，再匹配，如此循环，当找到一个匹配时会返回该匹配的字符串，然后再次进行匹配直到字符串结束。 - -上面例子中的就是贪婪的，如果要使用非贪婪，也就是懒惰模式，怎么呢？ - -如果要使用非贪婪，则加一个 `?` ，上面的例子修改如下： - -```Python -import re - -a = 'java*&39android##@@python' - -# 贪婪与非贪婪 - -re_findall = re.findall('[a-z]{4,7}?', a) -print(re_findall) - -``` - -输出结果如下： - -```txt -['java', 'andr', 'pyth'] -``` - -从输出的结果可以看出，android 只打印除了 andr ，Python 只打印除了 pyth ，因为这里使用的是懒惰模式。 - -当然，还有一些特殊字符也是可以表示数量的，比如： - - -> `?`：告诉引擎匹配前导字符 0 次或 1 次 -> -> `+`：告诉引擎匹配前导字符 1 次或多次 -> -> `*`：告诉引擎匹配前导字符 0 次或多次 - - -把这部分的知识点总结一下,就是下面这个表了: - -| 贪 婪 | 惰 性 | 描 述 | -| ------- | ------- | ----------------------------- | -| ？ | ？？ | 零次或一次出现，等价于{0,1} | -| + | +？ | 一次或多次出现 ，等价于{1,} | -| * | *？ | 零次或多次出现 ，等价于{0,} | -| {n} | {n}？ | 恰好 n 次出现 | -| {n,m} | {n,m}？ | 至少 n 次枝多 m 次出现 | -| {n,} | {n,}？ | 至少 n 次出现 | diff --git a/Article/PythonBasis/python14/4.md b/Article/PythonBasis/python14/4.md deleted file mode 100644 index 11790690..00000000 --- a/Article/PythonBasis/python14/4.md +++ /dev/null @@ -1,18 +0,0 @@ -# 边界匹配符和组 - -将上面几个点，就用了很大的篇幅了，现在介绍一些边界匹配符和组的概念。 - -一般的边界匹配符有以下几个： - -| 语法 | 描述 | -| ---- | ------------------------------------------------ | -| ^ | 匹配字符串开头（在有多行的情况中匹配每行的开头） | -| $ | 匹配字符串的末尾(在有多行的情况中匹配每行的末尾) | -| \A | 仅匹配字符串开头 | -| \Z | 仅匹配字符串末尾 | -| \b | 匹配 \w 和 \W 之间 | -| \B | [^\b] | - -分组，被括号括起来的表达式就是分组。分组表达式 `(...)` 其实就是把这部分字符作为一个整体，当然，可以有多分组的情况，每遇到一个分组，编号就会加 1 ，而且分组后面也是可以加数量词的。 - -此处本应有例子，考虑到篇幅问题，就不贴了 diff --git a/Article/PythonBasis/python14/5.md b/Article/PythonBasis/python14/5.md deleted file mode 100644 index 6c7138ce..00000000 --- a/Article/PythonBasis/python14/5.md +++ /dev/null @@ -1,56 +0,0 @@ -# re.sub - -实战过程中，我们很多时候需要替换字符串中的字符，这时候就可以用到 `def sub(pattern, repl, string, count=0, flags=0) ` 函数了，re.sub 共有五个参数。其中三个必选参数：pattern, repl, string ; 两个可选参数：count, flags . - -具体参数意义如下： - -| 参数 | 描述 | -| ------- | ------------------------------------------------------------- | -| pattern | 表示正则中的模式字符串 | -| repl | repl，就是replacement，被替换的字符串的意思 | -| string | 即表示要被处理，要被替换的那个 string 字符串 | -| count | 对于pattern中匹配到的结果，count可以控制对前几个group进行替换 | -| flags | 正则表达式修饰符 | - -具体使用可以看下下面的这个实例，注释都写的很清楚的了，主要是注意一下，第二个参数是可以传递一个函数的，这也是这个方法的强大之处，例如例子里面的函数 `convert` ,对传递进来要替换的字符进行判断，替换成不同的字符。 - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -import re - -a = 'Python*Android*Java-888' - -# 把字符串中的 * 字符替换成 & 字符 -sub1 = re.sub('\*', '&', a) -print(sub1) - -# 把字符串中的第一个 * 字符替换成 & 字符 -sub2 = re.sub('\*', '&', a, 1) -print(sub2) - - -# 把字符串中的 * 字符替换成 & 字符,把字符 - 换成 | - -# 1、先定义一个函数 -def convert(value): - group = value.group() - if (group == '*'): - return '&' - elif (group == '-'): - return '|' - - -# 第二个参数，要替换的字符可以为一个函数 -sub3 = re.sub('[\*-]', convert, a) -print(sub3) -``` - -输出的结果： - -```txt -Python&Android&Java-888 -Python&Android*Java-888 -Python&Android&Java|888 -``` diff --git a/Article/PythonBasis/python14/6.md b/Article/PythonBasis/python14/6.md deleted file mode 100644 index 8fd43bf6..00000000 --- a/Article/PythonBasis/python14/6.md +++ /dev/null @@ -1,95 +0,0 @@ -# re.match 和 re.search - -**re.match 函数** - -语法： - -```python -re.match(pattern, string, flags=0) -``` - -re.match 尝试从字符串的起始位置匹配一个模式，如果不是起始位置匹配成功的话，match() 就返回 none。 - - -**re.search 函数** - -语法： - -```Python -re.search(pattern, string, flags=0) -``` - -re.search 扫描整个字符串并返回第一个成功的匹配。 - -re.match 和 re.search 的参数，基本一致的，具体描述如下： - -| 参数 | 描述 | -| ------- | -------------------------------------------------------- | -| pattern | 匹配的正则表达式 | -| string | 要匹配的字符串 | -| flags | 标志位，用于控制正则表达式的匹配方式，如：是否区分大小写 | - -那么它们之间有什么区别呢？ - -re.match 只匹配字符串的开始，如果字符串开始不符合正则表达式，则匹配失败，函数返回 None；而 re.search 匹配整个字符串，直到找到一个匹配。这就是它们之间的区别了。 - -re.match 和 re.search 在网上有很多详细的介绍了，可是再个人的使用中，还是喜欢使用 re.findall - -看下下面的实例，可以对比下 re.search 和 re.findall 的区别，还有多分组的使用。具体看下注释，对比一下输出的结果： - -示例： - -```python - -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -# 提取图片的地址 - -import re - -a = '' - -# 使用 re.search -search = re.search('', a) -# group(0) 是一个完整的分组 -print(search.group(0)) -print(search.group(1)) - -# 使用 re.findall -findall = re.findall('', a) -print(findall) - -# 多个分组的使用（比如我们需要提取 img 字段和图片地址字段） -re_search = re.search('<(.*) src="(.*)">', a) -# 打印 img -print(re_search.group(1)) -# 打印图片地址 -print(re_search.group(2)) -# 打印 img 和图片地址，以元祖的形式 -print(re_search.group(1, 2)) -# 或者使用 groups -print(re_search.groups()) - -``` - -输出的结果： - -```txt - -https://s-media-cache-ak0.pinimg.com/originals/a8/c4/9e/a8c49ef606e0e1f3ee39a7b219b5c05e.jpg -['https://s-media-cache-ak0.pinimg.com/originals/a8/c4/9e/a8c49ef606e0e1f3ee39a7b219b5c05e.jpg'] -img -https://s-media-cache-ak0.pinimg.com/originals/a8/c4/9e/a8c49ef606e0e1f3ee39a7b219b5c05e.jpg -('img', 'https://s-media-cache-ak0.pinimg.com/originals/a8/c4/9e/a8c49ef606e0e1f3ee39a7b219b5c05e.jpg') -('img', 'https://s-media-cache-ak0.pinimg.com/originals/a8/c4/9e/a8c49ef606e0e1f3ee39a7b219b5c05e.jpg') -``` - - -最后，正则表达式是非常厉害的工具，通常可以用来解决字符串内置函数无法解决的问题，而且正则表达式大部分语言都是有的。python 的用途很多，但在爬虫和数据分析这连个模块中都是离不开正则表达式的。所以正则表达式对于学习 Python 来说，真的很重要。最后，附送一些常用的正则表达式和正则表达式和 Python 支持的正则表达式元字符和语法文档。 - -github：https://github.com/TwoWater/Python/blob/master/python14/%E5%B8%B8%E7%94%A8%E7%9A%84%E6%AD%A3%E5%88%99%E8%A1%A8%E8%BE%BE%E5%BC%8F.md - -欢迎大家 start ，https://github.com/TwoWater/Python 一下，这是草根学 Python 系列博客的库。也可以关注我的微信公众号： - -![http://twowater.com.cn/images/20171204192251900.gif](http://twowater.com.cn/images/20171204192251900.gif) diff --git a/Article/PythonBasis/python14/Preface.md b/Article/PythonBasis/python14/Preface.md deleted file mode 100644 index 1d7b6d6c..00000000 --- a/Article/PythonBasis/python14/Preface.md +++ /dev/null @@ -1,5 +0,0 @@ -# 目录 # - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-%E4%B8%80%E6%AD%A5%E4%B8%80%E6%AD%A5%E4%BA%86%E8%A7%A3%E6%AD%A3%E5%88%99%E8%A1%A8%E8%BE%BE%E5%BC%8F.png) - - diff --git "a/Article/PythonBasis/python14/\345\270\270\347\224\250\347\232\204\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217.md" "b/Article/PythonBasis/python14/\345\270\270\347\224\250\347\232\204\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217.md" deleted file mode 100644 index 5ffe7517..00000000 --- "a/Article/PythonBasis/python14/\345\270\270\347\224\250\347\232\204\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217.md" +++ /dev/null @@ -1,86 +0,0 @@ - -# - -# 常用的正则表达式 - -## 校验数字的表达式 - -``` -1、 数字：^[0-9]*$ -2、 n位的数字：^\d{n}$ -3、 至少n位的数字：^\d{n,}$ -4、 m-n位的数字：^\d{m,n}$ -5、 零和非零开头的数字：^(0|[1-9][0-9]*)$ -6、 非零开头的最多带两位小数的数字：^([1-9][0-9]*)+(.[0-9]{1,2})?$ -7、 带1-2位小数的正数或负数：^(\-)?\d+(\.\d{1,2})?$ -8、 正数、负数、和小数：^(\-|\+)?\d+(\.\d+)?$ -9、 有两位小数的正实数：^[0-9]+(.[0-9]{2})?$ -10、 有1~3位小数的正实数：^[0-9]+(.[0-9]{1,3})?$ -11、 非零的正整数：^[1-9]\d*$ 或 ^([1-9][0-9]*){1,3}$ 或 ^\+?[1-9][0-9]*$ -12、 非零的负整数：^\-[1-9][]0-9"*$ 或 ^-[1-9]\d*$ -13、 非负整数：^\d+$ 或 ^[1-9]\d*|0$ -14、 非正整数：^-[1-9]\d*|0$ 或 ^((-\d+)|(0+))$ -15、 非负浮点数：^\d+(\.\d+)?$ 或 ^[1-9]\d*\.\d*|0\.\d*[1-9]\d*|0?\.0+|0$ -16、 非正浮点数：^((-\d+(\.\d+)?)|(0+(\.0+)?))$ 或 ^(-([1-9]\d*\.\d*|0\.\d*[1-9]\d*))|0?\.0+|0$ -17、 正浮点数：^[1-9]\d*\.\d*|0\.\d*[1-9]\d*$ 或 ^(([0-9]+\.[0-9]*[1-9][0-9]*)|([0-9]*[1-9][0-9]*\.[0-9]+)|([0-9]*[1-9][0-9]*))$ -18、 负浮点数：^-([1-9]\d*\.\d*|0\.\d*[1-9]\d*)$ 或 ^(-(([0-9]+\.[0-9]*[1-9][0-9]*)|([0-9]*[1-9][0-9]*\.[0-9]+)|([0-9]*[1-9][0-9]*)))$ -19、 浮点数：^(-?\d+)(\.\d+)?$ 或 ^-?([1-9]\d*\.\d*|0\.\d*[1-9]\d*|0?\.0+|0)$ -``` - - -## 校验字符的表达式 - -``` -1、 汉字：^[\u4e00-\u9fa5]{0,}$ -2、 英文和数字：^[A-Za-z0-9]+$ 或 ^[A-Za-z0-9]{4,40}$ -3、 长度为3-20的所有字符：^.{3,20}$ -4、 由26个英文字母组成的字符串：^[A-Za-z]+$ -5、 由26个大写英文字母组成的字符串：^[A-Z]+$ -6、 由26个小写英文字母组成的字符串：^[a-z]+$ -7、 由数字和26个英文字母组成的字符串：^[A-Za-z0-9]+$ -8、 由数字、26个英文字母或者下划线组成的字符串：^\w+$ 或 ^\w{3,20}$ -9、 中文、英文、数字包括下划线：^[\u4E00-\u9FA5A-Za-z0-9_]+$ -10、 中文、英文、数字但不包括下划线等符号：^[\u4E00-\u9FA5A-Za-z0-9]+$ 或 ^[\u4E00-\u9FA5A-Za-z0-9]{2,20}$ -11、 可以输入含有^%&',;=?$\"等字符：[^%&',;=?$\x22]+ -12、 禁止输入含有~的字符：[^~\x22]+ -``` - -## 特殊需求表达式 - -``` -1、 Email地址：^\w+([-+.]\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*$ -2、 域名：[a-zA-Z0-9][-a-zA-Z0-9]{0,62}(/.[a-zA-Z0-9][-a-zA-Z0-9]{0,62})+/.? -3、 InternetURL：[a-zA-z]+://[^\s]* 或 ^http://([\w-]+\.)+[\w-]+(/[\w-./?%&=]*)?$ -4、 手机号码：^(13[0-9]|14[0-9]|15[0-9]|166|17[0-9]|18[0-9]|19[8|9])\d{8}$ -5、 电话号码("XXX-XXXXXXX"、"XXXX-XXXXXXXX"、"XXX-XXXXXXX"、"XXX-XXXXXXXX"、"XXXXXXX"和"XXXXXXXX)：^(\(\d{3,4}-)|\d{3.4}-)?\d{7,8}$ -6、 国内电话号码(0511-4405222、021-87888822)：\d{3}-\d{8}|\d{4}-\d{7} -7、 18位身份证号码(数字、字母x结尾)：^((\d{18})|([0-9x]{18})|([0-9X]{18}))$ -8、 帐号是否合法(字母开头，允许5-16字节，允许字母数字下划线)：^[a-zA-Z][a-zA-Z0-9_]{4,15}$ -9、 密码(以字母开头，长度在6~18之间，只能包含字母、数字和下划线)：^[a-zA-Z]\w{5,17}$ -10、 强密码(必须包含大小写字母和数字的组合，不能使用特殊字符，长度在8-10之间)：^(?=.*\d)(?=.*[a-z])(?=.*[A-Z]).{8,10}$ -11、 日期格式：^\d{4}-\d{1,2}-\d{1,2} -12、 一年的12个月(01～09和1～12)：^(0?[1-9]|1[0-2])$ -13、 一个月的31天(01～09和1～31)：^((0?[1-9])|((1|2)[0-9])|30|31)$ -14、 钱的输入格式： - a.有四种钱的表示形式我们可以接受:"10000.00" 和 "10,000.00", 和没有 "分" 的 "10000" 和 "10,000"：^[1-9][0-9]*$ - b.这表示任意一个不以0开头的数字,但是,这也意味着一个字符"0"不通过,所以我们采用下面的形式：^(0|[1-9][0-9]*)$ - c.一个0或者一个不以0开头的数字.我们还可以允许开头有一个负号：^(0|-?[1-9][0-9]*)$ - d.这表示一个0或者一个可能为负的开头不为0的数字.让用户以0开头好了.把负号的也去掉,因为钱总不能是负的吧.下面我们要加的是说明可能的小数部分：^[0-9]+(.[0-9]+)?$ - e.必须说明的是,小数点后面至少应该有1位数,所以"10."是不通过的,但是 "10" 和 "10.2" 是通过的：^[0-9]+(.[0-9]{2})?$ - f.这样我们规定小数点后面必须有两位,如果你认为太苛刻了,可以这样：^[0-9]+(.[0-9]{1,2})?$ - g.这样就允许用户只写一位小数.下面我们该考虑数字中的逗号了,我们可以这样：^[0-9]{1,3}(,[0-9]{3})*(.[0-9]{1,2})?$ - h.1到3个数字,后面跟着任意个 逗号+3个数字,逗号成为可选,而不是必须：^([0-9]+|[0-9]{1,3}(,[0-9]{3})*)(.[0-9]{1,2})?$ -15、 xml文件：^([a-zA-Z]+-?)+[a-zA-Z0-9]+\\.[x|X][m|M][l|L]$ -16、 中文字符的正则表达式：[\u4e00-\u9fa5] -17、 双字节字符：[^\x00-\xff] (包括汉字在内，可以用来计算字符串的长度(一个双字节字符长度计2，ASCII字符计1)) -18、 空白行的正则表达式：\n\s*\r (可以用来删除空白行) -19、 HTML标记的正则表达式：<(\S*?)[^>]*>.*?|<.*? /> (网上流传的版本太糟糕，上面这个也仅仅能部分，对于复杂的嵌套标记依旧无能为力) -20、 首尾空白字符的正则表达式：^\s*|\s*$或(^\s*)|(\s*$) (可以用来删除行首行尾的空白字符(包括空格、制表符、换页符等等)，非常有用的表达式) -21、 腾讯QQ号：[1-9][0-9]{4,} (腾讯QQ号从10000开始) -22、 中国邮政编码：[1-9]\d{5}(?!\d) (中国邮政编码为6位数字) -23、 IP地址：\d+\.\d+\.\d+\.\d+ (提取IP地址时有用) -24、 IP地址：((?:(?:25[0-5]|2[0-4]\\d|[01]?\\d?\\d)\\.){3}(?:25[0-5]|2[0-4]\\d|[01]?\\d?\\d)) -25、PV6 地址： (([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])) -26、URL 链接： ((http|ftp|https)://)(([a-zA-Z0-9\._-]+\.[a-zA-Z]{2,6})|([0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}))(:[0-9]{1,4})*(/[a-zA-Z0-9\&%_\./-~-]*)? - -``` diff --git "a/Article/PythonBasis/python14/\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217.png" "b/Article/PythonBasis/python14/\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217.png" deleted file mode 100644 index e11ec998653f664e406d52ba3cc846e1873af91e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 189841 zcmb@tbyOT(5HC0h2~M!!7CdNK-gD;6bocG*s#|h@Rn-$JFDrq9h>r*W08qY3iYfvCFeCr~Y%@G8^bFec+z;s2 z8z)5xVL;V5;Xd@>otcn~5CBjcjr3^n9(s&mFR9@K0DS0s{k%z}`#=ByycB*D6;gKB zJ$lly#!_qBjTRUktuE&Iqy0VV>ftck=^eaR{O9vG)8r28AyM3-Au=sF!ztlW@|yfZ z)-Dt^&x!$)IZ1K>0qC5tG*dz2wcL68NE!ByLSKY~3DJ=lTfWwPr8+QP#{Oca=`V=S>d8Zm zFFOJhRVJ-LFOG|yzNm^X0zQHQlG@Xr8W*{jlnl=`QlQ}{gK&)m!7h?~yD@5jpxdVn zr@v-e2mJGxZDc<>_1GLxYwox9tIgM`llLAl(>3|gvu+r9%K>DiO0qjB&m;Bbd0&R@;lcceZKMRPF*T?ODLOQg;eZpP|k zU49{8Wz?9RlGlmY@`T4Y)``SDFZQa+@p%gWBV7I0XwUhTm($kWz3pVZqL-`eXUwOw zV1XkH5S&_{p48^^9?TM-OU&L5F5i|v@UAy|>NM*Q;?$RmMTVkW-IHR0$IayXW+3oq zR{ZQ6fDSxZeLHu2{z5PNi-_i9PICG#s_zZK!LFA7*-B`)0w~8k6RCB4P?}Clx@8{zb$RiTu4FT$fUBepgQ@E411}JHFrj}XnS)?bW z0mR~YAAMy*y2)Hcw-0Rfoaf~U#NoHUN3%M@p&gK1zF@_-zfYP1%UtXVyre$A8s^oj zVdlO(0AK8qaY?#6MPD9!_3ZQQ2O+^?#ljE!4}WsJrGP`0DPTtOHh5^ioiJNEcwlcWB z;*e2nLT?af>fW+7M1wAZ#G%=Ap93u2r;)^FIH-saA~m)n;M-vQ13 zB6OO$VUetgQoG+Ax$21?b3E-((Hq*6fVh}E#NrJpJq=uuZo91WU!mF^*my&bjQqI7 zGni+b)wLYkJ?1lxl#1pPEnH37R%OyTT$IM)^!hf&S|C~{^c=3BAcc2~s$gN(wYYw1 z!=aS01kn9jzP6aF#uob}S? z#W!m?PonE-w~b-^^2s#O_g1-Y7I!ispTx02>_wt5{RL5D zO#87HIBPS@51TC6eIv_PT?b)%jJ=m%0;CthKV^k2T&`F2E^BXX|M4fXk=|}eY6S$PMQ;Vbe4I>bC5*xlW2^Kh_r5n=WQWEUo$In8u-3D0M=gMcrmFMLk|FQ6ApyiYp%-V{vE zKIhL#&)d}N@r@&72`=z*uz=2=E%Wirg{FN245p&>Ur#=3Y}R%I{2Fs76&4C41RDZ4 z#PiPZZlBT7T*EmVpY4+=!->ARibu$N>+eaQJlspEh#AAEeC$NTVijHIo($o#%JjWf zna_(D7WRN`B8v0x#}NML#Xs7)0)K3mtU+Q6VZILiWm~S+8=%Eypk}zo28t#_eePa6 zzyD4kPim<+Sk(P=-NjS3_5zub(JA(Qnn!tG5q<3~xsL&on3@O))lsy3_X);iwM-Ts z=AGXOB^&(YJ4;boW9=4UQlkI_K+TE0(UT1V%J(Hh6u`Hp##>CiBY|cH7k_g~d(tZjy;8h*?J?;EvNn>))WOfSvMZI{EC>9B-b!vJo&s!<6E6>MI4@ z>Q)&K!kXr!EH*@X5>#0RZ;Q5kgx|lF_u1KJc^dYPk_?c*B3g*!*mi=jBpez!9OxTsw});w2|Vd*QQ{sXUjRH~-&Hw~u-xUNeGy0gK$FCX*d8`X#A++b zsX>L#Lya|#QhL-1)g#{Pq#TO2$5G_Ab{E?szbo(ZTykQv-z-sAj1&A*S2SkY=a&VMQS;Dp3?TZe*aSlf}t zg-ArU9{7i0d{ka)tDceK&}E@#U@%#V{Neox)cfqYk$xjX%~Ys)ig@(6~7wQ1nLbEEs-P%{rov6f^Cb_9Bn35Ue6bUEGZBb>8s9 z%84JJ{SK4W000)@{J%TIr*}bed*nE_C#DnU)}my-U13)#Z1XXbcukQ{^aP} zzCCnp)(a~#ny|Ptd3W{WybfYrb!jq3@+p?0p=Z0bh`=p@lo|qwk;ikA(|~?QoLKJD zw_<&eW+OxRwrlf~{go_%1w*^NbHPMSiEAvT?sXZS_m%GNdO)aF6m6t0dE~S3K-$Oh zZxj`OctN5Q54vf*D1?DLCfDQ~)_E?-pzBMBWPtqo$H0Y{c#IowbTkQNjHcG`zoGZvA1!b6)f# zqDib-9n|ueBF^KmTGxXTf`rvr;1qqmf}d5MoL%DLd1SoDyVQn#$ECKSFO4wzNn#ws z?cBdGJr0#P-mc>1#`dPMD_sy%$Kc%-n*R zoivU^KtAprESt4Z&vnFaJPToO4mDdDua+9x{8(G_ZMgC z%T5GZ+C1(YN6(yic@swVJF^zgA++=5bvgPmq1LJJZV&jwQ}c+Udq840i1rR zFFqhf$M$qp)*)bW7#gwL6L`))EsQDEvzt0ipcYxnJagR2yav-5G#i~7oO3jgs(|1X zz8!LS4;_%jM^D-QUizloS<*DgMW`XXFlS|J8%enhf!`H|2S-sBpE3w5hVQuZV}L0A zkLyDNoU(ti+H3f?5kUmTy^N=pEg6pfO&(sjAG5~>ufw*i?Tz@i$Bh`j&~YaurnO{M z9xBrY@yw4rLI{CP-7a=tvG)^9+Ybz%&jqGVpKVj0w@nRu0e#%Y7b(Y^{Fj3riEm9!Em5 zXxr^+Psx2~Hg#l9hq2pDsdt`0P?iXV4LK$eWVz{nW{Yf*Bf>Gh?%qTk9Oa9n^a3%d zh6ASSz8Hk@BH1h#@CB#6T;KqOmYeO0b=qAg$1{1_`|tkEasbW*UFVaH^*aA0Ol?TG z(ERar_(cK!uT*FPU3q-)w(4og`@i(d@5bKR_5;H1e=}#{{^w8jHv|7AS2^Ur{^v8^ z{cnltd;fbsfctF(>c2k)CH&6+<75y13;%!DiT+=RBEyxwWIu@0EIxvi2u*pm z!Wjhe-?XoILnY8Rs^3rVFH8gyJ%e`0p%hS{fWBSe%bW;|_d__z)P~G?jJF^Y?-Lfo zqj9QkLifJ3=Hoi9k5%)-Hj{ZQzdp=1%@Z_@$pu0x7hgF*>4!Q|ch2#0^K_L?yZP>T z<{4D{UqRx?AtcW+#B(&^bL6kU&n{x!A@o_0)8f3iJ5OLLdXGttu%P>%fP;6dy*B;o zc!6n8Ye|?%_3t^9YR-?>)yg4#w%@0|l1E03Up}9IIGGTr|8W6Iww>yJ42Z-sN%;D> zC*%415#d!T{~9^~VBxRiM#~r&{$iVHZ+$`Ll9cLxHCb<}S>Rs52Zr2;2TIu!N8kwY zRh51pYlRFQxn>mM&OIN+F-9&Oxxd>=&T&BJT=5P;pkFc4N0WE&`9{Cs=iyb-)4n@A z-LKZ=$c8fJ2Y6MXK8zuF5}j57elD6{637J20;Z2Nvks~6H>Vk{Hte9G1^^g>eSMa- zU>A`z$hCN~=vCa}^W8ZH2#VKRc*BGhGs2LL`H z|6@BSq(LJBdYWw6+P(x?$FJp(FaMYy+H|+ft|PBbkwEEthBHTkW@ybLhx#8QBOto$ z`j9wnu;%%E3}!#j50}`cn=@5Kpq{c!M;dZDH z=G5*@evNN^syRLGf5Xvi!WgLid+Yy!$({pTlKMf5>7q?GD}GDU{ktNWjuo20c&h;Q zjyuiV>yMV*)sy{Vmt2Oij9seMz}3+shiYG>kEIwYgFjBKxqQ#bI+HX{nyY*BDo8AY z-!@!mL7zt?!RMvhJ|w3J;6}RFb(?bC6mbcFQM;?Aa~2F$R+IcNscaLds;XMT!ET(i zJq^4tO4Ix*54J~}EW3H|8<48gQz}pz*UhPgdz{5ulcmUNy~<%`VN+4MF8@=hkTqKngkVR0kWr}Q5EHqm*4f?q)@JvtD%QpMfK+=2aq;}(86DyVnP z5Tn!L=m6o%phQkF&?TJO6(hl6H%#^(@Q`+idHBzrFI7>XU|TcM7?AgHhQ;;oOZ>Ck zIaV5(HRaWe6IKYE3uHRpZV|-Dox+s$6cI*jGYqw#GWmS{u+=-()I^S-uI6Ijb6b6^ z@^PZF{lh1=!zmV^RgXvSc4-7;$TB?X66uxz!UQ}x)Vd^I4NG_WYprZ~*Mg7>o z;b*KT{^x;vx~hYB?%O`xtY5@&A}pT{dfM5CmJ)-MkEMFTUW`gy z2?QHBCJPDs7k_+AloOb$aeGC`mx)`RxvE*Evvmv<2tB^u?{B5PX?upi*7D;EN5Baj zl{pc^xxc!2r{M)v{;vH%P6EkqG-R8btn-k0xYnH0YqD}9?=OaE>SHf|9&RoAnR(d^ zd2t<5;en1xUSf{e36iolbmA9qy6x(DBbG#qNw{p-Cw*qs6N08kYNyOsQc2a{^d>?N zl>!F>&luGclh=)$yf37h;PPvBjc&d+Guh%mbw-2Dr2FZ9fj^wGA@%gO%O2AX(q5OQ zAqQJqMJTyeJzMaFTanbW3HbfWLtf^sU)OxO`#`Xr0f&4G>!_}GB*iWdcAPldT-^m% zpZw=f6p>;Ni=_Kss+eO%k)vVM#P`2Xe&5Y9jpgrt{xmpIHmQahG}I{56)SrF;}|bU zhgU=J>v~6HO}TJZGzhZe;I}uVbwCYO0Jq@F@W}W(G7O<#Zd-7A=SqG31h_{6-$>+8 zYKdF)#mlb$W`F;=Ax=BwNnKBTpx^7?HJ|Q20LOXs6mv%>-?BbJed@(Zi#Mr0Mf5w< z;~S8(Pk3q{UZ`cdgGU^u*-%ajpO2-QsvVzCv~aZ4$mQZb5oX5;b=(yz*Ypm*P(;He zDGl%!G4k8^^TVV6^D$eFBR>l-mO_ZO)q+M<9IREzkOOZ{?P0Zip>;0PhfqHkyh^+Oe%T_hBb__Xmy`22!I9OrGggO1i?2-N{ z4>){Rcz2>N*Di8Pla1JwGS_3D!!dmEWdbd|RD|u?!L@}58c1hjt4#0kveFwtK%liEnXDuk(zA9E$%ekmX zcjMB0X+6P4r7NSP-8eHaA{ZGI{OLR%0cN_D%Q$IcAc8|2G)0GT;PQezj0-KC`+Z=2 zz!QL@IN~54MI0|kK@5z|zQ8ozgD(ZZotIn+AX$FK_j?PqZh9LI{te!@oa-xjy10@? z%G`qV%37$)!^PiE`AbfL}&?>Y3vAdw2 zhD)=1?3xM__@Y%9Zbg1)ag(;d^(x|8eS}qG<4k%uRMx#yH_8vT@@Ln4c*Fc18r`gB z8ciRjf}+yN8b-dL_?+6}mzn|D9vB!F^U+Jve8l0@27J`^Ff^vHdtDi|T;%M4^)xOd zsGs<$6nbj}vPtBE9MeApb|IhFKPA@h=#Gm8K2x1;(^8}X)8X@5L{>$77zXEeupzk7c1Arbyj@JXmrcB~6Dc{KU7efw zqdew4*&ndP;F0w{yo|}BTApZdB)=&vOewmtG%;7$hGID!m^}aNnLhq3d}x?zl?YKN#RO3iAGMH(z-!5^(#C)g}7t6zEv; z&%Vr!h{kz&q`qYT_Y|OE{8Rw)?tent#{Uxv%={{2lIQIcEK}qDgcSn@-ag<&*y+e(Hi4S5s&;esEcj` zTm>;cDK3|XYvtvmmtNu|UA>2L#>7`?q`S8Rv(Em;4AJttX(x24*V+CDB4UR{NQbyk zZWrJ`t#<^Yk$zp|l-46$t-uKZw6`aBr7z_37j?<~{&|*3&E^`lw_uSMT}4#*w_RM! zIXT(<@%-H}Yj{Hm-E{GTnT2=h_h7S8!`_qgGvDo$M;9kN!eWVo7SWEiLVri(ADarh zQoW)b$6F4XTem8n7B~2vI7CVGl-Mg<0-hUzv;eeK#xVKuGtg5I2yq zRgV3wUYCsBWm_bIFZMZo*tg6P`b-kSA_7;v`KBr5Lh)Ubm)Uh=J_^zEPn}oys`y{B zLvAL7s=)h}LUuA#&#pu}CyqK}69)6?N+2EzSU@#((01>z;}y>_Womxuum=Y+-T93& za~9&|@|K(8!r9;KLLha&C)bj~;H!k{4Eo+zUq<9Ccd9*yhMM5NVsBl>H;9NwZtFGD ze`JXt-~@!_L;{pXB^&9KT_&?a`Yr;PnI$;QVE2#buZP-jVF&lLDX5x>I>k9d`pYf} zY|e0dg#$iU({;DEavs0WEo+ZRP0t}}zMak=tkV|X2oL_Snp!gP7D@N`{lfR{C-yWp zQt6A;D|@k1D-e9A&x3R3ab0bV*h`~b07^4tnN92L>qTgD`MOgD{%_krZlqhouRYn} z?84Wrs+-59d6AxOnW6__;`Yp2GaXk74qV`yT_`hm;EpIuQMNE zw<|-($5=ntH_?Sigx@GFLS*q83oC0mL&UtNK8^mE=gasy4@i%m!lCUO!SCl1YuqPp zD~R~bG4qcIs#v%reB&oweP5dVv5P_jj?CoDe?O-7Vg3kp_gov_7xealq2T@GL21l; zv?xt(t)7vh49d`@vn{Lc zXU#cR$k$?Oi<~%Q9xd&(;@HmG^RpUdMH_j}kJ1ZFgR$d82;_tL%fFbG!g~fpKOuvr zw27cQ3_zd#$N6MEZ~o%)CD+CQjSpWoa&75q`02 z;p3X`N;hqmyv(krJ022pl!96)E-Cnymbtu% zfLHgNDit*DEB0|@uX}5-0fo6|p`-=RQLskgTA`tukBw?zW_0y_-FYP`*lLrlC~j#p z1M&P5p>vt18#sgo!#06J8FXDnaVfeH`u=TDHCgY&hT(;f?Mb5N7>A*1Vbp6DHo@|R z-!rk*f}1`2V<c<={4DfGbpq0jE$BKecAI4f+ZI$P>K}?egyF%Xx_%sErJ-`Gj& zG{Aiewdc^jXXT^fuI0wMNDTkR+fAU(Ih`}QJHDDG+XQS194MpA%wW1UjbJ1}@bFBK zJada+VqDT9wJy4?QVG3#BY}4EFlNeLQIEiZGhBf=p-I<>D+`DM0iQ>Qqvq->t z?fY_qf<@0{pWv8arc&-^BEM?ko0I4+I8lP&+zmWrUjrD!#((w^K;@gw{M{BD8TK@M zqMHtkVRWD!t%?c@FUijUHLTEcCP}9(RHxA>(!vX-4h3tCBpl6c>MpHyd;}#e=*DvE zzG@0CUZ)nZGA`&^h%j^+{?2QMs=1IYy%o?9#NqgKf3-}`_=?UrKB;#8t5^)EVx#60 zbF4lmNX8<^P8LS(<`3Hw<6x!Bu^g8jjS%{e(VQ0*A3K@RwdP@8tH#%_iM}7pJ}&&h z9p#v$U-25L%HKdE6%;Tz?4Eod|E~F7LFo#%$6Z+#fdK1I$i(pQMk^ZmhJqeDVK$Sv zKQ6H@W2l&TU%xw7(*B#t*0&(FhrQTgvqesas6A&)gng8{<2^2Jxp=nOpaz&!O;_VC zzU8SDLPTaXf)6r(q`u14)5jB~bgTIrx{U5x>I$cfz82hSh!qUlY$AF9nQsOpq7^v3 zhnZr3{kilW8e$gXLR0)uKdG;Gl-w8MUR;3L-FoJ0f8;Xe#>1fh)nmbrTGvH-L%IMHpMXVNv0*7HA$q2nA1`m=TlM2`8@^T zPSe0;PB(ftY9Bezwe9AsnKI!NKB-BJ(Ni*Mez(iV9p=ZP&R~rV7D^^!S^RNJK|mG~XoEgFE%uP3lP}%d46Y;^aWx(RHer1xYxpB{ zr7J$rQnYYn;avmfvcSL#1fulx{QtEKHsMrK!;VWlmeVP`QTk*3)!{2(|1Gq{_>Xsn zi%^DtANm{kmyD5wP3(79aZfdHHSE7c zwlF~4gOqnuYQ6PdSNpt^L%Jp06T}BMoxgbUnrs-(U#yfdcj4~0+F<^zkg`lTTm+kC zl-8G@bSwfYu=l(=5&xwWklHRi%_g~Pwu$#QDSKvA?+u4t;hSf(_2GlA3@mFv*iEM( zd`<^^D(tP2Mqb4P^*qs=&E8R1zvhS68iwD_{$cSB$V_cN#Sg4GIHM*x0sjqXEB% zkajjqE(Cpo`K|SHD3*%SE~?2I^g$@6k_VP-ZBJ$--6CcaUhOi&B`hZJnQf_7F*Pr^|2heVN{r*)>j5I$ zs1)AP@zdzDb9F^`GaDZ{5H0W+)@vU$!>s=n&`hvd&9ndx=)%0ZEga>PpMTIrW9D9@ zUZ%!QFyT)02}xV0_2G=wi#_My#Nmbwgx@Lxi!<727bYJ(&mALO-0E!urA)ek*dMDtn zXxFT=oL=zb=aWFs<4G?mgE_;N_jIXdf&E8T)UxVNvmc`)yJt-+y7d)iZHX#NKtCKK%D z?vgsS>q2FyL*5s%ahr{mY$gvpx0@~5_W!!KZdLY!Rui7S+NX^!dh-qDZee zi|ni;`I=sj&qjRc3Ed65sjjQztXSimo3paX$G#xi_0qLysp3atP2wV}WIyl^nB$#f z2ZO7I@FQ*RNw*2R&Wepx>@m%z+^pEZ>FnqB#pstzt4~|!$|S%?El%q{T&NG75o=DX z#Pv3`f@6MBSuQ4Dk4`2ahT;#yQ%@aEkFHYP^pnY%mf)^QKX7!* z+FhC!oi@$ihXmSKXXtq9bUBE(u442j4-m&y#9d{4?Z?AQ{yNj=c0r{IA}EmhT$Sh$ znLZ>~#%<@yzH2(UOF*jvg}_W_aW!VjMh}Mi<>hEhe#-+&>ETTlj3hn&xlo1)G=-J%o|ylfb@wT9cG>cJDZ1s1|P~nBK<4nlT%e9g`TS zPTw*&%kiv>u{wXnXp%+fzuP^tAC?`Naani3SrlD@nE|@La768A`iYEY=7qjJ>0IQbI2K%G+@$tu z`SXtN+uFJSvnK51!Hwm?tvp`|>F5EulAV=x9^rR+JT#0dq z*1?atz5V#(PO+{S`3k(|kIb=d#^IJ~#bcRgBFwy7g{lZ3QYfQDIBy=(m1jPe(sDBMDaj`&M=WK&B36Ji2BS=Ayyzv=uP{#@pU(dk&%USwR?y7;THoU7IFo)q;vEhrXB@4=X#H#&}Jo zKA?%xZ+VyGk1!s?@qZu_>xwkWtCsoHvR~&1zTJG+d^2jT!iIYmG$WSX-WJqCQr73C zWfq!eCLtZ@{TiZj7@>CYo^`362SW#g)-a&!A?)ve(4#l&M_v+i4$`$u zypi8mOad8p;I;LysFaO%`*s|pD>sApTqL%-Q8^Ll%maA=F7bzk$h7Q<^;hX`Ra3#! zo}R1GH|ZptellO14YY-#LuoyQgG(5mo?rWte&3-!3Gb$frUSV{*zwx?bhu${C)ycs zg~lDk&pumCepOWd-pseGw+jLM_kve6t0qz^H?_FHmbdqNk)Ue#EW%-6v9Ak8@nJk0 zTfb7y1!11i_>DLGl6#HPv2OkaAFyoIYw}}5>89Lh-HsQH@LB=1j)*p^f+1kBh7U(0 z5_NdUr`ue+?_%^A;1qckZAxYNs(C?pXhQiDzSvYujfxCbjQ)cfW}Y=T0QVgky^jKw zaOAuh`9^+_u*u0}@g+SK9ce8CD^hJED=^)Z0QreYT(Jc#Ukd2;45BjgP!JLHdb?qv zK0DKp%7t1U{5_fAloNcJ8^3T_wB(~Rt01y27bZ_ELj;oOY^w|1>ZtU03zy4Z=4J8H zVu0u-(9c|x!D2^XLAm+_ZS;PkLbPHo6xQS|>XEwo+|?n<#8p=b&eQSk(;GE>` z&+4RC-`$^S;K3)sRgsIBn}1mArHCh?^3b||rxVBNc)6>8;@@A+)OeDGz@gta{i#RY z>&MlR&M_%hdJ?Yeniu0o7WRrv_6q)Cn*Tw@k|PE zcU-}gqV?jy#opbelFCLc2cDhH`|>)f+b$>@^G5F<#XU*kI4s2UG_7 zzIL>&*?eDyshzEDqnhl%vhA+Nd6_(JJ1 zDF{B4$?`pWgE9W<$IxK~^Dnmie^7+_cVvI~)zUwmKB|~g-FC_F9V13dp7cF;dy#96 zjyrrC+WXDL%?68UD`#dG{cz{=Mw$NR=`WrSrDMCZ25(HGFPWWI7cVsL`<8+&icN27 z=WHmhXZ9S*jTomm4&399<(s#%dg+N!vw(oc(+Osd8Wd^MPOlVSG~Q}KjYjF$UTp~s zG&ttpVDaJdiJDwanw(!AUg_)eT&IKh5ttW%ar{~Md30v+17R3*?-Qh7hNCSk*9D(k z#Mp>hdVtUtMjUxepJZC6pb_d_Ib8>l#8-B5XMcKM*?E$Psa$!JZ3T(FOrJt=IyyQ9 z$Q{FFyNdoz4=x`rJ{i7OGqb`-g(pGa!7zUJI;5HJk2L*7rpD=9iAHf}$t6*y z;_gR&+3JNhh210K!=;>MZIWQiP0`-370DbMF4jb*H)=HA#I4}nggxA_laY_N3zt>N z`rod?uWmh;+lZe|H#}XxEPtCXUdAT=&A;CuC;As3_E)ZgOiopDpA(GVjvw){OxEKu zxT*uPlTIh_0s*P{LPqqec)joJ-)BV==e}(D7`_n}c{V@YW=Uka?7q;kG*Hz*Uoot3v2=yWkA z#h*+%%~RO8cyQkG+$4X1&`<5olT7U8#yekhxkcc)G&;T*7tNP!juID7;Z7{I8SfD5vuM1Qs0YRq!<$k%_jnpZTWbJQEb&6sQ7T{DEWxe-3gvA`eH7zxMMWI zw`mCt#fW|!3clIZ{m|6`04|{QH4#a5EFzEaq0sGl<_mi6gq-t!1RPH1{1=K$JRiaN z)nZAAiSvE%aZ$!aHbziG)pSm969pow4CAdgIq z`y<5gmLV1la`R6f+Ld`dffc0NL|!#jkGRi*Iy;H31C%LWN+z}1h}pFzZtW%kNYgV_ za~cFbjKUdKcjajspCnsyAgn*Oc(>+se)A#<(2vp-#^9S7(K1oULAME2Di-7t(ZjVWK9&6U*NVZ{6z2A?mU{hsM3dyNmH=T&l` zLe#F{ZhFFAou))np~Mxt_a&ECAZ(M_Q=7uoP2AU>F%lKEY#;Ajwc;&!P!JmP_`u{Z zhRsGr4=h!0r_S?QM#7=6-zUxl9;krC?lUZ(#xGJz6@KK=`1uzU3-+>)njLT8LTo$r z{&?6AIb`Hk8#@btBrSej=1vZ*>?PJ)^on1oES!}%@FhGTT@90yT>7rG{h?ZaGfd~6 z^7BKT`}y0+!JD+$-C-VbQXrbQt$PW=#|BRJHdq0w`;HUT-{O?rr|$(x4iR5b z#veKZ@y%JuDx!TXA*yx7Ef4xS`8CwFDC#Zcx}%AYo#2ol)gE_DA6H3Rz~Y8SD4!E%PheFa)W*PhEgI#16fMVR zY|w%~Gp*R6L#S)URS1ojbndc%k2lQL@{EWE!g!8T~Ih3_W;d9}FXv1D}# zJA%b|e;lm=v{GLeamOtz>!EVdK}>o_bymeHOd=W`LHC2hGeinueHWV{r79#R3B*7< zx}*lvF=d|2r8!O07$cn7yr5MLw z_tC?T-&p`{K8kyAg@e(SwP~hWiFHF6@KHeoYUS^vu%Kqng`wN3OhP|RdU9CB$r|_v zFJW2oi3bI?|X{>YG$XS``$s2y@)qW8h16EqxksWJauN4| zx5w11R$Hdi6)jf8+rMjE*dOq893qhP777E7xy_y$Vgrb|y5kFM+j?GPCI|7Jq)D%V zR)T@38k1E^<<6N=H9{B%1C7A^Cj&0&}bw2qK>3e!liz(7>2$uMxty{VINNFE`FGt zVZa+R6e%+LS@_zI-=a>~&W-B)btFM7l|$TGB{HqP0vQG|yN0b1UN2m-t%-B<$|Q97 zgoKbP<}q&@;pZ!M+R!kC44cGuL1yuukH&Ad$ygmwCehQk3hsGtO#}=qYDG`WWjvqy zwV4h~Vt*fs5}*b1#~WF6R8!hVXtxHrm}hQ!)a!B%Dv^s_&n{r(*L!!BUSej*bI!u9 zyfaf4aElOh>gqR*eM5k0=E{9yhY^%6UbI1+2WQE_D-^9cDBiuodFKVb9DHIr$MbvV z;e+Z^p#|M?$XoK4eQ}2k_kFg@l-Jo=EDxd%+SSo}q+~7t2`zLZl1wi?J9P1^Q+W%t zexBj%NK;5MEA&67-{2Ggp)Eo4t34;dh;P1cNixeX>mwvE`HJ>EnY4KW18q_EG7A2}^x*c={?K$}6pfMKBFyE$0446jOckTjPbf3!mq?QF zggdPflH{MvA1sV_yY8MT{fRStA*lPbDL4z>}V@{ z@Sr-bWmHXy*W=EbKq_&g4^klOl?M_h1g?014+r>oVZE#-$fV>~V$enL(LY6^^z08e zS2jq$(J-!#2Ynz#MhhrizJz1=>co@UElEAXPP6kW$?G}Ih_`EqaS`W7C>Kjux)=MBpzg9PC-Wq2lz|AuI@R& zgmCS6q4g`MVB0L*omPb(`=mFAImgN~zL>;YaByeG{Nd)f!D^mysnyAh`$%d`{roR? zVS`tBfzpp_EJFhtpbmXWwMxdrvJs?N&Q!#*rlYHIk6FZw*eBUY}v2kJeCTUcHp7sAsMw;p1?TBq*OdI>jY$(&&R zB-1Fh#0ZYqV=Q}d3_tE!l<1+O_#CXmi4gtH%miY88%5{=i5V%2H!~MoT_)%4`epf zl02N6IQP7HI&+KJGg^7of4II5rr-0wC&|xfKcb#Y=ELVcb^SZ*PwHY*wkb95aEEVN zH=ch239MQ?V=m*6ccJM<@IIXq?UYI%Sf;N*ZImq`F(m|s$?9tTaQWHKMdG$xdQ5q! zdLO96`O;<{>6!NFn<@deg%%*Lq4@O2^+0_0({dsw*xP9v`j14&A0{AVBrzD3q-x8P z{~bk^8)o(IcK2NA-gEK4q_}AckUud`y zJJI)EU$sMz?9{S$_WmcMyu!K{7oS<>MwzWoND^NiiwHJzYC_+W%RTI6aI6%4>RpkZ z*)7q#(@hf;;PuUzU+?0u4_{*vBXU5gX1KlG;bF9?F+As9_vBpniXk3SjubKQ}hR&cF4>1Kh3g(04XVf5QHg^8UO-&rM=d0$M9i&i<^}%R zW4L`}k)oiV%c-(b~?4z|D_qNPjF(Y9!W8jAn}3oQlwyeSO6??@$@2i^^B?#dD7$v%~IS9=kd# z-|>awHep8rMh^AuVA6DU+`L5FP>O``uVoA!5|g%!JH|!S*_7eL_nu<>mv;9LtE}4L z4>4E4^&N+#o?ld@u7cyb@Til%4R=z{cdE{lXgpEWzd*wRG)^bq55Voc9fi>n4IvWS z%p;ybnGDz!!7EONz}JasC@1(O8_f<_LoUKR{#sECnhVOjWYscH&3sY)wul?5xZd0XC3IjEr9fV0#2y(Nsz0Nd5#TfJ`t zDjHd+ZhACf+T~V11@t$ssw;dI-3Go_SFU(b0?=iyI^nNsuMs1niG>4Akgazm3hqT& zVhBI{{?mh_LbfA3B78@lS>2N6vj zxCzvpfb;r0lt3R!QinB$fGVxkqHh`eCtmzBW+X3ZLuX5r_Z1<>3btS*2Vkx7HFY>$ zTj$~5-)iia^Yl7@`I$W>-I{9V`|w?#&v__MD!!XlGcao(oh)xa&<-2RdwZTRcgLCZAvJ)&pk^xB~`#mi_4a3iu zoUyz;&xp|8=kJkgCNJVh5C!h(y)#|5C5`9?eOqFNpP(*B>Cimw>R_HQ?P!&%@AQt19i5y=@9mxA7y$LZX9^kg_yf^zh&=k^t)MD z3w}SK8fKe9l;`hz=oHTOIM!_zFq!D~@iSj1pd`d*$|{6L?knH2`gWi3E$aea&iA4n zCXJ^eK~3)bDW-?6?E3;9i>*M*--D_Yx2huI0tif;18nm$d5m}7a&z6O{wU&3P>g21 zI=yi8R=+dGl9Qb$j5Az{4Mtvn0C(5RS8{;0icS8`pu8EYV91)yvk9@0Pq+5Wp(HX* z!&(?@mRQ1{_QDWuGgktXJ%N~F?c(|$$4&13eAqo^pNRhHGi^If91iR@ zobjEx*Oqgs3Kj(q6|&B&u7gW9GThd^0>rZAYMtz&=w;BFqZx+z6KCZVM^u*QtuSlQ zEwsQQBwA{0?9d7p#zJ1V9*^)mCAOxiKbL)=ILJ5{rzN0==+5BJd~-z81@O^$C;V$; zRK({Y^IRT$yku?&+MpSvd5N;@CeeYg&7G7?Hbv~dMc6=1`|e~b{=O2Q6a<3U_tN8= zR36fb-Z0P73^EnP-}tw}{n!{>E&GCbQr#SvKea8gA(YI#NjbyY2zA_Q%vnW+R8-|RAkCKirB8myyQ(^ z#wQ@_PQJY~)eT9BI@{%~&I6`c`PdW!$!##wYJ~oH4y~KNI}XLDmY*4Xdplj>JEi>c zMsQLS40DKsOVSyD`{}|@yCn{NT>hO;ZMQVZW$$&2relcM@7({v*;z)#*)44v3r^5L z@IYfhLU4!R?ru$Rhu{t&xO;GScemi~?!n#N=ixo)teIIe-&)^H|4d-fy`SEDSKW2j zRb!pH?<>Ebh1_P`An`Rk3(1BZdDU*FJkEsj`-Q;|1oQ`Dj$w+mMQTPk#5qVU-XRCb z7TR)f97ekm`OdNlu-jM#H9c`B;W-Ps6rC1K$D~TU;^0 zoL|zPZ^LUea0mWag@f z6rAz8+F>5m)T1JjjDR|?={a%Iaj@ifp?bnCgq(~>bDFRjWeP~hxHwuG@|l+>H|5sR zhpKSAurJ#ApjvL-m*03jvLWrRzQ{j0(;|kS&_uT1VI@x1c&AXJCiY0U*dDoovX1w- zNm-hlUU^rHeZrK@PaG(q+8wu=(!dEcUVsBXaW~IsY>?}=ssE~4@ao$LgfhVzKFKaf zB<6qywRi7VBim;N2G@c@PHi4Uux6UKMHt~R3(Kir#5?o2fg~&Pq zLz!@=I**fQctus_yIJ^3MT0v0=Mx{bl&vW2*PgC2S8tI6>UgnFE}$L->u_g86@7u9 zrqJK49-2bL+cm>(v6y%66P`ogxsDzoEpq+vT{Qz|a=}oz{SC+)^@`=R?X-&hL0gEk zBRrRem^lqAwo0BCU5~=aP4|g+#xuaAh=a|)%$ zJSS)}wYYe;FwyC2;9iJPPB2WoX3Z|`fpHPlb#D7@cNF%>$?0M2-mOa-D(*GLG12P@ z1kxFZ_zM(V2fC(bWmN2faT*TCcF@qn#ow!Z)FKXtQB;N7r?|V& zaBrl!I8T};7jZDQ6_?SC`X%f7w7rP<@)_lAY)(0`8X8DtEj@O(H!!%QZs3yIXfGmA zMq6{jGj@ce54#~EsZLf4&Jqdo2zi1>CwN(O=BJ=Z26b^d%x_9qx(2MaM4vDr$$u_` zDsdwms%uLoV*YwLO$~|~e2C+3$dK|8E5G5Fb-Tsnb?poC>qtZn7gP&WoWGM1nN(#4 zV+`hXlEv{8VHk!@TvU@6r)RwWN5{olbDZPlM$9x+h(98t zA`RyiMUtH{h>N|@sp+cpp~~%$;1+r#ZxSM0tCceoB=u*QXSfp9J$>zem4m+1{pb=n z@bzt2rwo%F2Qsijxc}Ly33Q9JIUUcvbwB>|s)6GJA~j%UQD zO4%+x9lyl1+fgLkq1d}uUCTsGPaH!Z+v{=ymo^jDmIL+Oss{s4Opg=fR1TfzXM|hx zh2LIffO!~SIKr^?Q{U48%nAc>bz(MVM-x)U0Y}Y<-cke8Id!WIOQS+nd9M6g`=F&- zO@d>z$Gi4&RmMdQ`=eh3Iv-RYjT8ozfaOFmx6~>yzP4)amvwK+>pU3duJnFFh!rnakl7Ocyvp;GR#2u z0N~Y0&#lZ(o~dGf7g4J$#q$7js5~=-5yqF6;bA0?{XigTpFP?{`iJt-XdkHz4(IwY zS0dF82Rc`R-sRcwet}6N<%=CYGTd$Ya$VVOIn9oHs~xQ)0q-g+N>!=8{TE)<+VZ8V zIqY&ve4oY60P<;fw_K8 z5E)1a?1w=p{{N9A8!h3f2Dh_S|VCh*OXU zy((|lT(0lCP>H$wG}jGG<;C7s+RBS(4Wqhe*Lxwc= zIM>$Zc%p0NI0jWz8g}J1nhH;$F4FRh^Ns@j##TO(@72hGS$(N!v*xaJ4eht1jfv*% zQRbA>swnEP)=-MpTZC@29Ho{#&;aWQYBM{2zy&QJh}b!If6Hg_gNRvdWXV^|4#4J@ zLW6weXp&%}!43JYA1^BO^QZo~J@=4c!E~+DunQ?UZB&6NF>PtI?53RAC`%Wp5>7#A z&CP&~wjecb?i5-sgtT%qbQVQ%+870T^_x*`?C>r(9^E8i<1tlG=RjHnJRG)!rpvi| z7`P~O%8K>dd(mA@vLFYhxLef8tCbl^))hAST1O*MX=9m zO!T_h+81^FBe}!E6K5+AyC7RwSWc+-J-Nm-F;l3>9GaaVxCSylfk8?>3xloiVrI%d zSa=!UDHGoM6T!l#wz zJQ?iQKIUIa>@jV8I6n}6NVG<~KRzP1D^fask2s#`3JdWQ4ACn(mMw|^cVYWp>7zHg zKP}NClV4=`L|R$GSlZcV&WFTPl=1BOk?N*hn(S6mDTO8Mb9A&yM>02UU%3izdwu6L zqEW8Zpb^o15JP0%Vc>iR??L{Ek{m8ABKnh48KVAvfLpPa z8hy^vAc4nC0O^5VLyMHt%gPtbn9ib$8ugK<`L>;iz|^Yvj|I-4+M=vszNCR0x6wZL zp)&#xl4m;pWW!7Ovx!?B6|@Z)_b6yv=HtqSg18HI1C1F}+LwLf!n)fQ^v|2!^nQZ3 zoT_i%Xe6L=iGCI6Uf_(%)PB}=JnEa~Cmg22=;s#+a-VE3oD59b@6k4rJRFEMcW6rl zO_L_=P@0PFaediGf2sZE7T1lx?uuGRSUN8DHD%z;{xhP@LVdilcFhU4YtW(bIzq9y zAv+d)qr@i?N{sg^GBaasK|hGa1HeHOOk&pUL??11NK$KpS&zzH{RQrwREC+<>jo4@ zbSPfLSMY{YBXgdE1qzuq-fNs9z>cyQ696%rC6qb5op$AK#f}Ql#lC{qmXc>OQDS^l z6BKX&FxW(WZ;q73uNR#s(jo&SW%oy!@pTF#i%IwH?mMqz&g#BG(*KgYOpEwoCAPj< zGv_Cj@;9_$E%AHi;D+n16gfdK8(ZmOKikHy&e_mlr`=lmv~t)3#TI-H7p#%-0^KH~ zYd{_50esPs9YlEewn7-I z??n)*5C-8J&7eN4#`O_#_TT(kX`fyaBiD>&-M#N;>%CCZN}78tnI7J2T?xN2DTpVv z<-6BYv9%mbgVbvwwa}7wwZz1#D`ur`QjtS!Z3{wk7p(eM?VHkkcfZyLaG zu_z0Do1#+Y0W@tH17v|j3no&BqWS7Yz#>6%z|cvXAmiV}+60r6(IOq~jdax^fWj=h%2~ z&&vJi3{legd|3Fil%eY0#Neli?9Y#sj)a84v-d)G3AIf(s)RElKK7p7hs={ilf=^w zB`CrS$URe^=^JXmd5(%DX_}2UkPzRWfd&xKpv@R^qQ(g|_YmwPxYMR33B)oJz7j58 zgGL*LZhF*M&pOUtL~ZOyGB!fWE8Mm z^b2E?{fInCK@mzG)t40-8|7TnX2yfGvCeRKC)@((*(Pb1ic?oD$j!7X07lMV zUBO6dJxE31)SZpX*%e4bbvwH5_S|r$+5bU5HMaTkJ$&ir! zSl~Gid{Rpf99PULjd^69=!2g zF&)b@P*4%f2fgqa--6(8w~+r6lOoUyXZzoQmH@x^U!WHNmne~FYb)pJ@#2>Ql+n}i zfU)6S_{+Q<&L#QB;8n1N=hX00Xu5VT+pj+KZ-kd`F|qzuY2UkgUA5z;;I+Wz?*r@< z3#<65QJPdxb*11Ks%~B|}?~S+VrI_f82~*%)P*U7EgWTjkx3hD`|w&pp;<&nY}+trt~G#Y?)@^Pfn`PImFX0JXeZDWN4- z=F!84#|Fn(DnT)tSQBbec6>HwRi9dO9o_IeilEW-OR&m-LxWHJDbZG&E2kg?oBCK= zr9%RJP(aLfH{-R+Ny?*$5?mh4V^HjZ&7!5})O#Q%F}Z!2YsGOJyyxgM4KZggXkr{X zT%lYHWc_sQ$y6Q>lU%68=v8!BA)s^FO6~LwsD5$60JV4iFr}mby{wO*KR6IYY9t+~ zD~vR;=jxtfL0|Fm@NY7`ENP^b&FnpYzm~nP9*=hzb`oJG_p)x=jQ&hUq+{Ms1+OI%v8HJ>g}$b%}>ml^qYIm(#TSr68AYraTs-fe{vr5XAoV5)c5_^ znRS_V_PH*0?Fp;TTN@y4sHjTjdzB#CazRnk43ASOB@^8zf>zPVyry#Mj-rQ6mWPc+ z{U-Tn@1Hj=sP6iQ01%Bs_yjV@oMa!e(72=qZa?CZxq`(W6K{I1oJXZCT=6YAnszDq z;`-+gGS){eA2Ow_Rd(&lbQ<+y-zBkI%g zi5ztBh4vQzJd=R++Ks55VNJzgGZ8K8!2mh718yb`?FsP%_?;%kI?}-9hjY-L{!Lig zojZ%UysAL&9(BBt2zgw+ztxn586Ttpj1mHc9rE_l6)RGy=q3xN#Q_UOiCewzyK-D{ zK0dC@7U@R{HMAM(dx7V-rs7rWF;@R^`{?|(bv!pHX7lm3Wr~2pqK6#k9FrCSdyO(a z)BO2y9DV*;7Gg;*6dH!%80fuT^sz9sudeVrh@xUoD{=TCf@+ znrPS_0oSL^3F<{hx$9n!EL4D{eodG7hWuRIg^l zCd!O2*sVDkQ`10plAOTK?eBMy5@>AsEeNiNnU1tp2xO*|^4iv#PBhSXvT)>=^Oa)R z!gq;lHT|ev0@}jaD99YW8`=tAlI#7AeEYp;YczA7;Z_0)Rb4e-@Zt!Y30E4-p(Km2b#9Ig9i z*@rF8otwzVkZbUdN+0Zz&2&3|-D5W`pX<|=7z`ge(_gEom&q?}2KkDIorl0F3kQT| z9K+D8a#w=C{U%uGzbx|yBwJ)kzA-_F)@RQI>o{ZJRnZu%?4a>(-AkYz$Ics@`cg!V z4~v+%vo*pLEU^%_>GYg=^3KUuR7h2F+rAvnAX?-^+q7W>E6hPQ(!X7;XU9Rq}ickA|XHigJ*_O1uRDH%lxMsJ8I7GwYEG| z8Xs-^b~B-r$1S&_73gie`g&)43|Lpp>ypmPw2K#t=@)U_^`yT)1^oZL2+{tkTxviI z0@3ffBu6P7`mieZIP>ik9xwxQ9UM0aI@G#y|I@3GOShwssLd9z@TtP)kaJo>6--5;g>ZpbIPo-0X1^_6 zgyGVz3XbsQ&&JGN^KAXr%7JhwUrEYU$vp%;!M-SG-e+=WhHj#>Urp^>RxoiqVZcLg zy`PPatA&2`$NB6d0_DVD-;LC=WxA_0zq#fcu`QuSlaln7n*?4nVBL6 zr+DFBPikW`w?h0fdUD^ZMzQ%B6ihs3g&7Wly0F+N!xqrBUn!BF*R<-)FC|;_?!(F+ z#9@So3UBrP*a^jg)tm8-_4`n?dS#*OLMT{EE`*x$B$we_QL6>mRN{Joa% zg`6p%aL5l2DQ`F8#ysJfU17ryXzqdEX!{{`;WfK#4)`GOfJG44SdXXL-x?IsozRUb znDI#;kTIx%nsImRWSwkh(53cV^`{7ni`{!^nS~z;47&j9Agka=JClceQoGf&%*On;YTw} zOllnprs)ba$FH4*hyEvumY-;j%mD9po$t>=PuH^JbwDQ^rv;8c-&lyCV9H<5odUw1 z0DB}lz|0#rNXt8lih_Uc7MzfU0!3$E-HJ?vK{P365YaE_41*eQszIewA`j8+KO|g8$_n7*B!feQKf=2^-cD991!2e0G^ydML=)LXEi4A zo{;3InRVUm`;WLgsH4M-by(PX#|AS-YSe0~i0I`bJv&2G6^NGArx-zXmr}bn{dEh%M3Lm)~avVp~a^$lw zquBJq7UxQ`7pt;2q8}rjQ4w!aGrpptp`tO%#iP`eA4FWbM=(~mZit=lhTk=6V@U*^s zcmFAM#Ra1x{(9F-3vIJ|U+1(1D)J9MGr^P$xXzx|6=EN8^*(NI z{kS6uPjt~caK89F+ZImJcWo~oN>C>Gc;m%DhOxRR_u@a4hVbDRZfd}=$p^${JfLqh z8fn`?b#bwjZM*018pXlZ$?9;E1Il|Iei1DLR<6{c+)E>aWZRVx@1|Q70W7{6X9vqWhm5i#908tGMzulfpoYMhf(dY?n8C( zF}_9ipX@?yY6Hgc3+^I?Es+@F93;Fp(p`xjx4<^vJP4@&%?a>*3C|n0d^B z6)a);`$h$Pd({xW!NLA{ng6>>`v2%Z`S<_-mx#yjE1#@)JYG_ZYb<#C`jZ26axqhr zRCHGJh9BKF516Vm*v)ufvMyhTkcPlOld{yY2$(`;mj~)%>AUuf;N145-yo19wO8%k zqWI2A|28_1(I4fh82NjTT?EImd)1gDcZ@!7EmFCgph;=zg5x`9bnMi-yIQjpA^OEdalKUL7*W4( z*?dyj48+7?&-MEi3p&4)IYk>23CmC>tyZ^}s>9kEq}u)NlnO^HgS-{fasqbrVbV|E ziVN^Fes*n>0MI2x^_Db)n%R<9xSutfjd6(6Y5(sg!eTxzl5l)tolenKn&#a+!E_`2 zL_@u0SXp~H4S?NgM%pL78JSe~GM+L0;$z>o&MLDx7xMg6P>!cfBksR1V*i4BjJ;mA z1Wq~;y*^=SwA3Q@Kxulevr)poyDeln0;%t9(#}}ww@3KF*Hc2YN^+fi`0mi*#>)yt zibljY>hZ015XiUon)|BlJ;!NHaIv{)4Md7ulS#4KV(cPq!%Y;3hO0MglII8tleUZP z!!OQwxx4gE7g_L#)AALkaI=R=^`NrDCo}_%sl882;(f;A-=P&=#@b=qn2zo*sw5Rn zs~w%K0k|D)q20$&BkQrLKeLg4&@v5XwOk`H#T>2vyN{Kj;*q^8#^-b12tBy6Dk2i}#4;SBwuag~^S2=^KIQ>P3 zo~d@hiY;NP5q~|*R<5Hsk~R(vb2KW#G+Sl~a4+F-qM)w%L;5(G_9j!RyFT9R zi~abr)+`Nu@m(b=Q$oq~TPW+`G7Mi!kZ?RU6p&XmOjC2{BCG3>D+w)|9NiyG42&qP z>Vya-xwG+TP3ReqiDiAM`G^yhiITD}LCcAURC^Y|Mb@&hDNO=e337#n~Wx z&x&Wzrb2z&ry=~A+2hCLg6!{xu{oO3UEW&Y zocui7`|eb-Er226baLLqO!_f!Xc>m^cYkeSbI<9(nfp%^QT)>nFPz0Wrr$h(#til$ zRds>1YE%UT{_j!hTfbrwtgtf}1&Db9$IwUWXx$m-nb1%Bus@j1{0Vfg?r;1JFm=o> zkf%`w@z`mn@7S^DArM1&L0eG5AsoCfDQZf%ejfj+b~LWzxKEXi=5*?H<6}jn@Bvu| zqkwT0{ETU(>ue_NiR(H>I7d7hCeU!JFkqpUiceX@#R$$)0OikO=^6Ns2?m?>m7woJ z+4Mf%yr1eKKYWP1!ON-Fxs{a&;23Db$aJ)l&y?-5uh^qlW`{HbWAsMBG&a0@1!ZVjR0^jz8~uxfzv6q<{B&yz^p{qb6V&&);b{6 zG2a$sDO`q3^n&IoHbv)+YY~dwdhu17yC2vrw~J)%3U?q31tmR`)j;>d>?mrOYyk;p zV}D*D5}g*Ss6_wa#^q%iwuU1$t2in)CaF!7pm&7%d{uKqM~V-wo{``SxJjmSloZ`ps zRL~en67#{2?A-v!jL#ene>0KeGWhe#2Ua#g?-tA8OK-Bj3NJOxdkiowyJ!-Jp>keN z-FcXeJO&D!Xu40K)0-=;G4@xc^U~#awJh2Ii%?o~362W3VDA$de6ma$VR+~`fY{WB zj&%M@VI+Ui(~Rqa>D|5f8JmLe+s5Biv`CXHQYRr^FJ{L2voN!$!|ksFCWi71FKQ#; z*wdnIPM%|D`Cofq(LdNSw8TF!_4wh$(CZ1*hJi44Pbhl8?-xiZbew}e4iY)UMNwIk zLevY97*JH!MH9SRWg`V`T7e}meLGE+?l5nQFP~b9yh4%j!(%Maj9hVUj&jji8Gm&$ zeRS;k2zusV!}_O~A+;A$|SdVh#7cV|V* zY)E5a$FZ(2BTjd22!t!c1mlu;c{ewA6~r$|%x+6G z*`%XwU|dv0R$v`X!r!0kYuvo?WO=vghPlxg+@*2UMawZ*f+9M2{pHN%jD=a-l*}pk zaS?nk?Vm5{;=FNI<>6jJ3eJu?)0KR^jc$i+t6e%^-xi2O;PpovjTNIjSDZ}vl_lwBVsNqv;ifl3- zit$cR?rfE+bR7MC4rf-JN1%>nW_;Cs`L&G78KwCEY@PU`V%B@ z)k!zPAW5$aI-x?Gcky!Qo(m9ySL319GowpnX9cIOJk01G0=29c&!`yxW}eW`V5D*$ zJFBZcFG7D$t=zdqtk3{76c>W{jp}0il5qOFstUf?+Egt9JDh5>U_1 z7+4QbuFY=33YUwfvg;O6c=+SHO%$tb)GPO;7Y@4n%+{520+(URI8dpP} zBmKwvJkMul(uxH=Etp1Rq{GADXv*+X$Ykb%lYQP?BY`Npx=eq!{k&2TFJIz)Q12KE z+NiOB`N=3bim~ifAvgY|zyN*t$+|~!Q}tW`?nt;m<(6(ixFkmOvEzufv&-te<}|H} z!zEkNsVJS|RU0$A3>#VBAO|e^;t5Z|#N)KaP1KQGv8(+F@X)ml(Ovr2n z$PJsB;P2Uf*Ja(%C|($Dk-`Ly@t=)?pwaU(T_vm}wMK8)pEz%WmOgQw2zUs1Ql>>7 z>8tdS4cw1b7HyXAif;x8fSws@(y@v>$jD?tic@)qUGS{fH(>#^3u{RcL9A3FT5OqX zy?Ph0%1X{-*=;1?xKPe$2a3n4hrn@v&*=#_X_~Fn!^InPKf4IcLvx^u zUd8ACLX83rvS1b#-eovFCR96!Z-@O3E=hY@m;w#xu5bPI5EYBQp{Tyv*LW9Igf^6{ zA8wS885k|9@+7&FF_2LKJq-a@!?3Gs(i`}D1}pi%Z{~Nzl?DaU8zdB7k>W{WG(9Xh5+UDkF0-y^)eq=^G|B$ySDO% zdc20Wri6BA%RC;E9G*RG20CTF)0rGzQoK89hOlSS-4sNiYpY0h_m1^!jCpy+SH+j} z$uMuQbMkkLh{yp`G`QDFOm)R6yALc7NK21S^{?_2rPofj*AeoF?wZFvcxZ*@4kEuY z03qK_QzR+sY@_KjMm12N(f;xdRTyxOWeSgsQ;!os*yAjuMReG>l35q0&Ff=hiMH>% z0+pDgcNtD{;1JdQujc0gF@~r9JWj(hmC?z&6NN>m}l`| zx-J~CAK%nP(Ox9;(;eJj;)s^w3y0zZVc2;W9qZ4Uj;e7d8Ee5ChI!FvBc9iUOG)=( zTNxw^r9J(BBQSd-d383o7v3rmyeo3^04f(C^NT?DipuJ4e9xYE3~fPN!$h->k$mr0 zEz>%$jlCLRto9d&=(=e4UM#!2?Lm@w39xtdEoGqmuGeAn9|R)vf>*udbt;c@=U+GX zyI9l*+_&SoeRHw$mDZgso(8_90?_rR=bU!-Og3%F`>k&gG#t=BHExdOUgvAlciD?_ z7|m!i<}MH6^;-Np07@l*)T3PHm7iG62{`3RewSA<^BIet_PiT`T5InITnc>v+x3X5 z-5K79dVpQsA$tz=62>;tAby&&itg6^9#%ay)4Q}X6F^S1e#_MxH7-PY% zo;r#Ur@&#fP^74475*3-(b;167%r zUC1szF)!8qzI$aU8t}V2BJ$vrHDfKb0N&Iw3))>)n+kamyZFXGTJumg!&qNi&@XVD z8zW+tV3i2<0vH)(EkQ+_7alvU1 z;1OTD=%*1&yTp#vWxG|;nRUjvJUkStqn5ZaK7v>N^WK=$qK*O|%nUx*qalbEP5v?9 z*oF+U`h+s-I3wr2b4XE`8p1+_!B!@8jttvg0jY~QY8e=xrrd)kZZ!e2kvD-bYKDTi zf;rq?m?W@j_^nw5m-6Q!lLs)R{!{2zO=uqarEL@#%mdRgp8c~}YjuI&=dqC1M>4s- zXgtr4vh)t*VCCnfD|z9#2McgKwsg0$1d1pE8E+5&!A5q-6dTE7fu(Ty=y;odwAg`qkO>`^ zOsxd`uzE-&+)Si;wp`PY!1Sp@@{vCewdLsjC7fB(_SNZny|SU%1r?9PPP5*3n`0; zN36M*D`czMI+n3{lqi?UFApCz{1wAi_C283w3!iT7#N}3v|>@$1OhN@(Wd4(bxN9b z?vaburSsT&ME&n)r{NQgv8vg$)fy=v&b&HHovZkfuH2&x>1*tp=W@1PmO>v_E>7u5 zrIY87FxyLvPEoy*zeaEnd#wK~&$ff zmzsM@7LDFxSj2--wYr{oXXjy0%&AX; zuIKdqe&|IAPpbg*>Mt~H z_U%V;rZ+5qbR3(a!CY^vo+#6)ZIuWc9UDD3%nYB1{u&Hu2ob$-rcFst(#5^}yo4=p z2BK8&c;p+j3y9T9C2=GSblYumyfNpYx`$NwArV|aF9pduFVWf$lZFK5(ueaJ+5jO# zHLX#ka3>2kGb#9FvZD`(pC44iWqf`3&kGceYOE`-0P-9 zV)!#$kEl$%uRq$yvx7)ia0$Yec=IYpP&S^jrG>Kh_4N0bFhbx7!R!N!Msu5C#5dz| z;&Ulc(Tnxe(!u<26@dXCpti2o7YQnO{7k7sB?>7?Ht|BQGkj=@wzNk=(LuE(?DtHz z(D5iuuw&|zd>7vFV%4SH{^dsFw|Td^Y@M5PFHyewUdF-E%}Yv~d`UT$(MXxcCHhYk zzcx?VxZzgZlFym($eqB2{R>K}K;NCr^ehv9zU~9orlcXK)JxB45YnqR0UElv%?1Yh z>~cU0Ixosh02;BKDW?m!!mi3knhwm=a)Kq(EIW0mZ^V!JkJY0i`Xk}$)&a%gdB(vA z%VJW=c1lFiSE{=NEfaO_Zsk*oxZmtC_UpaCmhtp*`YKnU4%st zbd6eekv+7yJv=CT4cP=nVTK${w@o(&naJXC2g|t)ww<2L>@JD9v4!%U%4j_v^EpB^ zLE60r02r1(_@iu4;617A^I0c~n(xVF-AiI|q&D;QvQz80o_o7mcNhnmB09?bq42(a zoKnN?I`PK0dy2bi+gh8J7j;D?3Bt(2y3{-Ct@l(OnJ>QsYMiV*<#(F`zVOVVUU*>8L;b=3T4-8ElQH0hTpkoRnU-281GeZ^d*7S2{$|M8hyt#+FUjG zoR^P_J+aw|K8Ia33nXkJ|K=Y1=|c>=8%rzOC(_{A(;p}(s_#wrtc9FMWgw}|)G}&8 zEIsJbye|He~+_fPA4ijzco z?rDde64fm*yb3^2Y4r!elB;l22qJUfq;pTBURLu_jamf3=n>weZ(fJZqh5rXv0!I_ z#BH+ugtfMuEn2*kN&=mmgiuHB7wtYkD!Ate5>2k&CuY_6{h}6?8mMfuaRAVWhy8WS zm)rP84*sxp{#Xzp@Ys`}nU;rvtm;16Yg5tOXGb|G_D_+?GGD{LgZ7f#til^={UX{8 zW>*1URd*luF2eA{w83XV_D2_zVn3&rpscWrCKv!W9=pCXq|H_;n#1oK;n+?uZA4-BS@rjrb{A%R_aFizO#(U3=cU-43Cu*g4wlse`^9G zjy2?uRQTu$);XCj(GELP2nMy>ENpS2yA@(C!e&l=gJO0iKrw=LX)A})M)%dNhaaRzInhf}(xfC02A&Qg>zkdY`dgxr30h%c&Ub;^A1+4oi%rRO>Y4a($b*?nHd?7qq=Z|!i8a& zfGlK3mKb3svf+?E{D5S=S5zh@yTuVpQG0o=NQl;-bmHs?fo`uI3!}NLXC9gEsNLK{w(PH!4(PV(aOXrGBA8P{iDU6t5%>XnS(#W_*?rco(b z?Of z!`L|HO{Yyv9){X{()Cds#B2l0eDUMER}2=RhjR)IZPL$1c$o5DCF673S0z@Kx?yF{ zCFYPnPrj|W<;_3@HL_0g^h$B-l@-@OmYw>^ce?DjW?%v%I{MVLl4N@hhXj>I*4tmN zj{?d?H+Au^$14Y4go#5>f9J^Jrhe!^3;X3t!b?lGn*6mh&YC(VNRE`|&)s9`MPo$o z==DSnCN?I)ii&Wv8Ix%Ey_#hzMHIe4tGom@`qabD?SyA_2ITBP!b}+NH0m@o$x=v$ zXtd#0i+6Hs4FKyra97rA+U4)RaQ`~_>U3*JX8(haqjynu75ZGE_Kyp`MZ&PC%=5tG zhc^+~@651XK2>jYf#=0iw0t7F&1~?|V97G7eGH?&)$_UOF7sz$^pp-M>yR67;3H!_ z3$gwZ3aZgRnA5_u_`vD-ezyefAH$DNc(M%n zR8hd=r`BiJb2zh|E-8tq02dxxfj?NJ->D_vVRWbk7EU0$>0{_(f4u)-Q~7#BP4W9U zv+`Vn5#h_vz`$#!1BIgmWlge&pFz2VL=-NCYyDrn&V2J?!&7%B?PKlT8-6om&~A{A z2lqa;(GmGt;t zb(`lCtsdn~Q4f8XR`%%@xyeB@Ys&(+9}e7U#PV%ew|F1eOMWBWE4woeLownY>dD8+ zE?hn6RpICW2Lt@+`3EMw;3NbCENnSQSN??|F84&>dK=tcMSNXnb(?@w3DnM4CZO?$f4>g&zU z#pW)^8bTQP5x+~E{%NGuv$L@=pkb+M$tU24^iKd_Bxa&aEv`WB0GLNr=)b7ipLcN+ zcE-h343fbl4h6N6^$vM&V4j~(&lszK!H==n!`C| zYx6Aq6XzO^g4_Oj2nS4Qo_YuK168Lz%wJphdBJojwi4tY^YCSyZL!m};RbT={j`I1 zxiRjz++02rRrg(HQ2foFak5vtn1!Uo2?TIashY>W=W?Eb*Q|clEc{u5{}KM(JH? z(+=B6OQ}Zd3cEc4J|*6=xbuUd1Fk~{uiE^X7~`;q}P zXHRE?gq{h`4Gwp5s-2Dtcl-m6x3&i zE6QF0vl>nql5c|6*Hi%uc%1}vjNz0~)riRBG*Q#m(e4DhQ}DW3i_VuI^X6k_=ar8e zb#ae#pXPk*p8T(Ebbu$`3v4K+Gr>k~@f;#G(k23LH^5F_7{LBI@{5&3Eeo#g(e08j ze%wbR-u!daG{Kn3%?&q-1&SrD=ij1@!1DxLY@4!-!g2c_>d{;MS*%rgG&@XlU4mZt zt74mg@^ST}A;RpG{ZI_ySw$j*2$}9%Z30;OAgqDNsFH9drcm{o<12=nvBn%A-rxuW zz;{s#uM|%0{IFpvcde95S=w8~`saYOdZU1k_d%X|$j>bukT|SI6vqChEy~a!2N{LM z{fUdRb)f+_$%c=(AF_&;jk}#IVEeI~l*r5K&lp6&47k2Qu+obzyt*2VR#yzow;2dY zGs&fr`6oz#XHDh}$@q_9!{3MKco~>$R4aBh;55}`B;@cm)o6)$I}VPAZz2G0pM>x4 zNz^~L%iG7luwP!tiR@bce~K=bywjVckh3Q;;}4# z$6IiVU2Qh<)R*+1+iEr!Vf*xfOKu^*rI*&uRlM>7R}?LMb&)c<+4n4Ky=4C zW^ymJ$J%C?x~-lEb-=>wXxcv#(MfVCN!punu8hyp(K>!>+Ud5UvFb}(*OLris00SqSNldZfmCpJ{NuI<$ zm6AQ!yxYP{XA({E5LRRtXx*soaI^Ono-uRba|e~jp?`1tQbsO(uo2xr$|&dY=aPFG zfoW)1nZe<3*02DaZ7x-o>D%!acdRU698W4}t;Xv6oex%B4%~Z2*iTSBcwrk1*&SEk z`Y!?9pqzH%eIX7+X0Kl$yUj)4|bktN}+=5-XHiTpr{bXXi2 zhpThGVKC6{&>kld{8Z`#+;Ab z@I662;0KD#DLc^@9u}{W39LD3&RzcBn5o23+q4H`;xavE&U`8{Ep7d@=fwRfkk%rwS*3T!Q-EH0k?l{Dpr!)p{Za z#mpm}KZd8|T<<-pm%dcpQ-%Ex*4{F#sj zyFpYI-OYk`;{EKspLc(IAK#z%`UQu=n#{V!IL8?%UxiL2z8!Uy^x{JA=?2c5`_yk% z_EVrz=@$^k#%{Ua98Vy0&ka5Sik#lyj6hDlRp0a?WTAI-ky$G$@NBrPz63ncVNK7TJ(n~OoG&Aq{v)ciJR>upy3Q#S}T8! za=6(G(Jh@iL=%YqAv5Z-wr*2T@7>@D%n({9qr$%KW@L{UiM!B^{GOPiX%siP9%zO4 zj{HEnCTlH?yJY z-`<^4xyb5taY{#0pRQg^svhj^%0^A6ttXba8R`RU1Ydot*h^9_-d6vY8+Ce0CLbRA8%A}1;q zysYJ@Nbda3a4RQWy`Khdayq;m+?KlFyVylDw4nnJyc{qR zlg=xlV^5&@5>UcE2mGo0Q|kM;na0M_o|MRr-h>?lqjFN;PsZ)(j9DoVaTO>u=Ort# zsxA9F6oTYv=I;lfRDQQmh*uU?RA)rb4_oFiQJ)n0I`O zB@JhQ1=SaPX^TB-`w}Y(g0#&CVgTOCO*hq)i}R8U_TAka7IkuCJ={8n5mO;TGA%|x z8XfZWan8A0Ic!W_>|r={HCIV9s1gN4uf-&oIoc$6NmLWuA9KS|1AnC{uzk*@B&RNT zN{)yyqccaPDCq?X;R9^$4?XK$Gu%X{?&d>jvqy`b40q~Aao{^W(+C6v4H;aX8G%u=-SLrHOC@bopy2k8c6AmtYe;I z+}z1`?b2aO?72vrMmrJ5BA(F~o%DF_f>emJ6WVkNDq*z6VUt`g)LE={mye&bMu2!* z1xs#+jgqY@Lu6o%-tbpj*xj9DFkbI5JPJL>`zsP>rw|QWY%esb^mO%uD^cwb)ERm> z&pGEul_P%M>Tnk63X(Hbj}N58bIYj6R)G|bI_TobS!gn%rReaMTLV+7lnMA(AXfuX z<*+g#mUk*V%N0d(w!b(JcMyuxJ#98X%v~yrhRjdRfh|%gDY)Os{;Xlm>b6O5&^A z7<9_YTgtd?F> zcvDOkbwbZv*?g@0FyLRe)#7uXWv|66`^+{mXgb)=rt@W2@jkcIh$Vi^rT zY#oBZtRIguNeQ&=U}_MF%2r1RPugsLD%HTCn&E^rG4e9MGP%(iw#APgt=wP(_M|jA z8Y8Z^kFJcu5$l1OCtn;Y9zBNloV_j!=NV=2{$(%Mq2E@S&^!cJ+GnjOM#@K@_eQhR zX|gZ)b17NKz|b|AsD=~K{k*ilI0JzbaP4XBoWh(is+mQ4N0znXE2M1Ji3 zS6V4Dwnys*;YJ22{)+aQoZH85$d?bSK%1g-J|=uNxj-v-sXm8g)|#M-F8;NM8i0@A z&-~i=qZ#`TJ*}@b*(bV#z2X1q3CRB)zhv{W);`)qv9FcSAHup#I7}&L6p;KvGe^o!C4e zq?U2sJ%2OPU+$bzcC{gD5OUC>@jfkj0M(GeP9aI@3W2@`^zxHtCgfCBd4KiIvGU>Y zS5*(GMNe)aJ6^zgEKkftML+B?)R22>u&3C0@~Cfx!&k+nRs}w*dm{<=)BVs=kB^FG z9+Cf6)G~j3t&KObf@*pW3PSl3EFh!3V*fiyfk-VFuoyo9Y=6Al^CU#PgS{OnNC~q1 z#)NKoR?L%Y5H$%I~+B2xZZXaUxcWsS}+4R!Mwbn_RSUxv=Lp zjtfzSL_7A^fPoH#wA5_UW&An2t2Z4G!Em7>%NLsCq$v2y`3z+OBo!;L$iDtu{ za#Y#=qqNkvYukivs`>_MAKQBZGK+r+kjN*=$#%mnb3XeHnGEwWNhrsQ0=|`bKmh9= z(DN2wIth?*Pru%HHT8d=hhPZcdFTV^!ThOy4}<-z-qO3y#$GW+r})?TaltYw7pxvWO^>?JVsV!4@5nl?Kpu-F%=N&isOMWe z#Y&50ZzUHF-o(o%vp~HYZ#UDFK_1RLFSEP~;jAJH2Ja!G`t0NZ_`MNyX-@s5{=*)y zN>j+V3kyH5NPMYg>S7K_;X@4n(iTVzpjVJ+yp0`k!D@lt4I{pbt?gasjmf^m+D z{R3~r>@&A2@VR=Y@+2ZALc|TuT?1&#3Ok-~LE27!Id**<`96JxZ4h`LNF{vj=;9Rn>E<`D?^(&Pc!iVKqw`743+Mw}f=D zgrpJbVVnCn064L2uR6wn2+810*>!xfXY-dsQxlCi{{<45&0=X>Q_~YF(eI(DYU1MY z!qVZ?cwl+zN5@zS1BGQ*0e}UfH@p-vjbl>4dslR@sNvH~l+(aQ-a(z-2$J{-FNqI3 z;K*O$5X8SMNP?NKvOw}T(C8lM3-L^@T11OSZ7?%F8c<`56vwezKdbyq8qg^%>t7;A z`|y#!xBiqhJfh=!PV5IQ&F#!F+-IM*`R(w9Ht1_p%d~=0ssrcyO&bpo)wjL44BdmB z&#c!8Lo8{Xd|P*G14|_&l##F>2L0?~KbT=0+Dio*=AtZ~2IxpwwwcWNxE*o<*O3tD z!_hsd?sgQc{Tj@!ltMaWr}-&S#r#ySB1Bk)rpoV}u#KtMz1C)|KCai9Zn+DW;`!C} zs&BSRlZcZq#*x4O#+YG302VJYs5GHmt3o<2X^&_^nd>PMKV8Y`xJg0YbZN#)3uccD zL_Ch-MKW|I8fD*IDQxQO%66Sn8Gn8PcI;i2yAQ} zM}8N_ULzEP%G(iy?~KgUe|4mx$r1^?VwXb=n&^Q42P{E}AJ*#seChY^6v&dA@>AW% z#{1V__qvWrQ!dY|`(9SOUenlK*YQsG(||tkuKMTOY4`sze%x8~MfTHP(H$gYjBn{)POK^ydfgiMqo6Kz3nQ=-qC$kMxVze)FIBv9T+4 z-xmT82boQ7&6KU#YV#fHWDts}1rze;7XfcUhT&}e=WoPO8!9sOHGAM=1|P}rlQM?v zobKm|DG;oJQ&dkC`SsOY_H_4^!psSZo3VShg}*%kmf%8Po&}0i#X6y-=dT4NXL^=-3Jnmwl-5(=I@{V)r6+z&S2PjY^r?X~pnWfEF;gV~XC(d$ktvj5@d$y(K?$6Mjpc?XuOi>66Y}hrVW>GsQ7&cVvf8 z0tn6hC|)T&k;bB=-~*hiYJunX*wH2fM!1v}*q2N2yKrSO?<4z@(OjO*p6Qfz7KOrv zjK^sp+hrMO`v%w4DLzC0oT`dP{h{W@Gqen0!^9gH1Bu3nVB~OIf%9O~Fg`te&bA_M zN%C@L`n9S0>*V3W9qQ3(8n-wE1mi0Qh;?#|VeZ}Iq*8aNJ{3MvWA7Zn7x_?ZD=)Xh zK=|m0;(>VVXaNIb^ZiM=2OrA!Ro|eP2yRmV$Lyfz=ohBvOs=WnyYIqX5ur%O&5#FC zpJ0)KQ5T^xe=LgFYv+1IHz!)2{%{Z-RMPD=;(GS(bYgY3dR*P&Foz4A-upFgHqRd! zqr4ULNCW|4vP(cB$q5TF?;o_^x+NMMau$#c4t9OPc$e*M>i<6PdouVsEO`Q|&yHb6 z;N>jjs>V<7SK_|DPw(L~;|KX}a0tUSiGar(++q61V4vY{Csg2_X4w6=g>N+jRkbmk zk_2=f!ua*j^d03NPfDC(z@@vFQ%G2c2^b`S;=Q2>gU2&L@(37t1{q9h3hboHi>e$n21D_@}iec9Vchnl>@;K#+!O1YaX$L(FU!7nI2 z9no3JzJPAk>hIkG|8C;Tr5Ujr#lt|w&KPw;sQcZz)V( zcfmjgDmESO26`ln8JK;w$xUVObN)&jZoqgH>*Jcm(D2>Z;M$L&^N`6^;uT)qn+^@| zl{aNa^K^K(6vC;&{Ub(H44)*JHX`is-WlywBdyAI>w0p+ciN@q3xT&jJ@DWxzP{7U z39)?ojF$0!HyLvH>L9hZ%ohV&tD|+#I`MFXh%A7 zQ{6=UsG9aMDP@BKOW4G2yzOcAhR$>ZP7h0Q`H|qH%uKw5E~s(2HWO%2{s>jDS+Bbj zBV=mNi9=mi2zOd{Y8Veps4@<|S>=c>fW)kb4#oiD9dh{oUWzD$LPzn06+bs6ctZNk z=g&MsgpPq$G)J^7fd^Fd9{GEkwV+%@Le)I4L}#}M+73IsofqI;Y{*NWCa~Ti8ZHn! zjn6;iR7InZCw@{{rIAR|>Ow*$g@-R7RD(;%?rFxOsW z>mtHW)By<(qY0~QFYik2akN6KE{o0Uz`IJ~Vm)1+Q=ulR_Zb307YT^J6TB=*t+1|W zm%aax6-Ivr&GyAAWBqYGtedGfF-W&CYIsrzUYES+?YZ zk=ti$N#wBDM;fyqT$^wTgl2d;-MZ{#wXrqHerJ!v$3Aio}H zClE^xA^2`MwBpeRE)2W`BZ=8{aRGn8a%!ij+$;@}=v4AS;c2USQ-jwD-pdY!YY0ZE zzVxq979e?V*R~uyf@!K%Q@#=xVP>{Za?L^eQ6iF?;8b*@twn09EcTGQSJ}{s!ST(P zv!~s_bCQzeU#S!pY|5!4Ut&DWl%DCs?bzZbkC#h&k~3Lm#oMa9@zUpQ`p^%(Pu|b4 zPQADl$D9Lseb+x^U?3q}!t@~|01(C!RUHw9yz4U{tKq?}c%YvlGmm_q6q7}E{^w~e z=yx~#5l4h)gfvY%`Gmjs;#wAVN|oUk>@_Er>^EPvjcCNgq)rQE}~Zk zh<$6S4l#(71HZ}}0c}sNkjEe4Fu0)7Tyr$o=sv zWKwlkz-v0?w0I64#4^Zj5cb`&I-tUDp>`(q1Q}Sw6`|VIR7-Ffww{S zv0K$w*sSv&DAyG8HZ3n_!U~cbIhC-JHYlGo{tW?{lHpjcHw2f17HUSjN45itipLO#o~`rFl(XOf>f3lx?&wx`2g8~ zA+Iae>Ou8%11aFL-=R&m0 z@|(*D{))OpR-IhHDfsVX)T;xj|omy*btr@3zA@rLfMT@7E|A4H8fj_Pjk~JTB^4cCrTsy|tvmjnwdv zUF~+^&jABqoM^EcD;$qJZ*ZQY_|2>6#Ax?@;661{`)>9|zQW#$-?CLC*+f$%Wu6C0 z3(yPtPd!pPX(f4kwtjx~?C}EbrD-@S1#%DUlnmiqo3tL!XV#c(IFHnft|e5E{$ZG4 z@4cxKEFaTDEFR4ZnZ|T2AH17gsKAR+&jAh!5WIdVWj~CKthFP zc6Rj5UrDS1NR5@VI1-rv8!o$h33Lg4MdM-|&TGDcev1eO2WfX{%B zgn3jn?lhN|xD7N7*rRR=l&m_xQoUhsm0N93+e4_`5GT=PIHRi9Z*R_gGT&&tlq{6ffg&{kwm zby@aGq?unR!6jOZd!>17bT+uGpKD6PsAsS{n zYDr$URrr`Xx<>P>@_go=KC)vAh?(*eGL=@rNa;6h?%{1SWfS@1VbG`CaQfT-x$)Bo zJHKp-Ja10<}2%iL6SClV2mXJhp(FIxof-ZdK_)&hH^2;;7;jA1xZqJQ!Ir zSf4LGq<4U>SmK+N`u$p1cDj5;d+S?>%`*nK9o_*xi8PP>s@#|dBWo;$jEoRHVoc$yD0G=lwX)hbuDtC zd)xzo$bkZB1w@A~WvzS|SLPW%ebhc>eXWZovDTLW*H`G(-RVl0f&f!EV$qFg*xj?W zIZ=`?fnBWSc=Iafe}ZaUJNHgcbg5f|4JK%&Z;#R^7AmryG&|R1y`!kJgkH3K{|$hb z%@-dV@x~+4h&HbdZlMO>+DVQV$Tp_i_Ej`3tTB_!kHHe8{4P`KHz>QA$&bQ^TO}t8 zmNL2l=n@e0kP{FP_OCm|e=~kbJ-tVb5nUt#bwo~wzsPc`Z42f2#5b-7+Ox5CegZBI z5)vykL=Le_BntTEFs9^fj@-DyEV4sD)!>mP@v2z4**O5JO`8H61%yip!RxN^cSX*s zEWc(>zpe)8-}iT$jr!@)|9lTIP3$!l!ptx2of6uxRzgpYu?j#5f;>I-Z!54so}D9r z+r8j_{Ir41|FUOFOw~!^=&y+aQidTQta!gMyo0s>BT@4fyzm+gl54 zhA#2+yv$puHh#~;4B!a-PQKi53M3OuQyF+~%_9zNCjVK$Hw_2?j!f$gpMDKc(&DUXGtxyQTSF0fbU-S7a}Vx-J83+_ z2hP`z;5TWI5YwE%rbgzR02*B(q;oX?Zb?ViU?g)4r^|4T^o31~swA4OU-dN{>oW6q z4{jp*VSjI{*FE-(nLNRyUe2L}rE_ZqKk6E>^KZe6=CX;zAGb;6MmN4eNHOzYZM^Q5 zpG#0!dyaybJOtH2)|O^(AKZx^6gKys_47+f>w!O!op2fv;0Q?t=_YPv=jFmK?O*1V zRlHDa=(mdHe`IEY>IhC?7~=S<3e~&p3uoWzTelS$@N5BSW_g1~-?Pnmf+ z^MXx;=OMU6@cGLZkL+U@@5Zw!h0C!b=Eeud_v*okkqp|m9UKY`k zD&AcoY1JJn!fShx`nZ}0opiq-Ft`gE|HM|u0YPG)=d(U+)0LGr;_P1@qL>@B+wp}e z?RaqhBomLkh+1dJVwuIScQ%YLKkz;uxA%Q^`%bfv?ex%!OKfc)x#>9RKR9b>{i;pW z=y3A~8G8y~RzCm%v+&LA7BFnvPJY-$mNVX8e;emb5vePllB=pmDH;AUNt{EHMf3;vnU8z5ep z$gIye)K2l_c`P}03ld^E##%AmLx#tXqwCWR4{PteXXUjNPk5u2|#*SqBgyrDx?$Hg7)q8=0&cg>_7HF;Bg}`=2FCCg==c80AOQ zJ6B2NgMo&D9h+PJ`3IJn5gL(9Iz$>|L$;AOiZe;-poFoMiARIG`2qN6E}H>S?wUf; zzyiDfjh12_-}P`(3&%zeG(lbBr`5}!f8;2n%{E9^?!Xg{Jkjf*)tQFdu)u+>JajaQ0dI_#2w0@cl3 z3I%cMcQ!N`SZ?W6Xr+&P2O)^L_=1&05HvknA&i&HP-zas z_M69!1Fh_FB^P-Q@tcd-OxMurpQPE3rhHAj6bHS>Jiy%_{@2wY;h`xt+G0MGqm>~6 z`p|!Mmic#MIzpyLrKo-;6HX2;j+uV0mO-2L@dD~nQ8otYd6GxqsNGA2Pj2%U{$WJS z$Z^L78m_&0nu%*C-JuIAH#hLBm>Fy)12i5vnp(%62HqD}0Vts5bwZo1u1weCRWY8g zC*!wXaFWBvY7hIryoWB5_pMk&+iubV^`6XnYoSokuG1@iFP7J(1xut03BUsIPfsT% zgkp5tAnccM^fy1+ezaX_BduH4WHab_MSgQ<1KtC%Kzji(pWAf~`NLzNBSJ9|x&2P{ zsbqyixa#j-`2F9Uq*Z$FZ>zwoUjLE2d9zKOLASg6R}%{CkAGL?>v-M5>pw7ipr!p^ zdQ*@C(8P&Mbvq>{P3-mZwoBV}JRp1DjeFUmHg1J+U6vv{VO)9H>;Fw-q3_CMD~fGP za@lG*$gC;51e!s9TMZRH`*tU(1prrno$XBB0S)8R4}lpXEfh=xK(Q4G)B!31HXddk zam2{#pw0iam*@+1{qtrdUlRdhBpN_?g?$!f_(6mUhN$IQ6%x?-$T7LLJ z8Z?^!)&qtXB?YGKZ9rp3R24awZzW-ot_jlyfp-3Jl^7UK;}#J_Q=5~#P#W0`70`f< zB2-A`3i+NSlpl!-F6)<;Yhq#5gRnKseH;>iB$}d9XE~B+pAyx5O3l;#H=XAuflC&% z=m?~P5{=cZKAXb2@jCiOR;`HY`|X`y_ubihUCY~Q_VyPQjQ6s9i4KqBY($D?4!aT` zMNjNhH-O=w>Wlfc4@Fizvv*tf`2#crW`3g;CdBk1X4s zQ-s7w@x(yw|?Xa}~?RZv=6Y~S$dnMK)7*0f|Z_FY(~bf|y$awUa=A-}NLReJD=0VjW^E$Ncn z#=PXLu6=d5#Z``gN+ox13_uF7`uZ3B2iDZF@s?_lC5-ZeU$Uw|u1bbdTuYr1)}s!a zwYjp6{O2H7i9QbEp0)cN?o3echePK6?N<yyb*}v3G7- zl~zpbcO>UtyZ}kkb$z3}ljM(hsW5I?-yr8164ItxBj)cRlRcKe>RlU&fgdwjxbT_r zH?>*CXD)Ur*#&(vSQ|xUkp~q5%DKkQlUI-{TZlwaj#jKF@o?G#I6|MlHQT)>PcZk9jUKe( zE?rS*xWQ--D6EM85uU>fQ9TP7EI<#lJNKV)@&dMB$Dw0eEV;JqrA~GbY#x(CoyK*T zL28A<*=bc)Oa+##%oWB<{kU%P>c4IF2@zfLF&*qCcX_P(TWr2`8!IuuuaxNubL>vL zWJsJmR8fz{G(T^1dSfoE0O1gOmzk{u;ql^8^bIFjXg+Y1657e98$}^r8L-;so)Chs zt@h6zEMx2GCv^HW${s6LbrujLCH%GAy7qn7J#m%(wqo-srC|2~cJCl;cu>H4*WA}k zo-oJCG)1JAnnfaM#(E!BqgMH!`m7HVgW^WNI`%W7QN1uYD@8);kRXroRpFOkIjd+z zyVy2o%Z#}RGxO|sDO)qaG3?yEFv@f;onF_hnY60r6;l;IKrYM&Be+caXLLOt=`C{R zajpebV?SInWF{X1yyxwnBStj48yY8nh>{OsYpFX1!tCcF%wc5B938u_9($Akgo8fh z(UQDga$Tq;^DI+0*J%FVo)5!%G{TD6PhER{J_~FnxFiMf!=`2O!?4;JOB$eYX-B+w zMEh?Tg%^>yV>PFWFm(&ugVeEh((q^OV*bX^2lOyl3oZvNOzYGVm zwqFfEl0_D;31<=i1v?akJ;E$=Vjg>9UzJypuHBvW;b-X*K+PYI_kw= zFLDBSU-nSOuhSNOW?}d~cleDsX9IpuE^jkR{&2XwNc^M@JbR&IeNI||Grvh z%LyVd<~%n2uS)8*=r|U3|8H@0AqLB;rFJ3(>o=H(xR1F9|tVu zH)PZeEzMjk?MW}OQ(@FfzGoyKWvOsG9CixnFqeoFRU@ueon&Z=Ss;3Q`fF{A>p(5$ z7nHlatq(H+v`*cBmIKym^pJf(iG!gc@yK23LG1#SZaU5M9X%TQTXy$655_ps08SJ)sh z-G`#<%`LsXcimO&lD$nQ`U!I!utwU}T8@rduExkiY0D$gu|(hOW)nT5?SK7*jy^qc z{PpGzQp+G;n8a70)5U}o{qbT0>(Ko}w}M1f_nI@D#_ss6nR>9frDcLm=R2UN9_i`= zxJ{3KKy}S3&ApfZLeI^7Ad3ykC)p z-(?JQzY`xvOK9|6k*HVZ@$g%oxvI&3W+SBylg}tnPa&Gz?7bQEoR>CP{5ep+dd79n zPoM>PDsgh1SP`NY1&~};Lq>ALPZZ=eEVNkzZV?5|u|tRVJwN$Sh@C-x_i56DqsR!? zco(^9d0U1MX&6}{oPTH)q|@_@*& zN9tCy;Ml9Jaw7H#9Vy+!d9%eh1jsq$>f8NL#NTeu8}wWkwl(#=3;o2i_c z|JrjJQlw^SsuWrR&TLY+3WF+CY-ZY1w$o*ocT3M-H?A+Kltsc?H&ZI8g1Rm^=+XW( z#KHQz8n316Agh```l<=IWZr>n{vjTEEw>w{Yyn->LNXA!sa?s1kj~xpW5ChGQTskN z)7f?1{~4X~eZEZ8f4)ejLm}bU0pjZ3#Eaf&u2Rg8RGW%wQNF1b=0r9p{N2g8*g*?m zBNW_Ha;j$WP)@vv-)vvBSr4LVSu-!ujAB1^0T^EM)p^j&iE`pPzelLF-mIsN^MywO zYqzBy578E{2bHETI*OdJ&!p7$!{^+0e>is#U;tC=d8gh@^@Yf#LaB+GJ1*V5$4gM| z&HaqfY3$Z*O0If|$#cWiDy(BT0NVz& zk(3;^;N|7Nm$+NdTc9O}FT1XYKEQ(e)C&_R$61YMHORj`D@MSZZ#`Txb)0rg8-z?G zW21)`BoCKP>g|0!H}dG^_489xeOwP5Bt!+5YtB$Ap{ORhR1TitKJ*iv&T`PyIvsVVGh1@KnW zP6bfDvv`9t?7dlfpL&C5M{{wOD?4g7{>tED$TOPNTVgM<=LVSiY+X`(ZehDHSwR8q zuOD|UEO78-M^C79nd5YZ4CQQDh~Hyx$S^&pB;*z2s4;yl<2o{mdIztt|z)ZY^ z_I@v4FG|8tYkNVtI(W{-$ zsFA8lLw;3=H<2T3>h2lFxHg6S``4pClE`0-Vv){l_qi`AL{z@T8xCyk9c$$^JVBl+ znv{i(#qjO`^69?T=EFXR3kjU}UbJ~5=??GBW@s$4^u+Jr{q-=B?AA3}kPst-<xM^sTF<&?K9m?7;`Kw8hwa5hUGgp7kub>YFj$Vc zQM1%8{T^2^&|;sPsE6jLEw8CTw)GfB4F!IR`w?Mbb%%}C%X=g|>8gYj(Ffv(C6FHb zHVu*$-dWD>e?U1Z_U;XsO%EXrM2s)Zw2*M=?Y;ML1gd<7@d2nF@fGbyzK#SK3Fu2M zYmm*Ahpxd(f0=z7i2pTLR^%etYQM31CEfj9s{z@Uxe?JgFHh8$0PgX3HB16_QUzgw zPXGGe9QuFTl7(Ke3OgNdQ+`TdUTeAC&c%KH8vUAWZu>3E_j-YQKvTevuL%otka{*PgNz{w95e$l`#Y3iKow)7>stDEDxuR@ljz5s=N z=Fn8B|8G2_1LJz363URo>-$08+-wCYb%F*8GNvk5&S&icUn1fKmp-OQi>MuNuE| zRtb*#V)6y}RkNf}G#BV^P!Ng`uO~IXz=@x|Tiy<3a<2F`?rWT)j_x1keo!?Lyj=(; z_Bkuy8b21HE^K%~JMUxDR3$0F@czA3fx7rWaqDZJ#~ZNtH0LeN{tDm zV3NjlThU|%bE^5X5``WAZFaH`rnq8Ao?Rsl6#O39Rq+1KFXue}MqG!W2x2C=PoCn9 zT3T=Xk!Nf60@fb!8R%k$Vxw`fPJnQxfcB`1D4j84a5C&PfqL^aWn+}}7@OnO@bizw zz;F6QcQEW9vLF^h1_=7F*pzKX5A!-W{O!yC4%n^1lG-&68mCmCAm>tUIcpvp!Re%~ zZ#LWtfNP5{ep2>X5D@4n`^;A!36v3a=Fx7>-8>Sk;pgK>GP!$&h;3O^55qTjGb}8L zCd*6@i)~~EUW}eMbq1Na>9+YLU!o*a+hyiHy1BNK6I;GvfB#KzX@~m#;b()u&4CC} zz+xPyZI8(TwQu)qoH4SQoVqvkN=9zAd+gSBPJ}%HIc>|%(_7%(-BpR6?w$BojffQK z)$LVR=ic)`5bReGJ(xxt>V(66bP^|Qi$1cRKl!Ya?b%hFHe<)G*36CovzeXK%BF<+wc&LCI(#^Of6Rhc5mRi zK1jNU4VHV=0!2RQV-{tD5Q|A*G*k>wTL3w#9KKpA%S=Fa&=l8IrHe%HdCxb|xZw`_ z_-B4K!$xYaImUWO2a&Q^L*t-NpC;x`z}05Ki+;${!oBV+6t)OqKmRdnq{G>&T~51p3t4PMon{pR$o6ru#uoI3MA12#G}#ADF5@8ID>0#C?1c+0uF~RX!?GuCOzy7Pq!~d4CNf z7SH|Q(YbG#h>hylXlmm5Uf57wUMh&O_Ksr=-B7*E1n!{8NY8Eg=p!a=X+_vdRfRS? zO^Z!NX*vzwx5Fy=mc+sH&zO_d!)s0aT_N$4&i$tCVu+zU7`Eogfo6&On2~cDM7x*} zHA*y&Qzs0Pv3{M3_Z^wgH<@wbv_YoH)^!=u@$DwUTJ@QdD=rR5F z^>ph0J0XFb{2-*X&BNiwATgGaik;@bjo!qyoJc0|$Q3*KTRMo1@C2i*TeLiEMtMs+ zuJQC&Q~!0^xUxAsSGFYy-?w2~=v8ep@i8sD3ZNW<1S*dozi+d>gopn8F@L-{Zm?SV zwA$)q=DjPju49(~IQSi7`ao2$G4dmj4VIs`-AVdHlnDSVSP1CXAI;_3h4$0yzy4+7 z<{;>uur%7gEggmWPsyV3Uy20b;k#iufaLvm`MKuu{0sJ|tnyHXkUm%z-f) z#PORc>>4#78k9;w;10r2{a-)Y2>F_j^Sb_ch^4W%hvnHm4;Gzheee4Lp2|`&$vs#o#Oi&oPD-uIjscYCl^Y)%v|y%nXKHrwF`)iyyz|FaI(>>=Xofi8W_QQ z=E{l+ljK!Qq!$}uAH|IgO5h%mxmw08qc~f zy!Yt?Q~TV$OdciH*nX;%za3~S&W|q)A^`}yVP0mD>0bn9$_wPYdW4WsO_HcaQs(*}8anr60Pq20s-{a$G(D?Z&6S$5V$o9B`g>Wk-jXH6S`Y> zO@H1ful^GITeM{D(S@EN`xg^aeRQGc)d6%}HNd-2hdjhi$EL}SOWmw zXtm{6t2Hk@q;d8xMGfi)<#q+fjbZPnzYPSefw;$h4!jd3S$nMGg|3?Rmz=JQ0{~H> z)jlFV41TJIj;@P0e4;*E@BDn`u--(Vh_}kb=c5b1XiI3A42~^G4*YO+si)~=#*DWA z=p*v3;}2R3AGZXpZ=S~FkR@VX`^dDz2WG7ugUP*m5y#6jUMgfGH^LTXX|wgST2rQ6 ztBIl@n(7c9$0gsm$q1MZlH9|wKpL+v*|Qfhf2_=hiIh~BX5eH1f^pJwe6kB}xiA3% ze16_>nh*;945-q?oN-H8!RY9Vh|=Hb#s2H`LWVCh@#-xO>IR~L@q8!;syWtevmf$8)zQ4A6u%Byr*+`W*iqZ%3 zv;HB^-+uQUmZUO2uiXUm&Ekmh!$OLf1okMLy(yFFX>o?|9#R-MAN|ypu!Qj-A*}om z?i+4ZU3Oh8>P-bNxa@~dJ&{2ix+1~nxngtEiS=3L2gS$G6-r`=rLo_YzOT0E8*yF_ z+Z@v^Jf!9?7-Y`=Q*6-uSFy1)-UC|6Uf-1^KBXaGK5(kHjRZ)Kwex=xl}avEbcC0Z zBi>vnry(K5Cyd|#t~7^A#I04Rqi_(Qj{v6Ojtz2Ke)I2K!>dp+?y&K}BK?;4`8Cyw zgpfuO{87~69D>R3|0ycKv{U(6!M=<|uT=$w@>J2ks*1BoaG+D(_sTLj7k~%9o zCtW_rAJWRj_?owPY@#&e5IKD*sMDodgwJKX_58>4h@*@SPQpKe3(Nsx>h8UmR6zPdNFsNDE9+X*=_bA4%i5 zTP{(TKrd!IUU+K_z!CoQIYT936--aQc2A|WEkdbQO)ppk2ig&QfTic6(YHI$$ zJi@FTn#u=(4`=^M>45mBO^Yr78KS0E>eu|prS1lu$n7J$6^xTY6awb2;C#0&C&6yb z+rRZi;e7Li7vg*6tfZ>BSS@Y~>xBuRq|DNYKmxLV&eQ+vtL$Sb;eDd z@A=$2qX?URbhm)~&6_v5KKEB+S$tk;9{jJVraZxB$7df>f2_Juc8kOG8M)Yr-e-2NNGry?!gU`jv zFc5S0``ST%K3zJl`~25K(FI%kla`6`_KzdN2mXKIL&JsjzPFE&4WVwOH$@Yj8`% z*<|Sh=9zA8U(CB58E)y|=Qcr5s-|z&xW3<&^4&`N=NQ{FTQ6P@kGrglP`|Vo;=4t@ z3N=iw@{Ai_C=2ee0S0cm&PLmk+~Ik%mrdcqbXM{2eVQu?0%k# z!ozRILAvkz`})nJPaB!AP$LKgiVS)9K&Q`};m+O?yB=63Ey%~$8kDD=&w?w;*P?be z+=JIQZ?-!Kw+FF{M@_D~UGKG5O|ewBw4CnqxZSo&>1mbRZ;7&OH#-2Jrt%E= z5Qq7Q0@O+KQWly&@gdK6p7K3~fU#Tsc(x$$64n1H)#oI9f{=Rjy4zT(vY7DQDK9}y~$-PT6V1GS5B zx9`Q1FR}Q>bY9Z=)BFCL;a8THW{akW{VCEJ-j9*^eHCot-wf^E^;>Ft|M-~Z;8$Ib z`Agdm=IA!wfs+G&-~gK{?#7KAJ)5Fgo>VDKCo{Hdlfe+4*!K*co1=BpmHnN;Bg;Z97-Djzr~5#R4eNbQ0E z4t#wZeAhOsMR92LFQ+ zw=2+6do+JESMX&)g2QhE&(!U#YPwiuc$=3!uAjYQxwz1FmNk6hE3JQ;oq_teCckU? zvI^Tj z7K2^F82fbeQCdz&6qSv|{b`m}fb{r4{O&13P$=^4szZ8l6;{yvti$U*whMgjGw+8R z^v9C}`A0W{2MIpJ#-C`+#{G1T*9;&|BK(gRQ(o;>mP2Tf43pGNNO)M7));Or3y<5G zrIR;QF@CvFKMJbnjDz5Kvm&-z*bg*_tnM>_H%yWM+06B~%<`^P9YnnpO#Weh>jRH# zlB^6y4zY4Mvt=OmbTMYw^?;L%cEmIE2pp{A4g%QCcJx2$KukpXUeF$*ql8W%5N;?_ zk_5KT@di9(p%4x+8qOZgenFH>a9Dfuym3?n_U+TQRXx(u zR=)i;!$rG*?T6?g<|D2oGhSvP&Y8iBjMnlI!9XF6>5-2QH26MKa5xF=V+YkIBt8qT z5UyJm97;L{^Tiw{tdu4CKfON<1+NQk1IACuwJYi?a>TS;HeY>6eTDJUW%5m!c-B)ycGrt3itLKLukk(|Y4Je)D zBnY>=ea`%g;7X$P4ZM%#`7cfPSqBagtr02wbhvCd$cv!zO{ClVx(!yYYhWk0QF?EM z4K`ZeV5+YPB^l#9M0pX#)@js3P?|?R+uTVKSbx4pq%7UgWU9s%_jqD>JzTybEB|Yu zoX_lXsW01)mb6tncfnP!10py$khGlnDci@{ABRgU2T#rYkn(mXexIbw0_NM%x zTmDWUU3v9L`QTyBm35`xCD%0Ra%BH9EyxMPCDoguptpUl;QRIZr(XL_quQ+P{Z{bo zIgUU(kQwr9kOB1U>|1Yf`kmL-pX;^H>L!jW1RCtYz|wI)y`)>>^$1jCrJyp8aNMrW zeLA5Tg>Wk-hQH0IS#EK0NE~H3->kUP1~f<@cf$Y!67;X=Vxa5)r{F{-@ylBLeR;kt zg5OsT#s7^DZM+sWbnp9yfdkI|`5CZL0(l0yvC&b~!-e{otAn|`UJ1t;c@{hyti4hN zxS5y47LLwlXq(p!*DwhHE+p&ueW3F1Z~yOcm<_j;dEHnYB+DdYcIVdrA&wIy8qZ0E zT(DSRUl@5mJQP0q`3qzx^ViH%dgwbSV0OP;qi(Eb<*2&)d9`eIu3wY4EXlGA+IWR} z6IwoNmg^OaKfn=u7JB2^{<2tKuDj^28~iBjAz13s8x^teC4uH?P)R zTD6qYHX>GJAlUK${6LB%moA<>8?${Ocj5=-u?I^kM5NN^icw=ufjjg+Hh4kuYQcx2VkqXgb?NI!= zljyr_Oxbsfq0yh=rstieS>lU(YPBpqW12}+6ev&^n5aaMqGa^U=Iblg##{bwS+?e8 zM&t+iw*yO6k&_&mGMfZBS+BDgH?QVPoQSuH?LGJ}9Tw__-DC@Ce>ElEPV6VE7TM|- z_E)HSB7hP;*h_3r8IdFBecL4-sFkFOgagCD*;vA;5QGveO585iqZ@k&^Eh@8qtOQf zm82t^8A6UJ3V5j_ty#^N$a9V*v56S**~ts6mJ;(>s^XG*f3f&|8d8t)%LqQb-#RBz zos4N1G2Oe-ZyvhgT;lMPS-&;&QXFt8ZxSYryAMIyB9TK>;KHPtj+sw_*P<_JP3N5Z zK1=mUzi4kj(s{L`9ZAYlyD&W0W7cs!#s2V>RR2(mR!ru|u&%l6+YM}K=y-f?alXWv z>B613d0!JZ(wspe) zswNUoEX+Q+!C&b}8qGi6v#Kg~{gNJF-`LzbkQr6FQcb&Lp4^dj{3t1kkGCpMviL~c z#QZ(itfW0@JQ9xYp3G#`FlBXD`Ue#>23)L}9_2Kz5W{F4nrq?kwq2G2*86A;#Cr2| zE(I(q>mRujmp!aIM|8EZ*E&vtj^JP?U<;7`0TfjHHWde{3rcMVRX8bpuTsHvd(%H} z_J%A{8Yjc|VMMXdQvXNE6?hN7Abu zQ)Y4Bb75h=Qi=g`&*sEhmrT!9%3{z7R+H;%SY#Qj1;3Kugwlz;8M zpCYxfH0mzvt1oq6+L?vM(jUJQwY_|(*U@Tfl-lxOW1otST_Va5ZP? zdCe6>)2am%Sq{k}mX=`Zu4{<@HACOj1O=tHT{pLfoa#t^YqWvuO_g&ae&SQ{SW@_= z;E=mmq!s?x+A`74_Js9eZpGfwU!{E;(5&UU%h!6k>PXfkoQ$Yhp(7#uLd<2SXFyJJq1sJ=t+UELy7ee5&yAM~irzLFa*N(+C$I?bxVO7qwa?+?~j zvC3A;i|!e$l1$`a=(<>3O4j30mla*Lb@r8#5qEi16s`&8+=OC5W%xN@%=OeaB$mdY z`cqueL!@p)%QW<}Si;DhvGSMO$S;PShU#PamnO4G;^8W7?2Cc8Ickl(-#x!{C;PyFqb3SS08;>%;#LriqzN1ni=G4wMA&zoeu+i0w4>wx!*KmUS}h7l%2#P(ME+S@@RvD%wPuJzZR z%>xErw+Eu;;cD@58&1-}jJxd5?gY;miZs1H>ZaoqZ_GW9- zIB8Ubcy4Yx<93n9Zr$3JQ>iT@CQ1-}X#(>jc6vfb7rA@5xRxwqPdYj(`>GBv_=n7L z##d=q$WTA$TPo1?HcuUHcu6b`)q_c0GDHYB?sP%Xp=#Hiy|+rSUU7K(H<{=e%F=?8 z3i?%va!E9x>VFveIxZ$x~zK&49f zg~fLlsaS`qPJ`?7$!oU;vtX_*aNk08ZSi+8n~XjZFHgcpQDj)(Y-W)1YX(6|$cf20 zlt`<+N@x)qZNQGH&_*3G=)0p--ECSzL4!O!EcF>6e!m94U$6POBJebdC9 z)Ch%zOB0P_q=EX={oR+&uFaU3l`|D0jMJX}FeqiPJB)r~>nu&FEz6!qN15$FPgZCU zyRWM^iK zz2-r36gh(g?_6}w|K0729r}R>!Svh88R3!ElBc8#_Z_|dA2Ry2TbRu@Nh}n8l3mxb zaLG-6?%9`ZXRh?)-_{SHBe(E^9rzV>VfC*^~3OQngB__{7J?!x+qo4~xaFDg zH4VdhP)O`hQ8Gth=^+0=>R3}xlO!?Y5cz@6?;U};{>@I6M+84pHTAp4ThCZs!XPds zC>gpU0XJ@j6iw)u~ zyDWG8=8IMrBg@d9eDrS!^$Jr)Fj{E_i`CNe9}$c%67WDn5D^8IeT=fSymewlj* z5AIh?k59y7B_i+NJpSRWJ1j2IeftP`7Xe5~X#{NN9cD0pT7)fgz4PXRQGq8?&Qqyp@wgmP{RKg5R=g{9!)I@|GVaOj5^Wq)(uQf@Aq&r26n6 zN&}w9vdziufaFqcTgk(Iyuxd2*I?jK?5oa(=ty8aZ#Ha6#wyP{Wh};H&oh$#Bqbw8 zY|r)$q4c_AWGSx6pDrB;3OSPW7Ha2zVizs%a0jF2P!}{(ieo zar|&wRb$$P^^w(`zGW2NpDJdq$Dcw)?I-QHRhiFXo%J_w7$zXknFRU31PHVXQoP|E z^Tu5F&M#uG6#B{~1{#w#)%&@*L%r>e@V}#&U?CcdR>8VtcrR?aF6HHY2YDk;4LeIM ziEa;G+-i6~-r>Ve%$&M|gS83?xJ{ii9A*NE_un55AFp>W#?g_GkjC14?kzxBd?()i zBfnDQM>%EH-OWtoX7wm*7B`aKNkxIxz**&zTT8PziHP`=`{Jmnl ztVj@dUfMl&^3`_QIzXg`v5UFYirlQYsiK3$-YYEPj9q!}o^J?ALrqWJI`d(Gim$$C zEjQ~g)`a@UtO)3Hd=Lq3UDX$f*-QHYH6%fKi{;J*UI`0(eoAh1hN8+;rkdQ=GUEQNOB9b znanG97FvL{){41M@}QMTpKg27Vx8A_!tWlj3>>RSQbWb7zskK{>2)(9m0J%=XM|ze zG0%K-eAApGmn!5)bDzv~2w7_(iaIyFp>?oQ+x;;030QWTPM(YsV?ubodJMC!S3#vdoIxuE;5#6QuJBebjM6F%eaKL(gzTO z0*NtquZfDnvu#8rCE-LSb7Hatvg!rz^}Wd9Tu(d&hFmERBD5Yo%EgS?dPUX)#UNAn zNa)6ofO09G0e6RDP7O*n9~;!??!CkL+?1Wg47|V?i#yJle&t_l0gS1K(eDcS+h>8i z9zCoq?@-a0CI%`SzF#d^wF2GjZbEv#>_HOYFy#4aedFjEnkt<42dr1#hDz+V6&Ix0Bkna_VZ4ZX;@ z5ss)DuC2>ViAc4Q!YOXc--r84luSR7c~i4lYPH~3i+VWY$$|(d%$`Y;p$@wiwjSay zS%Q*&t*`TP9tMf=<#9`l(=AT42JkW%6RrOUtGHy?SmbMDl9{=Z9}m*3}pXxDE~G5}HX-n5SoY$)gbc4RyaP&YPaz-gDTU z!6g(?0D%OARJ*8c39<+45M0A1LYtwYC~Si7;Tkac7}bA)P9*159GQ|Q+53y2QqbOc z1S+)o#Ge-+ObPKAP=+$Z-@N!aX$Lghk_z=4kl3HXk>+{(imx2J2MTVKbRRx>a%H)- zQ0moShw(wMdWOBCB7|J%Cc1doM&m~&K^|HG2k{rKlv;aQxda@Ud>fIQ{2=x#TDK+} z3Fh*ie|Y9jsYyNbc4ywyGbdUxw8%sH{EpK-OuqM1d}c+9`29D3##IMaEM0vGU_ofO zk*wCXjgTwQC%d@6&)j>^PFZ1rURGmxVS(s3y`eZM)3fUh&lbn#O@=Uc5WfC0$fA>s z0^Sy^7w;u|3zbK_+xpneyFy4e2XANL$Q+w{^Ig-`JGy$?fb+iJ;jGEQ!=*dWw*qu| z#GcfqDO5nR!Ol{ji;S8ISp)Het=ZEmUJd_P_+w3F>0!kv9zH$s%v1bC!miMgNDB6q zcznO}D#DU7C_#$+Eg92FknZRKId%FR0TBb30YMc3eKbL(o?-3p#=bqU`gOxe37zi# zUS?MM=50*Kkf_&Z7nxIUMjKIXy`bsta`xzpSGr7{sP@u=JwRaTgVT|oQ9c$YlVi?^ z8|qeXpZ6(q=9S7BI@880g0?Lo%AOC@P7)i-Ql2w}fnfnRZKdl!e^V+qjmeT@OM9ur z?g{SOXP)Zj9c5Sg3c^Ksp5Z1QER#?sh_Jg4_H6_^~!;+ONzDvSc>xlQ2 z61tDoXVAX=U^cG6GKg01v5sSnO-DO49RC)+-Tf2g=c{IEoF2%2p|oFB)XXAHPF><| zOK7l&2vE2JWZt*VRI42P7b<7WJv6b7;}nt5@Yr5B?}8)I(9jTQ^BYVYXz6*N>vK94 zY4+A;()b*C-N{!lPz3VRti4=3TUyHSNx!avRr>PggKWROf?v2$jnc@OSvpaAvMt>n zE@4`@?F31UfQLUuPdULAK^R!aiFo&v-uQRsvw>i*EjEds4NvAg)|7I`6JjdACi2&R z>6gRLl$`x~VlY@hj#HxvgPb9};`BtpO0-6nM8ZZyv&{ z|C?4>9h3QVc(`ui_AJ|9ku(#!?}jO@LIVGu{(-O!D~pl&*vZG8=057o(2z9}J~gJ;IEPe$B)WXGsq6WRkG=fR=>Tc0 zb-R#5w{Wkr&^2;tQ}605^de-go>vrv=jET)ezL)--j6Qs>7u*JWkujK(glt*VG!6_ z2D>S9O8=98iegu}2wl!S^MXHFU<*Vm|ImM=H-qX`-gQs*K!2R_U5WlSdSwyC>3Gh^ zZrlB~4LGlT;qhAMMSu^CJbr|^i)?Rw=Kr4<6M*z8J>bO@`Nx3bfCdi!H#>gbYmi(o zUbKvcEn?RTG@V8K7dQL!_iRAS*p@I{VaI@gRYHxQAuXj1NdvU%fm2GDmC$26@^)bIA5!B3fUXJo zvG~J_X`B?Bm>4Pm{WfqBEhvmOD^1^~oyPO#>4WGc12QFrFn~9uQeHm5lvMw~PW>*a zO`+lhd$9G^=3;}Vngj0uiOFxunVCc{Z#DrkZdXb%Di?s=ApSw_0P^kKM;Lkgqm9X| zqwo(qxp;xSX`jR})mXg$VqV;iQ{uhdde1b1%!z+tiXcg&X273Bi02)y3=J%xwOZxjTN8mr~ zi2t%nFhPYs9SU~w$AJMpj14-sUwruXx2*aSah3!9T3&;Ux-d+7=-nPhmn$&bqjD#9 z;CRqSt(_aY!3f2F%B#)d{M*f7VE+pbsiQFOgBhMJ52FauIj#-z|L)fR`2GbkQW{rf zRGn@0A>!0f23!;_H!5x3Jnpel&fh2Sk$90!FWI!T*VT%wEVIPd;I{@bRCs?zrf%-3 zQV++B2H@s@xu*F~LO$l+>74@+rJ$NP>n`fbBBuPM_kP`~{0pP}OeuMRRQXLSnL+p8 z*&3cWQM;-_dT#br#F7JZI6Jv(wDRux6<^4C9>d?8#G^(iJDHgEzlh-})oL*P7fGsJ zU{xUhI=x+N^Nx+M;&VGbx}nCylt=EkBR6`FQGhSRA38-mc=3ZevJWvcLxY`2=RYa9 z)0v>4KKLnN2bX zMhD2{7Mlpo)T)+_*J8%$#f6CyrjAitWzA3*1iq(er74THJg>@#{(t#JXd;PG%l|9C z$Wa%kU4AMlZmTQ6k0}14P8Os0#EpbuWgas=I@P0=aGT?`W)aTwYD?IAX{HT4H~TTC zO^sikc9{@TPXu{{JJ#097m|m~$M3)4$iX$ZE&ws|?*WaRN%&rrt=xkAxPlR}l((oT zWoc6-@MOn6el5`NLB7@G8@Jb_H4;04qrHrx_Oi79tfjO&D@$K96y9+B=MT^Pa;k}p z4e{TjW)bLZsP3tUpJ1$93OR+yNTRKydBPp8Lw5##M5GlwsYx@CTpT3C28Zf~6wweD zy_U7ukqH;XayYUt7jm;NAviz6=AeU1^QhEdfaa525T8_K&K|Ci&G&!g7Af`$VQ_c$mv9yM2m()&4l(?c>Uj6Z*TDS^R z_ZG+bC7@e>K-Iy5X@_ia5f#pN*lD0bBIB)}R+hSuPLi|D^z?u=H@>FZRNV;n8Y1gE z_jO^+y^mz&Rg`Tyx+SNu)23-+PQw>T-I~5=niHJq66t36VTgvz)-%$?f_qe7Pl$&;?D-;Cxc8fLK8 zi|(ay9cE&WSzIY}?&bL|(!H$%%iA&sjp@lWFMS(8uI()u7It^5UU5yPN92;Nw3ndW zE=zJ8(r0{jFKxttaP{dkSF&gf_qFFWM4QCa6XL=Kv&XHbdMi4TwB)x>`Mt>h;R79n zM|S7#cgV(Vnc(WFeH8R9vjDPHBU(;_pbehh%)Ef(zFKxuHI<2Ja#K+i90&y1I3r@$~vyQA@te`;Mak+)e){O}ngG&EG{lWlqJVT;O; z%HWwO(`$-F&d#?9?h0B6!z~v*>&(LF{7G+m$@QYeNGR%wF(#bd?s14pY2M|Y)N!@v zldm^DQ4-G!udPB$pPV{6Iq5n$AjL~I-7YlEFeSUsAf8s1@g_UZd~TFHFQCRP5{q>4 z1D@bf#?X5N4g6s0n}dS5jZLtIc@z>=W+?QlLH=@@7TE=l#>J2S_ zqf)Scb80Uy3v#yVuXE=Lp_+Vm&f3X^VH1TFVxi&0@1o@N@vRM2zAFeeRE%q|etZ(4 z9FTq-QTzxY)x9|Pni&e4Z=f%ocz4|uTPzr2ElLNNsPDQm@^?2b-*z?w2G1)YG}x_U zF!+V9?+cg}>Z{eZ-}yC@#PZSFFczmYbIX3!Q@GwU85?T@vhv8|PPFv5<0;x@xOpej zx2i7OZ@T5zUmUg*%dB&7cA~=V;_o`ny}5|+0>~ta zXrLI_)dPZMPSB%jJ{yE_kiWI*;!-z)pWc0ym*Z#w;dYh^`t9RL<;c2=a=x&Tn}VSk zndC_qB|WfAOR(YU*-kk!fMws9LO1{UaCc=>ODLEbH{7eW)Vrc z^PP<|d@vIO%2Y1BZ9Q+fEmamuh_Mp^gYdqgI-Z1QaQRCUT!q)+x8L}3ZBtUw^a)7t zi^(|yt_`=m#E?~OM|e1-Yg-^=MHiX1=A3q_Xw>>l_ zo}6lDN$Z8ULo>_YZLHK-bZx?a7s&}ji*xhukiU*fNqX#bhV~y0Uaw*Um64sZu08GC zdVI;^=&Y8@O2~jj_hK*JTm=1Y5$XqM#BUz_4H7i1@zc{H;u1xp#R>(yMg2c3N%NYM znqL3q4W9L%81rP{o5L^4e~rSQ8>V}z{_1^DQ0}sSQp(Sae-=>w7e@?CKNzLPdS$4*_oa zwBHp9zG^X(wa6bH81vlst&A;5^SA*8A7R2rxBmlo8X#shjeBMEz4rz7Pv`BBzl*#~;u;nj+fw?F`94XI}2K>lqqX z(Jk0ScCb&kskW@9pNTTc_fJ&%1unOQvB@$nl*brLAL6XbUu>THA$_YvbjnkMxa!os z_qY7LRxyH+6g`0!{hb;y?nbBw3E~d?kFOI-J3(4X`-a6usV^deMS&EMz2|Y)cFG14 zhassZxPF3DDdoc@YmI2XMkwR?16kWCL5jNJA-8A=$DNqpybaY0sOgT{aDF0`(3X#7 zB&-py%a$C&?5};e*D%2y76?ZS2+ml8PMXr>m#?|A78`ip_gqV9ys)qC$Yk_7C&;pJ)I~ zSWKax;L5F#_2B{fSOT8CCxBnC`jGCVjP6){OzQByi<-AiWCOm6cY^QZkhhLP)~?Uv z&!}mRciV>8VaOcJQ*7A_<=Vn8 zj-J1#!3q>st&x|Eq%(?lr7*oilV{>u~c?sb3+EUo?4_OVC{Gjm?K-;&p zjlVi?|B#A7v7@kMZ^^r2!!RI}_PK0gA1&~6)G2eTE`DBpUAol%4~ZH2iNIE`aQbX} z&4UA8$MEHn7&dHVn~NB_VgbVO1yd}e!qY(8-8Zd|?}xSC?^jJUx{`=1iS{ML2;{@& zh3-@WQY4s9On;rEi$51gW)=+$k&tRl1ou-lf>H6)uIN2h9!~85SQ~rD@|+O)k*&w> zca49ssmlV6LV&(f1;eLtSPuK~jbe0|8KpYI7Sg!KxZjF|o4{>dJT}6tz@nWf6z%J_{7!~n3KZeX{Pv4|2ZmH3dfz0CV`i3hRbuUd zbDrB{Yv^tW&<{6EQ10|{gS}RpVLw2DL5dw^pzN+@=|wb2$UW#xnno;#55xaPr=vR~ zBu9^MXVAQ!C5JID61&8d1VuaPE_jQ_#}CrShMCJ;1@)MGMTO?4wd#{j07XXP^q%HV ze*jSsAE_Q~Xl9o}l3yWmfRq>|fpgskYw?dtFAHmf&V#E)`37LV?h^P}x(;15eXnW~ ztZ+N)0M|8rE+^Qk;Jkw+U>eHy5u(`wQC1O=c!>|;%kZX%daihZ_oI|P;$}_V(%f|# zbtfcRyuaQZ(9mjOjC^IDop}{-z#r;RRdpO1+@oN3kW=~{u|md6msJbOy)`uRDY|DL zZEKWOjZ1ClEf+-|>zq&n85mdtZ=++>PP`AlQ$vX-e=icVZ*(Sw=M1mN=3HTx>$mNw zwAk@AggFArc%EFoG0%3DW>J;ETc-Cem&=3Iz!PQt!Y2C14m|EZoCelZIhz$Q)ugO* zpj%sEcPSN0{m_JD}1G7C=x`#FVR?kRSJzh>;(EBbnweLJPbbff;9 z2R#vP!&m?i&t6Hu|Y}=Bq=)uzC%a^=_t2Z6=FC+4A45lbxGV!{M zPH+pEW-JV6^v+X)y@F~_L#;6RdM^BlBEIn59fX@p zZ}vVDk8qZkXc2NJ$>J*)?_>2zIC!y%@Mq z$6#+(Me+c=OU<6?v=zh60F4)&$gpip8Y}8nZ%zx#ZvGK~yKf`^!rj}V3{=aR7ra~L zrNP%T>BEq%y*NWAqhjjlPW1++uORrATaS-Til$n#3pl%HzVk!F2~QUMVdkyMC&vd@bHQ^2q5I+TrLY2o-h_fK(Im_btODN^`x5zFjBN=@QUW)aNaV@#O zmag}_(}5v*UCe^-z-nExViXet@w5<1^gA;`H_8vYa907X3!R9z#3?p7;dWp${#-NV zUUKpV$^n@e2p8zs2i3u$9#ozP7M{FA^P5Mzm+_N%5ZnF7Az^qMqGK2@MxMlf5yp|vPzm$WS7PB70~BS zOcs$QZhtZHrJopvWI+M_ui=RXbo6ebQ23@=-8IpI_i17Q={3R_g|}I#$dtE;vx)?F zoJ-inigxc?)B+Z}-%(())07LB-qA$_@9`u%+A^Po%lWc(9kAN;;)wY>rgLA^ajbmx z@p;c5J3B6^U-wV^*PIFX@#S*cI6i2lU`M~3VHne7Iaw{Dja`Ig0CM`)f7Jw~!mJkS z(EY%^`|cLc|Eq=j{wa2J<(;9@z~`2-PXfpHMN;O`E>fN-uXd zu|5P_t*6v`d881!EA$`kZFVWzTt1ov%T8b`QT%wkB5qxc!n?xYv%mHHwZYlQYB!XJ zp{wp5-4w_lv-&pFvQm(0UkGkKG{Ne-XlNivVm;Hd-%O#KqGxJR~H< zVx`Te#vGKzdio_QWu<+3=!a!AjwMl>cy`k!P#2Jo^mWj;5cZe&cS}&6KLL2hRxbs= zQdc>!52U;cr%zeHc}ppZ$M^FUA8-;Xn%c(46To36`?i2pNeYI;tHew6FSHrur*r=U zb8?!)w%7kVD&^!|2DTeKJzK?K&9q^?l_+>hSypC3m&%CV;;C~A?ME${+V59$) z3TfE?*c&=P&D)pO3wphTeic|{PESv}XqTa?Vg-U8 zUI0-ev!dZc+iiic%*W_IE93NF~Oi9UDia^odH+m*Rx`y(DN$;+=>5QN2m7rvnRDMY+!7U6S1 zPF6`idZ7w-5`DxHr1Q z{?Cx?Ze@One*4-ZAIn#vUf~_^!LZ$W>Ff0owg{+KzEhPO zi=hyqaaEE(<79~YI}8%mHJ-?qjCVqDkyS;Eu>JneRZ(B9WqF1<b=|9}@kDPLWdd=(B?5;3_ug%Wph6tq2P`>7JQKRGzyZD%;h z1fx4)mXjEXrjS zD~)0ce)nsu1dp^|8Su!pRET4h7k&F#7f?d8N|O6oD99L2$@T?HL`B?q&pll59*Bnj zL^#7?3rM48y8JfmC2LeSaWF~0$l6W(+&`!Fys4(~_J&|c7ExRzNO7b4)yThW+h;MP zBdd1|aNB~TJZaM`yY11J7ZVtmCh$HW5d!RWFgl{rAi`HaNBFmgwlh%DWemFG&NjVm zpyGG3%28WpGhndj6~7p0|BX{lX=2-V30536(hJABW&;n^CBLFF_G1xCj(MZIs=emP zI`l~f``m}wtz4Q0TU+;^*U#&)n1FS=_pjIukNbq(7JDqOyg&6I&9Z`EyZb7Qf7KCw zsCCR&-;stl{w|j}>fY5D(n`Fq<5`zfNn?lGNX=hU+(am6qCUe3N4I`bxeCuccX_7! z@*K0$FEPy$|M=RSSuqW03q9wnL1!kxy5Vj)6Ist~eTe0=-|N397{pbrZ3R)1b!O67 z2QRbG>kn;uW0bH2sKXfhz5J!OK+c_k#qhaeGheo%l=VJwUfu*$L6r3@=%ltxR#PFI z3hHh6!)bh5Q-(dON4vQBP)CF-mVrn79l($M>E8yMvs?GCV8N^zcSr^auvrIGecrtN zmE{wW=uVKzFm_5Rbu7)8+!MxwC93f?MMAJ5->lOf@$4l2aUDP66WODz3&dm9!ckN1 zR1c1RIdC##uvD~jgf+7#gH4^0s%O=mD6iU4N7;_rs=TMx=Vc$7}squb*8 zxO{ri1yQe(fuKVNN*0&IEyBXBgnLhgTh=H*|o(a;`PGI=T+BN({o5Q2Vq zk&Xglb(8Ktw&Fjgoa_z&s4_*)ipK=xL83pteQA^wK<~F6~mW<}6pDW@N?N7yzll?2^YFb9OPVQ1>({n-h9FviMjcUc>dT@J#_Vx95r3jQ;d&_g%4~TWJcXBn)#;o@+89Uq(+q zX&x2~noG)WbG1%mGZc4^Ti@1!`sw#-SJf;I`Yd?PC>7Y>1==2Aaxh+EbaM@Tdlvh3 z#s;uIsD2$^JBnO=EdR&a%Xp1~8zb$*0Yow`^uI(h0s=}tt>!+;g?tsmP1|=@7+mMf z0!;g{)28Us#0b=*7Rf>T;>2y)46}(o@{0zX;9Hw4IB$W5YlB;zB#X6tCPAmSA*ylj zEIx+}<;OA)m)OejQSYt4vg2+?qpY?C4L(S^_+sm|IIbsq*)eI@I*S3pmSJy=3KkxtHJ$3T|5ms3zKf-fvsxgD~**XQ6sObJ* zx#sOvdIZ1z*V^Xc4 z(wey#E=lJ?1QI{L+LJm0DU;dcU2Oa@a5X;)>T&D8y<>XPxp$G$L{OO#v=gH?$|5!NMsV0 zYu}n%_;O26FhQmvWmm8LW5b@UhlOsB;=qRIbyYz94+Z z05ZHP^o%t5i0kbqc$?kk{8{+oYk|Bdoaia!V{{wYQ_nnNq}3-09RKwt$`<%fdIvtd z!soojn0S>B6|&Z58y0zy)XIj#p4yR5)4I;K1Q1`)U!jB?Kd#p^L&;#wQeq4n_j(;h z=zvDUoYRVfOyCFQJAIaX&Q`kd2!HZwAl?j!A4J0g~Qr*g{eVygZvh-4)R=s`6TwKp0XIeNTVhS%dJlBHuX7BwX{nC8E>I%b5xH;v#45^uD?jF05Le zsTNv1-M%Ue&Xs0^uaZP3%fgJ@!|&}T)CkiQQX}Ia@t+wchA2S4u5oOTP7!{$c3Rw5 zEEiHNsy!On64$@5<};%kQld;@Yw4EuGdHUIhaCrDLVGrs*(6!HNH}_W`1MG{32N!$ zE?gK#o4ifE7w_9|4_LkXXr4wS5Lw%F>K4=`zFOw*kM@O{LbdamoP&3oTG4tu!RPvKoq5f3RBD1bM?r3w8VUHbg*KEdl z$xz+*!Z#|6dN-3jyHyTPL@~ZxZIm(_8tTdPvdet#=4LzLT2;-aQ2o_aeV8xHxU8^4Fq?GV8OLfZ*mzhmRoAMnUh8@0{7u==tz*|*@!5CV zAhpoInWB5V5zoh$P)!1g9^xaoZMZ!2-Yf9z+uO8WQ-X z0{Q6{-Qcv}f$fhfm^aXiIZ#03Xa?IWd#)qE<5PgsPQH6gYDbS=-hQT)NGw9?%F6*! zLCkYr^17|M8XMmTj^!^PT(^kbwI~sxzz~C-OUaRm*Mz*mA1ZB0AzWJ?A95*RvHSC6 zj0Wo;@Y;U%4F24FkW^O>{1ETBe~uk@*R*1GL+~Xk1XHrbo{@)G4pp_Vj^3!*cn$-< z-N2UgjFx_*tu_h&8|p0p*8)kLbbvHY-Iw}irz@OGv@Y?)g|6PHa^XNJy9a%b0nh*>7SEQ@xvm5v-vhDyRj@$L1iXYuvRfToPCx_!?!V&gI73sYoVG zA1LF{g5O0D=rqt>#aI$v*l###Mom~u#XS>eh3RdQzZKFa0 z0vp<5kL%Z2XD1LYls`KJBJVa$2$dH8>b7Tjp1C&PFZ6n*ON<#XmmHZ07U#-eL2ekYi?5H%dN##ehYjfc-XF>e@)XMML5CTed? z%45~yHP&dIy4>abeeuJU1LdIrn&c-f79J}4oYXWqngn>UorWqaHA7^TBE?O&1H*-B zI`aK6t*>np^VpHjZ3L{7le|?1)HnEeOzb=Yl+9QLQFrsbqRU-$hCm5y#IL?d^~oCa zBa+U}+j*pJl#^Q(;mx)$2Rjk*V)#)@4e`8*WyOcTGn}Yfd)%FYH$+LdiG27OJ!*b>A;FS-q<#y{^9O zt~u2mtQb&$tcxSYN&FW%#q*W&9Um;y~8Q%)K{qeaK?HY$U>S2btQoq2bQZMV1_|PnC9weW$m5BY0bhcXhRUXdPqs23&FM-1Tp<_G_u9`(9)nUq z$2ceKmQB3Ndx@*Vz7&JT;&)&b2H2xTJFyJ0TyM!#K+2Lv)>8)jYN`r*0pi%iUUr4G z-W>&c(6CNaE7t8CyP$E=EZR!t!M*Sr)HR*AwHn{3WdVJGWd@ap}6c$a~1e-~S{{n=ue@j6RgDFL}0>s#UK z?XQ=m|DN0I1RIJpIkqetli*T&lmI~a)beK1g(NcGUmrz-4t2TsKRjDxAQNrUt=FP=Kz{Dh;g7G64a6Ll;zQHoKPDp$XEvq_MWO6#vpqi4XU_1FGZ zRy_<*ke;_1*=Gm1)>z~~Iupzs96UBi|`4@{3hI~0^+1QB^N=UX&|6=dOza+In3A^7^5CA17XQd@? z!_%6n_MbHqIz#QEWg}C1EM7E;NSJ=n)_9ny?bw;|aGaUcp z-<|W;v-q4spm(m#<4D?TrR2o z!x4M)zXf(VGOSw{c#Tu+XNqw6s3sZGeq8K0)I;+b67YOrlWWz}kd}sEl)_sZ@i(69 zhDH*OnSc626zUZP8K9L3>-!h9!UFSYxN)V-77Bafe{_F=?W*XvcXON5k*#e|?`uv& zsh7#(X#&itI|Q}NZpw3R91UphpSW98!R#$kuf__-vZY0uigOc|U3pFfe4@FaC!J92py z&&EJeA4FnyN%>pY68bQ>nHSW z-9YVkb#iLpxKqG6LdQ5+0U+&<{7S#qYl{B-27;Aigg)`G#h@)vqt4 z@Pf1#hb(00MX+RVRCmnu(`f=B%Rt=*C!%+gTDTyD+`QVfdk`*(Fgw;k=jyuJg)t)* zC<1Q4=@ZA6U}VGGYXB&b>IZRLg%w39j+bO~0vT#Q2X3})zrrS+a{l;mWBYS1J>Njh z*3dxf-AUJ30u4*NvhwqBvJio?V0dpD2Z$$bTf=eUD45*#d~cEHB-t(uJn>#$JS||0%@JYP46;v~8h&-fz~^ zz`Q?WL1n+3;2}i7-8MHQVkiyJv5h4=;$Y<>WpyieN1YbR`L!xs&nb~%ug0@s9|v)W zxvTryY+MrCXy^OZWa)`eg1VBxg-Low(dPf`_#fPI`>P`X3;|eF9yh2mJcLCz#9%+6 zk~sb!v^}Sse;SNkqE4~|Jityo%bzOZ=tND&nkz*g<0S^Ou!@dVoYNz4K~L zQyi>pcsPB=dkjacyJw&5livSL*fbAe?ZO#dcu^%%2=Rz+NR#R7F=Mw)3OlOPxV3os z@^#XbD$;CvBq?-yE%L8XjZDU120(0{l>jL$A<`Z)v=^ED!|zL#O-2$JJFk|b()N5w zo=eMNv?F54!?u;w1$c*j9-)z`0!;n;A|Y^4$r$jlZ+m;?U+em~4D{Ws=7&202}`+r zx*cI_o^<4`gaIPo4U1hlB@R$AOavt3HUAHZIpynCAy7ZFm?V`K?um4+wb?gB(`gZM_429r%ccuSg zCqeDN{ZlamJkdlzYD&Y6*1uCznuK^DLfySj{*}Qu&+h~3e>V$vN2F^2YUgRIVEpG7 z0TAE(OMLYoS|Y)wYZoVfuTy{X+ddD3=v}_7qa-J%U(!c$s?({p`)&vSbkVX%$A9)- zVw%nV!EO(_cg=C;y9N4m@oKKAS}rl3v3UG@Xej*H_k>at^A;aH zqs)%zf5=tCbYL9=?vKnb8CmIW67#Nx;j&{ww||O~N9jvT*e&KR=K21gL+)7UtZ|Gltjkl%}NumP#)lX4@!D zsXB9P%75FR!%TsAV z;2OHw-I{lL=-k70eI45qOu<1PymRUr5f{DF*a<@7pQ$9jwyzV;#-w*|yJG#ocM+PT zifG{_8a`G#HisctpSUyp5^%8(wb{7LJ4>^=nKDScOWov|$e)<;ba6|N1+_>QC}n)z zd&!49kQgc|X8zczj+ULjOk54`@Og0iR~0xv>MM)|g=3ljMv2V$17H{;8h9~EU=#kPW*)lU9;|8J@vC`evJzMK$KU8A-u7DXR6d(E@9VKiuub7JRQ~PMa=<^ ztpvCbBSvL?Uf?vpXXnh$0_<@!*15&Kg}fV);#N6`3Lc&zk(1L9OFH;r1$MY01~q82 zUHLG5*dYd&Mym1FR}toOt?Z!?L7k%$E&(@RIarW8BIHJ288dC{O{q5?EsO8&>L-KkS_cTvJee`hm!W%m7OFvR+kpusx&_mWcR2T6 zgL-qrOZ08C^haU3e9P13O`q~lKCmrEBXKGw-w%r8%c{`e#GNjFmx!$st}Es-imUrKP0h#SiR$Z&>gm)@liYg(Bih z$C;!IS?{Uv%*Sf5U)SNvd{6j$j(8+b=TBM)NQ`uZNTzePuJ6+DjRVb*kU(beN-<>q zl_Pyh8$2@*ZeyJ}-b#AcpRqg3wlU)BF3ZII{@?;3b775H3$0D|WDYV^8d{(*lC~T7&+D&CFdU zvKMFN*CfJ_4qNOQSD@<3d-7_oI-{kx19^Awn249siUPqYnJ7a;_w0`4-RaT?7aVkF>>G5v(y1yk_gxto?;MJhk=q?MP_C3KCAa z-YnpXKOb~XS_t+DC8eJ_Ndk6*U|kiWODKCF!RWa8d(uC1l}om zEH`#h+_Zi(y*gL&1Z_2zw&pHtaY=&)4_42p_RwrUjaZn;i92*s^Joc}0<$E9exHm8 zN4n-9e9BOAUek6k)t}>U>SJs_g=vy>6M!EIyD+@qKt@J4{|!aIU2-pRyQ6SC23)YD zi}Bmnfz26dD{utk1x}y3Pwh@Kh8M&`-dC4TuR?lk8@ctUQlME**LObi*d@thSx;w$ z1Y;go_TSjLPmxh>p)7q{mSi7u2yWSI5MvJSGO;bXmY0Da7ScvZ-98WBUhDX+bcP9~ z4_-Cp|9qHSfEHvAw@fc9Syh*{Op}NyYOa_8a2IqbalD8juQFF8w&(PrVc6LsYYoyD zE2HvzcjlKRQg&iW2OE(MONy@$Y%?@_?hGKIj9j%JQ}-QW>?;zNUA|9Y>TosL7eMvoSlW9v4n1LoWE1BTHGri7!U zE5x>AUCP4?C4f1x5HC>X4(Ct6;o80c)8OUe&0qP0bRPsu@Oz#a1!eyTRfW^CLzSeG zVJ*wGlSENCLPS`}vegQez&Mr@zoUyGulwSgr^Lt@>{q@Dj+ z^a77(1VRLkrTg}t;qLeQwFMqxCQY`sR!u&#P`&2}7kS``PnEYF`NrKv7PQoj2XN@-d2gpTB z-s>AA9=Hv(*Jr@e5}AZbPoXfDaNaC%PEVQ;Orwg9ZW`0<&x+g;mMIF|Q-hs*@aboD zi?eo_qTi9^h}K^_fwLvQ*hBNxW3Rq}F~-vvDih9)+-4Y!@Xl@Uj6bUTb9 z=vU9&U9F6IY5kpciDXOvCb|8H>~M76f-sy>&YB06KV@Me6J}}dyra-9=(`L5wZ`=e z+zTeXbfMvTDhhBv{fW`UT|cKo<*vpEBtgG2N46?JZO>!{ec4%frVhT230NfwZW1$e z6V#0tFAL79&+$p-uFNw1Sai>SAD!xBYELq*i?YoVd@&&eNS&kJ z0yN~&u#5eW#P71s`8Qj8Zno3#ymk96@Ac%caNigtFV?WhsJ!c~G!kEAuRMbUIU5@c zt9at4+e29z=bibaIG`~8c1`*m-j?Nc^d}XAfic(XNTczU)C5aSYwi{7 zs@1;>>fdX{-TR@xg` z9yh+!*9T_yvemE+aplbXZzjJ6>WL_{-P=tXebC(uQ5ZHzNn5auU6$k_iGXoqyT3|b z=vsWmn}XD3_&wJoJyQx*VzfJVGcYrGyK#Y5lUVQ=9I=n}Iu#MnTLlsBWVT*rM{az= zWI;atw0(hQmJs-B&79{9`?i_k>}5yt4nyW z$|3xWyoh5#B?tjLSsDyrN_G>WjkaCaF@h|4+9V4~hV1h{QB(>ec)^O|06L^WUG}IK z5V-#S>BW1zDBL3H!ufKPO^)~BBeNKB=&hCgb$tDJtgDmDTTNl}ZD{$0zCG+ESUjPO zULxRD_#uInkUSIfE%TLEdF?)R{hiy9d_~k{i#vG!n>LywsQ35y+&MM!@%(}F2P}19 zeDLZ&$9P4T)W7HvHTHH<9v@RtZQ}ZD5q*`TTVly?-w-e3bDnO0A`BKazIZ_FOjakd zlV)v0$TO|T7s3iRtH_8cgz?jAO+%iEhBzJ%tbEZzJ_PWFpN==BddTVVq?dze3DL-g zK0;(ruL=rwf0O4-{I=hg;-o0~qycxeYGuEZBr(d@Z7tt|_hKi&3<(oL7tjWt!BiA1 zXdvw|g0g>@e+zlny}gS>rAz7jc@qKqZAK&4n)c(er^mZFQ}Yu%@dd7P$=4%xz0px$ zOO9`Ja*sw*wwjN%QP&h85U;OCdb=!2cN>kmeK$~hBDX~TmQbOLlfMeHO1qG=`+S5k zyhb@B#zSxTJHV3FzkRpE*@h%shJ}7+toY3Sc@VuyapdjG;*@K2+ri%?K!C{~2TQvp zVBHmgY~9+v57Ooi-@x?GmSvt=>eao&m;caWf;YUmV4B{SWE$OZeN;GiG1F^SM?;Fl zy~66^{k6j>=WcK>cC1gYA^)djzbpK3XR-05NHJ`TUO*Q zli~T}Fhn_KdJrhZE)-o}haB6AK7JDFL3%9b{hbOLp~}^-*ctasHcm4oy276kv_5gy zH|iL8${C%-(!^TRo(UZWUCY(4jVEu*`Nq29`^&vK+Ev`=o0YaKsHflUNUsu0v=Y>e zk4AXek;=S_dX5}3_<{J<^SZoUG?p9U--XRV|1F}z#pBZ_O_P%PP|S$(f+?PWnvU)E zRipmu%X!iQM0J<>=d~JF_LFmfkxM4gfq{f_GNoHiXDZkoqjAvW)`$DWq1&lfFY0Da zjiTpYY8X_-*!54b6jOt8=DyKOG!|+RW=?-hUJNMB7 zT^KvE+EF%#y>G}m{&_zaK&$opWGxpG%8gU~6Td-LVHUmoX14?Q3DNFXib`BfSd8ni zC+P%?icedGhIkmVY>$f5hoZk_DySXIXI1wY^$#Vmzn>uf$v(WMt*BF7 z-zpE4{omKL=aZ4HwQzs8w2CkJ0`zOF^2GirLX6U5ujc}B#BS+kkMxt>e-EZ#9Lv<{ zT5m`10;)d0R}~|H{7?mmTHRUt&!+-qDG3aZ2aKmT10Z|Br|`7-wG1v-X#BaZ41Cq2 z3A%qgf#{w#Hg@WDBW|#xdCZPovX@=%s~4T|)tb^Mke0|qdNi;-T$IqeSNpn_Frf^{D+O^6_Hu=zx&F%`u{1U{EyX@|EE7b zR~YV|&Ls-UhwkUthl4i$$?LJ#p5_!qp~}}s@aK4-?`;qJ1?O$vjIl-@cl(59*AVW( zf^CnB<&holveSOuyrcUy=W~yT^0#^qzs1hCiXUYH6Nds`XO8NvEC`HHUhc-up44`H zHQfzvyW{j6@EC+Yvd`^Uxo5lwZE5qWP4$uuEHk2Q^f|iCaR!%Wl|cxdfCLq{_y_ZR zSd;YgbC71}$X>Cv2MHvtmg#fgzi!G_R9bddJb~@5SAJ2(e^Vs zf?Ev=D!RwpcA{`h(iQOm{Bl7#|d;eQC{d7+HG*rpUjP@aO={P^(7 z^GGBkF#u8Uh?k>}sinLXqd8$jC7!Wq1H!Vn&ANPT;Sk))vXGC@T^%I=_kqSEqj@zA z&5<_~mwEl$NT7RbO4^?8@j(~g^xfqzLeiJ}3#Q)Lf!z~)6N!yAaz`WaU`%fpwymHy zP(D~dDbG^lkjh^J*ITdXawymGeKoOxo2&%xpzm78kWstW9;6L^TT3p)TGKvbdMRK4yfEa z%ldH)>k(tw+F~^Gu}@lA{nf;|ek{8BFjwvylP0S1k~3CAYv~FGgKAN`POQ4KEgl?3 zIzfoqwi}khb+6h5*QDz>Nf-!j+aq}oKSZwJ=FoH@XQoU>I0TS{IWAq?7XN0yCIMX; zF@u~Is}2x()aYs1Tse8gbT}!Ye0%`{q7U7W-j28TE$MA$Xz}?L{z9{L#Jk>|XkAOb zbQfM0hVlA{h^hBRCFWf>##a0qq{TW%5t2M zPeZDZlg%v~b@i3ou`dvn@X?YLoJE-=PjFYx6o(@NEz1S)%8Rc|B6j-yH!kGwPK<*t z^^NwW*gBW&Jxm4Rzi}U8#+x<#D1c$StaH{va9wz%_x)&2*NquuxT^U|uZ;A{#5w6` z9AgPA>WX6U6EYm)OGxk_{(AmV8%+9=+fFw*QSYECdk`{jwBM{tEvEhHtg5jsV|<10 z_d`_09^^NJ+V10~i$*)qpSMua0Q?q8>-|#k7cd?YG%0TeZ+5w{AX_U6%}R~K+jAKW zvbNcqOW6zPl?M?)g;O$Vt#@N7-zZ(*Z(Fl9yv2hbS-3pk_bv($6&kKS6o?GInk6_D zUj!dun||vQEk04)(Y2wp?v#$gYM8c(<3YzD;7S`<%4ea`USH!}#tR|PA$4#0jn$eQ zKhr65P;dc6iHx)9t!Z)h#;u-tFu>A$5-8;DjjW%$$8%wsM#o^{%Wd-lVn;t_TYK7+ zX}A8#ZN+T6*yuWNC3*p+^#+iF^1o)p!8Ya)b>qV}O~LI%lW9SMj*wB^PSB*=Dcn_& zLE|3h#vKy5&S$hV*7FFhEo01>I$McM6vG~whw}W;$kZ9BH;SBoobzd)8!}VqY1`FA za%YxG^9Fwm<;3H9y1cTJLi(Xrr8o_xsm5yl7+-H^?u~XX(dMAJ!A^A3h{s*g<;G*O z#o3GohUYKG0LZM%he01#IMdPVm?TRiPn`YPAOVSU+sL(W?C) z4k~m;fRvKkuzkIa(C#0>#PU`#Cd$1AqzkaV4Bi(?w{1i*J0mrp!6!pq&o6sp z8o`ZFWnvp5J$$tX?fz#Mhh|gX(URI8b9|S-8%K|K|vt^ zt2QVfpO0x&+))B3MnB<%PA*+O7~S+*HhjnWTppww&^CO_ZU$o11HqM=UKWavR0m*u zCtG*IH_l4QFh7KgI`^nnpf~t9+*(2O@ue{CQJHO-+3%Z=c=);2ysX4@k{%v6rz5+r zOg*1@_WO5}F*Z)o9Px)t-N7-UHI3VKSD@vIE+!IR{-y=$UPmMp_U>#iVGJpXLdK!#Q_TC2+EHb@^ z5A#|$IEhWeKd^ZFqi-cUe~gDSZd2bAUM)ZF!`<^)TyyYTRn28BFk8o}MKD@|KX^Ot zFPnJ@t9}VS9Q&gAvc|j+wpdlyeB}<> z9p${BJY#TNZ>p*7PqmWl%+FnLf_xg>nTV*c4`Q!vgr)sG;Cym(jqq3#8h;tZuZ;Iv z=71T#rF{8LMR@bi*|3VzwmSAy;(SR^Lh4SdV}i{W`IiARu_(=94U>Ocp1p_ z^|#jEk*aI!j_i}XE?t?g(`OGMg#khm44%VP^|)RUcAa-;d}^Nl(MiX(vky0+ZVbR| zlhN1g=%8egM2cnr=iJtDCgo_jG0fns;56vtOQ<^9=LfByLOe85ec?EJya6r_7aOFV zB~zfY5h2DonjmH(oPlz@CqbOjxxA@p(HO)gu^%#88C{4qJsNq%3+Yrv9zZosAbO#D zHk2Nx6DV~`jc12fPM|*i4z1Gac6QbxuL4qm8)TLLZBb%Y1;zz!cw@7KW4hWNot#SJ z9ulRANe|4&pr0O}ao%3%rnmh;^C1H02NyC{Y!3Zzku}8jdZ^J@<*QRu9a86uy-Zaf zt%Op9u{;GI6UXc=VZ^n{QL|5?Ysq9)iirw@-MLe6?!9k99tik!dxf@wMYddXq{ghg zZuB0O4-uP1zeI-7##5UA5WD3YM zAE~@AO<;xAr!fi?vyTG2`esiFcF$W0JkXr{yRrR?#qhsT$^PXj_zzUs|H~f(p1q6z z+3oE5&)!+h|G<*I54h(4_musAOYi~I{W6a}t!Mtz^K;}m|7H~9p2v2d18q>tncxz8 z%~Bp@sfo{?0IE1MdE~{&&W!aBt1X?V3SraKeO%BPzFakiUcqvG=Aw<0=JXyn((?ss zCtCCH(Lb?uRf~9VFl^3f7rh4yok#8ZpE5G?`7$l8{PClpf0xcHcYZj8Rx>de+Aiwk z8c)HOn%`xjh{`rRaPDNwHrtA+F=One&--RSJx{Jzb@zKEG;@c+WC`;@v+m_McWvsq z>iXz~mly9PwvMB7^)4fCE~OOV#4h7$b*`4=T4L&*-O!hZBv6&!NQ;qbS^yb6?yeO#ZwdQ%8UDuxOlMQ5I1*|Vwb zkNq_i#L|L`vm>9gQLfG0!d2r6M>CQRl)Xx26J@Z_Mw;2U@N)KoQL~ z!L^fq9yB6g4)<#KL5F)#&(@)ng)$9>=gv=cFjK*>voqDSBc~IxdmYY;wRIyYowpTD z#X-3BUw~ZALeF%atTjvzdT70ncSbF;gkwZwywW$-w9>cvn zAD9qFdVYwDj1t7pG-f?{+Vc|rM7UCRzj}A2Kf4Xz%rt~c@{?rnPcjTO{JsV|d(mKg z)j>i(^mF|IfdV)ftUF#DvBzh&4=6~4INxCs2j;O7J}4CcaT){G;8$z`KU{~!Zf8lT z*QD#HjTR}=ytx|HrpZGW$_j|h_S1k3=zrHV_1ckFx2a?j!#zAY;Q70|3Jt_oJXyp`A;c~%&_mBM zmvozG3W~jRH`!ObyBZR3&8LW}*ZXhM>#|L(j5^!8C-O!XU__MiXE8sc2UuOm>OYU` zIXnts`)CSeBi9`sJHCd?2ofr#DDoqPR3_)3f(GM-@vwxsGmD+pi^1^qvN{8h%>LNg z2w^mVK4S@0eyhlJv0)}4u*u{&8%&+|OoD)$)&a^A0CoibH-&?Q1GaL`eTVoYl#dh8 zbe2iSB{5`>OV$T;OoUvuaGQ4*61OZyiPIvktQP*DiKO31tzHV_KB500#wghe=Qj7+xPb3Eos-e3c|a60if< z)Q3}FncDA33t2v5yuO+siXrArD8x~I34phCQpg15p6>Mu=wGI2f4LaHf@5R$;D7xN z)Qfau6o_r4+XO|0?>F$m9HFSiPDchSp_ zLTnAli-Cfw!*R9p0|3wIZ~Y|m!XrLxJhLcF;&^S0&Zn9HdjDR49q5T*TKLl>*OmNp zW4$IF>Pt4(r#-$0^zwMfyOZiHzK~<;!(9%!wxEaSox+yRy*8K8cwa!tAF{EKS}n?T%t&k~Xs66Mb%uakpNq!{XbTe4*PRKtX-xaqS%+ex~e!Au)J zIAKhH>O(v%5Fls%EBGP$H{;)cwT)75a!3y;v;sTE*Wy=@qZRN~pW>s@BN{Z6^1n0J z|7)(}PjnH_beWDs@=W@WGH)%zfnQQhS!F4sc=xasJF-&N%6RXo<-XPRL0iW$1 zQ2!TQCj)P7+vyKX*D8iZwizWvb(>LW)+iG&;1a$_gV}&DsNB04O0bLYbL_X>#EVc% zuxd@;H#%eYYCmDT*#=NTq9w{%HP@}FRsILMGqPr9x4%D-wpv8n>Kxq9D4t~&_krWj za9%;puRhaMTY&5}_Fw2B9tKSAl)L^q)oa$ymcFt>qFqg&q{%Lp^mP^w@g;-2d^@18 zCfdgx0_-a^47$FAQ(e9qe1)5^Xb~;)CzwuD=Y|Qfz7ago3_vs#dkmA8FC8r#!iUHC z@~hcV%j}!6?iqCG*$5T1BiDr7aud>LHp{g1H#9-r`@H1al=3s%Lkwo?sAJ|{N%;|j zAMUCpV-LN~>OA0_scX33+WM7guk3jBIcnfrxY14ZY_(o{3_6ee9F_|(J^!?8#07Fn zCJ5Qn)lutrj(B=bjB;9q+aR$ajyLa9xsmgf75#b_e`FD9+I2a&!ubicc|F3yw0LVa z%Q1rgCIic%6gOYtiGXua*HG_YpIZ--D(H4$xf`2QkLUyuWXewO4x2caS5<;kkw=6g zrxDl2E-$w3Rj$zBHJqFm+-2QK94_!QvEYwH%$Lq3Eeq0NIEfREC;?c0{p!!Br+0f3 z)CnUMUYb+5EJ29a*Vi*B7i_zZGi%i2@TK`Wy!v>UwqOfWt&s)ydEY6FR zdDbpA*$EoO(hy~5IBK)S7^u5gSkyJdL3#B9zpdvO(A>z*{?L6nKD`wVk!VotzZzH+ z`cj9M3CW1UT7J#J&}0{khm0K7y|CeJtXVz!@j|DTM+QJZ++8v(H=!p?bzDqws7NZ` zwYv=RrKm!DK=e;T5_i8%=>1iq_%Z4 z2C2N9o@$0TpJM|MX?`fBXqR9FNcOox-jIvXCZ88yNkArF@9yc@;v})8rg3Gu$o&1x z2bDO$&dcyB3>;iXpV`P8$or?W0|WE8_Gp^~a4gH1WI?G;`T5+|7Q6Qzsvzh{#o`s3>3XVmBgR%ctr&Y z6K+d}-FcLy6Dk|uTgy(&Q4oJF8hRU2SI&Tj4r4(4DvAmX05TrVt$!4Z5|bR3+t-zF zQ95sGig`+3h4P66TJ2Wxp_}#AL4ixR}TzEfy(lN5BTBBK$+GfUW<#rnL8fh1zf5>o<8x~9G z{Ta}JFN5a3zGY*NfU#rc*aVQITH9X{hDKLFID+tUFHv?-SknhKf;4QA0vYx{z;ZTo z%BZCV6nmygPmt;S1+Gb*KciOr1Llw8<~*zdLeATf^7qTEKIY)JhyQW zx_f;_E5DhE^zPFeB~1YYFrD1d?zPmI;%T8y(CIJl8hjtKg5?Y5-ELnvJ_@;39`u%Q(|dDqj* z)V-4}v*xXV8ki5-Y)pzSkCcZn!DF2!Wz{t~-veuUqPT1SATYK$bS+r=@<^}xv==xw)Km1+ zYKJQBI>F7Ty6y^r4Gfa0A!&*W*_nA$KdCP}b6z^xe*2E9-*10~%QPGH7=p>e$!uMG zVI076#M@MlqB}_9O@nBGKJt@PMKII&Lm^rfjt~qXyvEO&W#G zo@LvcO*WFy&3C#>dG;b~_PtVSjpRXjx&{Ds9Dz))TQdF!#ji<%F11d%lG%y_o-uNZ zL6dmlAqvHqcy~x@;P5PgDR)^&Lqz=Z#n7Ub36KpUnPc%q*`&EWc=z21wG{Pb(UQQG(1?>N+0EwGu?!>#~gX%UKIUzQgTkOriN8&I5@~uqK#6+~a9h*535rvUZ+|5!IgoEAZbPq?0t{cZ5H6 zmauQ2&LjV40J=EGKYRLLlcrt?9}Ke1*Ok^f<%>=xajvGDE+i*ob44e41x>0ceRDkR zKa=Oqop$yy!P&Ow_cuW*e5wk_=Q7J&(xs=Z#NS6`Mx8qmx#~ZkuofyXTgp`~otU3b z`SKM#r{C~6nNM`Pm`#o1L--1NCT5Z14@I!5KVWQQ8FTIiPcGH&}jo;ok>j*FV<-m}Lf9ip-0ucl>|sFt&F|J4a=!Gs`> zV(Y$WFWtdJ8ZSY4hVFcW&EZm!0wQyR?*1z)^>bJVg{t(6Vdp&R7hCDm#tD>#NgQRL zX!<3dKLr%KrecrC$Q7==&;rbA?r))Q1^GN_Ep>Hry046maf&a_k zPeTfvC?BySgo-9(>@BWDl;a@N;r{`}87aPpmn zal{Iz)x8!Y;X)6D_OWc?kv<)wUG<6VL45$IE7x~E9g16fZ7|+=k~11S1&LAyhy<>f zLA24{v0wGZhaY$SI)yO_W1$>4Zc-mrpKR4lD_A35soyZ{pd_*jDP(I%ORY@zVXOdL*J)AU>Z|O`3Y5slQ^4}yC(76&!puZ*> zB?($F0oIf|Pg&3GkHTFsXYb(Esy3N!aaru`{DR^cGYHD^KpzzMf7peG6_I;8p5Fcm zxuHG8Q3_(Ov=m(q3h*@Ve5Izsc35O+*E3PpKvBK`k&_8L_s9#9yqGY9DpPf`bbZ@(R+ilsY^iq#G zx=~AWMJq?NqJb>S2E#a}(Xa1bEn4mNG_cg#p9I(=!uvYGz*)X3^7zS#Bdd<#?xgOM z7mldtT_gQ{DJs|XqfECdS^cxzE@6Gj`ncjY2`-~$3{0p=00&tBq`al6`%fuc-2 z$n+9MeB}F*hRt~U*JSlkMH}Y<(Gq6KR45moY6!OEWvKXkOc~-8Ge%sZ1rkck+t#V9 zuZ_LjsVbhX4b*J_#k&8-Zv!$bM9njg$uA?O%HzKgu<_F=b|fQl%hM}p;LvG!bEq>i zH2CWIH?D5(dUx0|k)56hB_6vR_!0^_zI`^ZBPtQYNxo=%v=ysJFQ5>hPNj$D4C0Vy z35W=n+OGH+fOzL|p@D3&c`A|d{cWPY-M)pFuQ&$II+kH`LJhCM?{@FyG*=CfU{|=Y z;f|8cavx`{oOQRlqeOR!BZgM4&H@RXz>hSym-y z05mYqDZ8t4mw*LTb+LBBgXK6%&&`Z;fAcNkQf92Auv*Yz{l`%pbvXbiOl7;oztTnS z^)(HT#1NU>708Aa;XcARbimOlQUn>%7HGF$&W>B|fMKR1fMoK~|18h`$v{3_`rfbn zN&9t~Z~!46RQfyB^Cw0d)Zf(A@vbse0@9$T;>+x5cdv@%uilD49?P@s+TD|MKjZb2 z+X@hW0Ku|*mMM@l+g&z5WKX%9ko+{-KBdn&5{{|xea4fJSai5Klhw5t%VB*TNV|v~ z8(F4M)Y1D*3;s85%xpfxpzRggfXTrtI;_qi_UXxfNqkMM; zu!-o{>s?IJN>>+9pU+5l0)cl!)gf`oW=I9WY|WJl4Z+o^SYZwIA~~UqfQWaxPL|E*QaAcU%#u^R=w| z>u4*mn?{r!&jOf!D&!~ajwLnV>#RL|CL4cvA{&>j$#VoQ*#@wR$W=VqQf8jY7a6|=CK@l2VFMa zFgoNOOj)Cuy%(R2vljHz?eI8tE~_lh4n7g4ww)NS8l4VR9}G(Wy8wWD(rtNm`y()R zB4E0__(3*uk9y(!Ahqr15zw*7<`Hu=ZWxM6T7g$XKMib+`%wdUuCIXr89ifLIwsNJ zaQnRHFqH$N4yJ$IFTKaGklo3dAK&}ub8cSW2Ji3n(3TZt?xftls0+XKEGyC?ttOw= zDld!on6PhOpi$ZT&Ct5?XW?rN9xmL>uVz)nl>uAA0miuL!5Kx{89G{3lDoL1On#kI zMaR-%V5K@V`MQd)@_yUuW>`XUU^xn7r~e{?Waj%8`l)C7hUTejKUY0c3!x6T9F(P9 zN}HD33(KfdaqmU~ouX=m%zSI>y2Sb?0aWLDFr+52BS2{|D&Q)oMioSi-RJV+u<5>Z$8qE79@Yn$ zk?_u9A)tBk6Dnochs)9{6^i&-gt(qx+bm-E}OUd(&n1!U5sV2u#NSFby!` zR%&NctC5BHh%?(n^maH|R7WSfy}!g+_$IU@;6d9`lDwS6DS_6dH0;AaXX8=M%26tx z!rf_~^TuMdWb5uTG?H{p=E}P6CUzcs}85;7lf%?CT!uZ?uJC%qRwwE zOYHa0JRQAM(>ymf!U@IHB6g9=tUuJtey}YZ7D~V+C&^#xfqd9{kf&=i?RhJJk>548 z@~ozt26VN)Lf9%XmQ%Xr3eoSaQ0ux2&q5K%D3o z#}tYmH@mvMw zh}6BY4f3UFgq6ffvI|jEA^Es34HN(-jI6rA^kwozc>$fr@9D;2@f%L5n$i}ukpmE+ z&sdGGs}y8uq9zbm%f_;r>l4gfsAMvxfVlHeZL8BH=x%`U_g{QNdxq znAj56+p)PO$b{)?HC_N!EaMzOrpYJ*1qy^%P`uZ-SOTZ5Vs%I17K^%F8)3R1#2mn> z`$Ryk8%4{L2!?YrT6%(aY;%VK3^|Iv0eJezlAeE`eM)4zOYBa*>WeC{0d7X zWhuOwrQmS%pCU%~AQSA&*ub(2pBJAd{#E2i$}#l5TqhYoGyl=$D{EVRdm+XZPU%PUVVa|r zFTwxY-vWRdl?DGq!`QOja4;w21f~A8QZi|OILQ4XjXAUY1*P@b$|Vl#$jvAjm}<*@ zN_bY~Ug7EoyW?{WpiLa80kDolnKIIfEKfBmLXNq{e&LBg)tFV&Q7>EWiK=`A&J~K~ z$ttolD_)bcvHoQuSG!=NUORVGIfRK^t+cYIN9TcTg=(v@;X2gSqMLN}MEKJd+UvMo zb>rkOOO6SfMsY{K11=Wt4#;$Z7g?tYa*Trm)vFvPD=u6e0eCA=3U&vIb7#BnB?%qQrT{Llg_X;8L8`A6VI;V3Au|W2O3GEN@dZd3uQmY}mVa~Lh zaVJR#u!jzpAWpPHMv+x>Y8p6`P#-D-iSTgbWa7ShnN)P9p`PH)c`ttb63y%^Y?>Cn zczjnL^^KI2wx!}HUJTvpURNld<+u9~z}?S7(#!1}S^At&AK!S5949je!ENrj0(RJ5FZo6$2tGaBA$1R*@`l$*W+i-RPN7cz{@+z z8K_9DTQsF8DbaJyv1BD&JYgJiqE|Q47$aa*^hrEA&8n%baiOeIR16M@Hm5O{cNrYs zrlvh$ z%yDGe*YFjby7X~~=EY!sZE@HIWcI=45B_TnHTbxjvZ8o{F0#yVuq7B9$v++m7yqsL zA=qz}xLe=<^QghAMlv%%diZm3?OL9;h5Ok2^;>)Ie|4h%V^7WK$0*xs$5D}QDXRL)W|dqehgpLmCR z7UKStxA<-K>aC=0?Lg}U^V&I!>ABs3+rz+n!+iag)=gkx>kwTP80CibAoa57`FL7 z^l1X1UaL~?2;^<_@BI-L?3{(WF*ULQUu?z|WT>T;&B6)p1D3QTyD)kVk(*}ODIJiV zq>~vy&gN{i0OB&#+NeMbM^?%eHz#|rznN`GN|-Nu(SNWV4=)#nz#YD4L6qm!b~Wbw zQ>G92YnG}|#%`=Bqv970XalZ#%5@d#OUqmRwjU7&p>|haXtc;s1iFda8Lur{`DZG) zS`-vKsFBf-rKenVX{>beAY&X<>lS3V5lxUmg_DGq>7r%t!7>PbN&{Wt3oI|{$|o~^ z=|U`wn{gs)8O*l5oTjTe(*IS9vhZdW`S6NEN2mwk{(05^@=oFI_gTn+U6z8sx**SB zH2w6OhH+lK4OY3EPDu$Qp5H*iA{vRT<23QSPVTKM3$F;^;`O-SZGUCV9jjF|r9ZXV z3;L7TAcwmdfL=L>Of1wILBS7o+}a)UNr>zg!*TAq?va09;h$brYn~7kOswHj{T40&&>BVv|LMbEB^HIo zfF-TVg*Z7gW)W1t!Sj@ejGy#sJFM)y9Je>>wV2-CRgt=iO`W$qc8)}?HUIT7#XjhM zBqYh4PzDWb{M2@YjKRsVqlz`xhUx_Q#&4~670WRWfuY_K8dGDY8c8 z*jI$uuVel7=Y5(WkkIMkF1>>RZHO>PET=!<+7)JOUs8xQy#$tx7kE6>@LM@to*ej6 zsK(6(3Lu#xhb694)__?TvqJr5HoezG9&0au?_tNr^HPWwl1ThsxFUX)Gj{uW{JhEi z-%~eIPlKm%QEGTc+sYB4m|0P$f~|IuJm?e4&2`q#?>i}^xillxAvNO-d{)t&VAojs zh(ZZ`Mk^NL#5j~_qf9&Z>>5^qWoS>bQ5*G$htWJOI|QBO@^2G_i5#HZOyDY^!~}|fc0?EOi;!;sl&jX7_8Eu{^j8lZrTi5&7)EH;NgK& z=Zzjw&6edbHxYh7Jxmvy)_kn7<_%3S1IQ3RXSb)y!s1H}wf>Uk4I_}?3ObpGjEp+D z7!Iy*z(5;Lk4vThF!Lh4{s9(ibW{n_8|EargGAUhfwZdr&~`tKje_KBfRuh#j3)9p z3~ovuqDTX7N#i#b@l%7V+NwT*r+V2D5va~}K^pCPmg2^pFZu^D%;_$7B@XR=asYG* z;E^My{g^VqrXRB8W245zL34*=c?8Jp;i)0ao%54QY&mz8DsEPG@u3hG!ya%6%^m^* z*ZD$LIUkz=?!mYkR~4+8VI;^^+NJajlIMegoH!c604eik?FF{jV!Nqk7@`>mtV8Zl zpTOOsPaly1hiI3tEAKT{;NlUuBM2Ie^rmA@*NbR1h7n(uWA4nGO4hgJgm4|2)7mg8 zYqU>t*`*(!gtQ$T>^@S)>_aVaU8f>sCZ`wGRsExD9Iyz-|QyGq95dz`AuN{+bJYEki7ty z8!45i7mpuq#Ne+U?b6*268kc1*4b{c#ws4SjXF?k)YE<3i1&V>_esXx$cDGo@3yxjT?FJ@mPsNt#fzA~ z+u9B)8MgjId#T7YD9M7#^dbLnMR74Z)s2t${0P3!;CI$h@XC9MIrIne8vNnLOJp1z zw3)dA{)kFs7rtWv4Gz(MB*`JbBu}sRs#`Lk==YrqP)_Fz%$uR@dCSPA~V zk-_a~!xz-l_-W&fvesWdU;x%*?`VQD`%r%a9Swx$2zUR)s{#7R|D*>4PZ*jAQGMJF z&Q)%XV?Ja8V^E;es=&SZ3S|lt&7A9Y@GVXskw~qhWC34b44;EU6u~90}K;eeOS`i@1jB;0ryM^^ba&(U9$#7WAGP~EFX>jWWw^-(;G7`~&x&D9t2^}rhbAEbZS`~Wl1ti$VuZX(%N-L2*MO}8iv<{>N5=|?dZazUQHMN>Q;y|SX+ z%w|b#7f;fbh8zB}^8iHQy9B2C9m-W5{0utc-8;W^UhV9{PuSm}?>QIE`C!B>CtZ=E zx?3PHb|n>Kb0S!)9wf+Xmk6j${B2li{d83tpSL$}rzI;H32yhy7v}ZV4Q=rTq!`JQEkn#p4h38S}(eA znWWk+lw-MACAI8Gg5M6b}J>x+=7sDnsaM-g#zgvV=tv4FTdzzfMJSW`hDOJ zxcJuVc+Z>n-({+5o&#{^YHh*S8x6bu$y5;|a*O<1rYZ^!K=J`GdhsxpA(IwC4}*VX z5aMeLmyLh>)S|2f(9!6`#X^{;GKE8>Ei$-m{hY}TNsyyBwjGWFWN zXd`z&Yl2n|g~*vV#LS65?H2ni1srEjp}f}EItLx^S*3+0j&+ZE9)o{&b~*jI8cD_1 zJfJnZjm0e0K}Nh@YTJMlQzp%`rWZIXpFO`zD|YV6fa_8Sf2rFI=Aic4{;@jGx_TGl zuRpo4K%#Bj_vAFeyxcVWUwWa}QTl*X*!EBCv?8;L?U7^%Fi%anrjoR6TrQl}o0b_Q z-qW~6^DA@;ynK>J*ODN z!VBli0`c@J_j+o6^Dm&mlv-3u8a?qv4Eq5nthHhoiZREL-7q7#PV^3TXvJYXvd|(-H1f0dm|K8;MoVv9d1$nTre;uRTfwX0K21?vK z3!Xqgt5L7^hN^}6vA+$xKViRHZ5)#zsv%TcVGZ2l3q?m5cR@4fPg$the*gy{_34KH z=`+@zMvK88^HAcJsBeaVt5VMCf=q z6_>-(m-4|VAh6R0Y zT9%`});jghhFZFH=&-Qhr4Kg0$Y1oRDVJ4Wh&EBzi-(3JC6DXgzvsw)g=BU ztq2B|3aYzVv;3DZ9atmSf5+GxK{tw|7b$FWS8c<^e_+#D2;lw z?{cj1(N3t;ytukw_3h8!1=rc}qyu;d+*X&leHHB3%O(FMFfcr!1CkBzf!y>me2j0( z9H<7cWxIX+d5@V`wm9Q0#4Wqbl5V&^4ehGcgX8hBire0)+GL)Y!AKW?#PtlgVe-2`@kR&D z$z|YR?K_#0r(hr{z$97~`ernbl#CByQeHnpGuc-c(rItw2?cYP(yyMxFKa0Gv};|^ z1bU_re+u&t$*;hJ!1dPZlKUUBuoz_}%d1z~1XN@6U4{bv)`inAUT!g^nbsgr0NVV_ zPG;-UynjXjk%Q6xbTO=oeA~24yM-#|+EF;H#cvI(sQPfkW4GM&L7K|tDBYV8A&yG-Aj zFf?s^@C^Ij_M>Nvwqujor`>*Eu@*yz@td1oUR>FIkiUd>^TnI@3e(=_6TG=p*R3M@ zn?P{m*jaTliBmMY3Z*knglGA9O1wr7c-xc=M1>tLYff}!bt4gnO|=jsEZq-?NLV+T z%s);qY14c_$CtD76ue@=rn~s(Kv+OkFzEe^Z$+ylJap1i)1+%8;NrMn;_*+MBIPws zF?oUk>lAe9M>~P15AY>;vz;~kIidXcb_>Tfo%^<2A2+Lvxr#AH36IlO0Ef(&$Wv#I zSCv9!OfGfpZMY_8=a=iY>vzX23Q5F>Y#-w|$_%&!od9YI+0Hg6Q%pYK# z9jqXi>KNU1<~hVu7wf)Ca6fHx;?=_y#V4_pu|x3ny@De z#KbM-`iBh2iDHTm&P|VGPh5RXl!V)9D|dsYCR$zl8!HTb%JaD=YKLgZ>otI8)JH9M zKgG8S#DKVUYB+A^X2-TQ#j2vq{)Hejz^A%T23Yd@CBG*MdPH&*3|Gwj4AxjrLnaoC zEK*fZXfI*jLrR~vC;~5l+5KE6y8px}jnu_KzT?q&;ne~0Q{p@vTSTtu<#m@lSJE{J zie8gg&u{iReoHMf=iQk5PC#`M@EPZT9Q3}odZyfnJX@ikFplzI;u1M+MaO=Ox;^&c z9N??s*U4lC6zEz%f=5}8Nr-t~{V+Q9lcvDX(dA*}f?eSyFgBtemy8d-{E4EglKGA9 z)%MuTfVja_Z&`e+Qie^i>U4(^An@}p+-Sb5ceqdbaIO>8k8YrL=mz}+?hjE&uvfTX z)Q{r-8H)EzKbM6}_SIW_GjCsK{A-dbCHP^J)_fKJ6@AP&gZS!!Xz6?R71If2w>=-u zea!#`Jw29Tpf>0yvszBw*lu{+ zK{Nz_>5z=KvVL*@rj0}jCdj8xWWV1a0)h778N5AebG56biV_G|6pDYxcTnPy$1o!$ zm{LJTulZi)YE~R*1UnDqymCzg`Nws!I0wgJzd`HGSSQL217@~XoZbzO3sEOSJ~{j7 z)Dnw0>Iom{xzS?EAZNLX?Ip)Kl$X}RGT^u*Im}TACBaIhxGp>O5#d!pgY6^P_v=*E z`Sp#GoO=A%L6d-qN^XLI4r;zhLtN%|lWx3a7-$TvK$;h`qlTvF3Xu#?!#3>@gFNh~ zHV>m+zodaI3EU-#BG_oq8XnpMxfERzo>A>>myV2127xY&i&0u^3a4Bsw$oVe$mh`2 zWrIb020FcXexulRn&-lw6QAE1tt}xVHbupe>4wZ37ybgKU@?x&bDA?<+O>U}tu}Ll zp=PDJQ`ISc4s75iy=YreTvvvT_vdK9a2Qx@1znL|tHknwGPPeWMAtHtFii%bRv)kp zob=WN+9s2Bym6F&Es|v66NVvi@T_#3Q*ly^+>E%4VI#ssi?y#+ zNRp5BxvVQYCPdD1eiH1xI*Z#kMNqmJ{NNo)r6*}?Uraaf1aR}S5oLjcJ1ejW7!rPR zY4D05KMLA!9EsR$0=AqOxs?8S$s2?YGAu~d`WuwrtNW(4ycWf!yf0;CBYmVPdmygN zm^}l2fNOD0OQf$GIQsk>A5Z%7$fh|LP(nX9pivCa$Q17wzkBLjO36KKI^0PMUC_8R zCWWM4uB&Iy!nvU-+Z-jj5$IVOdMj83xyx)1Z*`k6-NnG)+J^%d-u76*wOgczhX)Mh zCCWUIi;4fQtjzp|+qW*B%xq-mFm5|9(74(=U<^EG0ldJ3SA;a8H7pmIOEoh$ zYZR*1BEcfx-IbGGK4(~JM&>hJDmBhDGS$<4HE6YxEQi@vb`l8iD-D2Hv?n+W8w6N} z9g2?9w#`>6+O@1Er?mIJR!LtF)3!zJn87dUSsQt^vP^1T&#@@0;c=zhuRZr10fIlV z-$zB)-{R5JPL-(3MnUsxGJ1Hm=Do%ss1;cF+{1o-48I{6vx_gM?ekp~PXVHOp3^b<8 zP-v+X($}$byDxJ$TurT;b9DoDT4@;@;#r4b56vu}-rR5kmHix{iPVp0b7StXWvTg* z?LQ8^Mk02fh&e+^s=t&ZKgk_)O|0bMKqV(0xr})}7=k)TQpi=*i;zmbqK}An>H5x2 zD-o9{mLxZ1#5FS3{%+%bX6)H&v?z_@P&(R$=Dorm_RIc`4-mBL5xB$b)M(v(V z2;F8%JobET?&o@n@nn&C3*F8?G1}t)kpFVG@#)3pct%M}<6)cLqv1Mv?a|=4!yCpF ze+))1s^7weG&7kePjT;DO}M`F9{bvvMnT^s<(r1!4IB{|t zCbP_@kpnf6d_y?pREqN+Iq~MZOwD}8G@|>vTYxqQK5sTJ` zuur=UjIP}&;Uh2gx<*=S`dv=fpBHR%f)T04BR4;)w%W0i zK(1l#ULAAf04SH90(yyF2lfAm_yc&D#ib3%*nTZ>$-=}Nm!sXKHGzZ<;JLv+NgomM z0}jqn=aj!_WXI8NHhz2s$8o7E5ku_?uC^zD-XmOZIr+=aKCr2n#<{Zrn6U5&+nm3s zyUg9Yc^(>m$w}--anjw#=w~*+uY^qN_&_MD&)^I58)5uZlJGA|jCIw7|jMMX0HB~S+2%~tJ zQ{M4(z?Jo<3_b0{_&Cz>QeF7<(L(g`opyw0Gi!$(u*i&4IXZxWB~2*0%1L}B9nV+B zaLE4|LaTYxI}DBz-$;)O97fw`fqw^<0XxzIGtUFKqtV*UI3HcaIZ9NS`>6jFS0w-h z2mV}u?l$c1f2>3o1PdqDIS{z@ zTd}DCP@_E$^3`bK9!=i|L-X59tLx9}mvtI9HQ8K1RD{IDHS5{&9>3)Ai1%LN>2Aj5 zQ#K&bH2CP*DRUopzgtB9{)zK9<NkLv04aQjZSBY<`0A?J4o z#kLXHdIehRfwyCO#)HsgMdsAlX*f9DyTdy`L>K>*B-fYeGv$NEMX%6t-VfRAnD9K} zZnzPaW}rQR_LhvK5op1T?$3t$Y2jhS9Bzdi{^mPBo^4m^%=0*J}`0?qu$|GYvo!XRV=#1_2c9AR} zk+VvPkef#=-TtXQGBU*R@3+BHI=@v$gQ!>i7g9ykU9)_KhA!0?Ed*cRu@))@!7FU_ z~o8FE>D?sM;Q%2v5$ zUy4$BfiZ{vqZKj#;lrMb2LtiXuBbPHY02m66o7=!wK^nmd!gU9pMn!FfyS=zeeJo0 z>lJBP5QoHAm7yqJ_IqYvJQ+Ctbj3h>S0*c8w&v`1vuLAYT+i^wi4cW^m(LMdar`cc z#LrgBjZI27yuxeKeDb^N1+6`|^>OOeIu^^&O>kiGD0h05pYR-Mj}G7SAa|!)4Yp)| zrqGdG#AI(krIElL6JcQUW1ReWbbx5MpX_XJ$wMHjHS>96KYd@a43&gTBE=P*D9+m} z1(>3L4-VO8x<`ZH3kxUeXDLU9*7Bm>^s8nt?l+BBu0J;FLZCWVKd`n$gFia1R)u2;iPbP;%OJ%f37kM42)aa59=f9vF(0p%0#VJ~rlIv zlI{_A8aT>kXLp$CMwszNm|fJn-g{ucTA{q*f#K_ig^N(yA8PIdUImY`;QhC&>VF27zW+P9kUyz0sS($A zk^8TCF+PQ3sWZ-FZueJUiFNfd`|AGG0yMXE{9nlWa+h zTO_g0JlPnA!ba(Kkxfmc;{mOdS!;8Nw2^+m-oP)MnXl!_g^b-=le?+yb>POify(zZ z=#`clsn|j*ssu{pFe!OEeNvNKY;QUferuder>nI92hF68rHnpmp)SGIlHCjuB{HV# zwaE#-cw>vmX{JLXQjFexXSYId(V3Qxi+z_El+ed>1I`V;ba-rog4Aww=)9P}`(kg(y>N#OOey zqXUSZDFs*f4*K)yihkz$RF^U=ncNS>z6nh!^pN5%(osXbIKgFG4qutQ0=s(X@-(w; zAN!KB7mn>A(`D^6NpzGJhbB=ux@A`8V}<){KF*m(`o)f`ithdqx#WV}(9@RhZPJ?| za~YiR=+X&kGdCvAqU|oH18k7Z#ljP#St^P{mP;{*7JPPl3(@X(5Oy8o4Hb8#dVaoenjD&s3Q>}J`F-N(jF%Ae(IF0hdk0@7{V67VG<-PeB_ zc7p(lN{M@$P%zjG2^SSK$;149;ev3k_o2<5-$qv_^vu<}ND76q-z}J1bt!)~ng2dA zA7^YIoqANo$4<$66BXXUNlr;5To`!rt8gSOG4`1Tkh%?h#pwkJ2R5NW5rc`?VHV}jQYqZ2kxFVw1dmsQ0 zEU3LeO>V|C!Fz?qxeP+Kb5~-J$|l@?MFWl*g%Wx+C|9_)51O`bt7)kG=jp)u57bO) zvC!X&S`uuu88j;kyQE*F18)S6RKg9rrETZVRdn3p2rzc%61JW>tV5@n1b3>q0`^)9 zci!IxeGDVF;nk((y_V?`hK-|+$r7Gn)uHcW@Ll|#Mn)>e0C9n+>Wz$bmSSvaOBCCJc{GO|?J&)O~46VLk)St<_>=&Kjo$XQUD=ZCZ zw<;9J!Cs%;j1aqwr2=l%1QcPXt~2229|iv~N@ly^6p@n-gn9?(-J^59Q9YeG+S|ai zLg2zSbA-K}OEM-J@d1 zZcfXQaZR5eNIWiSYCOEKw+VI>C@y$X!t}{{$Z#q}1Z~1SKDu1Qn!&Td@CoL^s;Fb4 z7-4lJUam>_aS#C92IGGd5Kb$l^VkSaryQec%#3nhQHfwBj+yIVhn5{JG)Kbt*tb`E z{A95C4a=z~u-G*kJ%NA`I=jsH)Gs&N%|JHva@oeZnI;9VwCfG2xjVy-uSKPE%_A|Q zm(tcaJ+rQhiI=cUOvZ+UZj{5iu8rK*qbX6(x;|4o(Jud%!@_q!p+>MbNxURy1}=oW zbkvFekUN6(b)+hP-p)^!GiuJg5ejkAnyjE>ZQ?l(2&<4!W@t1YZew#?7>{}UnUT+F zk&&m^c7f$XOPV5TY?VG1G9EON%;1C<_yl6D8DsMhT0GVpecm@<#SA8)<-f(v`RLF$ zIQ?s<#J*=KR><*CV`H2yop5|EMpVXdBP};?UG*GYJ)33>#$}qq8bNfCrtXy$?Af8W zwAp*0`g&|cHbZ}{OLJf05NNzLqSDoV12$|asIE_wk~MGz=83e{1m&se>0-&?%w_7Zook7dHOt-Ru9JWvP4&fR5P?x-SB zOSu<uoYS%rrG zBwXQevLHBMw}Tf$cw>t5(}oO)#l`gi^I&kiHR0Ff7lxaefX2XO7cnh=Y>f$Se>Q!STCCZ(&oql+ho7eZ|S?r`I;pM_*sqXmwZrP(nkM6h4 zrbFy3Mw?Vsmd1S`bp7p(pYWL|pl6P@Y{hUN9{R3brIRq=$T3e0%<~V%(5Yn=;0dG? z$(WWZEhfi~d@&O&OayDEwwsr&HBuTCXif`FoxU&j!l9-)AB-NIQx66QFRq_^;olll ziu~}_Kx)ty44lioHdTQoScQI}o=UpRs|2$i^-huOQZV?-dN1oS}5K? zu%&ta#5VOob;gd(AR zs!MHQKwLAeLY?G~pBaMhv-PR)K24^v_o6XX;Gb%%GFzlhXH^Vvo~NmCYQEHfa7-j9 zR>SFb;p8VYqqi#0dwU%(nts`B-`j_+Nn+KqAnMM&<@she+1SG=s_}k*f7CJ)k1Du1 z6#$e++mutBb{RvU<*(~!d+$=4?bNv_66D1E$L1CjHF-_hPt?K7E4sO3zCb$g+;=S{ ze)nxQcKTe_@kg5{pkq7;Su2l|y*pR%iwn3Ot%)X zs*IVX0}ym2nx-nrbail~fRgtI9z8^n^HxVW#D#Cx-_=hAADw7g%DMzgf)h69X0FVX zSlIdu_k63PPB#qiX|J@ku*`T zoVh&B^9OWS2q>I{W#@~`U3vvcI_n5v4DgFMsW0mbeP>@w%$VWVbHH!@(4$yy?JSFr zY$WJyyxYp2;kpLCBsKId8cnv$TXlP*FndOMkvh|IC<<>fMnIaw-wT%3>uaqsU=ZaR z)>*|*Q!3qajgWFa@d>t}V{v{D7XGnrDEOxeLq}lmfMp zJ2CcWULqU|1zo~(jj&uRy(u>$fnT{ja&^Hgi0o|7&$q~nsk`qrn?9os0lER#V1R)8 zabjwIAZ*qF=M~g-shA}z&L)2IDh-?J^i4@7QRsW=zT5H=l_*yWL{3$t=MBx=*wg(vT8$T zkGSlDY?|3*$>Zx7txnl8ciVhr7~2vb1Z{l@Li)UM)U*+&r?YjZ)H7b$nv=AROF{SZ zw!7~Na9 zp14`KGy=-qBy2yVk1a|q;zKRoP}ta-dBc0SCpt=qosOdtcgi0_mgs|eeh(W8uKG1u z?cr#}$KbmYm{pHknPgL0!B0&cQbr$w{BpYb%7J1x$12&9)=xpWf@LQiR)s1Dy`zVR zQ^om-zP1sjoek7qKG*j=$b3GyaI9hTv$y6$S^f1gw))boY-i@wdV7&`*=S3y!P|5S zs}=zh|AP{*_EuRx5bR_)K*BczJ@c?&2Tjn?^HR<$!$kv8t!u_)}{+x zaixc_e3%bC zMssocL&^|_m^kCm$#r`fDvSXTZ=-PKfcKK9l%|H8tcMiwyPyGUStA9g?_Um8Y@oiU zgh}yb;XEtam1>qjv=rYJC}B!F(`&gazH4@OE@2psD!WQHAc_z9DrLCH&2&`zn@pmZ z+SkIi!|hw}+BTWeR?B-@iOKl>s_yqxa=&SI93C<)XS3J9w4*C+lMn0rnf24tmp{_! z48#pc;r|#GN|k93xS>?-76BjZvlqq)Q?25IBOtfUD&gw z)V?C*8YVPZL&g|Y#N9v7V;5yNxug)pKwA~x8qxk{aK=gXTEmNqW{ML%1aYmLz*o1g zRAJiv6f;z#wPe4z)Z0-O>f}VDy%{To*fyb~`m}_1yo_W+knSajsojazLelq#fkC`f zW9XMjv7KQZ!|+hnY+?2=EFG?da+IHSS23fiA16xIFtNlxj#4oA$M?8VF?Jn&h_D&) zrDYy+%~EWo-o`=wA!Jx$yC$Ia23nh(d1bAl0&Q44%e+g!ir^)_jGrK zsm6tbFvYT(;N?!|i#T;vr~@m{%A7Y#eAH`9>0e6CtGE|?(4AXL?{d&ENyWFbQ=nkf z(9nn##aO&V2A{~fhXaDga^8O0UbiI1tZe6^GW{6xAnm|xA#(P$qq0Lv-_B2Il|H|W z+_eb$Yu3NlZY~QF9M>HZ2_AH>Qeh6>M zRI>6)q}J9-6IW$8e{QMgQqd=L471rR&-{X*lai}2ri0#vlVV5pp}LhdC~UNR$Sh8c z+RDeG$-zhk%Xji^fV0(;l>LfS-F;vD`CK39DmePWOrGM1_z2rWTRJ{jc*!V$-)!?+ zJ&85Ze&FSoYx_JmtEi!gTIsnkDJ-Wr(h-NLG=(>n%j_JPwSBdO9z|#&OWxErlpal8 z(ktV+(YP0@OQM7K&-=0_cUY1XYC#m%%SzUwU3ZOApx{99_a3S8xub|)s~{6hqZS;` z+}y+?9WoNLz@otoE1{p@q#kVm5vH z$^EzC$e~N`HJW8oI>xAwBcPK2u$t z7QnK#JnwQ1njUVVbsN4nnl?ZY*r?`69I&BnI;*?j4Ro1Nc0dI&omp) zQju`ZOj^_RnKRY(%+vmKRob%ciLK>oR!#ZU^8CuSAsHD6olgArlmcu2;d${IN%h1& z;)2_yCNSgJSf_7}k5G?axBStOIi-rMQMIGtaiI1fDD-G?+R#WQj8W8JzBlI%dJD#n zPw^*N*DbO5!c$wPjta%!cwtTEo@%15p=Q&%MT6(4 zR4d1LrIwqY{Tos|l>=U1WSPxU_hIk5;7Yj#b3sH&GO$C~7$ENf2KF6`(`^8CR&?)D z1$~R!kXkCPDIAsraIb1Mv%Jr(i7HN@T_Dd+oxW|H8py?ww3Tomf*TXUYWrRb*m{hm zs$ZhLtD3o=&!&@2g8_qw`m47Ex%0g$UX2XGLit^ABu!UF?2}b1-&#L%_ElI&9)hhP zXxQ7IXlIp=mEamJC6O&iwOEtEfoZS&{A-}#uW9mzRt5YII;$(rG^!pwrMbc99r^EG z`^%5bJEJix5#ujUCfit6uQN~*AGo}pLeeCDOlSga%zu5)HlPv@wZex1R(|sLN8YDB zOb$YE$*Y{xs^@h*pL~B|(} z4Dcw~w@G}$1S=oqznkCa&y>ciV^XYgHaHYmX=SJ?$qGNwjcP32Sy0(ZlQ}JJ6Pd(2 zs+@${SSr3@lLishn-+-|_xfIo)gav+y7!yuAg5t*c z)Sv7$$S4z!F52Kd_I5GQ*N0J8lOXw}nqi3h8(m8FP_*IH61HUd=M|CT`A_D_1@J zSi{3u9pR~X6{B1Jv+H7GD~8&Ug=O5HqG?jU#TD*RBedVUnD7!WReW86m4tliCePcB z5!}6_S*FxOd$M*aBwbC6sydg_M0timL{UQ5d<8<~dXGIsbYbNj@r7E(yJU99c@CJo zXK+1(>9~Ei>eo4`4a(v!2%TWm@PV8~r65rAbz~DqaHK*|`~|yu6!~_M3-vcOQ>8{G zE{sxs#_FnSp#NroXv5&9qOIw{Sk~`zvk_pfxO%@Zl)dq z0U8Z0;$Kqtra{Kb*jW~HSzZEBihRRnOpqlbgM+@PEKdbhzfaFf5YM+-Eebgro4S%B zA^S=z+cobY5tEok3lYBiN>#hCm+*BCC<0kiMM4+PcUg|}BXG+?zlo)*Li9Ww`t3?^ zY>UsXjiz|C<|^L>$k-lq7lPh)+^1hb#)X$av-4Y_PMRa8UZ=xuTO%&XW#b9?Tu+Iz z)RL=PXnqyzblBhW(p69SwJMQK>MXFhE%AB9%Ld_*A9Z)!wM|>3uX_;Se$Z1}1aJ*Os*iH0xae=k%|J zH^k(J0JLo_`SvKzjX(PqXvgzs2I|iZD7^4ybLWGyyM9d=HmcVqpXjG;LRDhGn}jW_ z#G)xkW%m%L3X7(LUv9Xqx zA0Et_SP9mz8`iLecOfUfuFwvdhr0YhRffdxB5nCA&C@hf0^OMJNoBu-FIS$#Rm{TRz7G2mRwU}MvU=D=UAW?0$slBLeG1GWpAZXX0Q*}^ z7GPkgG-x=q8jtM*863n1mSjj5Qivimly)wF|#EaZj`~W2j zzA-9fz!$fof@`ng|B`0*n**lFY=!Sj_Y%~cQfz7(1!r_l;~(~-pGY(3NUjw(B^D+6 z0r-Z7QY6WD6ck{wd#ib8yuDyzIw$i0#Hbg?(ohG@-6DjK4Y>8>8)r{wfTTPo8>U*j z^UuaQR;Tm3UE7Neh{YBc_LisXrOR10%Z>|h{<@edYB?U@2?4zX@WDR~0$(DEzqTjf z=0E!;Fe5U-wqNs7z{T((10Zbtx%}SzwOIqJi`-ve0=SL&4j2(^>#SRD45J=*vr&}P z3)wei@AGdDP&jSNc#d6t>6$?Z8Ue%^bEIikGOjwqgHX=o&RTI{#_=rnj^Ef%sUuk0 zJ`1Cho`dR=J|XbBwLA-W3rr=3i@qfA1P-YQ{t8K&R%^&JUfmnGFSL%aHj1;L46b+g zvs=k0Ygvde5*;|~jId-*yk9X-1)MT!Ml9}wnG%ZCyc;7WUHG3^qh9bHvf+g__6uKt zCp(4$R@mM_*&!DDBVO!^^!Hc-nM@f&fh*RIX>h@h(g#h>tK4i7QzgI7nAp~?)2bwn z?-(B>({kza_b0X@4gBvywX%99jPEPMBio8@^yQ$kqSos6#Uii$ZMkR&hfr2phjV}A zB-g14gynL%S&9;w*GtjGZI|dw6!C`oNQ9r0usGfQAOW`uWVSYYo|51!Rp$_mCm$mN zeWI)DQb!NZQ|oYWuH^0Oco|g^*|;>pOIL?)of=Qe|9&j1ap)_NEdOz+XPZG|=LG>H zJrs$?&e^u&?q|Xxbnh+i6uC)EwN+zGKsq$#W`&apxqH)=a8`b!4q7(T2wk`Fjkf|D z=V);ETydr~gLP8rD1F&6fDyE#A-44-D?YESItpbsDMTG(j?^(jxC!t$=0n@wm4+eX zd(iKL2&6q!;M&4jwT47&e@*g?wQmyl+oQwS5^S*60C+6mX%2F1op z+!p82ihpw!ZfZ9HbPA75Cy4io3fMr?|UI zi)(PFxD+k!?rz21ofHklAwWuSpY-$ny_o-6GixUASX@YQ?m6e4y`R1J!-T!5FB$@k zOR-}eMN6_46N{CRJ}Y$aspp(p4mnsq;M1~B7t+n_Y%xX;`YoCIrHgRqE{oG%Yb~7K zQ)^foujmU2RI>VXqN!O-_cJZ*Tk|r(7B9jIqNJgKFd#xs*|86fnF2zl0VFa(21uGP zyTzT7vml+y1?dTDX%#c}ca7$?@WPuQ0V_(_?(dT|z4#ljJno=G(}DWFI*6CXCTfC` zZJ}P)3)pD(yrMS#W^Ku@cMA@kQ~P96-cK6wllv3ZcG6KAZFyrKJ{3GFG<|m$U@{(! z!?l*_)po(sE^o0>pPWRl@d&Zm^4YGf&=(afE;E>n7*44xGgK64#1U1Bu`V?MlN=uY z<9JR|v@k2|m?czLA6SD6|r!suk-TW%G2d%@zRH7P5aTd>bYp+3;8=GZ+BUop#x-G3&Y=bL(j z@Y*9B*zyn{4^UhQ|II^Oc_m02b(yx*Xn)?a-~Psr4Ed|bq_mYfuy6bT2E+O~7e$zZ^vlDA=aE764k<8mBl3sFy7v@x{^ zs8MM{H0p$aL}vMZ%C_S!=R`Y>(lEEvsTE-w++{B7MlJI<;%F8kGLC@--NGQNO*EEQ zP2?Hy%!JC28ksO7ja#lx%HW*7jyAqVZ>3~2c7Tq)Z|t&iE*+}st`GPkIW8GpYZ57f z9=@VQIW9zWw3(--)WUqSF>=Rjw@wlOX2`LUzWa^d!2O^t|8mBDjPP08M8`^1=Nlj3 zqdHKQM1@dY!7tsTNRx60tMyD_+lwSd-WqDTZ?JQo9K*O6U}U6-sGR=oiKJp0=8${$ zZemnh0!c+>RW&`^;>!5#F$3Gv66TRd&o(uUyQcw1|2Wsqx9h8FdX`VvMtY)B{QMH` zUwW+j5C1MU?YkX(1~hwhM0lpGE%u?srGaa?Kz{7Zq4)2mPy$B6LRz$T7c?U%znT^PF$6Nw$&NFE_-)5*i=2Wt}GzYt>n_)5bo(*!YTrLHOC_s|R>G?snopY-T}k#eLleDD19Lnex4g zj7*H|?Yl9H>w;%}A@dy2*6q}5d}i}fX7p6VGO{q2kMD`8I4EiT&-LO*$XFC(1Sur zbRh)9UFKlvn&pk^C$Exr@qVcUx8WQ;L2=BWLYc3c*(PYgTmz;+FkoE!@Y zuMBA{m2wCM*JG{ZR>{YQX>0=Z_>FVnNWvj)!l-nNqY_ifw*huODFk*1858#16x1cA zPf2Vky|Q^TxFXNm)-A&&-@}`m8Y6YLoPau(cujkS^VIPpElSmR%-7riiE+~z6Wx-k z(NjW^`s`#+RB$Y|D#_$eYCm+Tc6W%?8?_rY?KeL!d-p|p=er~k87lr(Dt?jF8#7P& zWuMD$ry1KTGhVZa6<#bM;v7@``zQfafCcj!Vxi-Dk8L08UxrszA(qd)8VNCn~YT`p1Uc%UnG zAfQLHhCT0);;?XW6>ZclXiHenKI%1-GLyDVe60s-kWYi(rJzdI&KO8!PsyN*j(e(B z@T;p-StY3(zRP*;UQpb0c8uqX&yWwvCrR}A3T%zs*Hle^S3i4l7I>qc=N zZap$*GyD~ZZ8%99C*41cbsej@o*894j%vT5ui$0~-&Pw`2F)z~-XDC6AGGViPu=$j zwmfMxTr__ra9x)yt2pprKBXhfR{Xmj(rTn_FKhK2?t((H6zi?va%}X6jI?_Ny=*8v z`6DP31>Wc_&Do-^c8EjWbwOc%lwIakxQ|OWzT8gAqsTYVgI7<08iutdTAfI!?6hv- z9BUP#Qw=6R0?hK$ufjCj&W4l~SHH1Vb!pKoI8tPgIlL_Y!2mtLINPwK!Mmpkqr)lb z)kMWNz+S63d&lW^N6COoIAnta!sm!Y?RFn>I&o$jk4Rk?e~4Y z^F$5sxfWsz1Vec*vc`M8mE874DpWVv_Hp-A)Q=_ zHLe0LE$U|pzal}r6ob;9bgOLC^M@}v(|?A!QgyB&&B5S)zrm-9@0o%N4URvXOY_#L z+W9f_9aApKWSnXOwitzaZe_7jUof^L1Td z_rpKK&o!X;ar0z%G(pGY$AIJ6+PFXM?=SyI+BkK`&Vb$H)i5SxT{~{bS%^VKK`QaS zo9|j20CGZ}QIf8=YwZY2w_jHtMlB_g+pC!*36A4#g`tm=t(Cpu!@R|DBuv}e^UbT9 zb*DuGr*6bHSRI?|V_DsTFfk#on($D>^GW76#GM8B;kQAK^Z>k#-_fuG+xxdLYSaE( zb>L%(%PywL;UJ7bgK5xV%pjb9QIn5z$NwZoWOFjDvoL_;2Dfj))DW2F*m7XolXbxzicGou21?!yi|V_QMF$@5lHKf(l2W)i z5clM*+69un2S7H9{kd@6=K?&1dt1eI;+0Ewf8ryQ9-(d)VVo#P2h zB!9nv@3!Y(&bW4=_*B32c|Tn-W@E;(sMQ&(cPVi{=$DPK$YmQ`t$H1J`vUf7v;VaF z>0F^HULgX|aM8?6E=Eg;*JNdnwJ$cSfios^2`V=W;JUR0@)ifs#Wt${P1tL0gBLu9-GRz9b-nr-nYoI=@~g>+#ZYL}dfIaF|M|6&VHxh>$Qz zOPJ6cWdw6Gs!$~ag3q?A#n=V^^ie#qW*2x(2KucdC#q%b zz064IJxmi`UjANlm0xN%6Qh;{E!$h=;AncnpZ6{eU5!S1?w2|B#gk2%YL|G*cg!{B zpVK~>@u-6-gvK4Qhj+Pk@or%?h?ep_HquP2c@j)5A`K|u)N!5OjZrQ7Ue0|O-eisE zopBq~elmXfGPzW!E#1G}8hEIxHrpH+#p1pI_|kG5Q=;izJP1%nLS(S0BSV%pRti6p ze<(%G1}$JTD-U+U+R2rgR&BC`yl?ztN;fcr&?5GsjG`={zG;W^cht3H3bNXlDJKX> zaTCn+VZX(r35*lbVWhY(o+BPM$CsxxPvK9ciIDG$^b10hi+1&(&hT@*saIgT+XNx< z!iIZyc(FV1V3prroH_pi5}B(vUFTz2+L+0j%qAGBKWR+hK7*U{)ztwWyOl10_t0}^hbJ?< z7nwP6x$t^%+d?nR<(mG(X&HQ0T2~W=n(qKxQ~g%gW4evCt-E9GL-tQ8@>Hpdv@2LZ z@xtLlQK6s4@dX4WpzbCZwmT8`Yj+tCfz%6{`eZR_!i(TNg!mO8m-%1MuZ<`$=J*`H zYkaomZ7!PaeV_kF#3@>u+WHm2e?E8O!K6wYm|Jjb;=nHLb@(1Fuv*vyEBf0awd&9mK*~YI1xrx}!C~@^pta9>)O;j?m zxi+O%x$k&X?uS;aPmUrtv#1W=Y$|t3t8}oLW^?CyK0`d~ypVgctoA}Q{eXOipnJW5 zOw=kuV1~fAd0_DH(v?v{jc;E23(KWHs9UkQdLk<-OZcPbBV(@Jj{y2=(0A)JOh+`E zgCkhPunj~&zF1 z-hKFOrvw5$!JH$jrV*Cz9X^mGgIIVhL|Yak=kRt9aWh~Xh4Q=O)Bd7xz|FvmmNde8 z3^O<4*i?nCz^SZ`OhI@wVqQ4!S(9GiZ8SYy0Xrn!KsA6^hZ_64#<|Lf3aEW>Bgd-0 zj_0#Uz1&ZaGgq_d_FU%q2mn8M_0kr88*AA{Hr0pQ#bi~VBn1ahB-msR=Vpia@EZ5w z;l(t3__|sLabe|&M}mxg*U$q+v+dW49Wm_)eaZRO>E8Dhu$(RsB|5#?{ZRe~MJ4;$ zLx!lC#LI=!c^FRgN==brnhv=w2~IfV{#od%-C4rY*lr%G*^QQ>#w`8AT`Jl{@(*L` z+d%^KxWji2V^UTbJvSgp zH32%cqj%gxrB&u?Ws^G}7n235<37z|7D-q8anKmMgjg>TFnp#V*V;kZeJ`RJxd@Zcy3xWGsBJi zNs5x$niQ8SId?J@8GrMXn+B2$UfvwZd$Y7X&HT>gMw04Rm^OY+oK7rlIDe1yFZbX| zs{Ic|1jGR#!l&5i@X_$-IXr3tL?fF5R;egGO;9w}Y*KXM-xJog+dbl%-;)|gLVK7w z!F)qpBf*Mz>5B_Z+OmAjj&qw~{16a`4PM>6!E2LM)}vRtyk3yp=@UB*O`t&SqM?ps z1H8FsBq!H7u7(D;&!sW#W>$xB6ny=Vf>t}S!J7GTre>HjJj<>0rmpIV(FV@Z2udya zc=w3E=1EKyQ>y7BlZK3zV(k@~%e~wx{`t2KZpDsvU&AdzE7L8D#8&kYx>lS+BVD1c zWvjP%m@qZ~5r$>{oTu7w4~8nmyl#z7e0MQxTvzLPWc8QZBKWoQs z*uVUFgB%q#@6dm*bbCC@96jdW<0d##PPcDBTIUykVI~Dd zVnESP4+1~wzYHsx?KuS_ZiiTwzb`(-tyI&oL+UB21O1h48N;ZRG|XFn*-R;$TR*P5 zc1J1NY_jT}oFusoN2TJ_qR~l5LBqPt)4Y%!bvlRZj2@kxwbw?J9;{btlGjuqO_J)p zgNp|hI?*>Mxg_ed&Ye~cpUtZbcF9wJlkj!9X}#0?_^H;f36nq2(!j{cKdbJ2JJz+1 zj2TMXu?RnhhD#UfLrbaLs}0a4%pfvvDf1QPW*FlUY^Y z`@64z_a8|GtCTy&v=P3oPJ)ml8rPGMkxYi|ScGZLola&nj5oAYQ-mR(&Z(DVz$ioT zv`vLibv+gmE1D^!ngy-ECkFYN`*PHgBpVGM-pEzPlplJxwAdTMv>X+tL?u=`;w|h+ zs4-d7Dtd@G@YX)C!<5uv!O`g@PWKk;EGf2G>On0H-ma2%-4xO}?%FgjWx2HVt-$7x zzj(<86s)buaMmm#6V&i7lB9q>rvetVps@Pmfxw|)9j{DoV&}q~T72Rt_Y~uYXbfz{ zwQ|AsX!@Ons~4_};O0<4G!_sz1J$}M{nN|*G&?J9XV%p0O%?pdtFS|lNLA|%8a(h8 z?aS=(s#uZum}j4eo`&D)X(u+p)J+yO{TQ>Q#2RFu-Jx54suF0P~;I?y! zxy!kN&0aP^8&`rU!8r~KOQh)_q#T(uNvt}^{URQ(pSc?S&jX5l6+ZK>tGaYQ@>s{J zgIk|zawyhE;oIJx&Dy2Ll@5#&jEcqK%WO}Rb! z1;<>r+_aLd+(wJj9=?xMr;V|^&lF5Y!NzmzmA$Wm$1tfAx;$c-n9+AO+)X0f(0fx6 z^SKw+5L`_de#jha){*2*vumGeu*Yt68^A*$BKy@GtW+kr5H*1z%fL8LUxqC873BT& z%jFei1=qgRXZWjTjDCV$NOP>ETC*;wdI4W}^b2V_v}#D_oTBdh*9x(n*;hTZpI0I_ zwHZ7tDCxqzz3SOoHJ`Ee=Nb0bZVZhpN+9T)+mu!rXu!t()Tp_&-&MX0FgiiBetntX zGlEY8^_YY&6r$rkLQf_f`5^gYYNjIZX&&(*02p#_K$xyCA&wBbfg!Nv)VN$5c$fF9 zcixec^K&M?msGpl>BFwZ6is?)mtt3`#tsoOneiI@Y3xh#l(Hl?Oy(54$mB>Zy|q*d znjNJ#j&f&u=r)R-iF}l;u10XV9rLgI&0U&nGa-*)jVWeyv(FQ!B0OstyX7w$fv~SaiQGb({|VzxJ};6*2I+gQ4grpQ|j5a zAj;B`m9}RSy4kbCy9XWXespvWDqu2suE?eCHa?)4Wbm<0_JonoB-u-jI;t@9@H!m! z=}_U^8S}qT5;z}3gEM%zR)(E(g#Vhw>N@@Zt~&k?w!(e>{{~zC57xp;nHE(a%Wiru z-aVhJDLzW$?(Ll<9JTqxkj|`Z2M9>t{fB2grEiSI$a8++re&2a7K4+KZY*%TUr9*$ zP|Sq)xUDYzBiIcdLkjX;o{v6=wB?a~LchN6%2+^w`^_&Gn0*3(Bcd6sv?-qr{r4<6 zJWmzy`2}E`-^gGMyJP5db)O&~YYi0@6AH1X=*d74v=sxQ)HH-(fxun?4*fB* zbpHqZoXW<&j;cq2MSNZ(D2@_7;2Seewkm%?W49ANIV&UVet=vA}rB#<&|#sB>%Z z9EJ;LN(9pr4anI%_D>fvdl{Ey6fs*GA8&w9M9zpG0z7-4zpuJv_n1HLHeJM8?e6nr z?)vr!&Mb7am@|*xq7?98Y1U{Rgl0)49FD}i8GQeVn!Cx_&#m%q3qeT32`QH|cG1S~ zK9%9MOKR+WHj>S=7wbGB>2y^1YP2LbmVR9WwJP*!jrbw9P&lFX7+;NsL2lIe!F*h$ zih{s)z?kPt_Kr;o6Ra{#OK*v!Qj3mZph9uU~poNfC0R&(B}7 zMCGPpV?3AU#J-mU@6x0Oa z6^&>;7#0bFiU)j?jR=aPNx6UW6HDa7AGsg z`A%o?wSYSc`or2Y?uHJi*h!G&eDQQs`s0mCJu$Jm2+5jn(7!cDbuPE-#yug~qJ~^t z&@Mgvc)YXlo~23kjENFpqsQ+sUGDv;)Z1S?fH%)Vup#z~s}}v_eD=)M`sw|AyBI&M z^%Ti;5(UnpHzBJ^_DDyT@9`kOciD&E1U`68=gY5cy)aE|a6V~C?GMP)s(=<2HDT3V zrZI;?nlA3p^2EMP&U$JXJIGgw?qBHeNm;H*m!$jFHOYd_RxzeI6&NLfL73HV|ACM^ z@aCc&OLu!Y+%r1OChfF|KbuaUaipAV=^M6D2e9VmA}Q_suNN03p?1CK`>I^@I?=Z< znKpssW|XEteY9*e+32wlftyp7m9CLv4Geh25UI_XZ=>RPoXc6)66RV^lItF1 zPNE1){TRW#R@MhEbG4iLKvpg4&3@z#568=P9PsV%Vs)-jba;0#*{0dNmt!pRvy~I}pL)!=thUri}|+4Z%VggtJE+ue%$gtUcDE z0NI4&4JrcO^oYXu-xaJ^IFaCfBM{|z8f6`>c{Ju3zO`(^UZGIW%0sr^#mh)kV4%Zs zT784%KX+gX8*Vc2B`@LxQe=HsCJp!PVPnt75tIyuVLA?jEpHds*oK8-B-C^E(zUDM z`%3thgL3@R;3}QBe8u~DT@831!JF7q`#EV8ObMJSMJtIFS)MVw44u?H)hj!=?0x@D z5(zP@&0N1pNmsw}_L@XJu|}XWQ3Z+Spy*uQ-CAJKrw#k2h$%yGe4Id4({=gmIw?H`WuJq~`gL{UVe1lXQl@*oRRu&~Vf-|;7Q?kXpfM|D;Xq@c5c4$? z14z{W5YOxjo06zjZv6OjsBG(O!h-Uc6i)g%BUF=IS3Si3Xr3)!v5(I=86ELPHGK!xup#pLHzVN?S5Ap2*mX^r zsZ-DFJJc#vy&&RLv7T)j8jk(m_)Ya21CV9nT8Z<<;-*(C!{|ilvwhH1r2E=STVrA) zRVJZhD{ZI?+a(@?paPdssuGuAnMSpacd+;d%@^aWnt;i-bUB4)EQX5a0(KEOVsNI@ z6;~RMHp|gQ)iKFrLF$f-zBWf`)hsabF5~VmUE9)gIs|>?_l1|bv4v+%<>t@O@L_?o z(!mR<&yGePf8YJvCt5_`{z=W#&aHWYn!H+yJ&eWkH6nr~fp#eF? z8KdJo>+Qx-#h*t~Swi=MZarUhQ58^2JyT9kCkRh%1INaadz{VJsZDfDLX;b6A{L4F>5&Aq!9$P=1f#1*H ze+YMtfu&SL4_r+4&flHl%uIvj1IHk1wY$T8TDn z0!zeR6H8Uj3;#!Wjf)f1hL(=qjNI_Q#+&hazl%Ao%3b3VxqUXproH+2P}4I~T(T=< zWpMOGzf*P#bgXv`95aS?A87m-bwzcW78+<|kA9^i<4aW>GJu{J*$slQBo~27{u6uN z5q=XZ1w0CEDT^JPxULSh>4F5KEWbc|8jTpMjS4_ER>Jgz0KGBL`J=LT%^6>; z0b|%j+{x!6o2BLCfbpf-pa;9}^G^0wG_S5_$Z+)+a$QDeV&b?eu=0uRq-*&q=GCYk zz*M$uc53qR>N>fII}~>&VrD3WbVM6B&Du7vn|JSxznk0h#Oe7do{@l{73Qp4gj`O; zgxrT!0w2(nl*`|23`zMvgSe*E;#%F`K`MO5p?gls3~MTcgpqZ6gAxIwE)U;IbG#!` z=8Yfz8X3r7p3kRtb8&B8Fq08FrN>|I{_m9S#BJ(m5) zwE<~K;qlZo#F#|(iR`>j+$8G>djTMh^W~Ow#=9tLqbcZQb z3VAuO&Vc(J>!M%q#5&j}(qk7gHJf+s97uVL!5qPFIjfEILi>~SE~#>aF!|BC`53X^ zkKv;Be-cMn^}-@kA7y--m~HvkUDtPFssKB{TeDl4na<<{RFRD^vy9)$5;DTeQTF|H z>x~KEGYkH7M8B!^#R!a*R|v_FMP(ZdO)l`g&g(3=RCF5h%TQLMzIJ(x1<^0 z`(bYekLgKR1GgRl)q{$(M=uRTDZD}k{j~9T8edpZ2D*x~^Z5r4nFd~3oziaqDy_)% z^PUV?sFl{vV8yiFG6nN^XvVI{rzs*{9aR-U9v?QO5(ulFzxfH{*FY--#D-hhb`9eC zIaD5@U%&CH*z|a4FAw{tjhs2 zUc0{C1tIdh8hfXqI!cqIxNjBvM{F(oF~0LICzkqF-)Ld4C}-G&&{%<;4H z77QP?Pn$7f7MP+N(?8kgR$$+i+4ReipRar`5yNT+Dnt8Rwm zFYJ+W`8pvECO*n-VY6eGYn+JSt^A!@Nws!NgCNgNTG`aErYb=tX{b3iT~5MC@@_+b zYx~Xg`)a2x0Zr666!$)3taL;t_VoA=f~ou=mof&Y?+tIh5@tNTx7KHGaTw}itwE66 z_$SN@t1gEBv$h?|#7M))Y?y~9@!}WindU+`Pdsib)AfF{lh<8*r!VAqD8xiLi4Ki> zB1A)(ov&8jxFa&@!ZJR!7O^O$(kcS+g+W`i`UEF@Dh{b*3gTKl?|UPjqj^fUMQtpG}}AfBmDS@!)G zltZ?P>G_kxpc&_M0gCe=!nNjE)CPUyU`mRafX;kL{}Cf8gxr*v%nAyYZ`Zl8ST0c( z;eZryi5h`4vFm+X9xL=QP0vi3fl}tjjdhxIerkp*xuxcvh>Cksph>QP$zFJ;XNw*s z7lq&gNuWN zp?Oc%?_oaQUd4j>+j5TC`z;FyLhM#3dB=4qR9~ zyBIL8f!a~0zvlit{jgYZj^0wOR{Qp!%5mWRRIP?~TVzU!WVl*gK{S2=OOtltd{@8P zhg~%v5P19cEHgi5oFxnI^R3uA@48DFpuD1P?>*kLM;)&3%&uhc_K z#V52uY?muER1g>fewhOg$2t>1{76o*7(?><+k=LIw;S3J`_J$C)hIrvn?T@S|C~`}Tp0h=a` z)Fx&AxnjW@{($(Xhj5|;m=~?nxYqMt$&(j2xNku;;=1Tz%tk4Yo$P1yWsToNP@Y9a zv)lOqoVvE^Wo!jO^i6}mrHM8Sd}rnEW{nQhQW##~@Kp-`0bTu+>*#8JytvE}*3!OJ&_Mm)rx!Ax zY_7IZ1r#(HI_VB5Lb^F`AyXR@S5+xk*^Ba3*AtS#hzJKf_E5K<>ia4rG5)z~$O>r; zPsrGUs!Qo?s0w3-7kfL)oFL-EtG0_TOlgoULkN^O3n>}U#|#~ysGD7ow!1EGH;Q_k zofc@ip=CULTBFjg_v%}d1;qO1y*KvE31(jD-buYRjkM{Ha|ZF4?_gT%o=q84#znSF z*nJ%5f&1{Kcbgr)Qn;;@is3p6xmx{e-m#pjs0R475EqN=pH_cX0bLO?+;0z#TH zxo5gc`aEKqh=Tf+$rD~&(kzbrz2J}HEH#=>7}Ti!939V14jxIM=FbaXy_?D{oQ zaKF~8j`&bedtOk@_peIB*vOyZV*p2Q{RI>e!2f$w9j6IZ-t0Gn0mC2OpYl8s;l*$t zh57sE&L~T`{whWs*)ct}vyg*lq_HFhLBsND5<9jF%~>{L-GNsq{{A2^I}^NZ?owvL zw?n35>o-nyZ6rB+CAD3DnJM31fX)+^zPQz>=Vasa9ph7MLTX8Lx+hK>Q2j#P=P%wV zuq|~W-ti-fZ!G`fu24ihEAeNp9^KbpB`wsc_6^CJzXcSa;-NbLN~fctrYHP|*Tkz^ zzfGDMJoI1CjriY&++;TRaZ{GRR`S;%8q|S~A|3n5^=Z`oq0m`xi8_pAOcqD39Q=ft z;+mFHj113=Erh=OECIZ;G1A;@Wu1ZRd4^Z*#4{eTAX$e^5?8$S@C-|-Rwn@SH-mRrPOG8 zYO5jEKhFC$-ehad>qpR-Xo;ujy@;>!)w-(BZuQ!%X=Vf0@|=Is#c#zzfyFQpdzP-~ zRc1=a*!5s%pf)(Llr&njNGRN`>V{Z^bx|L4`?=M8R~5zmnNrDf#J**<^mAA5 zMh^PA+n*aP-6y^FWe4}?%{zY4!rufDe?AO6@vb9A+;SK~GMQ5Hi)+t$EZD8$T*+u) zQw+~q^)cKrYSp{J#nwDUITs23q6o5}^(nkl)#I-c-|yQA@oc|34{SzjA{OPKc0fKB zZzkgxM;Vb{FFhllJ!c*ikRhVH37XlOex=l#dBNm**Gin-bP#E<&IgvuGxc+x6iB0fp{PD8Dq4+#qFJT-N% z@IJ-gO8XKSba-)z*kv^OrBD&54!7)(chBxK?E|Zy-5y&ejM~5}tyaBMf18X%<^T%% z!#+pYtnIv!K{h+|$2Z_&txxtj09H;`kq^;6>Yd@8pxD%6G)438p-mcB7WsRhs@c>r zzTtZUGvpiVRX8Sk#mtJHqgqTm4kvY&owD1=&`*qU-)XJT1N$!~U^-Ooz<=UJihk?i zDN5o$w2sIldAv#dPcpP240dPg8Yru=hf+LxcSLhmdRnsGVinDrgsx{V`F~(!8+h=z4zV! z2Udm!cBo`Y4A!&0g$~fdWg#sc)<{)2qZ^2W)@*y$5bu;yA0!%bCuBjemQ?mG>JvyC zwS6BbYmu;)`n2C%dovZ(;>z=}&S45Aea0{-~D;ftp_fW{4L3qJavrg{(p+tdgFf-;{RznQ$yQwO$_pxWXn2* zEze+*MUjH23h>qD!uzwu#jt(TI(9#?CZKWN4vfG^w%rj=X2Ao@jcTww*b9IB3&}h3 zg450pz~9oCz=<$10&7>{sZTdCMyTB71)J-6a1TjoeDFGKImxOH$@hpDI9;m6QVzK1kb1elzLjicFH9! z7kIg*l%CpNm=Axrk`KtH6U?C3 z=pcOj^Y3n$68+NztI$yh=Wlia7T2A6m7Kb-31AP1&~^~4ptm{JsBEhvaZfz`#BMOv z9;43QW*23h8<##IAyNKCGZphbr{p%A;;1mdYUgG*3!wIy|7rrFEA`K>ggE>sslGH`FJzIuipd9~if%8uMtJLn!Fz(Ls($XaXSeG_(b=Cd5|-(1qA$oC5pj+klcGt~c_Ng48t zbXLTT&9eXd{+wzJaA{mlWC`S}R~7L{MtmrRY)Md<0N?|ohNP?c8g?!Y44G8F<-Trw z>J+d-c;b@U?cv<(xs_C@Rp%*Bm0W2ZLXD+hRETL})sy}TK?Uu1(keJ>Tne%MlR;3Q=%lk3O z{;6D^JF86h(?KkxunVKtttO1-ys1iT&GCXIPKS!|z}O0w=#lh@CS;8!SE2NrPW4HPoT%aSxaON!lcDse z5`x*OG%fW#MeEDk&~B2pDtK>lChmm1u?)rwHyGW_Q~5tbK;H=51kzDlcbDzZ%j)}G z$!iG%!@RVknC=}>{LU}e4k&+7@K7%ujUWv)NKmVd${|Mc@aGmmsrvYHf@}j}yC3vy zB~}X6q9X%W!)h~Nud-_D8sfJ9f_H;>VE?*)k04veo7E2a6r`jY6AF2-tU(0LHpflQ z3&hi^OWa8>D8GSiliTw?TiAiIm9SNUe;b%j*@I^v31A(aQiVE*5k%(RW>P&PH z_oH*&S&w<6BeLnB7tBn)uAROGwtpcS4jw3roaF-7|IzBEFsuoewh`hs(u6GM5a7)n!W|^2bj1NYptYFsqPh#evbU ztv#_pd@GkT4c^5l$sH!%%rZ7w|DktT&}FMNvq{7r&=cdaJJ%(hJ9+c#lSwz1JU1EA zQI_~TuCSF;&F;VOSUAMiaTwGxxoeP%->Crr+SA)m@_CMIg?>_%J_?()sQakfV5F97{ zxaua^0bB7zH2?2De_iMQ93Zeb1=z0i?=4`j|EEvC!Ah@Cqwd#dLhU^We&^pArmOh- zM4My0Zs-IsmUKe=k|`BUWYj3?`@enc4KeqEiW>}a67x+Rv#C*6mBU+6sJgd zpEhmNJGD@4=tcJ>Lb}(<)rrx_WvtlkShEvjzXwtgTgZ(td(NBpk^8xW(@@b~)ZIQX zO@SD=yi6}*l>VcrOz`VNs^u^B*(3nXNo~KVoyY`|y;t$e0XW{m0j%1@A7sW=?J9AP znf77-_P(6(Z6dRt0pi zG@px7GXxGeMMrN9@fikZLIRjTbYaWCg4Tp8ZKa}T&Gd^S(pg=8r5`(Eic}wG>!CD- zoDaq#>;wKru*GZu8AZFc-yyu}6Yk{-7RZMVfiPAsgr=IL8%&R@pxKQ%QIhg8>B4VZ zVh`5MR#OTzJKqf~ILwSry8livD7tY#BzP5NNj}oU`5;o~V*(!GSij{Trfn@>oinEm z3RFsU@>%H(Y$k7#tiSt9m6Kz+|93L8&6z@wf}yw2J|)tXL&jJC#^MW`)sjulDFs6n zfrtngXe8#GN56@F`UTDg9~BA?@=`*d2H2iXF+Le#7d`0!E38L}?` z10@Zb!!CdEkhPJeiMzPZttp(=DLRWolPsC(Ick-?T+m8(;={aC>iwi<7l|d~6WH+b zIMz=erdiIB(q9f;Lzt(U$EC#TF^WC&XPVg6Y zB3BE)tX$V3;_EN3yXiY9O)d|b@3JS`CVdTjS4tu9rg8F26r7>FyefGI5575ORT;s! zGMQFIh#e$u~d(KT%aS_SC*p$+(+<53aFYGLzs_fg^GDgV*(NrS+a zZShQ@SkMeQI0b(g?!aXrDJZ0mED>%x8CX{z259vK!a@%pERBSU?WN%2ZOYKVlA{@1 z<4D*G)qhttZ7Z-R7U4TAvs~~ikWB(?ITr!DVHsp~QC023Klvww_SZiCPw+Gziom0g z7FMhk10F&bl+otX)E>e#cLz}U$$iLVipcp9th4hmq`nEkP~E{RBS69W2-V+r7d!52 z8MktJrwd5^w*DRJH$FLvfmBb|`Gkn6ZPo>P;Mq5Am%Kt?x>dnfHbX>7t;IvL^*`n8xYCY2La zz{8Bys7S|=6Q7Ji$~4R*hlwvi_`o|Ch<9vT>{&sl{g%)B3d8R=5`(C&# z#hU|`YRYVyU|#MPFCsQ;thfwrZo($#CVqY7fboo}T;hVwjn5|MjW+5MUhZ2%%UXAa zSP(L0U;_#Bwp(YKl$^`JElT0-(|{cEzJS>;n~{Waf%~Nj4dd0H+h}<>Yom_b|1ZwI zGOCTPZI>1=6e#Xm+})v2+#Q0uyF10*iWPS#?(R-;cPSFQP~4M~KJu>ho%Mb{&dEQL z9ai?to|%1L_a$tb9+kPQ?-@x@@Q}sH%A347vb}_;+#2;CIQv@{G?mLYnzGIB2Ouh& zRgrIUdaBw(GHZ$?5c8F*cFDrRVMg{wZTz-1sJeqD<)RV=e8AvR0E%EBf z*geYXOD^Aw(J=}6?We^0aK6gbgA)XP+F&HIPXEqTJ30~rl`lgZ0MeOC! zWP;cymctjo(9q|(r22%LzQWREw_H0JoC83*n{|_nW@+H$TW)b*P2Nd^C$lk;C{EWt zZ3++W^bdDir|{cz6xdV%!sp+OKLF<@W2><|jt=USuDP_#tW3OWtvM`ws+N#l7BvrX zwS7)IX;182jvyDx3n_8TV|p}48IqvcfrLFr!~D75hVt0^p~EM~$fG;9NdrN73VOz; z#&06YO;E?1U4x>9r%_)^j?NSKtj55Ev+BppXq5OOn=-^U6Cb|5*R~5xjU09F3mRW(%BibJhgCZn38#}xxZ<&BM zknQ-b(gPTv88|3>FGrfX2pl{O^;we zyvk+x{TwmU(bFn<(E3_i(6_*kZB%)$$wT$^_WEmfLLT7^_*n5_2Z)f3&b5!2t_jm+ zN7bq3Bzx9r>hb6hQF;D)3WkOjO>6Ic)OZnXz;-spo^`4oWPS?6!1y@e z+egEBR<-oJH%%tDYh##AQv52fWL?9bsNo=zgM}69ON~jh=yn>E3f-l;mlj$8(1f?H zToryU#$57WuC4^P2Y_@sH82o zfB349*u@2u-^)yVeeU-JuLO=XllC3`QQJimVO!kUK@TU&3zG?%aiDsrC&dl?QH;?hxf>1}(l6ZA zH&$&s-uUxNnFwiwF{wr&SoV^ok6W%e7Q4BlHtM~|3rSl!n42?PkVCAf0n4An7Qla-cuCTC)xMy+kOAK+~S7eT1BF4k$q3%)fwkMDU zvFa}gwy(OND$lvykLl{n3i*9)J`;Pc9WxUg3&>1T5}GjnE{RA&F&}XqB+Y#^k?Hz& zZSSVOsqzpGXny`YY->g>s!JL^79;&TG+U&Zz1FL5$a20|Y5llCgx-%NdTawbU2i%B z(;gH08{!h6go+&ilndT3TwvX-qmSxbNNZ4>eESH>bZc#@DOx`gQVuI4h@OxF&MVWa zp&B0yq9_IOehb#hHKqReD8JWxA=9Df#Y5S^^c_7x!p6mKr6Q13jM%rz;s8KJlV=eJ9Qg}PbO zASb^5$ya4p%hEWXyNjuLQ)um6=)Y7NqM)ceI{RHm zaNA#W+g6!Pw3Mz*z%Bi3#7jb^oU;@=G%@;qjIy^4_gliZTISyt=bLAFa8;*W*`}L_ z=|g4jzBcRs@D8iyToaieyz0ATH0On20fxy-WIx+@!)#(VkiRdy(O^ge@);bRLUx=L zNpqUVKlU-7UNW0=H4I%Aw9yvjr^DyV?KI5C;TyUU78+(v-yWml6lP!8lSs?8auEGl zM<&;eG#bvD+--HE`|;cRYLUA>!F-b@HeT|5!duV_VKO_haRx zY~f~gZwW=y`Xar`N|heJmo5VBhQU(5DN6k)@?o3cuej9kyN1JLx|Z0$iHNa6TBhFDZU)pB8;Lg#rRzaNEpO(NOzn&>PCb;U00;KOE3aIN3*LvbMi z#^G0148tG*MQ>i;%G)KRg{~@T&D6gd2#_~%KUzONG@J(52>*r4K}H!yFp`w}zWgE2 z2K+Heg}lCi{t!}$?KS`T^MCcM`0H~+*}u#vh9sAd+Fp^DNdC43hB6$02u~z$qPe&7 z4D@`gdH}*)D!PBH(Ej>TZ`kK5Y=)yA-uprS27lY4R$KRfkd-g*NBUMFiX34ntvtl% zP4BwI-TKwP&4M9TYP8J9EhKmqA&3pG%OLdMSNN~xtziRa(9gls&`*Osa5mygF#rAl zRmcy(D!87as}nOg>yjoJlo?3k^}a@))%1QJ4)JyHaG}#}xin10ilf!e0n|_LI_6l? z78ic${ue&tqU4XCo*UsmgJ1ijEip6Og9vUNkR^|oZuc7J{R<$Hgo^a88_)BormqmA z4yKL$aqOdxy`h1d_W1ktp1$7y{3Awt*48ju4RYhV^MVi0r6&Kd>WyDKy>h$#MLC?H zGKN|HGn&jib{L*Jeva{wuE}u$1oy`%^zWl~um`cZ5dA~j1Mpe)c!ONlK|p1v0rGaA z3#!?z&m2tp8vOc&${>qJi>ysn&bMo~J_{DK=E|$OUvcyCEeS~dk~iz0(s9_$PC6F4($RpBgunDr z2N!h9mufT*ZOaj*RcyswLc22R4t3i)=j{YHfCsF!oyE6u9o`q4NsUM%#hA(NmYiOa zR-=SBrK+1R``YE3s}GCK(uhuc=w93jzFd~tUv*@uX6{RJ99kM}p9m>u75cae)4Wy9 z)?-h5PlHR3-UVO-Nsol@r|0e~Ids#%UhqJijA>gcy4YQ9mV>&|1{UNqv>pPPyk!O4 ziF>Mi9x3}S6k%9jJ3g)h)>jQLGCKIMEjKMT_WlXN`1my@ekrfFtuXfQpRcbA?B486->$#=nV)Zc+@(uowyB+Uygj6m-`MAyNy$Q6 z5-eNpy0Plo(lj0}RdDinjoJ=}i2wF-{lPwbk3Zl1+Um;O@_)92aLikb$4C6VbFqf$ zk-h<-CfoSwv)h<$BbAJB{MGxvD8g+D%LeFL&RS?r#AwegV<4k^VA?i(^TjOQd1(Z| zKs?h)^On0b>O%heRNnZ{YS9p8nA4?jvD{b-^TdZu7vE`3a^$0lmp}Yk@&}1qIrDxl zWI|2piea75TsZ7#|Etw40uWVTsPODO-MzG<)9ypv)u;C9uCufY#@$X3{$xeLbO1A< zdSB(}^{4d9^I1|mp5qVQYP#FwqPi zth$=bDv1e_loC447&i(+^vh`8s*}x6&^7l9E;Ab6f&5G4Nj^@jc+^bHet$Z2*3&^F z^Zdhf-JH{v#xfH*AuW|hDf8Wu|0^ZDadW>n&-6_t5drY}%6!c>E(R5A;cL(tHWeq9i)UgPh?D{)4 zuTeok1(&uTn2dDX>}*lr+`ck-V`W=i!y8ja2q}paVv@hwOym(id!9}NAI_KM?j5dd zUr*mfSiDgcD!t@PR4j|0*SqiDy$@^n_E{9R9IoFWCzIjE>(S6c1{y4hn6n;wj-4MB ztULa8`s@wp4$+T`cvCebhAsJ9*WG6`Dt`8k3K=WZ z7lZ{D6fGY~_B>>@aiRqnlXXGQK)-@AqxRDX(&=AP8*%$;x{oc&9lJLp?a- zuqCB{ZK}u4KfR__C$9^6SjGU22!EDG+Wxc)^ZM%t%-F5A>1BaDhoJkY-z#G=7*4|E zf1Q4g(Ku1vi_+-b3sUMq45Nk(a}%w=l%(%Hi0!QF+t~MavpB=I+qZ6AqdXAT<*!*@bj0Fxk&!jhOB}0;yWM%xCRB)yI@LYuhlsW{_4AiL=h5W8 ztl!Hr$PK=A5nZh`xHiJP_0>sih6wfUU6bx0?k7B_Q-`$c86_MN-&$bF#$2-E-gN<8 z7~O{-GNIA8JJBheu#m>(${82Pj;)Ib-Pmd0E~TX{m~ZwJR8j+BG=>3}3Adj>LH2rk ziI!jCQ5|*epW3rWECxW)DIq71$dgZ^$2dXVSvAkCN9Lzygn#<)8bXy&`_odm6M33B zA6JbM@RBe5PIzaPA1OM}1$74YZs_gB`FxIl5iowt!P+&)V{e$WiB%`2v#K+iyel&| zlDJ!Nzj)ox7%UX8xv0lZGB!F1a?+_=!X(n_1Q=mq^SA1!km+5BA-4BJ&p$t#aq;En z!I(v~XO*hzpAp}lNsTDWi1@0K6gT{yHm=Hnw9==da2XQY0j z9EFcksxrEj$g9`Lx9P3cGGTD$;gpYgiz?LK)>cT@O0_v+h~lg8S8$#oB_%1r^5Vfm zu|RTj;nT$d+&JVUjub3gd?#>UV;i>eN$Bjwxj42Z5@>yuyp&RjMEItxQE;)mRgTf_ z!yK`>6&Xlf^{;mr-Z7yvcc(V9EKo$_RXHxRn~UrVxuqNLcv<00I_YN5sp}cWv}YC9 zv@=9S*JZh?c;+qxFpS>}(6x03X-`q zW0rrbM(;c90Sy7TFYkh^(`&Q4!=!p0`$*6#E8;Nh)kiJ*ln)ehX^EkrfNs)aB5L_+ zqeddr2yUw8Eu{2Nut&ClKL~^Kxdz+b*mS&ZMz>BzK9KezCnPVrU6-x3-8SUhJ9Okc zC+SMGR1r}sYn?(FSh z)rO86|AZELUo-h?%b>GpGYOl0pY(=UFoQMf5{mg#kjQPQmM2PYd!nY0R5M^hHr@tX z9J|4|-n0I6NXNVm@RNHw*!_4}071+0H_rLmp@)Eifw?3BBULl|-O@IHn}%UmS!+TO zz-yS|GitT?B}2so&jtTYH3}8ozUgMQK)nV5b3}iV>+FXi3ii(zZM{-YS4c6+Y0HgF z)MJx&IO{3m5@>x}OHJn~gC6Qy7eaQCfM+59TU=fBmKgW6Q z`)B6kjvzi`s}&rX*LP2%=lr`r;&{$OZbpeAwkD1~(k`Xh(fs9(f5HsDRlGC7 z+Pn?Ho;yb|9LNV^ArxS&1@^*2`e~_fas8(+C5iEmtwRY zl03$l_~!b?*$)jmh+Xf@HdLIPr8dxmvbE%WVLyk=4(6Fi34GRdQ3`*S#O(g#*+y%r zQti@V>sJd@*-dGBWvu2;;Uh?MiyHG`Td}B8TN8(FoI+bJ_JO3NlBMvOcc+Q3?%-o& z9^fbwCb`XMpKttP`UTl_iGAxSfN|BRcJUK^sBCvXQ$0`zb(!UI_zN$S1l|tZlqH`z z*mWIgC`c__-sY9I2Ja*upU#^E;4_+}|32ZUb~T1_T8;Z}q%92#;D9Tdv-_tckw3-r z5wW_bTBJ=0Y2Z!)kODrW1g4dEALauBl9{()U`#`ua-czFL08(eVM;t`x1LCvmZZsE zGpaqGv=G8Ms3aO{r>7w%KtJ@pHy@*{mgVh33vFlI} zR`7Haj%$TOy693f>h>6+-@cbhD7KF_jT-doDoQtaDOuw zp=x&$n~dsXUsFP7>d8(cvN*}xFpPIc1G8&>ywS6>j=tOj`aL}%QlfTGCPpJ2A^-a| zTHIA23BJjarLW^WzbuWL&;D&d(%obQDPvuFZv7e~b->ToB)e z`1=}xeZ688;KIB4?C0Pi@j*KknQ4KF3|wcYqx+6$@}$In z=di5&diVF}S|JFj=kM2l%c8KAPF3gu zDPsqbmVU)1$vH4!{1bomf_wVWK%4%@J3StcbY`8Ra3BQ1ncur}U}54Ugf5(HVZ4r`ZjKj=3~D7;ft zI@_(@$(9_A``3t;*6Yv49sH~EOJ@%H%aF>rO!hR_b3P6pOYLudx?0V%vRY%h=_)()Snm!IBY-v> zwIrFTGq@=BzaKN)T4c~8$ZcZCttSzlI0?4ZUaZfx>*4T^T!SDtLJZqZ2}D&Y_L>k> zx%DusD-GI)I4Qcq^@q+btMe12!HzZk)$v)%Nq(gD%P>U1rz{=`XVL@u2>-}P2W7u9 zWxUTJ=n9GxIXYk=oVHL2wgpgU3O{T+NpYNwan{FXzsiT^OAx6>yY}y1?O6NOlby8; zAJ37`?l8f&{fhgRF>)ZxD7O%of^>KUAv!rMCkV)vwq7$<6Xnlq9!8cZE~I{b+2R9| zYM2hcRG}7wg?$z~@9Y;u+sa_ubxY6OdOdfL4shno~9 zQ2ByKEk;I!;4eih93GCIu-rN&#f1A%3YJ;e})1^xU;CTZ}QnZ3#7y`{@~{Owmn z4H}?0JC9gj+(_#A3a)eC0bOp1m&Vb5a(W>Zl}^6h85 z6HFHz>No?N3@I#1EA}nZ{(;RK;Eow65^Qcqr&JOofu;CqbYJ|0zjjkgINdNrL3rQd zVZ8_?8Pc7>db(=c0;a^0;@CD{1u`^s{h%Q+|H9zAV~Rafp+!+Tef4wiaYdblJ>Mk0 zpf77Ob^UlSFJs*E9-lxcCCW!Cg8F?LkkhQfqU8Ou@u!HAYt zxg{~S@~4+=2@j7&M0;jYkvY7&7)lBam~zn)8se(sS;rpN=!ththY%K4KYr~EkR#SQ zpk5SbDiX~%a;u@oP1Xf=e!|k4AOX6hNMWq!Ne`O6ZJ}#mzgV5YuJS0ylI;^@4^~%e zfHUR;Ty^G2T`lwv+2U`OJ3Q+p)+!$sE;ivlsZxUqv9(J#d{K>DfB)2c$W^!H+-J^^ z`<_8IkdwN~cl7*CC00O2;_ZzGexcxH$qym-!!PHw^5OYbEZEp*Zt2^LML5C(*0;CQ zX1l8+o?Ktx9e72q@8E1$>5@6oNUsOavCNyB3belKNJ>?$tHUvdyZC(XdP)c_z_KPv zFE#T|ODAgvj=$Zb5$5N)k&GB04NHx51o~iPOld#68DlI+LWr)MFmE964p%5IP=WQ> zW|L0WozGT);+leSfpGDreb{G>q@4ylHJfmu(zMTj^CdNwpt0`*Zj z^`~p7BhFEYk>lrSw7!8U@8+DGNg>Vo<#v&gLBT%34&yjNGTzLCt1xR;`kP;|k{lYx zdNMmj?3XbW`!=F=j`OYWkl0X%JXH7qHH1iHbn)-Xht4JtVq>labrp)L=_(&05YxBQ zk{53tl{EB_4*j3w%D1n3J0d`tNc5_Gg-cD}3XG2-`S;Robs z^Vd*7JNjGZ?VdCAnMa zwL1qi7~h{847sRq1TB)xpFfCAl zPl7SsxnZ->dQSe@iFj z?D#3bNl)d!9zVRXJC48~ZPRF6k-yyT(GtZnE>X(e_fq=df>vxu3Uyau892TaC zNBhM=K*iSn2W!}KU;l^=+9ns8bt7EJ)1J$90=hN@w^MG$jO48L7o}ZWMWO1pB~H$B z!|$$6`macQaY&K=u3{5!Ud#nArsANJRu!ge&)G6fpdd?32m+Ycv<5XCXd^ev``yS} zk{3O-iYyWQ9G~rS&|-z;VTX$}j&oA%g*BElp%eKEA{mnv_GQEy>$Hywe%{PFVa={z z$s8igp7y}tYxDjF>tSxAN^H93b3{0@NUOIfJ~mus?lf22w$69d5O`uTJ5{-^9c!b2 zg_nh6l^lAeFm^K5!hNKyKo$+J8ka=;wBI&>_4=9HUh^wgwNFxXegfMR`saLHHC?VE zxvcek455tH_iZ-v3A=>Xdc^Hx%iny3;Dcn)*z9Iu{S$N?w^D}(_gg|^)-p8{%iS2Q zmzj`j{eu~0sM8Je{2Zb2Z(`ejzg)Gw88WdO3GK!!pMd)$rST|5#CmZjb8a;=`ECTg zUH6MMj-s1@LXS?npngwu`gUyGyCh``wGS$~Qf_(eKN+XuU+|GcPE}jXa>dMNP)>t7 zjKd^P2$Fb>yUML*268q&15=E7~n0Y~DsSZvrS;G1BB( zY@W-)sg@3Tc6j&KjR{uAObYx~2ShkHZ44R=wHdrVr_U-LHdMqf&WMN{!Ve)$y(fn< z!)|*!0}Gvo$e?%Mx9VRfuZVGtt#=!H*?-NnUEJzad)%7v?RJ@y&}8IDFw%6u$?zv| zzG7lYF(=UOv*;rW(idV%Up_gCEgICjb|#C&h7~)G1cU?NDjv#fCrsDjn z{Y@4zHfY+3+vlw7=9QfAj`tJr4S?4SJ2ly$Jx`NUnhcCOC5?j#!KBvz(Onj-zS>em8(DL-7MSMM>+q2 zi8dwwf{AW%47X}XzB6rR@T}zzL3=(Vk09BbIIsH6#)-8)2U<>7SCoM ze^M);d+M4eE(9&=3*#ShNgIhV@Lf*s@43)iJL>uXNJD=g87CX^TjE^2e)0Q_!~6CY zeV8$~ns~P8t%V@WcVB67Ov6+2U)K#c5q6>BkSb4gDnt1CZtfCA-{5`^Qj_&aMHNgD zn6D1zBq4&o@xSt_Jvu(xkjXgP-p*XdT1N8ulAm*pE+u71&jMjuiI6a`KSd|)to5!- z#<;N*Wp>ZzSr`k@t;=3}h&zkSI~m#LVBcra=P*WfHGb}iRv(JFct8B+Tyc|=K;Hb6 zcX|oI&0+|@DOTLuBXFS_HIH-!Xzn-q>s{Y#(&}U(LYZD-k?;6LTkyo0vypr0Ol|>@ z?}h^QlaNo1&`3v#XVLj@<*t@NAH`Ibsq^$>pR*|<|L*}0ccjV=#V=7;5o5I9`R`g< z&**Ne>`QSZfr9CVx$0H(?}JiX7J}9I8GGVSZ4(c8;(k1tcsMvMw>CodXdjH$GH-d? z?g)kG!BYvk#81g~?AvKyCf}OAUDs%rKWiU@&20275RhH!n(&;J*KQKXjFHdA{iNGW zQMOsF|948sBM$iipP-WMk};ntp_U z%xc>~h=RT9yZcLS5WoNTv@f^$p0#kx+vMr8ojwRD4<$ZbSp|1s+7^+spXkB2yQ zA{n6TnVCsc)zsI%I=h7n^QtLhzjny8uQ`{D?>HWcZxRj>w;ok@$lTcd?tW_hV*a1f zKmLfYw0Tox0_RCm!Qe`FAEFOfm0tR=d#y@kHQUk{lT}jjQYksqJasS%m7$Bg{Oh+{ zX*O$_i0&u$f2;2I@s-RvrklH0Z4lVVMkK|xNz zlHD-M7JVvweu;}8!4mFCYa$ECb6NibGBP<{;NP!7OuLptF)%mVQ{5Ik`L{ODw?G;C zlQ+E^Q>^+zSn#94o@kWEuiWO7_6|Nu_mrPKHqOj{h$#cC{>Kc0x9(}y^6_&80dV6F z#l|}=`V{=y#T(Vb2UbqgZH9WI`@3|H{1~TR;=T@-42Ui9n9Hs)NS1PUAuhFbeSZN* zaPNn)|BlpY=i4Ft2h)N3C+r(S?fIYiq5pjTSp+8wyn5TyMDmxg5wcWS29c)JA0NPR zAn@7rKciT1K^Fn{7q#nHf4^b)@b7v3{|_+z_Xqq7%=~ZY)*lq5w#zdh=k8S)jQX0J z`%?Vce<>9E`~De}>-B{6EYJP&NF6Y84{@hOINxi1><+j`d~JJ` z3V1|(%|)MnydUp*-G&eJu}?D!DO5AQo*$Y#@JVU~4RvY?iR-pA;P@EeQAa8Ucb>aK zvRVG-{;UvxXBi6uDm=F#iQ&e<+96V0=)BRv47B$Oi1L4=13&Nf%#(m-ebqyA!H)r? z-nTt7O!P6}$3CzWI1K!nc1Zu!rWsS89QiD)Uj)9q01FDn^55)^7c!)FjdkA*gduM1$ja0~dl$*Og z9n~Ntg|?&ifV%XSyl)~1Y?Kjt3Vz|fVSYL7d6^7g3blJ`+M4eo{|TcPh7~=#>$l?* z*`1H|ycKY5Fm>&5G0zN+wq%gt*}mV7`9dUA*bw>&GhW$iO85m!Fz1dVOnb~@Uid}u zweKZmhxwQpRM>Wh8o)dqkPGUk(%d5|T7;vX2w<0w2cM8U#N%Y0e|U0XXR4op!cxJnjl=3=j^f1hz)Y1^&=u*cj)!70b-)9?;*WY@;y{<=9G-R%WC`tz|0GTarUITgn2!Qp55Zz! z0rjo}1O3jtfa{Zr+2{8M=?7cjWo@zjj-CgfZuiiX)H1LH`0g>F1niU;fN2v)LrTs9 zE{(p$h7IqaPMbpZ2Nm!BQq{NFx}<)UyXgU)^vw6X3V_em@Z6|;H2_p)9uf6cSV^BQ z>3Y%{Uw4*EkU_wq3S9+d@63I#crS>OQ6~}ny#31me??icUBJ-_a4r;h(7>QT1N(U2ZC8EjFxKni^E^7TZ6CZP z0VjeCKss3Q#IzgDAoF~r{1r%26+TEQ(*e|kjI`VFa1A-zcuxWRxDlYo-2gg9WG>8V zeHC|*0~S(9opIUj4nRPZ2Mn5r%%3v;1vS^_RJjs~u;=sGU~+|)KC*batm9G%ALx?& zRnf-maeK!fV)Xdt4@$WnBrIrQ#O56THT_QXyIi}TlhT`8=Huxq$ESyFaLNa3gBQ&P zrh>qs9p;j(UhAB$=&A2)M%~QIxPvg4d!8>O?t&s8vPcQr?19S!JVQTWUjsZc=~>LX zLI&Cyhmdv{cbYU-jm&-m@>s;ZvfQxfH(U7Hnz5=iMCVc_Ly!0rqE#8x$z}!2D6f#| znKdpxh_lw*6g>`X6Hwl7zl;R`Xd;6=FZKR#2v@L2E4^)5r6wDNLHF+F8vs_ZHpkO9 zAw3*6XdvL@)Tb|8=c4s_Z7&KbUwRtZkH>^(z+cl}vMCr6*4)t8WG~vl-@ls7K6v$4 zYb(=TR)tlX4G!zg-A&88p>{y&o|2wk06riOyAgLo0TR~r>$?dM8o~+{ug6Qsx&+on_W|51sWL#?SKr2v-WSA z9&_Ll1IW5Z`}0t2#tL9M*NizY;SkPUQCXUd(GeFlAI=6Ae8a;5?irJPO6&N9SZw$z z%=C5D?HCqm?+#r(NDD&6xSuq>6@Jmgo^Xp^HrM$Pwv-_z#aI$&)$XaY#1!$h?`5Y3 zgz-8}o(|5=0o-$nY<@lS0Y5$l6sH{bEcZMYk9ug#fDY5a_90%h!Es*dbWY%_&bm~y zN>T7{O~1A#b*~fcPYci;TYaGtDowv8;IddpcEpA?0-$&hB z4bo~~KH;tkX}T9*F(8&>O11awywn@qiW@oY+=K5sZo&gF%@lRF&dBW@a4O5!*AZSF z%6&WYgkiU|&!6drmU_!KLS%H8ZT@g6P5)jEJj)s2OM~cRp9AJ&#c6TN8h&t~k%&&{ zMatnYZ25}y(z_$b{MsXQu~K`U2%d1T4YTRza&y4)W`TFP0nS@mnhSP641#}?95J)? zUw%41dbjTms+ZATLMKIPtpZ9e4Pc&|WJfIfhE(fx4~b(oI(Ln7OI+6G)@xO$fRIz9 zXzSjYiu`&O{Sr*wjt3_XIX^hT>)v9;(A&3KHu;sP4SRN*yA zTP$@$&Z(HB+N%recF6{9ggUEihhVE}nSMjKGp|#A)%9qb9#|M@T(1?-*5a4D3x*hh zajmzUdRdAPrttb3$j<7EU3~RG>qG2^hiLJs?zg1ttx=zts5y z9WRk|tHQpt4`azByVca^8fU%5sXYFTiKCoFcR9`2s)@tqLL8}j@FbYuxiZ%}A9)VB zo+tmJ%f{$nsMt1HryyTvwn{{@=n}t_zV)6&ZUb%g;wyD(2Gj5WZF|;BG^Rex-eRe> zgxcbrz#IxQ;I`z)w!&8Kr?)#=W%vyZWbN#fDlY}Y*eHuZc=p;xA#_wSo^P(dex&j_R+mESP^c z@&Bg;e&GL#Ni<7_=;5>PENTIk!afQ#kQE6P3}b?%#jJGSOvNk&?kw=_{kNO=zbDsc zK$>#;UO-I7)p$x-*OL^FqyDJZqdMmuqVB_#^MSGxo&NhjEkONz4;ALyAH!`Z*S4|! zklgyxJO9X}NEfy-SZBSK%cE2_rr3Ud9G>DZ`|+}j3;mo&*TjI>Ae=*7`Oki2roVTq zZz=WCPPO>3hS?`_<+czqgxlH&y!Pf!4+~#@b*DWn?MF&0;=7(3N=$2=w!d%Y zTMIimVS~a8Q}&g}KMG zjJP_9nf}nd?m9Tk`vK@iIyKED%>{|l-geT;YFs9m117hn4Ggr_{#D6P9ZM;C&FEzD z-x5qdr+iowv<4IQ3|{cbD(WbMv2XpHcv?z{25(P%?z$EJ)K6I}<1G-!hOD?4h558T z#f@e~x%s2jc|sf29_nA)fZ>C(Uqg&2B}7j#^QG4iH8`zN2KBKIXX7EQ|J#*vWJ#){ zlr=7gXNR8LnizQfw;K+p*;G)?bP(ATupcplinvv*{HwwN%&a>9&(SY#kB;~3A+*EH zb+vsCe5?`Sfwdd$9|73zUwD1fk7ivfAizI$x0r!~FnKky8GLoV>L$y*Jd=Jo4LhwV zDNiS1u{13AlCX9EB1S;XJ)dzF7N)g5$^z(^AiK=Q2deAy8kQ=h3gZ8u-%g^$5nUaSe1>l*@t)f_ULO` z6vjq5{7%;{*d7KLuTn50OAyxs@7rmkkdNubRVZk(2JLvpc%G?N-F}f73R3qn*{~u% zCPXzE5Hq8&p6=k5+aS&An*ka-KKdNAH4L-1)S~fXWR+ZTma>8@ND0dY|e57VCZ>f#VtuV7Q&cNVCpU0Rzmwu3!q-cDi4)Gqq z&bh)yXa6kD*P*Y4wohc5l9}QVIVB|59=e#{Z_MffM$vnS?3tJ%KMbucR%L8=vdw`% zkj@ZxH;HBRtxM^{@$JfkWg$)N-uGzjCe6fuLwoQqym_!UZ6=QTN#(ZG_1Qd8hx-VZezZD=KU5m4@Q3ud-H29Tv&;ab zSy{Y4a-}Gen>i5=F`;c{Uf!1DjZ8S8r#G@RZ-deK(rxy($3Eq@BB-emXIXtMAMKVM z~*fPw) z5N%>yf3ETH6VA&s{QxIBx0Pe2u}nYY?s(RVvv3(v5g!GEu|C1$EG!*M|H%qaqgg0=@o?)RckhHP##7UPOBrxqG^x9K!vIrM2upY16Eb;{dkh)c}2 zRlFcX4dd1m^;8zS@8C-e*aywOy_rS5FS7pAO+x5qN9{vn}( zmQ<*&pXJ-!q?;J}0S1Yg$mS(^H4DjhT;Ftg6DjyBqFA#AMY8*@AiF|5Q?!_;aD&$E+WC+bf zuJIovYF@;2U-Xi4SEp#+Fgdm_!27D%@(IqFWWi5HNYOWUpTfO+)kekmj(!ic_dWvV zYix@7C3m_3og+O-Z3K%OQf!2Z1qFCA%4zH=?Uw+<-St)OSZob0(iO_~8fdm6Picq} z5MT@w1N6$E2@>^kcLbl`FS~yZn~NP&aCgi^q{4n^pV#-PiZKXOr;1f@7u>yne!U&F zC;ss>v2F{w;vBglE+_-`Fa^LN@p43R*;^Uyxf~=T5^OJ>qN4}{x$C?Fi|UZsPOjDH zP^AM^Fj1X^oukbJTa|@OMV0}K)@D~sa=UadExWK+le88upUEn2Ax0|ny2GZaSw|~A zMmf>H({xIA>2;-Teo+;?CeM2wN4)O;##~(aB_muz(Y;u)kQeLFvfzPTq~Pc^WgwrD zNyZov-j`CL{5A$wI)$g_>bhe}kGSwLCRLRN4S!nck$ajX|2_^+e1%4CWK{igX)EUG zr>JK7(>j6ss)r0yKTa4MV~DkD>J2>xj7;4&h%geQM-AsG_9)%%u&EwjVUuKcyYW!0 z0cqVI>NzZmGTK2r>Np$?Cha7KTPC+O9o!*L^e}D77G3}l`iuED6mQq|l;gbET~Gea(PIWRmu&$EDS<(XMXlfB^ku_-FqCB48et!>WsYp)XydoxQV4qsF3!|(u z#zQx&8m5%TWb(hOuW5WAq9mnv%1N@9rV`wQrNkLgdrDg^o$nUmbO-CS{c9}s*hnKz z>-zgU+Fzv%hAD0gZ9ICxb=bTy=s*2R4?Ht-Ru;!lHxl-@Af}^L0rtA{;@!Hr#UOL; zbcBnV%vx;7 z`L8q~+AJ|mi8oW<6Ln>&N+&wa4ADSrr%<;SoK*+l<~OW~$OdyoNzTCwiJmS)7$3P2 zjHJB6zQh89B%~5mv@ewl{K4sl7@{ro4eT;8-I6IJCUIChT2%yF{0pwkI?DCCv+vAD z#gC9e&pf*Q;`c0*n{R@e&Xs_+3|p%-dwfk{+2z`BS+KG=W!|?^> zKgdLNPvqS0O#dt|Foa31KYJdm?wfhSF6LL_;K(VNioP-|ho^70PQ9F7!=t`r*&(>L zsD!x{GS9$7T{#9YaQ(F>Q{D@+b_$R_60}nrRKs8^;UGJLd2@?vIxD^@t&-c5E$#|b zj~(O!(dEh(B6wm#TE84mZErs+58PEoLkJDCZ$5bc+dP9n2lp#<+`7V&fBI_BEJ?(s zy?F7=;pBHmmQ-9D+V8U89@IPpxW%as0fZY+za-~2h1>^h(H*~aTn~EVj(899vQ(^l z8*MN>j7S3W{ny~A;vEsi&9<4R=qx<)zuGH>=8Zk&%|*HHHxD*h3no9Cme@Og#ahpM zpXpwu5lfYd+C|05KH=B&tF&S%XXV6ElcK4Y-x2Y;7dY71BTVh?=;d7+_(~&^F^ckLt4<01NaBDYmSG z1zdxrusZfmW!F1vJXfxD5M#gR)?zuLgmM)jBml-doc=8nw`=U_FN)CG1rB0!E}{CT zQTKXNY_f{qC)iLUIxp34sD#`#DB(Sl-A>`XDRc)n-Vehs8JbUE1RZ4z^2XLUj-D%b zqxs!gjZgXG(|^%wG)+Jol3M?wc^B9F4h?3HO(VKt%XSG7blF~8=QyBwDn zz||arhk|FjDXOLoR)3C@$<4f#=;D=fm=;13S3qW*W5;P@gBD_o=IUfzZq4C^VdEy- z4QF$V0o_S^GsY?-joA;v%u?~Hy*oa8T;n&l9sb!1J3i1Ya_5KRHu$6HYxkohJFO*T z84=K@6Oa|7bV{S-ukAH#qByZjXYovDapDLO!Nkpe?7`wNn;c_giWXaS?9e7MK^*Yc z0$T5f)~VmCrcwdza&38pQ#<^qMeSf<72bN^5H+kp$%;(`??^!u^Uf?u+FJPISqqmn6 zeOTzTsJq{7q2iH&mUy@T^4`nXIB|_z#A}@!@7(;W;XB)yWFgDX+Fq=<@q49p9H+~( zpw;~O`49|(jclNN>*Uo;&Hs^N&vvU`eMLgwbGW-bpuoh*r%7?YM(%y@DT*TWus4p@M*Ofr1rZ>U-B`IY`RH$%bCp66m>4sYoA9+lggl-TeCE%ZmnK@9 z@n$;~h8Os1+x|bsoMj-ER@|wR!fU^QR!X*#Jo{+zw*19XC1{MYlU?**iJL^xBr|vKa`ya)OZ{qfX*ZPFt`imbY7vq+!ei~ z?NPqmQA|cIBiuQXbawvi@!0+RxX`qML*?#sUT|PPeN#NUz`*#()N{7)e&?umHT^8R z|AasHEvG5w+Ic-lp7S^ZA$(K&VK2ko_rW_26@0Oy_h z16sL#fjaQUE)!O)pGpQkYG*obwLwRS&ok3=1MeDkq3Cz0O)-Lh!=Ojv|7h-2u&6Nd zZ2WpWO=5^a>(W15i|O-}mfW9ty=M+MoiMUR1=HF`e0lSx2D@6r{Su|6FUS8Wco1b} zh)VWQjzMziZV&Ghu^0l)ey8QrJ0z~*6uDjDIA9qm&(rWFJj*f({AlSah zK8JSpJxK%3PwxIyP>SZgG;5>$tMekEfZXPC58E*4&Ra#w;C7;o`o_&>?I3m!pcWF1 z#c%o_o6Q7-|KX0iZmWnMk5m4viIM>~c4~%Z)6?EpPNEs|?KR5OrB=kMJVWzNUn;)I9rnu#pT>VN*- zzpj5c$y%rzeG>NIHVUR)qc#wN0OjTg1C-IAMi3-Vm7;#k2$eY7IUMPDQbo*eo@}78 zsQc3v6_Vm&&D^*mHeHQz&`2c=i*5m28z%u->@R)ncN3T^)jdD2nHU*9!VBM4QnQ5z z2($hm8Z(#Aj?X&ma2)cfCU~~WC`go>G0gjl)*MM1V9vnVj)s&Lm}k##i)*E|%M0-_ ztx;o2aP=H(KTK7G6%~5Sh99s6@J!zC@Uhk~setLs=Thbr(}hO|yOiMjyI;}CU#ZOth4IWJ=U9+x ze!g1~+6`U#VYX>7YgxtnL=Ba1SXB6FhNE;5&;e>LB1|u$d(Y@KEpUpTqpWL~NSmAh zQ)E-VG2`AEqNR<;o-E?F4t(wmZzry|4gE|xUcpOk7AA}&bZD+Fo)O7b?%AJKEoq`$ zgim#>f-%Pk57qKIfAcT|A0?Z~n{QUDO@!(i2z6Rf3@Tx0)g|=h*jemhu&F;u=u=p!u2Ep!*KS530Ao7Dnh}`k>pDjX<%RZSsNE)%Q|IjMFh73$aMP6~a%f z{o>Yk7~->c=k5$kfwaNRqsyA9{SgepVDx02X5k^~_%-aRG4J7!2)Z(R6m!$dRV1D^ zB5`AVqV0D~V;;$ckTQ`UEF+kS1nVDO(c*VG=G364VhVIUzm{QpdkbKUYAj(0QGBLn zK_nYUj_q8X!o&o#Hgh2xc~czk+`!wYb%Qeo_Y&JC5&z({#h74C_Un{1#_b84 zb6p9iswN60RO4W@YPZ@%urdB^^@`~}Sd3M_WLNEtz!F*ij9J>Tt(b9jnx%=$k^MBS zzoOVwJzOZ=WFw)qoOKHw8X$y%*LgTfj=lmoU=u$YyRbh%C*WOr6NHlB!-c=2y<7bV zu@UrqJ3ROlI}RSn^)TsMr)Y3f9?Vzd_(q(-nX!CDC>Qr1^WuhQ*x)+un`UH634XiM z@VLeH>12+|mi>MGY_EIc`1@a)-zJ{`(itl1RrZmXl;>)TxgmfR)HkhIS`k3O@T1^vFxOXsT^rM|K(o&0bga2A@jIoE!>g_Ac9?JsZMqS> zoYyQt!1h%G&RtEkuv~bzILL9G_W_C##%aZfFtktFK+Ujaa3hfZ*}z8f?4u%ey85&- zlMh78kXY7L_Ewh4gL?baYM}jesBg2Q!8N4Yq5mjm_s4F~o-q27JZQ}IJSVzdKbXT; zf!D3G!>aZ|nS}8Md(~+Wor3 z4L-G?Mn%+yfEe8m2$CY~{Aiuv{Cu!b@CnCJCM>ztelV?ji@Hld`UZ;mMxBGfmrS=0 zz)zm(1MU9#7(tyKVIj+wL^}NS23rs-?3F|KMx2}7#IBq6lFUZ2@77%@Wi=Zf(fWOD zH15_bLl8(Sn^=o^gpcz+o^KBHZzJ4q=)B4^+CZzh7QrWG=C2Qsch zkK@cO`lkvh7TI^9ZK=bgPTGv^=P&e;noCqJSInQG;-Oq7sql7>WJulhf==U<4RWpO zFKqxFSu(;*2I>^X*XqPP%c8PBu=a_LHbE=QMU{&7*&I%Pz}M?jzE6%dHybf0Z1n3d zvXy;n>)vtoQC5Ec{c8d16n@K*lCHp!xzvC$i$op=tU@fEbRo$?!^yUTNrkWHrxSHT z`)KHtSBh0CZ7__AC*X>s?r(Sc>zBU$l#{S18hKH~u7_Q-uAhLLUvR?DhMd9tn*)Hz z4PVLOu7={}=(9sZ$CYNb?h$nktdOFq4`wx2!hvBPBT~f|t3?K>DlI+3FPUfK4dO~8 zNTzT5c=1KKW%~3|Xia77zChEFPrYIi`$EzC1-45$l_UlOyEM!6|eBI<&4LrO*!GG?eioXv?`RZMv?G zn7-(LrQ!kD51H&993&@Q9rFDUvSeCYN=-?ErE0`K^!J=w7&X9+5n`(DXhDhb#u_<4B=4L=>ck5SRd~c=nHpi3?yC)(X zpyU8nRJSV|8CNs+II0GqDC$lDmj~<$MW9(o}hi7jEi+lEGEWib{o{&NFKmdA6&(wT%o8P}h^6F?OZ56-gOJ)gSn>mvw??*; z>U)3Bzy>>%oX=$k`Shx5e?8BG@!cFh${~A{TGyzITt`JXB2XiKnFlzR@Qj6K=OnC4 zMk-SFRvV-PiXsog<-muUChVFIm5cTI?$Rh~ggBJFgoPTe<*p_iEy!};Qe+W-DK1To zcE8B300{ZZq>?ZjJ8GMQfwHz{RFjEZ7Mu0erkDl{C{+#|+~{{=+t3BEn)k_4+)&6- zmDN(LTv`3Jk{PyCEzlT^<=x(=X~t64%uqGxUb6Xd%=abn<%ojyyUP~FrZQlFRu*K) z&mo-IC1)CCHAKT-u@aBELgM;4UaF!&?z0(vAHL!^c8at3sHsgVUzof$f|r0jAWwGu z%b@7(;&=c@X^zJx(PQlh4})fE1P!}qY%|nY!>Or-#!n9blKLhru|JBw$_)&?Yr^YC3YUf*?A3*OqEBL|>%E^LuD^hC#`Ix`+pt zCAoGPEpIL-CfoZ;o6$KCh_c3*2%!Yf>9V_{XAv0So_b)APuy|%#yPM%SYe=*BnczH zSjPm_#~=KKipdA( zpiP{8Nja)%St<`)Ew&BZME}ru#vJ1nJ!a=YS(v1xTU_J_-^Ulw@m?T8qvySi$J2Ss zaaGI4C_Rbhu*>$E+_AAS_7HYy8O%;<2KJY6P^L7*j;J_o>huFN7O5^!n3JFZ_MrUi zCp6a~GrhX>X&*Ky&Ev-Clt#w_Bn6DLIf*K3kf$3RTwjhY<@0}aj{7fHD%*_Q^7}7p z*frnwzZ@WX2n*Phu|~N-jTAc+o<(oL-O!dZRTvWLho9f99^(?~yt~ElxM&ck%D?wxvx_a1_t>Im-=#R;+GW?QWO0gLVPXza+Wr&>qT?Ul zW@0U3u7>b$^iRj8dfFWISmqo)FWt)@c?8=&md!)Ati7uFdg-KG&7(3dT-j!egyG3W z|0aCbHE0NWLB6MCmX~`Bm4O$Pb>n!dQr3WNj~2VcyNRsOgt{0goR)EKtr{1|(F6+U z;1Z)g?qmX9Pem#C8bIV+^V%dyz9bJm9E_xYJh&%0ddbOj{pO(BTUDTK5Vu{uL=1KSB^?f8$n2ZLv zo7}Z5--lGDt>bIvcJ)fQum1@n{@TR714ajd4P2NcFTmt0g)S_x>Ns_a zR!!w+oN}z~6tjw;Z_LXjS#S2Ch0BSRFP|JQ-OPIUa{?PGr|kxKN0JpB z5E}kP7qtL=!*Ewi?bi>LC6%~~4CPs)lSYl8o~inNHC9hP946LC#>k7n`)g;C!^$7} za|SL=yi%Z5mi2!I3Go>&c6h)^6dJK8a)`X?gt#Vsl1T2}WvQ^mQRqB_l#}kCVJ4sr z(d0bU)9k&KQnE;nY1qMFRga#jkXI2b9Q63j%&_r@`E@Gm4Ox~lzgucX@#GlXx~W1X zm*-Z`8SZME(LS8|YuFYtsofD!qf#xRJD0QSi^Qq$vlF}2I8BKm`2haiVADU9Gv8K) zwC-_1jh--{ocPcw%>22;R3@2ctC~F33p#e$@Fz57duxa3NX7)zkba{6`du5moI&1U z)fy9#jMlK*S8>yB-q+WsMyoq(J2j3z!7y{rDw+crprs5-N%iY{y9E(6N@Ki?rCap z%uKc^5H@;r)Y!MjRnWD?AI-0;zVZVypDfsUCZIduHjw0P33 z*@@}C0_XCG5-(YVndH_LNy#r;A1B%Pmg&y^S6GkkaWl0}pK>99A_Vk^ItXjJR>5Jr z1+!=n&$X@nA&xfx+-1BIxpjBS+*BDbPE6iEx>kKMNkM*g%sx1Cp{pYLjiiL6B)=Y% z#=(3H34C&Lkm5%AUg8K#)piK=WOE_Veh-3s8Sh55&A&FUOLdi=?RV5SXK!e;XJiHAaWfHrB9I!1uVLP2|HyPI-;2sKx``$ zwvMFybN%=CdemA9z|TN1p^lUL3-<(Jw5eS)q08LINs{#2q|WaUO0&nX{@>Ttb%y$J z=~E!Hm4SW{MH#x3&rKht+E|iZwvuaf4}EPf5KUE-4JO!oYHcW8FHlSPxCTU$0LvPW zF{f87C46SI35;W6bqU-|knW<&;obu1D6Dd96%IjFqFrsmAK|y<<5am|;>jJ}4%f`x&tQJF2IY*yDC9g6o=c zm_QyExMg}~T-?Hod`(_gdxDg$iujA;{cD#?a|XPQ@0gi0k(D@tc@_G|06qjyOEcT)CLRy9PLa#{KA2eT}3N4-q2`bf%QSwQd0LLVY}+E{Co znBp%ES=zMI!*s&b&r!6$5DS-pETDKV@>7=V`n!A=vU@o` zdU%lvC#Op3{K8V^au5c^ly2^f+tpq>h5L9w#~CMifBOaRtcLpnyGf1X`{x1I{nXZR zD;lqEX(UOepcG7IiMHBa-aofjnNJ56jEW(?ab78oJ}xs^^z?|TOLBLPwC}i;8VUZK zf3vl?nX^2pfwr<|sf4bF#{_D!RW1|<=v4E${&wH08u%n)AucNx80_TD`F2!VCFi!V7SR4o6=QH zEjZ$WBex|l*DFVp6qm?dCrY>@UH7#NI&2Q0R`Y*MP=n;Dg3VED9D?^))<`Fj%+B{Z zno?&s`L|wo!RWjI@SsT<_$>8Rr+cD%20h6=Qiv_w>2KnSik%I-jLBrh z)Uf=Le(pom@D6p^whLZP-9pO69(y(Kpm=2U-O8M2gcMa;P zy6a+37@?AoG;4gksrNWqH%@%PT7DPc^wUPVi*l7H%gI?^S5`bA{AN>kJOMAp6F9g}9^s=^t~cXt~8ie|wb zGOn#|zA#}}q}y^|pB`|KS~bi+yB4Dt0Vgy&($6L>`Bk%<$}OY4ipWiLerKriEw{>^ zM+HlcR@6Q(bJLBwbu#t0A!C7>Aq}?7zP2`ZrWag=41VkCC|``MJ19>JS)^K%o*2IIib@U`=q6gu;a*x@m^Jn<52p-(bFp3Xa|jamnFV z93ZcIu`Lu0v6s`JV@W|30*8)y8M9-LQqT+ASj!eX*5_;pJO*`lgDgnyx~7^g(7o%n zI{d=HW|h9qqb)SK_1K61WZ`Uui7Y2B0+_*?%?%TJmPzS@&bp)AMSIRXSJSxy|NaRZ zLa85ShBy>gn=Th@d`9rL03D8i%E_$=h2{ALDbpNFplnju<=lB?!+;}C2M>>2PQ1GL zvl-qt5OL6f+h^Mn1a~X!N58%j1!Ik(L(m%Aq3q$YY%S@o7Cdl~oR<`^*awbpBn?)D zb4KF*zsm|{5gvvv%H*1waqUCydK&V~phJgpt_r~~0ny|#mR*giyiHP7bz=#duO8`c zG$$shnO|>oa-gSd^%Hu^wEcJ|4t?%eO?FE?Sm9nOWQ=QS>Bdyli*Nj2pwLusUY&p)Ew!_1k}5 zXrTM6QVMWh)F5bY@H&c-aSk0TbFf&1hRSBexYz&!i@?aEETpcK9O{i{h%HPH5mkzUQQ%Y^QIJtGiF z8y=@nFDCScKtFzciT{*>&`#065ALV`#@N8XhzPA$zy3d=MG2PtnjP$CgNdXf|L@Eq z_3M9+H}vyAdbi%uF#tS*b=`}Qp;)529`zKttNRl35g&&C(s5nw-wyMYnK=*sZPV_ z5zQcn{`tz-v&6h{5A?u=f%d!g*6Q?N^)GWTtmS?~qiXG!C^+Q=H!5z9{Zc<`Kf-k~ z1r@@TDtJ$q5$4xN{b}Q~h6aTh`xoxdyiGSm;2oHC6xCd2Sc+}_CtLt#`nV-CsFK<3ya6E2@{Z1Ixg zvB&YTKPJwGkMXbWkXk+BaD_%&+Q<`7hRc2DSm>Y484j3QF%7+CqmF6GK?fsA6Yva1 z6dMKxd;y52dYRCqUT2Qa>VJE%uII5wWbp5x9<1zM2Z$ZH$g2EtJf<;}xv^how71t} zgV!^E&>}yFn523CgDzB(B8{s5kAx>KUR};PDXH*V!LjO0s|Pi^dJ@*Z&kt9p3gTT-L?r#InwHkzfQ~Pbi}wd@-(fdFe|W-QU6w9(_=#8xhK4g zPv77Hkn!bbJLJ zWtA32KQ>bw5`8DUsV<&7bI&GhjfOU^FW_OUuz*^3OBrd1#J&vUBkFQ?Hp`NQUmPY7 z+kZb9Bd)oQsh@NS4nD1luYr_YSn`_f;jhj!E^f&Syl{maz-Jb$y|G!vp{VDZk5>$l zu>T1X8_eKc@iD%5{>R#Z#?&4hT-5NKa?C6ugyv*iyN`xR_l{iQlXOWGR-d=6a2ec} zzl)`D+A0idj)|pUG`f!~_P-jDFZ2bl{5v}DsL}UOnYDyCJZdnPyrunA*t2T2kfYdR z@u_Sy3?PIO5x3TixR=NMRX2Ovxth^FV=|OBby1lc00oiPNT@i_D&Y;{9%vzpw+?tM$R6Y z&??~;r*g5mf=DcQJeXRnrH}PPE@X^G(R$#g#~%)|O9-)ZB`mnw-8#IMK|_qbO9bv9 z+}N6h`c)dMMW-4Zi~WK`t?=i`tmL~?*PxSMTPRT2t zlgFU{U{a`mU3ZyLx1nelc(r^2qaNQ3L&Kz?JVzgVt+^j`!p%7`Ma*SsAGdi`A&RoAo3491T?j4?Of zc?tdA6S|-|G~6%_SkigUcdAL;EZg6#e^t{TXqiIn9+Qc2_RPT;qK76yQXiH#9LMhm zXFyciZ#jj$4XHnZJzalf??{($2h|1_yf zv6+0;{E~iOs|#Yi0?%O{cAeV3xKU*r^&oZE?_IC0VeV;Q6U6R02Fdjh02?lnkpxF{=}H24I~ne^^X)gkGTkPObtwbE zoCY{)9>mw;mY*N$N&0qh!kui{~E=$l7;DH@ZA> zMH>WvH{&(sF^amHLV1SLY(NcHa<{&*J8W<-)%M3CgBW-_mnO?Jf7`in(!P(6d{R3O z8WcGGyx?!J&}D=Bv%Q6dP3xTf4vzS*L zcG)ITFjs~0SvJU`!LAjJbiG;u5&o|eZ>WX)xF}UeaD|JM(T~UZA1;U27Tkz0bDg1c z2ZxDB>q|Zq#_#b$^8Gu5~%e6EU!7 z0R^3DeqNUqTReBWI{#@O#!fr!@E!&kaSrFWoqrLf2vyUpIr0oWR+-5vs0{~CZCpF9 zvY=7VG%k2ai9fYNQ@{TE>BdTl=V_t}e+sP1W^Od!a_)p2yXni(rz-g$}ltXUeCE;2NX{vgOY&6u@5V zaw$CFVlB6o25W@9Gxt_OJ^QstDr1pN;0IRM_Um7*m}&}C?X|Ov2NxfF7P-2W8L)mA z8Nxe2*qfa5x+Y3SQH+XViBOZO?vLi&^Gh~IE4OIQiScFtisS65yri}4YG)Egityqr zzp4nSbSO${X6p#5Smccp{aiP;H%}|IVf;P^>g=6QT~f6m%a3P|G5y+W?jl;A;FHvB zzQk)in>p@c>&bMIdNbokO%8#up?SpB87nDpVAbsoWqjLfUku7C^dyK=;QuL6sS=Cv z6p+3=7t|q9ThlzARE%FSqd!LUk=vWSvMRT8!2B1=Af;K{!I0*T+{C1zSu$ovSLJy3 zeJs{roVLW$o612ckpXw?uK0TVV6Ch0of($Z>%qX1)q%*jC|BRvn1(qUWke^>)tLdq z7J7@R5)$IPRn_ma3Uyv~60Q3qQ4{ecUR99@snN>~&)*mw+yAgMY8k7ZBzNjn8kq8k zv)U0BR1mG7wfCL}q^!cj!%S0WXHH4E$C-b;r+s~xI9Fnr-2WQ9obrpxD!?GShBaqV z3i=LhJcD*3c-lB6klZ+ocPJBi`fw&j=+t#a)ye$`EJc}YMYEB{q(>D_MHcIazMbf@ zhGbqa$~pMUo4!+WMpx$ei{!)YjXmzlu(dqZJ7aF38c}K`o1PL`pp?fz-Z9PbsSP}1 zHU#=K$}zQLywlb`UHSO>EeL55>Bq&bGY3wOv3AuSLL|g1f55LVpdW4-J^-93 zYoz1BvnLi`O+yUs+Ow}aO-faJ%#2jNgD843%^J*-q!f(AYQHdC>s+wepA|!^&a;Js zDY-;anG4;mR=d?ubS{<;k1YF8E6F|c=#BNk3xvM{-5G?nvx(_lTg=+deDuVCuLtVT z1z`qsrlLJ(CuFif_KRxH1S(im_r1kxr{-SyZg~&{Y?4p8Q#U<;UAHp#swLYtYQkTU zt8g^PKHQXhNr>Ezso-aAUInGal(q6J5`#Mh(~$9XmfS6OCspZI!?EwFMs>1DoI1Z3 zk!q5urRK+wV|9^66Ssk|GI5UgsDi9P!V^$%ft0u^CLNJ}@%jAAV5?J`uTBYJNz+j! zeR$N^EYb)#a;&P-wTv73YiSQ1itZ&nb~m&nwL<&112AB~Wk1!r@70V~;{R{#je}5F zT7)J?jEas}NLX6yG(E`A64c3Qa!qH?0Nss#5&SN zE7|`6Yg4b_lszuTb?W~JWDM0hg+?f%DrGemZrPy-zooOvma{q?zbJTMVn&tAx$eMn za-XHNk1MoD11%!R0@d!8m;?vkpGs~X{_kO0LCpU_@vQfHn)847Ces3MH&2@!djE&H z8wmG5Fn6`G{)K&Os=FFr|Kh(fmUD+R7>mE~Gp3)qsBC!-;}0U$J^+Lje`bguTb}e&v!CwN+hXi( z$X&hct*||+>_5r5FMZ89t%-NLU7?D&yHVQN@OF2tTzy<)0TCrX-L#vY(?vOQSkE-( zaWe4}RM`SdZn%4 znL&7Xt@;vQC@6{}M|Ot9?0(fYgH(8m(;KK++QW=<*u{GDPcP$mQvA}t3l+?S-h`YL zF{f0|4H?Xmi*9v^gBJH4)j&>!MOsZJ)F7SQMV`T_p*>KnvcR<1$OejYp;B}HI8?op zBwKwZ%^5@TA~OfgVPum%o;=!1WgDCh6_j*>Min-fZ ziI(lNOk*|*ZGW3GON-`0{9n^P)?F&l5R-rDG=NJRa@-wYC`#Ax5xjPk53`YTZ%D;B zJFDp8c$N+LsP^o+&yQ$xkP?iIEf=1gFYsCmRYl$I_`I-XHstBq*;2CRYzyNFy^& z`Hs!|HSALHV}@?2W64pB0&eGkLzJCs3OrHW54RqbV8}+0z5AVmLG$6c6R`~S z6xoHou$`9Uc#(uaJ4j|+Lfvxj?1ZXoXcoL`fXnLPU&e?I7bR1fsvL^~n!sm>=c~8n z5K_0%K$1pY`tvxE*~k7b5jKT|*m;9R))LN84tnnaJT#h{pEgkWS(V1bppd&G9s8u7 zjQ%St!=Ce*yH~_d(AuFT@ia#t)W9>O z%=q}|BlQ$Emx*Du-|?Z-?Pu)$KS|g3aOoOMB^;N!+9Q5~ZCB%f-~k<^$0z7QFnS!l zCPV(N%dJ-X4Tt$Rpgp+rQr?Qm#0=L-~xQAGm`jdhF=Q+~b zat~`l(YTt8F`<*y*X5IYAGFf|H2U{mw%zAU=3TnqT|GJr*~cISHAS;))WHk1N=lTa z`P?)fH3a`2b!KP?7n8eSq`&c_fMgLVq+{8*>$HA#f$M$CT z2}yaN1JoUEnq^0)e#%zX{_pGSZ0-3qPq-iD-L;xLIq6E8W{>*K0y!xsRRHQpXZ@JG^x<2&egUP^v zU=ruB1koJR)mOmb-2~8&L3=hMx*qGyzZL7xbGXd|_KEXkNs!WOV>(qx9EABbpB(%Kw-O zRyNRg*F8$%x68gobKH-vTyEq%I|5Cls3u`F15bbR(d(h9NvFr!S%*OyDab>HQ(3;_ zjh}`W!N5$Ad5Rvqr=@?Xwid;bsaeFn#$d+H`t9k>5PY5fJT0lJq+Nu*{!AS(688QE zaE1S&$Pi*Ts%QnNUDW!Uq0~xQ=f|hEi(v+oGG=-0OFoI}h)t=f(cUPWItc4d+ahr3 z{8_-wlVfjk{iQ#NAc0PdLEpFUmfj8?EP^obc#+KI!61dBHddH_ganx(w_>bNbDimq z!Db?%wO!UJPkc`=3I&WT`&c9zcz?U4DKb{Q+&KdpupJ|mn=Jd2E&N-#G6|p^K->aR zT!VrFq+gAuWXFrueGmQ|;z2v`_yB^Mk5Z83^EF{L0%!&nX>y&R%TZ-?pao5pZ@ZDM zw|K3ZlT+{I6FH27_6wuG7}qcjDODFCsEcZH`Q{kA&(q>&8Sh$SjzDMb$GC0c7MCmW$(;vQDlxRE9M3$AxG}g<&zStS~ErgL$~`On)lSF-l2y4 z=@iH*n5wMOUBZ(FNQSjPui)nz7AIrOJw|V+#5!XVF||2?iPL7D ztF>1vKO<3oO;vJl>%ohlURQ+x6*~OBY`TdaILL^xq@Wy*T}|+A?nyi+hyWMPp1oAK z@KEVTof{`O1-0+vl}*L^=?|Yb3d<4cGcPRt9k2a^L?y1vT`MdE9aeHPYl$q$N~22T zaFu+DQ^o&0zXT&Xx~kvQqu!{W`!#l5@_A>XyF}9xy-6ABw$?2Yo zPsSeNW!xAkg>nt6l~BuqmnwHRzcGVd5j_dTtv0-8L1FtX!E0VB4Lj9RS=r^2AWMDgvlP2j zM%%?|g!`jWs5ElYmmBAYV%mLpWa7tTAf5dwO=_^pIAF&RysVZWrPiOsLU#XoQg}sc zeVTJcM0D|yRI+xt7N|5IZY?r%xV%NRo>8eI3-3EyeazY)&VP~PRZ*Ww8sD>iKg;ZD zFtFhEBjwQ8kcy3#!uv@x>Z(hzz)Lh*owaWKtopgoQ2fh)2{&uF=QMyp+tG~^{ zN0g1l3;Y)D-k~7Wk4yv_+dwLL`ywl(-v9puA$q&qkr&H6G z0VOg2iW!6}FlZ%65x|w_h#xy6*&SbjkPB3%Ao? zfLHHBFG^XG$IZNL_oQ%}^xBwR1~fO@-?5_vrr^n}9*YD0kn7+jV)RVXR;Z_S$92VphDDtA=AH6LWTiY@Wop9 z?6ugH!Q-T(f$cJ?RD=$=>3M5#a4dg|#ZMC2Lr`)7u8_+5oHFsG^je>~9bRcC`yI3E zZutDR9O^T+{9n`zo%wr5x7(UMlVKf9E%XVEDj+s{&v>7b4%g_+L4lXodna%o?Ej6v z+fPDGg=WsUZh56^WvEl_vm?{`3u7ziQlBfgs35G1K-BfxlwNGof z(xAt}$+juXn@{ z7kR(_Bwy4ka9{4F;x27oDy!w3lK2vM^AwSL5wzp5Cgk4g7{YB+SM6lJ3rkhz6*i^r zqL?>H9wwjOf*E0M=~E1sw+YYmUoJjWzJC^&Z&pxsk0DeWLn^G*=I&qX!tw{@(M`%F zwL=Lj=*;mYTEu2X+pw5`X7L(To9 z@M+;+7rehK@fRit&Rou9ya`Bnq2E<;d3fDVYU+&(KwizWoUwYP0oA{gAeFDhBt&}s zZb{8LOqL$MFD!p4-@}Sz90tWr7v;LRHU_P#M05^NI4nf`sa$u^*~z#5`s;(t+JC}J znmNu0bRDuDd{7phjRw)8OfWXN5hc2D=oEZDt*w^+YKRwi)0I$y3V*wy?0WUTE$&6jpOha`+#S{2co$X5&TCIR#D< zB8**|mNHd#@^CO#f_GEp1d`uZ=|d5IGU5GEpRTH=lOIhiFiCj;D*95BX+&jaOoSlU zS)h->25WH&WD_ut@*rDql;>}Z;)g&VpG!~wVbq@%4+YLDCntqo^dL@-VvsB2rCB^` zl(u1aPElmN(0lu=55<0a*jZ}sK5ugFqy~ZP{N^6K#&%(0TdQ;LSbNF(pEDg9tIkGv zy&wtMJ*~pF4!fAqx}&_U)HJZl9Myz?JP>uv+@x@NDhM?5bVqdHQ$vmRHZ)i)RI|Of zUT`Iq^?|Nfg=?6)Nq=;J!qql`s>CnkSblbahp0GFcpU-8N;`yt^(e}IzqSztx==Ps zxQ|`PRm+8IZ<8G18199Tl&sxe9ioKw*Vam-;%Q6HH$=!J2AIS$YdYR6Pb7_R8JGNi znOLwiBC8|e9(f<`!E`@H7MP*uVtJB4dw~894I0s~1m5MXXSt!^z4yBUjd1@7BpnQ5h^(oFhV!@lUcFeN&!a3I-~PT$k$M0dG2OlBtWS{3ja6}v6=j%;s4x8_h($fiv?;+_K;R_#G(~o`S)tha5<7G~%{E5uYf}UCHbrTQ=At zuCtj+OCV-MgF}spN%paA0>ml5TPZQ)ZKP2~IR2mLOl|nlDEJ*a4?|R>Up`e{mBVQbyn&hSSi3tzv2(Qp$I}&*e`I zPEBLz?N>^&P7NBs{|n&sro0~=N)Zjx);P2W@H4SL=;wJIqj~dXuUbpV_1>&k_UmBw zD`?Wr%a%S=cZvgpaktl@0QhrNcf<6p!(l_#O)Q3=6DLrk`CCudJyPB2@P%(`!rBO> z3^CK*cB=nyyAlZ`|9HvTp&*pKJ!D3IzMdpV=JZ}aDA%`mecW$>xu0=b#0;%8T30i~ zKZWIEQ2zg7?X9EY`j&lPLPD?*BuEIs-QC^Y-GjTk2X}XOhsGTmcWK-uxI<_xSaO^E z_SyTKH|~35-0^PzNi$~8xz=23R@JAzRiV_;!FW}+27nI{3jATxD014pTpR5P2|uO5 znK+*T@Hx+?+E%Iyo2pHfce!(=pkuyAUl~oGsTIGI%T22VttQKo@?e3ak{cH%jr4M+ z>(kcFC-K#aXA{LrXI$xZFJ(Sg_+JqxSqb!yj}NUWGZY$`1v;_aDy> zZdUS(ciItATT_p^xa(>i@=c0z_WNxk5;Z9%7-8J z@OO;9({+tOlyIfw0bO+h=rOk#6!fIR+ZLj+OAFo}=U;p}dN8AyU_=g|o{ZYPf4|om zf_DB1SZ|;rVSN4Z9#@DcT_7JL)?OF~pZCePVekroOZYIztd)=1^yLdm5SF@y93|c- zqSk9x-EF=dSCgc~bxX7o0Ry;1C4#d6rx@AEJ;bek^s^5q8fXzXFoWv=6{(>PQ&FKM zH&u8UdJ_#J1|4J&!MyEXGx2gXk0=43zdGMR#Uh zrjN<|k=htZZ+i%%5N~ZTP*huNt}%?NA>{*`ZVaz$bu?#Fiq*-Zgj5T8|K@--zlB`$ zcUJJ`BxUt+G`9S8xZh6ObnA$EGk5nc6j$q+UZhq{BrwfdTuHIw+@{`S3XUyJLnl}y{JpNiEm_#j8tB;l~Wz@c@PIG#$7E$#ks;839jbh zbEz9Qm~A#C)$Ou<=}W#kudX=0vKR5dgpdlXAEOr&nmSSo_3Na_VfUcE|n?yRq zEAL+BQYM#Sc>O})PY+ojq*yFCObRPnA*0+r5vt4D2WHIu>J^pOMLt29f{)KyDhOxnIUuNTO z|4wqjh>y{delen5MdxByOpix&a{kBc+{)AD_Lw5QEVeQ!O&m$w!B|RZ9T(ZlbW-I@ zgYNRgllA+4M69F9zI)YM{nF^M*llkYuAKV1)-eyeO?9f_U>)_PTk+s9qCexw-dHNRy}hN;^%%}F(`a`I7dw=n zNqex??6Oaxlg-Ib6h4Uj@*%rZ=$bmT5(9SXdRzJ=)+EE0^TFpDx|$BsV8rBhj?@LW z^y><1;XbcS>bzel;ugDdP6Ek^Mg&R

*3ci!<1N={*F`yHr^TlgJk3;N zT|k3F3n-FGC$Rebg(){WZy5Rp>`eVh;O6WnTDBPyfeKVrUMf18w!@%c0tQ-BZE=xp zGCyWXb|?R`^dWMMxxbDiLk`p~+~6R%o&f)8ik$B{1Jn8?9qf#YmFRS-$cFkv#&&Pw;j)cScwnn9Y63h>lZG9_~P3|r|8Q%ib^Qo(8wAxGIp z)Xs|%tB=5;RVLSn7+wAu-0@&(4M5Os&!T8jSY<||LA`;Y%b*KdgLlyF*%VQ#HeaJ? z;n%fhS(wQMa_WN`Dvi7Y--?R{9$8woxL^7YfK@{jd_)?aB}J4bM~L%WObavRKwE6z zCeXW1^Cv4Pd|4A zO!?izF&3CvM2|jHD^(r>O4<|Xom6T+_xxwKW4*4G?UQCkl)@K`ugY|k;VLCv6#jpH zl9EoRNR~1QPck2>rBO&SMRJQ_MMDjmxKuL=lY^#z-maabk+$z|xP{5(V3(Y>7_EwH zY^K?dZ7t-zq@{@8#}iLs)a^F~9IW_A{bSjml`7+okv}M!(q42tN9;Bm_O}D0I)q|i#Ugz| z1P?l??f|vyqY)Dp424AnvNQ4SBbmrnA7w&S4LSYX?W!hlNE*0c5a>z)?ffpAf1hi} zO6fl_QI`iTlm4l z{*Bk&;z1I9RKx_^J1C6g;-7xtcOsMM`5&v|I&`%gfxu=JO3{_D}M&sBZSA zDSl2#q9m#qMqjYR9~A>8+F=r0 zpNMHlFdlPr4>q%2xRtM0%E!9V3KlkP>~CKEzTcnif>lg+AXligdLFTM%|Iy|Cuho3 zP?3Ab*bV^Ww$ou~7OyR(N(bE+^gQm}xoF{SW-9RDx-pxn@m@F%Qkt$fCRDK4h)Pgo zRklc)=u_IjFXc?^QzRty$kB|{@RSp_c9gl==&H9rk2+RnXk!Wb>@C8v!}x4Dbs&u8 z?ypo`b0+4%m62HBp2_}wMfpKqQ9N1{HnPa$QNFlcg;YtT&%&`;9dXZE*7N6&H`Vm@ zFoiO27^MPK-|0Nwjw>chYcya zVb+{G+_07Ej2}f=29w3Zu63wvK91ly|99`>L!R;|HKN8Ig=1)pD$TIR66sms`mI5} zdwfW#HjDu|uW+_jm1RPE93+v??6|s8iK;uj=U75cl#u1XwO9!t3sZ|y3g$X%t*dj4 z`Gwq4P4(YL02X4iq3&iFRpY8Mx624Z9aCv>z%|6{QQ&A+oshW@^0iRF zH84#VnzQc+gBoVJ`0>;@cpdz6(rP|yZ^D{|yl7qt%?ix}mBsRz_G$6d(V|C6BBg$~ zVhWLOR7cgGEVOBu5Fx0+C&(+`=?nq0gGK3dh-&wK*?dusLu*+3aPK8=u(R7l#O-;8 zJJ+JB&thxn&3nG6zTPqvjDeo*BhHb+mV*vc4}@kC6DLc3`2nk!!&-pCx*17q^YE<^ z#ZLH~FVD@k+oI|_&n1co5DbaGIgi3uo*k@Ee5^MWp{oJQSZgYep=gs*9gF{c1mq!) z02MVSIFvskISUr2_K*bKO*PgW@S) z2cn#m`<4}-D@>tEJLMPOg`z%dAeVl`&R5W|xxqabZsbJ0Hli}_AaQ>ZFBZlY>OQj# zt0Zcjkm{r@HH;SK6?Ji-?!d3FAp1chk#}CzKUQyXR)DN{TK=Pp`$3@^FniWM`D&np z!~9&{;;qI@gB_r%+nLrFE&ggkdMcqh2M5Pn;o+3fL7q6D)Gf*=SWm2c@Q9#gpotg3}e%1V?JkD$q}lbm&?Gu2Y-@@rF0Y zrgkLoY@du)M4q~Cj6t-CXGPlCO_g;6hi;yLHT+Y({#+6j5cyJtHMztuyC+`$R2&Tl zQhb-;aG8k#GLv5`cn+nTaPn$P^IlwHUb^t?r!*T!vDc?ki<;`C67~9s2ke&}?Eo;ZrreNE5jzdDJQCPYX}Zzlz^Sp1E5*NxHOr1?su}-Z8cZ z&D_ox7vmcbKP<`gdQ3i+1^QLr@cOh)Ra|Damkvc`);ro~C*8SCiIadfJp{SawlF#E z4mN#p+B~H8#wWe%y+b5AhJUW*n96knTU^fJ^`&wBZQyT@mt!0c-Q?Ka)YL{9 zg-5yoTJq`!=g|%b)P* z|4L(^&*JBl9h9Hb#5qQx$I0#{fP(t5FWTL$VPB3(peM%V(_$@R zY7XEDg2pfo6C|kicDAUp{iSt_vH#4eoD<=rwh?Ie?Yf=g_-o;%eyg0T_g>4a@zA#& z9iOcMUYwC<#(m;#SBwFtLxtcNt2dWqyprSdqrRFBAxC@Icfox4jQ0==0BVCUHfqUP z7fGUlG2P&7o+p}4pPU_2n3+KMI|`2TfFxQN@j<+e)%PxeXr%7yF8pTE(XL-DaN6$8~&dop#1Tf4zCKg5vq* zh7(bz9hF`1FeB}ZC=Y3O0rd?L6~WP8|Cg9aNWR)Akb-!D~Vxm4_dL9;3nj&nR&);e+O6I7Sj| zP{1JaS42{4qS0l)8Dw!VAf%1={rgJmgo0rk!=afF5uzCjF1$B1wxPWRQ(=wLQlM*^ z07fKR#J5}MvztvLU&lbF<-zN((7$`jeNJ%LgSfN_$Sj!F%GAUulY0p9T(=4hXCIR* z#_I{F=!OAh*A=t_s-V!%sQbd=LZgk8Sb7fh$nke2B0bv-N%?B8bNT+8(HUG&$YCz( z|CO+enyG&ol@v2L1rhV{<^jON>8c3Q3WdZKi``M-jN-YCepc~?5_t=dH_+u=Vqt_d zZb=l;;FMnxQ3kIe8QIPaDmT(MTr?eDIm#lFglC!DH%U=`0=h^daR)YAqQ5mww?B&j z9|~s~mu(cV7300_v^qcH(Or2rNL)zN519?r5v`uYoDS3Ia_dA7j@J7W#1$KU-*Xbk zT}t5!@Uc)?30qU;q;WsxEkqbXcW|RdfToed^1(2 zh)rCHHDzirJFaNL!6@5*0^EO}|0@GokqnO}VN3>Kp6+n0bn6W#NrfLBCsy_o_m$=K zun9lKMP9aG$W=V=R!WR~sQ>vqyK-?s4%N)wd0gJW$f(`R~o_I=Pj`jhfeZ$TVDohBq*~!)m~_@-kuqg^mY* zRl5Hqcc*D(f8ZG#vPtsdfQ!|Wl2+P$8hMKm;@P*vvmmTci^rgbDSvi5y{Y8)(kk#H zB%ZjeF<2F+HH`}a2lAW%rB$Jk6omWLMU%?33R=3`X)8&D&?RraAdw{GF7xp%RP{nx zy?E6#GBi;Ds)g)G^)wii0dQq{y*Hx%Q*bh>5U^$3>Q`MGT-^K(@VVoNVpYn5qf)nY>b+@a8Cu*1xjv2W z9ws%J=s2P_$MP5hr)F1~m-1E8b3J5-l=rP%66B&h>q zM&q!^+p@JVsoUsL`1ri@2Y^lt^f+?c(A6lE(pS~!;sBgTu6)^?rW#_Er2M2Q(89qi zcmz^eW*RF=VGuyD5_Jyo#Qn8J*|9t$wMW4$+3d*5IWxLh&V|2!_N^>eu^NZ@2Uf%G zh1#d^(#!DwR9=s!I&JCvNVwy=|6==tZ^=WUcwIO0zWOxdPIb1Aoa*#ykT2k+=0c*?ttxf2%9anf9 z>EUYo5JAJVY}KS&3_tRABY+28`egIk+g4?>)=~Xxs=SV9%WSEJIP=%=&j(FitiAHb zj!fn{+^J7vq2*N-AxA`df`X*C`Y1?x2(!K5k7-TebBz7HxnEQsUZn7#aN&2G=T04u zJAd-7`}cRJ@2aF1yih%&Y+oC0J-n@63>=VLd9mVY^)`HfR4bh#*TwB+Nr4fr8e z_`{e;Dab^Tet^YL?^d^I0HzYw2y#xeORAfMgrKqz3PZX%QouJ=3Wu?3+0PNyOZhbv zns-G}Y^#Mv0#$*S+u25F?X;hQCPP>j@9iMk%apf%Jv()sP}6vyG@tCL^{?aMm%srA zCZS8xX`lEc`Na)t{WT zaZRcvA@PN8|6mpYNP-xF0pUFZWq7unsq&Q+g<3X|+ltC9hSo_9r34@0pHP-(%*D zyT?JCg6dH}Z4G7Ek&?}5s9Iuvvd%XAF|_Swku=N5SYxh~#%OCIjgFb*MvSNW{ zm_r-3N(ylBr2&HLy>nywSqIHur~&w5_Wy($|HH}Mel5)j_5ID8vEd#R)F5e;NEpOX z@|!52^%rK30SDoVL)Sr??A(%VV)1!>npS;6u9<>iv#OtX4jnr%i*|Z>DRmj>%6SYy zlF9Ts_JD1!FdEmb561p{9nHtj?iw&63+JEyLJj1p57Zk08`W7%9+KKAciBt`s?m3^ zHN>EnKSCCcQbn2KV1V|Gi^bgTz9QG1+~oD3 zsC0vKBn7fnCNoPCQ0>W~?8q4z$LhB?(y{lhtvb%P^o>nuQgUgaiDW}jVQSM-`6L3S zPTlKpwMY=6AQITB(zHpO>7pKf|H9y<6{TDC56$rW56ws`DtS}SvI=(GOYy2!1iRq+ z$k-4oni5t7cBk=ThgXLD(@wT0uP(5q!R~y;hA-e;$m^Uke?yPXo%|8AW&rC{CYzxb zaA2Xp+p zxojT!NJi|X?i1oQ>g)eNKJCJ-2f|6Q_|FI2*UbO?3CcQ4{{@_?@n15KBjo?>NRWGE z4@`R@d^tKnye|KEe_V(^HH&qiJcao9@N_u`Qci8>m)?ra8D661r0<)nyqvo?yUdiw zc!eE@&%bMby9BAMoK8Qqt&3eT{gUW#3@)@Opc*N^Mg}O&oysV7{vEAlTAmat{)Kzjcy#Q{DIlL1Y1G1C`>J8;XoeX zoOfZoRkbWBC{o#nUvP{~9C>m$DjxgM(lS~vv)uq_|CxPBCL6~jh)=U!jQ=(gvj_T8 z*R!Q62WMlB>7r5i1Mm{MODmlpOSgMV#z!{S@mB37UTCeJ$?5*vB3pSgNYTUl54LPB z@#7Dc8F~P2=@DMDEgx3}b!j$7tTK8v_eCQ9bX&r6iNm)qip~4E^_}!LRFXWfCnGuHcxUE26w0wG>es9QQ`|UIk=8&G4J9cj37t&*A@7cbU zQ|x>T`;qw_E+Y5yLXun7#6Z15-fz=42ixl!cbPewK>2I$>YqH^PnJ`+e!EGnxg^|9 zl|h)KS+f&pK2Nu3K1_Xm%S$JA$$;~Mhw^4Lk%cY9-A4Tw#%>RxT&I{Kn2a#r!~TG8 zjQYyXE0qmA4-IGAx8n&;m&UqRKKL`kMs-_YO|#P&Wo;nZX$n7ETX$Ns`XP|l>O?O3lj5qZZpmNy$G1Yr)+7)j?IXkFV-lQ`T+Al= zB#==e6L%lnn<*7z08CR2_^1sLkwx@*oAq(%dx=tFc#64@N8?(~Wuby^eM%b%Jii5O zb~v^BS4ztEInqu}|CZ3S))hhZpK&9NXOlsgsB7Qh+Q$B~e9za0HZ+!zvylQ4-0aR! zdev zU_Wd|!AhV$Xkjf>hxDUREmdIbQ{y_~Oh|%HaW+?vb4CM2z0y zN3IC{X9h_!x3o3N6@6l0jMN-O1n8*57rVOskY0k(^@bR{SZ*Ci=DLIS3lUnTnDM2$Enlw3) zqGF@q`oC7aYa(RIlFTsKCoe)t0jH{_aS|kaIL~_WXx5;#y}l$#LlF^|0ESVo-608R z|JuLgc=;6I3$!ODED9E~mZ_~K|1cVLS=ba7cVuX~D0-~0r1qd|QXH#0V5)UxN~t75~BtXhf^=9#Xm@^N&{4!7VXXE12ZK5Nq@)WMW< zcEe*_-fB~ko^yLv)BFqsXaDOw8# zFs;R}AmM-L#jsk!#xhmXC+wwI5OO_3wwj^Fv@znijH94cz`wai^BKNHrDqs?Cnj^l zlvD!c)(jiyuHqEmtk^IDXwZUFXg^}@zO05*>)kq5OyR<){xx}Q1E4oOn=MY-=cV|~ zW~)OOS-S&mtZv#$a@ud1mjOexd$Az9!W z1PH?^aLuFXhQO3&G9Qogj0)!FZ%LE{Vv@BHd1f<=i;;nD`#IZR-sgXNs2x)@e_$BK zS6!GFm-}LbhZryt8H0box zKi4$`6{JA6rI_s*Md)xHKh~#awbhFa5uO)uw;L&XhF;TFs0?VJDmvQ<{WUoyC=_Q@0inY(cQ#WHLT8wqxb?aYkM0&97q`>PC;3)%I{ItB*W*^)3>c+zaSGXlY24 zGgtRpX2UQBqra(&hVK*iQ%(JL89WCy5rpO0Rec}><$}2OR71Xp7mR^OA1V#7CYk7n&v)Ci&5b0nXo| zuhvLQ_DD=yurE5&XN_QNs-rIWZ&F5MPvoUTkC=@}rvV=NbM%`D_=U9r;4h$hdd|MO z#<^As|67c>w>KBRi21+!rm;N;M$>wTP9 z$Niqk2F0(&lW>DD%*1k!gO3yemjUGky1KFNzIOSIYf9_0bmPFSTf2C<-7I$fmco zoVxOk!c4lH_9|w+u?vUBj-^l)8%R)L?bui?#@eAS-fa+Wmp=e_BU~I3EnAT;0JfI9 zm{ZuRdyK8D`h=^X>lO6N78)Krewl(!zO5cnxER{dw0Iv~{evp{*5JDCA-!HSKileL zsrXDvVom)ARfuk@xVUB{hdTv7Mug6u+icmNVjFls8qhyMyfy_Ce;LF$9vr%WrgV%A zZ*PBIeS5tvmiE92a_s+Jkb^w57Y%OZeT%gw!5<gu?K!%nly0O^l%KqF4mXdHa-pXRM=r#62Kb+BR!{`i1QRZi<~ zwq4vUY|=4t2K!>P>oMCs@{PB9#cO$tut;|xJhn)!+ecVZ9Wv8_F7)H+mG4Gx$ediZ zV=6)0E3TN$j^6$opS&BerM&27$Pae{^vF2EGi68n7L*zV9xrt7wFFxgoMb#x`152q zXul0bQ`-Gama3G~V6_=W5XE$%_}sy@QS63z&nxb{`iyrI86d5vIyOb0xnU}e;Qe|TzerKxD2uXBHv)uK~ zi4gDsjQMRiaiQt()kA|YFF{t(xQq0AnHsj15kmjIEY8ZrR=C*A`WLk8Y ziT%!^3{A%FmZvoFNI9AdH+%F&6mbHPO)yqTh|_dtnQ?CFpQoo7QaoK@( z?;8(o!S=rv==~(|*SqDt?k|ejH{ApE{9bO8!1>gnW<5I%{i@yf@HxewT3|b)ATN*a z7qu|P(5PQmnpy$1=v4R!BXIPnB`=jOp3iBO{hH=ID8plHY=&0?Syi$z&4K+iLlKVMZkjKQ=&!xP>%*?q|x1KwY zb~WCs8`ERG!%NGP7qgu{%(VRd8X3?dY7UU8y{7fFBMDsO_q^N0E zBoo97O_lv+DMu4`;E&z2m`8(lXqvFeKOqkoPgYIgc=w$8$!nh77Veg^y$U@c+`4cT z3(~Ah5y;2fuQ~jgM9p$wqY?15o$qwgX(=sLGb{+{@DRz(EISd5j|Pqlf09|10^Ox5 zl-p-@1lkkYtUvb~FbG$pL1qP&T^np1@D|o0Kxll>=W%4O*X6;}OATZl8pPChvD+}k z+ZZ66ZV%TCt-BUD5viBvIy#oLUt)3Ri+QuFtb|a9Gqhf^0`JM%0OT#TLwMtW_L)@o z(kfYr>=`cL!4unNf#SV2!}c;p7apub3$>`?CuL-`%_~>q5MM?2k)wcc3vsGeK=&${ zKkRFCV4Af#M5YJF^!+AMeWo9epCmMPuhaRlN-a#L*b)ssYD?v3i%9Vw6&NL&pB#Bl z#eqzD!GE$@T+KxuYen*yUTMc}c%g|ZpuB!pmfVKafTQmadM4=;=5iEHs$NWB5qRbU zZoA6Pi1d*3dMVq&KaJ5}Os#fD48dfy7&I{L&QfkOQGJGT&3)PF;zbvVo@wH!|{=uA>JbOpc%u$7D+SEOlx1YE{8RU9VhxcML!7@Z-%|uoE|U>%X;Sm z)m1!kF7>Epv)utNWuY+*PG0E&$AafcxyV$weHkPkzM`alQs64nf+V40$|H7 zf#t)|YQZ^;wFY^oP>rXS#e$ib_{T81C>(pXdI2eF#~6>y$sZTrQ5ssG0=9SivE4=>+2IYIyq{64y~z zlMd_^DD)H2lh&|Ieg2vb@uQ~o9=jr~x=84nYxPYeuK**b7aXYe1;`4Jigq1l2gkS= zJz9bS9w)&5DbhFh4L6jqq6EpM|3Vizn;nUE63d|u)7xZ$+US@GI5yK@$DY2<7`BA6 zR4n?V^3405L?SUL_3->xDO;G`}aC;@PK} zRFqsSDwL_F2~tbmps)3z#=BVhH2jdq*sD29h5$52#+@T929<|DzqPFcapE~`K3eWI z&+>~1TMrBU?phDqs+?^cM@RN85A&M!*K`yns;A`kmT2%Re$vHDu=OX)Vz6s6{Sx$? zbuw^2ZQs_o)9Yb?|HJhlwS1hXSYHB`43f$Zq_1!JxLfb4_G zk9IaPZT8ribhb6RW*Kl>^@T&sP!f^oeWM8}JN4_EAIh5lizZ)>t2q2F%{1N5sLqEh zjrmTmLx;zC>(X3t7mBH!L&_F`qZRU}Y+msWvtv*>}NPIx5xtK~I`Qj|&l!D9x1IlqfvNbl|i0 z%C{v8tq0X#f}PxT!!S2xy-xz0UTRsa(-oE;o(c5(Rmr>ul6;M_Of$6LEX8#VOiIQY zYj!;^A)Y%pRkV86g~s7Z_F)<62Q~1wgR4hofgOhygkO*xxCtu$y(G&($Rs!#Gv~}g zQzB03M1JTM++Pgz4F#vfd!`_FP|BI+GYq4z2Va06-&dBY1h1)@aPW%v7f0@Kc9WqE zKvWE~Xe9($IdFGF(25+3>Uo_>AAtk$~jg_ra=c2%1HUwLMrvLu_n@cBP-W3ml;V?*rKC5btq9{UuIyy>u#;Mc+B_; zy_wlpeZZUXkV}zYJdT?FxoYu(4N!mm?awHXuq zw(1jDsfXsjehA)TAzmDY$(>HOYq`g^>Rv&g-q*~={Rd!RhD$FAmS(+Gowhy-Tk8Cd0C2pzFy5#hUj)s96OrWN;BnP zR)Wq0qpZ#Iku?czz0IyuJ*yzSTW1K#IFCkQMpVRo9y}YB&|zKwD+`5sk7UgR*TW{r z#-8O>^xN=X^a65EUjE88qDP561+QN3QP17K3ryvaLwbb$^SODad41JoF}#xB2dvI4Un(F81Ot*mXMVf`S z%TO%3>CE8E%9Cz6oMim|2TQgb$NzIt29jQ2mN6R`cvoe$5}QU-$k?2PoKnbfd z1fzJ#5|?>&pL6^-RffoATVN5K0d{>-OaJsJY$FheS0tKIq?lnBx>YmxR{PipD{yO- zgA4O`pUuhlFp1fop53TR&?L$1L}u@V-Opw~y+B z*kSpk$DZFgBf0$S+v^q*%0NOz(D8o>GnA(PbWBW3wkv%$!V#sEt+x20X5;BVQ!IcT z+*M4PyuFh(tP#1511vmgui3GU^>P@&E7WG7^$`nFtFk z#)>}tzp68GHt-AFVydS#i7if_zF3VfQ*yb!h`7;U(HXR%Exy&pQX~Rc&W1?lv#Y7= zkTZ^pYk)3j9NYGVwOPjMY}Qn!b$sd#e^&&+SYDK#@Qu&S8^VPDNxrP0eScNg)8~W> zGcy6ux3-Y>clt_w07$6*MC~zD@x$k`R6+32N>fnp9_G(4hS4GcV`za@A{Bw#$)h0J z)SD%pUQ2$xk{KV`7k`H&SawN$iYS9*C8S)+QU8FCYVvK$#|3^WL$A`rI{Dh>|mFOO#roem1egZJ{^Q z;ePsdmr|}$o`Me_kD^K`Bs!6LyN=05$6Vi6XH&S~XRE4@DWgTa6y;^hQP_!*(dE}d zMUY|NIlrX%dT+YsNASQoL!;aB*Sz>}*rjZ0$xJ-@*o39|s=WX33huwWB44m8$V1R_ z%%tFl9MRmG%TEZdut4<}{9GdSFxhIi&ehlFtQBrx5Kl{ER=~VOYOIz@6(Qt}+V$JO zISC6j6@JImH7l7!8Q4$FV^j(7OGrlO%3GrP%2bHkyzrg|AK*wSr8|)=R@}IT(Q;^@ zltGX^VJxD`e{STgyU*>cOI0t`QbV5#cPZ+BJ9>WF$kWN5@6L5$I#uO48==1AN-C+E z(M&{wKDDq`R9}u~#wtn&qEPVGcI9{0SH zDB8~^2w{q7RYXUc&QZ5JBeZR1Drxi@d{vIdQPP?tY8>ML3_Zh3I7@mcUHYc=zND-?1mR>A$_%Z?iR3Fm z-*uj3zA}y3Y*`I1e%bM=TFKOy#yaY~YXW;1Pus&qzAx2{F>UtxjAMFIWFWXjZ;pl+ zo~s}Cq#LkC2$pZiLD7p3=&SVsc(<=^_zUd6fCk}TpaFycjoF{hl>}!+W@XBes+x9;Lgo-3xVQ*yNGNOUw03uBXiV^57T?0F#m7>i_{G;-$S(!_ zet2FMUyp)HizqEc1Il^~9lqM#o^#iV__NJ|=2uff2BNeERe@ycs2EmPW2TnYa&JnD z*@x`4K7>uRwu-~|sf8Gmi?>GeY6v}&xbLaPbE}uADv@G~t&x-$hgf0U5fMkFf_#;H zsiQR%*WuJulQj64s%Fpi)pg$MA_l-c4vl>Sd!GuIK2wr_+HIQ(T#GiDOYQz1S^VF@ zjA5UbzFM7^Wy~}=U%09UV}9(jF2WiU!>nwV)C~jCBJ@>#xS?2${xyAF)i@O!iXkVj zlSh6)J(P0an{MEz)*07`(sY@mSSI5UIh-s)Tz_1E)|wqW{mM70JYDG2(!&B&1NP>U zcvI`_%nafYQ{iYheKUv9iw4fv`d>Dc(|);EkHp}44Z|%}(0^fP1m?J&YL`-9j>IZz z2+pjy1sPfFN-7eZQWF?C8#}Hb`~KM1Bt}r&?c$hCK^BX(!Lhu5)8)jC{6#U$dq4l$ z`#9l~+R7{6m`5rjO;v~RjjI37H;y2wC-33YJyhro(na^Mn)wqoMAO$)*D*?kD++{M zqE-m%O5zk7d1`;6p;{VBr9m_qs(k^8Xq)#LvAVq!$+i(8`mE&)nKe_X1sucIj9SZG za>GOoXN!IFW#_UhPKsB!ihOfwiRh@*Dhp?KKlQr8^eJ)Ah=vZ`L#XkHA&>)R39$9~ zOT@k`HN#4K)=!km?^)IK^Cv6MJU0zyE)3^hX{~mwI321f$h^(hOnV5h;-NUjMwcAH ziNV`LgOUqNn#aG}q?0Ba<{RdV+e#bTDjGgj$>>ndtMeq;+C7D=lj4ZOjYF*R7pSq} zJOZI)Oac!!op+~Ve1tf?Sj*!d$SOM}=AXN;KU`fLvB)0&n{wzvC)86pPl(4uRCOHXt9=x=Y7R5E zXH=4H$ux^*zdB{!EHh-^B8?WVe0OeOPk7hWr@=Xs@>XuF!GEp$*Tt;u;Wl#t*Hw^C z>0!H1?FB2s>6K1pJuUqoo9@Fy$G6mgy~2y-xbSohT&E4JQ+Ht=O7p|y3w>wM6JMCz64R=yxPH4IO6`Lbb zN_zEM=Wg4#^sIB+E1X=>0JGE&am|x4*EQ)v;4jBAznf<7Z?>7#w%A?d zqp{gd_J43up7&?PO5}81-}uy9LsS^q&DU!qlgdQ;wwsCj%p$A2AzL3=6W6&HFdy!1 z`4=ev_ZkfF@YmA+6A{Mmv3Knt_KuWX`eStnCLlcqmd@<1;ywxHR{7sYU4A#j+nM(O z{$w=J_ zJ#V@9$mAK+ft3CG2Eg+OV%bNfeB2!Bqlk5hL+p1I?V64VA;iNJ43Yhsk76lTyqrSs}B*M~A5RCmfQ$Uy(e)14xxD4^dq*UDA=mQ*6P zTe#D$&!>B9hE1a}@xF7au*0c*1l%R)O>t+b3vZOH?dWw+k zGV#9_FbPpa*#=lcx63tS(#nV_+ApyTEV9dxEs6q$7iClOAG1F$J68I3OTG)NlY}1P zSPn-WJ=rVzq9{iY59@WzV@B|AN^#1(b3dLik1I}C9aiT4BH|L}lK-$AL51JRLEpv@ z2MeT;pb=xPGe)#At}DRF?9%=)YTBEc=kw~3W=h$a1fY!vx2cmc)aQxKp~_^ zao7pTIvMsdBNsq5vlWuYb9e>9tJIkn!l}{s$X)Utkh61ysy0ISM4}+5iHp-iEp_`@}{_s%I*ZjRlmoLhQ+@%4QTdre;WJIwmN=LYa=oiV!*7l_ev* zy4BhbKADYL>0@Zs2UdaCNkQ6hj=VDxPYOfVqSJtyzjq`z9Hu+LK8sTj`^@DrqZso_ zCJ11gnf{UqfwKGW6(MG~oaozcxzdsRy}Qd8ihN4U*=6zROl(cDBq>*HKRad8VApZ1`cx~81zpCZsMq~lqain>#x!rMn5iV3>sF1MT}mAs8akDgW>%Eo zxhEa@ms8Xp->8xOn52Ds`F_QNKPQ&NKk7%@PiLy0fSftjaq)rkimw;Lo}jXT!}wOt zrsHLo20Y>?E|V*`_0GN`+qhf# zM%~e@vo&dQtf~D0M?-VH)P&;fHw<6X*Ne1VVy#0K7krpH(;r_fyuloo&8S{vY-`c-Z zb5FV|31uv)thE)iyf18YPP*P}7$Ws4UuH!6{HhV*S6sbAkF3OR`~;gidp(!2_2VjA z3}+hss>LcuV+Arg!XTH=W(k;nEab&wL(fezk-vjJ;`6MJQ8dB%EJ>( zJ@82WjfH12>e(K1g0$JNoy5X%bT%GUtAv9-BXoDV;$1x1R|$d*lS(fLPTthUyPMk` z3zmu0IpkSBM09XGQym(*&y>*mns$yEW4G&i3A!;!RB|2^=ESs6Q0{$61{5qKy_5UUGSIPKg z)s1fv0+sV`dFb%kY)HnX>uP+Eb+K@2z|r!I5ZIKYVK#R3*xDqeINRwL1Ra8v&UvvfBKLiv+86A`m zE=!m!-Hti+)qBQshKRhJoo5^6t8;oM-t#E!8zI{Kbz;ck3|(()`#0-?fr#5y5Ld?` zDxPt3!Lh<(9QkMTEzU|ZPPdih^8-XbXp#f_Hn7j!dm=}evG!s^t7H2WaV6KCu@R?f zfC9sb{qH`VYX%aQ4~LXOY`DZJyJQF{E2I`|i>t@Gmn61Y5kRs0PtihiV$Q)EdYw{- z_>twm%}rZ2Enw*{zw^Ab%nM>$uLf9ly@ba9mktP z9GM=LsOtBzyQU?MVu+2X1xo^V`a;lmRNBrGcl}pBhd_Lev6nZ5kfytk9ecl(fs;6U zk4W4wX2ZS(9TX!#xR%PoR^Ze=2rm2ZvP=WuV@uZc9|DAx0(R5X%^RgA<#9*%#0JJJ z@8uxUzixeu`-DVD=yFdXy@x=WQXgwxn}1Yg)4j}5t_4tf#Eu3Ssz7yxO+a#p?qC|e z?FNOvrG5yi?AFl$P;b~5THp2c2H3`rzUQv7Ms4?9>=m9Ef@w9 zV^=U1{g4TVrygHuTuI1L*2E{PWI2|9&u@d`?fidAXbAr&p#j)`c;BWR4b30*`2QC> zrT!d+o$BBlxyMeSNEa33Z=~B3N_E=Btdln1G6xA7PmvzI0%(8WAFNpj4r%La zDK|`VNY?WCdR1)!rrCe)PTxGHu58(|o;dyH42p1s*-Ahe%a*30r~ne{JddBb9?r1W>+d7bked)XaIPtYRT z@Zkj+6Tj{$yFxkxb$fZcvZGe@dc@xhi{qn2f)~$wi%MZM3*{jBw&SpcDYHW}&0eNe zH0SBMcZK=t5PLDNU;Xslc;AX9l2cwaE!#)OR~_t{+fjzU`@eOKXzI2sfBP}O8KDFD zqP+?Z6h$uC`4(1-=zv zqeZ!k{vVlCH|xA>Y4>eH?++ACdp`x-8|3=Wk7B_8P3QRMmuSMKQ;D&hRzTS`;2n!F zcg|K@ZVtFACZpX+BpA;X*!ZEnzgdMAsoEf2@m|3=wT?}ts)M$@%I~fRzPH0ULQZ)8 zwg!P&GOofmCT?Vx3msK|$13oD1t=G_$CjIfu`ITXtAi%Dw3q<3soZA6D)M~o!jSQ;h`_q6u9cwZpa?1eDZn{J<)Gq$y=OxeVQP8Ay5$v z?IQPd8oy1$LFGpph1y%iQu@E|ei!^jPT1`_jM=Hk$9fRAT9D?}xB94-p8>)OPQzTyw`b1q6W4P&eOLiY z-{&epcS$5+l=@K>oU8ATR=LtUR!n$p!F+RTe|_4#$AoPayq3I6 z46_+LrE??_Idenk`P@^0Ogd#*XjQ7Ri(}=4sjO!b5{#9IuvqDx`Hf6#haRigZr z$&GUahYa}a%FH9eMjS_G+jYapD1w=jGB7kel+52x7gw^}PqU5`@tW1q{QQ@Ojxmod zT{srC_ERE((qQ(Ov_rm9i_I`sbKScsd307#=@IVZ^fN`Zov{Y%U2-K9;z6lz)GxyD&Jq6+!nUfvX%w2_eeVsNnbXW; zGVWnpx#W}_r46Ytr7M^}gT~whg!xQ&rmyEu+MIhCN)T*YrcWe5y5yw3>!uhR;tyIx zxr^ij{iN1}c#T8)J%h>NyLB@1U$b_%6##Xr-G|f7MDZN(L3#5Eysk)%BIgfHnfPq9 zY;1(My|bt8b2sDP;?n|@7lYyhL!Gpr*+KV>L=_45ascfLMB>E{Us7?7m&p(K!U4Ud zOx?53{5@oGfXsPSwC>e=m;SNVNfcThoaBj*z{UY6yZ9G~ci}Yz9e2F$y;Xp{yuamW zjARm6#`XMpljt4m+Dx^MvmmRmk^WPPMmy#r6gaHR?o*>k)@kczs{snp)%fJFutw4` zoonog;n>esw|~Mb9YNK5y+gy02qizvF*fN+*(80DQj)3c`(o^~7n?)pCKhFEb5XbA-cR_Dv|GN}kE1iTDH~boVz32T06dO=?885eHg#^;gyFr6Go64aH11 zWFKLE=}9vtZ8d_4L~05ZrJJ>V$ug|#$@C@W0Yv!vX^*2;RkuUFPAw5peTR(8y%@60zxKruJ1RU+MK;euAN$PpS=?@*KF3@ zl|p_fnQEZ1pN0V_7qgULHgdNBiOhJV;&mJ~vw& zKbO=NyOIa5rQn8I!O}gU|9BUdz`QF{zMi|Lv-m!SlFL}ESYRqg3P;1qQQxsQb6Bc|T8yk`HG>+c?0le4t_{`AC;r(|1d z(~h$05rG0Skfh!jS!TDxp&zGe&JAX*AF=g)6s7rk;mlR)Y0-^CbGG?!n~o0Q$}A0~ z6c@)eTEjyLb2avH|iS7q{~WJXBTN{nQ7IXwn}(_`->{qHX9H8i8tfpiof5icbAPe zlTZDJvTe$)_Afr+zvfe180TqnJ+D9)TxYd&oGam2a7a<5e@tk(VEu1J6pc+aD>ZA* z{``4JcyJ@teU>K1y)<5RUiPC<4EbHWwy4yafroW_dx{nG`As}rvfmK2B+kO3y zU&U|B)uLNwcfjr8(;Bj`>!u{lM5b?*dj#eu%~{CN`A@D1l%#$T*Q42!!vh-XHOj$1 z?L~%WKfdkzG<(7LK!U2zAhC;2kMIp?7m6_xVDe_RXpG=gcxo%-xSy=ZEa&Kf+~+oQ zEt9Oe0~W`=`+MM0*6*ORc??ZZdULnD@?KP`cgu7J_f(La8=X^p`DSYRF8d()N;4{6Y^jvo|FYrNq=EjzQQu zmtUEf#09M#>VZ}gPv^9EU9_y}94o&MSrZ0Y$L=1 zAtJ~{oo3Z`4Ejalx$jq0FX8UiP^a;J*TOk;=(2Q=8J2wW^F<23t99Iw4GDxEhb@){ zSfIl2B0rf+d`+7~aOQhh{8&(@#JXP1wRG31DLYjjq=(AM1oA#ZNPVoTg^0I9t;}KU z8l|Z|A(Mj?I6dp47jV^&@DCS2S9qVVZcTD?r6doY_I&~_PsX3HW~&|@9a0QHwb1b> zo>$VNct+k-hNBr>b2^N>JW{;0Cc2_&Wh&eC0Cz;8#oTQigIZ4$hgQMYMj3`Jc(Bm$ zNVNua_ZL4j`h5<5UYDX*Evn?E%xYN@P)uwLjsnbeY0;>&nQ)9(6OH3?Eq$Q#NLo;w zcR)dA+1iPX=y@GCMo2J<-o%kVPCXdXb1Q#pFawCL3*4G4bDp~K7nSv0I4XH`X3QIY?r__aAo2M0c)PBDnOr5xHPm>;>Ou2=PyX!jp8ET4>MZ<}>yy!0594lyKbvtK&!XQ>*D_t_n(8EHHfs&PLOt3?Ivv z(1l2%Dat(*}L$!OAkRD)aWL#c#tL$%PFJKSlvcEp4sB@`>DBw66~*C-6u&1AFxne~|H zu3K-jcQ?E{DDLmy!0$e}0`03Tv+6ve(l1EM9#Q;avysA^7m2I8EK+X3cO=Y~dvZ%e zihdwthEt-=2oQ}a?ePz+us8!%dLzXbwT+GrhZ0=4C;dzQNLZP6|6<)S_Nz4a=WxOE zsG2tc%fnRQzPh`II@q;0X*YWF&wn>10VG#9goM8Yc^pbopGOUNZTe&{neVgz7@HK) zKHi9&hS$~B*sg;3H-D7H^Tc{zl}Zx!(28^434D8=rdu8kK6%8Yc4jw zb=F2JHF*H8Z65OLF=_OZ*j`Fseo}Iwk^yI|&jh!dGQy6=KdR3yJj1Ch37?5mpHtSq zgndkizKD*vezT#<;VMWaw3$gW-Oga~F?Q23!Tr2Ll&MCH6pq3$+mqc?=Xyip|fo zX1vM`Oe9hliN_tSSU@(Ui_9yMhp0fZvTwyYowc<0W+n2y0U+q z_pcW{4z~w-FS14KGr&}j0Xp=Q-tj9>-FG;iYu%L#v91{=va{9l@6V|U@u2_5^jNLr zeZQpvb~MY=dS$rl0meV_w$31R7ep=0hAJ^8OkHV5qbFpJ&|Td#k!(vWUqi7fwI~@{ z24A4%O6G%@v`sy^JUq1U!=W}%=()qMu9}1`3re07_x(e38WYc$Spv&5OQp-@J!{BS zR%%*aQj36~8U~6Rv)wYgIB(_Pp;8eIAZzkxn#~Z}nk%-O+w!QYI~QaJ5_t9h@pZY! zDC8e{>SOZ~tmGApHXI^`U-^+Q;$aT29@Kbp4cOH8@T27}?XIYnxTUxuYp<+W_ zQv+s5M*i_9-<|nzTOuysa(asY+DQ4{ z3LraqrQo+FbAF<8*mQF(5PRVZ>-Lp$^B(d`PC3OBNJmzxxdk(RL#<)F&-}8Dgq3I$ zh{UX|_f|f^9CUuvTB^uT608zp={ccI&hpv`O4n=o@}8gq_g0%13#=~}>qM;GB)I)XpLFXI?G zI6>}x9q^3>K_sQqG^*74o6Bk7w?T&SsHGJ7jr0WU)ng(j^gelf)F#s%1VF`TBD|8$T1zY zcJ#&`o`zG9LTbDb-J|%!$BeWrz}xaq$Dxe%8FJ#@*K>eI8q_`bCdftUch#W=XEnw- zGqB3-X$_;>R759-if-C6kHczX`{$(RFm!9Mu9nN?+Hc&IB5}blNU5S$h|JwXPGPE# zveCn~h-XVzWbM4CUqwJE-|~a4$5AknG+HWr#R28%9N!)$;V(ig{V%sfkK1a9lVA5r zsrtZ3cU%`vn7iM36s$fz|1p{m#S*h7NsMhGI34|#XBChm;#q+H2aN(Gd2Gp5vPcit zoBh~=fzY1@BSwI>jB*a2kMR?0E6zP>!Nna@L6KPvmZBrma0yHACoE1fmJju*x2{D> zZ~Vn}Mq2!0UzAD^h=J1V0iQjHKda8_{BdWUWu!`-xdI^Elcw^u?9!wjjjf_u;-)t$ z8{C-{{IOU&vj$Q>lDQt|%ywxitCikNM*1FR2ugw3gg5R`oe$muuQ54$=7Yec9*F_( zWO`;JdgNeZq?$Y`{o%yCTt%|a&*ci< zFYk!VCn$$A!`2Nip#1p^u4QK4REoFovCQG@=%W4K(~``aCVqSm$$Bh`sCC67e`7qGAHDNOg=0OV6*a`gqk*Jc@IcN;1IuEk%~2 znzzR9H$Z#8?|Zt;OaFQDxP*V<1V*B#-pXr2E>@(Z(EAO^76FXQ84OzFr= zS+=W4A*H+W;}3zict%=Asvzn#MLuU$5$F@0rzd^=W+KTj zRDU1s;sGwy!Y`jq1Tmc#FgeZ1(RcB~`}^%M@KLu;m(WGq{f46Jpi*+O?n8obMeM08 zm%EXW>@IHoaci!8p24WXlQ@#8e1691&MTkn@HaZDC@r)@e2gQb@S$V>G;=INJa1kB zMI0d5Bca}Mk-fYsUgO6Bo?5k^PSNXnztk-}A>5pHuW1FZn60$_5WUcm`PTsjh?Ko8 z8LhqO7xGE=6D{JjXMh^weazL}aO=G&R<#GPcO(ZfS4@cw=2Cf$mq=nHW#GFA^8vP8 z59@A)pZf7)s+Cldn&uNxS>eGY*xwkF`%x&669_YuKYEB{GpR-awmn`ZKrE20`ryUu z)^$I)epu#$^HJh`Q;6GKXQg1kBzkn(AVgQ5kbXLF0F&)Z-$U7fvH6Lx?-I1)e0aD{ zSPTTQEvwgO0qU}p1@G9OJKvZq{W65}PA%KB`s!KV8LZTz}c&k|7Ah=S1XI~62hf22CA!LijpFTo*eX|#H z_SslHt)>f6GQpRXp?$qb`Rni_AotvKE-*MH)5iD-x$0{KJ4i2GRPwOgZ{@89H<^7* z*8K75lV~CRG`#4(@ze2WA9EiAYl)%B$6^?pL)f@t>Rac3MlI99TVW|%X@k3D=R#Yy zatsH{#heDLL_W1nkDw;aI$d z=;|2T>8g=k-Ck=9-E3m@Dj>#+Ov<>QZ*8z!@` z(KZ-H5Fw?K5)K&Z#|tSsZ?j;eQeEhlyP-b`<_wHQ6?Tux3?pbpvo5mZj7NUHCYDmY z`00{$Kd~uuBcO7Mj7%7AzohO}8FO;nf=>I@dH(48lUlU#%#hQ(b?J|>fN{vzV;+R> zfs&UC-8O9H`|}7{b+nz zB>ghy2YFP3hO@slm;zVkt99P^W3)LC6a78|{AAvW$!Nb%=SRl5LW=caI@@g`jJfpC zNMCjhu-@_B8Ho__x7c4VOKapzMSH5+IIeTi>&*7sLAaU!$jR>ds%yU6mOAw%<#5B# zZ~1m?EcxcQM_q@h#kk+i`*%#sVRb_>#>U<_L%ZYN?fmD}qeDZJDi&ttO9zav&i6$) zaRsx>D=Y5q#hh4#oQd zs!1=M95$5?j(f%FwjE%3zX7iZxrN1~FVq}jkr=4=kcE%GGr1IssA=viK<-M1n3jYs@ z%P0JljyigU?N9ugR_+Q9Az7OWan^z1O3*FW52Sv`vyb~`@{DLAlg39>5wXGetAaw6 z`%1qZ@QWbfIEEFLi{D4zvk)Q)LJ=+?f>wgzWm$%@xhQ}+=%^2jd z#O5~N?o@me_GAu@?KX=0oqVaH(K)j(WY3rHoigv(ugN7r-Hm32W0YG;j&{@CX$!a5 z@G6zLl?}W-fboaaRrt*C3*~bZ787m0+wT|-47-KhAw18Re*=r}_6Y9C7f+yfO#BZW z7>wdoK|Vj5Z8qio!QO4cAbP?4fN|%GYe*p+I^|A(NHfv@y^NQH2sbpG;1j@5_qeswnH8kAhd+(N;3 zo=h}LROMIm8gAvgLJ!~1``8q{=86?4A(pm5$%yhBZITL>*Tt6!jZ$)dD(J9x)y-i8 z2HjE{KWgfZRzPlPO5I$J0(KtiNHdQp5dhZ7&%c85wJaV=tWmCiN?+HI=1jKWlf5Ea zyXIcX+8JKmC!y{Y9dy?^sN$iRO^_uDjWZj=ZgVA6m$(hk+C2WWY0dp{xGX6BIwwop_PoyV97hPqrOrzu65`9N<1MYT)VB7 zk)Kat%}7w$i5C39n7UQ6s>Gg(;h^+h!AGm+{^4}h{FWi$K#$KnC3dqE=<$les2V*} z9;MgjhYT)8TG9TRux}gh=LdpYt5^p_+DoOTT`y?Z=u7>cnQD+-%dXZF2+{V`b(9=q z4e}!P1m{p?Q?X7+8#M$*;um!wYOKjA|ID!=QPsbx`2Ct=<0lYK#;QohFI>B(@GqW_ zMOmwvbrSu8yaBSZ=xAo?ZVuTdq5Rl>9o;Qp|E{@A(}q2m2mbXUmI)fZlGmFq+frp)Q&sRRGUji;T2HJk6R3T<;*TSN~u8L4F~R6q)g z6$IIzG-h))uVU8KYULt2Peo3&Jt z0=BAkq@W7{dl^UR${ zoKuY0v^1?ZVLbwROKe%zq|dqdn!ss^B*v`I8*!_l&#YBmJ%3=s%UyGB0Qz9e@#|^H zR{mqzCU#m)9ckw0u)pzK6W6`;B~3R4?^lU4+2UG3I(xIQhQ?0q?!s&35D9lhjz4|i z9Y1nE$W^Q1SsYMY!INgRD9A^ZTFm&*r8?st|U zk_XSR3ZHg2quw2X#iSVLq?|E%3w-Qn7)x1Nq0g5l}uKbD>T2Qq?sArCsp5INT;{RwnEC5lwPP7u8!uK1_Xo8E1Ed6mX#=H!$T^@A@D2`CS@VZeBS(*K@R3Kyx0N>_ z^L~6+6f^tp!PG5)@qO*OVlAGV1`PKF%T#DZ-d@JurG5zuv+ZwM3jm=`elvF71Vl8Q z^8(L!>l+(C+?}i3(Rb*AkxO8uHN-0XxADKD^{~*~a8{j|7;eVi?#4|U&w-0kqXLPGf-7kJ{;v6`VVHXKM9NRQT6<}4x@gB~ zZ#QTsfmfV&p&m>O=15-f6&`XJd=tq;UH-Ltm^7@nR`1_O2Q)Ei9bk3!+hD`00Mx9F di`Ks1(XvSqKG*x2=yHF3a?;9Dl@caF{{tJfAbtP< diff --git "a/Article/PythonBasis/python14/\350\215\211\346\240\271\345\255\246Python\357\274\210\345\215\201\345\233\233\357\274\211 \344\270\200\346\255\245\344\270\200\346\255\245\344\272\206\350\247\243\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217.png" "b/Article/PythonBasis/python14/\350\215\211\346\240\271\345\255\246Python\357\274\210\345\215\201\345\233\233\357\274\211 \344\270\200\346\255\245\344\270\200\346\255\245\344\272\206\350\247\243\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217.png" deleted file mode 100644 index a8ce2a77fdbb558589855107a699f448763709b2..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 20029 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 KJO9euJ^mj}PMLH7 diff --git a/Article/PythonBasis/python15/1.md b/Article/PythonBasis/python15/1.md deleted file mode 100644 index 8809f64f..00000000 --- a/Article/PythonBasis/python15/1.md +++ /dev/null @@ -1,150 +0,0 @@ -网络上介绍 Python 闭包的文章已经很多了，本文将通过解决一个需求问题来了解闭包。 - - -这个需求是这样的，我们需要一直记录自己的学习时间，以分钟为单位。就好比我学习了 2 分钟，就返回 2 ，然后隔了一阵子，我学习了 10 分钟，那么就返回 12 ，像这样把学习时间一直累加下去。 - - -面对这个需求，我们一般都会创建一个全局变量来记录时间，然后用一个方法来新增每次的学习时间，通常都会写成下面这个形式： - -```Python -time = 0 - -def insert_time(min): - time = time + min - return time - -print(insert_time(2)) -print(insert_time(10)) -``` - -认真想一下，会不会有什么问题呢？ - -其实，这个在 Python 里面是会报错的。会报如下错误： - -``` -UnboundLocalError: local variable 'time' referenced before assignment -``` - -那是因为，在 Python 中，如果一个函数使用了和全局变量相同的名字且改变了该变量的值，那么该变量就会变成局部变量，那么就会造成在函数中我们没有进行定义就引用了，所以会报该错误。 - -如果确实要引用全局变量，并在函数中对它进行修改，该怎么做呢？ - -我们可以使用 `global` 关键字,具体修改如下： - -```Python -time = 0 - - -def insert_time(min): - global time - time = time + min - return time - -print(insert_time(2)) -print(insert_time(10)) -``` - -输出结果如下： - -``` -2 -12 -``` - -可是啊，这里使用了全局变量，我们在开发中能尽量避免使用全局变量的就尽量避免使用。因为不同模块，不同函数都可以自由的访问全局变量，可能会造成全局变量的不可预知性。比如程序员甲修改了全局变量 `time` 的值，然后程序员乙同时也对 `time` 进行了修改，如果其中有错误，这种错误是很难发现和更正的。 - - -全局变量降低了函数或模块之间的通用性，不同的函数或模块都要依赖于全局变量。同样，全局变量降低了代码的可读性，阅读者可能并不知道调用的某个变量是全局变量。 - -那有没有更好的方法呢？ - -这时候我们使用闭包来解决一下，先直接看代码： - -```python -time = 0 - - -def study_time(time): - def insert_time(min): - nonlocal time - time = time + min - return time - - return insert_time - - -f = study_time(time) -print(f(2)) -print(time) -print(f(10)) -print(time) -``` - -输出结果如下: - -``` -2 -0 -12 -0 -``` - -这里最直接的表现就是全局变量 `time` 至此至终都没有修改过,这里还是用了 `nonlocal` 关键字,表示在函数或其他作用域中使用外层(非全局)变量。那么上面那段代码具体的运行流程是怎样的。我们可以看下下图： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-Python%20%E9%97%AD%E5%8C%85%E8%A7%A3%E5%86%B3.png) - - -这种内部函数的局部作用域中可以访问外部函数局部作用域中变量的行为，我们称为： 闭包。更加直接的表达方式就是，当某个函数被当成对象返回时，夹带了外部变量，就形成了一个闭包。k - - -闭包避免了使用全局变量，此外，闭包允许将函数与其所操作的某些数据（环境）关连起来。而且使用闭包，可以使代码变得更加的优雅。而且下一篇讲到的装饰器，也是基于闭包实现的。 - - -到这里，就会有一个问题了，你说它是闭包就是闭包了？有没有什么办法来验证一下这个函数就是闭包呢？ - - -有的，所有函数都有一个 ` __closure__` 属性，如果函数是闭包的话，那么它返回的是一个由 cell 组成的元组对象。cell 对象的 cell_contents 属性就是存储在闭包中的变量。 - -我们打印出来体验一下： - -```Python -time = 0 - - -def study_time(time): - def insert_time(min): - nonlocal time - time = time + min - return time - - return insert_time - - -f = study_time(time) -print(f.__closure__) -print(f(2)) -print(time) -print(f.__closure__[0].cell_contents) -print(f(10)) -print(time) -print(f.__closure__[0].cell_contents) -``` - -打印的结果为： - -``` -(,) -2 -0 -2 -12 -0 -12 -``` - -从打印结果可见，传进来的值一直存储在闭包的 cell_contents 中,因此，这也就是闭包的最大特点，可以将父函数的变量与其内部定义的函数绑定。就算生成闭包的父函数已经释放了，闭包仍然存在。 - -闭包的过程其实好比类（父函数）生成实例（闭包），不同的是父函数只在调用时执行，执行完毕后其环境就会释放，而类则在文件执行时创建，一般程序执行完毕后作用域才释放，因此对一些需要重用的功能且不足以定义为类的行为，使用闭包会比使用类占用更少的资源，且更轻巧灵活。 - - - diff --git a/Article/PythonBasis/python16/1.md b/Article/PythonBasis/python16/1.md deleted file mode 100644 index 8316e9d6..00000000 --- a/Article/PythonBasis/python16/1.md +++ /dev/null @@ -1,213 +0,0 @@ -上一篇文章将通过解决一个需求问题来了解了闭包，本文也将一样，通过慢慢演变一个需求，一步一步来了解 Python 装饰器。 - - -首先有这么一个输出员工打卡信息的函数： - -```Python -def punch(): - print('昵称：两点水 部门：做鸭事业部 上班打卡成功') - - -punch() -``` - -输出的结果如下： - -``` -昵称：两点水 部门：做鸭事业部 上班打卡成功 -``` - -然后，产品反馈，不行啊，怎么上班打卡没有具体的日期，加上打卡的具体日期吧，这应该很简单，分分钟解决啦。好吧，那就直接添加打印日期的代码吧，如下： - -```Python -import time - - -def punch(): - print(time.strftime('%Y-%m-%d', time.localtime(time.time()))) - print('昵称：两点水 部门：做鸭事业部 上班打卡成功') - - -punch() -``` - -输出结果如下： - -``` -2018-01-09 -昵称：两点水 部门：做鸭事业部 上班打卡成功 -``` - -这样改是可以，可是这样改是改变了函数的功能结构的，本身这个函数定义的时候就是打印某个员工的信息和提示打卡成功，现在增加打印日期的代码，可能会造成很多代码重复的问题。比如，还有一个地方只需要打印员工信息和打卡成功就行了，不需要日期，那么你又要重写一个函数吗？而且打印当前日期的这个功能方法是经常使用的，是可以作为公共函数给各个模块方法调用的。当然，这都是作为一个整体项目来考虑的。 - -既然是这样，我们可以使用函数式编程来修改这部分的代码。因为通过之前的学习，我们知道 Python 函数有两个特点，函数也是一个对象，而且函数里可以嵌套函数，那么修改一下代码变成下面这个样子： - -```Python -import time - - -def punch(): - print('昵称：两点水 部门：做鸭事业部 上班打卡成功') - - -def add_time(func): - print(time.strftime('%Y-%m-%d', time.localtime(time.time()))) - func() - - -add_time(punch) -``` - -输出结果： - -``` -2018-01-09 -昵称：两点水 部门：做鸭事业部 上班打卡成功 -``` - - -这样是不是发现，这样子就没有改动 `punch` 方法，而且任何需要用到打印当前日期的函数都可以把函数传进 `add_time` 就可以了，就比如这样： - -```Python -import time - - -def punch(): - print('昵称：两点水 部门：做鸭事业部 上班打卡成功') - - -def add_time(func): - print(time.strftime('%Y-%m-%d', time.localtime(time.time()))) - func() - - -def holiday(): - print('天气太冷，今天放假') - - -add_time(punch) -add_time(holiday) - -``` - -打印结果： - -``` -2018-01-09 -昵称：两点水 部门：做鸭事业部 上班打卡成功 -2018-01-09 -天气太冷，今天放假 -``` - -使用函数编程是不是很方便，但是，我们每次调用的时候，我们都不得不把原来的函数作为参数传递进去，还能不能有更好的实现方式呢？有的，就是本文要介绍的装饰器，因为装饰器的写法其实跟闭包是差不多的，不过没有了自由变量，那么这里直接给出上面那段代码的装饰器写法，来对比一下，装饰器的写法和函数式编程有啥不同。 - -```Python -import time - - -def decorator(func): - def punch(): - print(time.strftime('%Y-%m-%d', time.localtime(time.time()))) - func() - - return punch - - -def punch(): - print('昵称：两点水 部门：做鸭事业部 上班打卡成功') - - -f = decorator(punch) -f() -``` - -输出的结果： - -``` -2018-01-09 -昵称：两点水 部门：做鸭事业部 上班打卡成功 -``` - -通过代码，能知道装饰器函数一般做这三件事： - -1. 接收一个函数作为参数 -2. 嵌套一个包装函数, 包装函数会接收原函数的相同参数，并执行原函数，且还会执行附加功能 -3. 返回嵌套函数 - - -可是，认真一看这代码，这装饰器的写法怎么比函数式编程还麻烦啊。而且看起来比较复杂，甚至有点多此一举的感觉。 - -那是因为我们还没有用到装饰器的 “语法糖” ，我们看上面的代码可以知道， Python 在引入装饰器 （Decorator） 的时候，没有引入任何新的语法特性，都是基于函数的语法特性。这也就说明了装饰器不是 Python 特有的，而是每个语言通用的一种编程思想。只不过 Python 设计出了 `@` 语法糖，让 定义装饰器，把装饰器调用原函数再把结果赋值为原函数的对象名的过程变得更加简单，方便，易操作，所以 Python 装饰器的核心可以说就是它的语法糖。 - -那么怎么使用它的语法糖呢？很简单，根据上面的写法写完装饰器函数后，直接在原来的函数上加 `@` 和装饰器的函数名。如下： - -```Python -import time - - -def decorator(func): - def punch(): - print(time.strftime('%Y-%m-%d', time.localtime(time.time()))) - func() - - return punch - -@decorator -def punch(): - print('昵称：两点水 部门：做鸭事业部 上班打卡成功') - -punch() -``` - -输出结果： - -``` -2018-01-09 -昵称：两点水 部门：做鸭事业部 上班打卡成功 -``` - -那么这就很方便了，方便在我们的调用上，比如例子中的，使用了装饰器后，直接在原本的函数上加上装饰器的语法糖就可以了，本函数也无虚任何改变，调用的地方也不需修改。 - -不过这里一直有个问题，就是输出打卡信息的是固定的，那么我们需要通过参数来传递，装饰器该怎么写呢？装饰器中的函数可以使用 `*args` 可变参数，可是仅仅使用 `*args` 是不能完全包括所有参数的情况，比如关键字参数就不能了，为了能兼容关键字参数，我们还需要加上 `**kwargs` 。 - -因此，装饰器的最终形式可以写成这样： - -```Python -import time - - -def decorator(func): - def punch(*args, **kwargs): - print(time.strftime('%Y-%m-%d', time.localtime(time.time()))) - func(*args, **kwargs) - - return punch - - -@decorator -def punch(name, department): - print('昵称：{0} 部门：{1} 上班打卡成功'.format(name, department)) - - -@decorator -def print_args(reason, **kwargs): - print(reason) - print(kwargs) - - -punch('两点水', '做鸭事业部') -print_args('两点水', sex='男', age=99) -``` - -输出结果如下： - -``` -2018-01-09 -昵称：两点水 部门：做鸭事业部 上班打卡成功 -2018-01-09 -两点水 -{'sex': '男', 'age': 99} -``` - - - diff --git a/Article/PythonBasis/python2/Grammar.md b/Article/PythonBasis/python2/Grammar.md deleted file mode 100644 index 44b5fa8e..00000000 --- a/Article/PythonBasis/python2/Grammar.md +++ /dev/null @@ -1,16 +0,0 @@ -# 一、Python 语法的简要说明 # - -每种语言都有自己的语法，不管是自然语言（英语，中文）还是计算机编程语言。 - -Python 也不例外，它也有自己的语法规则，然后编辑器或者解析器根据符合语法的程序代码转换成 CPU 能够执行的机器码，然后执行。 - -Python 的语法比较简单，采用缩进方式。 - -![Python语法.png](http://upload-images.jianshu.io/upload_images/2136918-b9b072c2587cc89e.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) - -如上面的代码截图，以 # 开头的语句是注释，其他每一行都是一个语句，当语句以冒号 : 结尾时，缩进的语句视为代码块。 - -要注意的是 Python 程序是大小写敏感的，如果写错了大小写，程序会报错。 - -更多的说明可以看看之前的文章：[Python代码规范中的简明概述](https://www.readwithu.com/codeSpecification/codeSpecification_first.html) - diff --git a/Article/PythonBasis/python2/Preface.md b/Article/PythonBasis/python2/Preface.md deleted file mode 100644 index 50339701..00000000 --- a/Article/PythonBasis/python2/Preface.md +++ /dev/null @@ -1,10 +0,0 @@ -# 前言 # - -最近要开始新的项目，工作又开始忙起来了，不过还是每天要抽时间来写博客，但不可能做到日更，因为一篇博客，写的时间还是挺长的。[Gitbook](https://www.readwithu.com/) 同时更新喔。 - -注：看到以前矫情的话语，一下子就想把它给删掉。可以刚刚按了删除键才发现，删了之后，不知道写什么了。就瞬间撤销了。这一章节中改动了挺多东西的，也新增了很多例子。 - -# 目录 # - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-%E5%9F%BA%E6%9C%AC%E6%95%B0%E6%8D%AE%E7%B1%BB%E5%9E%8B%E5%92%8C%E5%8F%98%E9%87%8F.png) - diff --git a/Article/PythonBasis/python2/StringCoding.md b/Article/PythonBasis/python2/StringCoding.md deleted file mode 100644 index e7e301b8..00000000 --- a/Article/PythonBasis/python2/StringCoding.md +++ /dev/null @@ -1,30 +0,0 @@ -# 四、 字符串的编码问题 # - -我们都知道计算机只能处理数字，如果要处理文本，就必须先把文本转换为数字才能处理。最早的计算机在设计时采用8个比特（bit）作为一个字节（byte），所以，一个字节能表示的最大的整数就是255（二进制11111111=十进制255），0 - 255被用来表示大小写英文字母、数字和一些符号，这个编码表被称为ASCII编码，比如大写字母 A 的编码是 65，小写字母 z 的编码是 122。 - -如果要表示中文，显然一个字节是不够的，至少需要两个字节，而且还不能和 ASCII 编码冲突，所以，中国制定了 GB2312 编码，用来把中文编进去。 - -类似的，日文和韩文等其他语言也有这个问题。为了统一所有文字的编码，Unicode 应运而生。Unicode 把所有语言都统一到一套编码里，这样就不会再有乱码问题了。 - -Unicode 通常用两个字节表示一个字符，原有的英文编码从单字节变成双字节，只需要把高字节全部填为 0 就可以。 - -因为 Python 的诞生比 Unicode 标准发布的时间还要早，所以最早的Python 只支持 ASCII 编码，普通的字符串 'ABC' 在 Python 内部都是 ASCII 编码的。 - -Python 在后来添加了对 Unicode 的支持，以 Unicode 表示的字符串用`u'...'`表示。 - -不过在最新的 Python 3 版本中，字符串是以 Unicode 编码的，也就是说，Python 的字符串支持多语言。就像上面的例子一样，我的代码中没有加`u'...'`，也能正常显示。 - -不过由于 Python 源代码也是一个文本文件，所以，当你的源代码中包含中文的时候，在保存源代码时，就需要务必指定保存为 UTF-8 编码。当Python 解释器读取源代码时，为了让它按 UTF-8 编码读取，我们通常在文件开头写上这两行： - -```python -#!/usr/bin/env python3 -# -*- coding: utf-8 -*- -``` - -第一行注释是为了告诉 Linux/OS X 系统，这是一个 Python 可执行程序，Windows 系统会忽略这个注释； - -第二行注释是为了告诉 Python 解释器，按照 UTF-8 编码读取源代码，否则，你在源代码中写的中文输出可能会有乱码。 - -申明了 UTF-8 编码并不意味着你的 .py 文件就是 UTF-8 编码的，必须并且要确保文本编辑器正在使用 UTF-8 without BOM 编码 - - diff --git a/Article/PythonBasis/python2/Type_conversion.md b/Article/PythonBasis/python2/Type_conversion.md deleted file mode 100644 index 3717efc5..00000000 --- a/Article/PythonBasis/python2/Type_conversion.md +++ /dev/null @@ -1,69 +0,0 @@ -# 五、基本数据类型转换 # - -Python 中基本数据类型转换的方法有下面几个。 - -|方法|说明| -|-----|------| -|int(x [,base ]) | 将x转换为一个整数 | -|float(x ) | 将x转换到一个浮点数 | -|complex(real [,imag ])| 创建一个复数 | -|str(x ) | 将对象 x 转换为字符串 | -|repr(x ) | 将对象 x 转换为表达式字符串 | -|eval(str ) | 用来计算在字符串中的有效 Python 表达式,并返回一个对象 | -|tuple(s ) | 将序列 s 转换为一个元组 | -|list(s ) | 将序列 s 转换为一个列表 | -|chr(x ) | 将一个整数转换为一个字符 | -|unichr(x ) | 将一个整数转换为 Unicode 字符 | -|ord(x ) | 将一个字符转换为它的整数值 | -|hex(x ) | 将一个整数转换为一个十六进制字符串 | -|oct(x ) | 将一个整数转换为一个八进制字符串 | - -注：在 Python 3 里，只有一种整数类型 int，表示为长整型，没有 python2 中的 Long。 - -这里我们可以尝试一下这些函数方法。 - -比如 `int()` 函数，将符合规则的字符串类型转化为整数 。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-30-091547.png) - -输出结果： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-30-091648.png) - -注意这里是符合规则的字符串类型，如果是文字形式等字符串是不可以被 `int()` 函数强制转换的。 - -还有小数形式的字符串也是不能用 `int()` 函数转换的。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-064739.png) - -这样转换会报错。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-064811.png) - -但这并不是意味着浮点数不能转化为整数，而是小数形式的字符串不能强转为字符串。 - -浮点数还是可以通过 `int()` 函数转换的。 - -比如： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-065336.png) - -输出结果： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-065407.png) - -但是你会发现，结果是 88 ，后面小数点的 0.88 被去掉了。 - -这是因为 `int()` 函数是将数据转为整数。如果是浮点数转为整数，那么 `int()` 函数就会做取整处理，只取整数部分。所以输出的结果为 88 。 - -其余的方法就不一一列举了，只要多用，多试，这些方法都会慢慢熟悉的。还有如果是初学者，完全可以每个方法都玩一下，写一下，随便写，然后运行看结果，反正你的电脑又不会因为这样而玩坏的。 - - - - - - - - - - diff --git a/Article/PythonBasis/python2/Type_of_data.md b/Article/PythonBasis/python2/Type_of_data.md deleted file mode 100644 index 3b4d826e..00000000 --- a/Article/PythonBasis/python2/Type_of_data.md +++ /dev/null @@ -1,180 +0,0 @@ -# 三、Python 的基本数据类型 # - -## 1、字符串 ## - -字符串英文 string ，是 python 中随处可见的数据类型，字符串的识别也非常的简单，就是用「引号」括起来的。 - -引号包括单引号 `' '` ，双引号 `" "` 和 三引号 `''' '''` ，比如 `'abc'` ，`"123"` 等等。 - -这里请注意，单引号 `''` 或双引号 `""` 本身只是一种表示方式，不是字符串的一部分，因此，字符串 `'abc'` 只有 a，b，c 这 3 个字符。 - -如果善于思考的你，一定会问？ - -为什么要有单引号 `' '` ，双引号 `" "` 和 三引号 `''' '''` 啊，直接定死一个不就好了，搞那么麻烦，那么多规则表达同一个东西干嘛？ - -对，一般来说一种语法只用一个规则来表示是最好的，竟然现在字符串有三种不同的表示，证明是有原因的。 - -那么我们先来看下这三种方式，来定义同样内容的字符串，再把它打印出来，看看是怎样的。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-29-071320.png) - -打印出来的结果是一样的。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-29-071403.png) - -那如果我们的字符串不是 `两点水`，是 `两'点'水` 这样呢？ - -这样就直接报错了。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-29-071800.png) - -但是要注意，用单引号 `' '` 不行，用双引号 `" "` 是可以的。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-29-072459.png) - -打印的结果也跟预想的一样： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-29-072523.png) - -至于三引号，也是一样的，如果字符串内容里面含有双引号，也是会报同样的错误的。那么这时候你就可以用三引号了。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-29-072701.png) - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-29-072829.png) - -那么用单引号，双引号定义的字符串就不能表示这样的内容吗？ - -并不是的，你可以使用转义字符。 - -比如单引号，你可以使用 `\'` 来表示，双引号可以使用 `\"` 来表示。 - -注意，这里的是反斜杠 `\`, 不是斜杆 `/` 。 - -了解了之后，直接程序测试一下： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-29-073544.png) - -运行结果如下： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-29-073601.png) - -最后，也提一下， 三引号 `''' '''` 是直接可以分行的。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-29-074157.png) - -运行结果： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-29-074209.png) - - - - - - -## 2、整数 ## - -整数英文为 integer 。代码中的整数跟我们平常认识的整数一样，包括正整数、负整数和零，是没有小数点的数字。 - -Python 可以处理任意大小的整数，例如：`1`，`100`，`-8080`，`0`，等等。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-29-075017.png) - -运行结果： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-29-075046.png) - -当然，要注意了，如果数字你用引号括起来了，那就属于字符串，而不属于整数。比如 `'100'` , 这 100 是字符串，不是整数。 - -在现实世界中，整数我们通常会做计算，因此代码世界也是一样，整数可以直接加减乘除。 - -比如： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-29-075748.png) - -程序运行结果： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-29-075806.png) - -这里提示下大家，看看上面的例子，有没有发现什么？ - -看下 `int4` 打印出来的结果，是 `0.5` , 是一个小数。 - -而我们上面对整数的定义是什么？ - -是没有小数点的数字。 - -因此 `int4` 肯定不是整数。 - -这里我们可以使用 `type()` 函数来查看下类型。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-30-032745.png) - -结果如下： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-30-032826.png) - -可以看到 `int4` 是 float 类型，而 `int1` ,`int2`,`int3` 都是 int 整数类型。 - -那么 float 是什么类型呢？ - -float 是浮点数类型，是我们下面会说到的。 - -在说浮点数之前，各位可以看下 Python 的算术运算符有哪些，有个印象。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-30-034538.png) - - - - - -## 3、浮点数 ## - -浮点数的英文名是 float ，是指带小数的数字。 - -浮点数跟整数有很多类似的地方，但是浮点数是最折磨人的，也是最难让人捉摸透的。 - -就好比世界级的大佬 Herb Sutter 说的：「世上的人可以分为3类：一种是知道自己不懂浮点运算的；一种是以为自己懂浮点运算的；最后一种是极少的专家级人物，他们想知道自己是否有可能，最终完全理解浮点运算。」 - -为什么这么说呢？ - -看下面的例子 ，像整数一样，只是基本的浮点数加法运算。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-30-081702.png) - -可是运算结果，对于初学者来说，可能会接受不了。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-30-081922.png) - -对于第一个还好，`0.55+0.41` 等于 0.96 ，运算结果完全一致。可是后面两个，你会发现怎么出现了那么多个零。 - -这是因为计算机对浮点数的表达本身是不精确的。保存在计算机中的是二进制数，二进制对有些数字不能准确表达，只能非常接近这个数。 - -所以我们在对浮点数做运算和比较大小的时候要小心。 - - - - -## 4、布尔值 ## - -布尔值和布尔代数的表示完全一致，一个布尔值只有 `True` 、 `False `两种值，要么是 `True`，要么是 `False`，在 Python 中，可以直接用 True、False 表示布尔值（请注意大小写），也可以通过布尔运算计算出来。 - -布尔值可以用 `and`、`or` 和 `not` 运算。 - -`and` 运算是与运算，只有所有都为 True，and 运算结果才是 True。 - -`or` 运算是或运算，只要其中有一个为 True，or 运算结果就是 True。 - -`not` 运算是非运算，它是一个单目运算符，把 True 变成 False，False 变成 True。 - - - -## 5、空值 ## - -基本上每种编程语言都有自己的特殊值——空值，在 Python 中，用 None 来表示 - - - - - - - diff --git a/Article/PythonBasis/python2/Variable.md b/Article/PythonBasis/python2/Variable.md deleted file mode 100644 index 06e66d01..00000000 --- a/Article/PythonBasis/python2/Variable.md +++ /dev/null @@ -1,47 +0,0 @@ -# 六、Python 中的变量 # - -## 1、变量的创建和赋值 ## - -在 Python 程序中，变量是用一个变量名表示，可以是任意数据类型，变量名必须是大小写英文、数字和下划线（_）的组合，且不能用数字开头，比如： - -```python -a=88 -``` - -这里的 `a` 就是一个变量，代表一个整数，注意一点是 Python 是不用声明数据类型的。在 Python 中 `=` 是赋值语句，跟其他的编程语言也是一样的，因为 Python 定义变量时不需要声明数据类型，因此可以把任意的数据类型赋值给变量，且同一个变量可以反复赋值，而且可以是不同的数据类型。 - -![Python 中的变量.png](http://upload-images.jianshu.io/upload_images/2136918-69affa6da83f1dfc.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) - -这种变量本身类型不固定的语言称之为动态语言，与之对应的是静态语言。静态语言在定义变量时必须指定变量类型，如果赋值的时候类型不匹配，就会报错。例如 Java 是静态语言。 - - -## 2、变量的指向问题 ## - -我们来看下这段代码，发现最后打印出来的变量 b 是 `Hello Python` 。 - -![Python变量指向.png](http://upload-images.jianshu.io/upload_images/2136918-052a908c25fcfc49.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) - -这主要是变量 a 一开始是指向了字符串 `Hello Python` ，`b=a` 创建了变量 b ,变量 b 也指向了a 指向的字符串 `Hello Python`，最后 `a=123`，把 变量 a 重新指向了 `123`，所以最后输出变量 b 是 `Hello Python` - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-%E5%8F%98%E9%87%8F%E7%9A%84%E6%8C%87%E5%90%91.png) - - - -## 3、多个变量赋值 ## - -Python 允许同时为多个变量赋值。例如： - -```python -a = b = c = 1 -``` - -以上实例，创建一个整型对象，值为 1，三个变量被分配到相同的内存空间上。 - -当然也可以为多个对象指定多个变量。例如： - -```python -a, b, c = 1, 2, "liangdianshui" -``` - -以上实例，两个整型对象 1 和 2 的分配给变量 a 和 b，字符串对象 "liangdianshui" 分配给变量 c。 - diff --git a/Article/PythonBasis/python2/print.md b/Article/PythonBasis/python2/print.md deleted file mode 100644 index 91817543..00000000 --- a/Article/PythonBasis/python2/print.md +++ /dev/null @@ -1,52 +0,0 @@ -# 二、print() 函数 # - -这里先说一下 `print()` 函数，如果你是新手，可能对函数不太了解，没关系，在这里你只要了解它的组成部分和作用就可以了，后面函数这一块会详细说明的。 - -`print()` 函数由两部分构成 ： - -1. 指令：print -2. 指令的执行对象，在 print 后面的括号里的内容 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-17-074454.png) - -而 `print()` 函数的作用是让计算机把你给它的指令结果，显示在屏幕的终端上。这里的指令就是你在 `print()` 函数里的内容。 - -比如在上一章节中，我们的第一个 Python 程序，打印 `print('Hello Python')` - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-17-080241.png) - -它的执行流程如下： - -1. 向解释器发出指令，打印 'Hello Python' -2. 解析器把代码解释为计算器能读懂的机器语言 -3. 计算机执行完后就打印结果 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-17-083751.png) - -可能这里有人会问，为什么要加单引号，直接 `print(Hello Python)` 不行吗？ - -如果你写代码过程中，有这样的疑问，直接写一下代码，自己验证一下是最好的。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-17-094034.png) - -显然，去掉单引号后，运行结果标红了（报错），证明这是不可以的。 - -主要是因为这不符合 Python 的语法规则，去掉单引号后， Python 解释器根本没法看懂你写的是什么。 - -所以就报 ` SyntaxError: invalid syntax` 的错误，意思是：语法错误。说明你的语句不合规则。 - - - - - - - - - - - - - - - - diff --git a/Article/PythonBasis/python3/List.md b/Article/PythonBasis/python3/List.md deleted file mode 100644 index 059adb86..00000000 --- a/Article/PythonBasis/python3/List.md +++ /dev/null @@ -1,268 +0,0 @@ -# 一、List（列表） # - -## 1、什么是 List （列表） - -List （列表）是 Python 内置的一种数据类型。 它是一种有序的集合，可以随时添加和删除其中的元素。 - -那为什么要有 List （列表）呢？ - -我们用一个例子来说明。 - -现在有一个团队要出去玩，要先报名。如果用我们之前学过的知识，那么就是用一个字符串变量把他们都记录起来。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-080527.png) - -但是这样太麻烦了，而且也不美观。 - -在编程中，一定要学会偷懒，避免「重复性工作」。如果有一百个成员，那么你及时是复制粘贴，也会把你写烦。 - -这时候就可以使用列表了。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-080835.png) - -就这样，一行代码就可以存放 N 多个名字了。 - - -## 2、怎么创建 List（列表） ## - -从上面的例子可以分析出，列表的格式是这样的。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-081342.png) - -其实列表就是用中括号 `[]` 括起来的数据，里面的每一个数据就叫做元素。每个元素之间使用逗号分隔。 - -而且列表的数据元素不一定是相同的数据类型。 - -比如： - -```python -list1=['两点水','twowter','liangdianshui',123] -``` - -这里有字符串类型，还有整数类型。 - -我们尝试把他打印出来，看看打印的结果是怎样的。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-081912.png) - -结果如下： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-081951.png) - - -## 3、如何访问 List（列表）中的值 ## - -就像一开始的例子，我们有时候不需要把全部人员的姓名都打印出来，有时候我们需要知道第 3 个报名的人是谁？前两名报名的是谁？ - -那么怎么从列表中取出来呢？ - -换种问法就是，怎么去访问列表中的值？ - -这时候我们可以通过列表的下标索引来访问列表中的值，同样你也可以使用方括号的形式截取字符。 - -例如： - -```python -name = ['一点水', '两点水', '三点水', '四点水', '五点水'] - -# 通过索引来访问列表 -print(name[2]) -# 通过方括号的形式来截取列表中的数据 -print(name[0:2]) -``` - -输出的结果： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-090321.png) - -可见，我们需要知道知道 `name` 这个列表中第三个报名的是谁？只需要用 `name[2]` 就可以了。 - -这里你会问，为什么是 2 ，不是 3 呢？ - -这是因为在编程世界中，都是从 0 开始的，而不是我们生活习惯中从 1 开始。 - -所以需要知道第三个是谁？ - -那就是 `name[2]` 就可以了。 - -从例子来看，我们还把 `name[0:2]` 的结果打印出来了。 - -从打印结果来看，只打印了第一，第二个元素内容。 - -这里可能会有疑问？ - -为什么不是打印前三个啊，不是说 2 就是第 3 个吗？ - -那是因为这是**左闭右开**区间的。 - -所以 `name[0:2]` 的意思就是从第 0 个开始取，取到第 2 个，但是不包含第 2 个。 - -还是那句话，为了更好的理解，可以多去尝试，多去玩编程。 - -所以你可以尝试下下面的各种方式： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-091524.png) - -看看输出的结果： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-091624.png) - -根据输出的结果和上面讲到的知识，就很容易理解其中的一些用法了。 - - - - - ## 4、怎么去更新 List（列表） ## - -还是一开始的例子，我们用代码记录了报名人的名字，那后面可能会有新人加入，也有可能会发现一开始写错名字了，想要修改。 - -这时候怎么办呢？ - -这时候可以通过索引对列表的数据项进行修改或更新，也可以使用 append() 方法来添加列表项。 - -```python -name = ['一点水', '两点水', '三点水', '四点水', '五点水'] - - -# 通过索引对列表的数据项进行修改或更新 -name[1]='2点水' -print(name) - -# 使用 append() 方法来添加列表项 -name.append('六点水') -print(name) -``` - -输出的结果： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-092406.png) - - - - - -## 5、怎么删除 List（列表） 里面的元素 ## - -那既然这样，肯定会有人中途退出的。 - -那么我们就需要在列表中，把他的名字去掉。 - -这时候使用 del 语句来删除列表的的元素 - -```python -name = ['一点水', '两点水', '三点水', '四点水', '五点水'] - -print(name) - -# 使用 del 语句来删除列表的的元素 -del name[3] -print(name) -``` - -输出的结果: - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-092705.png) - -你看输出的结果，列表中已经没有了 `四点水` 这个数据了。证明已经删除成功了。 - - - - - - -## 6、List（列表）运算符 ## - -列表对 `+` 和 `*` 的操作符与字符串相似。`+` 号用于组合列表，`*` 号用于重复列表。 - -|Python 表达式|结果|描述| -|-----------|-----|-----| -|len([1, 2, 3])|3|计算元素个数| -|[1, 2, 3] + [4, 5, 6]| [1, 2, 3, 4, 5, 6]| 组合| -|['Hi!'] * 4|['Hi!', 'Hi!', 'Hi!', 'Hi!']|复制| -|3 in [1, 2, 3]|True|元素是否存在于列表中| -|for x in [1, 2, 3]: print x,|1 2 3|迭代| - - -## 7、List （列表）函数&方法 ## - -|函数&方法|描述| -|----|----| -|len(list)|列表元素个数| -|max(list)|返回列表元素最大值| -|min(list)|返回列表元素最小值| -|list(seq)|将元组转换为列表| -|list.append(obj)|在列表末尾添加新的对象| -|list.count(obj)|统计某个元素在列表中出现的次数| -|list.extend(seq)|在列表末尾一次性追加另一个序列中的多个值（用新列表扩展原来的列表）| -|list.index(obj)|从列表中找出某个值第一个匹配项的索引位置| -|list.insert(index, obj)|将对象插入列表| -|list.pop(obj=list[-1])|移除列表中的一个元素（默认最后一个元素），并且返回该元素的值| -|list.remove(obj)|移除列表中的一个元素（参数是列表中元素），并且不返回任何值| -|list.reverse()|反向列表中元素| -|list.sort([func])|对原列表进行排序| - - -## 8、实例 ## - - -最后通过一个例子来熟悉了解 List 的操作 - -例子： - -```python -#-*-coding:utf-8-*- -#-----------------------list的使用---------------------------------- - -# 1.一个产品，需要列出产品的用户，这时候就可以使用一个 list 来表示 -user=['liangdianshui','twowater','两点水'] -print('1.产品用户') -print(user) - -# 2.如果需要统计有多少个用户，这时候 len() 函数可以获的 list 里元素的个数 -len(user) -print('\n2.统计有多少个用户') -print(len(user)) - -# 3.此时，如果需要知道具体的用户呢？可以用过索引来访问 list 中每一个位置的元素，索引是0从开始的 -print('\n3.查看具体的用户') -print(user[0]+','+user[1]+','+user[2]) - -# 4.突然来了一个新的用户，这时我们需要在原有的 list 末尾加一个用户 -user.append('茵茵') -print('\n4.在末尾添加新用户') -print(user) - -# 5.又新增了一个用户，可是这个用户是 VIP 级别的学生，需要放在第一位，可以通过 insert 方法插入到指定的位置 -# 注意：插入数据的时候注意是否越界，索引不能超过 len(user)-1 -user.insert(0,'VIP用户') -print('\n5.指定位置添加用户') -print(user) - -# 6.突然发现之前弄错了，“茵茵”就是'VIP用户'，因此，需要删除“茵茵”；pop() 删除 list 末尾的元素 -user.pop() -print('\n6.删除末尾用户') -print(user) - -# 7.过了一段时间，用户“liangdianshui”不玩这个产品，删除了账号 -# 因此需要要删除指定位置的元素，用pop(i)方法，其中i是索引位置 -user.pop(1) -print('\n7.删除指定位置的list元素') -print(user) - -# 8.用户“两点水”想修改自己的昵称了 -user[2]='三点水' -print('\n8.把某个元素替换成别的元素') -print(user) - -# 9.单单保存用户昵称好像不够好，最好把账号也放进去 -# 这里账号是整数类型，跟昵称的字符串类型不同，不过 list 里面的元素的数据类型是可以不同的 -# 而且 list 元素也可以是另一个 list -newUser=[['VIP用户',11111],['twowater',22222],['三点水',33333]] -print('\n9.不同元素类型的list数据') -print(newUser) - -``` - -![list的使用](http://upload-images.jianshu.io/upload_images/2136918-65d31cae9f8bb34d.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) - - diff --git a/Article/PythonBasis/python3/Preface.md b/Article/PythonBasis/python3/Preface.md deleted file mode 100644 index 08afe8d4..00000000 --- a/Article/PythonBasis/python3/Preface.md +++ /dev/null @@ -1,12 +0,0 @@ -# 前言 # - -之前我们学习了字符串，整数，浮点数几种基本数据类型，现在我们接着学习两种新的数据类型，列表（List）和元组（tuple）。 - -注： [https://www.readwithu.com/](https://www.readwithu.com/) 同步更新。 - - -# 目录 # - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-09-01-List%20%E5%92%8C%20Tuple.png) - - diff --git a/Article/PythonBasis/python3/tuple.md b/Article/PythonBasis/python3/tuple.md deleted file mode 100644 index d5b842a6..00000000 --- a/Article/PythonBasis/python3/tuple.md +++ /dev/null @@ -1,196 +0,0 @@ -# 二、tuple（元组） # - -## 1、什么是元组 （tuple） ## - -上一节刚说了一个有序列表 List ，现在说另一种有序列表叫元组：tuple 。 - -tuple 和 List 非常类似，但是 tuple 一旦初始化就不能修改。 -也就是说元组（tuple）是不可变的，那么不可变是指什么意思呢？ - -元组（tuple） 不可变是指当你创建了 tuple 时候，它就不能改变了，也就是说它也没有 append()，insert() 这样的方法，但它也有获取某个索引值的方法，但是不能赋值。 - -那么为什么要有 tuple 呢？ - -那是因为 tuple 是不可变的，所以代码更安全。 - -所以建议能用 tuple 代替 list 就尽量用 tuple 。 - - - -## 2、怎样创建元组（tuple） ## - -元组创建很简单，只需要在括号中添加元素，并使用逗号隔开即可。 - -```python -tuple1=('两点水','twowter','liangdianshui',123,456) -tuple2='两点水','twowter','liangdianshui',123,456 -``` - -创建空元组 - -```python -tuple3=() -``` - -元组中只包含一个元素时，需要在元素后面添加逗号 - -```python -tuple4=(123,) -``` - -如果不加逗号，创建出来的就不是 元组（tuple），而是指 ```123``` 这个数了。 - - -这是因为括号 () 既可以表示元组（tuple），又可以表示数学公式中的小括号，这就产生了歧义。 - -所以如果只有一个元素时，你不加逗号，计算机就根本没法识别你是要进行整数或者小数运算还是表示元组。 - -因此，Python 规定，这种情况下，按小括号进行计算，计算结果自然是 ```123``` ，而如果你要表示元组的时候，就需要加个逗号。 - -具体看下图 tuple4 和 tuple5 的输出值 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-093847.jpg) - - - - - - - -## 3、如何访问元组（tuple） ## - -元组下标索引也是从 0 开始，元组（tuple）可以使用下标索引来访问元组中的值。 - -```python -#-*-coding:utf-8-*- - -tuple1=('两点水','twowter','liangdianshui',123,456) -tuple2='两点水','twowter','liangdianshui',123,456 - -print(tuple1[1]) -print(tuple2[0]) -``` - -输出的结果： - -![访问 tuple](http://upload-images.jianshu.io/upload_images/2136918-edfb7c9ebc7d5ab0.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) - - - - - -## 4、修改元组 （tuple） ## - -可能看到这个小标题有人会疑问，上面不是花了一大段来说 tuple 是不可变的吗？ - -这里怎么又来修改 tuple （元组） 了。 - -那是因为元组中的元素值是不允许修改的，但我们可以对元组进行连接组合，还有通过修改其他列表的值从而影响 tuple 的值。 - -具体看下面的这个例子： - -```python -#-*-coding:utf-8-*- -list1=[123,456] -tuple1=('两点水','twowater','liangdianshui',list1) -print(tuple1) -list1[0]=789 -list1[1]=100 -print(tuple1) -``` - -输出的结果： -``` -('两点水', 'twowater', 'liangdianshui', [123, 456]) -('两点水', 'twowater', 'liangdianshui', [789, 100]) -``` - - -可以看到，两次输出的 tuple 值是变了的。我们看看 tuple1 的存储是怎样的。 - - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-%E4%BF%AE%E6%94%B9tuple%E6%B5%81%E7%A8%8B%E5%9B%BE.png) - - -可以看到，tuple1 有四个元素，最后一个元素是一个 List ，List 列表里有两个元素。 - -当我们把 List 列表中的两个元素 `124` 和 `456` 修改为 `789` 和 `100` 的时候，从输出来的 tuple1 的值来看，好像确实是改变了。 - -但其实变的不是 tuple 的元素，而是 list 的元素。 - -tuple 一开始指向的 list 并没有改成别的 list，所以，tuple 所谓的“不变”是说，tuple 的每个元素，指向永远不变。注意是 tupe1 中的第四个元素还是指向原来的 list ，是没有变的，我们修改的只是列表 List 里面的元素。 - - - -## 5、删除 tuple （元组） ## - -tuple 元组中的元素值是不允许删除的，但我们可以使用 del 语句来删除整个元组 - -```python -#-*-coding:utf-8-*- - -tuple1=('两点水','twowter','liangdianshui',[123,456]) -print(tuple1) -del tuple1 -``` - -## 6、tuple （元组）运算符 ## - -与字符串一样，元组之间可以使用 `+` 号和 `*` 号进行运算。这就意味着他们可以组合和复制，运算后会生成一个新的元组。 - -|Python 表达式|结果|描述| -|-----------|-----|-----| -|len((1, 2, 3))|3|计算元素个数| -|(1, 2, 3) + (4, 5, 6)|(1, 2, 3, 4, 5, 6)|连接| -|('Hi!',) * 4|('Hi!', 'Hi!', 'Hi!', 'Hi!')|复制| -|3 in (1, 2, 3)|True|元素是否存在| -|for x in (1, 2, 3): print(x)|1 2 3|迭代| - -## 7、元组内置函数 ## - -|方法|描述| -|----|----| -|len(tuple)|计算元组元素个数| -|max(tuple)|返回元组中元素最大值| -|min(tuple)|返回元组中元素最小值| -|tuple(seq)|将列表转换为元组| - - -## 8、实例 ## - -最后跟列表一样，来一个实例，大家也可以多尝试，去把元组的各种玩法玩一遍。 - -```python -name1 = ('一点水', '两点水', '三点水', '四点水', '五点水') - -name2 = ('1点水', '2点水', '3点水', '4点水', '5点水') - -list1 = [1, 2, 3, 4, 5] - -# 计算元素个数 -print(len(name1)) -# 连接,两个元组相加 -print(name1 + name2) -# 复制元组 -print(name1 * 2) -# 元素是否存在 (name1 这个元组中是否含有一点水这个元素) -print('一点水' in name1) -# 元素的最大值 -print(max(name2)) -# 元素的最小值 -print(min(name2)) -# 将列表转换为元组 -print(tuple(list1)) -``` - -输出的结果如下： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-08-31-101523.png) - - - - - - - - diff --git a/Article/PythonBasis/python4/Dict.md b/Article/PythonBasis/python4/Dict.md deleted file mode 100644 index 706fecb4..00000000 --- a/Article/PythonBasis/python4/Dict.md +++ /dev/null @@ -1,201 +0,0 @@ -# 一、字典(Dictionary) # - -## 1、什么是 dict（字典） ## - -上一章节，我们学习了列表（List） 和 元组（tuple） 来表示有序集合。 - -而我们在讲列表（list）的时候，我们用了列表（list） 来存储用户的姓名。 - -```python -name = ['一点水', '两点水', '三点水', '四点水', '五点水'] -``` - -那么如果我们为了方便联系这些童鞋，要把电话号码也添加进去，该怎么做呢？ - -用 list 可以这样子解决： - -```python -name = [['一点水', '131456780001'], ['两点水', '131456780002'], ['三点水', '131456780003'], ['四点水', '131456780004'], ['五点水', '131456780005']] -``` - -但是这样很不方便，我们把电话号码记录下来，就是为了有什么事能及时联系上这些童鞋。 - -如果用列表来存储这些，列表越长，我们查找起来耗时就越长。 - -这时候就可以用 dict （字典）来表示了，Python 内置了 字典（dict），dict 全称 dictionary，如果学过 Java ，字典就相当于 JAVA 中的 map，使用键-值（key-value）存储，具有极快的查找速度。 - -```python -name = {'一点水': '131456780001', '两点水': '131456780002', '三点水': '131456780003', '四点水': '131456780004', '五点水': '131456780005'} -``` - - - -## 2、dict （字典）的创建 ## - -字典是另一种可变容器模型，且可存储任意类型对象。 - -字典的每个键值(key=>value)对用冒号(:)分割，每个对之间用逗号(,)分割，整个字典包括在花括号({})中 ,格式如下所示： - -```python -dict = {key1 : value1, key2 : value2 } -``` - -注意：键必须是唯一的，但值则不必。值可以取任何数据类型，但键必须是不可变的。 - -创建 dict（字典）实例： - -```python -dict1={'liangdianshui':'111111' ,'twowater':'222222' ,'两点水':'333333'} -dict2={'abc':1234,1234:'abc'} -``` - - - -## 3、访问 dict （字典） ## - -我们知道了怎么创建列表了，回归到一开始提出到的问题，为什么使用字典能让我们很快的找出某个童鞋的电话呢？ - - - -```python -name = {'一点水': '131456780001', '两点水': '131456780002', '三点水': '131456780003', '四点水': '131456780004', '五点水': '131456780005'} - -print(name['两点水']) -``` - - -输出的结果： - -``` -131456780002 -``` - -可以看到，如果你知道某个人的名字，也就是 key 值， 就能很快的查找到他对应的电话号码，也就是 Value 。 - -这里需要注意的一点是：如果字典中没有这个键，是会报错的。 - - - -## 4、修改 dict （字典） ## - -向字典添加新内容的方法是增加新的键/值对，修改或删除已有键/值对 - -```python -#-*-coding:utf-8-*- -dict1={'liangdianshui':'111111' ,'twowater':'222222' ,'两点水':'333333'} -print(dict1) -# 新增一个键值对 -dict1['jack']='444444' -print(dict1) -# 修改键值对 -dict1['liangdianshui']='555555' -print(dict1) -``` - -输出的结果： - -``` -{'liangdianshui': '111111', 'twowater': '222222', '两点水': '333333'} -{'liangdianshui': '111111', 'twowater': '222222', '两点水': '333333', 'jack': '444444'} -{'liangdianshui': '555555', 'twowater': '222222', '两点水': '333333', 'jack': '444444'} -``` - -## 5、删除 dict （字典） ## - -通过 `del` 可以删除 dict （字典）中的某个元素，也能删除 dict （字典） - -通过调用 `clear()` 方法可以清除字典中的所有元素 - -```python -#-*-coding:utf-8-*- -dict1={'liangdianshui':'111111' ,'twowater':'222222' ,'两点水':'333333'} -print(dict1) -# 通过 key 值，删除对应的元素 -del dict1['twowater'] -print(dict1) -# 删除字典中的所有元素 -dict1.clear() -print(dict1) -# 删除字典 -del dict1 -``` - -输出的结果： - -``` -{'liangdianshui': '111111', 'twowater': '222222', '两点水': '333333'} -{'liangdianshui': '111111', '两点水': '333333'} -{} -``` - -## 6、 dict （字典）使用时注意的事项 ## - -(1) dict （字典）是不允许一个键创建两次的，但是在创建 dict （字典）的时候如果出现了一个键值赋予了两次，会以最后一次赋予的值为准 - -例如： - -```python -#-*-coding:utf-8-*- -dict1={'liangdianshui':'111111' ,'twowater':'222222' ,'两点水':'333333','twowater':'444444'} -print(dict1) -print(dict1['twowater']) -``` - -输出的结果： - -``` -{'liangdianshui': '111111', 'twowater': '444444', '两点水': '333333'} -444444 -``` - - -(2) dict （字典）键必须不可变，可是键可以用数字，字符串或元组充当，但是就是不能使用列表 - -例如： - -```python -#-*-coding:utf-8-*- -dict1={'liangdianshui':'111111' ,123:'222222' ,(123,'tom'):'333333','twowater':'444444'} -print(dict1) -``` - -输出结果： - -``` -{'liangdianshui': '111111', 123: '222222', (123, 'tom'): '333333', 'twowater': '444444'} -``` - -(3) dict 内部存放的顺序和 key 放入的顺序是没有任何关系 - -和 list 比较，dict 有以下几个特点： - -* 查找和插入的速度极快，不会随着key的增加而变慢 - -* 需要占用大量的内存，内存浪费多 - -而list相反： - -* 查找和插入的时间随着元素的增加而增加 - -* 占用空间小，浪费内存很少 - - -## 7、dict （字典） 的函数和方法 ## - -|方法和函数|描述| -|---------|--------| -|len(dict)|计算字典元素个数| -|str(dict)|输出字典可打印的字符串表示| -|type(variable)|返回输入的变量类型，如果变量是字典就返回字典类型| -|dict.clear()|删除字典内所有元素| -|dict.copy()|返回一个字典的浅复制| -|dict.values()|以列表返回字典中的所有值| -|popitem()|随机返回并删除字典中的一对键和值| -|dict.items()|以列表返回可遍历的(键, 值) 元组数组| - - - - - - - diff --git a/Article/PythonBasis/python4/Preface.md b/Article/PythonBasis/python4/Preface.md deleted file mode 100644 index 318dc462..00000000 --- a/Article/PythonBasis/python4/Preface.md +++ /dev/null @@ -1,15 +0,0 @@ -# 前言 # - -上一篇文章出现了个明显的知识点错误，不过感谢有个网友的提出，及时进行了修改。也希望各位多多包涵。 - ->注：(2019年09月01日15:28:00) 在修改文章的时候，发现自己两年前写的像屎一样, 忍不住还在群里吐槽一番。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-09-01-072923.png) - - -# 目录 # - - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-09-01-Dict%20%E5%92%8C%20Set.png) - - diff --git a/Article/PythonBasis/python4/Set.md b/Article/PythonBasis/python4/Set.md deleted file mode 100644 index 9fa62591..00000000 --- a/Article/PythonBasis/python4/Set.md +++ /dev/null @@ -1,141 +0,0 @@ -# 二、set # - -python 的 set 和其他语言类似, 是一个无序不重复元素集, 基本功能包括关系测试和消除重复元素。 - -set 和 dict 类似，但是 set 不存储 value 值的。 - - -## 1、set 的创建 ## - -创建一个 set，需要提供一个 list 作为输入集合 - -```python -set1=set([123,456,789]) -print(set1) -``` - -输出结果： - -``` -{456, 123, 789} -``` - -传入的参数 `[123,456,789]` 是一个 list，而显示的 `{456, 123, 789}` 只是告诉你这个 set 内部有 456, 123, 789 这 3 个元素，显示的顺序跟你参数中的 list 里的元素的顺序是不一致的，这也说明了 set 是无序的。 - -还有一点，我们观察到输出的结果是在大括号中的，经过之前的学习，可以知道，tuple (元组) 使用小括号，list (列表) 使用方括号, dict (字典) 使用的是大括号，dict 也是无序的，只不过 dict 保存的是 key-value 键值对值，而 set 可以理解为只保存 key 值。 - -回忆一下，在 dict （字典） 中创建时，有重复的 key ，会被后面的 key-value 值覆盖的，而 重复元素在 set 中自动被过滤的。 - - -```python -set1=set([123,456,789,123,123]) -print(set1) -``` - -输出的结果： - -``` -{456, 123, 789} -``` - -## 2、set 添加元素 ## - -通过 add(key) 方法可以添加元素到 set 中，可以重复添加，但不会有效果 - -```python -set1=set([123,456,789]) -print(set1) -set1.add(100) -print(set1) -set1.add(100) -print(set1) -``` - -输出结果： -``` -{456, 123, 789} -{456, 123, 100, 789} -{456, 123, 100, 789} -``` - -## 3、set 删除元素 ## - -通过 remove(key) 方法可以删除 set 中的元素 - -```python -set1=set([123,456,789]) -print(set1) -set1.remove(456) -print(set1) -``` - -输出的结果： - -``` -{456, 123, 789} -{123, 789} -``` - - -## 4、set 的运用 ## - -因为 set 是一个无序不重复元素集，因此，两个 set 可以做数学意义上的 union(并集), intersection(交集), difference(差集) 等操作。 - -![set集合运算](http://upload-images.jianshu.io/upload_images/2136918-733b1d1071f772bd?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) - -例子： - -```python -set1=set('hello') -set2=set(['p','y','y','h','o','n']) -print(set1) -print(set2) - -# 交集 (求两个 set 集合中相同的元素) -set3=set1 & set2 -print('\n交集 set3:') -print(set3) -# 并集 （合并两个 set 集合的元素并去除重复的值） -set4=set1 | set2 -print('\n并集 set4:') -print(set4) -# 差集 -set5=set1 - set2 -set6=set2 - set1 -print('\n差集 set5:') -print(set5) -print('\n差集 set6:') -print( set6) - - -# 去除海量列表里重复元素，用 hash 来解决也行，只不过感觉在性能上不是很高，用 set 解决还是很不错的 -list1 = [111,222,333,444,111,222,333,444,555,666] -set7=set(list1) -print('\n去除列表里重复元素 set7:') -print(set7) - -``` - -运行的结果： - -``` -{'h', 'l', 'e', 'o'} -{'h', 'n', 'o', 'y', 'p'} - -交集 set3: -{'h', 'o'} - -并集 set4: -{'h', 'p', 'n', 'e', 'o', 'y', 'l'} - -差集 set5: -{'l', 'e'} - -差集 set6: -{'p', 'y', 'n'} - -去除列表里重复元素 set7: -{555, 333, 111, 666, 444, 222} -``` - - diff --git a/Article/PythonBasis/python5/Cycle.md b/Article/PythonBasis/python5/Cycle.md deleted file mode 100644 index d8567c35..00000000 --- a/Article/PythonBasis/python5/Cycle.md +++ /dev/null @@ -1,313 +0,0 @@ -# 二、循环语句 # - - - -## 1、什么是循环语句 ## - -一般编程语言都有循环语句，为什么呢？ - -那就问一下自己，我们弄程序是为了干什么？ - -那肯定是为了方便我们工作，优化我们的工作效率啊。 - -而计算机和人类不同，计算机不怕苦也不怕累，也不需要休息，可以一直做。 - -你要知道，计算机最擅长就是做重复的事情。 - -所以这时候需要用到循环语句，循环语句允许我们执行一个语句或语句组多次。 - -循环语句的一般形式如下： - -![python循环语句](http://upload-images.jianshu.io/upload_images/2136918-eaaae2fbfec3330f?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) - - -在 Python 提供了 for 循环和 while 循环。 - -这里又有一个问题了，如果我想让他运行了一百次之后停止，那该怎么做呢？ - -这时候需要用到一些控制循环的语句： - -|循环控制语句|描述| -|------|------| -|break|在语句块执行过程中终止循环，并且跳出整个循环| -|continue|在语句块执行过程中终止当前循环，跳出该次循环，执行下一次循环| -|pass|pass 是空语句，是为了保持程序结构的完整性| - -这些控制语句是为了让我们告诉程序什么时候停止，什么时候不运行这次循环。 - - - - -## 2、 for 循环语句 ## - -我们先来看下 for 循环语句。 - -它的流程图基本如下： - - -![for循环的流程图](http://upload-images.jianshu.io/upload_images/2136918-a0728c1c488238af?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) - - -基本的语法格式： - -```python -for iterating_var in sequence: - statements(s) -``` - -那么我们根据他的基本语法格式，随便写个例子测试一下： - - -```python -for letter in 'Hello 两点水': - print(letter) -``` - -输出的结果如下： - -```txt -H -e -l -l -o - -两 -点 -水 -``` - -从打印结果来看，它就是把字符串 `Hello 两点水` 一个一个字符的打印出来。 - -那如果我们把字符串换为字典 dict 呢？ - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-09-07-094741.png) - -你会发现只打印了字典 dict 中的每一个 key 值。 - -很多时候，我都是建议大家学到一个新的知识点，都多去尝试。 - -你尝试一遍，自己观察出来的结论，好过别人说十遍。 - -如果你不知道怎么去试？ - -可以根据我们的例子举一反三，比如上面的 for 循环，试了字符串，字典，那我们之前学的基本数据类型还有什么呢？ - -不记得可以再返回去看看，可以把所有的基本类型都拿去尝试一下。 - -比如，你试了之后，会发现整数和浮点数是不可以直接放在 for 循环里面的。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-09-07-095313.png) - - - - - - -## 3、 range() 函数 ## - -for 循环还常常和 range() 函数搭配使用的。 - -如果不知道 range() 函数 , 我们直接通过一段程序来理解。 - -```python -for i in range(3): - print(i) -``` - -打印的结果为： - -``` -0 -1 -2 -``` - -可见，打印了 0 到 3 。 - -使用 range(x) 函数，就可以生成一个从 0 到 x-1 的整数序列。 - -如果是 `range(a,b)` 函数，你可以生成了一个左闭右开的整数序列。 - -其实例子中的 `range(3)` 可以写成 `range(0,3)`, 结果是一样的。 - -其实使用 range() 函数，我们更多是为了把一段代码重复运行 n 次。 - -这里提个问题，你仔细观察 range() 函数，上面说到的不管是 1 个参数的，还是 2 个参数的都有什么共同的特点？ - -不知道你们有没有发现，他都是每次递增 1 的。 - -`range(3)` 就是 0 ，1，2 ，每次递增 1 。 - -`range(3,6)` 就是 3 ，4 ，5 ，也是每次递增 1 的。 - -那能不能每次不递增 1 呢？ - -比如我想递增 2 呢？ - -在程序的编写中，肯定会遇到这样的需求的。而 python 发展至今，range 函数肯定也会有这种功能。 - -所以 range 函数还有一个三个参数的。 - -比如 `range(0,10,2) ` , 它的意思是：从 0 数到 10（不取 10 ），每次间隔为 2 。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-09-09-065854.png) - - - - - - -## 4、While 循环语句 ## - -While 循环和 for 循环的作用是一样的。 - -我们先来看看 While 循环语句的样子。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-09-07-083137.png) - -程序输出的结果是： - -```txt -5050 -``` - -这个例子是计算 1 到 100 所有整数的和。 - - - -## 5、for 循环和 whlie 循环的区别 ## - -之前也提到过了，如果一种语法能表示一个功能，那没必要弄两种语法来表示。 - -竟然都是循环，for 循环和 while 循环肯定有他们的区别的。 - -那什么时候才使用 for 循环和 while 循环呢？ - -* for 循环主要用在迭代可迭代对象的情况。 - -* while 循环主要用在需要满足一定条件为真，反复执行的情况。 -（死循环+break 退出等情况。） - -* 部分情况下，for 循环和 while 循环可以互换使用。 - -例如： - -```python -for i in range(0, 10): - print(i) - - -i = 0 -while i < 10: - print(i) - i = i + 1 -``` - -虽然打印的结果是一样的，但是细细品味你会发现，他们执行的顺序和知道的条件是不同的。 - - - -## 6、嵌套循环 ## - -循环语句和条件语句一样，都是可以嵌套的。 - -具体的语法如下： - -**for 循环嵌套语法** - -```python -for iterating_var in sequence: - for iterating_var in sequence: - statements(s) - statements(s) -``` - -**while 循环嵌套语法** - -```python -while expression: - while expression: - statement(s) - statement(s) -``` - -除此之外，你也可以在循环体内嵌入其他的循环体，如在 while 循环中可以嵌入 for 循环， 反之，你可以在 for 循环中嵌入 while 循环 - -比如： - -当我们需要判断 sum 大于 1000 的时候，不在相加时，可以用到 break ，退出整个循环。 - -```python -count = 1 -sum = 0 -while (count <= 100): - sum = sum + count - if ( sum > 1000): #当 sum 大于 1000 的时候退出循环 - break - count = count + 1 -print(sum) -``` - -输出的结果： - -```txt -1035 -``` - -有时候，我们只想统计 1 到 100 之间的奇数和，那么也就是说当 count 是偶数，也就是双数的时候，我们需要跳出当次的循环，不想加，这时候可以用到 break - -```python -count = 1 -sum = 0 -while (count <= 100): - if ( count % 2 == 0): # 双数时跳过输出 - count = count + 1 - continue - sum = sum + count - count = count + 1 -print(sum) -``` - -输出的语句： - -```txt -2500 -``` - -还有： - -```python -for num in range(10,20): # 迭代 10 到 20 之间的数字 - for i in range(2,num): # 根据因子迭代 - if num%i == 0: # 确定第一个因子 - j=num/i # 计算第二个因子 - print ('%d 是一个合数' % num) - break # 跳出当前循环 - else: # 循环的 else 部分 - print ('%d 是一个质数' % num) -``` - -输出的结果： - -```txt -10 是一个合数 -11 是一个质数 -12 是一个合数 -13 是一个质数 -14 是一个合数 -15 是一个合数 -16 是一个合数 -17 是一个质数 -18 是一个合数 -19 是一个质数 -``` - - -当然，这里还用到了 `for … else` 语句。 - -其实 for 循环中的语句和普通的没有区别，else 中的语句会在循环正常执行完（即 for 不是通过 break 跳出而中断的）的情况下执行。 - -当然有 `for … else` ，也会有 `while … else` 。他们的意思都是一样的。 - - diff --git a/Article/PythonBasis/python5/Example.md b/Article/PythonBasis/python5/Example.md deleted file mode 100644 index 9243e7b3..00000000 --- a/Article/PythonBasis/python5/Example.md +++ /dev/null @@ -1,45 +0,0 @@ -# 三、条件语句和循环语句综合实例 # - -## 1、打印九九乘法表 ## - -```python -# -*- coding: UTF-8 -*- - -# 打印九九乘法表 -for i in range(1, 10): - for j in range(1, i+1): - # 打印语句中，大括号及其里面的字符 (称作格式化字段) 将会被 .format() 中的参数替换,注意有个点的 - print('{}x{}={}\t'.format(i, j, i*j), end='') - print() -``` - -输出的结果: - -```txt -1x1=1 -2x1=2 2x2=4 -3x1=3 3x2=6 3x3=9 -4x1=4 4x2=8 4x3=12 4x4=16 -5x1=5 5x2=10 5x3=15 5x4=20 5x5=25 -6x1=6 6x2=12 6x3=18 6x4=24 6x5=30 6x6=36 -7x1=7 7x2=14 7x3=21 7x4=28 7x5=35 7x6=42 7x7=49 -8x1=8 8x2=16 8x3=24 8x4=32 8x5=40 8x6=48 8x7=56 8x8=64 -9x1=9 9x2=18 9x3=27 9x4=36 9x5=45 9x6=54 9x7=63 9x8=72 9x9=81 -``` - - -## 2、判断是否是闰年 ## - -```python - -# 判断是否是闰年 - -year = int(input("请输入一个年份: ")) -if (year % 4) == 0 and (year % 100) != 0 or (year % 400) == 0: - print('{0} 是闰年' .format(year)) -else: - print('{0} 不是闰年' .format(year)) - -``` - - diff --git a/Article/PythonBasis/python5/If.md b/Article/PythonBasis/python5/If.md deleted file mode 100644 index d113f597..00000000 --- a/Article/PythonBasis/python5/If.md +++ /dev/null @@ -1,178 +0,0 @@ -# 一、条件语句 # - - -## 1、什么是条件语句 ## - - -Python 条件语句跟其他语言基本一致的，都是通过一条或多条语句的执行结果（ True 或者 False ）来决定执行的代码块。 - -Python 程序语言指定任何非 0 和非空（null）值为 True，0 或者 null 为 False。 - -执行的流程图如下： - -![if语句流程图](http://upload-images.jianshu.io/upload_images/2136918-4ee2486190450a1a?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) - - -## 2、if 语句的基本形式 ## - -Python 中，if 语句的基本形式如下： - -```python -if 判断条件： - 执行语句…… -else： - 执行语句…… -``` - -之前的章节也提到过，Python 语言有着严格的缩进要求，因此这里也需要注意缩进，也不要少写了冒号 `:` 。 - -if 语句的判断条件可以用>（大于）、<(小于)、==（等于）、>=（大于等于）、<=（小于等于）来表示其关系。 - -例如： - -```python -# -*-coding:utf-8-*- - -results=59 - -if results>=60: - print ('及格') -else : - print ('不及格') - -``` - -输出的结果为： - -```txt -不及格 -``` - -上面也说到，非零数值、非空字符串、非空 list 等，判断为 True，否则为 False。因此也可以这样写： - -```python -num = 6 -if num : - print('Hello Python') -``` - -输出的结果如下： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-09-07-072713.png) - -可见，把结果打印出来了。 - -那如果我们把 `num ` 改为空字符串呢？ - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-09-07-072941.png) - -很明显，空字符串是为 False 的，不符合条件语句，因此不会执行到 `print('Hello Python')` 这段代码。 - -还有再啰嗦一点，提醒一下，在条件判断代码中的冒号 `:` 后、下一行内容是一定要缩进的。不缩进是会报错的。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-09-07-073432.png) - -冒号和缩进是一种语法。它会帮助 Python 区分代码之间的层次，理解条件执行的逻辑及先后顺序。 - - - -## 3、if 语句多个判断条件的形式 ## - -有些时候，我们的判断语句不可能只有两个，有些时候需要多个，比如上面的例子中大于 60 的为及格，那我们还要判断大于 90 的为优秀，在 80 到 90 之间的良好呢？ - -这时候需要用到 if 语句多个判断条件， - -用伪代码来表示： - -```python -if 判断条件1: - 执行语句1…… -elif 判断条件2: - 执行语句2…… -elif 判断条件3: - 执行语句3…… -else: - 执行语句4…… -``` - -实例： - -```python -# -*-coding:utf-8-*- - -results = 89 - -if results > 90: - print('优秀') -elif results > 80: - print('良好') -elif results > 60: - print ('及格') -else : - print ('不及格') - -``` - -输出的结果： - -```txt -良好 -``` - - - -## 4、if 语句多个条件同时判断 ## - -有时候我们会遇到多个条件的时候该怎么操作呢？ - -比如说要求 java 和 python 的考试成绩要大于 80 分的时候才算优秀，这时候该怎么做？ - -这时候我们可以结合 `or` 和 `and` 来使用。 - -or （或）表示两个条件有一个成立时判断条件成功 - -and （与）表示只有两个条件同时成立的情况下，判断条件才成功。 - -例如： - -```python -# -*-coding:utf-8-*- - -java = 86 -python = 68 - -if java > 80 and python > 80: - print('优秀') -else : - print('不优秀') - -if ( java >= 80 and java < 90 ) or ( python >= 80 and python < 90): - print('良好') - -``` - -输出结果： - -```txt -不优秀 -良好 -``` - -注意：if 有多个条件时可使用括号来区分判断的先后顺序，括号中的判断优先执行，此外 and 和 or 的优先级低于 >（大于）、<（小于）等判断符号，即大于和小于在没有括号的情况下会比与或要优先判断。 - -## 5、if 嵌套 ## - -if 嵌套是指什么呢？ - -就跟字面意思差不多，指 if 语句中可以嵌套 if 语句。 - -比如上面说到的例子，也可以用 if 嵌套来写。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-09-07-080557.png) - -当然这只是为了说明 if 条件语句是可以嵌套的。如果是这个需求，我个人还是不太建议这样使用 if 嵌套的，因为这样代码量多了，而且嵌套太多，也不方便阅读代码。 - - - - - diff --git a/Article/PythonBasis/python5/Preface.md b/Article/PythonBasis/python5/Preface.md deleted file mode 100644 index 34b1d5cc..00000000 --- a/Article/PythonBasis/python5/Preface.md +++ /dev/null @@ -1,16 +0,0 @@ -# 前言 # - -通常都听到别人说，计算机很牛逼，很聪明，其实计算机一点都不聪明，光是你要跟他沟通，都会气 shi 你，聪明的是在写程序的你。 - -写程序就是跟计算机沟通，告诉它要做什么。 - -竟然是这样，那么肯定缺少不了一些沟通逻辑。比如你要告诉计算机在什么情况下做什么？或者在哪个时间点做什么？ - -这都需要用到逻辑判断。这一章节，主要就是说这个。 - - -# 目录 # - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-09-09-%E6%9D%A1%E4%BB%B6%E8%AF%AD%E5%8F%A5%E5%92%8C%E5%BE%AA%E7%8E%AF%E8%AF%AD%E5%8F%A5.png) - - diff --git a/Article/PythonBasis/python6/1.md b/Article/PythonBasis/python6/1.md deleted file mode 100644 index 332f72e5..00000000 --- a/Article/PythonBasis/python6/1.md +++ /dev/null @@ -1,101 +0,0 @@ -# 一、Python 自定义函数的基本步骤 # - - - - -## 1、什么是函数 ## - -函数，其实我们一开始学 Python 的时候就接触过。 - -不过我们使用的大多数都是 Python 的内置函数。 - -比如基本每个章节都会出现的 `print()` 函数。 - -而现在，我们主要学习的是自定义函数。 - -**各位有没有想过为什么需要函数呢？** - -如果要想回答这个问题，我们需要先了解函数是什么？ - -函数就是组织好的，可重复使用的，用来实现单一，或相关联功能的代码段。 - -没错，函数其实就是把代码抽象出来的代码段。 - -那为什么要抽象出来呢？ - -**方便我们使用，方便我们重复使用。** - -**函数的本质就是我们把一些数据喂给函数，让他内部消化，然后吐出你想要的东西，至于他怎么消化的，我们不需要知道，它内部解决。** - -怎么理解这句话呢？ - -举个例子，好比每次用到的 print 函数，我们都知道这个函数的作用是可以把我们的数据输出到控制台，让我们看到。所以 `print('两点水')` , 我们想打印 `两点水` 出来，就把 `两点水` 这个数据喂给 `print` 函数，然后他就直接把结果打印到控制台上了。 - - - - - - - -## 2、怎么自定义函数 ## - -怎么自定义函数？ - -要知道怎么定义函数，就要知道函数的组成部分是怎样的。 - -```python -def 函数名(参数1，参数2....参数n): - 函数体 - return 语句 -``` - -这就是 Python 函数的组成部分。 - -所以自定义函数，基本有以下规则步骤： - -* 函数代码块以 def 关键词开头，后接函数标识符名称和圆括号() -* 任何传入参数和自变量必须放在圆括号中间。圆括号之间可以用于定义参数 -* 函数的第一行语句可以选择性地使用文档字符串（用于存放函数说明） -* 函数内容以冒号起始，并且缩进 -* return [表达式] 结束函数，选择性地返回一个值给调用方。不带表达式的 return 相当于返回 None。 - -语法示例： - -```python -def functionname( parameters ): - "函数_文档字符串" - function_suite - return [expression] -``` - -实例： - -1. def 定义一个函数，给定一个函数名 sum -2. 声明两个参数 num1 和 num2 -3. 函数的第一行语句进行函数说明：两数之和 -4. 最终 return 语句结束函数，并返回两数之和 - -```python -def sum(num1,num2): - "两数之和" - return num1+num2 - -# 调用函数 -print(sum(5,6)) -``` - -输出结果： - -```python -11 -``` - - - - - - - - - - diff --git a/Article/PythonBasis/python6/2.md b/Article/PythonBasis/python6/2.md deleted file mode 100644 index bc3e8361..00000000 --- a/Article/PythonBasis/python6/2.md +++ /dev/null @@ -1,68 +0,0 @@ -# 二、函数返回值 # - -通过上面的学习，可以知道通过 return [表达式] 语句用于退出函数，选择性地向调用方返回一个表达式。 - -**不带参数值的 return 语句返回 None。** - -具体示例： - -```python -# -*- coding: UTF-8 -*- - -def sum(num1,num2): - # 两数之和 - if not (isinstance (num1,(int ,float)) and isinstance (num2,(int ,float))): - raise TypeError('参数类型错误') - return num1+num2 - -print(sum(1,2)) -``` - -返回结果： - -```txt -3 -``` - -这个示例，还通过内置函数`isinstance()`进行数据类型检查，检查调用函数时参数是否是整形和浮点型。如果参数类型不对，会报错，提示 `参数类型错误`,如图： - -![检查函数参数是否正确](http://upload-images.jianshu.io/upload_images/2136918-cfe5907d67e912d8?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) - -当然，函数也可以返回多个值，具体实例如下： - -```python -# -*- coding: UTF-8 -*- - -def division ( num1, num2 ): - # 求商与余数 - a = num1 % num2 - b = (num1-a) / num2 - return b , a - -num1 , num2 = division(9,4) -tuple1 = division(9,4) - -print (num1,num2) -print (tuple1) -``` - -输出的值： - -```txt -2.0 1 -(2.0, 1) -``` - -认真观察就可以发现，尽管从第一个输出值来看，返回了多个值，实际上是先创建了一个元组然后返回的。 - -回忆一下，元组是可以直接用逗号来创建的，观察例子中的 ruturn ，可以发现实际上我们使用的是逗号来生成一个元组。 - -Python 语言中的函数返回值可以是多个，而其他语言都不行，这是Python 相比其他语言的简便和灵活之处。 - -**Python 一次接受多个返回值的数据类型就是元组。** - -不知道此刻你还记不记得元组的相关知识，如果不记得，建议现在立刻写几个例子回忆一下，比如如何获取元组的第一个元素出来。 - - - - diff --git a/Article/PythonBasis/python6/3.md b/Article/PythonBasis/python6/3.md deleted file mode 100644 index 2d3b8ccd..00000000 --- a/Article/PythonBasis/python6/3.md +++ /dev/null @@ -1,266 +0,0 @@ -# 三、函数的参数 # - - - - -## 1、函数的参数类型 ## - -设置与传递参数是函数的重点，而 Python 的函数对参数的支持非常的灵活。 - -主要的参数类型有：默认参数、关键字参数（位置参数）、不定长参数。 - -下面我们将一一了解这几种参数。 - - - - -## 2、默认参数 ## - -有时候，我们自定义的函数中，如果调用的时候没有设置参数，需要给个默认值，这时候就需要用到默认值参数了。 - -默认参数，只要在构造函数参数的时候，给参数赋值就可以了 - -例如： - - -```python -# -*- coding: UTF-8 -*- - -def print_user_info( name , age , sex = '男' ): - # 打印用户信息 - print('昵称：{}'.format(name) , end = ' ') - print('年龄：{}'.format(age) , end = ' ') - print('性别：{}'.format(sex)) - return; - -# 调用 print_user_info 函数 - -print_user_info( '两点水' , 18 , '女') -print_user_info( '三点水' , 25 ) -``` - -输出结果： - -```txt -昵称：两点水 年龄：18 性别：女 -昵称：三点水 年龄：25 性别：男 -``` - -从输出结果可以看到，当你设置了默认参数的时候，在调用函数的时候，不传该参数，就会使用默认值。 - -但是这里需要注意的一点是：**只有在形参表末尾的那些参数可以有默认参数值**，也就是说你不能在声明函数形参的时候，先声明有默认值的形参而后声明没有默认值的形参。 - -这是因为赋给形参的值是根据位置而赋值的。例如，def func(a, b=1) 是有效的，但是 def func(a=1, b) 是 无效 的。 - -默认值参数就这样结束了吗？ - -还没有的，细想一下，如果参数中是一个可修改的容器比如一个 lsit （列表）或者 dict （字典），那么我们使用什么来作为默认值呢？ - -我们可以使用 None 作为默认值。就像下面这个例子一样： - -```python -# 如果 b 是一个 list ，可以使用 None 作为默认值 -def print_info( a , b = None ): - if b is None : - b=[] - return; -``` - -认真看下例子，会不会有这样的疑问呢？在参数中我们直接 `b=[]` 不就行了吗？ - -也就是写成下面这个样子： - -```python -def print_info( a , b = [] ): - return; -``` -对不对呢？ - -运行一下也没发现错误啊，可以这样写吗？ - -这里需要特别注意的一点：**默认参数的值是不可变的对象，比如None、True、False、数字或字符串**，如果你像上面的那样操作，当默认值在其他地方被修改后你将会遇到各种麻烦。 - -这些修改会影响到下次调用这个函数时的默认值。 - -示例如下： - -```python -# -*- coding: UTF-8 -*- - -def print_info( a , b = [] ): - print(b) - return b ; - -result = print_info(1) - -result.append('error') - -print_info(2) -``` - -输出的结果： - -```txt -[] -['error'] -``` - -认真观察，你会发现第二次输出的值根本不是你想要的，因此切忌不能这样操作。 - - -还有一点，有时候我就是不想要默认值啊，只是想单单判断默认参数有没有值传递进来，那该怎么办？ - -我们可以这样做： - -```python -_no_value =object() - -def print_info( a , b = _no_value ): - if b is _no_value : - print('b 没有赋值') - return; -``` - -这里的 `object` 是 python 中所有类的基类。 你可以创建 `object` 类的实例，但是这些实例没什么实际用处，因为它并没有任何有用的方法， 也没有任何实例数据(因为它没有任何的实例字典，你甚至都不能设置任何属性值)。 你唯一能做的就是测试同一性。也正好利用这个特性，来判断是否有值输入。 - - - - -## 3、关键字参数（位置参数） ## - -一般情况下，我们需要给函数传参的时候，是要按顺序来的，如果不对应顺序，就会传错值。 - -不过在 Python 中，可以通过参数名来给函数传递参数，而不用关心参数列表定义时的顺序，这被称之为关键字参数。 - -使用关键参数有两个优势 ： - -* 由于我们不必担心参数的顺序，使用函数变得更加简单了。 - -* 假设其他参数都有默认值，我们可以只给我们想要的那些参数赋值 - -具体看例子： - -```python -# -*- coding: UTF-8 -*- - -def print_user_info( name , age , sex = '男' ): - # 打印用户信息 - print('昵称：{}'.format(name) , end = ' ') - print('年龄：{}'.format(age) , end = ' ') - print('性别：{}'.format(sex)) - return; - -# 调用 print_user_info 函数 - -print_user_info( name = '两点水' ,age = 18 , sex = '女') -print_user_info( name = '两点水' ,sex = '女', age = 18 ) - -``` - -输出的值： - -```txt -昵称：两点水 年龄：18 性别：女 -昵称：两点水 年龄：18 性别：女 -``` - - - - - -## 4、不定长参数 ## - -或许有些时候，我们在设计函数的时候，我们有时候无法确定传入的参数个数。 - -那么我们就可以使用不定长参数。 - -Python 提供了一种元组的方式来接受没有直接定义的参数。这种方式在参数前边加星号 `*` 。 - -如果在函数调用时没有指定参数，它就是一个空元组。我们也可以不向函数传递未命名的变量。 - -例如： - -```python -# -*- coding: UTF-8 -*- - -def print_user_info( name , age , sex = '男' , * hobby): - # 打印用户信息 - print('昵称：{}'.format(name) , end = ' ') - print('年龄：{}'.format(age) , end = ' ') - print('性别：{}'.format(sex) ,end = ' ' ) - print('爱好：{}'.format(hobby)) - return; - -# 调用 print_user_info 函数 -print_user_info( '两点水' ,18 , '女', '打篮球','打羽毛球','跑步') - -``` - -输出的结果： - -```python -昵称：两点水 年龄：18 性别：女 爱好：('打篮球', '打羽毛球', '跑步') -``` - -通过输出的结果可以知道，`*hobby`是可变参数，且 hobby 其实就是一个 tuple （元祖） - - -可变长参数也支持关键字参数（位置参数），没有被定义的关键参数会被放到一个字典里。 - -这种方式即是在参数前边加 `**`,更改上面的示例如下： - - -```python -# -*- coding: UTF-8 -*- - -def print_user_info( name , age , sex = '男' , ** hobby ): - # 打印用户信息 - print('昵称：{}'.format(name) , end = ' ') - print('年龄：{}'.format(age) , end = ' ') - print('性别：{}'.format(sex) ,end = ' ' ) - print('爱好：{}'.format(hobby)) - return; - -# 调用 print_user_info 函数 -print_user_info( name = '两点水' , age = 18 , sex = '女', hobby = ('打篮球','打羽毛球','跑步')) - -``` - -输出的结果： - -```txt -昵称：两点水 年龄：18 性别：女 爱好：{'hobby': ('打篮球', '打羽毛球', '跑步')} -``` - -通过对比上面的例子和这个例子，可以知道，`*hobby`是可变参数，且 hobby其实就是一个 tuple （元祖），`**hobby`是关键字参数，且 hobby 就是一个 dict （字典） - - - -## 5、只接受关键字参数 ## - -关键字参数使用起来简单，不容易参数出错，那么有些时候，我们定义的函数希望某些参数强制使用关键字参数传递，这时候该怎么办呢？ - -将强制关键字参数放到某个`*`参数或者单个`*`后面就能达到这种效果,比如： - -```python -# -*- coding: UTF-8 -*- - -def print_user_info( name , *, age , sex = '男' ): - # 打印用户信息 - print('昵称：{}'.format(name) , end = ' ') - print('年龄：{}'.format(age) , end = ' ') - print('性别：{}'.format(sex)) - return; - -# 调用 print_user_info 函数 -print_user_info( name = '两点水' ,age = 18 , sex = '女' ) - -# 这种写法会报错，因为 age ，sex 这两个参数强制使用关键字参数 -#print_user_info( '两点水' , 18 , '女' ) -print_user_info('两点水',age='22',sex='男') -``` - -通过例子可以看，如果 `age` , `sex` 不使用关键字参数是会报错的。 - -很多情况下，使用强制关键字参数会比使用位置参数表意更加清晰，程序也更加具有可读性。使用强制关键字参数也会比使用 `**kw` 参数更好且强制关键字参数在一些更高级场合同样也很有用。 - diff --git a/Article/PythonBasis/python6/4.md b/Article/PythonBasis/python6/4.md deleted file mode 100644 index e9b7b6e4..00000000 --- a/Article/PythonBasis/python6/4.md +++ /dev/null @@ -1,96 +0,0 @@ -# 四、函数传值问题 # - -先看一个例子： - -```python -# -*- coding: UTF-8 -*- -def chagne_number( b ): - b = 1000 - -b = 1 -chagne_number(b) -print( b ) -``` - -最后输出的结果为： - -```txt -1 -``` - -先看看运行的结果？ - -想一下为什么打印的结果是 1 ，而不是 1000 ？ - -其实把问题归根结底就是，为什么通过函数 `chagne_number` 没有更改到 b 的值？ - -这个问题很多编程语言都会讲到，原理解释也是差不多的。 - -这里主要是函数参数的传递中，传递的是类型对象，之前也介绍了 Python 中基本的数据类型等。而这些类型对象可以分为可更改类型和不可更改的类型 - -**在 Python 中，字符串，整形，浮点型，tuple 是不可更改的对象，而 list ， dict 等是可以更改的对象。** - -例如： - -**不可更改的类型**：变量赋值 `a = 1`，其实就是生成一个整形对象 1 ，然后变量 a 指向 1，当 `a = 1000` 其实就是再生成一个整形对象 1000，然后改变 a 的指向，不再指向整形对象 1 ，而是指向 1000，最后 1 会被丢弃 - -**可更改的类型**：变量赋值 `a = [1,2,3,4,5,6]` ，就是生成一个对象 list ，list 里面有 6 个元素，而变量 a 指向 list ，`a[2] = 5`则是将 list a 的第三个元素值更改,这里跟上面是不同的，并不是将 a 重新指向，而是直接修改 list 中的元素值。 - -![指向问题](http://upload-images.jianshu.io/upload_images/2136918-31b1031d75e1cec9?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) - -这也将影响到函数中参数的传递了： - -**不可更改的类型**：类似 c++ 的值传递，如 整数、字符串、元组。如fun（a），传递的只是 a 的值，没有影响 a 对象本身。比如在 fun（a）内部修改 a 的值，只是修改另一个复制的对象，不会影响 a 本身。 - -**可更改的类型**：类似 c++ 的引用传递，如 列表，字典。如 fun（a），则是将 a 真正的传过去，修改后 fun 外部的 a 也会受影响 - -因此，在一开始的例子中，`b = 1`,创建了一个整形对象 1 ，变量 b 指向了这个对象，然后通过函数 chagne_number 时，按传值的方式复制了变量 b ，传递的只是 b 的值，并没有影响到 b 的本身。具体可以看下修改后的实例，通过打印的结果更好的理解。 - -```python -# -*- coding: UTF-8 -*- -def chagne_number( b ): - print('函数中一开始 b 的值：{}' .format( b ) ) - b = 1000 - print('函数中 b 赋值后的值：{}' .format( b ) ) - - -b = 1 -chagne_number( b ) -print( '最后输出 b 的值：{}' .format( b ) ) - - -``` - -打印的结果： - -```txt -函数中一开始 b 的值：1 -函数中 b 赋值后的值：1000 -最后输出 b 的值：1 -``` - -当然，如果参数中的是可更改的类型，那么调用了这个函数后，原来的值也会被更改，具体实例如下： - -```python -# -*- coding: UTF-8 -*- - -def chagne_list( b ): - print('函数中一开始 b 的值：{}' .format( b ) ) - b.append(1000) - print('函数中 b 赋值后的值：{}' .format( b ) ) - - -b = [1,2,3,4,5] -chagne_list( b ) -print( '最后输出 b 的值：{}' .format( b ) ) -``` - -输出的结果： - -```txt -函数中一开始 b 的值：[1, 2, 3, 4, 5] -函数中 b 赋值后的值：[1, 2, 3, 4, 5, 1000] -最后输出 b 的值：[1, 2, 3, 4, 5, 1000] -``` - - diff --git a/Article/PythonBasis/python6/5.md b/Article/PythonBasis/python6/5.md deleted file mode 100644 index 4da7b8ab..00000000 --- a/Article/PythonBasis/python6/5.md +++ /dev/null @@ -1,63 +0,0 @@ -# 五、匿名函数 # - -有没有想过定义一个很短的回调函数，但又不想用 `def` 的形式去写一个那么长的函数，那么有没有快捷方式呢？ - -答案是有的。 - -python 使用 lambda 来创建匿名函数，也就是不再使用 def 语句这样标准的形式定义一个函数。 - -匿名函数主要有以下特点： - -* lambda 只是一个表达式，函数体比 def 简单很多。 -* lambda 的主体是一个表达式，而不是一个代码块。仅仅能在 lambda 表达式中封装有限的逻辑进去。 -* lambda 函数拥有自己的命名空间，且不能访问自有参数列表之外或全局命名空间里的参数。 - -**基本语法** - -```python -lambda [arg1 [,arg2,.....argn]]:expression -``` - -示例： - -```python -# -*- coding: UTF-8 -*- - -sum = lambda num1 , num2 : num1 + num2; - -print( sum( 1 , 2 ) ) - -``` - -输出的结果： - -```txt -3 -``` - -注意：**尽管 lambda 表达式允许你定义简单函数，但是它的使用是有限制的。 你只能指定单个表达式，它的值就是最后的返回值。也就是说不能包含其他的语言特性了， 包括多个语句、条件表达式、迭代以及异常处理等等。** - -匿名函数中，有一个特别需要注意的问题，比如，把上面的例子改一下： - -```python -# -*- coding: UTF-8 -*- - -num2 = 100 -sum1 = lambda num1 : num1 + num2 ; - -num2 = 10000 -sum2 = lambda num1 : num1 + num2 ; - -print( sum1( 1 ) ) -print( sum2( 1 ) ) -``` - -你会认为输出什么呢？第一个输出是 101，第二个是 10001，结果不是的，输出的结果是这样： - -```txt -10001 -10001 -``` - -**这主要在于 lambda 表达式中的 num2 是一个自由变量，在运行时绑定值，而不是定义时就绑定，这跟函数的默认值参数定义是不同的。所以建议还是遇到这种情况还是使用第一种解法。** - diff --git a/Article/PythonBasis/python6/Preface.md b/Article/PythonBasis/python6/Preface.md deleted file mode 100644 index 8b6f2210..00000000 --- a/Article/PythonBasis/python6/Preface.md +++ /dev/null @@ -1,13 +0,0 @@ -# 前言 # - -函数这个章节内容有点多，对于新手，也有些不好理解。建议各位多看几篇，多敲几次代码。 - -最后这是我的个人微信号，大家可以添加一下，交个朋友，一起讨论。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-07-070041.jpg) - -# 目录 # - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-07-%E5%87%BD%E6%95%B0.png) - - diff --git a/Article/PythonBasis/python7/1.md b/Article/PythonBasis/python7/1.md deleted file mode 100644 index 61bbff4b..00000000 --- a/Article/PythonBasis/python7/1.md +++ /dev/null @@ -1,65 +0,0 @@ -# 一、迭代 # - -什么叫做迭代？ - -比如在 Java 中，我们通过 List 集合的下标来遍历 List 集合中的元素，在 Python 中，给定一个 list 或 tuple，我们可以通过 for 循环来遍历这个 list 或 tuple ，这种遍历就是迭代。 - -可是，Python 的 `for` 循环抽象程度要高于 Java 的 `for` 循环的，为什么这么说呢？因为 Python 的 `for` 循环不仅可以用在 list 或tuple 上，还可以作用在其他可迭代对象上。 - -也就是说，只要是可迭代的对象，无论有没有下标，都是可以迭代的。 - -比如： - -```python - -# -*- coding: UTF-8 -*- - -# 1、for 循环迭代字符串 -for char in 'liangdianshui' : - print ( char , end = ' ' ) - -print('\n') - -# 2、for 循环迭代 list -list1 = [1,2,3,4,5] -for num1 in list1 : - print ( num1 , end = ' ' ) - -print('\n') - -# 3、for 循环也可以迭代 dict （字典） -dict1 = {'name':'两点水','age':'23','sex':'男'} - -for key in dict1 : # 迭代 dict 中的 key - print ( key , end = ' ' ) - -print('\n') - -for value in dict1.values() : # 迭代 dict 中的 value - print ( value , end = ' ' ) - -print ('\n') - -# 如果 list 里面一个元素有两个变量，也是很容易迭代的 -for x , y in [ (1,'a') , (2,'b') , (3,'c') ] : - print ( x , y ) - -``` - -输出的结果如下： - -```txt -l i a n g d i a n s h u i - -1 2 3 4 5 - -name age sex - -两点水 23 男 - -1 a -2 b -3 c -``` - - diff --git a/Article/PythonBasis/python7/2.md b/Article/PythonBasis/python7/2.md deleted file mode 100644 index 83df50ac..00000000 --- a/Article/PythonBasis/python7/2.md +++ /dev/null @@ -1,50 +0,0 @@ -# 二、Python 迭代器 # - -上面简单的介绍了一下迭代，迭代是 Python 最强大的功能之一，是访问集合元素的一种方式。现在正式进入主题：迭代器，迭代器是一个可以记住遍历的位置的对象。 - -迭代器对象从集合的第一个元素开始访问，直到所有的元素被访问完结束。 - -迭代器只能往前不会后退。 - -迭代器有两个基本的方法：iter() 和 next(),且字符串，列表或元组对象都可用于创建迭代器，迭代器对象可以使用常规 for 语句进行遍历，也可以使用 next() 函数来遍历。 - -具体的实例： - -```python -# 1、字符创创建迭代器对象 -str1 = 'liangdianshui' -iter1 = iter ( str1 ) - -# 2、list对象创建迭代器 -list1 = [1,2,3,4] -iter2 = iter ( list1 ) - -# 3、tuple(元祖) 对象创建迭代器 -tuple1 = ( 1,2,3,4 ) -iter3 = iter ( tuple1 ) - -# for 循环遍历迭代器对象 -for x in iter1 : - print ( x , end = ' ' ) - -print('\n------------------------') - -# next() 函数遍历迭代器 -while True : - try : - print ( next ( iter3 ) ) - except StopIteration : - break - -``` - -最后输出的结果： - -```txt -l i a n g d i a n s h u i ------------------------- -1 -2 -3 -4 -``` diff --git a/Article/PythonBasis/python7/3.md b/Article/PythonBasis/python7/3.md deleted file mode 100644 index 177ba14d..00000000 --- a/Article/PythonBasis/python7/3.md +++ /dev/null @@ -1,110 +0,0 @@ -# 三、list 生成式（列表生成式） # - - -## 1、创建 list 的方式 ## - -之前经过我们的学习，都知道如何创建一个 list ，可是有些情况，用赋值的形式创建一个 list 太麻烦了，特别是有规律的 list ，一个一个的写，一个一个赋值，太麻烦了。比如要生成一个有 30 个元素的 list ，里面的元素为 1 - 30 。我们可以这样写： - -```python -# -*- coding: UTF-8 -*- - -list1=list ( range (1,31) ) -print(list1) -``` - -输出的结果： - -```txt -[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30] -``` - -这个其实在之前也有提到过，打印九九乘法表，用这个方法其实就几句代码就可以了，具体可以看之前的这个章节：[条件语句和循环语句综合实例](../python5/Example.md) - -但是，如果用到 list 生成式，可以一句代码就生成九九乘法表了。 - -你没听错，就是一句代码。 - -具体实现： - -```python -print('\n'.join([' '.join ('%dx%d=%2d' % (x,y,x*y) for x in range(1,y+1)) for y in range(1,10)])) -``` - -最后输出的结果： - -```txt -1x1= 1 -1x2= 2 2x2= 4 -1x3= 3 2x3= 6 3x3= 9 -1x4= 4 2x4= 8 3x4=12 4x4=16 -1x5= 5 2x5=10 3x5=15 4x5=20 5x5=25 -1x6= 6 2x6=12 3x6=18 4x6=24 5x6=30 6x6=36 -1x7= 7 2x7=14 3x7=21 4x7=28 5x7=35 6x7=42 7x7=49 -1x8= 8 2x8=16 3x8=24 4x8=32 5x8=40 6x8=48 7x8=56 8x8=64 -1x9= 9 2x9=18 3x9=27 4x9=36 5x9=45 6x9=54 7x9=63 8x9=72 9x9=81 -``` - -不过，这里我们先要了解如何创建 list 生成式 - -## 2、list 生成式的创建 ## - -首先，list 生成式的语法为： - -```python -[expr for iter_var in iterable] -[expr for iter_var in iterable if cond_expr] -``` - -第一种语法：首先迭代 iterable 里所有内容，每一次迭代，都把 iterable 里相应内容放到iter_var 中，再在表达式中应用该 iter_var 的内容，最后用表达式的计算值生成一个列表。 - -第二种语法：加入了判断语句，只有满足条件的内容才把 iterable 里相应内容放到 iter_var 中，再在表达式中应用该 iter_var 的内容，最后用表达式的计算值生成一个列表。 - -其实不难理解的，因为是 list 生成式，因此肯定是用 [] 括起来的，然后里面的语句是把要生成的元素放在前面，后面加 for 循环语句或者 for 循环语句和判断语句。 - -例子： - -```python -# -*- coding: UTF-8 -*- -list1=[x * x for x in range(1, 11)] -print(list1) -``` - -输出的结果： - -```txt -[1, 4, 9, 16, 25, 36, 49, 64, 81, 100] -``` - -可以看到，就是把要生成的元素 x * x 放到前面，后面跟 for 循环，就可以把 list 创建出来。那么 for 循环后面有 if 的形式呢？又该如何理解： - -```python -# -*- coding: UTF-8 -*- -list1= [x * x for x in range(1, 11) if x % 2 == 0] -print(list1) -``` - -输出的结果： - -```txt -[4, 16, 36, 64, 100] -``` - -这个例子是为了求 1 到 10 中偶数的平方根，上面也说到， `x * x` 是要生成的元素，后面那部分其实就是在 for 循环中嵌套了一个 if 判断语句。 - -那么有了这个知识点，我们也可以猜想出，for 循环里面也嵌套 for 循环。具体示例： - -```python -# -*- coding: UTF-8 -*- -list1= [(x+1,y+1) for x in range(3) for y in range(5)] -print(list1) -``` - -输出的结果： - -```txt -[(1, 1), (1, 2), (1, 3), (1, 4), (1, 5), (2, 1), (2, 2), (2, 3), (2, 4), (2, 5), (3, 1), (3, 2), (3, 3), (3, 4), (3, 5)] -``` - -其实知道了 list 生成式是怎样组合的，就不难理解这个东西了。因为 list 生成式只是把之前学习的知识点进行了组合，换成了一种更简洁的写法而已。 - - diff --git a/Article/PythonBasis/python7/4.md b/Article/PythonBasis/python7/4.md deleted file mode 100644 index fe95fe1e..00000000 --- a/Article/PythonBasis/python7/4.md +++ /dev/null @@ -1,207 +0,0 @@ -# 四、生成器 # - -## 1、为什么需要生成器 ## - -通过上面的学习，可以知道列表生成式，我们可以直接创建一个列表。 - -但是，受到内存限制，列表容量肯定是有限的。而且，创建一个包含 1000 万个元素的列表，不仅占用很大的存储空间，如果我们仅仅需要访问前面几个元素，那后面绝大多数元素占用的空间都白白浪费了。 - -**所以，如果列表元素可以按照某种算法推算出来，那我们是否可以在循环的过程中不断推算出后续的元素呢？** - -这样就不必创建完整的 list，从而节省大量的空间。 - -**在 Python 中，这种一边循环一边计算的机制，称为生成器：generator。** - -在 Python 中，使用了 yield 的函数被称为生成器（generator）。 - -跟普通函数不同的是，生成器是一个返回迭代器的函数，只能用于迭代操作，更简单点理解生成器就是一个迭代器。 - -在调用生成器运行的过程中，每次遇到 yield 时函数会暂停并保存当前所有的运行信息，返回 yield 的值。并在下一次执行 next()方法时从当前位置继续运行。 - -那么如何创建一个生成器呢？ - - -## 2、生成器的创建 ## - -最简单最简单的方法就是把一个列表生成式的 `[]` 改成 `()` - -```python -# -*- coding: UTF-8 -*- -gen= (x * x for x in range(10)) -print(gen) -``` - -输出的结果： - -```txt - at 0x0000000002734A40> -``` - -创建 List 和 generator 的区别仅在于最外层的 `[]` 和 `()` 。 - -但是生成器并不真正创建数字列表， 而是返回一个生成器，这个生成器在每次计算出一个条目后，把这个条目“产生” ( yield ) 出来。 - -生成器表达式使用了“惰性计算” ( lazy evaluation，也有翻译为“延迟求值”，我以为这种按需调用 call by need 的方式翻译为惰性更好一些)，只有在检索时才被赋值（ evaluated ），所以在列表比较长的情况下使用内存上更有效。 - - -那么竟然知道了如何创建一个生成器，那么怎么查看里面的元素呢？ - -## 3、遍历生成器的元素 ## - -按我们的思维，遍历用 for 循环，对了，我们可以试试： - -```python -# -*- coding: UTF-8 -*- -gen= (x * x for x in range(10)) - -for num in gen : - print(num) -``` - -没错，直接这样就可以遍历出来了。当然，上面也提到了迭代器，那么用 next() 可以遍历吗？当然也是可以的。 - - -## 4、以函数的形式实现生成器 ## - -上面也提到，创建生成器最简单最简单的方法就是把一个列表生成式的 `[]` 改成 `()`。为啥突然来个以函数的形式来创建呢？ - -其实生成器也是一种迭代器，但是你只能对其迭代一次。 - -这是因为它们并没有把所有的值存在内存中，而是在运行时生成值。你通过遍历来使用它们，要么用一个“for”循环，要么将它们传递给任意可以进行迭代的函数和结构。 - -而且实际运用中，大多数的生成器都是通过函数来实现的。那么我们该如何通过函数来创建呢？ - -先不急，来看下这个例子： - -```python -# -*- coding: UTF-8 -*- -def my_function(): - for i in range(10): - print ( i ) - -my_function() -``` - -输出的结果： - -```txt -0 -1 -2 -3 -4 -5 -6 -7 -8 -9 -``` - -如果我们需要把它变成生成器，我们只需要把 `print ( i )` 改为 `yield i` 就可以了，具体看下修改后的例子： - -```python -# -*- coding: UTF-8 -*- -def my_function(): - for i in range(10): - yield i - -print(my_function()) -``` - -输出的结果： - -```txt - -``` - -但是，这个例子非常不适合使用生成器，发挥不出生成器的特点，生成器的最好的应用应该是：你不想同一时间将所有计算出来的大量结果集分配到内存当中，特别是结果集里还包含循环。因为这样会耗很大的资源。 - -比如下面是一个计算斐波那契数列的生成器： - -```python -# -*- coding: UTF-8 -*- -def fibon(n): - a = b = 1 - for i in range(n): - yield a - a, b = b, a + b - -# 引用函数 -for x in fibon(1000000): - print(x , end = ' ') -``` - -运行的效果： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-07-%E8%AE%A1%E7%AE%97%E6%96%90%E6%B3%A2%E9%82%A3%E5%A5%91%E6%95%B0%E5%88%97%E7%9A%84%E7%94%9F%E6%88%90%E5%99%A8.gif) - -你看，运行一个这么大的参数，也不会说有卡死的状态，因为这种方式不会使用太大的资源。这里，最难理解的就是 generator 和函数的执行流程不一样。函数是顺序执行，遇到 return 语句或者最后一行函数语句就返回。而变成 generator 的函数，在每次调用 next() 的时候执行，遇到 yield语句返回，再次执行时从上次返回的 yield 语句处继续执行。 - -比如这个例子： - -```python -# -*- coding: UTF-8 -*- -def odd(): - print ( 'step 1' ) - yield ( 1 ) - print ( 'step 2' ) - yield ( 3 ) - print ( 'step 3' ) - yield ( 5 ) - -o = odd() -print( next( o ) ) -print( next( o ) ) -print( next( o ) ) -``` - -输出的结果： - -```txt -step 1 -1 -step 2 -3 -step 3 -5 -``` - -可以看到，odd 不是普通函数，而是 generator，在执行过程中，遇到 yield 就中断，下次又继续执行。执行 3 次 yield 后，已经没有 yield 可以执行了，如果你继续打印 `print( next( o ) ) ` ,就会报错的。所以通常在 generator 函数中都要对错误进行捕获。 - -## 5、打印杨辉三角 ## - -通过学习了生成器，我们可以直接利用生成器的知识点来打印杨辉三角： - -```python -# -*- coding: UTF-8 -*- -def triangles( n ): # 杨辉三角形 - L = [1] - while True: - yield L - L.append(0) - L = [ L [ i -1 ] + L [ i ] for i in range (len(L))] - -n= 0 -for t in triangles( 10 ): # 直接修改函数名即可运行 - print(t) - n = n + 1 - if n == 10: - break -``` - -输出的结果为： - -```txt -[1] -[1, 1] -[1, 2, 1] -[1, 3, 3, 1] -[1, 4, 6, 4, 1] -[1, 5, 10, 10, 5, 1] -[1, 6, 15, 20, 15, 6, 1] -[1, 7, 21, 35, 35, 21, 7, 1] -[1, 8, 28, 56, 70, 56, 28, 8, 1] -[1, 9, 36, 84, 126, 126, 84, 36, 9, 1] -``` - - diff --git a/Article/PythonBasis/python7/5.md b/Article/PythonBasis/python7/5.md deleted file mode 100644 index 8768ac97..00000000 --- a/Article/PythonBasis/python7/5.md +++ /dev/null @@ -1,102 +0,0 @@ -# 五、迭代器和生成器综合例子 # - -因为迭代器和生成器基本是互通的，因此有些知识点需要综合在一起 - -## 1、反向迭代 ## - -反向迭代，应该也是常有的需求了，比如从一开始迭代的例子里，有个输出 list 的元素，从 1 到 5 的 - -```python -list1 = [1,2,3,4,5] -for num1 in list1 : - print ( num1 , end = ' ' ) -``` - -那么我们从 5 到 1 呢？这也很简单， Python 中有内置的函数 `reversed()` - -```python -list1 = [1,2,3,4,5] -for num1 in reversed(list1) : - print ( num1 , end = ' ' ) -``` - -方向迭代很简单，可是要注意一点就是：**反向迭代仅仅当对象的大小可预先确定或者对象实现了 `__reversed__()` 的特殊方法时才能生效。 如果两者都不符合，那你必须先将对象转换为一个列表才行** - -其实很多时候我们可以通过在自定义类上实现 `__reversed__()` 方法来实现反向迭代。不过有些知识点在之前的篇节中还没有提到，不过可以相应的看下，有编程基础的，学完上面的知识点应该也能理解的。 - -```python -# -*- coding: UTF-8 -*- - -class Countdown: - def __init__(self, start): - self.start = start - - def __iter__(self): - # Forward iterator - n = self.start - while n > 0: - yield n - n -= 1 - - def __reversed__(self): - # Reverse iterator - n = 1 - while n <= self.start: - yield n - n += 1 - -for rr in reversed(Countdown(30)): - print(rr) -for rr in Countdown(30): - print(rr) -``` - -输出的结果是 1 到 30 然后 30 到 1 ，分别是顺序打印和倒序打印 - -## 2、同时迭代多个序列 ## - -你想同时迭代多个序列，每次分别从一个序列中取一个元素。你遇到过这样的需求吗？ - -为了同时迭代多个序列，使用 zip() 函数，具体示例： - -```python -# -*- coding: UTF-8 -*- - -names = ['laingdianshui', 'twowater', '两点水'] -ages = [18, 19, 20] -for name, age in zip(names, ages): - print(name,age) -``` - -输出的结果： - -```txt -laingdianshui 18 -twowater 19 -两点水 20 -``` - -其实 zip(a, b) 会生成一个可返回元组 (x, y) 的迭代器，其中 x 来自 a，y 来自 b。 一旦其中某个序列到底结尾，迭代宣告结束。 因此迭代长度跟参数中最短序列长度一致。注意理解这句话喔，也就是说如果 a ， b 的长度不一致的话，以最短的为标准，遍历完后就结束。 - -利用 `zip()` 函数，我们还可把一个 key 列表和一个 value 列表生成一个 dict （字典）,如下： - -```python -# -*- coding: UTF-8 -*- - -names = ['laingdianshui', 'twowater', '两点水'] -ages = [18, 19, 20] - -dict1= dict(zip(names,ages)) - -print(dict1) - -``` - - -输出如下结果： - -```python -{'laingdianshui': 18, 'twowater': 19, '两点水': 20} -``` - -这里提一下， `zip()` 是可以接受多于两个的序列的参数，不仅仅是两个。 \ No newline at end of file diff --git a/Article/PythonBasis/python7/Preface.md b/Article/PythonBasis/python7/Preface.md deleted file mode 100644 index 1646e388..00000000 --- a/Article/PythonBasis/python7/Preface.md +++ /dev/null @@ -1,11 +0,0 @@ -# 前言 # - -这篇内容挺多的，而且比内容不好理解。或许新手看完后，还会一脸懵逼，不过这是正常的，如果你看完后，是迷糊的，那么建议你继续学习后面的内容，等学完，再回来看几次。 - -注：这也是我第二次修改内容没有改过的章节。 - -# 目录 # - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-07-%E8%BF%AD%E4%BB%A3%E5%99%A8%E5%92%8C%E7%94%9F%E6%88%90%E5%99%A8.png) - - diff --git a/Article/PythonBasis/python8/1.md b/Article/PythonBasis/python8/1.md deleted file mode 100644 index 13fd9e0d..00000000 --- a/Article/PythonBasis/python8/1.md +++ /dev/null @@ -1,54 +0,0 @@ -# 一、面向对象的概念 # - - - -## 1、面向对象的两个基本概念 ## - -编程语言中，一般有两种编程思维，面向过程和面向对象。 - -面向过程，看重的是解决问题的过程。 - -这好比我们解决日常生活问题差不多，分析解决问题的步骤，然后一步一步的解决。 - -而面向对象是一种抽象，抽象是指用分类的眼光去看世界的一种方法。 - -Python 就是一门面向对象的语言, - -如果你学过 Java ，就知道 Java 的编程思想就是：万事万物皆对象。Python 也不例外，在解决实际问题的过程中，可以把构成问题事务分解成各个对象。 - -面向对象都有两个基本的概念，分别是类和对象。 - -* **类** - -用来描述具有相同的属性和方法的对象的集合。它定义了该集合中每个对象所共有的属性和方法。对象是类的实例。 - -* **对象** - -通过类定义的数据结构实例 - - - - - -## 2、面向对象的三大特性 ## - -面向对象的编程语言，也有三大特性，继承，多态和封装性。 - -* **继承** - -即一个派生类（derived class）继承基类（base class）的字段和方法。继承也允许把一个派生类的对象作为一个基类对象对待。 - -例如：一个 Dog 类型的对象派生自 Animal 类，这是模拟"是一个（is-a）"关系（例图，Dog 是一个 Animal ）。 - -* **多态** - -它是指对不同类型的变量进行相同的操作，它会根据对象（或类）类型的不同而表现出不同的行为。 - -* **封装性** - -“封装”就是将抽象得到的数据和行为（或功能）相结合，形成一个有机的整体（即类）；封装的目的是增强安全性和简化编程，使用者不必了解具体的实现细节，而只是要通过外部接口，一特定的访问权限来使用类的成员。 - - -**如果你是初次接触面向对象的编程语言，看到这里还一脸懵逼，不要紧，这是正常的。下面我们会通过大量的例子逐步了解 Python 的面向对象的知识。** - - diff --git a/Article/PythonBasis/python8/2.md b/Article/PythonBasis/python8/2.md deleted file mode 100644 index 67917711..00000000 --- a/Article/PythonBasis/python8/2.md +++ /dev/null @@ -1,83 +0,0 @@ -# 二、类的定义和调用 # - - - -## 1、怎么理解类？ ## - -类是什么？ - -个人认为理解类，最简单的方式就是：类是一个变量和函数的集合。 - -可以看下下面的这张图。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2020-03-09-014706.jpg) - -这张图很好的诠释了类，就是把变量和函数包装在一起。 - -当然我们包装也不是毫无目的的包装，我们会把同性质的包装在一个类里，这样就方便我们重复使用。 - -所以学到现在，你会发现很多编程的设计，都是为了我们能偷懒，重复使用。 - - - - - - -## 2、怎么定义类 ## - -知道了类是什么样子的，我们接下来就要学习怎么去定义类了。 - -类定义语法格式如下： - -```python -class ClassName(): - - . - . - . - -``` - -可以看到，我们是用 `class` 语句来自定义一个类的，其实这就好比我们是用 `def` 语句来定义一个函数一样。 - -竟然说类是变量和方法的集合包，那么我们来创建一个类。 - -```python -class ClassA(): - var1 = 100 - var2 = 0.01 - var3 = '两点水' - - def fun1(): - print('我是 fun1') - - def fun2(): - print('我是 fun1') - - def fun3(): - print('我是 fun1') -``` - -你看，上面我们就定义了一个类，类名叫做 `ClassA` , 类里面的变量我们称之为属性，那么就是这个类里面有 3 个属性，分别是 `var1` , `var2` 和 `var3` 。除此之外，类里面还有 3 个类方法 `fun1()` , `fun2()` 和 `fun3()` 。 - - - - - -## 3、怎么调用类属性和类方法 ## - - -我们定义了类之后，那么我们怎么调用类里面的属性和方法呢？ - -直接看下图： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2020-03-09-014728.jpg) - -这里就不文字解释了（注：做图也不容易啊，只有写过技术文章才知道，这系列文章，多耗时） - -好了，知道怎么调用之后，我们尝试一下： - - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2020-03-09-014742.jpg) - - diff --git a/Article/PythonBasis/python8/3.md b/Article/PythonBasis/python8/3.md deleted file mode 100644 index 82147949..00000000 --- a/Article/PythonBasis/python8/3.md +++ /dev/null @@ -1,57 +0,0 @@ -# 三、类方法 # - - -## 1、类方法如何调用类属性 ## - -通过上面我们已经会定义类了，那么这里讲一下在同一个类里，类方法如何调用类属性的。 - -直接看个例子吧： - - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-08-110451.png) - -注意看，在类方法上面多了个 `@classmethod` ，这是干嘛用的呢？ - -这是用于声明下面的函数是类函数。其实从名字就很好理解了。 - -class 就是类，method 就是方法。 - -那是不是一定需要注明这个呢？ - -答案是是的。 - -如果你没使用，是会报错的。 - - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-08-110822.png) - -如果没有声明是类方法，方法参数中就没有 `cls` , 就没法通过 `cls` 获取到类属性。 - -因此类方法，想要调用类属性，需要以下步骤： - -* 在方法上面，用 `@classmethod` 声明该方法是类方法。只有声明了是类方法，才能使用类属性 -* 类方法想要使用类属性，在第一个参数中，需要写上 `cls` , cls 是 class 的缩写，其实意思就是把这个类作为参数，传给自己，这样就可以使用类属性了。 -* 类属性的使用方式就是 `cls.变量名` - - -记住喔，无论是 `@classmethod` 还是 `cls` ,都是不能省去的。 - -省了都会报错。 - - - - - -## 2、类方法传参 ## - -上面我们学习了类方法如何调用类属性，那么类方法如何传参呢？ - -其实很简单，跟普通的函数一样，直接增加参数就好了。 - -这个就直接上例子了： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-08-113458.png) - - - - diff --git a/Article/PythonBasis/python8/4.md b/Article/PythonBasis/python8/4.md deleted file mode 100644 index 2dea4f4b..00000000 --- a/Article/PythonBasis/python8/4.md +++ /dev/null @@ -1,32 +0,0 @@ -# 四、修改和增加类属性 # - - -## 1、从内部增加和修改类属性 ## - -来，我们先来温习一下类的结构。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-08-034102.png) - -看着这个结构，提一个问题，如何修改类属性，也就是类里面的变量？ - -从类结构来看，我们可以猜测，从类方法来修改，也就是从类内部来修改和增加类属性。 - -看下具体的实例： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-08-120146.png) - -这里还是强调一下，例子还是要自己多写，不要只看，自己运行， 看效果。多想。 - - - - -## 2、从外部增加和修改类属性 ## - -我们刚刚看了通过类方法来修改类的属性，这时我们看下从外部如何修改和增加类属性。 - -例子如下： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-08-121135.png) - - - diff --git a/Article/PythonBasis/python8/5.md b/Article/PythonBasis/python8/5.md deleted file mode 100644 index 1f92bcf0..00000000 --- a/Article/PythonBasis/python8/5.md +++ /dev/null @@ -1,171 +0,0 @@ -# 五、类和对象 # - - - - -## 1、类和对象之间的关系 ## - -这部分内容主要讲类和对象，我们先来说说类和对象之间的关系。 - -**类是对象的模板** - -我们得先有了类，才能制作出对象。 - -类就相对于工厂里面的模具，对象就是根据模具制造出来的产品。 - -**从模具变成产品的过程，我们就称为类的实例化。** - -**类实例化之后，就变成对象了。也就是相当于例子中的产品。** - - - - - -## 2、类的实例化 ## - -这里强调一下，类的实例化和直接使用类的格式是不一样的。 - -之前我们就学过，直接使用类格式是这样的： - -```python -class ClassA(): - var1 = '两点水' - - @classmethod - def fun1(cls): - print('var1 值为：' + cls.var1) - - -ClassA.fun1() -``` - -而类的实例化是怎样的呢？ - -是这样的，可以仔细对比一下，类的实例化和直接使用类的格式有什么不同？ - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-09-025401.png) - - -主要的不同点有： - -* 类方法里面没有了 `@classmethod` 声明了，不用声明他是类方法 -* 类方法里面的参数 `cls` 改为 `self` -* 类的使用，变成了先通过 `实例名 = 类()` 的方式实例化对象，为类创建一个实例，然后再使用 `实例名.函数()` 的方式调用对应的方法 ，使用 `实例名.变量名` 的方法调用类的属性 - - -这里说明一下，类方法的参数为什么 `cls` 改为 `self` ？ - -其实这并不是说一定要写这个，你改为什么字母，什么名字都可以。 - -不妨试一下： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-09-032030.png) - -你看，把 `self` 改为 `aaaaaaaa` 还是可以一样运行的。 - -只不过使用 `cls` 和 `self` 是我们的编程习惯，这也是我们的编程规范。 - -因为 cls 是 class 的缩写，代表这类 ， 而 self 代表这对象的意思。 - -所以啊，这里我们实例化对象的时候，就使用 self 。 - -**而且 self 是所有类方法位于首位、默认的特殊参数。** - -除此之外，在这里，还要强调一个概念，当你把类实例化之后，里面的属性和方法，就不叫类属性和类方法了，改为叫实例属性和实例方法，也可以叫对象属性和对象方法。 - -为什么要这样强调呢？ - -**因为一个类是可以创造出多个实例对象出来的。** - -你看下面的例子： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-09-034453.png) - -我不仅能用这个类创建 a 对象，还能创建 b 对象 - - - - - -## 3、实例属性和类属性 ## - -一个类可以实例化多个对象出来。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-09-040408.png) - -根据这个图，我们探究一下实例对象的属性和类属性之间有什么关系呢？ - -**先提出第一个问题，如果类属性改变了，实例属性会不会跟着改变呢？** - -还是跟以前一样，提出了问题，我们直接用程序来验证就好。 - -看程序： - - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-09-061015.png) - - -从程序运行的结果来看，**类属性改变了，实例属性会跟着改变。** - -这很好理解，因为我们的实例对象就是根据类来复制出来的，类属性改变了，实例对象的属性也会跟着改变。 - -**那么相反，如果实例属性改变了，类属性会改变吗？** - -答案当然是不能啦。因为每个实例都是单独的个体，不能影响到类的。 - -具体我们做下实验： - - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-09-062437.png) - -可以看到，**不管实例对象怎么修改属性值，对类的属性还是没有影响的。** - - - - -## 4、实例方法和类方法 ## - -那这里跟上面一样，还是提出同样的问题。 - -**如果类方法改变了，实例方法会不会跟着改变呢？** - -看下下面的例子： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-09-063242.png) - -这里建议我的例子，各位都要仔细看一下，自己重新敲一遍。相信为什么要这么做，这么证明。 - -还是那句话多想，多敲。 - -回归正题，从运行的结果来看，类方法改变了，实例方法也是会跟着改变的。 - -在这个例子中，我们需要改变类方法，就用到了**类的重写**。 - -我们使用了 `类.原始函数 = 新函数` 就完了类的重写了。 - -要注意的是，这里的赋值是在替换方法，并不是调用函数。所以是不能加上括号的，也就是 `类.原始函数() = 新函数()` 这个写法是不对的。 - - -**那么如果实例方法改变了，类方法会改变吗？** - -如果这个问题我们需要验证的话，是不是要重写实例的方法，然后观察结果，看看类方法有没有改变，这样就能得出结果了。 - - -可是我们是不能重写实例方法。 - -你看，会直接报错。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-09-064303.png) - - - - - - - - - - - - - diff --git a/Article/PythonBasis/python8/6.md b/Article/PythonBasis/python8/6.md deleted file mode 100644 index 71152336..00000000 --- a/Article/PythonBasis/python8/6.md +++ /dev/null @@ -1,146 +0,0 @@ -# 六、初始化函数 # - - - -## 1、什么是初始化函数 ## - -初始化函数的意思是，当你创建一个实例的时候，这个函数就会被调用。 - -比如： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-09-071102.png) - -当代码在执行 `a = ClassA()` 的语句时，就自动调用了 `__init__(self)` 函数。 - -**而这个 `__init__(self)` 函数就是初始化函数，也叫构造函数。** - -初始化函数的写法是固定的格式：中间是 `init`，意思是初始化，然后前后都要有【两个下划线】，然后 `__init__()` 的括号中，第一个参数一定要写上 `self`，不然会报错。 - -构造函数（初始化函数）格式如下： - -```python -def __init__(self,[...): -``` - - -初始化函数一样可以传递参数的，例如： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-09-073421.png) - - - - -## 2、析构函数 ## - -竟然一个在创建的时候，会调用构造函数，那么理所当然，这个当一个类销毁的时候，就会调用析构函数。 - -析构函数语法如下： - -```python -def __del__(self,[...): -``` - -看下具体的示例： - - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-09-084417.png) - - - -## 3、Python 定义类的历史遗留问题 ## - -Python 在版本的迭代中，有一个关于类的历史遗留问题，就是新式类和旧式类的问题，具体先看以下的代码： - -```python -#!/usr/bin/env python -# -*- coding: UTF-8 -*- - -# 旧式类 -class OldClass: - pass - -# 新式类 -class NewClass(object): - pass - -``` - -可以看到，这里使用了两者中不同的方式定义类，可以看到最大的不同就是，新式类继承了`object` 类，在 Python2 中，我们定义类的时候最好定义新式类，当然在 Python3 中不存在这个问题了，因为 Python3 中所有类都是新式类。 - -那么新式类和旧式类有什么区别呢？ - -运行下下面的那段代码： - -```python -#!/usr/bin/env python -# -*- coding: UTF-8 -*- - -# 旧式类 -class OldClass: - def __init__(self, account, name): - self.account = account - self.name = name - - -# 新式类 -class NewClass(object): - def __init__(self, account, name): - self.account = account - self.name = name - - -if __name__ == '__main__': - old_class = OldClass(111111, 'OldClass') - print(old_class) - print(type(old_class)) - print(dir(old_class)) - print('\n') - new_class = NewClass(222222, 'NewClass') - print(new_class) - print(type(new_class)) - print(dir(new_class)) - -``` - -这是 python 2.7 运行的结果： - -``` -/Users/twowater/dev/python/test/venv/bin/python /Users/twowater/dev/python/test/com/twowater/test.py -<__main__.OldClass instance at 0x109a50560> - -['__doc__', '__init__', '__module__', 'account', 'name'] - - -<__main__.NewClass object at 0x109a4b150> - -['__class__', '__delattr__', '__dict__', '__doc__', '__format__', '__getattribute__', '__hash__', '__init__', '__module__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__', '__weakref__', 'account', 'name'] - -Process finished with exit code 0 - -``` - -这是 Python 3.6 运行的结果： - -``` -/usr/local/bin/python3.6 /Users/twowater/dev/python/test/com/twowater/test.py -<__main__.OldClass object at 0x1038ba630> - -['__class__', '__delattr__', '__dict__', '__dir__', '__doc__', '__eq__', '__format__', '__ge__', '__getattribute__', '__gt__', '__hash__', '__init__', '__init_subclass__', '__le__', '__lt__', '__module__', '__ne__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__', '__weakref__', 'account', 'name'] - - -<__main__.NewClass object at 0x103e3c9e8> - -['__class__', '__delattr__', '__dict__', '__dir__', '__doc__', '__eq__', '__format__', '__ge__', '__getattribute__', '__gt__', '__hash__', '__init__', '__init_subclass__', '__le__', '__lt__', '__module__', '__ne__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__', '__weakref__', 'account', 'name'] - -Process finished with exit code 0 - -``` - - -仔细观察输出的结果，对比一下，就能观察出来，注意喔，Pyhton3 中输出的结果是一模一样的，因为Python3 中没有新式类旧式类的问题。 - - - - - - diff --git a/Article/PythonBasis/python8/7.md b/Article/PythonBasis/python8/7.md deleted file mode 100644 index 0e95adad..00000000 --- a/Article/PythonBasis/python8/7.md +++ /dev/null @@ -1,181 +0,0 @@ -# 七、类的继承 # - -## 1、定义类的继承 ## - -说到继承，你一定会联想到继承你老爸的家产之类的。 - -类的继承也是一样。 - -比如有一个旧类，是可以算平均数的。然后这时候有一个新类，也要用到算平均数，那么这时候我们就可以使用继承的方式。新类继承旧类，这样子新类也就有这个功能了。 - -通常情况下，我们叫旧类为父类，新类为子类。 - - -首先我们来看下类的继承的基本语法： - -```python -class ClassName(BaseClassName): - - . - . - . - -``` - -在定义类的时候，可以在括号里写继承的类，如果不用继承类的时候，也要写继承 object 类，因为在 Python 中 object 类是一切类的父类。 - -当然上面的是单继承，Python 也是支持多继承的，具体的语法如下： - -```python -class ClassName(Base1,Base2,Base3): - - . - . - . - -``` - -多继承有一点需要注意的：若是父类中有相同的方法名，而在子类使用时未指定，python 在圆括号中父类的顺序，从左至右搜索 ， 即方法在子类中未找到时，从左到右查找父类中是否包含方法。 - -那么继承的子类可以干什么呢？ - -继承的子类的好处： -* 会继承父类的属性和方法 -* 可以自己定义，覆盖父类的属性和方法 - -## 2、调用父类的方法 ## - -一个类继承了父类后，可以直接调用父类的方法的，比如下面的例子，`UserInfo2` 继承自父类 `UserInfo` ，可以直接调用父类的 `get_account` 方法。 - -```python -#!/usr/bin/env python -# -*- coding: UTF-8 -*- - -class UserInfo(object): - lv = 5 - - def __init__(self, name, age, account): - self.name = name - self._age = age - self.__account = account - - def get_account(self): - return self.__account - - -class UserInfo2(UserInfo): - pass - - -if __name__ == '__main__': - userInfo2 = UserInfo2('两点水', 23, 347073565); - print(userInfo2.get_account()) - -``` - -## 3、父类方法的重写 ## - -当然，也可以重写父类的方法。 - -示例： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -class UserInfo(object): - lv = 5 - - def __init__(self, name, age, account): - self.name = name - self._age = age - self.__account = account - - def get_account(self): - return self.__account - - @classmethod - def get_name(cls): - return cls.lv - - @property - def get_age(self): - return self._age - - -class UserInfo2(UserInfo): - def __init__(self, name, age, account, sex): - super(UserInfo2, self).__init__(name, age, account) - self.sex = sex; - - -if __name__ == '__main__': - userInfo2 = UserInfo2('两点水', 23, 347073565, '男'); - # 打印所有属性 - print(dir(userInfo2)) - # 打印构造函数中的属性 - print(userInfo2.__dict__) - print(UserInfo2.get_name()) - -``` - -最后打印的结果： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-09-Python%20%E7%B1%BB%E7%9A%84%E7%BB%A7%E6%89%BF.png) - -这里就是重写了父类的构造函数。 - - -## 4、子类的类型判断 ## - -对于 class 的继承关系来说，有些时候我们需要判断 class 的类型，该怎么办呢？ - -可以使用 `isinstance()` 函数, - -一个例子就能看懂 `isinstance()` 函数的用法了。 - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -class User1(object): - pass - - -class User2(User1): - pass - - -class User3(User2): - pass - - -if __name__ == '__main__': - user1 = User1() - user2 = User2() - user3 = User3() - # isinstance()就可以告诉我们，一个对象是否是某种类型 - print(isinstance(user3, User2)) - print(isinstance(user3, User1)) - print(isinstance(user3, User3)) - # 基本类型也可以用isinstance()判断 - print(isinstance('两点水', str)) - print(isinstance(347073565, int)) - print(isinstance(347073565, str)) - -``` - -输出的结果如下： - -```txt -True -True -True -True -True -False -``` - -可以看到 `isinstance()` 不仅可以告诉我们，一个对象是否是某种类型，也可以用于基本类型的判断。 - - diff --git a/Article/PythonBasis/python8/8.md b/Article/PythonBasis/python8/8.md deleted file mode 100644 index 7a2c9cbb..00000000 --- a/Article/PythonBasis/python8/8.md +++ /dev/null @@ -1,70 +0,0 @@ -# 八、类的多态 # - -多态的概念其实不难理解，它是指对不同类型的变量进行相同的操作，它会根据对象（或类）类型的不同而表现出不同的行为。 - -事实上，我们经常用到多态的性质，比如： - -``` ->>> 1 + 2 -3 ->>> 'a' + 'b' -'ab' -``` - -可以看到，我们对两个整数进行 + 操作，会返回它们的和，对两个字符进行相同的 + 操作，会返回拼接后的字符串。 - -也就是说，不同类型的对象对同一消息会作出不同的响应。 - - -看下面的实例，来了解多态： - - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -class User(object): - def __init__(self, name): - self.name = name - - def printUser(self): - print('Hello !' + self.name) - - -class UserVip(User): - def printUser(self): - print('Hello ! 尊敬的Vip用户：' + self.name) - - -class UserGeneral(User): - def printUser(self): - print('Hello ! 尊敬的用户：' + self.name) - - -def printUserInfo(user): - user.printUser() - - -if __name__ == '__main__': - userVip = UserVip('两点水') - printUserInfo(userVip) - userGeneral = UserGeneral('水水水') - printUserInfo(userGeneral) - -``` - -输出的结果: - -```txt -Hello ! 尊敬的Vip用户：两点水 -Hello ! 尊敬的用户：水水水 -``` - -可以看到，userVip 和 userGeneral 是两个不同的对象，对它们调用 printUserInfo 方法，它们会自动调用实际类型的 printUser 方法，作出不同的响应。这就是多态的魅力。 - -要注意喔，有了继承，才有了多态，也会有不同类的对象对同一消息会作出不同的相应。 - - - -最后，本章的所有代码都可以在 [https://github.com/TwoWater/Python](https://github.com/TwoWater/Python) 上面找到，文章的内容和源文件都放在上面。同步更新到 Gitbooks。 - diff --git a/Article/PythonBasis/python8/9.md b/Article/PythonBasis/python8/9.md deleted file mode 100644 index 68d56fb6..00000000 --- a/Article/PythonBasis/python8/9.md +++ /dev/null @@ -1,118 +0,0 @@ -# 九、类的访问控制 # - - -## 1、类属性的访问控制 ## - -在 Java 中，有 public （公共）属性 和 private （私有）属性，这可以对属性进行访问控制。 - -那么在 Python 中有没有属性的访问控制呢？ - -一般情况下，我们会使用 `__private_attrs` 两个下划线开头，声明该属性为私有，不能在类地外部被使用或直接访问。在类内部的方法中使用时 `self.__private_attrs`。 - -为什么只能说一般情况下呢？ - -因为实际上， Python 中是没有提供私有属性等功能的。 - -但是 Python 对属性的访问控制是靠程序员自觉的。为什么这么说呢？ - -看看下面的示例： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-09-Python%20%E5%B1%9E%E6%80%A7%E8%AE%BF%E9%97%AE%E6%8E%A7%E5%88%B6.png) - -仔细看图片，为什么说双下划线不是真正的私有属性呢？我们看下下面的例子，用下面的例子来验证： - -```python - -#!/usr/bin/env python -# -*- coding: UTF-8 -*- - -class UserInfo(object): - def __init__(self, name, age, account): - self.name = name - self._age = age - self.__account = account - - def get_account(self): - return self.__account - - -if __name__ == '__main__': - userInfo = UserInfo('两点水', 23, 347073565); - # 打印所有属性 - print(dir(userInfo)) - # 打印构造函数中的属性 - print(userInfo.__dict__) - print(userInfo.get_account()) - # 用于验证双下划线是否是真正的私有属性 - print(userInfo._UserInfo__account) - - -``` - -输出的结果如下图： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-09-Python%E5%8F%8C%E4%B8%8B%E5%88%92%E7%BA%BF%E5%B1%9E%E6%80%A7.png) - - - - -## 2、类专有的方法 ## - -一个类创建的时候，就会包含一些方法，主要有以下方法： - -类的专有方法： - -| 方法 | 说明 | -| ------| ------ | -|`__init__` |构造函数，在生成对象时调用| -|`__del__ `| 析构函数，释放对象时使用| -|`__repr__ `| 打印，转换| -|`__setitem__ `| 按照索引赋值| -|`__getitem__`| 按照索引获取值| -|`__len__`| 获得长度| -|`__cmp__`| 比较运算| -|`__call__`| 函数调用| -|`__add__`| 加运算| -|`__sub__`| 减运算| -|`__mul__`|乘运算| -|`__div__`| 除运算| -|`__mod__`| 求余运算| -|`__pow__`|乘方| - -当然有些时候我们需要获取类的相关信息，我们可以使用如下的方法： - -* `type(obj)`：来获取对象的相应类型； -* `isinstance(obj, type)`：判断对象是否为指定的 type 类型的实例； -* `hasattr(obj, attr)`：判断对象是否具有指定属性/方法； -* `getattr(obj, attr[, default])` 获取属性/方法的值, 要是没有对应的属性则返回 default 值（前提是设置了 default），否则会抛出 AttributeError 异常； -* `setattr(obj, attr, value)`：设定该属性/方法的值，类似于 obj.attr=value； -* `dir(obj)`：可以获取相应对象的所有属性和方法名的列表： - - - -## 3、方法的访问控制 ## - -其实我们也可以把方法看成是类的属性的，那么方法的访问控制也是跟属性是一样的，也是没有实质上的私有方法。一切都是靠程序员自觉遵守 Python 的编程规范。 - -示例如下，具体规则也是跟属性一样的， - -```python -#!/usr/bin/env python -# -*- coding: UTF-8 -*- - -class User(object): - def upgrade(self): - pass - - def _buy_equipment(self): - pass - - def __pk(self): - pass - -``` - - - - - diff --git a/Article/PythonBasis/python8/Preface.md b/Article/PythonBasis/python8/Preface.md deleted file mode 100644 index a0abeb00..00000000 --- a/Article/PythonBasis/python8/Preface.md +++ /dev/null @@ -1,30 +0,0 @@ -# 前言 # - - -之前的文章都是使用[Sublime Text](http://www.sublimetext.com/)来编写 Python 的，主要是为了更好的熟悉和了解 Python ，可是开发效率不高，也不方便，从这章开始，改为使用 Pycharm 了，在之前的篇节[集成开发环境（IDE）: PyCharm](https://www.readwithu.com/python1/IDE.html)中介绍了 PyCharm ，如果如要激活软件可以通过授权服务器来激活，具体看这个网址。[JetBrains激活（http://www.imsxm.com/jetbrains-license-server.html）](http://www.imsxm.com/jetbrains-license-server.html)当然你也可以尝试破解， [Pycharm2017.1.1破解方式](http://blog.csdn.net/zyfortirude/article/details/70800681)，不过对于软件的升级不方便。 - - -这篇内容非常的重要，也是我用了很多时间写的。基本上把以前写的东西都重新改了一遍。里面的代码都是我一个一个的敲的，图片也是我一个一个制作的。 - - - - -# 目录 # - -![面向对象](media/%E9%9D%A2%E5%90%91%E5%AF%B9%E8%B1%A1.png) - - - - - - - - - - - - - - - - diff --git a/Article/PythonBasis/python9/1.md b/Article/PythonBasis/python9/1.md deleted file mode 100644 index 70c912a6..00000000 --- a/Article/PythonBasis/python9/1.md +++ /dev/null @@ -1,50 +0,0 @@ -# 一、Python 模块简介 # - -在开发过程中，随着程序代码越写越多，在一个文件里代码就会越来越长，越来越不容易维护。 - -后面我们学习了函数，知道函数是实现一项或多项功能的一段程序，这样就更方便我们重复使用代码。 - -紧接着，我们有学了类，类可以封装方法和变量（属性）。这样就更方便我们维护代码了。 - -我们之前学过，类的结构是这样的: - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-08-034102.png) - -而我们要学的模块是这样的： - - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-10-175017.png) - -在模块中，我们不但可以直接存放变量，还能存放函数，还能存放类。 - -不知道你们还有没有印象，我们封装函数用的是 `def` , 封装类用的是 `class` 。 - -而我们封装模块，是不需要任何语句的。 - -**在 Python 中，一个 .py 文件就称之为一个模块（Module）。** - -可以看下我之前写的例子，在 pychrome 上 ，这样一个 test.py 文件就是一个模块。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-070013.png) - -其实模块就是函数功能的扩展。为什么这么说呢？ - -那是因为模块其实就是实现一项或多项功能的程序块。 - -通过上面的定义，不难发现，函数和模块都是用来实现功能的，只是模块的范围比函数广，在模块中，可以有多个函数。 - -然有了函数，那为啥那需要模块？ - -最大的好处是大大提高了代码的可维护性。 - -其次，编写代码不必从零开始。当一个模块编写完毕，就可以被其他地方引用。我们在编写程序的时候，也经常引用其他模块，包括 Python 内置的模块和来自第三方的模块。 - -使用模块还可以避免函数名和变量名冲突。相同名字的函数和变量完全可以分别存在不同的模块中，因此，我们自己在编写模块时，不必考虑名字会与其他模块冲突。但是也要注意，尽量不要与内置函数名字冲突。 - -Python 本身就内置了很多非常有用的模块，只要安装完毕，这些模块就可以立刻使用。我们可以尝试找下这些模块，比如我的 Python 安装目录是默认的安装目录，在 C:\Users\Administrator\AppData\Local\Programs\Python\Python36 ，然后找到 Lib 目录，就可以发现里面全部都是模块，没错，这些 `.py` 文件就是模块了。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-python36bin%E7%9B%AE%E5%BD%95.png) - -其实模块可以分为标准库模块和自定义模块，而刚刚我们看到的 Lib 目录下的都是标准库模块。 - - diff --git a/Article/PythonBasis/python9/2.md b/Article/PythonBasis/python9/2.md deleted file mode 100644 index abf1c87b..00000000 --- a/Article/PythonBasis/python9/2.md +++ /dev/null @@ -1,117 +0,0 @@ -# 二、模块的使用 # - -## 1、import ## - -Python 模块的使用跟其他编程语言也是类似的。你要使用某个模块，在使用之前，必须要导入这个模块。导入模块我们使用关键字 `import`。 - -`import` 的语法基本如下： - -```python -import module1[, module2[,... moduleN] -``` - -比如我们使用标准库模块中的 math 模块。当解释器遇到 `import` 语句，如果模块在当前的搜索路径就会被导入。 - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -import math - -_author_ = '两点水' - -print(math.pi) -``` - -输出的结果： - -```txt -3.141592653589793 -``` - -一个模块只会被导入一次，不管你执行了多少次 import。这样可以防止导入模块被一遍又一遍地执行。 - -当我们使用 import 语句的时候，Python 解释器是怎样找到对应的文件的呢？ - -这就涉及到 Python 的搜索路径，搜索路径是由一系列目录名组成的，Python 解释器就依次从这些目录中去寻找所引入的模块。这看起来很像环境变量，事实上，也可以通过定义环境变量的方式来确定搜索路径。搜索路径是在 Python 编译或安装的时候确定的，安装新的库应该也会修改。搜索路径被存储在sys 模块中的 path 变量 。 - -因此，我们可以查一下路径： - -```python -#!/usr/bin/env python -# -*- coding: UTF-8 -*- - -import sys - -print(sys.path) -``` - -输出结果： - - -```txt -['C:\\Users\\Administrator\\Desktop\\Python\\Python8Code', 'G:\\PyCharm 2017.1.4\\helpers\\pycharm', 'C:\\Users\\Administrator\\AppData\\Local\\Programs\\Python\\Python36\\python36.zip', 'C:\\Users\\Administrator\\AppData\\Local\\Programs\\Python\\Python36\\DLLs', 'C:\\Users\\Administrator\\AppData\\Local\\Programs\\Python\\Python36\\lib', 'C:\\Users\\Administrator\\AppData\\Local\\Programs\\Python\\Python36', 'C:\\Users\\Administrator\\AppData\\Local\\Programs\\Python\\Python36\\lib\\site-packages', 'C:\\Users\\Administrator\\Desktop\\Python\\Python8Code\\com\\Learn\\module\\sys'] - -``` - -## 2、from···import ## - - -有没有想过，怎么直接导入某个模块中的属性和方法呢？ - -Python 中，导入一个模块的方法我们使用的是 `import` 关键字，这样做是导入了这个模块，这里需要注意了，这样做只是导入了模块，并没有导入模块中具体的某个属性或方法的。而我们想直接导入某个模块中的某一个功能，也就是属性和方法的话，我们可以使用 `from···import` 语句。 - -语法如下： - -```python -from modname import name1[, name2[, ... nameN]] -``` - -看完简介后可能会想， `from···import` 和 `import` 方法有啥区别呢？ - -想知道区别是什么，观察下面两个例子： - - `import` 导入 sys 模块，然后使用 version 属性 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-from%C2%B7%C2%B7%C2%B7import%E5%92%8C%20import%E7%9A%84%E5%8C%BA%E5%88%AB1.png) - -`from···import` 直接导入 version 属性 - -![from···import和 import的区别2](media/from%C2%B7%C2%B7%C2%B7import%E5%92%8C%20import%E7%9A%84%E5%8C%BA%E5%88%AB2-2.png) - - - - -## 3、from ··· import * ## - -通过上面的学习，我们知道了 `from sys import version` 可以直接导入 version 属性。 - -但是如果我们想使用其他的属性呢？ - -比如使用 sys 模块中的 `executable` ，难道又要写多一句 `from sys import executable` ,两个还好，如果三个，四个呢？ - -难道要一直这样写下去？ - -这时候就需要 `from ··· import *` 语句了，这个语句可以把某个模块中的所有方法属性都导入。比如： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -from sys import * - -print(version) -print(executable) - -``` - -输出的结果为： - -```txt -3.6.1 (v3.6.1:69c0db5, Mar 21 2017, 18:41:36) [MSC v.1900 64 bit (AMD64)] -C:\Users\Administrator\AppData\Local\Programs\Python\Python36\python.exe -``` - -注意：这提供了一个简单的方法来导入一个模块中的所有方法属性。然而这种声明不该被过多地使用。 - - diff --git a/Article/PythonBasis/python9/3.md b/Article/PythonBasis/python9/3.md deleted file mode 100644 index 48947d50..00000000 --- a/Article/PythonBasis/python9/3.md +++ /dev/null @@ -1,25 +0,0 @@ -# 三、主模块和非主模块 # - -## 1、主模块和非主模块的定义 ## - -在 Python 函数中，如果一个函数调用了其他函数完成一项功能，我们称这个函数为主函数，如果一个函数没有调用其他函数，我们称这种函数为非主函数。主模块和非主模块的定义也类似，如果一个模块被直接使用，而没有被别人调用，我们称这个模块为主模块，如果一个模块被别人调用，我们称这个模块为非主模块。 - -## 2、__name__ 属性 ## - -在 Python 中，有主模块和非主模块之分，当然，我们也得区分他们啊。那么怎么区分主模块和非主模块呢？ - -这就需要用到 `__name__` 属性了，这个 `——name——` 属性值是一个变量，且这个变量是系统给出的。利用这个变量可以判断一个模块是否是主模块。如果一个属性的值是 `__main__` ,那么就说明这个模块是主模块，反之亦然。但是要注意了：** 这个 `__main__` 属性只是帮助我们判断是否是主模块，并不是说这个属性决定他们是否是主模块，决定是否是主模块的条件只是这个模块有没有被人调用** - -具体看示例： - -首先创建了模块 lname ，然后判断一下是否是主模块，如果是主模块就输出 `main` 不是，就输出 `not main` ，首先直接运行该模块，由于该模块是直接使用，而没有被人调用，所以是主模块，因此输出了 `main` ，具体看下图： - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-name%E5%B1%9E%E6%80%A7%E5%8C%BA%E5%88%86%E6%A8%A1%E5%9D%971.png) - - -然后又创建一个 user_lname 模块，里面只是简单的导入了 lname 模块，然后执行，输出的结果是 `not main` ，因为 lname 模块被该模块调用了，所以不是主模块，输出结果如图： - - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-name%E5%B1%9E%E6%80%A7%E5%8C%BA%E5%88%86%E6%A8%A1%E5%9D%972.png) - - diff --git a/Article/PythonBasis/python9/4.md b/Article/PythonBasis/python9/4.md deleted file mode 100644 index a98e5376..00000000 --- a/Article/PythonBasis/python9/4.md +++ /dev/null @@ -1,21 +0,0 @@ -# 四、包 # - -包，其实在上面的一些例子中，都创建了不同的包名了，具体可以仔细观察。 - -在一开始模块的简介中提到，使用模块可以避免函数名和变量名冲突。 - -相同名字的函数和变量完全可以分别存在不同的模块中，因此，我们自己在编写模块时，不必考虑名字会与其他模块冲突。但是也要注意，尽量不要与内置函数名字冲突。 - -但是这里也有个问题，如果不同的人编写的模块名相同怎么办？ - -为了避免模块名冲突，Python 又引入了按目录来组织模块的方法，称为包（Package）。 - -比如最开始的例子，就引入了包，这样子做就算有相同的模块名，也不会造成重复，因为包名不同，其实也就是路径不同。如下图，引入了包名后， lname.py 其实变成了 com.Learn.module.nameattributes.lname - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-Python%20%E5%8C%85.png) - -仔细观察的人，基本会发现，每一个包目录下面都会有一个 `__init__.py` 的文件，为什么呢？ - -因为这个文件是必须的，否则，Python 就把这个目录当成普通目录，而不是一个包 。 `__init__.py` 可以是空文件，也可以有Python代码，因为 `__init__.py` 本身就是一个模块，而它对应的模块名就是它的包名。 - - diff --git a/Article/PythonBasis/python9/5.md b/Article/PythonBasis/python9/5.md deleted file mode 100644 index 93cc20e9..00000000 --- a/Article/PythonBasis/python9/5.md +++ /dev/null @@ -1,57 +0,0 @@ -# 五、作用域 # - -学习过 Java 的同学都知道，Java 的类里面可以给方法和属性定义公共的（ public ）或者是私有的 （ private ）,这样做主要是为了我们希望有些函数和属性能给别人使用或者只能内部使用。 - - 通过学习 Python 中的模块，其实和 Java 中的类相似，那么我们怎么实现在一个模块中，有的函数和变量给别人使用，有的函数和变量仅仅在模块内部使用呢？ - -在 Python 中，是通过 `_` 前缀来实现的。正常的函数和变量名是公开的（public），可以被直接引用，比如：abc，ni12，PI等；类似`__xxx__`这样的变量是特殊变量，可以被直接引用，但是有特殊用途，比如上面的 `__name__` 就是特殊变量，还有 `__author__` 也是特殊变量，用来标明作者。 - -注意，我们自己的变量一般不要用这种变量名；类似 `_xxx` 和 `__xxx` 这样的函数或变量就是非公开的（private），不应该被直接引用，比如 `_abc` ，`__abc` 等； - -**这里是说不应该，而不是不能。因为 Python 种并没有一种方法可以完全限制访问 private 函数或变量，但是，从编程习惯上不应该引用 private 函数或变量。** - -比如： - -```python -#!/usr/bin/env python3 -# -*- coding: UTF-8 -*- - -def _diamond_vip(lv): - print('尊敬的钻石会员用户，您好') - vip_name = 'DiamondVIP' + str(lv) - return vip_name - - -def _gold_vip(lv): - print('尊敬的黄金会员用户，您好') - vip_name = 'GoldVIP' + str(lv) - return vip_name - - -def vip_lv_name(lv): - if lv == 1: - print(_gold_vip(lv)) - elif lv == 2: - print(_diamond_vip(lv)) - - -vip_lv_name(2) - -``` - -输出的结果： - -```txt -尊敬的钻石会员用户，您好 -DiamondVIP2 -``` - -在这个模块中，我们公开 `vip_lv_name` 方法函数，而其他内部的逻辑分别在 `_diamond_vip` 和 `_gold_vip` private 函数中实现，因为是内部实现逻辑，调用者根本不需要关心这个函数方法，它只需关心调用 `vip_lv_name` 的方法函数，所以用 private 是非常有用的代码封装和抽象的方法 - -一般情况下，外部不需要引用的函数全部定义成 private，只有外部需要引用的函数才定义为 public。 - ------------------------- - -最后扯淡，欢迎加我微信：`thinktoday2019`, 进入微信 Python 讨论群。 - - diff --git a/Article/PythonBasis/python9/Preface.md b/Article/PythonBasis/python9/Preface.md deleted file mode 100644 index ba6b2563..00000000 --- a/Article/PythonBasis/python9/Preface.md +++ /dev/null @@ -1,9 +0,0 @@ -# 前言 # - -学习到这里，可以说 Python 基础学习基本接近尾声了。 - -# 目录 # - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-14-%E6%A8%A1%E5%9D%97%E4%B8%8E%E5%8C%85.png) - - diff --git "a/Article/advanced/Mac\344\270\255\344\275\277\347\224\250virtualenv\345\222\214virtualenvwrapper.md" "b/Article/advanced/Mac\344\270\255\344\275\277\347\224\250virtualenv\345\222\214virtualenvwrapper.md" deleted file mode 100644 index d67f0f71..00000000 --- "a/Article/advanced/Mac\344\270\255\344\275\277\347\224\250virtualenv\345\222\214virtualenvwrapper.md" +++ /dev/null @@ -1,140 +0,0 @@ - -## Virtualenv - -### 介绍 - -在使用 `Python` 开发的过程中，工程一多，难免会碰到不同的工程依赖不同版本的库的问题；亦或者是在开发过程中不想让物理环境里充斥各种各样的库，引发未来的依赖灾难。 - -因此，我们需要对于不同的工程使用不同的虚拟环境来保持开发环境以及宿主环境的清洁。而 `virtualenv`就是一个可以帮助我们管理不同 `Python` 环境的绝好工具。`virtualenv` 可以在系统中建立多个不同并且相互不干扰的虚拟环境。 - -### 安装 - -``` - pip3 install virtualenv -``` - -这样就成功了 - -### 使用 - -#### 创建 - -假如我们想要用`scrapy`去爬取某个网站的信息，我们不想再宿主环境总安装scrapy以及requests这些包，那我们就可以使用virtualenv了。 - -假设我们把这个虚拟环境放在`~/workspaces/project_env/spider/`目录下 - -``` - virtualenv ~/workspaces/project_env/spider/ -``` - -这样虚拟环境就创建好了，我们可以看到在这个目录下油三个目录被建立 - -* bin：包含一些在这个虚拟环境中可用的命令，以及开启虚拟环境的脚本 `activate` -* include：包含虚拟环境中的头文件，包括 `Python` 的头文件 -* lib：这里面就是一些依赖库 - -#### 激活 - -``` - source ~/workspaces/project_env/spider/bin/activate -``` - -此时我们就已经在虚拟环境中了 - -可以安装一下requests这个模块 - -``` - pip install requests -``` - -可以看到很快就成功 - -#### 退出虚拟环境 - -``` - deactivate -``` - -## virtualenvwrapper - -### 介绍 - -我们刚才了解了`virtualenv`，我觉得比较麻烦，每次开启虚拟环境之前要去虚拟环境所在目录下的 `bin` 目录下 `source`一下 `activate`，这就需要我们记住每个虚拟环境所在的目录。 - -一种可行的解决方案是，将所有的虚拟环境目录全都集中起来，比如放到 `~/virtualenvs/`，并对不同的虚拟环境使用不同的目录来管理。`virtualenvwrapper` 正是这样做的。并且，它还省去了每次开启虚拟环境时候的 `source` 操作，使得虚拟环境更加好用。 - -### 安装 - -``` - pip install virtualwrapper -``` - -这样我们就安装好了可以管理虚拟环境的神器 - -### 使用 - -#### 配置 - -首先需要对`virtualenvwrapper`进行配置: - -* 需要指定一个环境变量，叫做`WORKON_HOME`，它是用来存放各种虚拟环境目录的目录 -* 需要export vitualenvwrapper这个模块存放的位置 -* 需要运行一下它的初始化工具 `virtualenvwrapper.sh`，可通过`which virtualenvwrapper.sh`查看位置，我的在`/usr/local/bin/` - -由于每次都需要执行这两步操作，我们可以将其写入终端的配置文件中。 - -如果使用 `bash`，则添加到 `~/.bashrc` 中 - -如果使用 `zsh`，则添加到 `~/.zshrc` 中 - -这样每次启动终端的时候都会自动运行，终端启动之后 `virtualenvwrapper` 就可以用啦 - -``` - export WORKON_HOME='~/Workspaces/Envs' - - export VIRTUALENVWRAPPER_PYTHON=/usr/local/bin/python3 - - source /usr/local/bin/virtualenvwrapper.sh -``` - - -**创建虚拟机** - -``` -mkvirtualenv env -``` - -创建虚拟环境完成后，会自动切换到创建的虚拟环境中 - -当然也可以指定虚拟机的 python 版本 - -``` -mkvirtualenv env -p C:\python27\python.exe -``` - -**列出虚拟环境列表** - -``` -workon 或者 lsvirtualenv -``` - -**启动/切换虚拟环境** - -使用 workon [virtual-name] 即可切换到对应的虚拟环境 - -``` -workon [虚拟环境名称] -``` - - -**删除虚拟环境** - -``` -rmvirtualenv [虚拟环境名称] -``` - -**离开虚拟环境，和 virutalenv 一样的命令** - -``` -deactivate -``` diff --git "a/Article/advanced/Python\345\256\236\347\216\260\346\224\266\345\217\221\351\202\256\344\273\266.md" "b/Article/advanced/Python\345\256\236\347\216\260\346\224\266\345\217\221\351\202\256\344\273\266.md" deleted file mode 100644 index 5945b1e1..00000000 --- "a/Article/advanced/Python\345\256\236\347\216\260\346\224\266\345\217\221\351\202\256\344\273\266.md" +++ /dev/null @@ -1,66 +0,0 @@ -在实际开发中，当你收到一个需求的时候，比如要做一个「收发邮件」的功能。 - -如果你完全没有印象，没有思路，可以直接 Google 搜索的。 - -因为我们不可能对每个知识点都了解，不了解不可耻，但要懂得怎么去找资料了解。 - -强调一下， - -用 Google 搜索。 - -用 Google 搜索。 - -用 Google 搜索。 - -恕我直言，百度搜索是真的辣鸡。 - -那我们怎么去找资料呢？ - -首先我们可以直接 Google 「Python 收发邮件」，就可以得到这么一个结果。 - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-15-065554.png) - -这种常用的需求，基本只要看前几个就能知道大概的思路了。 - -可以看到，用 Python 实现邮件的收发，主要用到 smtplib 和 email这两个模块。 - - -至于这些模块怎么用，直接看 [Python 官方文档](https://docs.python.org/3.7/library/smtplib.html?highlight=smtplib) - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-15-065957.png) - -真的，没有任何教程比官方文档资料还全。 - -不过我们可以总结一下这些内容。 - -**1、SMTP 发送邮件** - -Python 发送邮件主要步骤如下： - -* `import smtplib` - - 导入 `smtplib` 模块，主要用于构造传输服务的 -* `server = smtplib.SMTP()` - - SMTP 是 smtplib 模块中的一个类（class），实例化这个类，方便我们调用他里面的方法。 - - SMTP (Simple Mail Transfer Protocol)翻译过来是“简单邮件传输协议”的意思，SMTP 协议是由源服务器到目的地服务器传送邮件的一组规则。 -* `server.connect(host, port)` - - 连接（connect）指定的服务器 - - host 是指定连接的邮箱服务器，你可以指定服务器的域名。 - - port 服务器的端口号 - - 这些怎么找到，好比 qq 邮箱，在「设置」那里就有相关的开关和说明。 - - ![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-15-090427.png) - - 点相关的说明，你就能看到对应的服务器地址和端口号了 - - ![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-10-15-090619.png) -* `server.login(username, password)` - - 登录的账号密码 -* `server.sendmail(from_addr, to_addr, msg)` - - 发送邮件，发送邮件一般是谁发给了谁，发送了什么？总结为也就是三个参数，发送者，接受者，发送邮件的内容。 - - from_addr：邮件发送地址 - - to_addr：邮件收件人地址 - - msg ： 发送邮件的内容，邮件内容需要用到 `email` 模块。通过 `email` 模块我们可以定义邮件的主题，收件人信息，发件人信息等等。 -* `server.quit()` - - 退出服务 - - 直接看下例子，给 QQ 邮箱发送一个邮件： - - - diff --git a/Article/advanced/advanced.md b/Article/advanced/advanced.md deleted file mode 100644 index 37af8d02..00000000 --- a/Article/advanced/advanced.md +++ /dev/null @@ -1,2 +0,0 @@ -* [使用Python虚拟环境](/Article/advanced/使用Python虚拟环境.md) -* [Mac中使用virtualenv和virtualenvwrapper](/Article/advanced/Mac中使用virtualenv和virtualenvwrapper.md) diff --git "a/Article/advanced/\344\275\277\347\224\250Python\350\231\232\346\213\237\347\216\257\345\242\203.md" "b/Article/advanced/\344\275\277\347\224\250Python\350\231\232\346\213\237\347\216\257\345\242\203.md" deleted file mode 100644 index c7eddae1..00000000 --- "a/Article/advanced/\344\275\277\347\224\250Python\350\231\232\346\213\237\347\216\257\345\242\203.md" +++ /dev/null @@ -1,130 +0,0 @@ -python 的虚拟环境可以为一个 python 项目提供独立的解释环境、依赖包等资源，既能够很好的隔离不同项目使用不同 python 版本带来的冲突，而且还能方便项目的发布。 - -# virtualenv # - -[virtualenv](http://pypi.python.org/pypi/virtualenv)可用于创建独立的 Python 环境，它会创建一个包含项目所必须要的执行文件。 - -**安装 virtualenv** - -``` -$ pip install virtualenv -``` - - -**配置 pip 安装第三方库的镜像源地址** - -我们都知道，国内连接国外的服务器都会比较慢，有时候设置下载经常出现超时的情况。这时可以尝试使用国内优秀的[豆瓣源](https://pypi.douban.com/simple)镜像来安装。 - -使用豆瓣源安装 virtualenv - -``` -pip install -i https://pypi.douban.com/simple virtualenv -``` - -**virtualenv使用方法** - -如下命令表示在当前目录下创建一个名叫 env 的目录（虚拟环境），该目录下包含了独立的 Python 运行程序,以及 pip副本用于安装其他的 packge - -``` -virtualenv env -``` - - -当然在创建 env 的时候可以选择 Python 解释器，例如： - -``` -virtualenv -p /usr/local/bin/python3 venv -``` - -默认情况下，虚拟环境会依赖系统环境中的 site packages，就是说系统中已经安装好的第三方 package 也会安装在虚拟环境中，如果不想依赖这些 package，那么可以加上参数 `--no-site-packages` 建立虚拟环境 - -``` -virtualenv --no-site-packages [虚拟环境名称] -``` - -**启动虚拟环境** - -``` -cd ENV -source ./bin/activate -``` - -注意此时命令行会多一个`(ENV)`，ENV为虚拟环境名称，接下来所有模块都只会安装到这个虚拟的环境中去。 - -**退出虚拟环境** - -``` -deactivate -``` - -如果想删除虚拟环境，那么直接运行`rm -rf venv/`命令即可。 - -**在虚拟环境安装 Python packages** - -Virtualenv 附带有 pip 安装工具，因此需要安装的 packages 可以直接运行： - -``` -pip install [套件名称] -``` - -# Virtualenvwrapper - -Virtualenvwrapper 是一个虚拟环境管理工具，它能够管理创建的虚拟环境的位置，并能够方便地查看虚拟环境的名称以及切换到指定的虚拟环境。 - - -**安装（确保virtualenv已经安装）** - -``` -pip install virtualenvwrapper -``` - -或者使用豆瓣源 - -``` -pip install -i https://pypi.douban.com/simple virtualenvwrapper-win -``` - -注： - -安装需要在非虚拟环境下进行 - -**创建虚拟机** - -``` -mkvirtualenv env -``` - -创建虚拟环境完成后，会自动切换到创建的虚拟环境中 - -当然也可以指定虚拟机的 python 版本 - -``` -mkvirtualenv env -p C:\python27\python.exe -``` - -**列出虚拟环境列表** - -``` -workon 或者 lsvirtualenv -``` - -**启动/切换虚拟环境** - -使用 workon [virtual-name] 即可切换到对应的虚拟环境 - -``` -workon [虚拟环境名称] -``` - - -**删除虚拟环境** - -``` -rmvirtualenv [虚拟环境名称] -``` - -**离开虚拟环境，和 virutalenv 一样的命令** - -``` -deactivate -``` diff --git a/Article/codeSpecification/codeSpecification_Preface.md b/Article/codeSpecification/codeSpecification_Preface.md deleted file mode 100644 index 59911c8b..00000000 --- a/Article/codeSpecification/codeSpecification_Preface.md +++ /dev/null @@ -1,10 +0,0 @@ -# 前言 # - -本来不应该把这个章节放在那面前面的，因为还没进行学习之前，直接看这个章节，会感觉有很多莫名其妙的东西。 - -但是把这个章节放在前面的用意，只是让大家预览一下，有个印象，而且在以后的学习中，也方便大家查阅。 - -# 目录 # - -![](http://twowaterimage.oss-cn-beijing.aliyuncs.com/2019-07-20-Python%E4%BB%A3%E7%A0%81%E8%A7%84%E8%8C%83.png) - diff --git a/Article/codeSpecification/codeSpecification_first.md b/Article/codeSpecification/codeSpecification_first.md deleted file mode 100644 index 5f3faa6e..00000000 --- a/Article/codeSpecification/codeSpecification_first.md +++ /dev/null @@ -1,257 +0,0 @@ -# 一、简明概述 - -## 1、编码 - -* 如无特殊情况, 文件一律使用 UTF-8 编码 -* 如无特殊情况, 文件头部必须加入`#-*-coding:utf-8-*-`标识 - -## 2、代码格式 - -### 2.1、缩进 - -* 统一使用 4 个空格进行缩进 - -### 2.2、行宽 - -每行代码尽量不超过 80 个字符(在特殊情况下可以略微超过 80 ，但最长不得超过 120) - -理由： - -* 这在查看 side-by-side 的 diff 时很有帮助 -* 方便在控制台下查看代码 -* 太长可能是设计有缺陷 - -### 2.3、引号 - -简单说，自然语言使用双引号，机器标示使用单引号，因此 __代码里__ 多数应该使用 __单引号__ - - * ***自然语言*** **使用双引号** `"..."` - 例如错误信息；很多情况还是 unicode，使用`u"你好世界"` - * ***机器标识*** **使用单引号** `'...'` - 例如 dict 里的 key - * ***正则表达式*** **使用原生的双引号** `r"..."` - * ***文档字符串 (docstring)*** **使用三个双引号** `"""......"""` - -### 2.4、空行 - -* 模块级函数和类定义之间空两行； -* 类成员函数之间空一行； - -```python -class A: - - def __init__(self): - pass - - def hello(self): - pass - - -def main(): - pass -``` - -* 可以使用多个空行分隔多组相关的函数 -* 函数中可以使用空行分隔出逻辑相关的代码 - - -## 3、import 语句 - -* import 语句应该分行书写 - -```python -# 正确的写法 -import os -import sys - -# 不推荐的写法 -import sys,os - -# 正确的写法 -from subprocess import Popen, PIPE -``` -* import语句应该使用 __absolute__ import - -```python -# 正确的写法 -from foo.bar import Bar - -# 不推荐的写法 -from ..bar import Bar -``` - -* import语句应该放在文件头部，置于模块说明及docstring之后，于全局变量之前； -* import语句应该按照顺序排列，每组之间用一个空行分隔 - -```python -import os -import sys - -import msgpack -import zmq - -import foo -``` - -* 导入其他模块的类定义时，可以使用相对导入 - -```python -from myclass import MyClass -``` - -* 如果发生命名冲突，则可使用命名空间 - -```python -import bar -import foo.bar - -bar.Bar() -foo.bar.Bar() -``` - -## 4、空格 - -* 在二元运算符两边各空一格`[=,-,+=,==,>,in,is not, and]`: - -```python -# 正确的写法 -i = i + 1 -submitted += 1 -x = x * 2 - 1 -hypot2 = x * x + y * y -c = (a + b) * (a - b) - -# 不推荐的写法 -i=i+1 -submitted +=1 -x = x*2 - 1 -hypot2 = x*x + y*y -c = (a+b) * (a-b) -``` - -* 函数的参数列表中，`,`之后要有空格 - -```python -# 正确的写法 -def complex(real, imag): - pass - -# 不推荐的写法 -def complex(real,imag): - pass -``` - -* 函数的参数列表中，默认值等号两边不要添加空格 - -```python -# 正确的写法 -def complex(real, imag=0.0): - pass - -# 不推荐的写法 -def complex(real, imag = 0.0): - pass -``` - -* 左括号之后，右括号之前不要加多余的空格 - -```python -# 正确的写法 -spam(ham[1], {eggs: 2}) - -# 不推荐的写法 -spam( ham[1], { eggs : 2 } ) -``` - -* 字典对象的左括号之前不要多余的空格 - -```python -# 正确的写法 -dict['key'] = list[index] - -# 不推荐的写法 -dict ['key'] = list [index] -``` - -* 不要为对齐赋值语句而使用的额外空格 - -```python -# 正确的写法 -x = 1 -y = 2 -long_variable = 3 - -# 不推荐的写法 -x = 1 -y = 2 -long_variable = 3 -``` - -## 5、换行 - -Python 支持括号内的换行。这时有两种情况。 - -1) 第二行缩进到括号的起始处 - -```python -foo = long_function_name(var_one, var_two, - var_three, var_four) -``` - -2) 第二行缩进 4 个空格，适用于起始括号就换行的情形 - -```python -def long_function_name( - var_one, var_two, var_three, - var_four): - print(var_one) -``` - -使用反斜杠`\`换行，二元运算符`+` `.`等应出现在行末；长字符串也可以用此法换行 - -```python -session.query(MyTable).\ - filter_by(id=1).\ - one() - -print 'Hello, '\ - '%s %s!' %\ - ('Harry', 'Potter') -``` - -禁止复合语句，即一行中包含多个语句： - -```python -# 正确的写法 -do_first() -do_second() -do_third() - -# 不推荐的写法 -do_first();do_second();do_third(); -``` - -`if/for/while`一定要换行： - -```python -# 正确的写法 -if foo == 'blah': - do_blah_thing() - -# 不推荐的写法 -if foo == 'blah': do_blash_thing() -``` - -## 6、docstring -docstring 的规范中最其本的两点： - -1. 所有的公共模块、函数、类、方法，都应该写 docstring 。私有方法不一定需要，但应该在 def 后提供一个块注释来说明。 -2. docstring 的结束"""应该独占一行，除非此 docstring 只有一行。 - -```python -"""Return a foobar -Optional plotz says to frobnicate the bizbaz first. -""" - -"""Oneline docstring""" -``` diff --git a/Article/codeSpecification/codeSpecification_second.md b/Article/codeSpecification/codeSpecification_second.md deleted file mode 100644 index ae4af9ec..00000000 --- a/Article/codeSpecification/codeSpecification_second.md +++ /dev/null @@ -1,128 +0,0 @@ -# 二、注释 - -## 1、注释 - -### 1.1、块注释 -“#”号后空一格，段落件用空行分开（同样需要“#”号） - -```python -# 块注释 -# 块注释 -# -# 块注释 -# 块注释 -``` - -### 1.2、行注释 -至少使用两个空格和语句分开，注意不要使用无意义的注释 - -```python -# 正确的写法 -x = x + 1 # 边框加粗一个像素 - -# 不推荐的写法(无意义的注释) -x = x + 1 # x加1 -``` - -### 1.3、建议 - -* 在代码的关键部分(或比较复杂的地方), 能写注释的要尽量写注释 - -* 比较重要的注释段, 使用多个等号隔开, 可以更加醒目, 突出重要性 - -```python -app = create_app(name, options) - - -# ===================================== -# 请勿在此处添加 get post等app路由行为 !!! -# ===================================== - - -if __name__ == '__main__': - app.run() -``` - -## 2、文档注释（Docstring） -作为文档的Docstring一般出现在模块头部、函数和类的头部，这样在python中可以通过对象的\_\_doc\_\_对象获取文档. -编辑器和IDE也可以根据Docstring给出自动提示. - -* 文档注释以 """ 开头和结尾, 首行不换行, 如有多行, 末行必需换行, 以下是Google的docstring风格示例 - -```python -# -*- coding: utf-8 -*- -"""Example docstrings. - -This module demonstrates documentation as specified by the `Google Python -Style Guide`_. Docstrings may extend over multiple lines. Sections are created -with a section header and a colon followed by a block of indented text. - -Example: - Examples can be given using either the ``Example`` or ``Examples`` - sections. Sections support any reStructuredText formatting, including - literal blocks:: - - $ python example_google.py - -Section breaks are created by resuming unindented text. Section breaks -are also implicitly created anytime a new section starts. -""" -``` - -* 不要在文档注释复制函数定义原型, 而是具体描述其具体内容, 解释具体参数和返回值等 - -```python -# 不推荐的写法(不要写函数原型等废话) -def function(a, b): - """function(a, b) -> list""" - ... ... - - -# 正确的写法 -def function(a, b): - """计算并返回a到b范围内数据的平均值""" - ... ... -``` - -* 对函数参数、返回值等的说明采用numpy标准, 如下所示 - -```python -def func(arg1, arg2): - """在这里写函数的一句话总结(如: 计算平均值). - - 这里是具体描述. - - 参数 - ---------- - arg1 : int - arg1的具体描述 - arg2 : int - arg2的具体描述 - - 返回值 - ------- - int - 返回值的具体描述 - - 参看 - -------- - otherfunc : 其它关联函数等... - - 示例 - -------- - 示例使用doctest格式, 在`>>>`后的代码可以被文档测试工具作为测试用例自动运行 - - >>> a=[1,2,3] - >>> print [x + 3 for x in a] - [4, 5, 6] - """ -``` - - -* 文档注释不限于中英文, 但不要中英文混用 - -* 文档注释不是越长越好, 通常一两句话能把情况说清楚即可 - -* 模块、公有类、公有方法, 能写文档注释的, 应该尽量写文档注释 - - diff --git a/Article/codeSpecification/codeSpecification_third.md b/Article/codeSpecification/codeSpecification_third.md deleted file mode 100644 index 4217d6ee..00000000 --- a/Article/codeSpecification/codeSpecification_third.md +++ /dev/null @@ -1,82 +0,0 @@ -# 三、命名规范 - -## 1、模块 -* 模块尽量使用小写命名，首字母保持小写，尽量不要用下划线(除非多个单词，且数量不多的情况) - -```python -# 正确的模块名 -import decoder -import html_parser - -# 不推荐的模块名 -import Decoder -``` - -## 2、类名 -* 类名使用驼峰(CamelCase)命名风格，首字母大写，私有类可用一个下划线开头 - -```Python -class Farm(): - pass - -class AnimalFarm(Farm): - pass - -class _PrivateFarm(Farm): - pass -``` - -* 将相关的类和顶级函数放在同一个模块里. 不像Java, 没必要限制一个类一个模块. - -## 3、函数 - -* 函数名一律小写，如有多个单词，用下划线隔开 - -```python -def run(): - pass - -def run_with_env(): - pass -``` - -* 私有函数在函数前加一个下划线_ - -```python -class Person(): - - def _private_func(): - pass -``` - -## 4、变量名 - -* 变量名尽量小写, 如有多个单词，用下划线隔开 - -```python -if __name__ == '__main__': - count = 0 - school_name = '' -``` - -* 常量采用全大写，如有多个单词，使用下划线隔开 - -```python -MAX_CLIENT = 100 -MAX_CONNECTION = 1000 -CONNECTION_TIMEOUT = 600 -``` - -## 5、常量 ## - -* 常量使用以下划线分隔的大写命名 - -```python -MAX_OVERFLOW = 100 - -Class FooBar: - - def foo_bar(self, print_): - print(print_) - -``` \ No newline at end of file diff --git a/Article/django/Django.md b/Article/django/Django.md deleted file mode 100644 index 7d79dfd6..00000000 --- a/Article/django/Django.md +++ /dev/null @@ -1,12 +0,0 @@ -# Django - -Python 下有许多款不同的 Web 框架。Django 是重量级选手中最有代表性的一位。许多成功的网站和 APP 都基于 Django。 - -如果对自己的基础有点信息的童鞋，可以尝试通过国外的 ![Django 博客从搭建到部署系列教程](https://simpleisbetterthancomplex.com/series/2017/09/04/a-complete-beginners-guide-to-django-part-1.html) 进行入门，这个教程讲的非常的详细，而且还有很多有趣的配图。不过可能因为墙的原因，很多人会访问不到，就算访问到了，也因为是英语的，不会进行耐心的阅读学习。因此我打算翻译这个教程。 - -* [一个完整的初学者指南Django-part1](/Article/django/一个完整的初学者指南Django-part1.md) -* [一个完整的初学者指南Django-part2](/Article/django/一个完整的初学者指南Django-part2.md) - -后面经一个朋友说，这个教程已经有人在翻译了，因此我也不翻译了，不过感觉我的翻译还是挺好的，因为不是直译的，是通过了解后，用自己的语言再次表达出来。 - -这里有上面这个教程翻译计划的 [Github](https://github.com/wzhbingo/django-beginners-guide) 以及 [博客](https://www.cloudcrossing.xyz/post/20/)，觉得哪个看得舒服，就选哪个进行学习。 diff --git "a/Article/django/\344\270\200\344\270\252\345\256\214\346\225\264\347\232\204\345\210\235\345\255\246\350\200\205\346\214\207\345\215\227Django-part1.md" "b/Article/django/\344\270\200\344\270\252\345\256\214\346\225\264\347\232\204\345\210\235\345\255\246\350\200\205\346\214\207\345\215\227Django-part1.md" deleted file mode 100644 index 8e4c73d4..00000000 --- "a/Article/django/\344\270\200\344\270\252\345\256\214\346\225\264\347\232\204\345\210\235\345\255\246\350\200\205\346\214\207\345\215\227Django-part1.md" +++ /dev/null @@ -1,472 +0,0 @@ ->源自：https://simpleisbetterthancomplex.com/series/2017/09/04/a-complete-beginners-guide-to-django-part-1.html - -### 一个完整的初学者指南Django - 第1部分 - - ![一个完整的初学者指南Django - 第1部分](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-1/featured.jpg) - - - ![Python 3.6.2](https://img.shields.io/badge/python-3.6.2-brightgreen.svg) ![Django 1.11.4](https://img.shields.io/badge/django-1.11.4-brightgreen.svg) - - -#### 介绍 - -![欢迎班](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-1/Pixton_Comic_Welcome_Class.png) - - -今天我将开始一个关于 Django 基础知识的新系列教程。这是一个完整的 Django 初学者指南。材料分为七个部分。我们将从安装，开发环境准备，模型，视图，模板，URL 到更高级主题（如迁移，测试和部署）来探索所有基本概念。 - - -我想做一些不同的事情。一个教程，易于遵循，信息丰富和有趣的阅读。因此我想出了在文章中创建一些漫画的想法来说明一些概念和场景。希望你喜欢这种阅读方式！ - - -但在我们开始之前...... - - -我想通过孔夫子的名言来开始我们的课程： - -> 我听见了，我就忘了 -> -> 我看见了，我就记得了 -> -> 我去做了，我就理解了 - -![孔子名言](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-1/Pixton_Comic_Confucius_Quote.png) - -所以，一定要动手！不要只阅读教程。让我们一起来实操，这样你将通过做和练会学习到更多的知识。 - -* * * - -#### 为什么选择 Django？ - - -Django 是一个用 Python 编写的 Web 框架。这个 Web 框架支持动态网站，应用程序和服务开发。它提供了一组工具和功能，可解决许多与 Web 开发相关的常见问题，例如安全功能，数据库访问，会话，模板处理，URL 路由，国际化，本地化等等。 - - -使用诸如 Django 之类的 Web 框架，能使我们能够以标准化的方式快速开发安全可靠的Web 应用程序，从而无需重新开发。 - - -那么，Django 有什么特别之处呢？ - -对于初学者来说，这是一个 Python Web 开源框架，这意味着您可以从各种各样的开源库中受益。在[python软件资料库(pypi)](https://pypi.python.org/pypi) 中托管了超过 **11.6万** 个的包（按照 2017 年 9 月 6 日的数据）。如果你需要解决一个特定问题的时候，可能已经有相关的库给你使用。 - -Django 是用 Python 编写的最流行的 Web 框架之一。它可以提供各种功能，例如用于开发和测试的独立 Web 服务器，缓存，中间件系统，ORM，模板引擎，表单处理，基于 Python 单元测试工具的接口。Django 还附带了电池，提供内置应用程序，如认证系统，具有自动生成`CRUD`(增删改除)操作页面的管理界面，生成订阅文档（RSS / Atom），站点地图等。甚至在 Django 中建立了一个地理信息系统（GIS）框架。 - -而且 Django 的开发得到了 [Django软件基金会的](https://www.djangoproject.com/foundation/)支持，并且由 JetBrains 和 Instagram 等公司赞助。Django 到目前为止，已经持续开发维护超过12年了，这足以证明它是一个成熟，可靠和安全的 Web 框架。 - -##### 谁在使用Django？ - -为什么要知道谁在使用 Django 呢？ - -因为这能很好的让我们了解和知道它能做些什么？ - -在使用 Django 的最大网站中，有：[Instagram](https://instagram.com/)， [Disqus](https://disqus.com/)，[Mozilla](https://www.mozilla.org/)， [Bitbucket](https://bitbucket.org/)，[Last.fm](https://www.last.fm/)， [National Geographic](http://www.nationalgeographic.com/)。 - -当然，远远不止上面列举的这些，你可以看下 [Django Sites](https://www.djangosites.org/) 数据库，它们提供了超过 **5000** 个 Django 支持的 Web站点的列表。 - -顺便说一下，去年在 Django Under The Hood 2016 大会上，Django 核心开发人员Carl Meyer 和 Instagram 员工就[如何在规模上使用Django](https://www.youtube.com/watch?v=lx5WQjXLlq8) 以及它如何支持其增长展开了一次演讲。这是一个长达一个小时的谈话，如果你有兴趣的话，可以去了解下。 - - -* * * - -#### 安装 - -如果我们想开始使用 Django ，那么我们需要安装一些应用程序，包括安装 **Python**，**Virtualenv** 和 **Django**。 - -![基本设置](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-1/Pixton_Comic_Basic_Setup.png) - - -一开始，强烈建议使用虚拟环境，虽然不是强制性的，可是这对于初学者来说，是一个很好的开端. - - -在使用 Django 开发 Web 站点或 Web 项目时，必须安装外部库以支持开发是非常常见的。使用虚拟环境，您开发的每个项目都会有其独立的环境。所以依赖关系不会发生冲突。它还允许您维护在不同 Django 版本上运行的本地计算机项目。 - - -##### 安装Python 3.6.2 - -我们想要做的第一件事是安装最新的 Python 发行版，它是 **Python 3.6.2**。至少在我写这篇教程的时候是这样。如果有更新的版本，请与它一起使用。接下来的步骤应该保持大致相同。 - -我们将使用 Python 3，因为最重要的 Python 库已经移植到 Python 3，并且下一个主要的 Django 版本（2.x）不再支持 Python 2。所以 Python 3 是很有必要的。 - -在 Mac 中，最好的安装方法就是 [Homebrew](https://brew.sh/)。如果您还没有在Mac 上安装它，请在 **终端** 运行以下命令： - -``` -/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" -``` - -如果您没有安装**命令行工具`(Command Line Tools)`**，则 Homebrew 安装可能需要更长一点时间。但它会自动处理，所以不用担心。请坐下来等到安装完成。 - -当您看到以下消息时，您会知道安装何时完成： - - -``` -==> Installation successful! - -==> Homebrew has enabled anonymous aggregate user behaviour analytics. -Read the analytics documentation (and how to opt-out) here: - https://docs.brew.sh/Analytics.html - -==> Next steps: -- Run `brew help` to get started -- Further documentation: - https://docs.brew.sh -``` - -请运行以下命令来安装Python 3： - -``` -brew install python3 -``` - - -由于 macOS 已经安装了Python 2，所以在安装 Python 3 之后，您将可以使用这两个版本。 - -要运行 Python 2，请使用`python`终端中的命令。对于 Python 3，请`python3`改用。 - -我们可以通过在终端中输入来测试安装： - -``` -python3 --version -Python 3.6.2 -``` - -![macOS测试Python 3](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-1/mac/test-python.png) - -到此时，Python 已经安装完成了。进入下一步：虚拟环境！ - -##### 安装 Virtualenv - -接下来这一步，我们将通过 **pip**(一个管理和安装Python包的工具)来安装**Virtualenv**。 - - -请注意，Homebrew 已经为您的 Python 3.6.2 安装了 `pip3`。 - -在终端中，执行下面的命令： - -``` -sudo pip3 install virtualenv -``` - -![pip3安装virtualenv](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-1/mac/pip-virtualenv.png) - - -到目前为止，我们执行的操作都是在系统环境下的。不过，从这一刻起，我们安装的所有东西，包括 Django 本身，都将安装在虚拟环境中。 - - -你可以这样想像一下：对于每个 diango 项目，我们都会为它创建一个虚拟环境。这就好比每个 Django 项目都是一个独立的沙盒，你可以在这个沙盒里随意的玩，安装软件包，卸载软件包，不管怎么对系统环境都不会有任何影响，也不会对其他项目有影响。 - - -我个人喜欢在我的电脑上创建一个 **Development** 的文件夹，然后在这个文件夹下存放我的所有项目。当然，你也可以根据下面的步骤来创建你个人的目录。 - - -通常，我会在我的 **Development** 文件夹中创建一个项目名称的新文件夹。竟然这是我们的第一个项目，就直接将项目名称起为 **myproject**。 - -``` -mkdir myproject -cd myproject -``` - -![创建myproject文件夹](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-1/mac/myproject.png) - - -该文件夹将存储与 Django 项目相关的所有文件，包括其虚拟环境。 - -接下来，我们将开始创建我们第一个虚拟环境和安装 Django。 - -在 **myproject** 文件夹中，我们创建一个基于 python 3 的虚拟环境。 - -``` -virtualenv venv -p python3 -``` - -![VIRTUALENV](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-1/mac/venv.png) - -如上图所示，我们的虚拟环境已创建完成。那么我们将如何使用它呢？ - - -当然，我们先开启虚拟环境啦，可以通过以下命令来激活一下虚拟环境： - - - ``` - source venv/bin/activate - ``` - -如果你在命令行的前面看到 **（venv）**，就说明，虚拟环境激活成功，现在已经进入到虚拟环境里面了。如下图所示： - - -![Virtualenv激活](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-1/mac/activate.png) - - -那么这里面到底发生了什么呢？ - - -其实这里我们首先创建了名为 **venv** 的特殊文件夹，这个文件夹里面有 python 的副本，当我们激活 **venv** 环境之后，运行 `Python` 命令时，它使用的是存储在 **venv** 里面 `Python` 环境 ，而不是我们装在操作系统上的。 - - -如果在该环境下，我们使用 **PIP** 安装 python 软件包，比如 Django ，那么它是被安装在 **venv** 的虚拟环境上的。 - - -这里有一点需要注意的，当我们启动了 **venv** 这个虚拟环境后，我们使用命令 `python` 就能调用 python 3.6.2 ，而且也仅仅使用 `pip`（而不是`pip3`）来安装软件包。 - - -那么如果我们想退出 **venv** 虚拟环境，该如何操作呢？ - -只要运行以下命令就可以： - -``` -deactivate -``` - -不过，现在我们先不退出虚拟环境 **venv** ，保持着虚拟环境的激活状态，开始下一步操作。 - - - - -##### 安装Django 1.11.4 - -现在我们来安装以下 Django 1.11.4 ，因为我们已经开启了虚拟环境 **venv** ，因此，这操作会非常的简单。我们将运行下面的命令来安装 Django ： - -``` -pip install django -``` - -![pip安装django](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-1/mac/pip-django.png) - - -安装成功了，现在一切都准备就绪了！ - - -![结束安装](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-1/Pixton_Comic_End_Installation.png) - -* * * - -#### 开始一个新项目 - -要开始一个新的 Django项目，运行下面的命令： - -到目前为止，我们终于可以开始一个新的 Django 项目了，运行下面的命令，创建一个 Django 项目： - -``` -django-admin startproject myproject -``` - -命令行工具 **django-admin** 会在安装 Django 的时候一起安装的。 - - -当我们运行了上面的命令之后，系统就会自动的为 Django 项目生成基础的文件。 - - -我们可以打开 **myproject** 目录，可以看到具体的文件结构如下所示： - - -``` -myproject/ <-- higher level folder - |-- myproject/ <-- django project folder - | |-- myproject/ - | | |-- __init__.py - | | |-- settings.py - | | |-- urls.py - | | |-- wsgi.py - | +-- manage.py - +-- venv/ <-- virtual environment folder -``` - - -可以看到，一个初始 Django 的项目由五个文件组成： - - -* **manage.py**：**django-admin** 是命令行工具的快捷方式。它用于运行与我们项目相关的管理命令。我们将使用它来运行开发服务器，运行测试，创建迁移等等。 -* **__init__.py**：这个空文件告诉 Python 这个文件夹是一个 Python 包。 -* **settings.py**：这个文件包含了所有的项目配置。我们会一直使用到这个文件。 -* **urls.py**：这个文件负责映射我们项目中的路由和路径。例如，如果您想在 URL `/about/` 中显示某些内容，则必须先将其映射到此处。 -* **wsgi.py**：该文件是用于部署简单的网关接口。现在我们暂时不用关心它的内容。 - - - -Django 自带有一个简单的 Web 服务器。在开发过程中非常方便，所以我们不需要安装其他任何软件即可以在本地运行项目。我们可以通过执行命令来运行它： - -``` -python manage.py runserver -``` - - -现在在 Web 浏览器中打开以下 URL：**http://127.0.0.1:8000**，您应该看到以下页面： - - -![有效！](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-1/it-worked.png) - - -这里提醒一点，如果你需要停止服务器，可以 `Control + C` 点击停止开发服务器。 - -* * * - -#### Django 的应用 - - -在 Django 哲学中，我们有两个重要的概念： - -* **app**：是一个可以执行某些操作的 Web 应用程序。一个应用程序通常由一组 models(数据库表)，views(视图)，templates(模板)，tests(测试) 组成。 -* **project**：是配置和应用程序的集合。一个项目可以由多个应用程序或一个应用程序组成。 - -请注意，如果没有一个 project，你就无法运行 Django 应用程序。像博客这样的简单网站可以完全在单个应用程序中编写，例如可以将其命名为 blog或 weblog。 - -![Django应用程序](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-1/Pixton_Comic_Django_Apps.png) - - -当然这是组织源代码的一种方式，现在刚入门，判断确定什么是不是应用程序这些还不太重要。包括如何组织代码等，现在都不是担心这些问题的时候。现在，首先让我们先熟悉了解 Django 的 API 和基础知识。 - -好了，为了更好的了解，我们先来创建一个简单的论坛项目，那么我们要创建一个应用程序，首先要进入到 **manage.py** 文件所在的目录并执行以下命令： - -``` -django-admin startapp boards -``` - - -请注意，这次我们使用了命令 **startapp**。 - -这会给我们以下的目录结构： - -``` -myproject/ - |-- myproject/ - | |-- boards/ <-- our new django app! - | | |-- migrations/ - | | | +-- __init__.py - | | |-- __init__.py - | | |-- admin.py - | | |-- apps.py - | | |-- models.py - | | |-- tests.py - | | +-- views.py - | |-- myproject/ - | | |-- __init__.py - | | |-- settings.py - | | |-- urls.py - | | |-- wsgi.py - | +-- manage.py - +-- venv/ -``` - - -所以，我们先来看看每个文件的功能： - -* **migrations /**：在这个文件夹中，Django 会存储一些文件以跟踪您在 **models.py** 文件中创建的更改，目的是为了保持数据库和 **models.py** 同步。 -* **admin.py**：这是 Django应用程序一个名为 **Django Admin** 的内置配置文件。 -* **apps.py**：这是应用程序本身的配置文件。 -* **models.py**：这里是我们定义 Web 应用程序实体的地方。models 由 Django 自动转换为数据库表。 -* **tests.py**：该文件用于为应用程序编写单元测试。 -* **views.py**：这是我们处理Web应用程序请求(request)/响应(resopnse)周期的文件。 - -现在我们创建了我们的第一个应用程序，让我们来配置一下项目以便启用这个应用程序。 - - -为此，请打开**settings.py**并尝试查找`INSTALLED_APPS`变量： - -**settings.py** - -``` -INSTALLED_APPS = [ - 'django.contrib.admin', - 'django.contrib.auth', - 'django.contrib.contenttypes', - 'django.contrib.sessions', - 'django.contrib.messages', - 'django.contrib.staticfiles', -] -``` - -正如你所看到的，Django 已经安装了6个内置的应用程序。它们提供大多数Web应用程序所需的常用功能，如身份验证，会话，静态文件管理（图像，JavaScript，CSS等）等。 - -我们将会在本系列教程中探索这些应用程序。但现在，先不管它们，只需将我们的应用程序 boards 添加到 `INSTALLED_APPS` 列表即可： - -``` -INSTALLED_APPS = [ - 'django.contrib.admin', - 'django.contrib.auth', - 'django.contrib.contenttypes', - 'django.contrib.sessions', - 'django.contrib.messages', - 'django.contrib.staticfiles', - - 'boards', -] -``` - -使用上个漫画中的正方形和圆形的比喻，黄色圆圈将成为我们的 **boards** 应用程序，而 **django.contrib.admin**，**django.contrib.auth** 等将成为红色圆圈。 - -* * * - -#### Hello, World! - - -现在我们先来写一个我们的第一个 **视图（view）** ，那么，现在我们来看看该如何使用 Django 来创建一个新的页面吧。 - - -打开 **boards** 应用程序中的 **views.py** 文件，并添加下面的代码： - -**views.py** - -```python -from django.http import HttpResponse - -def home(request): - return HttpResponse('Hello, World!') -``` - -**视图（view）** 是接收 `HttpRequest` 对象并返回 `HttpResponse`对象的 Python 函数。接收 request 作为参数并返回 response 作为结果。这个过程是需要我们记住的。 - - -因此，就像我们上面的代码，我们定义了一个简单的视图，命名为 `home` ，然后我们简单的返回了一个字符串 **Hello，World！** - - -那么我们直接运行就可以了吗？ - -并不是的，我们还没有告诉 Django 什么时候调用这个 **视图（view）** 呢？这就需要我们在 **urls.py** 文件中完成： - - -**urls.py** - -```Python -from django.conf.urls import url -from django.contrib import admin - -from boards import views - -urlpatterns = [ - url(r'^/code>, views.home, name='home'), - url(r'^admin/', admin.site.urls), -] -``` - - -如果您将上面的代码段与您的 **urls.py** 文件进行比较，您会注意到我添加了以下的代码：`url(r'^$', views.home, name='home')` 并使用我们的应用程序 **boards** 中导入了 **views** 模块。`from boards import views` - -可能这里大家还是会有很多疑问，不过先这样做，在后面我们会详细探讨这些概念。 - -但是现在，Django 使用**正则表达式**来匹配请求的URL。对于我们的 **home** 视图，我使用的是`^$`正则表达式，它将匹配空白路径，这是主页（此URL：**http://127.0.0.1:8000**）。如果我想匹配URL **http://127.0.0.1:8000/homepage/**，那么我们 url 的正则表达式就应该这样写：`url(r'^homepage/$', views.home, name='home')`。 - -运行项目，让我们看看会发生什么： - -``` -python manage.py runserver -``` - - -在 Web 浏览器中，打开 http://127.0.0.1:8000 ： - - -![你好，世界！](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-1/hello-world.png) - - -这样我们就看到了我们刚刚创建的第一个界面了。 - -* * * - -#### 总结 - -这是本系列教程的第一部分。在本教程中，我们学习了如何安装最新的 Python 版本以及如何设置开发环境。我们还介绍了虚拟环境，并开始了我们第一个 Django 项目，并已创建了我们的初始应用程序。 - -我希望你喜欢第一部分！第二部将涉及模型，视图，模板和网址。我们将一起探索所有的Django 基础知识！ - -就这样我们可以保持在同一页面上，我在 GitHub 上提供了源代码。项目的当前状态可以在发布**release tag v0.1-lw**下找到。下面的链接将带你到正确的地方： - -[https://github.com/sibtc/django-beginners-guide/tree/v0.1-lw](https://github.com/sibtc/django-beginners-guide/tree/v0.1-lw) diff --git "a/Article/django/\344\270\200\344\270\252\345\256\214\346\225\264\347\232\204\345\210\235\345\255\246\350\200\205\346\214\207\345\215\227Django-part2.md" "b/Article/django/\344\270\200\344\270\252\345\256\214\346\225\264\347\232\204\345\210\235\345\255\246\350\200\205\346\214\207\345\215\227Django-part2.md" deleted file mode 100644 index f3d83c33..00000000 --- "a/Article/django/\344\270\200\344\270\252\345\256\214\346\225\264\347\232\204\345\210\235\345\255\246\350\200\205\346\214\207\345\215\227Django-part2.md" +++ /dev/null @@ -1,1182 +0,0 @@ - ![一个完整的初学者指南Django - 第2部分](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/featured.jpg) - - - ![Python 3.6.2](https://img.shields.io/badge/python-3.6.2-brightgreen.svg) ![Django 1.11.4](https://img.shields.io/badge/django-1.11.4-brightgreen.svg) - - -#### 介绍 - - -欢迎来到 Django 教程的第二部分！在上一课中，我们安装了项目所需要的一切软件，希望你们在学习这篇文章之前，安装了 Python 3.6，并且在虚拟环境中运行Django 1.11。因为，在本篇文章中，我们将继续在这个项目中编写我们的代码。 - - -在这一篇文章中，可能不会有太多的代码操作，主要是讨论分析项目。在下一篇中，我们就开始学习 Django 的基础知识，包括模型（models），管理后台（admin），视图（views），模板（templates）和 路由（URL）。 - - -在这里，还是跟第一篇一样，建议大家多动手。 - -* * * - -#### 论坛项目 - - -每个人的学习习惯都是不同的，不知道你们是怎样的，就我个人而言，通过看实例和一些代码片段，可以让我学的更多，学的更快。但是，有些时候当我们看到 `Class A`和`Class B` ，或者是 `foo(bar)` 这样的例子的时候，我们是很难理解这些概念的。 - - -所以在我们进入模型（models），创建视图（views） 这些有趣的代码实操之前，我们还是需要花点时间，简单的讨论一下我们将怎样设计，开发这个项目。 - - -但是如果你已经有 web 开发经验的，而且觉得讲的太细了，那么你可以快速的浏览一下，然后进入到 【模型（models）】那一块中。 - -如果你对 Web 开发并不熟悉，那么我强烈建议你认真阅读下去。这里会介绍 web 应用程序开发的建模和设计，因为对于 web 开发来说，敲代码只是其中的一部分，模型的设计也是很重要的。 - - -![火箭科学](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/Pixton_Comic_Rocket_Science.png) - - -##### 用例图 - - -我们的项目本身是一个论坛系统，整个项目来说就是维护几个【论坛板块（boards）】 ，然后在每个板块里面，用户可以通过创建【主题（Topic）】并且在主题中讨论。 - - -一般情况下，只有管理员才能创建【论坛板块（boards）】，那么在用户这方面，我们就需要分为普通用户和管理员用户了，而且他们拥有的权限是不同的，管理员用户可以创建 【论坛板块（boards）】，【主题（Topic）】以及讨论回复，而普通用户只能发布【主题（Topic）】以及讨论回复。具体每个用户角色的功能分配如下图： - - - -> 图1：Web Board 核心功能的用例图 - - -![用例图](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/use-case-diagram.png) - - - -##### 类图 - - -从上面的用例图中，我们可以开始思考我们项目中的**实体类**有哪些了。这些实体是我们要创建的模型，它与我们的 Django 应用非常密切。 - - -如果要实现上面我们说到的论坛，那么我们至少需要以下的几个模型：**Board**，**Topic**，**Post**和**User**。 - -* **Board** : 版块 -* **Topic** : 主题 -* **Post** : 帖子（用户评论与回复） -* **User** : 用户 - - -> 图2：Web Board 类图 - - -![基本类图](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/basic-class-diagram.png) - - -上面我们只是说了需要有几个模型，并没有提到模型与模型之间是怎么关联的。 - - -通过上面的图片我们可以知道，主题（Topic）与版块（Board） 之间是有关联的，就好比我们需要知道这个主题（Topic） 是属于哪一个版块的（Board），因此我们需要一个字段，也就是可以通过外键爱关联它们。 - - -同样的，一个帖子（Post） 也是需要确定它是那个主题的，当然，用户和主题（Topic）和帖子（Post） 之间也是有联系的，因为我们需要确认是谁发的帖子，是谁回复评论了内容。 - - -竟然知道了模型之间的联系了，那么我们也必须要考虑这些模型应该存放哪些信息。就目前而言，我们的模型可以设计成这样： - - -> 图3：类（模型）之间关系的类图 - - -![类图](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/class-diagram.png) - - - -这个类图强调的是模型之间的关系，当然最后这些线条和箭头都会用字段来进行表示。 - -**Board（版块模型）** ：Board 中有 **name** 和 **description** 这两个字段，name 是唯一的，主要是为了避免两个名称重复。description 则是用于描述把这个版块来用干什么的。 - - -**Topic（主题模型）** ：subject 表示主题内容，last_update 用来定义话题的排序，starter 用来识别谁发起的话题，board 用于指定它属于哪个版块 - - -**Post（帖子模型）** ： message 字段，用于存储回复的内容，created_at 创建的时间，在排序时候用（最先发表的帖子排最前面），updated_at 更新时间，告诉用户是否更新了内容，同时，还需要有对应的 User 模型的引用，Post 由谁创建的和谁更新的。 - - -**User（用户模型）** ：这里有 username ，password，email 和 is_superuser 四个字段。 - - -这里值得注意的是，我们在 Django 应用中，不需要创建 User 用户模型，因为在 Django 的 contrib 中已经内置了 User 模型，我们可以直接拿来使用，就没必要重新创建了。 - - -认真观察的童鞋应该看到了，上面的模型关系图中，模型与模型之间的对应关系有数字 1，0..* 等等的字段，这是代表什么意思呢？ - - -如下图，`1` 代表一个 Topic 必须与一个 Board 相关联，`0..*` 代表 Board 下面可能会有多个和 0 个 Topic ，也就是一对多的关系。 - - -![类图板和主题协会](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/class-diagram-board-topic.png) - - -这里也是一样，`1` 代表一个 Post 只有一个 Topic ，`1..*` 代表一个 Topic 下面可能会有 1 个和多个个 Post ，也就是说，一个主题最少一个一个帖子。 - - - -![类图主题和帖子关联](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/class-diagram-topic-post.png) - - -`1` 代表一个 Topic 有且至于一个 User ，`0..*` 代表一个 User（用户） 可能拥有多个 Topic ，也可能没有。 - - -![类图主题和用户关联](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/class-diagram-topic-user.png) - - -Post（帖子） 和 User（用户）的关系也是类似，一个 Post 必须有一个 User ，而一个 User 可能没有也可能有多个 Post。这里的 Post ，用户发布了之后是可以进行修改的，也就是更新（updated_by），当然如果又被修改，updated_by 就是为空了。 - - -![类图邮政和用户协会](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/class-diagram-post-user.png)一 - - -当然，如果你觉得上面的图看起来很复杂，那么你也可以不需要强调模型与模型之间的关系，直接强调字段就可以了，如下图： - - -> 图4：强调类（模型）属性（字段）的类图 - - -![类图属性](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/class-diagram-attributes.png) - - -其实这种表达图和前面那个显示箭头和线的表达图，要表达的内容是一样的。不过使用这种表达方式可能更符合 Django Modles API 的设计。 - - -好了，现在已经够 UML 了！为了绘制本节介绍的图表，我使用的是 [StarUML](http://staruml.io/) 工具。 - - -##### 原型图 - - -花了一些时间来设计我们的程序模型，后面我们也需要设计一下我们的网页原型图。只有这样，才能更好的让我们清楚的知道自己将要干什么？ - - -![线框漫画](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/Pixton_Comic_Wireframes.png) - - - -首先，是我们的主页，在主页中，我们会显示我们所有的版块： - - -> 图5：主页显示所有的版块信息 - - -![线框板](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/wireframe-boards.png) - - -同样的，当用户点进了版块信息，进入到版块页面，那么版块页面也将显示该版块下的所有主题： - - ->图6：版块下的所有主题信息 - -![线框主题](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/wireframe-topics.png) - - -通过观察图片，细心的你，可能会发现，用户在这个页面有两条可以走的路线。第一条就是点击 “new topic” 来创建新的主题，第二条就是点击已经存在的主题进入相关的主题进行讨论回复。 - - - -“new topic” 的界面如下 ： - - -![线框新主题](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/wireframe-new-topic.png) - - -而，进入了相关的主题后，应该显示具体的帖子信息和用户的一些回复信息： - - -![线框帖子](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/wireframe-posts.png) - - - -如果用户点击 “Reply” 的按钮，他们将看到下面的页面，并以相反的顺序（最新的第一个）对帖子进行显示： - -![线框回复](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/wireframe-reply.png) - - -那么这些图是用什么来绘制的呢？你可以使用 [draw.io](https://draw.io/) ，而且他是完全免费的。 - - -* * * - -#### 模型（Models） - - -上一部分，设计了我们 Web 应用的数据库还有界面原型设计。在模型（Models）这一部分中，我们将在 Django 中创建我们数据库的模型类：**Board** ，**Topic** 和 **Post** 。 - - -这里是不是有个疑问，明明我们设计数据库的时候是有 **User** 的，为什么我们不用创建它的模型类呢？是不是写漏了？ - - -并不是，那是因为 **User** 这个模型类，已经内置在 Django 应用程序中的，**User** 模型就在 **django.contrib.auth** 中。在 settings.py 中，`INSTALLED_APPS` 就配置了**django.contrib.auth**。 - - -好了，现在我们将根据我们上面设计的数据库模型来完成我们项目 **boards** 下的 models.py 文件中的所有操作。 - - -> **boards/models.py** - -```python -from django.db import models -from django.contrib.auth.models import User - -class Board(models.Model): - name = models.CharField(max_length=30, unique=True) - description = models.CharField(max_length=100) - -class Topic(models.Model): - subject = models.CharField(max_length=255) - last_updated = models.DateTimeField(auto_now_add=True) - board = models.ForeignKey(Board, related_name='topics') - starter = models.ForeignKey(User, related_name='topics') - -class Post(models.Model): - message = models.TextField(max_length=4000) - topic = models.ForeignKey(Topic, related_name='posts') - created_at = models.DateTimeField(auto_now_add=True) - updated_at = models.DateTimeField(null=True) - created_by = models.ForeignKey(User, related_name='posts') - updated_by = models.ForeignKey(User, null=True, related_name='+') -``` - -可以看到，创建的所有模型类，**Board** ， **Topic** 和 **Post** 都是 **django.db.models.Model** 的子类，它们都将会转化成数据表。而 **django.db.models.Field** 的子类（Django 内置的核心类）的实例都会转化为数据表中的列。 - - -上面可以看到的 `CharField`，`DateTimeField` 等，都是 **django.db.models.Field** 的子类，在 Django 项目中都可以直接使用它们。 - - -在这里，我们仅仅使用了 `CharField`，`TextField`，`DateTimeField`，和 `ForeignKey` 字段来定义我们的模型（Models） 。当然，在 Django 中，不仅仅只是提供了这些字段，还提供了更多，更广泛的选择来代表不同类型的数据，比如还有：`IntegerField`，`BooleanField`， `DecimalField`。我们会根据不同的需求来使用它们。 - - -有些字段是需要参数的，就好比 `CharField` ，我们都设定了一个 `max_length` , 设置一个最大长度。当我们设定了这个字段后，就会作用于数据的。 - - -在 `Board` 模型（Model）中，在 `name` 字段中，我们也设置了参数 `unique=True`，顾名思义，这是为了在数据库中，保证该字段的唯一性。 - - -在 `Post` 模型中，`created_at` 字段有一个可选参数，`auto_now_add` 设置为 `True`。这是为了指明 Django 在创建 `Post` 对象的时候，`created_at` 使用的是当前的日期和时间。 - - -创建模型与模型之间关系的其中一种方法就是使用 `ForeignKey` 字段，使用这个字段，会自动创建模型与模型之间的联系，而且会在数据库中也创建它们的关系。使用 `ForeignKey` 会有一个参数，来表明他与那个模型之间的联系。 例如： - - -在 `Topic` 模型中，`models.ForeignKey(Board, related_name='topics')`，第一个参数是代表关联的表格（主表），在默认情况下，外键存储的是主表的主键（Primary Key）。第二个参数 `related_name` 是定义一个名称，用于反向查询的。Django 会自动创建这种反向关系。 虽然 `related_name` 是可选参数，但是如果我们不为它设置一个名称的，Django 会默认生成名称 `(class_name)_set` 。例如，在 `Board` 模型中，`Topic` 实例将在该 `topic_set` 属性下可用。而我们只是将其重新命名为`topics`，使用起来更加自然。 - - -在 `Post` 模型中，`updated_by` 字段设置`related_name='+'`。这指示 Django 我们不需要这种反向关系。 - - -下面这张图可以很好地看到设计图和源码之间的比较，其中绿线就表示了我们是如何处理反向关系的。 - - -![类图模型定义](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/class-diagram-django-models.png) - - -可能到这一步，你会问：“主键呢？”好像我们都没有定义主键啊。对，如果我们没有为模型（Models）指定主键，那么 Django 会自动生成它。 - - -##### 迁移模型（Migrating the Models） - - -到这一步，我们要开始告诉 Django 如何创建数据库，这样方便我们更好的使用。 - - -打开**终端** ，激活虚拟环境，进入到 **manage.py** 文件所在的文件夹，然后运行以下命令： - - -``` -python manage.py makemigrations -``` - -这时，你会看到这样的输出信息： - - -``` -Migrations for 'boards': - boards/migrations/0001_initial.py - - Create model Board - - Create model Post - - Create model Topic - - Add field topic to post - - Add field updated_by to post -``` - - -此时，Django 在 **boards / migrations** 目录内创建了一个名为**0001_initial.py** 的文件。它代表了我们应用程序模型的当前状态。在下一步中，Django 将使用该文件来创建表和列。 - - -迁移文件被翻译成 SQL 语句。如果您熟悉 SQL，则可以运行以下命令来检查将在数据库中执行的 SQL 指令： - -``` -python manage.py sqlmigrate boards 0001 -``` - - -如果你不熟悉 SQL，也不用担心。在本系列教程中，我们不会直接使用 SQL。所有的工作都将使用 Django ORM 来完成，它是一个与数据库进行通信的抽象层。 - -好了，下一步我们将把我们的迁移文件应用到我们的数据库中： - - -``` -python manage.py migrate -``` - - -输出应该是这样的： - -``` -Operations to perform: - Apply all migrations: admin, auth, boards, contenttypes, sessions -Running migrations: - Applying contenttypes.0001_initial... OK - Applying auth.0001_initial... OK - Applying admin.0001_initial... OK - Applying admin.0002_logentry_remove_auto_add... OK - Applying contenttypes.0002_remove_content_type_name... OK - Applying auth.0002_alter_permission_name_max_length... OK - Applying auth.0003_alter_user_email_max_length... OK - Applying auth.0004_alter_user_username_opts... OK - Applying auth.0005_alter_user_last_login_null... OK - Applying auth.0006_require_contenttypes_0002... OK - Applying auth.0007_alter_validators_add_error_messages... OK - Applying auth.0008_alter_user_username_max_length... OK - Applying boards.0001_initial... OK - Applying sessions.0001_initial... OK -``` - - - -因为这是我们第一次迁移数据库，所以该 `migrate` 命令还应用了 Django contrib 应用中现有的迁移文件，这些文件列于 `settings.py` 中的 `INSTALLED_APPS` 。 - - -而 `Applying boards.0001_initial... OK` 就是指我们在上一步中生成的迁移文件。 - - -好了，此时！我们的数据库已经可以使用了。 - - -![SQLite的](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/Pixton_Comic_SQLite.png) - - -> **注意：** 需要注意的是 **SQLite** 是一个数据库。SQLite 被许多公司用于成千上万的产品，如所有 Android 和 iOS 设备，所有主要的 Web 浏览器，Windows 10，MacOS 等。 -> -> 当然，它也不是适合所有的应用场景。SQLite 不能与 MySQL，PostgreSQL 或 Oracle 等数据库进行比较。大容量网站，密集型的应用程序，大数据集，高并发性，这些使用使用 SQLite 可能会导致很多问题。 -> -> 在我们开发的项目中，我们将使用 SQLite ，因为它很方便，我们不需要安装其他任何东西。当我们将项目部署到生产环境时，我们将切换到 PostgreSQL 。因为这对于简单的网站是不错的选择。但这里有一点要注意，对于复杂的网站，建议在开发和生产中使用相同的数据库。 - - -##### Models API - - -使用 Python 开发的一个重要优点是交互式 shell。我几乎一直都在使用它。这是一个可以快速尝试和测试实验的方法。 - -你可以使用 **manage.py** 加载我们的项目来启动 Python shell ： - -启动命令： - -``` -python manage.py shell -``` - -可以看到这样的输出： - -``` -Python 3.6.2 (default, Jul 17 2017, 16:44:45) -[GCC 4.2.1 Compatible Apple LLVM 8.1.0 (clang-802.0.42)] on darwin -Type "help", "copyright", "credits" or "license" for more information. -(InteractiveConsole) ->>> -``` - - -在我们使用 `python manage.py shell` 之外，我们也可以将项目添加到`sys.path`并加载 Django。这意味着我们可以在项目中导入我们的模型(models) 和任何其他资源。 - -我们从导入 **Board** 类开始： - -``` -from boards.models import Board -``` - -如果我们需要创建 **Board** 对象，我们可以执行以下操作： - -``` -board = Board(name='Django', description='This is a board about Django.') -``` - -此时我们只是创建了这个对象，并没有保存到数据库的，因此我们可以调用 `save` 方法，将这个对象保存在数据库中。 - - -``` -board.save() -``` - -该 `save` 方法 ，在创建对象和更新对象中都可以使用，这里 Django 会创建一个新的对象，因为 **Board** 实例是没有 **id** 这个字段的，因此保存后，Django 会自动设置一个 ID ： - - -``` -board.id -1 -``` - - -其他的字段你也可以当作属性来访问就好了，比如： - -``` -board.name -'Django' -``` - -``` -board.description -'This is a board about Django.' -``` - - -要更新一个值，我们可以这样做： - - -``` -board.description = 'Django discussion board.' -board.save() -``` - - -每个 Django 模型 (Models) 都带有一个特殊的属性; 我们称之为 **Model Manager（模型管理器）**。我们可以通过 Python 属性 `objects` 来访问它。它主要用于在数据库中执行查询。例如，我们可以使用它来直接创建一个新的**Board** 对象： - -``` -board = Board.objects.create(name='Python', description='General discussion about Python.') -``` - -``` -board.id -2 -``` - -``` -board.name -'Python' -``` - -所以，结合之前的操作，我们现在有两个 boards 对象。我们可以使用`objects` 列出数据库中所有现有的 boards ： - - -``` -Board.objects.all() -, ]> -``` - - -结果是一个 **QuerySet** 。稍后我们会进一步了解它。基本上，它是来自数据库的对象列表。通过输出结果，可以看到我们有两个对象，但我们只能读取 **Board对象** 。这是因为我们没有在 **Board** 模型中定义 `__str__` 方法。 - - -该 `__str__` 方法是一个对象的字符串表示。我们可以使用 Board 的名称来表示它。 - - -首先，退出交互式控制台： - - -``` -exit() -``` - - -现在编辑 **boards** 应用程序中的 **models.py** 文件： - - -``` -class Board(models.Model): - name = models.CharField(max_length=30, unique=True) - description = models.CharField(max_length=100) - - def __str__(self): - return self.name -``` - - -让我们再次尝试查询。再次打开交互式控制台： - - -``` -from boards.models import Board - -Board.objects.all() -, ]> -``` - - -仔细对比上面的，看下区别？ - -可以看到上面那个是 object ，而这里是我们定义的字符串。 - - -我们可以将这个 **QuerySet** 看作一个列表。假设我们想遍历它并打印每个 Board（版块） 的描述： - - -``` -boards_list = Board.objects.all() -for board in boards_list: - print(board.description) -``` - - -结果是： - - -``` -Django discussion board. -General discussion about Python. -``` - - -当然，我们也可以使用 **Model Manager（模型管理器）** 来查询数据库，如果查询其中的一个，我们可以使用 `get` 的方法： - - -``` -django_board = Board.objects.get(id=1) - -django_board.name -'Django' -``` - -当然我们要小心这种情况，因为很容易发生内存溢出的。比如我们试图去查询一个不存在的对象，就好比我们数据库只有两个 Board 对象，如果你查询 `id=3`，那么它会引发一个异常： - - -``` -board = Board.objects.get(id=3) - -boards.models.DoesNotExist: Board matching query does not exist. -``` - -当然，在 `get` 方法中，参数可以是该模型下的字段，最好是使用唯一的标识字段。否则会返回多个对象，会导致异常的。 - - -``` -Board.objects.get(name='Django') - -``` - - -请注意，查询是区分大小写的，小写 “django” 是不匹配的： - - -``` -Board.objects.get(name='django') -boards.models.DoesNotExist: Board matching query does not exist. -``` - - -##### 模型操作摘要 - -下面的表格是我们在本章节中学到的方法和操作。代码示例使用 **Board** 模型作为参考示例。大写的 **Board** 代表类，小写的 **board** 是指 **Board** 的实例对象。 - - -| 描述 | 代码示例 | -| --- | --- | -| 创建一个对象并没有保存 | `board = Board()` | -| 保存一个对象（创建或更新） | `board.save()` | -| 在数据库中创建并保存一个对象 | `Board.objects.create(name='...', description='...')` | -| 列出所有对象 | `Board.objects.all()` | -| 获取由字段标识的单个对象 | `Board.objects.get(id=1)` | - - -在下一节中，我们将开始编写视图并在 HTML 页面中显示我们的版块页面。 - - -* * * - -#### Views, Templates 和静态文件 - - -回顾一下，我们之前做的。我们已经可以在应用程序的主页上显示 ”Hello ，World！“ 的界面了。 - - -> **MyProject/urls.py** - -``` -from django.conf.urls import url -from django.contrib import admin - -from boards import views - -urlpatterns = [ - url(r'^/code>, views.home, name='home'), - url(r'^admin/', admin.site.urls), -] -``` - -> **boards/views.py** - -``` -from django.http import HttpResponse - -def home(request): - return HttpResponse('Hello, World!') -``` - -好了，现在我们需要修改这个主页，如果你不记得我们的主页要做成什么样子，可以看看之前我们已经设计好的原型界面图。我们在主页上，要做的是在表格中显示一些版块的名单和其他的一些信息。 - - -首先我们要做的是：导入 **Board** 模型，然后获取所有的存在的版块（boards）信息 - - -> **boards/views.py** - - -``` -from django.http import HttpResponse -from .models import Board - -def home(request): - boards = Board.objects.all() - boards_names = list() - - for board in boards: - boards_names.append(board.name) - - response_html = '
'.join(boards_names) - - return HttpResponse(response_html) -``` - - - -然后我们运行，就会看到这个简单的 HTML 页面： - - - -![主页HttpResponse](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/boards-homepage-httpresponse.png) - - -但是，一般情况下，我们是不会通过这种方式去渲染 HTML ，在 **views.py** 中，我们只需要获取 **boards** 的集合，至于 HTML 渲染那部分的代码，我们应该在 Django 的 templates 目录下完成。 - - -##### Django 模板引擎设置 - -竟然我们要将 **views.py** 里渲染 HTML 的代码分离，那么我们首先要在 **baords** 的同目录下，创建一个名为 **templates** 的文件夹。 - - -``` -myproject/ - |-- myproject/ - | |-- boards/ - | |-- myproject/ - | |-- templates/ <-- here! - | +-- manage.py - +-- venv/ -``` - -在我们创建的 **templates** 文件夹中，我们创建一个名为 **home.html** 的 HTML 文件 - -> **templates/home.html** - -```html - - - - - Boards - - -

Boards

- - {% for board in boards %} - {{ board.name }}
- {% endfor %} - - - -``` - -**home.html** 的文件内容如上面的一样，是一些原始的 HTML 标签代码和 Django 语言上的代码：`{% for ... in ... %}` ，`{{ variable }}`。上面的代码中展示了如何使用 for 循环遍历 list 对象。 - -到此，我们的 HTML 页面已经完成了，可是我们还没有告诉 Django 在哪里能找到我们应用中的 `templates` 文件夹里的 HTML。 - - -首先，我们在 Django 中绑定一下我们的 `templates` ,打开我们 ** myproject** 项目中的 **settings.py** 文件，搜索 `TEMPLATES` 变量然后在 `DIRS`设置 ：`os.path.join(BASE_DIR, 'templates')` - -具体如下： - -```python -TEMPLATES = [ - { - 'BACKEND': 'django.template.backends.django.DjangoTemplates', - 'DIRS': [ - os.path.join(BASE_DIR, 'templates') - ], - 'APP_DIRS': True, - 'OPTIONS': { - 'context_processors': [ - 'django.template.context_processors.debug', - 'django.template.context_processors.request', - 'django.contrib.auth.context_processors.auth', - 'django.contrib.messages.context_processors.messages', - ], - }, - }, -] -``` - -这样设计就好比相当于在你的项目中的完整路径下，在加上 "/templates" - -那是不是跟我们预想的一样呢？我们可以通过 python shell 进行调试： - -``` -python manage.py shell -``` - -``` -from django.conf import settings - -settings.BASE_DIR -'/Users/vitorfs/Development/myproject' - -import os - -os.path.join(settings.BASE_DIR, 'templates') -'/Users/vitorfs/Development/myproject/templates' -``` - - -可以看到，目录就是指向我们在上面创建的 **templates** 文件夹 - -此时，我们只是绑定了 **templates** 文件夹的路径，Django 并没有绑定我们 **home.html** ，我们可以在 **views.py** 中绑定： - -``` -from django.shortcuts import render -from .models import Board - -def home(request): - boards = Board.objects.all() - return render(request, 'home.html', {'boards': boards}) -``` - - - -运行后，HTML 的页面是这样的： - - -![主板渲染](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/boards-homepage-render.png) - -我们可以改进HTML模板来代替使用表格： - -> **templates/home.html** - -```html - - - - - Boards - - -

Boards

- - - - - - - - - - - - {% for board in boards %} - - - - - - - {% endfor %} - -
BoardPostsTopicsLast Post
- {{ board.name }}
- {{ board.description }} - 		00
- - -``` - - -![主板渲染](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/boards-homepage-render-2.png) - - -##### 测试主页 - - -![测试漫画](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/Pixton_Comic_Testing.png) - -测试这部分会在这系列教程中会不断的重复探讨。 - - -现在让我们来写第一个测试，首先在应用程序 **boards** 中找到 **tests.py** - -> **boards/tests.py** - -``` -from django.core.urlresolvers import reverse -from django.test import TestCase - -class HomeTests(TestCase): - def test_home_view_status_code(self): - url = reverse('home') - response = self.client.get(url) - self.assertEquals(response.status_code, 200) -``` - -这是一个非常简单的测试用例，但非常的有用。我们在测试的是响应状态码，如果是 200 意味着成功。 - - -我们可以在控制台中检查响应码： - -![回应200](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/test-homepage-view-status-code-200.png) - - -如果出现未捕获的异常，语法错误或其他任何情况，Django 会返回状态代码**500**，这意味着**服务器错误**。现在，想象我们的应用程序有 100 个界面（view）。如果我们为所有视图（view）编写了这个简单的测试，只需一个命令，我们就可以测试所有视图是否返回成功代码，这样用户就不会在任何地方看到任何错误消息。如果没有自动化测试，我们需要逐一检查每个页面。 - -要执行 Django 的测试套件： - -``` -python manage.py test -``` - -``` -Creating test database for alias 'default'... -System check identified no issues (0 silenced). -. ----------------------------------------------------------------------- -Ran 1 test in 0.041s - -OK -Destroying test database for alias 'default'... -``` - -现在我们可以测试 Django 是否为请求的 URL 返回了正确的视图函数。这也是一个有用的测试，因为随着开发的进展，您会发现 **urls.py** 模块可能变得非常庞大而复杂。URL 配置全部是关于解析正则表达式的。有些情况下我们有一个非常宽容的URL，所以 Django 最终可能返回错误的视图函数。 - -以下是我们如何做到的： - -> **boards/tests.py** - -``` -from django.core.urlresolvers import reverse -from django.urls import resolve -from django.test import TestCase -from .views import home - -class HomeTests(TestCase): - def test_home_view_status_code(self): - url = reverse('home') - response = self.client.get(url) - self.assertEquals(response.status_code, 200) - - def test_home_url_resolves_home_view(self): - view = resolve('/') - self.assertEquals(view.func, home) -``` - - - -在第二个测试中，我们正在使用 `resolve` 功能。Django 使用它来将请求的 URL与 **urls.py** 模块中列出的 URL 列表进行匹配。该测试将确保使用 `/`根 URL ，是否返回主视图（home view）。 - -再次测试： - -``` -python manage.py test -``` - -``` -Creating test database for alias 'default'... -System check identified no issues (0 silenced). -.. ----------------------------------------------------------------------- -Ran 2 tests in 0.027s - -OK -Destroying test database for alias 'default'... -``` - - -要查看有关测试执行的更多详细信息，请将 **verbosity** 设置为更高级别： - -``` -python manage.py test --verbosity=2 -``` - -``` -Creating test database for alias 'default' ('file:memorydb_default?mode=memory&cache=shared')... -Operations to perform: - Synchronize unmigrated apps: messages, staticfiles - Apply all migrations: admin, auth, boards, contenttypes, sessions -Synchronizing apps without migrations: - Creating tables... - Running deferred SQL... -Running migrations: - Applying contenttypes.0001_initial... OK - Applying auth.0001_initial... OK - Applying admin.0001_initial... OK - Applying admin.0002_logentry_remove_auto_add... OK - Applying contenttypes.0002_remove_content_type_name... OK - Applying auth.0002_alter_permission_name_max_length... OK - Applying auth.0003_alter_user_email_max_length... OK - Applying auth.0004_alter_user_username_opts... OK - Applying auth.0005_alter_user_last_login_null... OK - Applying auth.0006_require_contenttypes_0002... OK - Applying auth.0007_alter_validators_add_error_messages... OK - Applying auth.0008_alter_user_username_max_length... OK - Applying boards.0001_initial... OK - Applying sessions.0001_initial... OK -System check identified no issues (0 silenced). -test_home_url_resolves_home_view (boards.tests.HomeTests) ... ok -test_home_view_status_code (boards.tests.HomeTests) ... ok - ----------------------------------------------------------------------- -Ran 2 tests in 0.017s - -OK -Destroying test database for alias 'default' ('file:memorydb_default?mode=memory&cache=shared')... -``` - -详细程度决定了将要打印到控制台的通知和调试信息量; 0 是无输出，1 是正常输出，2 是详细输出。 - -##### 静态文件设置 - -静态文件是指 CSS，JavaScript，字体，图像或者是我们用来组成用户界面的任何其他资源。 - -事实上，Django 不提供这些文件。但在开发过程中，我们又会用到，因此 Django 提供了一些功能来帮助我们管理静态文件。这些功能可在配置文件（settings.py）中 `INSTALLED_APPS` 里的 **django.contrib.staticfiles** 。 - -有了这么多的前端组件库，我们没有理由继续渲染基本的 HTML 。我们可以轻松地将Bootstrap 4 添加到我们的项目中。Bootstrap 是一个用 HTML，CSS 和JavaScript 开发的开源工具包。 - -在项目根目录中，除**boards**，**templates** 和 **myproject** 文件夹外，我们还需要创建一个名为 **static** 的文件夹，并在 **static** 文件夹内创建另一个名为 **css** 文件夹： - -``` -myproject/ - |-- myproject/ - | |-- boards/ - | |-- myproject/ - | |-- templates/ - | |-- static/ <-- here - | | +-- css/ <-- and here - | +-- manage.py - +-- venv/ -``` - -到 [getbootstrap.com](https://getbootstrap.com/docs/4.0/getting-started/download/#compiled-css-and-js) 下载最新版本： - -![Bootstrap下载](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/bootstrap-download.png) - -下载 **Compiled CSS and JS** 的版本。 - -解压从 Bootstrap 网站下载的 **bootstrap-4.0.0-beta-dist.zip** 文件，将文件 **css / bootstrap.min.css** 复制到我们项目的css文件夹中： - -``` -myproject/ - |-- myproject/ - | |-- boards/ - | |-- myproject/ - | |-- templates/ - | |-- static/ - | | +-- css/ - | | +-- bootstrap.min.css <-- here - | +-- manage.py - +-- venv/ -``` - -还是一样的问题，我们需要将 Django 中的 **settings.py** 里配置一下静态文件的目录。在 `STATIC_URL` 添加以下内容： - -``` -STATIC_URL = '/static/' - -STATICFILES_DIRS = [ - os.path.join(BASE_DIR, 'static'), -] -``` - - -这里可以回忆一下，`TEMPLATES` 配置目录的路径，操作是差不多的。 - - -现在我们必须在模板中加载静态文件（Bootstrap CSS文件）： - -> **templates/home.html** - -``` -{% load static %} - - - - Boards - - - - - - -``` - - - -首先，我们在 html 的开头加载静态文件：`{% load static %}` - - -`{% static %}` 是用于告诉资源文件存在的路径，在这是，`{% static 'css/bootstrap.min.css' %}` 就会返回 **/static/css/bootstrap.min.css** ，相当于 **http://127.0.0.1:8000/static/css/bootstrap.min.css** - - -这个 `{% static %}` 标签将会和 **settings.py** 的 `STATIC_URL` 组成最终的 URL。怎么理解这句话呢？ - -例如，我们在静态文件托管在 **https://static.example.com/** ，然后我们设置了这个属性：`STATIC_URL=https://static.example.com/`，然后 `{% static 'css/bootstrap.min.css' %}` 返回的是 ：**https://static.example.com/css/bootstrap.min.css**。 - - -如果还不能理解，放心，你现在只需要了解和记住相关的过程就行了，后面正式开发上线的时候，会继续开展这部分的内容。 - - -刷新页面 **127.0.0.1:8000** 我们可以看到它是这个样子的： - -![Boards主页Bootstrap](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/boards-homepage-bootstrap.png) - -现在我们可以编辑模板，以利用Bootstrap CSS： - -现在我们可以利用 Bootstrap CSS 来编辑我们的模板页面了： - - - -``` -{% load static %} - - - - Boards - - - -
-
    -
  1. Boards
    2. -
- - - - - - - - - - - {% for board in boards %} - - - - - - - {% endfor %} - -
BoardPostsTopicsLast Post
- {{ board.name }} - {{ board.description }} - 00
-
- - -``` - - - -修改后变成这样子： - -![Boards主页Bootstrap](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/boards-homepage-bootstrap-2.png) - - -到目前为止，我们使用交互式控制台（`python manage.py shell`）添加新的版块（board）。但是这样很不方便，因此我们需要一个更好的方式来做这个。在下一节中，我们将为网站管理员实施一个管理界面来管理它。 - -* * * - -#### Django Admin简介 - -当我们开始一个新项目时，Django 在 `INSTALLED_APPS` 中已经配置了 **Django Admin** 。 - -![Django Admin漫画](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/Pixton_Comic_Django_Admin.png) - -Django Admin 的一个很好的用例就是，在博客中，它可以被作者用来编写和发布文章。另一个例子是电子商务网站，工作人员可以创建，编辑，删除产品。 - -目前，我们将配置 Django Admin 来维护我们的应用程序的版块模块。 - -我们首先创建一个管理员帐户： - -``` -python manage.py createsuperuser -``` - -按照说明操作： - -``` -Username (leave blank to use 'vitorfs'): admin -Email address: admin@example.com -Password: -Password (again): -Superuser created successfully. -``` - -现在在浏览器中打开 URL：**http://127.0.0.1:8000/admin/** - -![Django管理员登录](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/django-admin-login.png) - -输入 **用户名** 和 **密码** ： - -![Django Admin](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/django-admin.png) - - -在这里，它已经配置了一些功能，我们也可以添加**用户**和**组**来管理权限。 - - -那么我们如何在这个管理后台中管理版块（Board）里面的内容呢？ - -其实很简单，在 **board** 目录下，**admin.py** 中添加以下代码： - - -> **boards/admin.py** - -``` -from django.contrib import admin -from .models import Board - -admin.site.register(Board) -``` - - -保存以下，然后刷新网页： - -![Django管理委员会](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/django-admin-boards.png) - -点击 **Boards** 链接就能查看现有版块列表： - -![Django管理委员会名单](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/django-admin-boards-list.png) - -我们可以通过点击 **Add Board** 按钮添加一个新的版块： - -![Django管理委员会添加](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/django-admin-boards-add.png) - -点击 **SAVE** 按钮： - -![Django管理委员会名单](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/django-admin-boards-list-2.png) - -我们可以检查一切是否正常，打开 **http://127.0.0.1:8000** URL： - -![董事会主页](https://simpleisbetterthancomplex.com/media/series/beginners-guide/1.11/part-2/boards-homepage-bootstrap-3.png) - -* * * - -#### 结论 - -在本教程中，我们探讨了许多新概念。我们为我们的项目定义了一些要求，创建了第一个模型，迁移了数据库，开始玩 Models API。我们创建了第一个视图并编写了一些单元测试。我们还配置了 Django 模板引擎，静态文件，并将 Bootstrap 4 库添加到项目中。最后，我们简要介绍了 Django Admin 界面。 - - -该项目的源代码在 GitHub 上,你可以在下面的链接中找到本章节的代码： - -[https://github.com/sibtc/django-beginners-guide/tree/v0.2-lw](https://github.com/sibtc/django-beginners-guide/tree/v0.2-lw) \ No newline at end of file diff --git "a/Article/supplement/Python\345\205\263\351\224\256\345\255\227yield.md" "b/Article/supplement/Python\345\205\263\351\224\256\345\255\227yield.md" deleted file mode 100644 index 60353d25..00000000 --- "a/Article/supplement/Python\345\205\263\351\224\256\345\255\227yield.md" +++ /dev/null @@ -1,279 +0,0 @@ -> 原文：http://stackoverflow.com/questions/231767/the-python-yield-keyword-explained -> -> 注：这是一篇 stackoverflow 上一个火爆帖子的译文 - -## 问题 ## - -Python 关键字 yield 的作用是什么？用来干什么的？ - -比如，我正在试图理解下面的代码: - -```Python -def node._get_child_candidates(self, distance, min_dist, max_dist): - if self._leftchild and distance - max_dist < self._median: - yield self._leftchild - if self._rightchild and distance + max_dist >= self._median: - yield self._rightchild -``` - - -下面的是调用: - - -```python -result, candidates = list(), [self] -while candidates: - node = candidates.pop() - distance = node._get_dist(obj) - if distance <= max_dist and distance >= min_dist: - result.extend(node._values) - candidates.extend(node._get_child_candidates(distance, min_dist, max_dist)) -return result -``` - -当调用 ```_get_child_candidates``` 的时候发生了什么？返回了一个列表？返回了一个元素？被重复调用了么？ 什么时候这个调用结束呢？ - - -## 回答 - -为了理解什么是 yield ,你必须理解什么是生成器。在理解生成器之前，让我们先走近迭代。 - -**可迭代对象** - -当你建立了一个列表，你可以逐项地读取这个列表，这叫做一个可迭代对象: - -```Python ->>> mylist = [1, 2, 3] ->>> for i in mylist : -... print(i) -1 -2 -3 -``` - -mylist 是一个可迭代的对象。当你使用一个列表生成式来建立一个列表的时候，就建立了一个可迭代的对象: - -```python ->>> mylist = [x*x for x in range(3)] ->>> for i in mylist : -... print(i) -0 -1 -4 -``` - -所有你可以使用 ```for .. in ..``` 语法的叫做一个迭代器：列表，字符串，文件……你经常使用它们是因为你可以如你所愿的读取其中的元素，但是你把所有的值都存储到了内存中，如果你有大量数据的话这个方式并不是你想要的。 - -**生成器** - -生成器是可以迭代的，但是你 只可以读取它一次 ，因为它并不把所有的值放在内存中，它是实时地生成数据: - -```python ->>> mygenerator = (x*x for x in range(3)) ->>> for i in mygenerator : -... print(i) -0 -1 -4 -``` - -看起来除了把 [] 换成 () 外没什么不同。但是，你不可以再次使用 ```for i in mygenerator``` , 因为生成器只能被迭代一次：先计算出0，然后继续计算1，然后计算4，一个跟一个的… - -**yield 关键字** - -yield 是一个类似 return 的关键字，只是这个函数返回的是个生成器。 - -```python ->>> def createGenerator() : -... mylist = range(3) -... for i in mylist : -... yield i*i -... ->>> mygenerator = createGenerator() # create a generator ->>> print(mygenerator) # mygenerator is an object! - ->>> for i in mygenerator: -... print(i) -0 -1 -4 -``` - -这个例子没什么用途，但是它让你知道，这个函数会返回一大批你只需要读一次的值. - -为了精通 yield ,你必须要理解：当你调用这个函数的时候，函数内部的代码并不立马执行 ，这个函数只是返回一个生成器对象，这有点蹊跷不是吗。 - -那么，函数内的代码什么时候执行呢？当你使用for进行迭代的时候. - -现在到了关键点了！ - -第一次迭代中你的函数会执行，从开始到达 yield 关键字，然后返回 yield 后的值作为第一次迭代的返回值. 然后，每次执行这个函数都会继续执行你在函数内部定义的那个循环的下一次，再返回那个值，直到没有可以返回的。 - -如果生成器内部没有定义 yield 关键字，那么这个生成器被认为成空的。这种情况可能因为是循环进行没了，或者是没有满足 if/else 条件。 - -**回到你的代码** - -生成器: - -```Python -# Here you create the method of the node object that will return the generator -def node._get_child_candidates(self, distance, min_dist, max_dist): - - # Here is the code that will be called each time you use the generator object : - - # If there is still a child of the node object on its left - # AND if distance is ok, return the next child - if self._leftchild and distance - max_dist < self._median: - yield self._leftchild - - # If there is still a child of the node object on its right - # AND if distance is ok, return the next child - if self._rightchild and distance + max_dist >= self._median: - yield self._rightchild - - # If the function arrives here, the generator will be considered empty - # there is no more than two values : the left and the right children -``` - - -调用者: - -```Python -# Create an empty list and a list with the current object reference -result, candidates = list(), [self] - -# Loop on candidates (they contain only one element at the beginning) -while candidates: - - # Get the last candidate and remove it from the list - node = candidates.pop() - - # Get the distance between obj and the candidate - distance = node._get_dist(obj) - - # If distance is ok, then you can fill the result - if distance <= max_dist and distance >= min_dist: - result.extend(node._values) - - # Add the children of the candidate in the candidates list - # so the loop will keep running until it will have looked - # at all the children of the children of the children, etc. of the candidate - candidates.extend(node._get_child_candidates(distance, min_dist, max_dist)) - -return result -``` - -这个代码包含了几个小部分： - -* 我们对一个列表进行迭代，但是迭代中列表还在不断的扩展。它是一个迭代这些嵌套的数据的简洁方式，即使这样有点危险，因为可能导致无限迭代。 `candidates.extend(node._get_child_candidates(distance, min_dist, max_dist))` 穷尽了生成器的所有值，但 while 不断地在产生新的生成器，它们会产生和上一次不一样的值，既然没有作用到同一个节点上. -* `extend()` 是一个迭代器方法，作用于迭代器，并把参数追加到迭代器的后面。 - - -通常我们传给它一个列表参数: - - -```Python ->>> a = [1, 2] ->>> b = [3, 4] ->>> a.extend(b) ->>> print(a) -[1, 2, 3, 4] -``` - - -但是在你的代码中的是一个生成器，这是不错的，因为： - -* 你不必读两次所有的值 -* 你可以有很多子对象，但不必叫他们都存储在内存里面。 - - -并且这很奏效，因为 Python 不关心一个方法的参数是不是个列表。Python 只希望它是个可以迭代的，所以这个参数可以是列表，元组，字符串，生成器... 这叫做 `duck typing`,这也是为何 Python 如此棒的原因之一，但这已经是另外一个问题了... - -你可以在这里停下，来看看生成器的一些高级用法: - -**控制生成器的穷尽** - -```Python ->>> class Bank(): # let's create a bank, building ATMs -... crisis = False -... def create_atm(self) : -... while not self.crisis : -... yield "$100" ->>> hsbc = Bank() # when everything's ok the ATM gives you as much as you want ->>> corner_street_atm = hsbc.create_atm() ->>> print(corner_street_atm.next()) -$100 ->>> print(corner_street_atm.next()) -$100 ->>> print([corner_street_atm.next() for cash in range(5)]) -['$100', '$100', '$100', '$100', '$100'] ->>> hsbc.crisis = True # crisis is coming, no more money! ->>> print(corner_street_atm.next()) - ->>> wall_street_atm = hsbc.create_atm() # it's even true for new ATMs ->>> print(wall_street_atm.next()) - ->>> hsbc.crisis = False # trouble is, even post-crisis the ATM remains empty ->>> print(corner_street_atm.next()) - ->>> brand_new_atm = hsbc.create_atm() # build a new one to get back in business ->>> for cash in brand_new_atm : -... print cash -$100 -$100 -$100 -$100 -$100 -$100 -$100 -$100 -$100 -... -``` - - -对于控制一些资源的访问来说这很有用。 - -**Itertools,你最好的朋友** - -itertools 包含了很多特殊的迭代方法。是不是曾想过复制一个迭代器?串联两个迭代器？把嵌套的列表分组？不用创造一个新的列表的 zip/map? - -只要 import itertools - -需要个例子？让我们看看比赛中4匹马可能到达终点的先后顺序的可能情况: - -```python ->>> horses = [1, 2, 3, 4] ->>> races = itertools.permutations(horses) ->>> print(races) - ->>> print(list(itertools.permutations(horses))) -[(1, 2, 3, 4), - (1, 2, 4, 3), - (1, 3, 2, 4), - (1, 3, 4, 2), - (1, 4, 2, 3), - (1, 4, 3, 2), - (2, 1, 3, 4), - (2, 1, 4, 3), - (2, 3, 1, 4), - (2, 3, 4, 1), - (2, 4, 1, 3), - (2, 4, 3, 1), - (3, 1, 2, 4), - (3, 1, 4, 2), - (3, 2, 1, 4), - (3, 2, 4, 1), - (3, 4, 1, 2), - (3, 4, 2, 1), - (4, 1, 2, 3), - (4, 1, 3, 2), - (4, 2, 1, 3), - (4, 2, 3, 1), - (4, 3, 1, 2), - (4, 3, 2, 1)] -``` - -**了解迭代器的内部机理** - -迭代是一个实现可迭代对象(实现的是 `__iter__()` 方法)和迭代器(实现的是 `__next__()` 方法)的过程。可迭代对象是你可以从其获取到一个迭代器的任一对象。迭代器是那些允许你迭代可迭代对象的对象。 diff --git a/README.md b/README.md deleted file mode 100644 index 6053629b..00000000 --- a/README.md +++ /dev/null @@ -1,169 +0,0 @@ -IT 行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰，但是，我们要清楚：淘汰的永远只是那些初级水平的从业者，过硬技术的从业者永远都是稀缺的。因此对于学习，我们还是要踏踏实实的。 - - -自学 Python ，也是一样，不要一开始因为头脑发热就不停地收藏各种资料网站，购买各种书籍，下载了大量的教学视频，过了几天，学习的热情开始褪去，再过几个星期，终于完成了学习课程 —— 《从入门到放弃》。所以，学习 Python 需要一步一个脚印，踏踏实实地学。 - - - -# FQ - -在讲 Python 如何入门之前，个人建议最好每个人都有自己的 FQ 工具，多使用 Google 搜索，多去看一下墙外的世界，多看 Github 上的开源项目。 - -至于如何 FQ ，这里提供一下我用过的工具：[FQ工具集](/Res/FQ.md) - - - -# Python 学习资源集 - -相信很多人学习某门编程语言的时候，都会找各种学习资料。说句实话，资料太多，反而没用，根据自己的学习习惯，个人能力选择一门资源坚持学就好了。 - -因为每个人的需求不同，这里整理了一批 Python 比较好的学习资料： - -* [Python 博客网站资源](/Res/Python博客网站资源.md) - -还有一些有趣的网站： - -* [一个可以看执行过程的网站](http://www.pythontutor.com/visualize.html#mode=edit) - - - -# Python 入门 - -对于入门，主要是掌握基本的语法和熟悉编程规范，因此大部分的教程基本一致的，所以还是建议选好适合自己的一个教程，坚持学下去。 - -在 Python 入门中，本人编写了一系列的 《草根学 Python 》 文章， 是基于 Python 3.6 写的 Python 入门系列教程，为了更好的阅读，把它整理在 [GitBook](https://www.readwithu.com/) 上，希望对各位入门 Python 有所帮助。 - ->注：2018 年 02 月 27 日，基础知识入门部分已经完成了的。因近期读者反映有些图片没法打开了（之前图片放在七牛云，用的是临时链接，最近七牛云把这个给关闭了，导致图片没法打开），且自己对之前的内容有些不满意，决定在 2019 年 7 月 7 日开始进行了再次修改。但这里做个说明，因为之前写的时候用的是 windows 电脑，现在用 mac ，所以有些例子是 windows 的截图，有些是 mac 的截图，不要觉得奇怪。 - -**主要目录如下：** - -* [为什么学Python?](/Article/PythonBasis/python0/WhyStudyPython.md) -* [Python代码规范](/Article/codeSpecification/codeSpecification_Preface.md) - - [简明概述](/Article/codeSpecification/codeSpecification_first.md) - - [注释](/Article/codeSpecification/codeSpecification_second.md) - - [命名规范](/Article/codeSpecification/codeSpecification_third.md) -* [第一个Python程序](/Article/PythonBasis/python1/Preface.md) - - [Python 简介](/Article/PythonBasis/python1/Introduction.md) - - [Python 的安装](/Article/PythonBasis/python1/Installation.md) - - [第一个 Python 程序](/Article/PythonBasis/python1/The_first_procedure.md) - - [集成开发环境（IDE）: PyCharm](/Article/PythonBasis/python1/IDE.md) -* [基本数据类型和变量](/Article/PythonBasis/python2/Preface.md) - - [Python 语法的简要说明](/Article/PythonBasis/python2/Grammar.md) - - [print() 函数](/Article/PythonBasis/python2/print.md) - - [Python 的基本数据类型](/Article/PythonBasis/python2/Type_of_data.md) - - [字符串的编码问题](/Article/PythonBasis/python2/StringCoding.md) - - [基本数据类型转换](/Article/PythonBasis/python2/Type_conversion.md) - - [Python 中的变量](/Article/PythonBasis/python2/Variable.md) -* [List 和 Tuple](/Article/PythonBasis/python3/Preface.md) - - [List（列表）](/Article/PythonBasis/python3/List.md) - - [tuple（元组）](/Article/PythonBasis/python3/tuple.md) -* [ Dict 和 Set](/Article/PythonBasis/python4/Preface.md) - - [字典(Dictionary)](/Article/PythonBasis/python4/Dict.md) - - [set](/Article/PythonBasis/python4/Set.md) -* [条件语句和循环语句](/Article/PythonBasis/python5/Preface.md) - - [条件语句](/Article/PythonBasis/python5/If.md) - - [循环语句](/Article/PythonBasis/python5/Cycle.md) - - [条件语句和循环语句综合实例](/Article/PythonBasis/python5/Example.md) -* [函数](/Article/PythonBasis/python6/Preface.md) - - [Python 自定义函数的基本步骤](/Article/PythonBasis/python6/1.md) - - [函数返回值](/Article/PythonBasis/python6/2.md) - - [函数的参数](/Article/PythonBasis/python6/3.md) - - [函数传值问题](/Article/PythonBasis/python6/4.md) - - [匿名函数](/Article/PythonBasis/python6/5.md) -* [迭代器和生成器](/Article/PythonBasis/python7/Preface.md) - - [迭代](/Article/PythonBasis/python7/1.md) - - [Python 迭代器](/Article/PythonBasis/python7/2.md) - - [list 生成式（列表生成式）](/Article/PythonBasis/python7/3.md) - - [生成器](/Article/PythonBasis/python7/4.md) - - [迭代器和生成器综合例子](/Article/PythonBasis/python7/5.md) -* [面向对象](/Article/PythonBasis/python8/Preface.md) - - [面向对象的概念](/Article/PythonBasis/python8/1.md) - - [类的定义和调用](/Article/PythonBasis/python8/2.md) - - [类方法](/Article/PythonBasis/python8/3.md) - - [修改和增加类属性](/Article/PythonBasis/python8/4.md) - - [类和对象](/Article/PythonBasis/python8/5.md) - - [初始化函数](/Article/PythonBasis/python8/6.md) - - [类的继承](/Article/PythonBasis/python8/7.md) - - [类的多态](/Article/PythonBasis/python8/8.md) - - [类的访问控制](/Article/PythonBasis/python8/9.md) -* [模块与包](/Article/PythonBasis/python9/Preface.md) - - [Python 模块简介](/Article/PythonBasis/python9/1.md) - - [模块的使用](/Article/PythonBasis/python9/2.md) - - [主模块和非主模块](/Article/PythonBasis/python9/3.md) - - [包](/Article/PythonBasis/python9/4.md) - - [作用域](/Article/PythonBasis/python9/5.md) -* [Python 的 Magic Method](/Article/PythonBasis/python10/Preface.md) - - [Python 的 Magic Method](/Article/PythonBasis/python10/1.md) - - [构造(`__new__`)和初始化(`__init__`)](/Article/PythonBasis/python10/2.md) - - [属性的访问控制](/Article/PythonBasis/python10/3.md) - - [对象的描述器](/Article/PythonBasis/python10/4.md) - - [自定义容器（Container）](/Article/PythonBasis/python10/5.md) - - [运算符相关的魔术方法](/Article/PythonBasis/python10/6.md) -* [枚举类](/Article/python11/PythonBasis/Preface.md) - - [枚举类的使用](/Article/PythonBasis/python11/1.md) - - [Enum 的源码](/Article/PythonBasis/python11/2.md) - - [自定义类型的枚举](/Article/PythonBasis/python11/3.md) - - [枚举的比较](/Article/PythonBasis/python11/4.md) -* [元类](/Article/PythonBasis/python12/Preface.md) - - [Python 中类也是对象](/Article/PythonBasis/python12/1.md) - - [使用 `type()` 动态创建类](/Article/PythonBasis/python12/2.md) - - [什么是元类](/Article/PythonBasis/python12/3.md) - - [自定义元类](/Article/PythonBasis/python12/4.md) - - [使用元类](/Article/PythonBasis/python12/5.md) -* [线程与进程](/Article/PythonBasis/python13/Preface.md) - - [线程与进程](/Article/PythonBasis/python13/1.md) - - [多线程编程](/Article/PythonBasis/python13/2.md) - - [进程](/Article/PythonBasis/python13/3.md) -* [一步一步了解正则表达式](/Article/PythonBasis/python14/Preface.md) - - [初识 Python 正则表达式](/Article/PythonBasis/python14/1.md) - - [字符集](/Article/PythonBasis/python14/2.md) - - [数量词](/Article/PythonBasis/python14/3.md) - - [边界匹配符和组](/Article/PythonBasis/python14/4.md) - - [re.sub](/Article/PythonBasis/python14/5.md) - - [re.match 和 re.search](/Article/PythonBasis/python14/6.md) -* [闭包](/Article/PythonBasis/python15/1.md) -* [装饰器](/Article/PythonBasis/python16/1.md) - - - - -# 知识点补漏 -* [Python 关键字 yield](/Article/supplement/Python关键字yield.md) - - - -# Python 进阶 - -* [使用Python虚拟环境](/Article/advanced/使用Python虚拟环境.md) -* [Mac中使用virtualenv和virtualenvwrapper](/Article/advanced/Mac中使用virtualenv和virtualenvwrapper.md) - - - - -# HTML 和 CSS 入门 - - -# JavaScript 入门 - - - -# Django - -Python 下有许多款不同的 Web 框架。Django 是重量级选手中最有代表性的一位。许多成功的网站和 APP 都基于 Django。 - -如果对自己的基础有点信息的童鞋，可以尝试通过国外的 [Django 博客从搭建到部署系列教程](https://simpleisbetterthancomplex.com/series/2017/09/04/a-complete-beginners-guide-to-django-part-1.html) 进行入门，这个教程讲的非常的详细，而且还有很多有趣的配图。不过可能因为墙的原因，很多人会访问不到，就算访问到了，也因为是英语的，不会进行耐心的阅读学习。因此我打算翻译这个教程。 - -* [一个完整的初学者指南Django-part1](/Article/django/一个完整的初学者指南Django-part1.md) -* [一个完整的初学者指南Django-part2](/Article/django/一个完整的初学者指南Django-part2.md) - - -持续更新.... - - -可以关注我的公众号，实时了解更新情况。 - - - - - - diff --git a/Res/FQ.md b/Res/FQ.md deleted file mode 100644 index 24cb613a..00000000 --- a/Res/FQ.md +++ /dev/null @@ -1,28 +0,0 @@ - -# FQ - - -* **蓝灯** - - 简单粗暴，下载安装即可用，每月免费 5g ，也可以 购买专业版，一年两百多。其实如果不用来看视频，够用的了。 - - 传送门： [蓝灯官方论坛](https://github.com/getlantern/forum) ，[蓝灯镜像下载地址](http://s3.amazonaws.com/urtuz53txrmk9/index.html) - - -* **XX-Net** - - 基于 Google 免费的云服务搭建，这里有个矛盾就 是：搭建前你得 FQ。也就是说，我要下载 FQ 软件，可是 下载这个 FQ 软件就要 FQ 。 - - 所以这里你可以先用蓝灯 FQ 后，再搭建这个 - - 传送门：[官方中文文档](https://github.com/XX-net/XX-Net/wiki/%E4%B8%AD%E6%96%87%E6%96%87%E6%A1%A3)，[基于 Chrome 浏览器的搭建步骤](https://github.com/XX-net/XX-Net/wiki/%E4%BD%BF%E7%94%A8Chrome%E6%B5%8F%E8%A7%88%E5%99%A8) - - -* **自己搭建 ssr** - - 当然，最好的还是自己能搭建 ss/ssr 服务器，这里有个适合初学者的教程。 - - 传送门：[教程地址](../Res/自己搭建ss:ssr服务器.md) - - - diff --git "a/Res/Python\345\215\232\345\256\242\347\275\221\347\253\231\350\265\204\346\272\220.md" "b/Res/Python\345\215\232\345\256\242\347\275\221\347\253\231\350\265\204\346\272\220.md" deleted file mode 100644 index de1e8026..00000000 --- "a/Res/Python\345\215\232\345\256\242\347\275\221\347\253\231\350\265\204\346\272\220.md" +++ /dev/null @@ -1,47 +0,0 @@ -# Python 博客网站资源 - - -* **本人编写的 Python 系列文章** - - 本草根编写的 Python 文章，里面有各种例子代码 - - 传送门： [Gitbook](https://www.readwithu.com/)，[github](https://github.com/TwoWater/Python) - -* **Python 在线手册** - - Python 在线手册站，收集整理了大量 Python 流行技术文档和教程。更多时候我们用来查询 Api 。 - - 传送门：[官方地址](http://docs.pythontab.com) - - -* **Python轻松入门** - - 网易云课程，Python 轻松入门 - - 传送门： [官方地址](https://study.163.com/course/introduction.htm?courseId=1003655001&utm_campaign=share&utm_content=courseIntro&utm_medium=iphoneShare&utm_source=weixing) - - -* **廖雪峰 Python 教程** - - 最最最经典的 Python 入门文章。 - - 传送门：[官方地址](http://www.liaoxuefeng.com/wiki/0014316089557264a6b348958f449949df42a6d3a2e542c000) - - -* **Python 基础教程** - - 详细的记录 Python 各个知识点的用法讲解，很适合小白入门。 - - 传送门：[官方地址](http://www.runoob.com/python/python-tutorial.html) - - -* **莫烦Python** - - - 传送门：[官方地址](https://morvanzhou.github.io/tutorials/python-basic/) - -* **The Hitchhiker’s Guide to Python** - - 传送门：[官方地址](http://docs.python-guide.org/en/latest/) - - diff --git "a/Res/\350\207\252\345\267\261\346\220\255\345\273\272ss:ssr\346\234\215\345\212\241\345\231\250.md" "b/Res/\350\207\252\345\267\261\346\220\255\345\273\272ss:ssr\346\234\215\345\212\241\345\231\250.md" deleted file mode 100644 index efb5e017..00000000 --- "a/Res/\350\207\252\345\267\261\346\220\255\345\273\272ss:ssr\346\234\215\345\212\241\345\231\250.md" +++ /dev/null @@ -1,293 +0,0 @@ -# 客户端下载 - -第一次电脑系统使用SSR/SS客户端时，需要安装NET Framework 4.0，不然无法正常使用，[微软官网下载](https://www.microsoft.com/zh-cn/download/details.aspx?id=17718)。 - -NET Framework 4.0是SSR/SS的运行库，没有这个SSR/SS客户端无法正常运行。有的电脑系统可能会自带NET Framework 4.0。 - -* Windows SSR客户端 [下载地址](https://github.com/shadowsocksr-backup/shadowsocksr-csharp/releases) [备用下载地址](https://nofile.io/f/6Jm7WJCyOVv/ShadowsocksR-4.7.0-win.7z) - -* MAC SSR客户端 [下载地址](https://github.com/shadowsocksr-backup/ShadowsocksX-NG/releases) [备用下载地址](https://nofile.io/f/jgMWFwCBonU#ab0d3c3b6ac54482) - -* Linux客户端一键安装配置 [使用脚本](https://github.com/the0demiurge/CharlesScripts/blob/master/charles/bin/ssr) (使用方法见注释) 或者采用图形界面的[linux ssr客户端](https://github.com/erguotou520/electron-ssr/releases) - -* 安卓 SSR客户端 [下载地址](https://github.com/shadowsocksr-backup/shadowsocksr-android/releases) [备用下载地址](https://nofile.io/f/rvTJoj0h5GC/shadowsocksr-release.apk) - -* 苹果手机SSR客户端：Potatso Lite、Potatso、shadowrocket都可以作为SSR客户端，但这些软件目前已经在国内的app商店下架，可以用美区的appid账号来下载。但是，如果你配置的SSR账号兼容SS客户端，或者协议选择origin且混淆选择plain，那么你可以选择苹果SS客户端软件（即协议和混淆可以不填），APP商店里面有很多，比如：openwingy、superwingy、bestwingy、wingy+、greatwingy等。 - -**有了客户端后我们需要自己搭建服务器创建ss/ssr账号才能翻墙。提供ss/ssr免费账号 有需求的人可以使用。** - -# 搭建教程 - -### 为什么不怕被封ip？因为vultr可以随时删除和创建服务器，新服务器就是新的ip，所以不怕被封ip。 - - -**教程很简单，整个教程分三步：** - -第一步：购买VPS服务器 - -第二步：一键部署VPS服务器 - -第三步：一键加速VPS服务器 （谷歌BBR加速，推荐） - -* * * - -**第一步：购买VPS服务器** - -VPS服务器需要选择国外的，首选国际知名的vultr，速度不错、稳定且性价比高，按小时计费，能够随时开通和删除服务器，新服务器即是新ip。 - -vultr注册地址： [http://www.vultr.com/?ref=7048874](http://www.vultr.com/?ref=7048874) （全球15个服务器位置可选，KVM框架，最低2.5美元/月） - -[![img](https://camo.githubusercontent.com/e5b4fc7834baffafe9883ac40cc7f296e62f9741/68747470733a2f2f7777772e76756c74722e636f6d2f6d656469612f62616e6e65725f322e706e67)](https://www.vultr.com/?ref=7048874) - -虽然是英文界面，但是现在的浏览器都有网页翻译功能，鼠标点击右键，选择网页翻译即可翻译成中文。 - -注册并邮件激活账号，充值后即可购买服务器。充值方式是paypal（首选）或支付宝，使用paypal有银行卡（包括信用卡）即可。paypal注册地址：[https://www.paypal.com](https://www.paypal.com/) （paypal是国际知名的第三方支付服务商，注册一下账号，绑定银行卡即可购买国外商品） - -2.5美元/月的服务器配置信息：单核 512M内存 20G SSD硬盘 带宽峰值100M 500G流量/月 - -5美元/月的服务器配置信息： 单核 1G内存 25G SSD硬盘 带宽峰值100M 1000G流量/月 - -10美元/月的服务器配置信息： 单核 2G内存 40G SSD硬盘 带宽峰值100M 2000G流量/月 - -20美元/月的服务器配置信息： 2cpu 4G内存 60G SSD硬盘 带宽峰值100M 3000G流量/月 - -40美元/月的服务器配置信息： 4cpu 8G内存 100G SSD硬盘 带宽峰值100M 4000G流量/月 - -**vultr实际上是折算成小时来计费的，比如服务器是5美元1个月，那么每小时收费为5/30/24=0.0069美元 会自动从账号中扣费，只要保证账号有钱即可。如果你部署的服务器实测后速度不理想，你可以把它删掉（destroy），重新换个地区的服务器来部署，方便且实用。因为新的服务器就是新的ip，所以当ip被墙时这个方法很有用。当ip被墙时，为了保证新开的服务器ip和原先的ip不一样，先开新服务器，开好后再删除旧服务器即可。** - -计费从你开通服务器开始算的，不管你有没有使用，即使服务器处于关机状态仍然会计费，如果你没有开通服务器就不算。比如你今天早上开通了服务器，但你有事情，晚上才部署，那么这段时间是会计费的。同理，如果你早上删掉服务器，第二天才开通新的服务器，那么这段时间是不会计费的。在账号的Billing选项里可以看到账户余额。 - -温馨提醒：同样的服务器位置，不同的宽带类型和地区所搭建的账号的翻墙速度会不同，这与中国电信、中国联通、中国移动国际出口带宽和线路不同有关，所以以实测为准。可以先选定一个服务器位置来按照教程进行搭建，熟悉搭建方法，当账号搭建完成并进行了bbr加速后，测试下速度自己是否满意，如果满意那就用这个服务器位置的服务器。如果速度不太满意，就一次性开几台不同的服务器位置的服务器，然后按照同样的方法来进行搭建并测试，选择最优的，之后把其它的服务器删掉，按小时计费测试成本可以忽略。 - -如图： - -[![img](https://raw.githubusercontent.com/Alvin9999/pac2/master/pp100.png)](https://raw.githubusercontent.com/Alvin9999/pac2/master/pp100.png) - -[![img](https://raw.githubusercontent.com/Alvin9999/pac2/master/pp101.png)](https://raw.githubusercontent.com/Alvin9999/pac2/master/pp101.png) - -**vps服务器系统推荐选择CentOS 6.X64位的系统（系统版本不要选centos7！centos7默认的防火墙会阻止ssr的正常连接！）。完成购买后，找到系统的密码记下来，部署服务器时需要用到。** - -如图： -[![img](https://raw.githubusercontent.com/Alvin9999/crp_up/master/pac%E6%95%99%E7%A8%8B01.png)](https://raw.githubusercontent.com/Alvin9999/crp_up/master/pac%E6%95%99%E7%A8%8B01.png) - -[![img](https://raw.githubusercontent.com/Alvin9999/crp_up/master/pac%E6%95%99%E7%A8%8B02.png)](https://raw.githubusercontent.com/Alvin9999/crp_up/master/pac%E6%95%99%E7%A8%8B02.png) - -[![img](https://raw.githubusercontent.com/Alvin9999/crp_up/master/pac%E6%95%99%E7%A8%8B04.png)](https://raw.githubusercontent.com/Alvin9999/crp_up/master/pac%E6%95%99%E7%A8%8B04.png) - -**不要选centos7系统！点击图中的CentOS几个字，会弹出centos6，然后选中centos6！entos7默认的防火墙可能会干扰ssr的正常连接！** - -> 接下来这一步是开启vps的ipv6 ip，选填项。如果你的电脑系统可以用ipv6，那么可以勾选此项。大多数用户没有这个需求，但有一些用户可能会用到，所以补充了这部分内容。 - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/ssripv6-01.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/ssripv6-01.png) - -[![img](https://raw.githubusercontent.com/Alvin9999/crp_up/master/pac%E6%95%99%E7%A8%8B05.png)](https://raw.githubusercontent.com/Alvin9999/crp_up/master/pac%E6%95%99%E7%A8%8B05.png) - -[![img](https://raw.githubusercontent.com/Alvin9999/crp_up/master/pac%E6%95%99%E7%A8%8B06.png)](https://raw.githubusercontent.com/Alvin9999/crp_up/master/pac%E6%95%99%E7%A8%8B06.png) - -> 如果你开启了vps的ipv6，那么在后台的settings选项可以找到服务器的ipv6 ip。在部署SSR账号时，你用ipv6 ip就行。整个部署及使用过程中，记得把电脑系统开启ipv6喔。 - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/ssripv6-02.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/ssripv6-02.png) - -* * * - -**第二步：部署VPS服务器** - -购买服务器后，需要部署一下。因为你买的是虚拟东西，而且又远在国外，我们需要一个叫Xshell的软件来远程部署。Xshell windows版下载地址： - -[国外云盘1下载](http://45.32.141.248:8000/f/d91974d046/) - -[国外云盘2下载](https://nofile.io/f/eb5dUzYMQK4/Xshell_setup_wm.exe) 提取密码：666 - -[国外云盘3下载](https://www.adrive.com/public/NdK3Ez/Xshell_setup_wm.exe) 密码：123 - -如果你是苹果电脑操作系统，更简单，无需下载xshell，系统可以直接连接VPS。打开**终端**（Terminal），输入ssh root@ip 其中“ip”替换成你VPS的ip, 按回车键，然后复制粘贴密码，按回车键即可登录。粘贴密码时有可能不显示密码，但不影响， [参考设置方法](http://www.cnblogs.com/ghj1976/archive/2013/04/19/3030159.html) 如果不能用MAC自带的终端连接的话，直接网上搜“MAC连接SSH的软件”，有很多，然后通过软件来连接vps服务器就行，具体操作方式参考windows xshell。 - -* * * - -部署教程： - -下载xshell软件并安装后，打开软件 - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/xshell11.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/xshell11.png) - -选择文件，新建 - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/xshell12.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/xshell12.png) - -随便取个名字，然后把你的服务器ip填上 - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/xshell13.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/xshell13.png) - -连接国外ip即服务器时，软件会先后提醒你输入用户名和密码，用户名linux系统默认都是root，密码是购买服务器后的cent系统的密码。 - -**如果开好了服务器，发现xshell死活连不上，多半是开的服务器ip被墙了，遇到这种情况，把服务器删掉，重新开个新的服务器即可，可以是同地区的也可以选择其它地区。** - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/xshell14.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/xshell14.png) - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/xshell2.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/xshell2.png) - -连接成功后，会出现如上图所示，之后就可以复制粘贴代码部署了。 - -CentOS6/Debian6/Ubuntu14 ShadowsocksR一键部署管理脚本： - -* * * - -yum -y install wget - -wget -N –no-check-certificate [https://softs.fun/Bash/ssr.sh](https://softs.fun/Bash/ssr.sh) && chmod +x ssr.sh && bash ssr.sh - -备用脚本： - -yum -y install wget - -wget -N –no-check-certificate [https://raw.githubusercontent.com/ToyoDAdoubi/doubi/master/ssr.sh](https://raw.githubusercontent.com/ToyoDAdoubi/doubi/master/ssr.sh) && chmod +x ssr.sh && bash ssr.sh - -———————————————————代码分割线———————————————— - -复制上面的代码到VPS服务器里，按回车键，脚本会自动安装，以后只需要运行这个快捷命令就可以出现下图的界面进行设置，快捷管理命令为：bash ssr.sh - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/8.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/8.png) - -如上图出现管理界面后，**输入数字1来安装SSR服务端**。如果输入1后不能进入下一步，那么请退出xshell，重新连接vps服务器，然后输入快捷管理命令bash ssr.sh 再尝试。 - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/demo/31.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/demo/31.png) - -根据上图提示，依次输入自己想设置的**端口和密码** (**密码建议用复杂点的字母组合，端口号为1-65535之间的数字**)，回车键用于确认 - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/demo/32.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/demo/32.png) - -如上图，选择想设置的**加密方式**，比如10，按回车键确认 - -接下来是选择**协议插件**，如下图： - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/11.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/11.png) - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/demo/41.PNG)](https://raw.githubusercontent.com/Alvin9999/PAC/master/demo/41.PNG) - -选择并确认后，会出现上图的界面，提示你是否选择兼容原版，这里的原版指的是SS客户端（SS客户端没有协议和混淆的选项），可以根据需求进行选择，演示选择y - -之后进行混淆插件的设置。 -**注意：有的地区需要把混淆设置成plain才好用。因为混淆不总是有效果，要看各地区的策略，有时候不混淆（plain）让其看起来像随机数据更好。（注意：tls 1.2_ticket_auth容易受到干扰！请选择除tls开头以外的其它混淆！！！）** - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/demo/33.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/demo/33.png) - -进行混淆插件的设置后，会依次提示你对设备数、单线程限速和端口总限速进行设置，默认值是不进行限制，个人使用的话，选择默认即可，即直接敲回车键。 - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/14.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/14.png) - -之后代码就正式自动部署了，到下图所示的位置，提示你下载文件，输入：y - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/15.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/15.png) - -耐心等待一会，出现下面的界面即部署完成： - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/16.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/16.png) - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/demo/34.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/demo/34.png) - -根据上图就可以看到自己设置的SSR账号信息，包括IP、端口、密码、加密方式、协议插件、混淆插件，这些信息需要填入你的SSR客户端。如果之后想修改账号信息，直接输入快捷管理命令：bash ssr.sh 进入管理界面，选择相应的数字来进行一键修改。例如： - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/22.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/22.png) - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/23.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/23.png) - -**脚本演示结束。** - -此脚本是开机自动启动，部署一次即可。最后可以重启服务器确保部署生效（一般情况不重启也可以）。重启需要在命令栏里输入reboot ，输入命令后稍微等待一会服务器就会自动重启，一般重启过程需要2～5分钟，重启过程中Xshell会自动断开连接，等VPS重启好后才可以用Xshell软件进行连接。如果部署过程中卡在某个位置超过10分钟，可以用xshell软件断开，然后重新连接你的ip，再复制代码进行部署。 - -* * * - -**第三步：一键加速VPS服务器** - -此加速教程为谷歌BBR加速,Vultr的服务器框架可以装BBR加速，加速后对速度的提升很明显，所以推荐部署加速脚本。该加速方法是开机自动启动，部署一次就可以了。 - -按照第二步的步骤，连接服务器ip，登录成功后，在命令栏里粘贴以下代码： - -【谷歌BBR加速教程】 - -yum -y install wget - -wget –no-check-certificate [https://github.com/teddysun/across/raw/master/bbr.sh](https://github.com/teddysun/across/raw/master/bbr.sh) - -chmod +x bbr.sh - -./bbr.sh - -把上面整个代码复制后粘贴进去，不动的时候按回车，然后耐心等待，最后重启vps服务器即可。 - -演示开始，如图： - -复制并粘贴代码后，按回车键确认 - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/18.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/18.png) - -如下图提示，按任意键继续部署 - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/19.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/19.png) - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/20.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/20.png) - -部署到上图这个位置的时候，等待3～6分钟 - -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/21.png)](https://raw.githubusercontent.com/Alvin9999/PAC/master/ss/21.png) - -最后输入y重启服务器，如果输入y提示command not found ，接着输入reboot来重启服务器，确保加速生效，bbr加速脚本是开机自动启动，装一次就可以了。 - -* * * - -购买vps服务器后，ip有了，通过部署，端口、密码、加密方式、协议和混淆也有了，最后将这些信息填入SSR客户端就可以翻墙啦。 - -**有了账号后，打开SSR客户端，填上信息，这里以windows版的SSR客户端为例子**： -[![img](https://raw.githubusercontent.com/Alvin9999/PAC/master/demo/42.PNG)](https://raw.githubusercontent.com/Alvin9999/PAC/master/demo/42.PNG) - -在对应的位置，填上服务器ip、服务器端口、密码、加密方式、协议和混淆，最后将浏览器的代理设置为（http）127.0.0.1和1080即可。账号的端口号就是你自己设置的，而要上网的浏览器的端口号是1080，固定的，谷歌浏览器可以通过 SwitchyOmega 插件来设置。 - -启动SSR客户端后，右键SSR客户端图标，选择第一个“系统代理模式”，里面有3个子选项，选择”全局模式“，之后就可以用浏览器设置好了的代理模式（http）127.0.0.1和1080翻墙，此模式下所有的网站都会走SSR代理。（适合新手） - -[![ssr9000](https://user-images.githubusercontent.com/12132898/32225069-cfe6195a-be7e-11e7-99e0-e2fa98f93b1f.png)](https://user-images.githubusercontent.com/12132898/32225069-cfe6195a-be7e-11e7-99e0-e2fa98f93b1f.png) - -* * * - -**常见问题参考解决方法**： - -1、用了一段时间发现ssr账号用不了了 - -首先ping一下自己的ip，看看能不能ping的通，ping不通那么就是ip被墙了，ip被墙时，xshell也会连接不上服务器，遇到这种情况重新部署一个新的服务器，新的服务器就是新的ip。关于怎么ping ip的方法，可以自行网上搜索，或者用xshell软件连接服务器来判断，连不上即是被墙了。vultr开通和删除服务器非常方便，新服务器即新ip，大多数vps服务商都没有这样的服务，一般的vps服务商可能会提供免费更换1次ip的服务。 - -2、刚搭建好的ssr账号，ip能ping通，但是还是用不了 - -首选排除杀毒软件的干扰，尤其是国产杀毒软件，比如360安全卫生、360杀毒软件、腾讯管家、金山卫生等。这些东西很容易干扰翻墙上网，如果你的电脑安装了这样的东西，建议至少翻墙时别用，最好卸载。其次，检查下SSR信息是否填写正确。浏览器的代理方式是否是ssr代理，即（HTTP）127.0.0.1 和1080。如果以上条件都排除，还是用不了，那么可以更换端口、加密方式、协议、混淆，或者更换服务器位置。另外，如果你的vps服务器配置的是SSR账号，即有协议和混淆且没有兼容原版(SS版），那么你必须使用SSSR客户端来使用账号，因为SS客户端没有填写协议和混淆的选项。 - -3、有的地区需要把混淆参数设置成plain才好用。因为混淆不总是有效果，要看各地区的策略，有时候不混淆（plain）让其看起来像随机数据更好。 - -4、电脑能用但手机用不了 - -如果你的手机用的是SS客户端，SS客户端没有填协议和混淆的地方，如果你部署的协议和混淆的时候没有选择兼容原版（SS版），因此手机是用不了的。这个时候你把协议弄成兼容原版、混淆也设置成兼容原版即可。或者直接将协议设置成origin，混淆设置成plain。 - -5、vps的服务器操作系统不要用的太高，太高可能会因为系统的防火墙问题导致搭建的SSR账号连不上，如果你用的centos系统，建议用centos6，不要用centos7。如果你前面不小心装了centos7系统，那么只能重装系统或者重新部署新的vps服务器。 - -6、vultr服务商提供的vps服务器是单向流量计算，有的vps服务商是双向流量计算，单向流量计算对于用户来说更实惠。因为我们是在vps服务器上部署SSR服务端后，再用SSR客户端翻墙，所以SSR服务端就相当于中转，比如我们看一个视频，必然会产生流量，假如消耗流量80M，那么VPS服务器会产生上传80M和下载80M流量，vultr服务商只计算单向的80M流量。如果是双向计算流量，那么会计算为160M流量。 - -7、如果你想把搭建的账号给多人使用，不用额外设置端口，因为一个账号就可以多人使用。一般10美元的服务器可以同时支持100人在线使用。 - -如果想实现支持每个用户(端口)不同的加密方式/协议/混淆等，并且管理流量使用，可以参考多用户配置脚本：wget -N –no-check-certificate [https://softs.fun/Bash/ssrmu.sh](https://softs.fun/Bash/ssrmu.sh) && chmod +x ssrmu.sh && bash ssrmu.sh 备用脚本：wget -N –no-check-certificate [https://raw.githubusercontent.com/ToyoDAdoubi/doubi/master/ssrmu.sh](https://raw.githubusercontent.com/ToyoDAdoubi/doubi/master/ssrmu.sh) && chmod +x ssrmu.sh && bash ssrmu.sh 安装后管理命令为：bash ssrmu.sh -注意：这个多用户配置脚本和教程内容的脚本无法共存！要想用这个脚本，把之前的脚本卸载，输入管理命令bash ssr.sh ，选择3，卸载ShadowsocksR即可卸载原脚本。 - -8、vultr服务器每月有流量限制，超过限制后服务器不会被停止运行，但是超出的流量会被额外收费。北美和西欧地区的服务器超出流量后，多出的部分收费为0.01美元/G。新加坡和日本东京（日本）为0.025美元/G，悉尼（澳大利亚）为0.05美元/G。把vultr服务器删掉，开通新的服务器，流量会从0开始重新计算。 - -9、vultr怎样才能申请退款呢？ - -vultr和其他的国外商家一样，都是使用工单的形式与客服联系，如果需要退款，直接在后台点击support，选择open ticket新开一个工单，选择billing question财务问题，简单的在文本框输入你的退款理由。比如：Please refund all the balance in my account。工单提交以后一般很快就可以给你确认退款，若干个工作日后就会退回你的支付方式。（全额退款结束后，账号可能会被删除） - -如果英语水平不好，但是想和客服进行交流，可以用百度在线翻译，自动中文转英文和英文转中文。 - -10、路由器也可以配置ssr，关键的是路由器刷固件，华硕路由器刷梅林改版固件最简单，下载固件直接刷，梅林改版固件自带软件中心，然后再软件中心点离线安装就可以了（原版梅林不带软件中心 [下载](http://asuswrt.lostrealm.ca/download)）。路由器刷merlin_8wan_firmware（八万）的固件就行[KoolShare固件下载](http://firmware.koolshare.cn/) -其他的路由器也可以刷梅林。有问题或者对路由器配置ssr感兴趣的，可以在这些网站上自学：[koolshare](http://koolshare.cn/forum.php) [华硕路由爱好者社区](http://www.52asus.com/forum.php) [NAP6](https://nap6.com/portal.php) - -* * * - ->转接自：https://github.com/getlantern/forum/issues/5620 -原出处也已经被删除了 - - - diff --git a/SUMMARY.md b/SUMMARY.md deleted file mode 100644 index 501d1e0b..00000000 --- a/SUMMARY.md +++ /dev/null @@ -1,96 +0,0 @@ -# Summary - -* [为什么学Python?](/Article/PythonBasis/python0/WhyStudyPython.md) -* [Python代码规范](/Article/codeSpecification/codeSpecification_Preface.md) - - [简明概述](/Article/codeSpecification/codeSpecification_first.md) - - [注释](/Article/codeSpecification/codeSpecification_second.md) - - [命名规范](/Article/codeSpecification/codeSpecification_third.md) -* [第一个Python程序](/Article/PythonBasis/python1/Preface.md) - - [Python 简介](/Article/PythonBasis/python1/Introduction.md) - - [Python 的安装](/Article/PythonBasis/python1/Installation.md) - - [第一个 Python 程序](/Article/PythonBasis/python1/The_first_procedure.md) - - [集成开发环境（IDE）: PyCharm](/Article/PythonBasis/python1/IDE.md) -* [基本数据类型和变量](/Article/PythonBasis/python2/Preface.md) - - [Python 语法的简要说明](/Article/PythonBasis/python2/Grammar.md) - - [print() 函数](/Article/PythonBasis/python2/print.md) - - [Python 的基本数据类型](/Article/PythonBasis/python2/Type_of_data.md) - - [字符串的编码问题](/Article/PythonBasis/python2/StringCoding.md) - - [基本数据类型转换](/Article/PythonBasis/python2/Type_conversion.md) - - [Python 中的变量](/Article/PythonBasis/python2/Variable.md) -* [List 和 Tuple](/Article/PythonBasis/python3/Preface.md) - - [List（列表）](/Article/PythonBasis/python3/List.md) - - [tuple（元组）](/Article/PythonBasis/python3/tuple.md) -* [ Dict 和 Set](/Article/PythonBasis/python4/Preface.md) - - [字典(Dictionary)](/Article/PythonBasis/python4/Dict.md) - - [set](/Article/PythonBasis/python4/Set.md) -* [条件语句和循环语句](/Article/PythonBasis/python5/Preface.md) - - [条件语句](/Article/PythonBasis/python5/If.md) - - [循环语句](/Article/PythonBasis/python5/Cycle.md) - - [条件语句和循环语句综合实例](/Article/PythonBasis/python5/Example.md) -* [函数](/Article/PythonBasis/python6/Preface.md) - - [Python 自定义函数的基本步骤](/Article/PythonBasis/python6/1.md) - - [函数返回值](/Article/PythonBasis/python6/2.md) - - [函数的参数](/Article/PythonBasis/python6/3.md) - - [函数传值问题](/Article/PythonBasis/python6/4.md) - - [匿名函数](/Article/PythonBasis/python6/5.md) -* [迭代器和生成器](/Article/PythonBasis/python7/Preface.md) - - [迭代](/Article/PythonBasis/python7/1.md) - - [Python 迭代器](/Article/PythonBasis/python7/2.md) - - [lsit 生成式（列表生成式）](/Article/PythonBasis/python7/3.md) - - [生成器](/Article/PythonBasis/python7/4.md) - - [迭代器和生成器综合例子](/Article/PythonBasis/python7/5.md) -* [面向对象](/Article/PythonBasis/python8/Preface.md) - - [面向对象的概念](/Article/PythonBasis/python8/1.md) - - [类的定义和调用](/Article/PythonBasis/python8/2.md) - - [类方法](/Article/PythonBasis/python8/3.md) - - [修改和增加类属性](/Article/PythonBasis/python8/4.md) - - [类和对象](/Article/PythonBasis/python8/5.md) - - [初始化函数](/Article/PythonBasis/python8/6.md) - - [类的继承](/Article/PythonBasis/python8/7.md) - - [类的多态](/Article/PythonBasis/python8/8.md) - - [类的访问控制](/Article/PythonBasis/python8/9.md) -* [模块与包](/Article/PythonBasis/python9/Preface.md) - - [Python 模块简介](/Article/PythonBasis/python9/1.md) - - [模块的使用](/Article/PythonBasis/python9/2.md) - - [主模块和非主模块](/Article/PythonBasis/python9/3.md) - - [包](/Article/PythonBasis/python9/4.md) - - [作用域](/Article/PythonBasis/python9/5.md) -* [Python 的 Magic Method](/Article/PythonBasis/python10/Preface.md) - - [Python 的 Magic Method](/Article/PythonBasis/python10/1.md) - - [构造(`__new__`)和初始化(`__init__`)](/Article/PythonBasis/python10/2.md) - - [属性的访问控制](/Article/PythonBasis/python10/3.md) - - [对象的描述器](/Article/PythonBasis/python10/4.md) - - [自定义容器（Container）](/Article/PythonBasis/python10/5.md) - - [运算符相关的魔术方法](/Article/PythonBasis/python10/6.md) -* [枚举类](/Article/python11/PythonBasis/Preface.md) - - [枚举类的使用](/Article/PythonBasis/python11/1.md) - - [Enum 的源码](/Article/PythonBasis/python11/2.md) - - [自定义类型的枚举](/Article/PythonBasis/python11/3.md) - - [枚举的比较](/Article/PythonBasis/python11/4.md) -* [元类](/Article/PythonBasis/python12/Preface.md) - - [Python 中类也是对象](/Article/PythonBasis/python12/1.md) - - [使用 `type()` 动态创建类](/Article/PythonBasis/python12/2.md) - - [什么是元类](/Article/PythonBasis/python12/3.md) - - [自定义元类](/Article/PythonBasis/python12/4.md) - - [使用元类](/Article/PythonBasis/python12/5.md) -* [线程与进程](/Article/PythonBasis/python13/Preface.md) - - [线程与进程](/Article/PythonBasis/python13/1.md) - - [多线程编程](/Article/PythonBasis/python13/2.md) - - [进程](/Article/PythonBasis/python13/3.md) -* [一步一步了解正则表达式](/Article/PythonBasis/python14/Preface.md) - - [初识 Python 正则表达式](/Article/PythonBasis/python14/1.md) - - [字符集](/Article/PythonBasis/python14/2.md) - - [数量词](/Article/PythonBasis/python14/3.md) - - [边界匹配符和组](/Article/PythonBasis/python14/4.md) - - [re.sub](/Article/PythonBasis/python14/5.md) - - [re.match 和 re.search](/Article/PythonBasis/python14/6.md) -* [闭包](/Article/PythonBasis/python15/1.md) -* [装饰器](/Article/PythonBasis/python16/1.md) -* [知识点补漏](README.md) - - [Python 关键字 yield](/Article/supplement/Python关键字yield.md) -* [**Python 进阶部分**](/Article/advanced/advanced.md) -* [使用Python虚拟环境](/Article/advanced/使用Python虚拟环境.md) -* [Mac中使用virtualenv和virtualenvwrapper](/Article/advanced/Mac中使用virtualenv和virtualenvwrapper.md) -* [**Django**](/Article/django/Django.md) - - diff --git a/TwoWater-Python.json b/TwoWater-Python.json deleted file mode 100644 index b57bee7b..00000000 --- a/TwoWater-Python.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "title": "草根学Python", - "repo": "TwoWater/Python", - "branch": "master", - "original_url": "https://www.gitbook.com/book/twowater/python" -} \ No newline at end of file diff --git a/book.json b/book.json deleted file mode 100644 index e7b3af94..00000000 --- a/book.json +++ /dev/null @@ -1,13 +0,0 @@ -{ - "plugins": [ - "github", - "toggle-chapters", - "github-buttons", - "-highlight" - ], - "pluginsConfig": { - "github": { - "url": "https://github.com/TwoWater/Python" - } - } -} \ No newline at end of file diff --git a/feature.txt b/feature.txt new file mode 100644 index 00000000..d9552aa0 --- /dev/null +++ b/feature.txt @@ -0,0 +1 @@ +hdjdhsjhdjh