joblib

Beranda joblib dengan dokumentasi pengguna terletak di:

https://joblib.readthedocs.io

Mendapatkan kode terbaru

Untuk mendapatkan kode terbaru menggunakan git, cukup ketik:

 git klon https://github.com/joblib/joblib.git

Jika Anda belum menginstal git, Anda dapat mengunduh zip kode terbaru: https://github.com/joblib/joblib/archive/refs/heads/main.zip

Menginstal

Anda dapat menggunakan pip untuk menginstal joblib:

 pip instal joblib

dari direktori mana pun atau:

 setup python.py instal

dari direktori sumber.

Ketergantungan

• Joblib tidak memiliki dependensi wajib selain Python (versi yang didukung adalah 3.8+).
• Joblib memiliki ketergantungan opsional pada Numpy (setidaknya versi 1.6.1) untuk manipulasi array.
• Joblib menyertakan salinan loky vendornya sendiri untuk manajemen proses.
• Joblib dapat secara efisien membuang dan memuat array numpy tetapi tidak memerlukan instalasi numpy.
• Joblib memiliki ketergantungan opsional pada python-lz4 sebagai alternatif yang lebih cepat daripada zlib dan gzip untuk serialisasi terkompresi.
• Joblib memiliki ketergantungan opsional pada psutil untuk mengurangi kebocoran memori dalam proses pekerja paralel.
• Beberapa contoh memerlukan ketergantungan eksternal seperti pandas. Lihat instruksi di bagian Membuat dokumen untuk detailnya.

Alur kerja untuk berkontribusi

Untuk berkontribusi pada joblib, pertama-tama buat akun di github. Setelah ini selesai, buat repositori joblib agar memiliki repositori Anda sendiri, kloning menggunakan 'git clone' di komputer tempat Anda ingin bekerja. Buat perubahan pada klon Anda, dorong ke akun github Anda, uji di beberapa komputer, dan jika Anda puas dengan perubahan tersebut, kirimkan permintaan tarik ke repositori utama.

Menjalankan rangkaian pengujian

Untuk menjalankan rangkaian pengujian, Anda memerlukan modul pytest (versi >= 3) dan cakupan. Jalankan rangkaian pengujian menggunakan:

 lib pekerjaan tersulit

dari akar proyek.

Membangun dokumen

Untuk membuat dokumen, Anda harus memiliki sphinx (>=1.4) dan beberapa dependensi diinstal:

 instalasi pip -U -r .readthedocs-requirements.txt

Dokumen kemudian dapat dibuat dengan perintah berikut:

 buat dok

Dokumen html terletak di direktori doc/_build/html .

Membuat tarball sumber

Untuk membuat tarball sumber, misalnya untuk pengemasan atau distribusi, jalankan perintah berikut:

 setup python.py sdist

Tarball akan dibuat di direktori dist. Perintah ini akan mengkompilasi dokumen, dan tarball yang dihasilkan dapat diinstal tanpa ketergantungan tambahan selain pustaka standar Python. Anda memerlukan alat setup dan sphinx.

Membuat rilis dan mengunggahnya ke PyPI

Perintah ini hanya dijalankan oleh manajer proyek, untuk membuat rilis, dan mengunggah ke PyPI:

 python setup.py sdist bdist_wheel
benang unggah dist/*

Perhatikan bahwa dokumentasi akan diperbarui secara otomatis pada setiap git push. Jika bukan itu masalahnya, coba buat dokumen secara lokal dan selesaikan kesalahan pembuatan dokumen apa pun (khususnya saat menjalankan contoh).

Memperbarui log perubahan

Perubahan tercantum dalam file CHANGES.rst. Mereka harus diperbarui secara manual tetapi perintah git berikut dapat digunakan untuk menghasilkan baris:

 git log --abbrev-commit --date=short --no-merges --sparse