标签:可读性 cti 命令提示符 pip安装 窗口 letters one 开始 接受
重用代码是构建一个可维护系统的关键。
代码组是Python中对块的叫法。
对之前的vowels代码功能创建一个函数名为search_for_vowels( )
在函数调用时结果:
Bool内置函数,提供某个值时它会返回这个值计算为true还是false。
关于真假:
Python中的每一个对象都有一个关联的真值,表示这个对象计算为true或false。
如果计算值为0、值None、空串或一个内置的数据结构,则为false。
任何非空的数据结构都是true。
‘‘‘FUNC:return a boolean based on any vowels found.‘‘‘
def search_for_vowels(word):#用def开始,定义一个函数
#这个函数暂时没有参数, 所以这个列表为空
vowels=set(‘aeiou‘)#vowels=[‘a‘,‘e‘,‘i‘,‘o‘,‘u‘]
found=vowels.intersection(set(word))
return bool(found)#会返回一个布尔值,有元音时为真,否则为假。
最后两行还可以精简:
return vowels.intersection(set(word))
回忆内置数据结构:
注意是l(字母L)而不是1(数字),list()内置函数用来定义一个空列表。
列表用 [ ] 表示,赋值用 [ ] 包围;
dict()内置函数用来定义一个空字典,用 { } 表示,赋值用{ } 包围;
set()内置函数用来定义一个空集合,用 ()表示,赋值用{ } 包围;
Tuple()内置函数用来定义一个空元组,用()表示,赋值用()包围。
在参数后加:str 表示希望参数是一个字符串
第二行后面添加了一些内容,->set表示这个函数会返回一个集合。
在IDLE编辑窗口使用help(函数名)来查看函数的注释和注解。
ü 函数是命名的代码块。
ü def关键字用来命名函数,函数代码在def关键字下缩进。
ü Python中’’’可以用来增加多行注释。
ü 函数可以接受任意多个命名参数,也可以没有参数。
ü Return语句允许函数返回任意多个值(也可以不返回任何值)。
ü 函数注解可以用来描述函数参数的类型以及函数的返回类型。
现在函数的版本如下:
def search_for_vowels(word:str)->set:
‘‘‘FUNC:display any vowels found in an asked-for word.‘‘‘
vowels=set(‘aeiou‘)
return vowels.intersection(set(word))
建立一个通用的函数:允许用户指定要搜索的字母集合,而不总是使用五个元音。
PEP8建议所有顶层函数上下都有两个空行,这是一些默认的规定,便于程序的可读。
def search_for_letters(phrase:str,letters:str=‘aeiou‘)->set:
‘‘‘FUNC:return a set of ‘letters‘ found in ‘phrase‘ . ‘‘‘
return set(letters).intersection(set(phrase))
#set(letters),从letters中创建一个集合对象。
#intersection是取两个集合中的交集。
#最后利用return语句将这个交集操作的结果返回给调用代码。
#letters:str=‘aeiou‘是给letters提供一个默认值,不指定时使用aeiou
关于赋值:
在shell界面调用时输入:函数名(‘参数1’,‘参数2’)
这是位置赋值,根据函数定义时的顺序进行赋值。
关键字赋值时不需要保持顺序:
函数名(关键字1=‘参数1’,关键字2=‘参数2’)
ü 函数可以隐藏复杂性,可以把一行复杂的代码抽象成一个简单的函数使用。
ü 任何函数都可以在def行赋一个默认值。
ü 赋值时有两种方法,不指定关键字时按照顺序赋值。
创建模块
首先建一个文件夹mymodules,然后把刚才的文件放在里面,
导入模块直接调用即可
必须切换到模块的目录下,才可以导入模块,如果目录有误或无该模块,会报错。
现在给window上创建一个发布文件:
首先给文件夹mymodules中需要三个文件
Setup.py中:
README.txt为空文件即可。
vsearch.py中:
然后在命令提示符中切换到该目录下然后输入python setup.py sdist:
切换使用cd + 路径
python setup.py sdist
最后的结果表示一切正常,现在三个文件已经合并到一个发布文件中,这是一个可安装的文件,包含了模块的源代码,名为vsearch-1.0.tar.gz,在刚才的文件夹里已经创建了一个叫dist文件夹,
下来安装发布文件:
python -m pip install vsearch-1.0.tar.gz
ü 模块就是将一个或多个函数保存在文件中。
ü 将模块安装到site-packages,将允许导入模块并使用模块中的函数,而不论当前的工作目录。
记得之前提到过的PEP 8插件,这是一个用来检查Python代码编码规范的工具,当符合这个原则时,则证明我们的代码更加的标准,可读性和兼容性也更强,若是每个人对于同一个功能的代码差距非常大,那么就不是我们学习Python的初衷了,标准化有很多好处。
回顾之前的vsearch.py代码:(我删除了后面的#开头的注释)
def search_for_vowels(phrase:str)->set:
‘‘‘FUNC:display any vowels found in an asked-for word.‘‘‘
vowels=set(‘aeiou‘)
return vowels.intersection(set(phrase))
def search_for_letters(phrase:str,letters:str)->set:
‘‘‘FUNC:return a set of ‘letters‘ found in ‘phrase‘ . ‘‘‘
return set(letters).intersection(set(phrase))
上文中我们已经使用pip工具把vsearch.py模块安装到计算机的Python解释器中。Pip工具还可以用来为解释器安装第三方代码。
现在使用pip安装pytest测试框架和PEP 8插件:
搜索cmd.exe右键使用管理员身份运行
py -3 -m pip install pytest
经过一番安装之后,系统提示pip版本有些低,所以根据提示更新pip:
python -m pip install --upgrade pip
更新完成:
下来安装PEP8插件:
python -m pip install pytest-pep8
中间的提示目前来看暂且不用管,说路径的问题。
下来从重新打开一个命令提示符,切换到vsearch.py所在的目录下,我的路径在桌面
文件里的内容是:
这个相信不陌生吧,就是之前创建模块的那个文件夹。
下来检查我们代码的兼容性:
py.test --pep8 vsearch.py
好像报了很多的错误,看来我们自己编写的代码是不符合兼容性要求的,下来针对每个问题进行分析。
第一个错误是:2:29 missing whitespace after ‘:’
也就是说在:之后需要加一个空格。
查看之前的代码
错误提示的2:29是第二行第29个字符也就是图中标注的位置之后缺少一个空格,我把类似的位置后面的空格都补充上。又检查了一遍。
第二个错误是:3:1 indentation contains tabs
tab有问题,删了那个tab(后面提到,这个办法是有问题的)
第三个错误:4:1 也多了一个tab
第四个错误:4:8 missing whitespace around operator
指到了那个等号,看来等号两端需要加空格。
后 面的问题是:逗号之后也需要加空格。最后面需要加一个空行。
出了一个问题:修正了所有的错误还有问题,就是tab键的问题,现在程序是这样:
def search_for_vowels(phrase: str)->set:
‘‘‘FUNC:display any vowels found in an asked-for word.‘‘‘
vowels = set(‘aeiou‘)
return vowels.intersection(set(phrase))
def search_for_letters(phrase: str, letters: str)->set:
‘‘‘FUNC:return a set of ‘letters‘ found in ‘phrase‘ . ‘‘‘
return set(letters).intersection(set(phrase))
报的错误是这样:
说的都是一个内容,我想是不是TAB键的空格数不符合兼容性要求呢?
百度上说把tab换成四个空格,终于好了!
这下变绿了(哈哈)也即是说,现在这个代码不存在PEP8问题了。
函数注释的提示冒号之后需要一个空格;
等号两端需要空格;
逗号之后需要空格;
tab不如四个空格规范,可能是编辑器的问题;
最后需要一个空行;
每个函数前面要加两个空行;
上期回顾:3结构化数据 https://www.cnblogs.com/sebastiane-root/p/9267783.html
至此,内容就结束了,下期预告:构建web应用
零基础python之4函数重用-函数与模块(附详细的步骤和程序)
标签:可读性 cti 命令提示符 pip安装 窗口 letters one 开始 接受
原文地址:https://www.cnblogs.com/sebastiane-root/p/9343461.html