कमांड-लाइन इंटरफ़ेस — v0.0.5-alpha.3

ऐतिहासिक alpha.3 CLI reference: Scarp v0.0.5-alpha.3 2 नवंबर 2026 को निश्चित source commit 7715c28df09c7703b39e14fddb963275b25df476 से जारी हुआ। यहाँ लिखी commands उस प्रकाशित prerelease में मौजूद हैं, केवल future proposals नहीं हैं। Scarp अभी experimental interpreter है; इससे .srp प्रोग्राम का native executable नहीं बनता।

नया प्रकाशित release: v0.0.5-alpha.4 में project create, directory verify और launch अब वास्तविक रूप से उपलब्ध हैं। नए project के लिए alpha.4 quickstart पढ़ें। यह पुराना पृष्ठ सिर्फ alpha.3 के exact CLI की जानकारी देता है।

वर्तमान सभी CLI commands के लिए प्रकाशित alpha.4 CLI संदर्भ पढ़ें। इसमें file और project commands, budgets तथा JSON error semantics दिए गए हैं। यह पुराना पृष्ठ जानबूझकर alpha.3 पर ही आधारित है।

Alpha.3 के standalone programs सीखने हों तो alpha.3 quickstart पढ़ें। पुराने scripts के लिए alpha.1 CLI का ऐतिहासिक संदर्भ सुरक्षित रखा गया है।

उपलब्ध commands

बिना arguments के scarp command guidance देता है। पुराने run, check, tokens और modules commands अभी पुराने code की compatibility के लिए उपलब्ध हैं। नए tutorial में नए नामों का उपयोग करें।

सही executable पहचानें

सबसे पहले जाँचें कि आपके executable का version 0.0.5-alpha.3 ही है:

scarp version
scarp guide
scarp diagnose --json

यदि PATH में executable नहीं है तो Windows PowerShell में .\scarp.exe या Linux/macOS में ./scarp लगाएँ। इंस्टॉलेशन quickstart में archive और SHA-256 checksum मिलाने की पूरी विधि है।

Source जाँचें, चलाएँ और inspect करें

प्रकाशित release के examples वाले folder में text_construction.srp, collection_module.srp और उसकी modules/ dependency साथ रखकर ये commands चलाएँ:

scarp verify text_construction.srp
scarp exec text_construction.srp
scarp inspect tokens text_construction.srp
scarp inspect ast text_construction.srp
scarp inspect modules --json collection_module.srp
scarp explain E0015

text_construction.srp चलाने पर प्रकाशित उदाहरण का stdout बिल्कुल यह है:

Hello, 🌍
🌍🌍🌍
8 11

verify और पुराना check एक जैसे नहीं हैं। नया verify सामान्य statements, runtime arithmetic या function contracts चलाए बिना static जाँच करता है। कुछ सीमित compile-time scalar module constants का मूल्यांकन हो सकता है। पुराने check में चुने हुए runtime paths जाँचने के दौरान चल सकते हैं, भले user output न मिले।

inspect tokens केवल lexer है, पूरे program का validator नहीं। inspect ast entry file को parse करता है; यह imports resolve नहीं करता, type checker नहीं है और इसका tree स्थिर machine-readable API नहीं है। Static source/type validation के लिए verify इस्तेमाल करें।

बजट विकल्प और सहायता

exec में interpreter की runtime-budget flags एक source filename के पहले दे सकते हैं। पुराने run में भी यह सुविधा है:

scarp exec --max-steps 2000000 text_construction.srp
scarp guide inspect modules

बजट की सीमाएँ runtime reference में हैं। verify, inspect tokens और inspect ast program चलाते नहीं हैं, इसलिए इनमें runtime-budget flags न दें। Alpha.3 में project create और launch उपलब्ध नहीं थे; प्रकाशित alpha.4 में ये अब उपलब्ध हैं। दोनों versions में arbitrary program arguments forwarding, compile, build, package manager तथा native-code generation अभी उपलब्ध नहीं हैं।

Relative path terminal के वर्तमान folder के आधार पर resolve होता है। Spaces वाले path को quotes में लिखें। - से शुरू होने वाले filename के पहले -- separator लगा सकते हैं। Source UTF-8 होना चाहिए और imports स्थानीय relative modules तक सीमित हैं; source सुरक्षा देखें।

JSON आउटपुट के तीन अलग प्रकार

यह command जानबूझकर प्रकाशित गलत-type वाली fixture पर fail होगी। Program चलाने के बजाय stderr पर E0015 error मिलेगा:

scarp verify --diagnostic-format=json diagnostics/type_error.srp

Failure के समय exit code और stderr दोनों देखें। सफल AST के लिए inspect ast --json उपलब्ध नहीं है। --diagnostic-format=json सफल AST को JSON में नहीं बदलता। अधिक जानकारी: diagnostics और alpha.3 का वास्तविक JSON snapshot।

Exit status और compatibility

सफल verify शांत रहता है। exec सामान्य प्रोग्राम आउटपुट stdout या stderr पर लिख सकता है। Source error पर partial user output नहीं दिया जाता; लेकिन output I/O failure के समय पहले के bytes लिखे जा सकते हैं।

आगे alpha.3 compiler प्रमाण, alpha.2 module inspection और alpha.1 पुराना CLI देखें।

सत्यापन: GitHub CI में इस page के commands प्रकाशित compiler पर जाँचे जाते हैं। प्रदर्शित stdout conformance/alpha3/ में pinned है।