10分钟制作开源pip包

简介: 10分钟制作开源pip包

一、了解PyPI

96447814-120fc980-1245-11eb-938d-6ea408716c72.png

可以理解为它是一个包管理平台,我们常用的所有的包都会托管在这个平台,我们通过pip install xx 它会在PyPI找到这个包并下载到我们的电脑上。

二、流程分析

对于模块开发者本质上要做三件事:

  • 把冰箱门打开
  • 把大象放进去
  • 把冰箱门关上
  • 对于模块开发者本质上要做三件事:
  • 编写模块
  • 将模块进行打包
  • 上传到PyPI(需要先注册PyPI账号)
  • 注册PyPI账号
  • 安装上传工具
  • 基于工具进行上传
  • 对于模块的使用者来说,只需要做2件事:
  • 通过 pip install 模块 去安装模块
  • 调用模块

三、制作开源模块

现在,假设我们制作一个名为fucker的模块。

第一步 项目文件夹

要求目录结构如下:

fucker
├── LICENSE           # 声明,给模块使用者看,说白了就是使用者是否可以免费用于商业用途等。
├── README.md         # 模块介绍
├── demos             # 使用案例
├── fucker            # 模块代码目录
│   └── __init__.py
└── setup.py          # 给setuptools提供信息的脚本(名称、版本等)

1.1 LICENSE

LICENSE文件就是咱们模块的许可证,给模块使用者看,说白了就是使用者是否可以免费用于商业用途等。一般开源的软件会选择相对宽泛许可证 MIT,即:作者保留版权,无其他任何限制。

Copyright (c) 2018 The Python Packaging Authority
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

更多其他许可证参见:Choose an open source license | Choose a License

1.2 README

readme就是对于当前模块的描述信息,一般用于markdown格式编写,如:

fucker是一个吊炸天的工具...

此文件也可以写模块的简单使用手册,如果手册太复杂建议再创建一个doc文件夹存放使用手册。

1.3 demos目录

demos一般会写一些该模块使用的示例,用于使用者快速可以将模块应用到生成中。

1.4 setup.py

setup.py文件其实是一个配置文件,用于给setuptools提供一些模块相关的信息,如:模块名称、模块版本、适用的python版本、作者、github地址等。

import setuptools
with open("README.md", "r") as fh:
    long_description = fh.read()
setuptools.setup(
    name="fucker",  # 模块名称
    version="1.0",  # 当前版本
    author="wupeiqi",  # 作者
    author_email="wupeiqi@live.com",  # 作者邮箱
    description="一个非常NB的包",  # 模块简介
    long_description=long_description,  # 模块详细介绍
    long_description_content_type="text/markdown",  # 模块详细介绍格式
    # url="https://github.com/wupeiqi/fucker",  # 模块github地址
    packages=setuptools.find_packages(),  # 自动找到项目中导入的模块
    # 模块相关的元数据
    classifiers=[
        "Programming Language :: Python :: 3",
        "License :: OSI Approved :: MIT License",
        "Operating System :: OS Independent",
    ],
    # 依赖模块
    install_requires=[
        'pillow',
    ],
    python_requires='>=3',
)

注意:setuptools是一个包管理工具,可用于打包和安装模块。

1.5 fucker目录

插件内容,可以将相关代码在此处编写,如:wp.py

def func():
    print("一个神奇的包")

最后的文件夹如下:

fucker
├── LICENSE
├── README.md
├── demos
├── fucker
│   ├── __init__.py
│   └── wp.py
└── setup.py

96447814-120fc980-1245-11eb-938d-6ea408716c72.png

第二步 代码打包&上传

上述步骤中将文件夹和代码编写好之后,就需要对代码进行打包处理。

2.1 安装打包工具(已有无需重复安装)

打包代码需先安装setuptools和wheel两个工具,可以单独安装,也可以安装pip,从而自动安装这两个工具。


Securely Download get-pip.py [1]

Run python get-pip.py. [2] This will install or upgrade pip. Additionally, it will install setuptools and wheel if they’re not installed already.

详见:Installing Packages — Python Packaging User Guide

注意:已安装用户,如要更新setuptools和wheel两个工具,可通过如下命令:

python -m pip install --upgrade setuptools wheel

2.2 打包代码

之后在pycharm的Terminal终端输入:

python setup.py sdist bdist_wheel

此时生成如下文件:

96447814-120fc980-1245-11eb-938d-6ea408716c72.png

fucker
├── LICENSE
├── README.md
├── fucker
│   ├── __init__.py
│   └── wp.py
├── fucker.egg-info
│   ├── PKG-INFO
│   ├── SOURCES.txt
│   ├── dependency_links.txt
│   └── top_level.txt
├── build
│   ├── bdist.macosx-10.6-intel
│   └── lib
│       └── fucker
│           ├── __init__.py
│           └── wp.py
├── demos
├── dist
│   ├── fucker-0.0.1-py3-none-any.whl
│   └── fucker-0.0.1.tar.gz
└── setup.py

2.3 发布模块(上传)

文件打包完毕后,需要将打包之后的文件上传到PyPI,如果想要上传是需要先去 PyPI · The Python Package Index 注册一个账号。

  • 安装用于发布模块的工具:twine 【已安装无需重复安装】
python -m pip install --upgrade twine
pip install --upgrade twine
# 提示:python -m 的作用是 run library module as a script (terminates option list)
  • 发布
python -m twine upload --repository-url https://upload.pypi.org/legacy/  dist/*
twine upload --repository-url https://upload.pypi.org/legacy/  dist/*

上传时,提示需要输入PyPI的用户名和密码

96447814-120fc980-1245-11eb-938d-6ea408716c72.png

第三步 安装使用

3.1 安装

  1. pip install 模块

3.2 应用

from fucker import wp
wp.func()
相关文章
|
27天前
|
并行计算 Ubuntu 开发工具
Jetson学习笔记(一):jetson 系列镜像下载、烧写、设置散热风扇、中文包、pip、中转英目录、软件源、显示CSI摄像头
关于NVIDIA Jetson系列设备的入门学习笔记,涵盖了从下载镜像、烧录、设置散热风扇、安装中文语言包、配置环境变量、安装CUDA和OpenCV,到显示CSI摄像头和增加Swap交换空间的详细步骤。
48 0
Jetson学习笔记(一):jetson 系列镜像下载、烧写、设置散热风扇、中文包、pip、中转英目录、软件源、显示CSI摄像头
|
3月前
|
存储 Linux 网络安全
常用的 Python 工具:使用 virtualenv、使用 Pip 进行安装和管理包
常用的 Python 工具:使用 virtualenv、使用 Pip 进行安装和管理包
35 0
|
4月前
|
文字识别 Python
python -m pip ,SyntaxError: invalid syntax,下载需要pip的包
python -m pip ,SyntaxError: invalid syntax,下载需要pip的包
|
6月前
|
Python
python(pip)包/模块:如何离线安装?
python(pip)包/模块:如何离线安装?
91 0
|
6月前
|
Python Windows
Python分发包安装pip3
Python分发包安装pip3
33 0
|
Python
安装python包管理工具pip
安装python包管理工具pip
87 1
|
6月前
|
Python
【Python笔记】pip intall -e命令:让你的工程直接使用开源包的源码,可断点调试,修改源码!
【Python笔记】pip intall -e命令:让你的工程直接使用开源包的源码,可断点调试,修改源码!
209 0
|
6月前
|
机器学习/深度学习 缓存 程序员
Python包管理工具 pip 及其常用命令和参数用法
Python包管理工具 pip 及其常用命令和参数用法
305 0
|
6月前
|
Unix iOS开发 MacOS
「Python系列」Python pip(包管理工具)、Anaconda介绍
Python pip是一个现代的、通用的Python包管理工具,用于查找、下载、安装、卸载Python包。它支持从PyPI(https://pypi.org/)、版本控制、本地项目以及直接从分发文件进行安装。pip是一个命令行程序,安装后,会向系统添加一个pip命令,该命令可以从命令提示符运行。
149 0
|
6月前
|
安全 iOS开发 MacOS