TypeSpec: API-केंद्रित विकास के लिए नई भाषा

 (typespec.io)
6 पॉइंट द्वारा GN⁺ 2024-05-02 | 1 टिप्पणियां | WhatsApp पर शेयर करें
  • TypeSpec API-केंद्रित विकास के लिए एक नई भाषा है, जिसे API डेवलपर्स, डिज़ाइनरों और मैनेजरों की ज़रूरतों को पूरा करने के लिए डिज़ाइन किया गया है
    • यह ऐसे वातावरण में विकसित किया गया है जहाँ लगातार उच्च गुणवत्ता वाले API और संबंधित अनुभव देना लगातार अधिक जटिल और महत्वपूर्ण होता जा रहा है
    • TypeSpec सिर्फ़ एक भाषा नहीं, बल्कि एक ऐसा प्लेटफ़ॉर्म है जो abstraction को संभव बनाता है, code reuse को बढ़ावा देता है, और तेज़ विकास के लिए आधुनिक टूलिंग का उपयोग करता है

TypeSpec के मुख्य फीचर्स

  • इंटरऑपरेबिलिटी
    • TypeSpec सिर्फ़ एक API description language नहीं है; यह एक high-level definition language है जो API को परिभाषित करके विभिन्न protocols, clients, servers और documentation को एक साथ emit कर सकता है
    • यह इंडस्ट्री-स्टैंडर्ड API definition भाषाओं के साथ interoperable है, जिससे अलग-अलग विकल्पों के बीच का अंतर कम होता है
  • उत्पादकता
    • TypeSpec उत्कृष्ट डेवलपर एक्सपीरियंस देता है जो डेटा और API definition प्रक्रिया को सरल व उत्पादक बनाता है
    • भाषा सरल है और कम इनपुट में जटिल डेटा और API structure define किया जा सकता है
  • API पैटर्न
    • TypeSpec सामान्य data types, API patterns और guidelines को टीम या ecosystem स्तर पर साझा किए जाने वाले reusable high-level components के रूप में encapsulate करके API quality improve करता है
  • परिचितता
    • TypeSpec ने TypeScript और C# से प्रेरणा लेकर इसे सीखना आसान बनाया है, इसलिए यह कई डेवलपर्स के लिए परिचित महसूस होता है
  • एक्सटेंसिबिलिटी
    • TypeSpec को custom decorator vocabularies और type templates के साथ extend करके business या application logic domain में API को model किया जा सकता है
  • इकोसिस्टम
    • TypeSpec से सामान्य types, language extensions, linters और emitters को पैकेज के रूप में bundle करके संगठन के भीतर या पूरे इकोसिस्टम में NPM पर distribute किया जा सकता है

समुदाय और सहयोग

  • Microsoft में उपयोग
    • Microsoft TypeSpec का उपयोग करके API विकास प्रक्रिया में बदलाव ला रहा है
    • कई Azure services ने TypeSpec अपना लिया है, और उनकी संख्या हर दिन बढ़ रही है
    • Microsoft Graph टीम TypeSpec की क्षमता का उपयोग करके productivity बढ़ा रही है और customization को सरल बना रही है
  • सहभागिता के लिए आमंत्रण
    • TypeSpec सिर्फ़ एक भाषा नहीं, बल्कि एक community है
    • सभी पृष्ठभूमि के डेवलपर्स को public beta में शामिल होकर TypeSpec की ताकत सीधे महसूस करने के लिए आमंत्रित किया जाता है

GN+ की राय

  • TypeSpec एक उच्च abstraction वाला API definition language लग रहा है, जो API development approach को काफी सुधार सकता है
    • यह "API First" approach को support करता है और विकास दक्षता व अंतिम product quality में सुधार में मदद कर सकता है
    • अलग-अलग protocols का समर्थन, extensibility और मजबूत ecosystem के कारण यह कई development scenarios में उपयोगी हो सकता है
  • लेकिन किसी नई भाषा को अपनाने में हमेशा learning cost आती है, इसलिए टीम में rollout से पहले पर्याप्त training होनी चाहिए
    • TypeScript और C# की syntax लेने का प्रयास सीखने की curve को कम करने की दिशा में एक सकारात्मक कदम है
  • Swagger, RAML, API Blueprint जैसे समान भूमिका वाले मौजूद API definition languages के साथ इसके differentiation points को और स्पष्ट करने की ज़रूरत है
    • यह कैसे पुराने language limits को resolve करता है और migration कितना आसान है, जैसे प्रश्न अभी भी बाकी हैं
  • Microsoft के अंदर पहले से उपयोग करके धीरे-धीरे सुधारने वाला dogfooding approach भरोसा देता है
    • लेकिन यह अभी ओपन सोर्स प्रोजेक्ट के रूप में नया है, इसलिए आने वाले कई वर्षों तक लगातार विकास और community support महत्त्वपूर्ण होगा
  • API डिजाइन में standardization और reusability बढ़ाने का दिशा सही है, पर कभी-कभी ऐसा लगता है कि एक साथ बहुत कुछ solve करने की कोशिश हो रही है
    • बेहतर होगा कि प्राथमिकता तय करके फीचर को चरणबद्ध तरीके से मजबूत किया जाए

संबंधित पढ़ाई

1 टिप्पणियां

 
GN⁺ 2024-05-02
Hacker News टिप्पणियाँ
  • अगर आप पहले से ही API टाइपिंग के लिए TypeScript का इस्तेमाल कर रहे हैं, तो TypeScript से सीधे JSON स्कीमा जनरेट करने वाला ts-json-schema-generator एक अच्छा विकल्प हो सकता है।
  • OpenAPI के YAML की तुलना में कुछ भी बेहतर दिख सकता है, लेकिन फिर भी OpenAPI को विकास के सबसे अच्छे प्रयासों में से एक माना जाता है।
  • TypeScript को schema language के तौर पर breakthrough बनाने की उम्मीद थी, लेकिन TypeSpec ऐसा लगता है कि यह JavaScript हटा कर सिर्फ JSON के लिए टाइपिंग छोड़ देता है।
  • हमने TypeSpec को latest APIs में इस्तेमाल करते हुए GraphQL की तरह API को describe करके design-first तरीके से build करने वाला टूल खोजा; जबकि OpenAPI editors बहुत clunky हैं और API के अंदर data relationships को अस्पष्ट बना देते हैं, TypeSpec काफी मददगार साबित हुआ।
  • क्योंकि यह Microsoft द्वारा बनाया गया है, इसलिए अंदाज़ा है कि यह GraphQL पर उनका जवाब है, और अगर अंदरूनी तौर पर इस्तेमाल हो रहा हो तो शायद ओपन सोर्स consortium से बनी चीजों की तुलना में tooling बेहतर हो।
  • यह WSDL जैसा लग रहा है, यानी WSDL का TypeScript version, लेकिन पता नहीं कि यह WSDL से ज़्यादा टिकेगा या नहीं।
  • बड़ा सवाल यह था कि supported output languages क्या हैं; लगता है OpenAPI export करके खराब generator चलाने के अलावा कोई विकल्प नहीं है।
  • अच्छा होता अगर TypeSpec फ़ाइलों को TypeScript में import करके auto types मिल जाएँ, लेकिन code generation सिरदर्दी वाला और error-prone है।
  • यह Smithy का competitor/alternative लगता है; अगर TypeSpec टीम से कोई यहाँ हो तो तुलना कैसे है, यह सुनना चाहूँगा।
  • उत्सुकता है कि इसे YAML में बदलकर मनचाही toolchain में convert किया जा सकेगा या नहीं।
  • अच्छा होता अगर 25 साल पहले CORBA IDL जो देती थी, वैसा high-level IDL मिले जो schema और multi-language stub generation दे।