Slashdot Mirror


WxPython in Action

aceydacey writes ""WxPython in Action" is a new and definitive guide to the popular wxPython GUI framework. WxPython has been growing in popularity by leaps and bounds in recent years but has been hampered by a comparative lack of good, comprehensive documentation, so much so that many people have turned to studying the documentation for the underlying wxWidgets framework, that is written in C++. "WxPython in Action" fills the void by combining a good introduction to the framework with a comprehensive and accessible reference document. At 552 pages, Manning Publications has produced a definitive book." Read the rest of Ron's review. WxPython in Action author Robin Dunn and Noel Rappin pages 552 publisher Manning rating 10 reviewer Ron Stephens ISBN 1-932394-62-1 summary An introduction to the WxPython GUI Framework

WxPython is one of the best cross-platform GUI toolkits for the open source Python programming language. It excels in matching the native look and feel of programs on Windows, Linux, and Mac OS X. It is a mature project, being a well-developed wrapper of the underlying wxWidgets C++ toolkit. Another reason for its growing popularity is its very extensive number of widgets, making it a capable and modern tool for making professional-looking GUIs for applications in almost any field of endeavor. It has endured a reputation for having a steep learning curve, and for sometimes being difficult to install and easy to break during upgrades; both of which downsides should be lessened by the publishing of this book.

Written by Robin Dunn, the creator and moving force behind wxPython, and ably assisted by Noel Rappin, this book is definitive, authoritative and well-written. Part 1 fills the role of a good introduction to the toolkit, and Parts 2 and 3 are a thorough reference to the widgets, behavior and usage of the framework.

in Part 1, we learn the inside story behind the beginnings and the history of wxPython's development. We are walked through the creation of simple examples of the core functionality of the framework illustrating how to create and use the basic controls and event loops. Then, we get a more detailed explanation of the wxPython event loop, an introduction to PyCrust (a useful tool for wxPython programmers, essentially an interactive interpreter session, wrapped as a wx widget) a whole chapter on the Model-View-Controller paradigm, and a discourse on good factoring techniques for GUI programs. This is rather general programming knowledge, not necessarily specific to wxPython, and truly expert programmers will probably skip much of this material, but for many, like me, it is very useful, and for many others, it will be a good review of previously known material. The writing style is excellent but one weakness is that the authors return again and again to wxPython evangelism and boosterism, which is regrettable; but this is the only section of the book to suffer from this flaw.

Part 2 gives detailed coverage of each widget, control, frame, dialog, and menu in the toolkit, and this is the meat of the book and will be used and reused as core reference material by many a programmer. This is good stuff, thorough, well researched, and definitive. Next, the authors give an equally good explanation of how to use sizers and grids to layout and control your GUI application. Part 2 fills the previously missing gap in core wxPython documentation and, to folks who need it, is worth its weight in gold.

Part 3, called Advanced wxPython, gives welcome coverage to advanced layout and control issues. This subject of advanced layout is, in my opinion, where the rubber really hits the road in GUI design, and it is appropriate that this is where the authors spend the most time and effort, and with good result. The final chapter breaks new ground by walking the reader through the creation of a multithreaded wxPython application. This is great stuff, and the advanced readers will be left pining for even more on this timely topic of such growing importance. Fortunately, the authors are available online to communicate with users who truly master the material in the book and want to to pursue more advanced usage.

The book is at its best in documenting the core API for expert programmers who are new to wxPython. It is also a good introduction to wxPython for advanced programmers. For moderately experienced programmers, the book is excellent but will be a tough read; probably not to be mastered in a straight read thorough, the book will adequately reward this kind of reader who is dedicated and persistent. For novice programmers, especially those who have little to no previous experience in GUI programming, I believe the book may be beyond their grasp.

So, if you are a serious programmer who wants or needs to use the wxPython GUI toolkit, "wxPython in Action" is a must-have reference book. It is perfect for this kind of reader and will become a well-worn book that will be useful for at least the next five years. It is unlikely that any other book about wxPython will be published that could do a better job, given the authors' unparalleled understanding of the toolkit and the obvious patience, time and care they took in researching, writing, and editing this book. It is not a casual read, but to a serious student of the subject, that is a positive statement. The book is strong meat, a weighty and substantive technical tome.

The book really shines in the many pages devoted to User Interface design and implementation. This is where many programmers need help, and it is gratifying that this book goes into the most detail on this subject. This is very detailed coverage and one is left with a satisfaction that, while not easy reading, it is well worth while. I feel this is the book's strongest point.

I know that it sometimes seems there has been an inflation in the scoring of books, with reviewers giving so many high ratings that one wonders how meaningful those ratings are. This book is not for everybody, and it is not a work of great literature, but given the obvious need for such a work, and the careful and accurate fulfillment of this need by these authors, I feel justified in giving it a rating of ten stars. For the people who really need this book, it is about as good as it could get, and will be a most welcome addition to their technical library.

More material for those learning and using Python can found at my web site Python Learning Resources.

You can purchase WxPython in Action from bn.com. Slashdot welcomes readers' book reviews -- to see your own review here, read the book review guidelines, then visit the submission page.

26 of 77 comments (clear)

  1. About time by cagle_.25 · · Score: 2, Funny
    For those of us stuck using Tkinter because time did not permit digging through the wxPython docs, this will be a welcome addition.

    Good review, BTW.

    --
    Human being (n.): A genetically human, genetically distinct, functioning organism.
    1. Re:About time by CRCulver · · Score: 3, Informative

      If you don't want to use Tkinter and hate the obtuseness of WxPython, there's always PyGTK.

    2. Re:About time by WoLpH · · Score: 4, Informative

      Another (imho pretty good) alternative, PyQT.

      Using the QT widgets it's cross platform (Linux, BSD, Windows, others?) and pretty fast :)

    3. Re:About time by LaissezFaire · · Score: 2, Interesting

      Unfortunately PyGTK is slow and buggy (crashes) on Windows, as the good folks over at http://www.gajim.org/ have discovered. It makes it less useful cross platform, though on linux it runs well.

  2. On a related subject... by RyanFenton · · Score: 2, Interesting

    I've been planning an opengl project with a GUI in it for image editing, using Python for scripting. Would it be possible/plausible to render from from a GUI toolkit like wxPython into a texture to load into opengl, so that the window could be part of a world, rather than enclosing an OpenGL widget into a wxWidgets/wxPython framework?

    Ryan Fenton

    1. Re:On a related subject... by Anonymous Coward · · Score: 5, Informative

      Not really. Nearly all GUI toolkits allow putting the widgets outside of the GL Canvas, but what you speak of would involve mucking with way too much evil. Essentially you can get the bitmap for any active window in WX, but mapping the event models back and forth would require some extreme skill -- and quite a performance hit. You'd have to manipulate the wx API programatically and do all the mapping translations yourself.

      That being said, wxPython rocks. I wrote wxPython code for a living for about a year and came away with a great respect for it. Printers and the like ... they all work. I didn't bother with the socket/thread stuff since Python can do that, but in all it's pretty nice. Layout was a bit annoying, but not nearly as bad as Swing. My advice... write all your code programatically using sizers and don't use the glade-like editor at all.

    2. Re:On a related subject... by Profane+MuthaFucka · · Score: 5, Interesting

      Not my experience. I found wxWidgets in general to be full of bugs, to the point where the display errors I was getting were making it impossible to use. For example:

      1) fill a tree widget with a few thousand items. You've got lines going everywhere.
      2) The latest library upgrade screwed with the layouts so that what formerly used to fill the entire window now filled only the upper left corner.
      3) The date widget screws up every time there's a daylight-savings change. If the change happens on April 1st, the date selection widget will display March 30. On April 2nd, it's working again.

      That's just three, but I've seen many more. By comparison, I'm very experinced with Swing, QT, MSFC, and Tk, and none of those displayed the kinds of problems that I saw with wxWidgets.

      And when I say wxWidgets, I mean the library in general. I've programmed all of the above GUI libs mentioned in multiple languages, and wxWidgets behaved with similar bugginess in wxPython too.

      The wxPython API definitely does rock, but there's a lot of bugs. I tried to dig through the code to see what was going on, and I found that to be a huge mess too. I've been through the Qt code, and it's pretty well organized and definitely well written. wxWidgets appeared to be due for a refactoring and cleanup to make it easier to work on.

      --
      Fascism trolls keeping me up every night. When I starts a preachin', he HITS ME WITH HIS REICH!
  3. The book talks about ... by rabalde · · Score: 4, Informative

    ... wxPython, "a blending of the wxWidgets C++ class library with the Python programming language". Please, do not forget to put links on the articles, because the /. effect need'em.

  4. Wax is also helpful to wxPython programmers by Ursus+Maximus · · Score: 5, Informative

    Wax is a user-friendly layer on top of wxPython. It allows for easier GUI programming in a more "Pythonic" way. It runs on all platforms that support wxPython. It can be found aand downloaded at http://sourceforge.net/projects/waxgui

    1. Re:Wax is also helpful to wxPython programmers by Abcd1234 · · Score: 4, Funny

      So... it's an abstraction layer over a wrapper of an abstraction layer to an underlying GUI toolkit? Awesome... :)

  5. Plug-ins by truthsearch · · Score: 2, Informative

    The one place where using the python wrapper for wxWidgets can really pay off is user scripting or plug-ins. If your app's written in python it's quite easy to allow users to write plug-ins to your app in python. Otherwise you'd have to connect your C++ app to the python interpreter to give the same ability.

    I used wxPython for a while because I think it's a great alternative to VB. Coming from the VB world it was a big step up with a small learning curve. It's a good way for Windows desktop developers to get into Linux desktop development.

  6. Re:Another Alphabet Soup... by Duhavid · · Score: 2, Insightful

    Ignore it mostly, until it becomes relevant to you.

    --
    emt 377 emt 4
  7. Re:Python wrappers by Senzei · · Score: 2, Insightful
    That could be said about any of the 100's of shity half-finished Python wrappers that clog my Gentoo system. What a scourge. To anyone who thinks it would be nice to wrapper C/C++ library , don't do it! I would advise anyone who wants to use wXWidgets to do so in C++. The event abstraction is a lot nicer that Qt and the library is just as portable.
    I guess I am really not following here, but how else are you supposed to handle widgets in python without some kind of wrapper over C/C++? Wouldn't doing all of it yourself be a lot more work for much less benefit than wrapping up an existing library?
    --
    Slashdot: Where anecdotes and generalizations can be freely substituted for facts, logic, or intelligence
  8. Nice, but... by Angst+Badger · · Score: 2, Insightful

    ...it sure would be great if someone would do this for the other wx language bindings. For something as complex as a widget library, lacking comprehensive documentation renders it all but useless to anyone but folks with lots of time on their hands.

    --
    Proud member of the Weirdo-American community.
    1. Re:Nice, but... by paulli · · Score: 2, Informative

      http://users.skynet.be/saw/wxJS/ for javascript.

      This assumes you are using javascript as a programming language and not hacking out a web page.

  9. Nice introduction, but still incomplete by bigqueso · · Score: 2, Insightful

    I got this book a few months ago with the hope that it would be a nice introduction and reference. I bought it from the publisher, because I could also get a PDF version. That has been really nice since it makes it easier to look for examples.

    The book was a nice introduction to someone who isn't familiar with wxWidgets or wxPython and it reads well. Despite this, I found the book to be lacking as a good reference book. The index is kind of sparse, and I found myself turning more and more to the wxWidgets and wxPython web sites and demo.py as a reference for specific widgets. I don't plan on taking my copy back, but I instead use it as just one more avenue for information.

  10. And PyGlade by malverian · · Score: 2, Informative

    Combining PyGtk and PyGlade is one of the most amazing user interface programming experiences I've ever had. That is to say, it's not completely unbearable. My favorite feature by far is that if you have a class (let's call it "InterfaceSignals"), you can call signal_autoconnect(InterfaceSignals) to automagically connect every method in that class to the respective signals defined in your Glade file, due to Pythons wonderfully introspective nature.

    Also, unlike wxPython, pyGtk actually has very nice documentation. For reference, here's the signal_autoconnect method I mentioned:
    http://www.pygtk.org/pygtk2reference/class-gladexm l.html#method-gladexml--signal-autoconnect

    --
    You're just mad because the voices in your head talk to me.
  11. Someday OSS developers will learn by MikeRT · · Score: 2, Insightful

    Most other programmers don't want to have to hunt down and really play around with parts of a toolkit to understand it and use it well. For most people, WxPython would probably be a hobby GUI toolkit. Who wants to spend more time learning the API than making cool little apps or making a serious one with it? Very few.

    Yes, yes, I know they are doing this in their spare time too. I'm not complaining. I'm just saying that when people can choose between well-documented free toolkits from big companies or poorly documented open source ones, the former will usually win.

    1. Re:Someday OSS developers will learn by pnot · · Score: 2, Informative

      Please provide a link to the well-documented free toolkit from a big company that runs on Linux.

      Qt from Trolltech is Free, extremely well-documented, and runs on Linux and several Unix flavours as well as Mac OS X and Windows.

    2. Re:Someday OSS developers will learn by Duke · · Score: 2, Informative
  12. Re:check out PythonCard by Ursus+Maximus · · Score: 2

    I just want to say that I agree about PythonCard. It is very easy to use and it rivals VB or Delphi in making it easy to draw a simple GUI front end for data entry and such, and yet it is a simple tool with almost no learning curve. I don't know if it would work for every imaginable application, but for most applications it is a real joy to use. PythonCard can be found at http://pythoncard.sourceforge.net/

  13. wxWidgets linux does NOT use Qt... by Mitchell+Mebane · · Score: 3, Informative

    wxWidgets linux does NOT use Qt, it uses GTK. As I understand it, wxWidgets is LGPL and Qt is GPL, and writing a Qt backend would force it to be GPL. :/

    --

    The roots of education are bitter, but the fruit is sweet.
    --Aristotle
    1. Re:wxWidgets linux does NOT use Qt... by AWhiteFlame · · Score: 3, Informative

      wxWidgets is not LGPL. wxWidgets is under the wxWindows (the project was renamed but apparently this wasn't) license.

      --
      "Everything worth innovating today will go to court tomorrow."
  14. Re:Perl by gregarican · · Score: 3, Funny

    Strange. Your comment is short and rather terse, but I can nevertheless read it and comprehend it easily. Are you SURE you like Perl?

  15. Re:Wx does NOT excel in matching OS X by kollivier · · Score: 2, Insightful

    Have you run the wxPython demo? Or are a couple random screenshots enough to get you to "strongly disagree" about something? There are still a couple controls that need work on the Mac port, but a vast majority of its controls are 100% native and match native behavior as closely as possible. (In the cases that the OS doesn't just 'give it to us' for free.)

    wx, however, is like any other toolkit. It doesn't force you to adhere to HIGs, and unfortunately many Mac ports are from Win/Linux apps, and focus their resources on those ports because, sadly, that's where the users/customers are. A number of wx apps don't even support Mac, not because they can't, but because they simply don't have (enough) users that are interested in the Mac port. As Mac customers and support becomes more important, so too will the number of applications that optimize for Mac, and let me tell you, those that used wx will find they can probably polish their GUI in a matter of days.

    And in fact, we're working on cutting the work needed for HIG-compliance on all platforms too. At the wxPython level, we're working on additions to wx controls that are automatically HIG-compliant for Win, OS X and GNOME/GTK. So long as you use this library, your controls will space themselves according to the HIGs. If you're really interested in cross-platform development, I'd strongly encourage you to look at what's out there and then determine if wx is really such a bad choice for getting native Mac LNF.

  16. The book is great for beginners by MrBlic · · Score: 2, Informative

    Having used wxPython for just a few small projects, and currently one very large one, I found that the book was appropriate for someone who was just getting started. WxWidgets and wxPython can do much more than this book would suggest.

    I keep it on my bookshelf next to the wxWidgets book and end up reaching for the wxWidgets book more often, even though I'm using wxPython.

    I agree with the other poster who suggests that people code GUIs with sizers instead of using the XRC resources, although if you have multiple people on a project, and one or two want to change just the GUI, then the XRC, along with Dialog Blocks would be a perfect combination. The trick to making the gui stuff quick even though it's in code is to configure your favorite text editor with snippets or aliases or whatever it calls them to have lots of fill-in the blanks templates for things like a staticText / Edit box row in a dialog. I have a good collection of VisualSlickedit aliases I'd be happy to send to anyone who e-mails me at: jim at maplesong dot com.

    wxPython is easy to debug too. I'm coding my application partially in C++ wxWidgets, and driving the complex gui parts in wxPython. I have my wxPython extension dll in a visual studio project, and I point the "when debugging run:" to python itself, with an argument that points to my script. I can set breakpoints in my C++ code, and they are hit when I get to the right place in the wxPython gui. I can simutaneously use Wing IDE from Wingware to debug the python code. The trick is the python actually initiates the conversation with the debugger through sockets... the debugger just has to be in 'passive mode' to accept the connection.

    Unlike the other posters, I have not run into anything buggy. Everything has been solid, and has made sense, and for the most part worked the first time every time, even mostly on OSX. (I start off on Windows.) The only troule I've had on Linux/GTK is controlling the font size in the HTML windows. (wxWidgets has a simple but fantastically useful lightweight HTML layout widget!)

    I'm really hoping that Google comes around to putting some support into wxWidgets & wxPython. It already has great support from Mitch Kaypor and the OSAF, and AOL has used it for their communicator, and lots and lots of small shops have used it successfully, as well as several open source projects... Ok, it's doing fine.

    -Jim

    --
    Celebrate Excellence!