Verbinden Sie sich mit einem konfigurierten Arbeitsbereichsdienst

Verwenden Sie Altifigence CLI 0.1.9 unter Linux, um mit einem bestehenden Arbeitsbereichsdienst von Digital Design Studio zu arbeiten. Ihr Betreiber stellt den Dienstursprung, den Arbeitsbereichszugriff und die aktivierten Funktionen bereit. Anfragen richten sich an die Arbeitsbereichsdateien und Experimente dieses Dienstes.

Setzen Sie den Exit-Status 0 voraus, bevor Sie ein gespeichertes Ergebnis lesen. Bewahren Sie die Standardfehlerausgabe separat auf und prüfen Sie die unten beschriebenen Ergebnisfelder.

Konfigurieren Sie die Verbindung

Setzen Sie ALTI_STUDIO_ENDPOINT auf den vom Betreiber bereitgestellten Ursprung. Entfernte Dienste verwenden HTTPS; Dienste über eine IP-Loopback-Adresse dürfen HTTP verwenden. Geben Sie einen Ursprung mit leerem Pfad an und konfigurieren Sie bei aktivierter Authentifizierung das vom Betreiber bereitgestellte ALTI_STUDIO_SERVICE_SECRET. Die CLI sendet diesen Wert als x-service-secret. Jeder Befehl kann seinen Ursprung auch mit --endpoint auswählen.

Prüfen Sie Experimente und aufbewahrte Dateien

Listen Sie nach der Verbindungskonfiguration bis zu fünf Experimente auf. Ein leerer Arbeitsbereich gibt den folgenden beispielhaften Beleg zurück; HTTP 200 beendet den Befehl mit Code 0.

alti --json ide service evolve list --limit 5

{"schema":"altifigence.dds.service-receipt.v1","operation":"evolve.list","ok":true,"httpStatus":200,"body":{"runs":[]}}

Verwenden Sie für ein aufbewahrtes Ergebnis dessen exakten Pfad im Dienst-Arbeitsbereich. Ersetzen Sie diesen Beispielpfad durch eine Datei, die in Ihrem autorisierten Arbeitsbereich vorhanden ist. Der Antwortinhalt bewahrt die Dateifelder des Eigentümers einschließlich content.

alti --json ide service evolve read-file evolve/adder/results/report.md

Suchen und ersetzen Sie in einer geprüften Datei

Die Textsuche im Arbeitsbereich erfordert einen Linux-Dienst. Durchsuchen Sie denselben Dienst, den Sie für die Ersetzung verwenden werden, und prüfen Sie anschließend die gefundene Datei, die Fundstellen und die Metadaten zur Abdeckung. Jeder Treffer enthält einen contentHash. Die CLI bewahrt truncated und replaceScopeComplete, damit Sie den zurückgegebenen Umfang beurteilen können.

alti --json ide service workspace search --query old_signal --match-case --whole-word

Speichern Sie Folgendes als replace.json und ersetzen Sie den beispielhaften Hash mit 64 Zeichen durch den tatsächlichen contentHash des ausgewählten Treffers in rtl/top.sv. Halten Sie die Suchanfrage und die Optionen mit Ihrer Prüfung konsistent. Die Anfrage richtet sich an eine einzelne Datei; wenn match weggelassen wird, wird die Ersetzung auf deren passende Vorkommen angewendet. Der erwartete Hash bindet die Aktualisierung an die von Ihnen geprüfte Dateiversion.

{
  "query": "old_signal",
  "replacement": "new_signal",
  "options": {
    "matchCase": true,
    "wholeWord": true
  },
  "paths": [
    "rtl/top.sv"
  ],
  "expectedHashes": {
    "rtl/top.sv": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

alti --json ide service workspace replace --request replace.json

Beheben Sie Konflikte und Konfigurationsfehler

Wenn sich die Datei geändert hat, zeigt der folgende Block einen beispielhaften Konfliktbeleg. HTTP 409 beendet den Befehl mit Code 1. Führen Sie die Suche erneut gegen denselben Dienst aus, prüfen Sie die aktuellen Treffer und die Dateiversion und aktualisieren Sie anschließend expectedHashes mit dem neuen contentHash, bevor Sie eine neue Ersetzung einreichen.

{"schema":"altifigence.dds.service-receipt.v1","operation":"workspace.replace","ok":false,"httpStatus":409,"body":{"ok":false,"code":"search_replace_conflict","conflicts":[{"path":"rtl/top.sv","expectedHash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","actualHash":"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"}],"replacements":0,"files":[]}}

STUDIO_ENDPOINT_REQUIRED mit httpStatus: null beendet den Befehl mit Code 2: Konfigurieren Sie den Ursprung des Betreibers und führen Sie den Befehl erneut aus. Beziehen Sie bei HTTP 401 das passende Dienstgeheimnis vom Betreiber. Bei einer Zeitüberschreitung nach einer Ersetzung müssen Sie die aktuelle Datei prüfen und erneut suchen, bevor Sie über eine weitere Aktualisierung entscheiden.