python使用setuptools打包并上传到PyPi版本库中

python使用setuptools打包并上传到PyPi版本库中

最近在写python的一个幻灯生成器。看到很多python的库都以setup.py和easy_install安装，便打算尝试一下。一试之下发现极端简单。所以做一些笔记。
参考的文章有:
• setuptools开发者文档
• 可爱的 Python: 使用 setuptools 孵化 Python egg
准备工作
万事开头难，要想你的python代码可以使用easy_install和setup.py，那么必须做好以下准备:
1. 安装python的setuptools包
2. 你的代码必须是在package里。也就是你的代码不能出现在根目录，应该在一个目录下，且有init.py。
书写你的setup.py脚本
本着记录我的想法的目的，我就不从Hello world开始了。我就直接将SlideGen这个库的setup.py放出来。根据每行说明一下，大家应该就懂了。

 setup(
      name='SlideGen',
      version='0.0.0.1 pre',
      packages=['slidegen'],
      author='reyoung',
      author_email='reyoung@126.com',
      license='LGPL',
      install_requires=["PyYAML>=3.10","Markdown>=2.1.1","tornado>=2.2"],
      description="A HTML5 Slide Generator in python",
      entry_points ={
        'console_scripts':[
            'SlideGen=slidegen.SlideGen:Main'
        ]
      },
      keywords ='html5 slide generator',
      url='https://github.com/reyoung/SlideGen'
)
这个代码需要在根目录中写一个叫做setup.py文件，在setup.py中包括上述代码。
在其中，必须包含一个叫做setup的函数，在这个函数中，可以对代码包的参数进行设置。一些参数的简单介绍如下：
• packages:你的代码库包括的package。这个packages可以是多个，也可以通过find_packages自动去做，不过手动也是不错的。
• install_requires:就是你的代码库需求的第三方库。如果你不记得你的代码中使用的第三方库有什么，可以使用yolk显示所有在setuptools下管理的第三方库
安装yolk可以使用easy_install yolk
查询使用easy_install管理的软件包使用命令yolk -l
• entry_points是自动生成的可执行程序，他会生成到Python*/Scripts/这个目录中。其中：
o console_scripts是生成命令行程序
o gui_scripts是生成图形界面程序
o 等于右边的格式如下："[可执行程序名]=引入的包名.子包名.模块名:入口函数"
使用setup.py
安装
在写好setup.py后，安装变得异常简单。直接使用命令python setup.py install即可以完成安装。
调试/卸载
我并没有找到使用python脚本卸载的方法，但是可以使用python setup.py install --record install.txt将所有安装的文件列在install.txt中。我们可以使用rm来删除这些文件，达到卸载的目的。
上传到PyPi的版本库
上传pypi后，其他人就可以使用easy_install XXX来安装了。
上传也非常简单，只需要一条命令。
setup.py register sdist bdist_egg upload
而使用这条命令的结果，就会将你的代码传到pypi上，需要注意的是:
• 如果你没注册pypi帐号，在命令行中他会提示你注册pypi帐号，跟着步骤来就好了。但是需要注意验证电子邮箱。
• 之后，如果你选择记住密码，他会在你的%HOME%\.pypirc中存储你的密码(linux下是~/.pypirc)，需要注意的是，他存储密码的格式不正确，需要手工的添加[server-login]这一段，格式如下
...
[server-login]
username: XXXXXX
password: XXXXXX(明文)
这样你就可以将python的代码上传到pypi版本库中了。

摘自 reyoung1110的专栏