49 lines
1.9 KiB
Markdown
49 lines
1.9 KiB
Markdown
---
|
||
author: deng
|
||
date: "20250109"
|
||
category: Note
|
||
tags:
|
||
- Python
|
||
- Nox
|
||
- FlexibleTest
|
||
- Versioning
|
||
---
|
||
|
||
|
||
[image resource](https://nox.thea.codes/en/stable/index.html)
|
||
|
||
- Abstract
|
||
- 在將Python專案打包時會遇到填寫依賴套件及其版本的問題，開發者必須逐一測試Python版本與依賴套件版本之間（甚至是跨平台）不同組合的可運行性，而Nox可以將這一流程自動化
|
||
- Steps
|
||
1. 在開發環境中安裝Nox（`python -m pip install nox`）
|
||
2. 在Package資料夾中產生*noxfile.py* 並撰寫測試程式碼（範例程式碼可見Note）
|
||
3. 於終端機輸入`nox` 開始進行測試
|
||
- Note
|
||
- 若只想執行某個函式的程式碼，可執行`nox -s [function_name]`
|
||
- 若想將測試結果輸出檔案（測試組合很多的時候很適合），可執行`nox --report [file_name].json`
|
||
- 小知識，如果semantic version沒有給patch的話，則其為0（比方說我們要測試的numpy版本設為1.24，則其實際測試的版本為1.24.0）
|
||
- 測試的環境會放在`.nox`裡（通常以python搭配套件名稱進行資料夾命名，若套件太多則會hash成短名稱），如果使用`reuse_venv`則nox會去重新使用這些環境檔進行測試，可節省重新建立環境的時間
|
||
- 以下為*noxfile.py*範例程式碼（透過環境是否能順利通過單元測試來判別套件之間的匹配性）
|
||
|
||
```python
|
||
# noxfile.py
|
||
#
|
||
# author: deng
|
||
# date : 20250110
|
||
|
||
import nox
|
||
|
||
|
||
@nox.session(venv_backend='conda', python=['3.10', '3.11', '3.12'])
|
||
@nox.parametrize('numpy', ['1.26', '2.0'])
|
||
@nox.parametrize('scikit_learn', ['1.5', '1.6'])
|
||
def test_flexibility(session, numpy, scikit_learn):
|
||
|
||
# Install package dependencies
|
||
session.install(f'numpy=={numpy}')
|
||
session.install(f'scikit-learn=={scikit_learn}')
|
||
|
||
# Test
|
||
session.install('pytest')
|
||
session.run('pytest', 'tests', '-v')
|
||
``` |