在Pypi上发布自己的Python包

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了在Pypi上发布自己的Python包相关的知识,希望对你有一定的参考价值。


使用Python编程的都知道,Python的包安装非常的方便,一般都是可以pip来安装搞定:

sudo pip install <package name>

pip的安装请移步:https://pip.pypa.io/en/stable/installing/


 

最近因为项目上的需要,发布了一个自己的pypi Python包,这里我大致分享如何发布自己的Pypi包一般过程。

打包工作主要依赖python的一个叫setuptools的包来完成,在进行下面操作前请使用pip安装它:

sudo pip install setuptools

(这里面我都是假设你已经准备好你的代码,测试代码以及目录结构,加上我今天要分享的,就可以组成一个完整的python包)

  • 1. 第一步,就是到pypi(https://pypi.python.org/pypi)上注册自己的用户, 点击“Register”,填写自己的用户名,密码,邮件地址后,就成功了。

技术分享

记住自己的用户名和密码,后面上传的时候要输入的

  • 2. 准备setup.py/setup.conf文件,它是放在你包的根目录的,这一步至关重要,包括要发布的包名字,版本,license,描述,特性(classifier)等等,下面是我自己包的一个setup.py文件的内容,基本上只需要在这个上面修改就行了,具体如下:

#!/usr/bin/env python
# coding=utf-8

from setuptools import setup, find_packages

setup(
    name=persist-queue,
    version=__import__(persistqueue).__version__,
    description=(
        A thread-safe disk based persistent queue in Python.
    ),
    long_description=open(README.rst).read(),
    author=Peter Wang,
    author_email=[email protected],
    maintainer=Peter Wang,
    maintainer_email=[email protected],
    license=BSD License,
    packages=find_packages(),
    platforms=["all"],
    url=http://github.com/peter-wangxu/persist-queue,
    classifiers=[
        Development Status :: 4 - Beta,
        Operating System :: OS Independent,
        Intended Audience :: Developers,
        License :: OSI Approved :: BSD License,
        Programming Language :: Python,
        Programming Language :: Python :: Implementation,
        Programming Language :: Python :: 2,
        Programming Language :: Python :: 2.7,
        Programming Language :: Python :: 3,
        Programming Language :: Python :: 3.4,
        Programming Language :: Python :: 3.5,
        Programming Language :: Python :: 3.6,
        Topic :: Software Development :: Libraries
    ],
)

需要注意的上面的字段:

  • version - 这个简单,就是包的发布的版本,可以直接写在这,也可以从其他地方引用过来。
  • long_description - 必须是rst(reStructuredText )格式的,因为这个里面的内容是显示在pypi包首页上,具体rst的语法可以参考:http://rest-sphinx-memo.readthedocs.io/en/latest/ReST.html

   我的long_description是同目录下的README.rst的内容,同时这个README也是我的github项目首页。

  • packages - 申明你的包里面要包含的目录,比如  [‘mypackage‘, ‘mypackage_test]  可以是这种使用我的示例,让setuptools自动决定要包含哪些包
  • install_requires - 申明依赖包,安装包时pip会自动安装:格式如下(我上面的setup.py没有这个参数,因为我不依赖第三方包:)):
    install_requires=[
        Twisted>=13.1.0,
        w3lib>=1.17.0,
        queuelib,
        lxml,
        pyOpenSSL,
        cssselect>=0.9,
        six>=1.5.2,
        parsel>=1.1,
        PyDispatcher>=2.0.5,
        service_identity,
    ]

 

3. 准备requirements.txt 和 test-requirements.txt,这个申明包的依赖包和跑自动化测试的测试依赖包,具体格式示例如下:

mock>=2.0.0
flake8>=3.2.1
eventlet>=0.19.0
nose2>=0.6.5
cov_core>=1.15.0
virtualenv>=15.1.0

以上是我的test-requirements.txt的内容,requirements.txt的格式个上面一样。

准备这个两个文件不是必须的。

但是,有了它们,用户可以自己手动安装依赖包

pip install -r requirements.txt

有了它们,结合tox等工具,可以非常方便的加入自动化测试。 

  • 4. 准备一个项目的README.rst文件,前面也提到了它的格式要求,第一次发包,可以直接copy别人的格式,这东西熟能生巧,多写就会了。

下面是我的README的截图,就长这个样子:

技术分享

 

  • 5. 准备好上面的步骤,一个包就基本完整了,剩下的就是打包了(cd到包的根目录):

可以使用下面命令打包一个源代码的包:

python setup.py sdist build

这样在当前目录的dist文件夹下,就会多出一个以tar.gz结尾的包了:

也可以打包一个wheels格式的包,使用下面的命令搞定:

python setup.py bdist_wheel --universal

这样会在dist文件夹下生成一个whl文件,

  • 6. 上传生成的包,可以使用setuptools,或者twine上传,推荐使用twine上次,因为使用setuptools上传时,你的用户名和密码是明文或者未加密传输,安全起见还是使用twine吧

# 上传source 包
python setup.py sdist upload
# 上传pre-compiled包
python setup.py bdist_wheel upload

使用twine上传,先安装twine

sudo pip install twine

twine upload dist/*

上次前都会提示你前面注册的用户名和密码。一切搞定,你的包现在可以通过pip在任何地方安装了。

 


 

后续

其实对于一个包,你要长久维护,自动测试肯定要加入,后面有时间再分享下如何使用tox的使用和与第三方CI的集成。

 

引用链接:

pypi详细教程: https://packaging.python.org/distributing

我的开源python包: https://github.com/peter-wangxu/persist-queue

 



以上是关于在Pypi上发布自己的Python包的主要内容,如果未能解决你的问题,请参考以下文章

如何将自己的Python代码打包发布到pypi上

在 Pypi 上注册一个内部包

Pypi:我可以声称自己是未维护包的新维护者吗?

Python 第三方包上传至 PyPI 服务器

如何在 PyPi 上更新 Python 包?

Python 库打包分发简易指南