：PyODPS製作第三方包

安裝完PyODPS後，您可以在本地命令列中使用以下命令為Python 3打包pandas以及pandas的依賴項。

• 使用Docker模式打包：

  pyodps-pack pandas

• 使用非Docker模式打包：

  pyodps-pack --without-docker pandas

• 打包時指定所需版本：

  pyodps-pack pandas==1.2.5

經過一系列的打包步驟，工具會顯示包中的所有依賴版本，具體如下。並在目前的目錄中產生一個packages.tar.gz檔案，其中包括下面列出的所有依賴專案。

Package         Version
--------------- -------
numpy           1.21.6
pandas          1.2.5
python-dateutil 2.8.2
pytz            2022.6
six             1.16.0

如果您希望為Python 2.7打包，請確定包的後續使用環境為MaxCompute還是DataWorks，辨別方法請參考PyODPS DataFrame的代碼運行環境。

• 在MaxCompute中使用Python 2.7包的打包命令：

  pyodps-pack --mcpy27 pandas

• 在DataWorks中使用Python 2.7包的打包命令：

  pyodps-pack --dwpy27 pandas

樣本：以基於pyproject.toml組織的專案為例，為您介紹如何使用pyodps-pack打包。假定專案的目錄結構如下：

test_package_root
├── test_package
│   ├── __init__.py
│   ├── mod1.py
│   └── subpackage
│       ├── __init__.py
│       └── mod2.py
└── pyproject.toml

其中pyproject.toml內容可能為：

[project]
name = "test_package"
description = "pyodps-pack example package"
version = "0.1.0"
dependencies = [
    "pandas>=1.0.5"
]

完成包的開發後，使用以下命令可以將此包和所有依賴打包進packages.tar.gz檔案中（path_to_package為test_package_root的上級路徑）：

pyodps-pack /<path_to_package>/test_package_root

pyodps-pack支援打包遠程Git代碼倉庫（例如GitHub）中的代碼。以PyODPS本身為例，可以使用以下命令執行打包：

pyodps-pack git+https://github.com/aliyun/aliyun-odps-python-sdk.git

如果想要打包某個分支或者Tag，可以使用：

pyodps-pack git+https://github.com/aliyun/aliyun-odps-python-sdk.git@v0.11.2.2

如果打包前需要安裝一些打包依賴（例如cython），可以使用--install-requires參數增加安裝時依賴。也可以編寫一個格式與requirements.txt相同的install-requires.txt檔案，並使用--install-requires-file選項指定。例如，如果需要先安裝Cython再打包PyODPS，可以執行如下命令：

pyodps-pack \
    --install-requires cython \
    git+https://github.com/aliyun/aliyun-odps-python-sdk.git@v0.11.2.2

也可以建立一個install-requires.txt檔案並依照requirements.txt格式編寫如下：

cython>0.29

打包命令可以寫成：

pyodps-pack \
    --install-requires-file install-requires.txt \
    git+https://github.com/aliyun/aliyun-odps-python-sdk.git@v0.11.2.2

一部分包包含額外的二進位依賴，例如需要編譯或安裝的外部動態連結程式庫。pyodps-pack提供了--run-before參數用以指定打包前需要執行的步驟，該步驟中可以安裝所需的二進位依賴。下面以地理資訊庫GDAL為例為您介紹如何打包。

1. 確定打包時需要安裝的二進位依賴。

   根據GDAL 3.6.0在PyPI上的文檔，我們需要安裝3.6.0以上版本的libgdal。libgdal編譯說明則指出，該包依賴6.0版本以上的PROJ包，這兩個二進位包均使用CMake打包。據此，編寫二進位包安裝檔案並儲存為install-gdal.sh：

   #!/bin/bash
   set -e
   
   cd /tmp
   curl -o proj-6.3.2.tar.gz https://download.osgeo.org/proj/proj-6.3.2.tar.gz
   tar xzf proj-6.3.2.tar.gz
   cd proj-6.3.2
   mkdir build && cd build
   cmake ..
   cmake --build .
   cmake --build . --target install
   
   cd /tmp
   curl -o gdal-3.6.0.tar.gz http://download.osgeo.org/gdal/3.6.0/gdal-3.6.0.tar.gz
   tar xzf gdal-3.6.0.tar.gz
   cd gdal-3.6.0
   mkdir build && cd build
   cmake ..
   cmake --build .
   cmake --build . --target install

2. 使用pyodps-pack進行打包，命令如下：

   pyodps-pack --install-requires oldest-supported-numpy --run-before install-gdal.sh gdal==3.6.0

下面列出pyodps-pack命令的可用參數，可用於控制打包過程：