Designing an Python API: Fluent interface or arguments -

-

i'm playing around simple port of protovis api python.

consider simple bar chart example, in javascript:

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();

i'm debating whether continue use fluent interface style api or use named parameters instead. named parameters write:

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()

is there preferred python style?

my vote anti-chaining, pro-named-params.

  1. dot-chaining makes poor code-intellisense since empirical prototype empty panel() or bar(), can of course pydoc on it, in day , age intellisense available in ides , great productivity booster.

  2. chaining makes programatically calling class more difficult. it's nice able pass in list or dict *args, **kwargs -- while possible chaining you'd have support both methods or bunch of backflips meta-create class.

  3. chaining makes code more difficult read because inevitably on 1 line, , wonder why things goofed when they've passed in same param twice -- can prevent named param constructor dup filtering built in.


Comments

Post a Comment

Popular posts from this blog

ASP.NET/SQL find the element ID and update database -

-
basically i've got update query runs when click submit button. i have asp:repeater in page layer inside this <asp:repeater id="dgbookings" runat="server" onitemdatabound="itemdb"> <itemtemplate> <div class="bookingscontent"> <div class="bookingdetails" id="<%# databinder.eval(container.dataitem, "booking_ref") %>"> <p class="infotext"><%# databinder.eval(container.dataitem, "adults") %> <asp:linkbutton onclick="editdetails" text="edit..." runat="server"></asp:linkbutton></p> <p class="infotext"><asp:linkbutton onclick="submitdetails" text="submit..." runat="server"></asp:linkbutton></p> </div> </div> </itemtemplate> <asp:repeater> and outputs ...
Read more

jquery - appear modal windows bottom -

-
i have modal windows in application, work fine <div id="modal" class="modal hide fade" tabindex="-1" role="dialog" aria-labelledby="mymodallabel" aria-hidden="true"> but when modal appears, appear top of windows, , want appear bottom the application joomla 3.0! , using template of meet gavern any idea? i found solution i modified de css in bootstrap .modal.fade { top:-25%; -webkit-transition:opacity .3s linear, bottom .3s ease-out; -moz-transition:opacity .3s linear, bottom .3s ease-out; -ms-transition:opacity .3s linear, bottom .3s ease-out; -o-transition:opacity .3s linear, bottom .3s ease-out; transition:opacity .3s linear, bottom .3s ease-out; }
Read more

c++ - Compiling static TagLib 1.6.3 libraries for Windows -

-
i having super hard time compiling , using taglib 1.6.3 in qt project. i've tried can think of. taglib claims supported through cmake i'm not having luck. furthermore, i'm confused kinds of files need qt libs! i've built *.a files, *.lib, , *.dll. understand far... believe since i'm working in windows *.lib want. no matter do, end "undefined references" taglib functions try use when try compile qt project. have tried mingw32, msys, visual studio 2008, , cross-compiling windows on linux. turning nothing. what makes less sense me if compile same taglib source qt on mac (g++ think?) works fine! somewhere in windows compilation procedures have going wrong. have been smacking face on desk 30 (on , off) hours trying figure out. since qt uses mingw must compile taglib same compiler? if compile *.lib's visual studio not compatible? are *.a libraries usable in windows? (assuming mingw) i'm still trying handle on c++ stuff, after reading coun...
Read more