Amazon CodeCatalyst tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Lihat informasi yang lebih lengkap di [Cara bermigrasi dari CodeCatalyst](migration.md).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan Python
Topik-topik ini menjelaskan cara menggunakan`pip`, manajer paket Python, dan`twine`, utilitas penerbitan paket Python, dengan. CodeCatalyst
**Topics**
+ [Mengkonfigurasi pip dan menginstal paket Python](packages-python-pip.md)
+ [Mengkonfigurasi Twine dan menerbitkan paket Python](packages-python-twine.md)
+ [Normalisasi nama paket Python](python-name-normalization.md)
+ [Kompatibilitas Python](packages-python-compatibility.md)
# Mengkonfigurasi pip dan menginstal paket Python
Untuk menggunakannya `pip` CodeCatalyst, Anda harus terhubung `pip` ke repositori paket Anda dan memberikan token akses pribadi untuk otentikasi. Anda dapat melihat instruksi untuk menghubungkan `pip` ke repositori paket Anda di konsol. CodeCatalyst Setelah Anda mengautentikasi dan `pip` terhubung CodeCatalyst, Anda dapat menjalankan `pip` perintah.
**Contents**
+ [Menginstal paket Python dari CodeCatalyst dengan pip](#pip-install)
+ [Mengkonsumsi paket Python dari PyPI melalui CodeCatalyst](#pip-install-pypi)
+ [dukungan perintah pip](#pip-command-support)
+ [Perintah yang didukung yang berinteraksi dengan repositori](#supported-pip-commands-that-interact-with-a-repository)
+ [Perintah sisi klien yang didukung](#supported-pip-client-side-commands)
## Menginstal paket Python dari CodeCatalyst dengan pip
Petunjuk berikut menjelaskan cara mengkonfigurasi `pip` untuk menginstal paket Python dari repositori CodeCatalyst paket Anda atau salah satu repositori hulu.
**Untuk mengkonfigurasi dan menggunakan `pip` untuk menginstal paket Python dari repositori paket Anda CodeCatalyst**
1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Pada halaman ikhtisar untuk proyek Anda, pilih **Paket**.
1. Pilih repositori paket Anda dari daftar repositori paket.
1. Pilih **Connect to repository**.
1. Di kotak dialog **Connect to repository**, pilih **pip** dari daftar klien manajer paket.
1. Anda akan memerlukan token akses pribadi (PAT) untuk mengautentikasi pip dengan. CodeCatalyst Jika Anda sudah memilikinya, Anda dapat menggunakannya. Jika tidak, Anda dapat membuatnya di sini.
1. Pilih **Buat token**.
1. Pilih **Salin** untuk menyalin PAT Anda.
**Awas**
Anda tidak akan dapat melihat atau menyalin PAT Anda lagi setelah Anda menutup kotak dialog.
1. Gunakan `pip config` perintah untuk mengatur URL CodeCatalyst registri dan kredensialnya. Ganti nilai-nilai berikut.
**catatan**
Jika menyalin dari instruksi konsol, nilai berikut harus diperbarui untuk Anda dan tidak boleh diubah.
+ Ganti *username* dengan nama CodeCatalyst pengguna Anda.
+ Ganti *PAT* dengan CodeCatalyst PAT Anda.
+ Ganti *space\$1name* dengan nama CodeCatalyst spasi Anda.
+ Ganti *proj\$1name* dengan nama CodeCatalyst proyek Anda.
+ Ganti *repo\$1name* dengan nama repositori CodeCatalyst paket Anda.
```
pip config set global.index-url https://username:PAT@https://packages.region.codecatalyst.aws/pypi/space_name/proj_name/repo_name/simple/
```
1. Dengan asumsi bahwa sebuah paket ada dalam repositori Anda atau salah satu repositori hulu, Anda dapat menginstalnya dengan `pip install`. Misalnya, gunakan perintah berikut untuk menginstal paket `requests`.
```
pip install requests
```
Gunakan `-i` opsi untuk kembali sementara untuk menginstal paket dari [https://pypi.org alih-alih repositori](https://pypi.org) CodeCatalyst paket Anda.
```
pip install -i https://pypi.org/simple requests
```
## Mengkonsumsi paket Python dari PyPI melalui CodeCatalyst
**Anda dapat menggunakan paket Python dari [Indeks Paket Python (PyPI)](https://www.pypi.org/) melalui repositori dengan mengonfigurasi CodeCatalyst repositori dengan koneksi upstream ke PyPI.** Paket yang dikonsumsi dari **PyPI** dicerna dan disimpan di repositori Anda. CodeCatalyst
**Untuk mengkonsumsi paket dari PyPI**
1. Jika Anda belum melakukannya, konfigurasikan pip dengan repositori CodeCatalyst paket Anda dengan mengikuti langkah-langkah di. [Menginstal paket Python dari CodeCatalyst dengan pip](#pip-install)
1. Pastikan repositori Anda telah menambahkan **PyPI** sebagai sumber upstream. Anda dapat memeriksa sumber upstream mana yang ditambahkan atau menambahkan **PyPI** sebagai sumber upstream dengan mengikuti instruksi dan memilih repositori [Menambahkan repositori hulu](packages-upstream-repositories-add.md) penyimpanan **PyPI**.
Untuk informasi selengkapnya tentang meminta paket dari repositori upstream, lihat. [Meminta versi paket dengan repositori hulu](packages-upstream-repositories-request.md)
## dukungan perintah pip
Bagian berikut merangkum perintah pip yang didukung, oleh CodeCatalyst repositori, selain perintah tertentu yang tidak didukung.
**Topics**
+ [Perintah yang didukung yang berinteraksi dengan repositori](#supported-pip-commands-that-interact-with-a-repository)
+ [Perintah sisi klien yang didukung](#supported-pip-client-side-commands)
### Perintah yang didukung yang berinteraksi dengan repositori
Bagian ini berisi daftar `pip` tempat klien `pip` membuat satu atau beberapa permintaan ke registri yang telah dikonfigurasi. Perintah-perintah ini telah diverifikasi untuk berfungsi dengan benar ketika dipanggil terhadap repositori CodeCatalyst paket.
****
| Perintah | Deskripsi |
| --- | --- |
| [menginstal](https://pip.pypa.io/en/stable/reference/pip_install/) | Menginstal paket. |
| [Unduh](https://pip.pypa.io/en/stable/reference/pip_download/) | Mengunduh paket. |
CodeCatalyst tidak mengimplementasikan`pip search`. [Jika Anda telah mengonfigurasi `pip` dengan repositori CodeCatalyst paket, menjalankan `pip search` akan mencari dan menampilkan paket dari PyPI.](https://pypi.org/)
### Perintah sisi klien yang didukung
Perintah ini tidak memerlukan interaksi langsung dengan repositori, jadi CodeCatalyst tidak perlu melakukan apa pun untuk mendukungnya.
****
| Perintah | Deskripsi |
| --- | --- |
| [copot pemasangan](https://pip.pypa.io/en/stable/reference/pip_uninstall/) | Meng-uninstall paket. |
| [membekukan](https://pip.pypa.io/en/stable/reference/pip_freeze/) | Output paket terinstal dalam format persyaratan. |
| [daftar](https://pip.pypa.io/en/stable/reference/pip_list/) | Daftar paket terinstal. |
| [menunjukkan](https://pip.pypa.io/en/stable/reference/pip_show/) | Menampilkan informasi tentang paket terinstal. |
| [periksa](https://pip.pypa.io/en/stable/reference/pip_check/) | Verifikasi bahwa paket yang diinstal memiliki dependensi yang kompatibel. |
| [konfigurasi](https://pip.pypa.io/en/stable/reference/pip_config/) | Mengelola konfigurasi lokal dan global. |
| [roda](https://pip.pypa.io/en/stable/reference/pip_wheel/) | Membangun wheel dari kebutuhan Anda. |
| [hash](https://pip.pypa.io/en/stable/reference/pip_hash/) | Menghitung hash dari arsip paket. |
| [penyelesaian](https://pip.pypa.io/en/stable/user_guide/#command-completion) | Membantu penyelesaian perintah. |
| [debug](https://pip.pypa.io/en/stable/reference/pip_debug/) | Menampilkan informasi yang berguna untuk debugging. |
| help | Menampilkan bantuan untuk perintah. |
# Mengkonfigurasi Twine dan menerbitkan paket Python
Untuk menggunakannya `twine` CodeCatalyst, Anda harus terhubung `twine` ke repositori paket Anda dan memberikan token akses pribadi untuk otentikasi. Anda dapat melihat instruksi untuk menghubungkan `twine` ke repositori paket Anda di konsol. CodeCatalyst Setelah Anda mengautentikasi dan `twine` terhubung CodeCatalyst, Anda dapat menjalankan `twine` perintah.
## Menerbitkan paket CodeCatalyst dengan Twine
Petunjuk berikut menjelaskan cara mengautentikasi dan menghubungkan `twine` ke repositori CodeCatalyst paket Anda.
**Untuk mengkonfigurasi dan menggunakan `twine` untuk mempublikasikan paket ke CodeCatalyst repositori paket Anda**
1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Pada halaman ikhtisar untuk proyek Anda, pilih **Paket**.
1. Pilih repositori paket Anda dari daftar repositori paket.
1. Pilih **Connect to repository**.
1. Di kotak dialog **Connect to repository**, pilih **Twine** dari daftar klien manajer paket.
1. Anda akan memerlukan token akses pribadi (PAT) untuk mengautentikasi benang. CodeCatalyst Jika Anda sudah memilikinya, Anda dapat menggunakannya. Jika tidak, Anda dapat membuatnya di sini.
1. Pilih **Buat token**.
1. Pilih **Salin** untuk menyalin PAT Anda.
**Awas**
Anda tidak akan dapat melihat atau menyalin PAT Anda lagi setelah Anda menutup kotak dialog.
1. Anda dapat mengkonfigurasi benang dengan `.pypirc` file, atau dengan variabel lingkungan.
1. **Untuk mengkonfigurasi dengan `.pypirc` file.**
Buka `~/.pypirc` di editor pilihan Anda.
Tambahkan server indeks untuk CodeCatalyst, termasuk repositori, nama pengguna, dan PAT yang Anda buat dan salin di langkah sebelumnya. Ganti nilai-nilai berikut.
**catatan**
Jika menyalin dari instruksi konsol, nilai berikut harus diperbarui untuk Anda dan tidak boleh diubah.
+ Ganti *username* dengan nama CodeCatalyst pengguna Anda.
+ Ganti *PAT* dengan CodeCatalyst PAT Anda.
+ Ganti *space\$1name* dengan nama CodeCatalyst spasi Anda.
+ Ganti *proj\$1name* dengan nama CodeCatalyst proyek Anda.
+ Ganti *repo\$1name* dengan nama repositori CodeCatalyst paket Anda.
```
[distutils]
index-servers = proj-name/repo-name
[proj-name/repo-name]
repository = https://packages.region.codecatalyst.aws/pypi/space_name/proj_name/repo_name/
password = PAT
username = username
```
1. **Untuk mengkonfigurasi dengan variabel lingkungan.**
Mengatur variabel lingkungan berikut. Dalam `TWINE_REPOSITORY_URL` nilai, perbarui*space\$1name*,*proj\$1name*, dan *repo\$1name* dengan nama CodeCatalyst ruang, proyek, dan repositori paket Anda.
```
export TWINE_USERNAME=username
```
```
export TWINE_PASSWORD=PAT
```
```
export TWINE_REPOSITORY_URL="https://packages.region.codecatalyst.aws/pypi/space_name/proj_name/repo_name/"
```
1. Publikasikan distribusi Python dengan perintah. `twine upload`
# Normalisasi nama paket Python
CodeCatalyst menormalkan nama paket sebelum menyimpannya, yang berarti nama paket CodeCatalyst mungkin berbeda dari nama yang diberikan saat paket diterbitkan.
Untuk paket Python, saat melakukan normalisasi nama paket diberi huruf kecil dan semua instance karakter`.`,`-`, dan `_` diganti dengan satu karakter. `-` Jadi nama paket `pigeon_cli` dan `pigeon.cli` dinormalisasi dan disimpan sebagai`pigeon-cli`. Nama yang tidak dinormalisasi dapat digunakan oleh pip dan benang. Untuk informasi selengkapnya tentang normalisasi nama paket Python, lihat [PEP 503](https://www.python.org/dev/peps/pep-0503/#normalized-names) dalam dokumentasi Python.
# Kompatibilitas Python
Meskipun CodeCatalyst tidak mendukung `/simple/` API, itu mendukung operasi `Legacy` API. CodeCatalyst tidak mendukung operasi PyPI `XML-RPC` atau `JSON` API.
Untuk informasi lebih lanjut, lihat berikut ini pada repositori Python Packaging Authority. GitHub
+ [API Legacy](https://warehouse.pypa.io/api-reference/legacy.html)
+ [XML-RPC API](https://github.com/pypi/warehouse/blob/main/docs/dev/api-reference/xml-rpc.rst)
+ [API JSON](https://docs.pypi.org/api/json/)