创建自己的python模块，并使用pip install安装到python环境（实例教程）
摘要：这篇文章描述了自己动手把需要的代码封装成python模块的方法。完成后，我们可以直接使用pip install xxx下载自己的模块并使用内置的函数。
介绍
python作为一门鼎鼎大名的语言，最有优势的地方就是它拥有无数第三方的模块可以直接拿来使用。以numpy（一个用于实现科学计算的模块）为例，常见的用法一般是这样，相信写过python的肯定是见得多了。
import numpy from numpy import core
要使用这样外部的模块，我们通常使用pip install或者 easy_install 命令安装相关的外部文件。这个命令实际上是从python的资源管理库中下载需要的python模块。
使用python包模块有很多好处：
可以使用pip之类的命令来管理和安装python模块，避免手动管理引用文件。 方便共享我们的python包。 在一个模块中可以添加文档。 在python包与包之间有很多的相互依赖，引入包模块可以预先加载所有需要的包，避免由于模块之间依赖造成的问题。
最近在导师的一个项目里，需要从一个复杂的json格式的文件中提取大量格式化数据。为了方便重复的数据提取，我写了一个python模块，于是记录一下整个把自己写的python包发布到pip资源管理站上的过程。
注意：这个发布的过程只在python 2.7版本上经过测试，对于python 3.x 版本可能会有错误。请谨慎使用。
创建pip目录结构
要把自己的包发布到pip上，需要满足以下几个条件：
目录下的所有文件名均为英文小写 不包含下划线，空格和特殊字符 选定的包名在pypi网站上没有使用过，可以访问官网，搜索一下想用的名字有没有被占用。
我的python包名叫做clinicaltrial，目录结构如下：我们先创建空文件，指定以下的名字
clinicaltrial/
clinicaltrial/
__init__.py
setup.py
其中主目录是整个包的根目录，setup.py是部署到pip需要的配置文件，子目录clinicaltrial是真正的python代码位置。
我们在__init__.py中写入代码：
def start():
print("import successful")
然后在setup.py文件中写入以下配置信息（参数里的内容可以修改，可以添加的参数具体可以参考python官方文档）
from setuptools import setup
setup(name='clinicaltrial',
version='0.1',
description='clinical trial information retriver',
url='https://github.com/tongling/clinicaltrial',
author='ling',
author_email='tonglingacademic@gmail.com',
license='mit',
packages=['clinicaltrial','filter'],
zip_safe=false)
然后打开命令行，切换到当前目录，输入
pip install .
然后，在我们的上，就可以导入这个包了：
import clinicaltrial clinicaltrial.start()
发布python模块
然后，我们在pypi官网上发布我们的包。我的包在这里，可以先看一下。
首先我们登录官网，在右边菜单点击register，注册一个账号。
然后在命令行中切换到当前目录，输入：
$ python setup.py sdist
这条命令会创建clinicaltrial-0.1.tar.gz文件，这个文件待会儿将上传到网站上。
然后输入命令，上传我们的文件：
$ python setup.py sdist upload
上传成功后，全世界所有人都可以使用pip下载你的包啦！只要输入
$ pip install clinicaltrial
就可以下载你的模块到任何python环境上。
小结
至此，用最简单的方法创建自己的python包，基本设置就完成了。但是想要让python包真正用起来，还需要增加这个包里面更多的内容。通常来说，在__init__.py编写一些初始运行脚本，增加包的使用文档和一些测试工具都是非常必要的内容。
今天就先到这里啦！后面我会介绍更多关于python之间模块依赖，.gitignore，以及编写模块测试的方法。玩的愉快！