Resterm

टर्मिनल के लिए एक API-as-code वर्कबेंच।
resterm.app · docs

Resterm एक API क्लाइंट है जो .http/.rest फ़ाइलों को सोर्स कोड के रूप में उपयोग करता है। लगभग सभी सुविधाएँ .http फ़ाइलों में रहती हैं, इसलिए इन्हें Git या किसी अन्य वर्ज़न कंट्रोल में समीक्षा करना आसान होता है। आप सीधे TUI से अनुरोध भेज सकते हैं, API फ़्लो का परीक्षण कर सकते हैं, HTTP ट्रैफ़िक रिकॉर्ड कर सकते हैं और लोकल मॉक सर्वर चला सकते हैं, या resterm run कमांड के साथ स्क्रिप्ट और CI में वही परिभाषाएँ चला सकते हैं।

Resterm क्यों

• पूर्ण API फ़्लो का परीक्षण करें। लॉग इन करें, टोकन कैप्चर करें, एक रिसोर्स बनाएँ, और परिणाम जाँचें। अपनी अनुरोध फ़ाइलों में सीधे assertions, loops, conditions, retries, और scripts जोड़ें।
• वास्तविक ट्रैफ़िक को लोकल मॉक में बदलें। HTTP अनुरोधों और प्रतिक्रियाओं को रिकॉर्ड करें, फिर उन्हें चलाने योग्य अनुरोधों या मॉक परिभाषाओं के रूप में सहेजें। मॉक को उन अनुरोधों के पास रखें जो उनका उपयोग करते हैं।
• पता लगाएँ कि क्या बदला। विभिन्न वातावरणों में प्रतिक्रियाओं की तुलना करें, पहले के परिणामों से diff करें, अनुरोध समय का निरीक्षण करें, और बार-बार चलने वाले रनों को प्रोफ़ाइल करें।
• लोकल और CI में समान जाँच चलाएँ। विकास के दौरान टर्मिनल UI का उपयोग करें, फिर उन फ़ाइलों को resterm run के साथ चलाएँ। JSON या JUnit रिपोर्ट निर्यात करें।
• कई प्रोटोकॉल पर काम करें। HTTP, GraphQL, और gRPC अनुरोध भेजें, और WebSocket और SSE स्ट्रीम के साथ काम करें।

अंतर्निहित SSH tunnels और Kubernetes port-forwards आपको bastion के पीछे या क्लस्टर के अंदर API तक पहुँचने देते हैं।

कोई अकाउंट नहीं, कोई टेलीमेट्री नहीं, कोई AI सुविधाएँ नहीं।

स्क्रीनशॉट

Trace और timeline

UI का और देखने के लिए क्लिक करें

Workflows

Profiler

Explain

RestermScript

इंस्टॉल करें

macOS और Linux:

brew install resterm
# or
curl -fsSL https://raw.githubusercontent.com/unkn0wn-root/resterm/main/install.sh | bash

Windows:

iwr -useb https://raw.githubusercontent.com/unkn0wn-root/resterm/main/install.ps1 | iex

Go 1.25 या नए संस्करण के साथ:

go install github.com/unkn0wn-root/resterm/cmd/resterm@latest

macOS, Linux और Windows के लिए पहले से बने बाइनरीज़ releases पेज पर हैं। Linux बाइनरीज़ के लिए glibc 2.32 या नया संस्करण आवश्यक है।

अपडेट करने के लिए, यदि आपने Homebrew से इंस्टॉल किया है तो brew upgrade resterm चलाएँ। अन्यथा resterm --update चलाएँ। अधिक जानकारी install गाइड में।

त्वरित शुरुआत

mkdir my-api && cd my-api
resterm init
resterm

resterm init एक requests.http फ़ाइल बनाता है जिसमें कुछ नमूना अनुरोध और उनका उत्तर देने के लिए लोकल मॉक होते हैं, इसलिए इसे आज़माने के लिए आपको वास्तविक API की आवश्यकता नहीं है। मॉक सर्वर शुरू करने के लिए g Shift+M दबाएँ, कर्सर को किसी अनुरोध पर ले जाएँ और उसे भेजने के लिए Ctrl+Enter दबाएँ। किसी भी समय सहायता के लिए ? दबाएँ।

आपको init की भी आवश्यकता नहीं है। resterm चलाएँ, एक URL टाइप करें या curl कमांड पेस्ट करें, और Ctrl+Enter दबाएँ।

वही फ़ाइल UI के बिना भी चलती है। एक टर्मिनल में मॉक शुरू करें और दूसरे में एक अनुरोध चलाएँ:

resterm mock requests.http                       # terminal 1
resterm run --request CreateUser requests.http   # terminal 2

अनुरोध फ़ाइलें

Resterm मानक .http प्रारूप पढ़ता है और सेटिंग्स और ऑटोमेशन के लिए ऊपर # @ निर्देश जोड़ता है:

# @setting base-url https://api.example.com/v1/

### Create users
// Send this request once for each name in the list.
# @for-each ["david", "tom"] as name
# @when env.mode == "development"
# @assert response.statusCode == 201
POST users
Content-Type: application/json

{"name":"{{= name }}"}

पहले अनुरोध से पहले का @setting पूरी फ़ाइल पर लागू होता है। ### एक नया अनुरोध शुरू करता है। किसी अनुरोध के ऊपर के निर्देश उसे दोहरा सकते हैं, छोड़ सकते हैं या प्रतिक्रिया की जाँच कर सकते हैं।

और उदाहरण _examples/ में हैं, और प्रत्येक निर्देश request file reference में सूचीबद्ध है।

दस्तावेज़ीकरण

पूर्ण दस्तावेज़ resterm.app/docs पर हैं। शुरुआत करने के लिए अच्छे स्थान हैं workflows, mock servers, recording, the CLI और RestermScript।

TUI के अंदर, :help <topic> अंतर्निहित मैनुअल खोलता है और :docs <topic> वेबसाइट पर वही पेज खोलता है।

अपने स्वयं के Go कोड से अनुरोध फ़ाइलें चलाने के लिए, headless पैकेज देखें।

प्रायोजक

Resterm मुफ़्त और ओपन सोर्स है और हमेशा रहेगा। यदि आपको मेरा काम पसंद है, तो आप GitHub पर इसे प्रायोजित कर सकते हैं।

लाइसेंस

Apache License 2.0।