Scarp में पहला project बनाएँ (v0.0.5-alpha.4)

यह पुराने प्रकाशित v0.0.5-alpha.4 (3 नवंबर 2026) के लिए नए project की शुरुआती guide है। आधिकारिक compiler source commit 79141329176f5dce51457e90a6652902f6432135 है। Scarp अभी प्रयोगात्मक है और interpreter से program चलाता है।

1. आधिकारिक compiler डाउनलोड और verify करें

GitHub के published release से अपने OS का archive और उसी release की .sha256 अथवा SHA256SUMS file लें।

Archive extract या execute करने से पहले SHA-256 hash को official checksum से मिलाएँ। Terminal से scarp चलने की व्यवस्था करें। यदि PATH में नहीं है तो Windows PowerShell में .\scarp.exe और Linux/macOS में ./scarp का उपयोग करें।

2. Project बनाएँ, verify करें और चलाएँ

Terminal को ऐसे parent folder में खोलें जहाँ hello-world नाम का folder पहले से न हो। ये चार commands क्रम से चलाएँ:

scarp version
scarp create hello-world
scarp verify hello-world
scarp launch hello-world

scarp version का परिणाम 0.0.5-alpha.4 दिखाना चाहिए। create किसी पहले से मौजूद खाली folder को भी overwrite नहीं करता। verify source/type जाँच करता है, सामान्य statements execute नहीं करता। launch starter program को वास्तव में चलाता है।

3. बनी हुई files देखें

Project की structure:

hello-world/
  Scarp.project
  src/
    main.srp

बनी हुई hello-world/Scarp.project file का exact content:

scarp-project: 1
name: hello-world
entry: src/main.srp

Compiler द्वारा बनी hello-world/src/main.srp file:

print("Hello from Scarp!");

Project को launch करने पर प्रकाशित compiler का output:

Hello from Scarp!

यह output simulate नहीं किया गया है। Source, manifest और stdout को compiler के वास्तविक tagged project generator से मिलाया जाता है। GitHub CI भी उसी tagged compiler को build करके project create, verify और launch करती है।

4. Entry file बदलें

hello-world/src/main.srp को UTF-8 text के रूप में edit करें। Manifest का entry: src/main.srp project के भीतर इस file को चुनता है। बदलाव के बाद पहले static verify और फिर execution launch चलाएँ:

scarp verify hello-world
scarp launch hello-world

verify सामान्य program statements, runtime arithmetic या function contracts execute नहीं करता। इसलिए static verification सफल रहने के बाद भी launch पर runtime error आ सकती है।

5. आम समस्याओं का समाधान

Flags, manifest limits और error formats के लिए पूरा alpha.4 release guide, feature status और पुराना alpha.3 CLI reference पढ़ें।

Alpha.3 से आ रहे हैं? मौजूदा files को बदलने से पहले migration checklist देखें। Standalone exec और verify FILE.srp commands अब भी समर्थित हैं।