Saya akan terus memetik perenggan yang berkaitan untuk anda lihat:
Muat naik kit anda sendiri
Kami telah melihat dan menggunakan begitu banyak pakej yang ditulis oleh orang lain Adakah anda benar-benar mahu menulisnya sendiri? Kandungan sebelumnya dalam bab ini sudah cukup untuk semua orang memahami cara menulis pakej dan menggunakannya secara tempatan, tetapi bagaimana kita berkongsi pakej ini dengan dunia? Sudah tentu, anda perlu memuat naik pakej ke PyPI (Dengan cara ini semua orang boleh menggunakan pip untuk memuat turun dan memasang pakej anda). Bahagian ini adalah untuk mengajar anda cara melakukannya.
Jika anda bercadang untuk memuat naik pakej anda sendiri, anda mesti mendaftar terlebih dahulu di PyPI untuk mendapatkan akaun dan kata laluan.
Pertama sekali, semua orang perlu tahu bahawa jika projek Python anda bukan sahaja mahu dapat mengimport dari folder semasa atau relatif, tetapi juga mahu dapat dipasang ke dalam persekitaran Python, anda mesti menulis di bawah fail setup.py projek. Di sini kita perlu memuat naik ke PyPI untuk menyesuaikan setup.py kita dahulu Mari kita semak struktur projek yang hendak dimuat naik dan lokasi beberapa fail konfigurasi yang ingin kami tambahkan:
Kami mendapati pada asalnya terdapat dua pakej pkgA dan pkgB di bawah projek (biasanya kami mempunyai beberapa pakej dalam projek dan kami perlu Memuat naik semua pakej itu milik), yang mengandungi beberapa modul dan __init__.py yang menunjukkan bahawa ia adalah struktur pakej. Kemudian kita akan mempunyai fail penerangan README (digunakan untuk memperkenalkan struktur dan penggunaan projek, yang tidak akan dibincangkan secara terperinci di sini) dan fail pelaksanaan (kod skrip pelaksanaan keseluruhan projek) pelari .
Seterusnya kami perlu menambah dua fail konfigurasi pada projek asal, iaitu fail setup.py dan .pypirc Kami akan memperkenalkan cara menggunakan fail ini satu per satu satu.
Mula-mula mari kita lihat setup.py:
daripada persediaan import distutils.core
persediaan (
nama = 'Projek Saya',
pakej = ['pkgA', 'pkgB'],
skrip = ['pelari'],
versi = '1.0',
penerangan = 'Projek pertama saya',
pengarang = 'dokelung',
author_email = 'dokelung@gmail.com',
kata kunci = ['Projek Baik'],
pengelas = [],
)
Kita mesti mengimport fungsi setup daripada distutils.core (distutils ialah pakej terbina dalam Python Fungsi ini akan membantu kami memasangnya lihat maksud setiap parameter dalam fungsi ini:
Nama medan
Penerangan
nama
Nama projek (nama yang sama dengan direktori projek)
pakej
Nama pakej untuk dipasang
skrip
Nama skrip biasanya mewakili fail boleh laku, tetapi tidak semestinya
versi
Versi
penerangan
Penerangan Projek
pengarang
Pengarang
e-mel_pengarang
Peti mel pengarang
kata kunci
Beberapa kata kunci untuk projek ini
Berikut ialah penjelasan ringkas tentang skrip Apa yang ditulis dalam skrip di sini ialah fail pelaksanaan keseluruhan projek. Untuk memasang fail ini pada sistem pengguna pada masa yang sama, kami perlu menandakannya, jika tidak, apabila kami menggunakan pip untuk memasang kemudian, kami hanya akan memasang pakej dan bukan fail boleh laku. Apa yang dipanggil pemasangan fail boleh laku di sini sebenarnya bermaksud meletakkan skrip yang ditentukan dalam laluan boleh laku, seperti /usr/bin/, supaya pengguna boleh memasangnya di mana-mana sahaja selepas pemasangan (sebenarnya, kita boleh menentukan laluan pemasangan, tetapi jika kita hanya memberikan nama skrip, ia akan diletakkan di lokasi lalai). Satu perkara yang perlu anda perhatikan di sini ialah nama skrip mestilah tidak sama dengan pakcage yang ingin diimport. Ini akan membawa kepada beberapa ralat import.
Pada ketika ini, anda sudah mempunyai fail pemasangan yang cantik (yang turut menyokong keluaran PyPI).
Seterusnya, mari lihat fail .pypirc Hanya dengan mencipta fail konfigurasi ini kita boleh memindahkan sesuatu ke PyPI:
[distutils]
pelayan indeks=
pypi
[pypi]
repositori: https://pypi.python.org/pypi
nama pengguna: (isi nombor akaun di sini)
kata laluan: (isi kata laluan di sini)
Jika anda pengguna Windows, sila buka terminal (command prompt) dan tetapkan pembolehubah persekitaran:
set HOME=C:\Users\Owner\
Kemudian kami akan menambah subdirektori Pemilik dalam folder pengguna slot C (sebenarnya C:\Users) dan meletakkan Copy .pipyrc kami. kod> dan letakkannya dalam folder, dan tetapan selesai.
Jika anda pengguna Linux atau Mac, sila juga salin .pypirc ke direktori utama anda:
$ cp .pypirc ~/.pypirc
Selepas fail konfigurasi di atas sedia, tiba masanya untuk mencapai peringkat terakhir, daftar dahulu:
$ python setup.py register -r pypi
Muat naik seterusnya:
$ python setup.py sdist upload -r pypi
Bagus, anda telah berjaya menjadikan kerja anda kelihatan kepada seluruh dunia Pergi ke PyPI dan lihat halaman pakej anda. Akhirnya, kami merasai buah manis itu, dan kemudian menggunakan pip untuk memuat turun projek kami (dan pakej di dalam) dan memasangnya pada komputer kami untuk melihat:
$ pip pasang MyProject
Jika pembaca menggunakan pip untuk memasang projek yang dimuat naik pada komputer mereka, pakej di bawah projek itu boleh diimport di mana-mana sahaja pada mesin tempatan.
Kemudian anda boleh memberitahu dunia bahawa anda juga penyumbang kepada Python.
Rujuk tutorial dalam buku It's Django I wrote
Saya akan terus memetik perenggan yang berkaitan untuk anda lihat:
Muat naik kit anda sendiri
Kami telah melihat dan menggunakan begitu banyak pakej yang ditulis oleh orang lain Adakah anda benar-benar mahu menulisnya sendiri? Kandungan sebelumnya dalam bab ini sudah cukup untuk semua orang memahami cara menulis pakej dan menggunakannya secara tempatan, tetapi bagaimana kita berkongsi pakej ini dengan dunia? Sudah tentu, anda perlu memuat naik pakej ke PyPI (Dengan cara ini semua orang boleh menggunakan pip untuk memuat turun dan memasang pakej anda). Bahagian ini adalah untuk mengajar anda cara melakukannya.
Pertama sekali, semua orang perlu tahu bahawa jika projek Python anda bukan sahaja mahu dapat mengimport dari folder semasa atau relatif, tetapi juga mahu dapat dipasang ke dalam persekitaran Python, anda mesti menulis di bawah fail setup.py projek. Di sini kita perlu memuat naik ke PyPI untuk menyesuaikan setup.py kita dahulu Mari kita semak struktur projek yang hendak dimuat naik dan lokasi beberapa fail konfigurasi yang ingin kami tambahkan:
Kami mendapati pada asalnya terdapat dua pakej
pkgA
danpkgB
di bawah projek (biasanya kami mempunyai beberapa pakej dalam projek dan kami perlu Memuat naik semua pakej itu milik), yang mengandungi beberapa modul dan__init__.py
yang menunjukkan bahawa ia adalah struktur pakej. Kemudian kita akan mempunyai fail peneranganREADME
(digunakan untuk memperkenalkan struktur dan penggunaan projek, yang tidak akan dibincangkan secara terperinci di sini) dan fail pelaksanaan (kod skrip pelaksanaan keseluruhan projek) pelari .Seterusnya kami perlu menambah dua fail konfigurasi pada projek asal, iaitu fail
setup.py
dan.pypirc
Kami akan memperkenalkan cara menggunakan fail ini satu per satu satu.Mula-mula mari kita lihat
setup.py
:Kita mesti mengimport fungsi
setup
daripadadistutils.core
(distutils ialah pakej terbina dalam Python Fungsi ini akan membantu kami memasangnya lihat maksud setiap parameter dalam fungsi ini:Berikut ialah penjelasan ringkas tentangskrip Apa yang ditulis dalam skrip di sini ialah fail pelaksanaan keseluruhan projek. Untuk memasang fail ini pada sistem pengguna pada masa yang sama, kami perlu menandakannya, jika tidak, apabila kami menggunakan pip untuk memasang kemudian, kami hanya akan memasang pakej dan bukan fail boleh laku. Apa yang dipanggil pemasangan fail boleh laku di sini sebenarnya bermaksud meletakkan skrip yang ditentukan dalam laluan boleh laku, seperti
/usr/bin/
, supaya pengguna boleh memasangnya di mana-mana sahaja selepas pemasangan (sebenarnya, kita boleh menentukan laluan pemasangan, tetapi jika kita hanya memberikan nama skrip, ia akan diletakkan di lokasi lalai). Satu perkara yang perlu anda perhatikan di sini ialah nama skrip mestilah tidak sama dengan pakcage yang ingin diimport. Ini akan membawa kepada beberapa ralat import.Pada ketika ini, anda sudah mempunyai fail pemasangan yang cantik (yang turut menyokong keluaran PyPI).
Seterusnya, mari lihat fail
.pypirc
Hanya dengan mencipta fail konfigurasi ini kita boleh memindahkan sesuatu ke PyPI:Jika anda pengguna Windows, sila buka terminal (command prompt) dan tetapkan pembolehubah persekitaran:
Kemudian kami akan menambah subdirektori
Pemilik
dalam folder pengguna slot C (sebenarnyaC:\Users
) dan meletakkanCopy .pipyrc kami. kod> dan letakkannya dalam folder, dan tetapan selesai.
Jika anda pengguna Linux atau Mac, sila juga salin
.pypirc
ke direktori utama anda:Selepas fail konfigurasi di atas sedia, tiba masanya untuk mencapai peringkat terakhir, daftar dahulu:
Muat naik seterusnya:
Bagus, anda telah berjaya menjadikan kerja anda kelihatan kepada seluruh dunia Pergi ke PyPI dan lihat halaman pakej anda. Akhirnya, kami merasai buah manis itu, dan kemudian menggunakan
pip
untuk memuat turun projek kami (dan pakej di dalam) dan memasangnya pada komputer kami untuk melihat:Kemudian anda boleh memberitahu dunia bahawa anda juga penyumbang kepada Python.
Soalan yang saya jawab: Python-QA