Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Kompatibilitas Python

CodeArtifact mendukung PyPI Simple Repository API di/simple/<project>/, digunakan oleh,, piptwine, uv dan klien Python lainnya. Klien memilih antara respons HTML dan JSON menggunakan header Accept permintaan.

Dukungan API Repositori Sederhana

CodeArtifact mengimplementasikan versi 1.1 dari PyPI Simple Repository API seperti yang didefinisikan oleh PEP 503, PEP 691, dan PEP 700.

Jenis konten Accept header berikut didukung pada /simple/<project>/ titik akhir:

Jika klien menentukan Accept header yang tidak menyertakan salah satu jenis konten yang didukung, CodeArtifact kembali406 Not Acceptable.

Tanggapan JSON mencakup bidang PEP 700versions,size, dan upload-time bersama dengan bidang PEP 691. Respons HTML membawa waktu unggah per artefak yang sama dengan data-upload-time atribut pada setiap tautan artefak.

upload-timeBidang size and mungkin hilang untuk versi paket yang di-cache sebelum pengambilan metadata per aset diaktifkan. Ketika klien meminta paket seperti itu melalui JSON Simple Repository API, CodeArtifact mengambil kembali metadata dari registri upstream dan mengisi bidang yang hilang. Tidak diperlukan tindakan pelanggan, dan permintaan berikutnya untuk versi paket yang sama mengembalikan metadata lengkap.

pip23.0 dan yang lebih baru dan uv kirim Accept header JSON secara default, sehingga sebagian besar klien menerima JSON tanpa konfigurasi tambahan.

Contoh: meminta JSON untuk sebuah proyek

Contoh berikut digunakan curl untuk mengambil respons JSON Simple Repository API untuk proyek. requests Dapatkan URL repositori dariaws codeartifact get-repository-endpoint, dan token otorisasi dari. aws codeartifact get-authorization-token

curl --header "Accept: application/vnd.pypi.simple.v1+json" \
     --header "Authorization: Bearer $CODEARTIFACT_AUTH_TOKEN" \
     "https://my_domain-111122223333.d.codeartifact.region.amazonaws.com/pypi/my_repo/simple/requests/"

Contoh berikut menunjukkan respons JSON yang khas (terpotong untuk singkatnya). upload-timeBidang versionssize,, dan berasal dari PEP 700;hashes,requires-python, dan yanked bidang berasal dari PEP 691.

{
  "meta": { "api-version": "1.1" },
  "name": "requests",
  "versions": [ "2.31.0", "2.32.0", "2.32.3" ],
  "files": [
    {
      "filename": "requests-2.32.3-py3-none-any.whl",
      "url": "2.32.3/requests-2.32.3-py3-none-any.whl",
      "hashes": {
        "sha256": "70761cfe03c773ceb22aa2f671b4757976145175cdfca038c02654d061d6dcc6",
        "md5": "df6df19f49fc7ae54ee5ff2dd3d22d2c"
      },
      "requires-python": ">=3.8",
      "size": 64928,
      "upload-time": "2024-05-29T15:37:49.123456Z",
      "yanked": false
    }
  ]
}

API PyPI yang tidak didukung

CodeArtifact tidak mendukung API PyPI berikut:

Untuk informasi selengkapnya tentang PyPI API, lihat referensi Legacy API di situs web Python Packaging Authority. GitHub

dukungan perintah pip

Bagian berikut merangkum perintah pip yang didukung, oleh CodeArtifact repositori, selain perintah tertentu yang tidak didukung.

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 CodeArtifact repositori.

CodeArtifact tidak mengimplementasikanpip search. Jika Anda telah mengonfigurasi pip dengan CodeArtifact repositori, menjalankan pip search akan mencari dan menampilkan paket dari PyPI.

Perintah sisi klien yang didukung

Perintah ini tidak memerlukan interaksi langsung dengan repositori, jadi CodeArtifact tidak perlu melakukan apa pun untuk mendukungnya.