कॉन्फ़िगर की गई वर्कस्पेस सेवा से कनेक्ट करें

मौजूदा Digital Design Studio वर्कस्पेस सेवा के साथ काम करने के लिए Linux पर Altifigence CLI 0.1.9 का उपयोग करें। आपका ऑपरेटर सेवा का ओरिजिन, वर्कस्पेस की पहुँच और सक्षम सुविधाएँ प्रदान करता है। अनुरोध उस सेवा की वर्कस्पेस फ़ाइलों और प्रयोगों को संबोधित करते हैं।

सहेजा गया परिणाम पढ़ने से पहले निकास स्थिति 0 होना आवश्यक है। मानक त्रुटि को अलग रखें और नीचे वर्णित परिणाम फ़ील्ड की जाँच करें।

कनेक्शन कॉन्फ़िगर करें

ALTI_STUDIO_ENDPOINT को ऑपरेटर द्वारा दिए गए ओरिजिन पर सेट करें। दूरस्थ सेवाएँ HTTPS का उपयोग करती हैं; IP लूपबैक सेवाएँ HTTP का उपयोग कर सकती हैं। खाली पथ वाला ओरिजिन दें और प्रमाणीकरण सक्षम होने पर ऑपरेटर द्वारा दिया गया ALTI_STUDIO_SERVICE_SECRET कॉन्फ़िगर करें। CLI इस मान को x-service-secret के रूप में भेजती है। प्रत्येक कमांड --endpoint से अपना ओरिजिन भी चुन सकती है।

प्रयोगों और रखी गई फ़ाइलों की जाँच करें

कनेक्शन कॉन्फ़िगर होने पर अधिकतम पाँच प्रयोग सूचीबद्ध करें। खाली वर्कस्पेस नीचे दी गई उदाहरणात्मक रसीद लौटाता है; HTTP 200 निकास कोड 0 देता है।

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

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

किसी रखे गए परिणाम के लिए सेवा के वर्कस्पेस में उसका सटीक पथ उपयोग करें। इस उदाहरण के पथ को अपने अधिकृत वर्कस्पेस में मौजूद फ़ाइल से बदलें। प्रतिक्रिया का बॉडी स्वामी की फ़ाइल के फ़ील्ड को सुरक्षित रखता है, जिनमें content भी शामिल है।

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

एक समीक्षा की गई फ़ाइल में खोजें और प्रतिस्थापित करें

वर्कस्पेस में पाठ खोजने के लिए Linux सेवा आवश्यक है। उसी सेवा में खोजें जिसका उपयोग आप प्रतिस्थापन के लिए करेंगे, फिर मेल खाने वाली फ़ाइल, स्थानों और कवरेज मेटाडेटा की समीक्षा करें। प्रत्येक मिलान में contentHash होता है। CLI truncated और replaceScopeComplete को सुरक्षित रखती है ताकि आप लौटाए गए दायरे का आकलन कर सकें।

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

निम्न सामग्री को replace.json के रूप में सहेजें और उदाहरण के 64 वर्ण वाले हैश को चुने गए rtl/top.sv मिलान के वास्तविक contentHash से बदलें। क्वेरी और विकल्पों को अपनी समीक्षा के अनुरूप रखें। अनुरोध एक फ़ाइल को लक्षित करता है; match छोड़ देने पर उस फ़ाइल के मेल खाने वाले स्थानों पर प्रतिस्थापन लागू होता है। अपेक्षित हैश अपडेट को उस फ़ाइल संस्करण से बाँधता है जिसकी आपने समीक्षा की थी।

{
  "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

विरोधों और कॉन्फ़िगरेशन त्रुटियों से उबरें

यदि फ़ाइल बदल गई है, तो नीचे एक उदाहरणात्मक विरोध रसीद दिखाई गई है। HTTP 409 निकास कोड 1 देता है। उसी सेवा में फिर से खोजें, वर्तमान मिलानों और फ़ाइल संस्करण की समीक्षा करें, फिर नया प्रतिस्थापन भेजने से पहले नए contentHash से expectedHashes अपडेट करें।

{"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":[]}}

httpStatus: null के साथ STUDIO_ENDPOINT_REQUIRED निकास कोड 2 देता है: ऑपरेटर का ओरिजिन कॉन्फ़िगर करें और दोबारा चलाएँ। HTTP 401 के लिए ऑपरेटर से संबंधित सेवा सीक्रेट प्राप्त करें। प्रतिस्थापन के बाद टाइमआउट होने पर कोई अन्य अपडेट तय करने से पहले वर्तमान फ़ाइल की जाँच करें और फिर से खोजें।