Scarp v0.0.5-alpha.3 से शुरुआत

यह ऐतिहासिक, alpha.3 के लिए सत्यापित शुरुआती गाइड v0.0.5-alpha.3 (2 नवंबर 2026) के लिए शुरुआती मार्गदर्शिका है। Scarp अभी प्रयोगात्मक interpreter है। यह .srp से native executable नहीं बनाता और भाषा की स्थिर compatibility की गारंटी नहीं है। पुराने मुख्य संदर्भ का आधार अब भी alpha.1 है। नई स्थापना के लिए वर्तमान v0.0.6-alpha.3 release देखें; नीचे के commands और source examples जानबूझकर alpha.3 पर आधारित हैं।

1. सही archive चुनें और checksum मिलाएँ

आधिकारिक alpha.3 GitHub release से अपने कंप्यूटर के लिए archive डाउनलोड करें:

उसी release से संबंधित .sha256 या SHA256SUMS फ़ाइल भी लें। Archive extract करने से पहले डाउनलोड की गई फ़ाइल का SHA-256 hash निकालें और आधिकारिक hash से पूरी तरह मिलाएँ:

• Windows PowerShell: Get-FileHash -Algorithm SHA256 -Path .\scarp-0.0.5-alpha.3-x86_64-pc-windows-msvc.zip
• Linux: sha256sum scarp-0.0.5-alpha.3-x86_64-unknown-linux-gnu.tar.gz
• macOS: shasum -a 256 scarp-0.0.5-alpha.3-aarch64-apple-darwin.tar.gz

Hash अलग हो तो उस archive को न चलाएँ। सही archive extract करें और उसमें मौजूद example फ़ाइलों और folders को साथ रखें। Scarp executable सीधे extracted folder से चला सकते हैं; इसे system PATH में जोड़ना अनिवार्य नहीं है।

2. Scarp का version जाँचें

Extracted folder में terminal खोलकर उपयुक्त executable चलाएँ:

scarp version

यदि PATH में Scarp नहीं है तो Windows PowerShell में .\scarp.exe version और Linux/macOS में ./scarp version चलाएँ। आगे जाने से पहले यह पुष्टि करें कि version 0.0.5-alpha.3 है। पुरानी binary के साथ नई commands न मिलाएँ।

3. सत्यापित Scarp प्रोग्राम बनाएँ

अपनी पसंद के folder में UTF-8 encoding वाली text_construction.srp फ़ाइल बनाएँ। नीचे का पूरा code वैसे ही लिखें:

bind greeting: string = text_concat("Hello, ", "🌍");
bind planet = text_slice(greeting, 7, 1);
print(greeting);
print(text_repeat(planet, 3));
print(text_len(greeting), text_bytes(greeting));

यह उदाहरण प्रकाशित alpha.3 compiler source से हूबहू लिया गया है; किसी प्रस्तावित syntax पर आधारित नहीं है।

4. पहले verify, फिर execute करें

उसी folder में जहाँ फ़ाइल रखी है, ये commands चलाएँ:

scarp verify text_construction.srp
scarp exec text_construction.srp

verify बिना सामान्य statements चलाए source और modules की types जाँचता है। exec प्रोग्राम चलाता है। ऊपर दिए गए code का प्रकाशित output यह है:

Hello, 🌍
🌍🌍🌍
8 11

यदि Scarp PATH में नहीं है, तो text_construction.srp को extracted executable वाले folder में रखें और ऊपर लिखे scarp की जगह Windows PowerShell में .\scarp.exe या Linux/macOS पर ./scarp उपयोग करें। वैकल्पिक रूप से executable का पूरा path दें; source फ़ाइल का नाम terminal के वर्तमान folder से resolve होता है।

यहाँ 8 Unicode scalar values की संख्या है, और 11 UTF-8 bytes की। 🌍 एक Unicode scalar value है लेकिन चार bytes लेता है।

5. आगे क्या सीखें?

प्रकाशित alpha.3 CLI reference में commands तथा exit codes और Alpha.3 release guide में चार जाँचे गए programs, नई CLI और structured diagnostics पढ़ें। लंबे installation और source-build चरणों के लिए इंस्टॉलेशन पृष्ठ देखें, जिसका विस्तृत आधार अभी alpha.1 है। किसी भी feature को स्थिर मानने से पहले भाषा की स्थिति देखें।

सत्यापन: इस पृष्ठ का program और output alpha.3 conformance fixtures से TypeScript checks तथा CI में मिलाए जाते हैं।

Alpha.4 में जाएँ? File से project workflow के migration guide में नई और पुरानी commands का अंतर देखें। File commands अब भी चलती हैं; directory commands के लिए alpha.4 आवश्यक है।