首頁 > 軟體

python程式的打包分發範例詳解

2022-06-28 14:00:22

引言

python程式設計時,一部分人習慣將實現同一個功能的程式碼放在同一個檔案;

使用這些程式碼只需要import就可以了;

下面看一個例子。

testModel.py

class Test:
    name = 'tom'
    age = 0
    __weight = 0
    def __init__(self,n,a,w):
        self.name = n
        self.age = a
        self.__weight = w
    def speak(self):
        print("Test model: ",self.name,self.age, self.__weight)

接著,參照上面的程式碼:

import testModel
testModel.Test("tom", 0, 1).speak()
# Test model:  tom 0 1

python程式打包

  • 新建一個資料夾testPackages;
  • testPackages下新建一個空檔案__init__.py,宣告這是一個python包
  • testPackages下新建一個空檔案testModel.py,用於存放函數程式碼
testPackages/
        ├── __init__.py
        └── testModel.py

接著,參照上面的程式碼:

from testPackages import testModel
testModel.Test("tom", 0, 1).speak()
# Test model:  tom 0 1

 __init__.py檔案的作用

__init__.py的作用就是申明這是一個包;

每次匯入包之前都會先執行__init__.py,因此可以在其中申明一些定義,比如變數或介面;

下面我們看一個__init__.py的使用例子

testPackages/
        ├── __init__.py
        ├── add.py
        └── testModel.py

add.py

def add(a, b):
    return a + b

__init__.py

import testPackages.add
add = testPackages.add.add

接著,參照上面的程式碼:

import testPackages
testPackages.add(1,2)
# 3

構建python包

使用setuptools構建python包

packaging_tutorial/
├── LICENSE
├── pyproject.toml  #使用什麼工具(pip或build)構建專案
├── README.md
├── src/
│   └── example_package/
│       ├── __init__.py
│       └── example.py
└── tests/  #例子資料

pyproject.toml

[build-system]
requires = ["setuptools>=42"]
build-backend = "setuptools.build_meta"

setup.py是setuptool的構建指令碼,用於設定包的基本資訊:名字,版本和原始碼地址

import setuptools
with open("README.md", "r", encoding="utf-8") as fh:
    long_description = fh.read()
setuptools.setup(
    name="testPackages",
    version="2.2.1",
    author="Author",
    author_email="author@example.com",
    description="A small example package",
    long_description=long_description,
    long_description_content_type="text/markdown",
    url="http://baidu.com/",
    classifiers=[
        "Programming Language :: Python :: 3",
        "License :: OSI Approved :: MIT License",
        "Operating System :: OS Independent",
    ],
    package_dir={"": "src"},
    packages=setuptools.find_packages(where="src"),
    python_requires=">=3.6",
)

setup()引數:

package_dir:字典,key是包名,value是一個資料夾;

packages:分發包需要匯入的所有模組列表;可以手動輸入,也可以使用find_packages函數自動尋找package_dir下的所有包或模組。

生成分發包

python3 setup.py sdist

本地安裝

python3 -m pip install ./dist/testPackages-2.2.1.tar.gz

呼叫

from testPackages import add
add.add(1,2)
# 3
#在__init__.py構建了add = testPackages.add.add,所以可以直接使用
add(1,2)
# 3

參考 Packaging Python Projects

以上就是python程式的打包分發範例詳解的詳細內容,更多關於python程式打包分發的資料請關注it145.com其它相關文章!


IT145.com E-mail:sddin#qq.com