Ñò (üûGc@sXdZddkZddkZddklZlZddkZddklZddk Tddk l Z d„Z d„Z d d „Zd d „Zd d „Zd „Zd„Zd„Zd„Zd„Zddddd„Zd„Zd„Zd„Zd„Zddddddddd„Zd„Zdddddddd d!d"g ZdS(#s URL HelpersiÿÿÿÿN(turl_fortrequest_config(tcompute_public_path(t*(t html_escapecCst|ƒo|ƒS|SdS(N(tcallable(turl((s9/usr/lib/python2.6/site-packages/webhelpers/rails/urls.pytget_urls cs"ˆ‰ˆ‰‡‡fd†}|S(sÈ Lazily evaluates url_for() arguments. Used instead of url_for() for functions so that the function will be evaluated in a lazy manner rather than at initial function call. cs tˆˆŽS(N(R((targstkargs(s9/usr/lib/python2.6/site-packages/webhelpers/rails/urls.pytcalls((RR R ((RR s9/usr/lib/python2.6/site-packages/webhelpers/rails/urls.pyRstcKsj|ot|}ti|}nd}t|ƒo |ƒ}n t|ƒ}d|||p|fS(sú Create link tag with text ``name`` and a URL created by the set of ``options``. See the valid options in the documentation for Routes url_for. The html_options has three special features. One for creating javascript confirm alerts where if you pass ``confirm='Are you sure?'``, the link will be guarded with a JS popup asking that question. If the user accepts, the link is processed, otherwise not. Another for creating a popup window, which is done by either passing ``popup`` with True or the options of the window in Javascript form. And a third for making the link do a POST request (instead of the regular GET) through a dynamically added form element that is instantly submitted. Note that if the user has turned off Javascript, the request will fall back on the GET. So its your responsibility to determine what the action should be once it arrives at the controller. The POST form is turned on by passing ``post`` as True. Note, it's not possible to use POST requests and popup targets at the same time (an exception will be thrown). Examples:: >> link_to("Delete this page", url(action="destroy", id=4), confirm="Are you sure?") >> link_to("Help", url(action="help"), popup=True) >> link_to("Busy loop", url(action="busy"), popup=['new_window', 'height=300,width=600']) >> link_to("Destroy account", url(action="destroy"), confirm="Are you sure?", method='delete') R s%s(tconvert_options_to_javascriptttagst tag_optionsRR(tnameRt html_optionsttag_op((s9/usr/lib/python2.6/site-packages/webhelpers/rails/urls.pytlink_to"s    cKst|||}d|S(sY Generate a form containing a sole button that submits to ``url``. Use this method instead of ``link_to`` for actions that do not have the safe HTTP GET semantics implied by using a hypertext link. The parameters are the same as for ``link_to``. Any ``html_options`` that you pass will be applied to the inner ``input`` element. In particular, pass disabled = True/False as part of ``html_options`` to control whether the button is disabled. The generated form element is given the class 'button-to', to which you can attach CSS styles for display purposes. The submit button itself will be displayed as an image if you provide both ``type`` and ``src`` as followed: type='image', src='icon_delete.gif' The ``src`` path will be computed as the image_tag() computes its ``source`` argument. Example 1:: # inside of controller for "feeds" >> button_to("Edit", url(action='edit', id=3))
Example 2:: >> button_to("Destroy", url(action='destroy', id=3), confirm="Are you sure?", method='DELETE')
Example 3:: # Button as an image. >> button_to("Edit", url(action='edit', id=3), type='image', src='icon_delete.gif')
*NOTE*: This method generates HTML code that represents a form. Forms are "block" content, which means that you should not try to insert them into your HTML where only inline content is expected. For example, you can legally insert a form inside of a ``div`` or ``td`` element or in between ``p`` elements, but not in the middle of a run of text, nor can you place a form within another form. (Bottom line: Always validate your HTML before going public.) s %s(t _button_to(RRRt button_html((s9/usr/lib/python2.6/site-packages/webhelpers/rails/urls.pyt button_toLs=c KsÖ|ot|dgƒnd}|iddƒ}|iƒdjo+tidddd d d d d |ƒ}n|iƒd jo|pd}|idƒ}|o|d=dt|ƒ|d to allow the secure_button_to() (webhelpers.rails.secure_form_tag.secure_button_to) to use this function as well. tdisabledR tmethodtPUTtDELETEtinputttype_thiddentidt_methodtname_tvaluetGETtPOSTtconfirms return %s;tonclickttypetsrctimagetalttimagestpngtsubmits5
s
(RR( tconvert_boolean_attributestpoptupperR ttagtgettconfirm_javascript_functionRt escape_oncetupdatetdictR( RRRt method_tagRt form_methodR#turt submit_typet img_source((s9/usr/lib/python2.6/site-packages/webhelpers/rails/urls.pyRŒs0    !cKstt|ƒ|||S(s! Conditionally create a link tag of the given ``name`` using the ``url``. If the current request uri is the same as the link's only the name is returned. This is useful for creating link bars where you don't want to link to the page currently being viewed. (tlink_to_unlesst current_page(RRR((s9/usr/lib/python2.6/site-packages/webhelpers/rails/urls.pytlink_to_unless_current´s cKs |o|St|||SdS(s” Conditionally create a link tag of the given ``name`` using the ``url``. If ``condition`` is True only the name is returned. N(R(t conditionRRR((s9/usr/lib/python2.6/site-packages/webhelpers/rails/urls.pyR:¿scKst| |||S(s• Conditionally create a link tag of the given ``name`` using the ``url``. If ``condition`` is True only the name is returned. (R:(R=RRR((s9/usr/lib/python2.6/site-packages/webhelpers/rails/urls.pyt link_to_ifËscCs2tƒ}t|ƒo|ƒ|jS||jSdS(s=Return true if the current page uri is equivalent to ``url``.N(t current_urlR(Rtcurrl((s9/usr/lib/python2.6/site-packages/webhelpers/rails/urls.pyR;Ôs  cOsJtƒ}|i}|iddƒ}|od|}nt||Ž|S(sReturn the current page's url.t QUERY_STRINGR t?(RtenvironR0R(RtkwargstconfigRCtqs((s9/usr/lib/python2.6/site-packages/webhelpers/rails/urls.pyR?Üs   cKs|o| o d}n|o|otdƒ‚n½|o'|o dt|ƒt|ƒf}n|o'|o dt|ƒt|ƒf}na|odt|ƒ}nF|odt|ƒ}n+|ot|ƒd}n|idƒ}||d<|S(NR"s-You can't use popup and post in the same linksif (%s) { %s };return false;s return %s;s%sreturn false;s return false;R$(t ValueErrorR1tpopup_javascript_functiontmethod_javascript_functionR0(R#tpopuptpostRRtoc((s9/usr/lib/python2.6/site-packages/webhelpers/rails/urls.pyR ås&    cCsYxR|D]J}|i|ƒo||o|||}|i|ƒo|idt|ƒƒqI|i|ƒqIWd i|ƒ}n| |}| o|d| 7}n|| d>> mail_to("me@domain.com", "My email", encode = "javascript") '' >>> mail_to("me@domain.com", "My email", encode = "hex") 'My email' You can also specify the cc address, bcc address, subject, and body parts of the message header to create a complex e-mail using the corresponding ``cc``, ``bcc``, ``subject``, and ``body`` keyword arguments. Each of these options are URI escaped and then appended to the ``email_address`` before being output. **Be aware that javascript keywords will not be escaped and may break this feature when encoding with javascript.** Examples:: >>> mail_to("me@domain.com", "My email", cc="ccaddress@domain.com", bcc="bccaddress@domain.com", subject="This is an example email", body= "This is the body of the message.") 'My email' tcctbcctsubjecttbodyit+s%20smailto:t@t.thexR s&#%d;s\ws%%%xRBthreftat javascriptsdocument.write('%s');seval(unescape('%s'))N( tappendturllibt urlencodetreplacetjointordtretcompiletmatchR t content_tagtjavascript_tag(t email_addressRRTRURVRWt replace_att replace_dottencodeRtextrastitemt options_querytprotocoltemail_address_obfuscatedt_[1]txt_[2]tword_ret encoded_partsRR/ttmpt_[3]tstring((s9/usr/lib/python2.6/site-packages/webhelpers/rails/urls.pytmail_tosB"+  44    4cCsLd|}dig}|D]}|dt|ƒq~ƒ}td|ƒS(sÊObfuscate data in a Javascript tag. Example:: >>> js_obfuscate("") '' sdocument.write('%s');R s%%%xseval(unescape('%s'))(RcRdRi(tdataRxRsRtRz((s9/usr/lib/python2.6/site-packages/webhelpers/rails/urls.pyt js_obfuscateas 4RRRR<R:R>R;R?R{R}(t__doc__ReR`troutesRRR t asset_tagRR^twebhelpers.utilRRRRRRR<R:R>R;R?tNoneR R,R1RHRIR{R}t__all__(((s9/usr/lib/python2.6/site-packages/webhelpers/rails/urls.pyts6       * @ (      I