;ò ÎÑAHc@sdZdklZdklZlZdkl Z ye Wndk l Z nXda e e eiƒƒƒe e eƒƒƒZd„Zt d„ZedjoÖeeƒZeiƒd eifd „ƒYZd efd „ƒYZeƒZeƒZee_eƒZeƒiZd kZde_ eidƒgjpt ‚eidƒZ!e!ddgjpt ‚dGHnd S(snTraits-aware tab completion. This module provides a custom tab-completer that intelligently hides the names that the enthought.traits library (http://code.enthought.com/traits) automatically adds to all objects that inherit from its base HasTraits class. Activation ========== To use this, put in your ~/.ipython/ipy_user_conf.py file: from ipy_traits_completer import activate activate([complete_threshold]) The optional complete_threshold argument is the minimal length of text you need to type for tab-completion to list names that are automatically generated by traits. The default value is 3. Note that at runtime, you can change this value simply by doing: import ipy_traits_completer ipy_traits_completer.COMPLETE_THRESHOLD = 4 Usage ===== The system works as follows. If t is an empty object that HasTraits, then (assuming the threshold is at the default value of 3): In [7]: t.ed doesn't show anything at all, but: In [7]: t.edi t.edit_traits t.editable_traits shows these two names that come from traits. This allows you to complete on the traits-specific names by typing at least 3 letters from them (or whatever you set your threshold to), but to otherwise not see them in normal completion. Notes ===== - This requires Python 2.4 to work (I use sets). I don't think anyone is using traits with 2.3 anyway, so that's OK. (sapi(sTryNextsget(sdir2(sSetic Csá|iidƒ}di|d ƒ} |i| ƒ}|d o t ‚n|d} t | t i ƒ o t ‚nt| ƒ}|d}|o?gi} |D]$} | i|ƒo| | ƒqq~ }ntƒii}|djo@gi} |D]%} | idƒ o| | ƒqøqø~ }nN|djo@gi} |D]%} | idƒ o| | ƒqEqE~ }nt|ƒtjott|ƒtƒ}n| d}gi} |D]} | || ƒq¼~ }|Sd S( sÐA custom IPython tab-completer that is traits-aware. It tries to hide the internal traits attributes, and reveal them only when it can reasonably guess that the user really is after one of them. s.iÿÿÿÿsfoundsobjis__is_N( seventssymbolssplits symbol_partssjoinsbasesselfs_ofindsoinfosTryNextsobjs isinstancesTs HasTraitssdir2sattrss attr_startsappends_[1]sas startswithsipgetsoptionssreadline_omit__namess omit__namesslensCOMPLETE_THRESHOLDslistssets TRAIT_NAMESsbdotstcomp( sselfseventsoinfosattrss attr_startstcomps symbol_partss omit__namessbdotsbasesasobjs_[1]((sX/u/d/b/dbachman/=/lib/python2.3/site-packages/IPython/Extensions/ipy_traits_completer.pystrait_completerNs.      ? @ @ +cCsat|tƒo |dj od|}t|ƒ‚n|atƒ}|idt ddƒdS(sÈActivate the Traits completer. :Keywords: complete_threshold : int The minimum number of letters that a user must type in order to activate completion of traits-private names.is5complete_threshold must be a positive integer, not %rscomplete_commandsre_keys.*N( s isinstancescomplete_thresholdsintses ValueErrorsCOMPLETE_THRESHOLDsipgetsipsset_hookstrait_completer(scomplete_thresholdsesip((sX/u/d/b/dbachman/=/lib/python2.3/site-packages/IPython/Extensions/ipy_traits_completer.pysactivate~s  s__main__sTCleancBstZRS(N(s__name__s __module__(((sX/u/d/b/dbachman/=/lib/python2.3/site-packages/IPython/Extensions/ipy_traits_completer.pysTCleanžssBunchcBstZRS(N(s__name__s __module__(((sX/u/d/b/dbachman/=/lib/python2.3/site-packages/IPython/Extensions/ipy_traits_completer.pysBunchŸsNst.edst.edis t.edit_traitsst.editable_traitssTests OK("s__doc__senthought.traitssapisTs IPython.ipapisTryNextsgetsipgetsIPython.genutilssdir2ssetssetssSetsCOMPLETE_THRESHOLDs HasTraitssobjects TRAIT_NAMESstrait_completersactivates__name__slistsTNLssortsTCleansBunchstsfsosIPsipsipy_traits_completerscompletesAssertionErrorsta(sipsdir2sBunchssetsfsTCleansipy_traits_completersoststas TRAIT_NAMESstrait_completersipgetsTsTNLsTryNextsactivate((sX/u/d/b/dbachman/=/lib/python2.3/site-packages/IPython/Extensions/ipy_traits_completer.pys?0s6   + 0