एक पायथन एपीआई डिज़ाइन करना: फ़्लुएंट इंटरफेस या तर्क

Question

मैं Protovis एपीआई के पाइथन के एक साधारण बंदरगाह के साथ खेल रहा हूं।

सरल बार चार्ट उदाहरण पर विचार करें, जावास्क्रिप्ट में:

var vis = new pv.Panel() 
    .width(150) 
    .height(150); 

vis.add(pv.Bar) 
    .data([1, 1.2, 1.7, 1.5, .7, .3]) 
    .width(20) 
    .height(function(d) d * 80) 
    .bottom(0) 
    .left(function() this.index * 25); 

vis.render(); 

मैं इस धाराप्रवाह इंटरफ़ेस शैली एपीआई का उपयोग या बजाय नामित पैरामीटर का उपयोग करने के लिए जारी करने के लिए है कि क्या बहस कर रहा हूँ। नामित पैरामीटर के साथ हम लिख सकते हैं:

vis = pv.Panel(width=150, 
       height=150) 

vis = vis + pv.Bar(data=[1, 1.2], 
        width=20, 
        height=lambda d: d * 80, 
        bottom=0, 
        left=lambda: self.index * 25) 
vis.render() 

क्या कोई पसंदीदा पायथन शैली है?

Answer 1

मेरा वोट एंटी-चेनिंग, प्रो-नाम-पैराम्स है।

1. डॉट चेन गरीब कोड-IntelliSense के लिए बनाता है के बाद से अनुभवजन्य प्रोटोटाइप सिर्फ एक खाली पैनल() या बार(), आप उस पर पाठ्यक्रम pydoc के कर सकते हैं, लेकिन इस समय और युग IntelliSense में में उपलब्ध है अधिकांश आईडीई और एक महान उत्पादकता बूस्टर।

2. चेनिंग प्रोग्राम को क्लासिक रूप से कक्षा को और अधिक कठिन कहता है। एक सूची या निर्देश में * args, ** kwargs के रूप में पास करने में सक्षम होने के लिए बहुत अच्छा है - जबकि चेनिंग के साथ संभवतः आपको क्लास को मेटा बनाने के लिए दोनों विधियों या बैकफ्लिप्स का एक समूह का समर्थन करना होगा।

3. चेनिंग कोड को पढ़ने में अधिक कठिन बनाता है क्योंकि अनिवार्य रूप से कोई भी इसे एक पंक्ति पर करेगा, और आश्चर्य की बात है कि जब वे एक ही परम में दो बार पारित होते हैं तो चीजें सभी गुम हो जाती हैं - आप इसे रोक सकते हैं नामित पैरा कन्स्ट्रक्टर डुप्ली फ़िल्टरिंग मूल रूप से निर्मित है।