pydistcheck
v0.8.0
pydistcheck ? pydistcheck adalah antarmuka baris perintah (CLI) yang Anda jalankan pada paket Python, yang dapat:
Ini terinspirasi oleh R CMD check R.
Format yang Didukung:
conda (baik .conda dan .tar.bz2 ).tar.bz2 , .tar.gz , atau arsip .zip Lihat "Periksa Referensi" untuk daftar lengkap jenis masalah yang dapat ditangkap pydistcheck .
Lihat "Cara Menguji Distribusi Python" untuk mempelajari bagaimana pydistcheck dan alat serupa seperti auditwheel , check-wheel-contents , dan twine check masuk ke dalam alur kerja pengembangan Python.
Untuk latar belakang lebih lanjut tentang nilai alat semacam itu, lihat pembicaraan SCIPY 2022 "Apakah CSV itu termasuk di PYPI? Mungkin tidak" (tautan video).
Pasang dengan pip .
pip install pydistcheck Atau conda .
conda install -c conda-forge pydistcheckUntuk detail lebih lanjut, lihat "Instalasi" (tautan).
Cobalah pada paket yang Anda sukai ...
pip download
--no-deps
-d ./downloads
pyarrow
pydistcheck --inspect ./downloads/ * .whl... untuk melihat apa yang dikandungnya.
----- package inspection summary -----
file size
* compressed size: 25.9M
* uncompressed size: 94.0M
* compression space saving: 72.4%
contents
* directories: 0
* files: 809 (30 compiled)
size by extension
* .dylib - 73.2M (77.9%)
* .so - 10.8M (11.4%)
* .h - 4.5M (4.8%)
* .py - 2.4M (2.5%)
* .pyx - 0.8M (0.8%)
* .pxi - 0.7M (0.8%)
* .cc - 0.4M (0.5%)
* .cmake - 0.4M (0.4%)
* .pxd - 0.3M (0.3%)
* .gz - 0.2M (0.2%)
* .hpp - 0.1M (0.1%)
* .txt - 0.1M (0.1%)
* no-extension - 77.4K (0.1%)
* .orc - 48.4K (0.1%)
* .parquet - 14.0K (0.0%)
* .sh - 7.8K (0.0%)
* .md - 3.6K (0.0%)
* .yml - 1.5K (0.0%)
* .ubuntu - 1.3K (0.0%)
* .fedora - 1.0K (0.0%)
* .diff - 1.0K (0.0%)
* .feather - 0.6K (0.0%)
largest files
* (49.1M) pyarrow/libarrow.1700.dylib
* (10.7M) pyarrow/libarrow_flight.1700.dylib
* (3.8M) pyarrow/lib.cpython-311-darwin.so
* (3.8M) pyarrow/libparquet.1700.dylib
* (2.9M) pyarrow/libarrow_substrait.1700.dylib
==================== done running pydistcheck ===============
Atau pada data uji dalam repo ini ...
pydistcheck tests/data/problematic-package- *... untuk melihat jenis masalah yang diperiksa.
------------ check results -----------
1. [files-only-differ-by-case] Found files which differ only by case. Files: problematic-package-0.1.0/problematic_package/Question.py,problematic-package-0.1.0/problematic_package/question.PY,problematic-package-0.1.0/problematic_package/question.py
2. [mixed-file-extensions] Found a mix of file extensions for the same file type: .NDJSON (1), .jsonl (1), .ndjson (1)
3. [mixed-file-extensions] Found a mix of file extensions for the same file type: .yaml (2), .yml (1)
4. [path-contains-non-ascii-characters] Found file path containing non-ASCII characters: 'problematic-package-0.1.0/problematic_package/?veryone-loves-python.py'
5. [path-contains-spaces] Found path with spaces: 'problematic-package-0.1.0/beep boop.ini'
6. [path-contains-spaces] Found path with spaces: 'problematic-package-0.1.0/problematic_package/bad code/'
7. [path-contains-spaces] Found path with spaces: 'problematic-package-0.1.0/problematic_package/bad code/__init__.py'
8. [path-contains-spaces] Found path with spaces: 'problematic-package-0.1.0/problematic_package/bad code/ship-it.py'
9. [unexpected-files] Found unexpected directory 'problematic-package-0.1.0/.git/'.
10. [unexpected-files] Found unexpected file 'problematic-package-0.1.0/.gitignore'.
11. [unexpected-files] Found unexpected file 'problematic-package-0.1.0/.hadolint.yaml'.
12. [unexpected-files] Found unexpected file 'problematic-package-0.1.0/problematic_package/.gitignore'.
errors found while checking: 12
Dan pada distribusi yang dibangun yang berisi objek yang dikompilasi ...
pydistcheck tests/data/debug-baseballmetrics * .whl ... pydistcheck dapat mendeteksi dimasukkannya simbol debug (yang meningkatkan ukuran distribusi).
checking 'tests/data/debug-baseballmetrics-0.1.0-py3-none-macosx_10_15_x86_64.macosx_11_6_x86_64.macosx_12_5_x86_64.whl'
------------ check results -----------
1. [compiled-objects-have-debug-symbols] Found compiled object containing debug symbols. For details, extract the distribution contents and run 'dsymutil -s "lib/lib_baseballmetrics.dylib"'.
errors found while checking: 1
checking 'tests/data/debug-baseballmetrics-py3-none-manylinux_2_28_x86_64.manylinux_2_5_x86_64.manylinux1_x86_64.whl'
------------ check results -----------
1. [compiled-objects-have-debug-symbols] Found compiled object containing debug symbols. For details, extract the distribution contents and run 'objdump --all-headers "lib/lib_baseballmetrics.so"'.
errors found while checking: 1
Lihat https://pydistcheck.readthedocs.io/en/latest/ untuk mempelajari lebih lanjut.
