एक पायथन डॉकस्ट्रिंग को शाब्दिक स्ट्रिंग के रूप में दिया जाना चाहिए; लेकिन कभी-कभी कई कार्यों (जैसे, विभिन्न रचनाकार) के लिए समान डॉकस्ट्रिंग होना उपयोगी होता है, या कई एक्सेस विधियां तर्कों की एक ही सूची को स्वीकार कर सकती हैं (और फिर उसी छिपी विधि पर भरोसा करती हैं), इसलिए का उपयोग करना अच्छा होगा हर जगह विवरण। ऐसे मामलों के लिए मैं __doc__ को असाइन करके एक डॉकस्ट्रिंग का निर्माण कर सकता हूं, जो कि मैं एक साधारण सजावटी के माध्यम से करता हूं। यह प्रणाली बहुत अच्छी तरह से काम करती है (पायथन 2 में), और मुझे खुशी है कि यह कितना सरल, स्पष्ट और अच्छी तरह से encapsulated है।एक सजावट के साथ एक अजगर docstring संशोधित: क्या यह एक अच्छा विचार है?
प्रश्न: क्या यह एक अच्छा विचार है? विशेष रूप से, ऐसे उपकरण हैं जो इस सेट-अप द्वारा भ्रमित किए जाएंगे (उदाहरण के लिए, कुछ भी जो बाइटकोड के बजाय स्रोत से डॉकस्ट्रिंग निकालता है)। क्या समाधान अभी भी अजगर 3 में काम करने जा रहा है? क्या ऐसे अन्य कारण या परिस्थितियां हैं जो इस अव्यवस्थित को बनाती हैं?
"विभिन्न रचनाकार"? मुझे लगता है कि आप किसी प्रकार का कारखाना कार्य करते हैं, क्योंकि आपके पास केवल एक '__init__' हो सकता है। –
मुझे नहीं लगता कि "फैक्ट्री फ़ंक्शन" सही है। मैं एक वर्ग के स्थिर सदस्यों का जिक्र कर रहा था, जो एक ही कक्षा का उदाहरण बनाते थे। वे सभी एक भाषा में बहुलक रचनाकार होंगे जो सीधे इसका समर्थन करते हैं। लेकिन हां, फैक्ट्री फ़ंक्शन एक और उपयोग केस हो सकता है। – alexis
मैं उनको एक तरह का कारखाना मानूंगा, हाँ। नेमस्पेसिंग के अलावा स्थिर सदस्य कार्यों और मुफ्त कार्यों (सी ++ शब्दावली का उपयोग करने के लिए) में वास्तव में कोई अंतर नहीं है। हालांकि पायथन में अलग "वर्ग विधि" और "स्थैतिक विधि" अवधारणाएं हैं। –