Python(2):创建函数模块

简介: 说明: 在使用python的时候我们除了使用内置的函数之外,可能还需要使用一些别人写的函数。或者我们写的代码也希望可以给其他人使用。要实现这样的功能,我们就需要按照下面的步骤来定义自己的模块:   Step1:新建一个py文件 首先我们将前面一章所写的打印列表的函数保存为一个.py文件,假设我这里保存为 kider.py。

说明:

在使用python的时候我们除了使用内置的函数之外,可能还需要使用一些别人写的函数。或者我们写的代码也希望可以给其他人使用。要实现这样的功能,我们就需要按照下面的步骤来定义自己的模块:

 

Step1:新建一个py文件

首先我们将前面一章所写的打印列表的函数保存为一个.py文件,假设我这里保存为 kider.py。

1 """
2 这是一个打印列表的函数,如果列表中有嵌套的列表也会展开打印出来
3 """
4 def print_list(movies):
5     if isinstance(movies, list):
6         for movie in movies:
7             print_list(movie)
8     else:
9         print(movies)
kider.py

如果要发布的话,最好将函数快代码添加上注释。在python里面,三引号 """ 中的字符串表注释,这个是多行注释 ,单行注释使用 # 。
这时候如果想使用该模块,最原始的办法是将前面的kider.py文件放入到本机的python模块地址。

如何知道本机的python模块放在哪,只需在IDLE(python控制台)中输入:

import sys

sys.path

sys.path的输出就是本机的python模块所在的文件

1 >>> import sys
2 >>> sys.path
3 ['', '/usr/local/lib/python3.5/dist-packages/redis-2.10.5-py3.5.egg', '/usr/lib/python35.zip', '/usr/lib/python3.5', '/usr/lib/python3.5/plat-x86_64-linux-gnu', '/usr/lib/python3.5/lib-dynload', '/home/zyq/.local/lib/python3.5/site-packages', '/usr/local/lib/python3.5/dist-packages', '/usr/lib/python3/dist-packages']
modulePath


 Step2:将py文件作为模块安装到本地
但其实我们不需要将自己写的python模块放入本机的python模块地址,可以直接通过命令来安装python模块到本机:
主要步骤如下:
》1.新建一个和准备安装的python文件同名的目录,这里取名为 kider,并且将前面的kider.py文件放入该目录下
》2. 在该目录下建立一个setup.py文件,并且编辑文件的内容大致如下:

 1 from distutils.core import setup
 2 setup(
 3     name              = 'kider',
 4     version         = '1.0.0',
 5     py_modules     = ['kider'],
 6     author        = 'KiDe',
 7     author_email    = '929557120@qq.com',
 8     url        = 'http://www.rampage.com',
 9     description    = 'KiDe\'s first test module',
10     )      
setup.py    

》3. 进入kider目录,并且使用 python3 setup.py sdist 来进行编译,编译完成之后可以发现多了很多文件和目录
》4. 使用 sudo python3 setup.py install 命令安装到本地的python模块。
》5. 接下来可以在程序中按如下方式使用python模块了:

1 import kider  
2 movies = ["haha", [1, 2, "Ha"], "movie2"];
3 kider.print_list(movies)
UseKider

为啥不能直接通过 print_list来使用刚刚发布的python模块?

  这是因为默认的在python shell中的命名空间是 __main__, 如果想要使用print_list 因为他是属于 kider 命名空间的,所以应该带上该名称空间。
不过当然你也可以使用和setup.py中的同样的语法,将命名空间中的方法引入进来,这样你就可以直接使用方法名: form kider import print_list  
但是这样存在一个风险,就是会覆盖当前名称空间的同名函数。

PS:注意到install之后其实在新生成的 __pycache__ 文件夹中多了一个 pyc文件,该文件可以当做是编译后的class文件,可以删除,但是如果删除,在执行的时候就可能损失掉对应的优化性能。
 

Step3:可选的把模块上传到pypi
现在可以把模块上传到pypi(python package index)上了:
》1. 首先需要去官网上注册一个账号  http://pypi.python.org
》2. python3 setup.py register   如果完成了第一步,那么该步骤选则选项1, 否则其实该部也可以选择2 进行直接新账号创建注册
》3. pyhton3 setup.py sdist upload  这一步进行将模块代码上传

假设选择了将代码上传到高大上的pypi,那么肯定需要对原来函数的功能进行改进,增加两个参数,一个可以指定是否需要缩进,一个可以指定缩进时tab的个数。最终版本的代码如下:

 1 """ this is KiDe's python module """
 2 
 3 """ 这个函数打印传入的参数,如果传入的参数是一个列表,则会依次打印列表中的项。
 4     支持多重嵌套的列表,会逐行依次打印出每一个嵌套列表中的所有子项。
 5 """
 6 # 第一个参数是输入的准备用来输出的对象,第二个参数表示如果对象中有子列表是否对子项采用缩进,第三个参数表示如果采用缩进,缩进的tab数量
 7 def print_list(args, level=0, indent=False):
 8     if isinstance(args, list):
 9         for arg in args:
10             print_list(arg, level+1, indent)
11     else:
12         if indent:
13             for tab_stop in range(level):
14                 print("\t", end='')
15         print(args)
kider.py

对于python指定了缺省值的参数可以省略,比如可以直接指定第三个参数而不指定第二个参数的值,此时的调用方式如下:

1 >>> import kider
2 >>> kider.print_list(['aa', 'bb', 'cc'], indent=True)
3     aa
4     bb
5     cc
Invoke

 

黎明前最黑暗,成功前最绝望!
相关文章
|
11天前
|
Python
在Python中,可以使用内置的`re`模块来处理正则表达式
在Python中,可以使用内置的`re`模块来处理正则表达式
28 5
|
21天前
|
Java 程序员 开发者
Python的gc模块
Python的gc模块
|
24天前
|
数据采集 Web App开发 JavaScript
python-selenium模块详解!!!
Selenium 是一个强大的自动化测试工具,支持 Python 调用浏览器进行网页抓取。本文介绍了 Selenium 的安装、基本使用、元素定位、高级操作等内容。主要内容包括:发送请求、加载网页、元素定位、处理 Cookie、无头浏览器设置、页面等待、窗口和 iframe 切换等。通过示例代码帮助读者快速掌握 Selenium 的核心功能。
70 5
|
27天前
|
Python
SciPy 教程 之 SciPy 模块列表 6
SciPy教程之常量模块介绍:涵盖公制、二进制(字节)、质量、角度、时间、长度、压强、体积、速度、温度、能量、功率及力学单位。示例展示了角度单位转换为弧度的几个常用常量。
19 7
|
27天前
|
Python
SciPy 教程 之 SciPy 模块列表 7
`scipy.constants` 模块提供了常用的时间单位转换为秒数的功能。例如,`constants.hour` 返回 3600.0 秒,表示一小时的秒数。其他常用时间单位包括分钟、天、周、年和儒略年。
18 6
|
24天前
|
测试技术 数据安全/隐私保护 Python
探索Python中的装饰器:简化和增强你的函数
【10月更文挑战第24天】在Python编程的海洋中,装饰器是那把可以令你的代码更简洁、更强大的魔法棒。它们不仅能够扩展函数的功能,还能保持代码的整洁性。本文将带你深入了解装饰器的概念、实现方式以及如何通过它们来提升你的代码质量。让我们一起揭开装饰器的神秘面纱,学习如何用它们来打造更加优雅和高效的代码。
|
25天前
|
Python
SciPy 教程 之 SciPy 模块列表 13
SciPy教程之SciPy模块列表13:单位类型。常量模块包含多种单位,如公制、二进制(字节)、质量、角度、时间、长度、压强、体积、速度、温度、能量、功率和力学单位。示例代码展示了如何使用`constants`模块获取零摄氏度对应的开尔文值(273.15)和华氏度与摄氏度的转换系数(0.5556)。
18 1
|
26天前
|
弹性计算 安全 数据处理
Python高手秘籍:列表推导式与Lambda函数的高效应用
列表推导式和Lambda函数是Python中强大的工具。列表推导式允许在一行代码中生成新列表,而Lambda函数则是用于简单操作的匿名函数。通过示例展示了如何使用这些工具进行数据处理和功能实现,包括生成偶数平方、展平二维列表、按长度排序单词等。这些工具在Python编程中具有高度的灵活性和实用性。
|
25天前
|
XML 前端开发 数据格式
超级详细的python中bs4模块详解
Beautiful Soup 是一个用于从网页中抓取数据的 Python 库,提供了简单易用的函数来处理导航、搜索和修改分析树。支持多种解析器,如 Python 标准库中的 HTML 解析器和更强大的 lxml 解析器。通过简单的代码即可实现复杂的数据抓取任务。本文介绍了 Beautiful Soup 的安装、基本使用、对象类型、文档树遍历和搜索方法,以及 CSS 选择器的使用。
58 1
|
26天前
|
Python
SciPy 教程 之 SciPy 模块列表 9
SciPy教程之常量模块介绍,涵盖多种单位类型,如公制、质量、角度、时间、长度、压强等。示例展示了如何使用`scipy.constants`模块查询不同压强单位对应的帕斯卡值,包括atm、bar、torr、mmHg和psi。
15 1