Metadata-Version: 1.0
Name: tiddlywebplugins.methodhack
Version: 0.2
Summary: Allow PUT and DELETE to tunnel over POST
Home-page: http://pypi.python.org/pypi/tiddlywebplugins.methodhack
Author: Chris Dent
Author-email: cdent@peermore.com
License: UNKNOWN
Description: 
        From the pydoc:
        
        A TiddlyWeb plugin for working around limitations in some server setups
        wherein perfectly legit HTTP methods like PUT and DELETE are not allowed
        to pass through to TiddlyWeb.
        
        This can also happen when using some legacy browsers which will not
        allow PUT and DELETE in XmlHttpRequest calls.
        
        We do this by looking at, in order:
        
        X-HTTP-Method header
        http_method URL parameter
        
        If the real method is POST, REQUEST_METHOD will be reset to whatever is
        given in the above.
        
        If the real method is GET, REQUEST_METHOD will only be reset to whatever
        is given in the above if it is GET or HEAD.
        
        Effectively this means that if you want to override, you must POST. This
        is consistent with idempotency conventions associated with HTTP methods.
        
        ONLY USE THIS MIDDLEWARE IF YOU CANNOT FIX YOUR SERVER OR YOUR BROWSER.
        YOUR SERVER AND BROWSER ARE BROKEN IF YOU NEED TO USE THIS.
        
        NOTE: This code will not magically handle tunneling of methods. Client
        code must choose to do the tunneling. At this time TiddlyWeb client code
        such as TiddlyWebAdaptor does NOT tunnel. methodhack provides a way to
        hand PUT and DELETE requests that have been tunneled over POST for those
        browsers that do not support PUT and DELETE. It handles clients that
        support a protocol defined in the docs.
        
        N.B.: When using this with TiddlyWebWiki, a client-side component is
        required as well. To this end, the following jQuery plugin can be used
        as a TiddlyWiki plugin:
        http://github.com/FND/jquery/blob/master/jquery.methodhack.js
        
Platform: Posix; MacOS X; Windows
