ŕZc@sddlZddlZddlZddlZddlZddlmZddlmZddlm Z ddlm Z ddlm Z ddlm Z ddlm Z dd lmZdd lmZdd lmZdd lmZddd edZdZdd dZdd eedZdd dZdZdZdefdYZeZ defdYZ!dddZ"dZ#dZ$defdYZ%defdYZ&d efd!YZ'd"e fd#YZ(d$efd%YZ)dS(&iN(tbuiltins(t exceptions(tlibutils(tpynames(t pynamesdef(t pyobjects(t pyobjectsdef(tpyscopes(tworder(t fixsyntax(t functionutilsic CsP|dk r%tjdtddnt|||d|d|d|}|S(soReturn python code completions as a list of `CodeAssistProposal`\s `resource` is a `rope.base.resources.Resource` object. If provided, relative imports are handled. `maxfixes` is the maximum number of errors to fix if the code has errors in it. If `later_locals` is `False` names defined in this scope and after this line is ignored. s'Codeassist no longer supports templatest stacklevelitresourcetmaxfixest later_localsN(tNonetwarningstwarntDeprecationWarningt_PythonCodeAssist(tprojectt source_codetoffsetR t templatesR Rtassist((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyt code_assists  cCs.tj|t}|j|\}}}|S(sNReturn the offset in which the completion should be inserted Usually code assist proposals should be inserted like:: completion = proposal.name result = (source_code[:starting_offset] + completion + source_code[offset:]) Where starting_offset is the offset returned by this function. (RtWordertTruetget_splitted_primary_before(RRt word_findert expressiontstartingtstarting_offset((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyR +s cCsStj||||}|j|}|dkr7dS|j}tj|S(s Get the pydocN(R t FixSyntaxt pyname_atRt get_objecttPyDocExtractortget_doc(RRRR R tfixertpynametpyobject((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyR%=s   c CsYtj||||}|j|}|dkr7dS|j} tj| ||S(syGet the calltip of a function The format of the returned string is ``module_name.holding_scope_names.function_name(arguments)``. For classes `__init__()` and for normal objects `__call__()` function is used. Note that the offset is on the function itself *not* after the its open parenthesis. (Actually it used to be the other way but it was easily confused when string literals were involved. So I decided it is better for it not to try to be too clever when it cannot be clever enough). You can use a simple search like:: offset = source_code.rindex('(', 0, offset) - 1 to handle simple situations. If `ignore_unknown` is `True`, `None` is returned for functions without source-code like builtins and extensions. If `remove_self` is `True`, the first parameter whose name is self will be removed for methods. N(R R!R"RR#R$t get_calltip( RRRR R tignore_unknownt remove_selfR&R'R(((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyR)Gs   c Csntj||||}|j|}|dk rj|j\}}|dk rj|jj|fSndS(sSReturn the definition location of the python name at `offset` Return a (`rope.base.resources.Resource`, lineno) tuple. If no `resource` is given and the definition is inside the same module, the first element of the returned tuple would be `None`. If the location cannot be determined ``(None, None)`` is returned. N(NN(R R!R"Rtget_definition_locationt get_modulet get_resource( RRRR R R&R'tmoduletlineno((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyR,hs   cOs8ddl}tjdtdd|jjj||S(Nis4Use `rope.contrib.findit.find_occurrences()` insteadR i(trope.contrib.finditRRRtcontribtfindittfind_occurrences(targstkwdstrope((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyR4{s   c Cse|j|}tjjj||}|j\}}|sCdS|jj|}g}t |t j rt j |j|dfg}n6t |t jrt j |j|dfg}nxn|jr:t |tjrd} n!t |tjr d} nd} |j|jj| f|j}qW|j|jjdf|j|S(sGet the canonical path to an object. Given the offset of the object, this returns a list of (name, name_type) tuples representing the canonical path to the object. For example, the 'x' in the following code: class Foo(object): def bar(self): class Qux(object): def mux(self, x): pass we will return: [('Foo', 'CLASS'), ('bar', 'FUNCTION'), ('Qux', 'CLASS'), ('mux', 'FUNCTION'), ('x', 'PARAMETER')] `resource` is a `rope.base.resources.Resource` object. `offset` is the offset of the pyname you want the path to. t PARAMETERtVARIABLEtFUNCTIONtCLASStMODULEN(t get_pymoduleR7tbasetevaluatet eval_locationR,Rt get_scopetget_inner_scope_for_linet isinstanceRt ParameterNameRt get_name_atR.t AssignedNametparentRt FunctionScopet ClassScopetappendR(tget_namet real_pathtreverse( RR RtpymodR'tdefmodR0tscopetnamest scope_type((s6lib/python2.7/site-packages/rope/contrib/codeassist.pytget_canonical_paths0     tCompletionProposalcBskeZdZd dZdZdZedZedZ dZ dZ edZ RS( sA completion proposal The `scope` instance variable shows where proposed name came from and can be 'global', 'local', 'builtin', 'attribute', 'keyword', 'imported', 'parameter_keyword'. The `type` instance variable shows the approximate type of the proposed object and can be 'instance', 'class', 'function', 'module', and `None`. All possible relations between proposal's `scope` and `type` are shown in the table below (different scopes in rows and types in columns): | instance | class | function | module | None local | + | + | + | + | global | + | + | + | + | builtin | + | + | + | | attribute | + | + | + | + | imported | + | + | + | + | keyword | | | | | + parameter_keyword | | | | | + cCs(||_||_|j||_dS(N(tnameR't _get_scopeRP(tselfRURPR'((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyt__init__s  cCsd|j|j|jfS(Ns %s (%s, %s)(RURPttype(RW((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyt__str__scCs t|S(N(tstr(RW((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyt__repr__scCsk|j}t|tjr*|j}nt|tjrg|j}t|tjrg|j SndS(stThe names of the parameters the function takes. Returns None if this completion is not a function. N( R'RCRt ImportedNamet_get_imported_pynamet DefinedNameR#RtAbstractFunctiontget_param_names(RWR'R(((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyt parameterss  cCs|j}t|tjr~|j}t|tjr=dSt|tjrSdSt|tjswt|tjrdSnut|tj rdSt|tj st|tj r|j}t|t j rdSt|t jrdSndS(NtfunctiontclasstinstanceR/(R'RCRt BuiltinNameR#tBuiltinFunctiont BuiltinClasst BuiltinObjectRtImportedModuleR]R_RR`t AbstractClass(RWR'R(((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRYs(   cCsKt|jtjrdSt|jtjsCt|jtjrGdS|S(Ntbuiltintimported(RCR'RRfRRjR](RWRP((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRVs cCsB|js dS|jj}t|ds/dS|jjjS(sYGet the proposed object's docstring. Returns None if it can not be get. R%N(R'RR#thasattrR%(RWR(((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyR% s  cCstjd|jS(NsAthe proposal's `kind` property is deprecated, use `scope` instead(RRRP(RW((s6lib/python2.7/site-packages/rope/contrib/codeassist.pytkinds N( t__name__t __module__t__doc__RRXRZR\tpropertyRbRYRVR%Ro(((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRTs     tNamedParamProposalcBs eZdZdZdZRS(sA parameter keyword completion proposal Holds reference to ``_function`` -- the function which parameter ``name`` belongs to. This allows to determine default value for this parameter. cCs9||_d|}tt|j|d||_dS(Ns%s=tparameter_keyword(targnametsuperRtRXt _function(RWRURc((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRX+s  cCsFtjj|j}x*|jD]\}}|j|kr|SqWdS(sGet a string representation of a param's default value. Returns None if there is no default value for this param. N(R tDefinitionInfotreadRxtargs_with_defaultsRvR(RWtdefinfotargtdefault((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyt get_default1s (RpRqRrRXR(((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRt$s cCst|||}|jS(sSort a list of proposals Return a sorted list of the given `CodeAssistProposal`\s. `scopepref` can be a list of proposal scopes. Defaults to ``['parameter_keyword', 'local', 'global', 'imported', 'attribute', 'builtin', 'keyword']``. `typepref` can be a list of proposal types. Defaults to ``['class', 'function', 'instance', 'module', None]``. (`None` stands for completions with no type like keywords.) (t_ProposalSortertget_sorted_proposal_list(t proposalst scopeprefttypepreftsorter((s6lib/python2.7/site-packages/rope/contrib/codeassist.pytsorted_proposals=s cCs@tj|t}|j|\}}}|r<|d|S|S(s!Return the expression to completet.(RRRR(RRRRRR ((s6lib/python2.7/site-packages/rope/contrib/codeassist.pytstarting_expressionNs  cCstjdtddiS(Ns"default_templates() is deprecated.R i(RRR(((s6lib/python2.7/site-packages/rope/contrib/codeassist.pytdefault_templatesXs  RcBseZd dedZejZdZdZ dZ dZ d dZ dZ dZd Zd Zd ZRS( icCsj||_||_||_||_||_tj|t|_|jj |\|_ |_ |_ dS(N( RtcodeR R RRRRRRRRR(RWRRRR R R((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRX`s     cCsO|d}x:|dkrF||js9||dkrF|d8}q W|dS(Niit_(tisalnum(RWRRtcurrent_offset((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyt_find_starting_offsetms  cCsFg}x9|jD].}|j|r|jt|dqqW|S(Ntkeyword(tkeywordst startswithRJRT(RWRtresulttkw((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyt_matching_keywordsts cCs~|jt|jkrgSt|jj}|jjdkrz|jjdkrz|j |j |jn|S(Nt( RtlenRtlistt_code_completionstvaluesRtstripRtextendR(RWt completions((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyt__call__{s *c Csi}tjjj||j}|dk r|j}d}t|tj tj frcd}nxN|j j D]7\}}|j |jrvt|||||R?teval_strRRR#RCRtPyModulet PyPackagetget_attributestitemsRRRT( RWt module_scopet holding_scopeRt found_pynametelementt compl_scopeRUR'((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyt_dotted_completionss      cCs|jdk r%|j|j|n|dkr@|j}n |j}x|jD]\}}|j|jrYd}|jdkrd}n|dks|j s|j ||| rt |||||R?RRtBadIdentifierErrorRR#RCRR`RkRRatFalseRRRt( RWRRPRRtfunction_parenstprimarytfunction_pynameR(t param_namesRRU((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRsB          N(RpRqRRRXRtkwlistRRRRRRRRRRR(((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyR^s         RcBs/eZdZdddZdZdZRS(s$Sort a list of code assist proposalscCs||_|dkr3dddddddg}n||_|dkr`dd d d dg}ntd t|D|_dS( NRuRRRmRRlRRdRcReR/css!|]\}}||fVqdS(N((t.0tindexRY((s6lib/python2.7/site-packages/rope/contrib/codeassist.pys s(RRRtdictt enumeratettyperank(RWtcode_assist_proposalsRR((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRXs      cCsi}x-|jD]"}|j|jgj|qWg}xn|jD]c}|j|g}g|D]}|j|jkre|^qe}|jd|j |j |qFW|S(s%Return a list of `CodeAssistProposal`tkey( Rt setdefaultRPRJRtgetRYRtsortt _proposal_keyR(RWRtproposalRRPtscope_proposals((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRs  cCs4d}|jj|jd||j|jfS(NcSstd|DS(Ncss!|]}|dkrdVqdS(RiN((Rtc((s6lib/python2.7/site-packages/rope/contrib/codeassist.pys s(tsum(RU((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyt_underline_countsid(RRRYRU(RWt proposal1R((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRs  N(RpRqRrRRXRR(((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRs R$cBszeZdZeedZdZdZdZdZdZ edZ edZ d Z d d Z RS( cCsgt|tjr|j|St|tjr>|j|St|tjrc|j|jSdS(N( RCRR`t_get_function_docstringRkt_get_class_docstringtAbstractModulet_trim_docstringR%R(RWR(((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyR%%s  cCsyNt|tjr(|dj}nt|tjsM|dj}nWntjk redSX|rt|tj rdSt|tjr|j |dt }|r|j |r|j ddj ddS|SdS(NRXRt add_modules(self)s()s(self, t(( RCRRkR#R`RtAttributeNotFoundErrorRt PyFunctiont_get_function_signatureRt _is_methodtreplace(RWR(R*R+R((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyR).scCs|j|jd}g|jD]}|j^q%}d|jdj|f|}d|kr|dj}t|tjr|d|j |7}qn|S(Nisclass %s(%s): s, RXs ( RR%tget_superclassesRKtjoinR#RCRR`t_get_single_function_docstring(RWtpyclasstcontentsRwtsuperstdoctinit((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyR>s% cCsf|g}|j|r=|j|j|j|jndjg|D]}|j|^qJS(Ns (RRt_get_super_methodsRGRKRR(RWt pyfunctiont functionsRc((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRJs   cCs%t|tjo$t|jtjS(N(RCRRRGtPyClass(RWR((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRRscCs6|j|}|j|jdd}|d|S(NRis: (RRR%(RWRt signaturetdocs((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRVscCs{g}xn|jD]`}||krZ||j}t|tjrZ|j|qZn|j|j||qW|S(N(RR#RCRR`RJRR(RWRRURt super_classRc((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyR[s cCso|j||}t|tjrDtjj|}||jSd||jdj |j fSdS(Ns%s(%s)s, ( t _locationRCRRR RyRzt to_stringRKRRa(RWRRRtinfo((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRes cCsg}|j}xF|rWt|tj rW|j|j|jd|j}qW|rt|tjr|jd|j|nt|t j r|jd|jdqndj |S(NRiR( RGRCRRRJRKRtinsertt _get_moduleRt BuiltinModuleR(RWR(RRRG((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRns    cCsH|j}|dk rD|j}|dk rDtj|dSndS(NRR(R-RR.Rtmodname(RWRR/R ((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyR|s     ics#|s dS|jj}tj}xF|dD]:}|j}|r0t|t|t|}q0q0W|djg}|tjkrx,|dD]}|j||j qWnx|r|d r|j qWx"|r|d r|j dqWdj fd|DS(sThe sample code from :PEP:`257`Riiis c3s|]}d|VqdS(t N((Rtline(R(s6lib/python2.7/site-packages/rope/contrib/codeassist.pys s( t expandtabst splitlinestsystmaxsizetlstriptminRRRJtrstriptpopR(RWt docstringRRtindentRtstrippedttrimmed((Rs6lib/python2.7/site-packages/rope/contrib/codeassist.pyRs"  &(RpRqR%RR)RRRRRRRRR(((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyR$#s      tTemplateProposalcBseZdZRS(cCs<tjdtddtt|j|d||_dS(NsTemplateProposal is deprecated.R ittemplate(RRRRwRRXR(RWRUR((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRXs  (RpRqRX(((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRstTemplatecBs,eZdZdZdZdZRS(cCs#||_tjdtdddS(NsTemplate is deprecated.R i(RRRR(RWR((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRXs  cCsgS(N((RW((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyt variablesscCs|jS(N(R(RWtmapping((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyt substitutescCs t|jS(N(RR(RWR((s6lib/python2.7/site-packages/rope/contrib/codeassist.pytget_cursor_locations(RpRqRXRRR(((s6lib/python2.7/site-packages/rope/contrib/codeassist.pyRs   (*RRRtrope.base.codeanalyzeR7trope.base.evaluatet rope.baseRRRRRRRRRt rope.contribR t rope.refactorR RRRR R%RR)R,R4RStobjectRTtCodeAssistProposalRtRRRRRR$RR(((s6lib/python2.7/site-packages/rope/contrib/codeassist.pytsF       !  :e )~