码迷,mamicode.com
首页 > 编程语言 > 详细

零基础python之4函数重用-函数与模块(附详细的步骤和程序)

时间:2018-07-20 21:18:15      阅读:277      评论:0      收藏:0      [点我收藏+]

标签:可读性   cti   命令提示符   pip安装   窗口   letters   one   开始   接受   

4代码重用——函数与模块

重用代码是构建一个可维护系统的关键。

代码组是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’)

 

函数知识小结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))

 

安装pytest和PEP 8插件

上文中我们已经使用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

 

 技术分享图片

技术分享图片

中间的提示目前来看暂且不用管,说路径的问题。

确认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问题了。

小结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

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!