Panduan Penggunaan pip dalam ServBay

pip ialah alat pengurusan pakej yang disyorkan secara rasmi untuk bahasa Python dan merupakan sebahagian penting dalam ekosistem Python. ServBay, sebagai persekitaran pembangunan web tempatan yang direka khas untuk pembangun, telah mengintegrasikan sokongan penuh untuk Python dan alat pengurusan pakej pip, sekali gus memudahkan pembinaan dan pengurusan kebergantungan projek Python anda.

Panduan ini bertujuan membantu pengguna ServBay memahami serta memanfaatkan pip dengan berkesan untuk mengurus pakej Python, sama ada untuk pemasangan pustaka baru, naik taraf kebergantungan sedia ada, mahupun pembangunan dalam persekitaran terasing (virtual environment).

Apa Itu pip?

pip ialah alat untuk memasang dan mengurus pakej perisian Python. Ia boleh memuat turun dan memasang pakej dari Python Package Index (PyPI) atau sumber lain.

1. Sejarah Perkembangan & Kepentingan:
   • pip diperkenalkan pada tahun 2008 sebagai pengganti yang lebih baik untuk easy_install.
   • Bermula dengan Python 3.4, pip disertakan secara lalai dalam pemasangan standard Python dan menjadi pengurus pakej piawai.
   • Dengan pip, pembangun boleh memasang, menaik taraf, menyahpasang dan mengurus pelbagai pustaka serta kerangka pihak ketiga yang diperlukan untuk projek mereka dengan mudah.
2. Gambaran Fungsi Teras:
   • Pemasangan pakej: Muat turun dan pasang pakej Python serta kebergantungannya dari PyPI atau sumber indeks lain.
   • Pengurusan kebergantungan: Rekod semua pakej serta versi tertentu yang projek anda perlukan dan dapat bina semula persekitaran berdasarkan maklumat ini (biasanya menggunakan fail requirements.txt).
   • Pengendalian versi: Menyokong pemasangan versi pakej tertentu, serta mengurus kebergantungan dan kemungkinan konflik versi antara pakej.
   • Pelbagai sumber pemasangan: Menyokong pemasangan pakej daripada PyPI, sistem kawalan versi (misalnya Git), laluan tempatan atau fail edaran.
3. Integrasi pip dalam ServBay:
   • ServBay telah menyertakan versi pip yang stabil terkini untuk setiap versi Python yang disokongnya.
   • Fungsi pengurusan pakej ServBay bekerja lancar dengan pip terbina dalam bagi memberikan pengalaman pemasangan yang mudah.
   • ServBay membenarkan anda memasang dan mengurus pakej pada pelbagai versi Python dalam persekitarannya.

Prasyarat

Sebelum mula menggunakan pip dalam ServBay, pastikan:

• Anda telah memasang dan menjalankan ServBay dengan berjaya.
• Sekurang-kurangnya satu versi pakej Python telah diaktifkan dalam ServBay.

Asas Penggunaan pip dalam ServBay

pip telah dipra-pasang dalam persekitaran Python yang disediakan oleh ServBay. Anda boleh menggunakannya terus di terminal tanpa pemasangan tambahan.

Buka tetingkap terminal, kemudian jalankan arahan berikut:

Contoh Arahan Lazim

• Pasang pakej:

  pip install nama_pakej

  Sebagai contoh, untuk memasang kerangka web popular Flask:

  pip install Flask

• Pasang versi tertentu pakej:

  pip install nama_pakej==nombor_versi

  Contohnya, untuk memasang Flask versi 2.0.0:

  pip install Flask==2.0.0

• Naik taraf pakej:

  pip install --upgrade nama_pakej

  Sebagai contoh, untuk menaik taraf Flask ke versi terkini:

  pip install --upgrade Flask

• Nyahpasang pakej:

  pip uninstall nama_pakej

  Untuk menyahpasang Flask:

  pip uninstall Flask

  Selepas menjalankan arahan ini, pip akan menyenaraikan fail-fail yang akan dibuang dan meminta pengesahan anda.

• Lihat senarai pakej yang dipasang:

  pip list

  Arahan ini akan memaparkan semua pakej serta versinya yang telah dipasang dalam persekitaran semasa.

• Lihat pakej yang perlu dikemas kini:

  pip list --outdated

  Arahan ini membantu anda mengetahui pakej mana yang mempunyai versi baru yang tersedia.

Penggunaan Lanjutan dan Pengurusan Kebergantungan pip

Dalam pembangunan projek sebenar, anda mungkin perlukan fungsi pip yang lebih kompleks untuk mengurus kebergantungan projek.

• Menjana fail kebergantungan projek (requirements.txt): Bagi merekod semua pakej serta versi tepat yang dikehendaki oleh projek semasa, gunakan arahan pip freeze. Ini sangat penting untuk memastikan konsistensi antara persekitaran pembangunan, ujian dan produksi.

  pip freeze > requirements.txt

  Arahan ini akan mengeksport semua pakej yang telah dipasang melalui pip ke dalam fail requirements.txt.

• Pasang kebergantungan daripada fail requirements.txt: Jika anda menerima projek yang mengandungi fail requirements.txt, anda boleh memasang semua kebergantungan dengan pantas menggunakan fail tersebut.

  pip install -r requirements.txt

  pip akan membaca kandungan fail dan memasang semua pakej serta versi yang ditentukan.

• Tentukan sumber cermin (mirror) sementara untuk pemasangan: Dalam sesetengah persekitaran rangkaian, memuat turun langsung daripada PyPI mungkin lambat atau tidak stabil. Anda boleh gunakan parameter -i untuk menetapkan cermin PyPI yang lain secara sementara semasa pemasangan.

  pip install nama_pakej -i https://pypi.tuna.tsinghua.edu.cn/simple

  Perhatian, kaedah ini hanya berkuat kuasa untuk arahan tersebut sahaja. Untuk menukar sumber cermin secara kekal, anda boleh konfigurasi tetapan global pip.

Persekitaran Maya (Virtual Environments)

Sangat digalakkan untuk menggunakan persekitaran maya semasa membangunkan projek Python. Persekitaran maya ialah persekitaran Python tersendiri yang mempunyai pelaksana (interpreter), pip, dan direktori site-packagesnya sendiri. Antara kelebihannya:

• Pengasingan kebergantungan projek: Setiap projek boleh mempunyai versi berlainan bagi pustaka yang sama tanpa mengganggu antara satu sama lain.
• Kekalkan persekitaran sistem bersih: Elakkan pemasangan kebergantungan projek secara global di seluruh sistem.
• Memudahkan pengurusan kebergantungan: Lebih mudah untuk jana fail kebergantungan menggunakan pip freeze.

Membina dan Menggunakan Persekitaran Maya dalam ServBay

ServBay kebiasaannya telah menyediakan modul venv (binaan dalam Python 3.3+) atau menyokong pemasangan alat virtualenv. Penggunaan venv yang dibina dalam Python adalah disyorkan.

1. Cipta persekitaran maya: Jalankan arahan berikut dalam direktori projek anda (contohnya pada /Applications/ServBay/www/my-python-project):

   cd /Applications/ServBay/www/my-python-project
   python -m venv myenv

   Ini akan mencipta satu folder bernama myenv di direktori projek anda, yang mengandungi persekitaran Python baru.

2. Aktifkan persekitaran maya: Sebelum digunakan, anda perlu mengaktifkan persekitaran maya tersebut. Selepas diaktifkan, semua arahan python dan pip berjalan dalam konteks persekitaran maya ini.

   • Pada sistem macOS/Linux:

     source myenv/bin/activate

   • Pada sistem Windows (melalui ServBay atau terminal serasi lain):

     myenv\Scripts\activate

   Biasanya, tanda nama persekitaran maya (contoh: (myenv) prompt_anda$) akan dipaparkan pada prompt terminal selepas diaktifkan.

3. Penggunaan pip dalam persekitaran maya: Setelah diaktifkan, gunakan saja arahan pip untuk memasang pakej ke dalam persekitaran maya ini.

   (myenv) pip install requests

   Ini akan memasang pustaka requests ke dalam persekitaran myenv tanpa menjejaskan persekitaran sistem atau persekitaran maya lain.

4. Keluar dari persekitaran maya: Setelah selesai, anda boleh keluar daripada persekitaran maya dengan:

   deactivate

   Prompt terminal akan kembali ke keadaan asal dan python serta pip akan merujuk ke persekitaran servis atau sistem global ServBay.

Cadangan Amalan Terbaik

• Sentiasa guna pip dalam persekitaran maya: Ini adalah prinsip paling utama semasa membangunkan projek Python.
• Urus kebergantungan dengan requirements.txt: Sentiasa kemas kini fail kebergantungan anda menggunakan pip freeze > requirements.txt dan sertakannya dalam repositori projek.
• Kemas kini pip secara berkala: Walaupun ServBay menyediakan versi pip yang agak baru, anda tetap digalakkan untuk mengemaskini pip dalam persekitaran maya atau sistem secara berkala dengan arahan pip install --upgrade pip.
• Pantau dan kemas kini pakej usang: Gunakan pip list --outdated untuk melihat senarai pakej yang perlu dikemas kini, dan naik taraf mengikut keperluan projek anda.
• Kenali masalah lazim: Jika menghadapi ralat pemasangan, teliti mesej ralat dengan teliti. Isu biasa termasuk masalah rangkaian, kebenaran, konflik kebergantungan atau ketiadaan alat pembinaan.

Soalan Lazim (FAQ)

• Soalan: Saya mendapat ralat "pip: command not found" di terminal ServBay. Apa perlu dibuat?
  • Jawapan: Pastikan anda telah mengaktifkan pakej Python dalam aplikasi ServBay serta memastikan pembolehubah persekitaran ServBay telah dikonfigurasi dengan betul.
• Soalan: Pemasangan pakej sangat perlahan atau gagal. Bagaimana mengatasinya?
  • Jawapan: Ini biasanya berkait dengan rangkaian. Anda boleh cuba gunakan parameter -i untuk memilih cermin PyPI yang lebih pantas, atau konfigurasi tetapan sumber cermin pip secara global.
• Soalan: Ralat kebenaran (Permission Denied) semasa memasang pakej. Apa penyelesaiannya?
  • Jawapan: Elakkan menggunakan sudo pip install ... dalam persekitaran sistem global. Sebaiknya gunakan persekitaran maya, di mana anda mempunyai hak menulis sepenuhnya. Jika benar-benar perlu pasang ke persekitaran pengguna (namun tidak disyor), anda boleh gunakan pip install --user nama_pakej.

Rumusan

ServBay menyediakan persekitaran yang mudah dan terintegrasi dengan alat pip yang berkuasa khas untuk pembangun Python. Dengan menguasai asas dan teknik lanjutan pip—terutama melalui penggunaan persekitaran maya—anda boleh mengurus kebergantungan projek dengan cekap dan mengelakkan konflik persekitaran, membolehkan anda memberi tumpuan penuh kepada penulisan kod. Manfaatkan sepenuhnya gabungan ServBay dan pip untuk mempertingkatkan aliran kerja pembangunan Python anda.