attribute_wrapper 0.1.0

Basic access

from attribute_wrapper import HTTPWrapper

r = HTTPWrapper("http://kitakitsune.org")
data = r.get()

This will download content of http://kitakitsune.org and return it as string. The .get() call determines the HTTP method, which is used to perform the request.

Attribute path composition

The dot attribute access notation is used to compose the path of required HTTP resource. For example:

r.raw.get()

is translated to GET request for http://kitakitsune.org/raw.

Special characters

The dot notation in python is restricted only to A-Z, a-z, 0-9 and _, which may be sometimes too much restricting. Thats why the GenericWrapper has the attribute .specials, which contains mappings of special sequences to URL characters.

The .specials table is at this moment implemented by following structure:

{
    "__dot__": ".",
    "__slash__": "/",
    "__dash__": "-",
}

Which means that URL containing this substrings will be translated as expected:

r.raw.doctene_knihy__dot__txt.get()

is translated to http://kitakitsune.org/raw/doctene_knihy.txt

This functionality can be changed by replacing .specials dictionary table with something else, or with blank dictionary to disable it.

Automatic suffix

If you work with API, which expects that each file ends with suffix like .json or .html, you can modify the .suffix attribute or add suffix parameter when you are instancing the class:

r = HTTPWrapper("http://kitakitsune.org", suffix=".txt")

# this will return content of the http://kitakitsune.org, because the suffix
# is ignored in root of the path
r.get()

# this will return http://kitakitsune.org/raw/doctene_knihy.txt
r.raw.doctene_knihy.get()

Parameters

The method handling call at last attribute accepts keyword parameters, which are sent to server as form data:

r.post(something="else")

This will send {"something": "else"} dictionary as POST data to server.

JSONWrapper

As example subclass, there is also JSONWrapper, which translates all parameters to JSON and send it as HTTP body to server. This may be specially useful with some of the REST API.

Your code

Feel free to send pull request with you own classes (don’t forget to document it). I would like to make this package useful and I will gladly incorporate your code, so you don’t need to create your own package.