Python 3.7

netrc - netrc फाइल प्रोसेसिंग




python

netrc - netrc फाइल प्रोसेसिंग

स्रोत कोड: Lib/netrc.py

netrc वर्ग पार्स करता है और Unix ftp प्रोग्राम और अन्य FTP क्लाइंट द्वारा उपयोग किए जाने वाले netrc फाइल फॉर्मेट को इनकैप्सुलेट करता है।

class netrc.netrc([file])

एक netrc उदाहरण या उपवर्ग उदाहरण एक netrc फ़ाइल से डेटा encapsulate। आरंभिक तर्क, यदि मौजूद है, तो फ़ाइल को पार्स करने के लिए निर्दिष्ट करता है। यदि कोई तर्क नहीं दिया जाता है, तो उपयोगकर्ता के घर निर्देशिका में फ़ाइल .netrc - जैसा कि os.path.expanduser() द्वारा निर्धारित किया जाएगा - पढ़ा जाएगा। अन्यथा, एक FileNotFoundError अपवाद उठाया जाएगा। पार्स त्रुटियां NetrcParseError को फ़ाइल नाम, लाइन नंबर, और टोकन को समाप्त करने सहित नैदानिक ​​जानकारी के साथ NetrcParseError । यदि कोई तर्क POSIX सिस्टम पर निर्दिष्ट नहीं है, तो .netrc फ़ाइल में पासवर्ड की उपस्थिति .netrc को NetrcParseError यदि फ़ाइल का स्वामित्व या अनुमतियाँ असुरक्षित हैं (प्रक्रिया चलाने वाले उपयोगकर्ता के अलावा किसी उपयोगकर्ता के स्वामित्व में है, या पढ़ने या लिखने के लिए सुलभ है किसी अन्य उपयोगकर्ता द्वारा)। यह ftp और उपयोग करने वाले अन्य प्रोग्राम्स के बराबर सुरक्षा व्यवहार को लागू करता है।

संस्करण ४.४ में परिवर्तित: पोसिक्स अनुमति जांच में जोड़ा गया।

संस्करण 3.7 में परिवर्तित: os.path.expanduser() .netrc फ़ाइल का स्थान खोजने के लिए उपयोग किया जाता है जब फ़ाइल को तर्क के रूप में पारित नहीं किया जाता है।

exception netrc.NetrcParseError

जब स्रोत पाठ में वाक्य-रचना संबंधी त्रुटियाँ netrc , तो netrc वर्ग द्वारा उठाया गया अपवाद। इस अपवाद के उदाहरण तीन दिलचस्प विशेषताएँ प्रदान करते हैं: msg त्रुटि का एक पाठ विवरण है, filename नाम स्रोत फ़ाइल का नाम है, और lineno उस लाइन नंबर को देता है जिस पर त्रुटि पाई गई थी।

netrc वस्तुओं

एक netrc उदाहरण के निम्नलिखित तरीके हैं:

netrc.authenticators(host)

होस्ट के लिए प्रमाणक का 3-टुपल (login, account, password) लौटाएं। यदि netrc फ़ाइल में दिए गए होस्ट के लिए कोई प्रविष्टि नहीं है, तो 'डिफ़ॉल्ट' प्रविष्टि के साथ जुड़े टपल लौटें। यदि न तो मिलान होस्ट और न ही डिफ़ॉल्ट प्रविष्टि उपलब्ध है, तो None वापस न करें।

netrc.__repr__()

Netrc फ़ाइल के प्रारूप में वर्ग डेटा को स्ट्रिंग के रूप में डंप करें। (यह टिप्पणियों को त्याग देता है और प्रविष्टियों को पुनः व्यवस्थित कर सकता है।)

netrc उदाहरणों में सार्वजनिक उदाहरण चर हैं:

netrc.hosts

शब्दकोश मानचित्रण नाम (login, account, password) tuples करने के लिए। 'डिफ़ॉल्ट' प्रविष्टि, यदि कोई हो, को उस नाम से एक छद्म मेजबान के रूप में दर्शाया गया है।

netrc.macros

शब्दकोश स्ट्रिंग स्ट्रिंग सूचियों के लिए मैक्रो नाम मैपिंग।

ध्यान दें

पासवर्ड ASCII वर्ण सेट के सबसेट तक सीमित हैं। सभी ASCII विराम चिह्नों को पासवर्ड में अनुमति दी जाती है, हालांकि, ध्यान दें कि व्हाट्सएप और गैर-मुद्रण योग्य वर्णों को पासवर्ड में अनुमति नहीं है। यह .netrc फ़ाइल को पार्स करने के तरीके की एक सीमा है और भविष्य में इसे हटाया जा सकता है।