我的测试包
dokg的Python项目详细描述
我的测试包
上传包裹的步骤
1.安装所需的软件包:
Setuptools
:setuptools是一个用于创建和分发python包的包开发过程库。Wheel
:wheel包为setuptools提供一个bdist\u wheel命令。它创建.whl文件,该文件可通过pip install命令直接安装。然后我们将把相同的文件上传到pypi.org。Twine
:tween包通过https在您的系统和pypi之间提供了一个安全、经过身份验证和验证的连接。Tqdm
:这是twine内部使用的智能进度表。
sudo python -m pip install --upgrade pip setuptools wheel
sudo python -m pip install tqdm
sudo python -m pip install --user --upgrade twine
2.设置项目
- 创建文件夹结构遵循此回购协议
- 包文件示例
dokg
#!/usr/bin/env python
echo "hey there, this is my first pip package"
使脚本可执行:
chmod +x dokr
在包中创建安装文件setup.py。此文件将包含所有包元数据信息。
import setuptools
with open("README.md", "r") as fh:
long_description = fh.read()
setuptools.setup(
name = 'dokg',
version = '0.3',
scripts = ['dokg'],
author = 'Hai V.Dam',
author_email = 'haidv@tomochain.com',
description = 'My test package',
long_description = long_description,
long_description_content_type = "text/markdown",
url = 'https://github.com/naviat/dokg',
packages = setuptools.find_packages(),
classifiers = [
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 2",
"License :: OSI Approved :: MIT License",
"Operating System :: OS Independent",
],
)
3.编译包
Setuptools
:setuptools是一个用于创建和分发python包的包开发过程库。Wheel
:wheel包为setuptools提供一个bdist\u wheel命令。它创建.whl文件,该文件可通过pip install命令直接安装。然后我们将把相同的文件上传到pypi.org。Twine
:tween包通过https在您的系统和pypi之间提供了一个安全、经过身份验证和验证的连接。Tqdm
:这是twine内部使用的智能进度表。sudo python -m pip install --upgrade pip setuptools wheel
sudo python -m pip install tqdm
sudo python -m pip install --user --upgrade twine
dokg
#!/usr/bin/env python
echo "hey there, this is my first pip package"
使脚本可执行:
chmod +x dokr
在包中创建安装文件setup.py。此文件将包含所有包元数据信息。
import setuptools
with open("README.md", "r") as fh:
long_description = fh.read()
setuptools.setup(
name = 'dokg',
version = '0.3',
scripts = ['dokg'],
author = 'Hai V.Dam',
author_email = 'haidv@tomochain.com',
description = 'My test package',
long_description = long_description,
long_description_content_type = "text/markdown",
url = 'https://github.com/naviat/dokg',
packages = setuptools.find_packages(),
classifiers = [
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 2",
"License :: OSI Approved :: MIT License",
"Operating System :: OS Independent",
],
)
进入包文件夹并执行以下命令:python setup.py bdist_wheel
。这将创建如下结构:
.
├── LICENSE
├── README.md
├── build
│ ├── bdist.macosx-10.7-x86_64
│ └── scripts-3.7
│ └── dokg
├── dist
│ └── dokg-0.3-py3-none-any.whl
├── dokg
├── dokg.egg-info
│ ├── PKG-INFO
│ ├── SOURCES.txt
│ ├── dependency_links.txt
│ └── top_level.txt
└── setup.py
build
:生成包信息。dist
:包含您的.whl文件。whl文件是以wheel格式保存的包,wheel格式是用于python发行版的标准构建包格式。您可以使用pip在系统上直接安装.whl文件install some_package.whlproject.egg.info
:egg包包含编译的字节码、包信息、依赖关系链接,并捕获setup.py test命令在运行测试时使用的信息。
4.在PIP上上载
- 创建pypirc:pypirc文件存储pypi存储库信息。在主目录中创建文件
对于Windows:C:\Users\UserName\.pypirc
对于*nix:~/.pypirc
并添加以下内容。用您的用户名替换javatechy。
[distutils]
index-servers=pypi
[pypi]
repository = https://upload.pypi.org/legacy/
username = naviat
要在pypi上上载dist/*.whl文件,请使用tween:
python -m twine upload dist/*