Amazon CodeCatalyst ist nicht mehr offen für Neukunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter [Wie migriert man von CodeCatalyst](migration.md).

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Verwenden von Python
<a name="packages-python"></a>

In diesen Themen wird beschrieben`pip`, wie Sie den Python-Paketmanager und `twine` das Python-Hilfsprogramm zur Paketveröffentlichung mit verwenden CodeCatalyst.

**Topics**
+ [Pip konfigurieren und Python-Pakete installieren](packages-python-pip.md)
+ [Twine konfigurieren und Python-Pakete veröffentlichen](packages-python-twine.md)
+ [Normalisierung von Python-Paketnamen](python-name-normalization.md)
+ [Python-Kompatibilität](packages-python-compatibility.md)

# Pip konfigurieren und Python-Pakete installieren
<a name="packages-python-pip"></a>

Um `pip` mit zu verwenden CodeCatalyst, müssen Sie eine Verbindung `pip` zu Ihrem Paket-Repository herstellen und ein persönliches Zugriffstoken für die Authentifizierung bereitstellen. Anweisungen zum Herstellen einer Verbindung `pip` zu Ihrem Paket-Repository finden Sie in der CodeCatalyst Konsole. Nachdem Sie sich authentifiziert und eine `pip` Verbindung hergestellt haben CodeCatalyst, können Sie `pip` Befehle ausführen.

**Contents**
+ [Python-Pakete CodeCatalyst mit pip installieren](#pip-install)
+ [Python-Pakete von PyPI konsumieren bis CodeCatalyst](#pip-install-pypi)
+ [Unterstützung für Pip-Befehle](#pip-command-support)
  + [Unterstützte Befehle, die mit einem Repository interagieren](#supported-pip-commands-that-interact-with-a-repository)
  + [Unterstützte clientseitige Befehle](#supported-pip-client-side-commands)

## Python-Pakete CodeCatalyst mit pip installieren
<a name="pip-install"></a>

Die folgenden Anweisungen erklären, wie Sie die Installation von Python-Paketen aus Ihrem CodeCatalyst Paket-Repository oder einem seiner Upstream-Repositorys konfigurieren`pip`.

**Um Python-Pakete aus Ihrem CodeCatalyst Paket-Repository `pip` zu konfigurieren und zu installieren**

1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Wählen Sie auf der Übersichtsseite für Ihr Projekt die Option **Pakete** aus.

1. Wählen Sie Ihr Paket-Repository aus der Liste der Paket-Repositorys aus.

1. Wählen Sie **Mit Repository verbinden**.

1. Wählen **Sie im Dialogfeld Mit Repository verbinden** die Option **pip** aus der Liste der Paketmanager-Clients aus.

1. Sie benötigen ein Personal Access Token (PAT), mit dem Sie Pip authentifizieren können. CodeCatalyst Wenn Sie bereits eines haben, können Sie dieses verwenden. Wenn nicht, können Sie hier eine erstellen.

   1. Wählen Sie **Token erstellen**.

   1. Wählen Sie **Kopieren**, um Ihre PAT zu kopieren.
**Warnung**  
Sie können Ihre PAT nicht mehr sehen oder kopieren, nachdem Sie das Dialogfeld geschlossen haben.

1. Verwenden Sie den `pip config` Befehl, um die CodeCatalyst Registrierungs-URL und die Anmeldeinformationen festzulegen. Ersetzen Sie die folgenden Werte.
**Anmerkung**  
Wenn Sie Anweisungen aus der Konsole kopieren, sollten die folgenden Werte für Sie aktualisiert und nicht geändert werden.
   + *username*Ersetzen Sie sie durch Ihren CodeCatalyst Benutzernamen.
   + Ersetzen Sie es *PAT* durch Ihr CodeCatalyst PAT.
   + *space\$1name*Ersetzen Sie es durch Ihren CodeCatalyst Bereichsnamen.
   + Ersetze es *proj\$1name* durch deinen CodeCatalyst Projektnamen.
   + Ersetzen Sie es durch *repo\$1name* den Namen Ihres CodeCatalyst Paket-Repositorys.

   ```
   pip config set global.index-url https://username:PAT@https://packages.region.codecatalyst.aws/pypi/space_name/proj_name/repo_name/simple/
   ```

1. Unter der Annahme, dass ein Paket in Ihrem Repository oder einem seiner Upstream-Repositorys vorhanden ist, können Sie es mit `pip install` installieren. Verwenden Sie beispielsweise den folgenden Befehl, um das `requests` Paket zu installieren.

   ```
   pip install requests
   ```

   Verwenden Sie die `-i` Option, um vorübergehend zur Installation von Paketen von [https://pypi.org](https://pypi.org) statt von Ihrem CodeCatalyst Paket-Repository zurückzukehren.

   ```
   pip install -i https://pypi.org/simple requests
   ```

## Python-Pakete von PyPI konsumieren bis CodeCatalyst
<a name="pip-install-pypi"></a>

**Sie können Python-Pakete aus dem [Python Package Index (PyPI)](https://www.pypi.org/) über ein CodeCatalyst Repository konsumieren, indem Sie das Repository mit einer Upstream-Verbindung zu PyPI konfigurieren.** Von **PyPI** konsumierte Pakete werden aufgenommen und in Ihrem Repository gespeichert. CodeCatalyst 

**Um Pakete von PyPI zu konsumieren**

1. Falls Sie es noch nicht getan haben, konfigurieren Sie pip mit Ihrem CodeCatalyst Paket-Repository, indem Sie die Schritte unter befolgen. [Python-Pakete CodeCatalyst mit pip installieren](#pip-install) 

1. Stellen Sie sicher, dass Ihr Repository **PyPI** als Upstream-Quelle hinzugefügt hat. Sie können überprüfen, welche Upstream-Quellen hinzugefügt wurden, oder **PyPI** als Upstream-Quelle hinzufügen, indem Sie den Anweisungen unter folgen [Ein Upstream-Repository hinzufügen](packages-upstream-repositories-add.md) und das **PyPI-Speicher-Repository** auswählen.

Weitere Informationen zum Anfordern von Paketen aus Upstream-Repositorys finden Sie unter. [Eine Paketversion mit Upstream-Repositorys anfordern](packages-upstream-repositories-request.md)

## Unterstützung für Pip-Befehle
<a name="pip-command-support"></a>

In den folgenden Abschnitten werden die Pip-Befehle zusammengefasst, die von CodeCatalyst Repositorys unterstützt werden, zusätzlich zu bestimmten Befehlen, die nicht unterstützt werden.

**Topics**
+ [Unterstützte Befehle, die mit einem Repository interagieren](#supported-pip-commands-that-interact-with-a-repository)
+ [Unterstützte clientseitige Befehle](#supported-pip-client-side-commands)

### Unterstützte Befehle, die mit einem Repository interagieren
<a name="supported-pip-commands-that-interact-with-a-repository"></a>

In diesem Abschnitt sind `pip` Befehle aufgeführt, bei denen der `pip` Client eine oder mehrere Anfragen an die Registry stellt, mit der er konfiguriert wurde. Es wurde überprüft, ob diese Befehle korrekt funktionieren, wenn sie in einem CodeCatalyst Paket-Repository aufgerufen werden.


****  

| Befehl | Description | 
| --- | --- | 
|   [install](https://pip.pypa.io/en/stable/reference/pip_install/)   |  Pakete installieren.  | 
|   [herunterladen](https://pip.pypa.io/en/stable/reference/pip_download/)   |  Pakete herunterladen.  | 

CodeCatalyst implementiert nicht`pip search`. Wenn Sie `pip` mit einem CodeCatalyst Paket-Repository konfiguriert haben, `pip search` werden beim Ausführen Pakete von [PyPI](https://pypi.org/) gesucht und angezeigt.

### Unterstützte clientseitige Befehle
<a name="supported-pip-client-side-commands"></a>

Diese Befehle erfordern keine direkte Interaktion mit einem Repository und müssen daher auch CodeCatalyst nicht unterstützt werden.


****  

| Befehl | Description | 
| --- | --- | 
|   [deinstallieren](https://pip.pypa.io/en/stable/reference/pip_uninstall/)   |  Pakete deinstallieren.  | 
|   [einfrieren](https://pip.pypa.io/en/stable/reference/pip_freeze/)   |  Gibt installierte Pakete im Anforderungsformat aus.  | 
|   [Liste](https://pip.pypa.io/en/stable/reference/pip_list/)   |  Listet die installierten Pakete auf.  | 
|   [sh](https://pip.pypa.io/en/stable/reference/pip_show/)ow   |  Zeigt Informationen über installierte Pakete an.  | 
|   [überprüfen](https://pip.pypa.io/en/stable/reference/pip_check/)   |  Stellen Sie sicher, dass die installierten Pakete kompatible Abhängigkeiten haben.  | 
|   [config](https://pip.pypa.io/en/stable/reference/pip_config/)   |  Verwalten Sie die lokale und globale Konfiguration.  | 
|   [Rad](https://pip.pypa.io/en/stable/reference/pip_wheel/)   |  Baue Räder nach deinen Anforderungen.  | 
|   [Hash](https://pip.pypa.io/en/stable/reference/pip_hash/)   |  Berechnet die Hashes von Paketarchiven.  | 
|   [Fertigstellung](https://pip.pypa.io/en/stable/user_guide/#command-completion)   |  Hilft bei der Befehlsvervollständigung.  | 
|   [debug](https://pip.pypa.io/en/stable/reference/pip_debug/)   |  Zeigt Informationen an, die für das Debuggen nützlich sind.  | 
|  help  |  Zeigt Hilfe für Befehle an.  | 

# Twine konfigurieren und Python-Pakete veröffentlichen
<a name="packages-python-twine"></a>

Um `twine` mit zu verwenden CodeCatalyst, müssen Sie eine Verbindung `twine` zu Ihrem Paket-Repository herstellen und ein persönliches Zugriffstoken für die Authentifizierung bereitstellen. Anweisungen zum Herstellen einer Verbindung `twine` zu Ihrem Paket-Repository finden Sie in der CodeCatalyst Konsole. Nachdem Sie sich authentifiziert und eine `twine` Verbindung hergestellt haben CodeCatalyst, können Sie `twine` Befehle ausführen.

## Pakete CodeCatalyst mit Twine veröffentlichen
<a name="packages-twine-publish"></a>

Die folgenden Anweisungen erklären, wie Sie sich authentifizieren und eine Verbindung `twine` zu Ihrem CodeCatalyst Paket-Repository herstellen können.

**Zur Konfiguration und Verwendung `twine` zum Veröffentlichen von Paketen in Ihrem CodeCatalyst Paket-Repository**

1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Wählen Sie auf der Übersichtsseite für Ihr Projekt die Option **Pakete** aus.

1. Wählen Sie Ihr Paket-Repository aus der Liste der Paket-Repositorys aus.

1. Wählen Sie **Mit Repository verbinden**.

1. Wählen **Sie im Dialogfeld Mit Repository verbinden** die Option **Twine** aus der Liste der Paketmanager-Clients aus.

1. Sie benötigen ein Personal Access Token (PAT), mit dem Sie Twine authentifizieren können. CodeCatalyst Wenn Sie bereits einen haben, können Sie diesen verwenden. Wenn nicht, können Sie hier eine erstellen.

   1. Wählen Sie **Token erstellen**.

   1. Wählen Sie **Kopieren**, um Ihre PAT zu kopieren.
**Warnung**  
Sie können Ihre PAT nicht mehr sehen oder kopieren, nachdem Sie das Dialogfeld geschlossen haben.

1. Sie können Twine mit einer `.pypirc` Datei oder mit Umgebungsvariablen konfigurieren.

   1. **Um mit einer `.pypirc` Datei zu konfigurieren.**

      Öffnen Sie `~/.pypirc` in einem Editor Ihrer Wahl.

      Fügen Sie einen Indexserver für hinzu CodeCatalyst, einschließlich des Repositorys, des Benutzernamens und der PAT, die Sie in einem vorherigen Schritt erstellt und kopiert haben. Ersetzen Sie die folgenden Werte.
**Anmerkung**  
Wenn Sie Anweisungen aus der Konsole kopieren, sollten die folgenden Werte für Sie aktualisiert und nicht geändert werden.
      + *username*Ersetzen Sie sie durch Ihren CodeCatalyst Benutzernamen.
      + Ersetzen Sie es *PAT* durch Ihr CodeCatalyst PAT.
      + *space\$1name*Ersetzen Sie es durch Ihren CodeCatalyst Bereichsnamen.
      + Ersetze es *proj\$1name* durch deinen CodeCatalyst Projektnamen.
      + Ersetzen Sie es durch *repo\$1name* den Namen Ihres CodeCatalyst Paket-Repositorys.

      ```
      [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. **Zur Konfiguration mit Umgebungsvariablen.**

      Stellen Sie die folgenden Umgebungsvariablen ein. Geben Sie den `TWINE_REPOSITORY_URL` Wert update und die Namen Ihres CodeCatalyst Space- *space\$1name* *proj\$1name**repo\$1name*, Projekt- und Paket-Repositorys ein.

      ```
      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. Veröffentlichen Sie eine Python-Distribution mit dem `twine upload` Befehl.

# Normalisierung von Python-Paketnamen
<a name="python-name-normalization"></a>

CodeCatalyst normalisiert Paketnamen, bevor sie gespeichert werden, was bedeutet, dass sich die Paketnamen in CodeCatalyst möglicherweise von dem Namen unterscheiden, der bei der Veröffentlichung des Pakets angegeben wurde.

Bei Python-Paketen wird der Paketname bei der Normalisierung in Kleinbuchstaben geschrieben und alle Instanzen der Zeichen`.`,`-`, und `_` werden durch ein einzelnes Zeichen ersetzt. `-` Die Paketnamen `pigeon_cli` und und `pigeon.cli` werden also normalisiert und gespeichert als. `pigeon-cli` Der nicht normalisierte Name kann von pip und twine verwendet werden. Weitere Informationen zur Normalisierung von Python-Paketnamen finden Sie unter [PEP 503](https://www.python.org/dev/peps/pep-0503/#normalized-names) in der Python-Dokumentation.

# Python-Kompatibilität
<a name="packages-python-compatibility"></a>

 Es CodeCatalyst unterstützt zwar nicht die `/simple/` API, aber die `Legacy` API-Operationen. CodeCatalyst unterstützt keine PyPI `XML-RPC` - oder `JSON` API-Operationen. 

Weitere Informationen finden Sie im Folgenden im GitHub Repository der Python Packaging Authority.
+ [Legacy-API](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)
+ [JSON-API](https://docs.pypi.org/api/json/)