PEP 3107 (फ़ीचर एनोटेशन)

पीईपी 572 - फ़ीचर एनोटेशन

मानक के लिए एनोटेशन

औचित्य

फ़ीचर एनोटेशन बेसिक्स

1. मापदंडों के लिए एनोटेशन और फ़ंक्शन के रिटर्न मान पूरी तरह से वैकल्पिक हैं।
2. संकलन समय पर एक फ़ंक्शन के विभिन्न भागों के साथ मनमाने ढंग से अभिव्यक्तियों को जोड़ने के तरीके से ज्यादा कुछ नहीं है।
   
   पायथन खुद एनोटेशन पर कोई ध्यान नहीं देता है। केवल एक चीज यह है कि यह आपको उन्हें एक्सेस करने की अनुमति देता है, जिसे नीचे दिए गए "गेटिंग एक्सेस टू फीचर एनोटेशन" अनुभाग में वर्णित किया गया है।
   
   जब केवल तृतीय-पक्ष पुस्तकालयों द्वारा व्याख्या की जाती है, तो एनोटेशन का अर्थ होता है। वे फ़ंक्शन एनोटेशन के साथ जो चाहें कर सकते हैं। उदाहरण के लिए, एक पुस्तकालय, बेहतर संदर्भ डेटा प्रदान करने के लिए स्ट्रिंग एनोटेशन का उपयोग कर सकता है, उदाहरण के लिए:
   
   

   def compile(source: "something compilable",
               filename: "where the compilable thing comes from",
               mode: "is this a single statement or a suite?"):
       ...

   
   एक अन्य पुस्तकालय प्रकार मिलान के लिए जाँच करने के लिए पायथन फ़ंक्शन और विधि एनोटेशन का उपयोग कर सकता है। यह पुस्तकालय एनोटेशन का उपयोग यह दिखाने के लिए कर सकता है कि यह किस प्रकार के इनपुट डेटा की अपेक्षा करता है और यह किस प्रकार का डेटा लौटाएगा। शायद यह कुछ इस तरह होगा:
   
   

   def haul(item: Haulable, *vargs: PackAnimal) -> Distance:
       ...

   
   हम एक बार फिर से दोहराते हैं: किसी भी उदाहरण के एनोटेशन का कोई मतलब नहीं है। वे केवल तृतीय-पक्ष पुस्तकालयों के संयोजन में वास्तविक अर्थ प्राप्त करते हैं।
   
3. पैरा 2 से निम्नानुसार, यह पीईपी निर्मित प्रकारों के लिए भी एनोटेशन के प्रसंस्करण के लिए किसी भी मानक तंत्र को पेश करने का प्रयास नहीं करता है। यह सारा काम तीसरे पक्ष के पुस्तकालयों को सौंपा गया है।

वाक्य - विन्यास

पैरामीटर

def foo (a: , b:  = 5):
    ...

def foo(*args: expression, **kwargs: expression):
    ...

def foo((x1, y1: expression),
        (x2: expression, y2: expression)=(None, None)):
    ...

मान लौटाएं

def sum() -> expression:
    ...

decorator: '@' dotted_name [ '(' [arglist] ')' ] NEWLINE
decorators: decorator+
funcdef: [decorators] 'def' NAME parameters ['->' test] ':' suite
parameters: '(' [typedargslist] ')'
typedargslist: ((tfpdef ['=' test] ',')*
                ('*' [tname] (',' tname ['=' test])* [',' '**' tname]
                 | '**' tname)
                | tfpdef ['=' test] (',' tfpdef ['=' test])* [','])
tname: NAME [':' test]
tfpdef: tname | '(' tfplist ')'
tfplist: tfpdef (',' tfpdef)* [',']

lambdas

1. यह पिछड़े संगतता का उल्लंघन होगा।
2. लम्बदा परिभाषा के अनुसार तटस्थ और अनाम हैं
3. लैम्ब्डा को हमेशा फ़ंक्शंस के रूप में फिर से लिखा जा सकता है

सुविधा एनोटेशन तक पहुंच प्राप्त करें

def foo (a: 'x', b: 5 + 6, c: list) -> max (2, 9):
    ...

{'a': 'x',
 'b': 11,
 'c': list,
 'return': 9}

बक्सों का इस्तेमाल करें

• प्रकार की जानकारी प्रदान करना
  • चेक टाइप करें
  • आईडीई टिप्स एक्सपेक्टेड एंड रिटर्नेड आर्गुमेंट टाइप्स पर
  • कार्य अधिभार / सामान्य कार्य [लगभग]। फ़ंक्शन ओवरलोडिंग अन्य भाषाओं में लोकप्रिय है और एक ही नाम के साथ कई कार्यों के अस्तित्व में हैं, लेकिन एक ही समय में, उनके द्वारा स्वीकार किए गए मापदंडों की संख्या भिन्न होती है]
  • विभिन्न प्रोग्रामिंग भाषाओं के बीच पुल
  • अनुकूलन
  • तर्क कार्यों को समर्पित करें
  • डेटाबेस क्वेरी मैप करना
  • आरपीसी पैरामीटर मार्शलिंग [लगभग। मार्शलिंग रैम में संग्रहीत सूचना को स्टोरेज या ट्रांसमिशन के लिए उपयुक्त प्रारूप में परिवर्तित करने की प्रक्रिया है। RPC - दूरस्थ प्रक्रिया कॉल]
• अन्य जानकारी प्रदान करना
  • दस्तावेज़ीकरण पैरामीटर और रिटर्न मान

मानक पुस्तकालय

Pydoc और मॉड्यूल का निरीक्षण किया

अन्य PEP से लिंक करें

फंक्शन सिग्नेचर ऑब्जेक्ट्स

कार्यान्वयन

अस्वीकृत प्रस्ताव

• BDFL [. ] , , : « »
• stdlib , , . .
• , , .
• आगे की चर्चा के बावजूद, एनोटेशन इंटरैक्शन के लिए तंत्र का मानकीकरण नहीं करने का निर्णय लिया गया। इस स्तर पर ऐसा समझौता समय से पहले होगा। हम एक वास्तविक स्थिति के आधार पर इन समझौतों को व्यवस्थित रूप से विकसित करने की अनुमति देना चाहते हैं, और हर किसी को कुछ वंचित योजना का उपयोग करने के लिए मजबूर करने की कोशिश नहीं करते हैं।