下面是一个初始模板(别担忧,稍后会举办具体搜查)
- """Setup for the chocobo package."""
- import setuptools
- with open('README.md') as f:
- README = f.read()
- setuptools.setup(
- author="Shay Palachy",
- author_email="shay.palachy@gmail.com",
- name='chocobo',
- license="MIT",
- description='chocobo is a python package for delicious chocobo recipes.',
- version='v0.0.3',
- long_description=README,
- url='https://github.com/shaypal5/chocobo',
- packages=setuptools.find_packages(),
- python_requires=">=3.5",
- install_requires=['requests'],
- classifiers=[
- # Trove classifiers
- # (https://pypi.python.org/pypi?%3Aaction=list_classifiers)
- 'Development Status :: 4 - Beta',
- 'License :: OSI Approved :: MIT License',
- 'Programming Language :: Python',
- 'Programming Language :: Python :: 3.5',
- 'Programming Language :: Python :: 3.6',
- 'Topic :: Software Development :: Libraries',
- 'Topic :: Software Development :: Libraries :: Python Modules',
- 'Intended Audience :: Developers',
- ],
- )
起首,导入setuptools。这是一个很是有效代码包,可轻松对Python包举办刊行,纵然它不包罗在尺度库中(相同的distutils是比不了的),它如故是当今Python包刊行的尺度,应该紧记于心。本文只行使了setuptools包中的两个函数:setup和find_packagges。
在导入setuptools之后,挪用setup()函数之前,只需将README.md 文件的内容读入到全局变量 README中即可。
然后只需通过以下变量挪用setuptools.setup() 函数即可:
- author:输入姓名。
- author_email:输入邮箱。
- name:代码包的名称,在本例中为“chocobo”。
- license:在本例中为字符串“MIT”,或选择其他容许证。
- description:代码包的简短先容,节制在一行以内。譬喻:“chocobo代码包是建造鲜味chocobo的食谱”
- version:暗示封装的当前版本的字符串。笔者在之后的文章中会先容更简捷的处理赏罚要领,可是今朝,只必要在想要宣布新版本时手动增进一个数字就可以了。凡是的做法是将版本号前插手字母V,因此v1是第一个版本的版本字符串,但笔者提议将v0.0.1 视为等效版本字符串并行使此名目。后文将具体先容这种做法的意义。
- long_description:暗示README的内容。该部门是代码包的具体描写。也就是该页面PyPI的内容(示例:https://pypi.org/project/pdpipe/)。
- url:可链接到代码包的主页。假如读者没有专用的站点,那么存储库的URL是一个不错的选择。
- packages: 又一次提到了setuptools!按照呼吁,这个参数获取要天生和刊行/安装的全部代码包的名称数组。从技能上讲,可以直接行使[“chocobo”]这个名字,可是最好是将其通用化,并行使setuptools 函数,它能处理赏罚更伟大的包和存储库布局。有两个可选参数可以作为输入数据,where 和exclude,但在这里忽略不计。作为功效,where可链接至安装文件地址的目次,包罗全部子目次,一样平常来嗣魅这样已经足够了。
- python_requires: 假如你的电脑支持Python的全部版本,就不必顾及此参数。假如不能,应该选择一个恰当的值。从技能上讲,笔者不同意行使未经测试的版本,但保险时代今朝我们可以举办恰当的假设:
(1) 假如读者正在行使Python2,出格是Python2.7版本,可以得出以下两点结论:(a)你独树一帜,异常优越(b)你的电脑设置只需支持Python2.7即可,以是可以行使“>=2.7”这个字符来编辑这个参数。其它,期间在前进,试试Python3吧。
(编辑:湖南网)
【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容!
|