72 lines
1.6 KiB
Plaintext
72 lines
1.6 KiB
Plaintext
|
|
"""
|
|
Contributors can be viewed at:
|
|
http://svn.secondlife.com/svn/linden/projects/2008/pyogp/lib/base/trunk/CONTRIBUTORS.txt
|
|
|
|
$LicenseInfo:firstyear=2008&license=apachev2$
|
|
|
|
Copyright 2009, Linden Research, Inc.
|
|
|
|
Licensed under the Apache License, Version 2.0.
|
|
You may obtain a copy of the License at:
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
or in
|
|
http://svn.secondlife.com/svn/linden/projects/2008/pyogp/lib/base/LICENSE.txt
|
|
|
|
$/LicenseInfo$
|
|
"""
|
|
|
|
Networking Basics
|
|
~~~~~~~~~~~~~~~~~
|
|
|
|
The networking layer is basically a replaceable REST client. It is defined as a utility
|
|
providing methods such as GET, POST etc.
|
|
|
|
Let's retrieve the standard utility (this is overridden here in this test to use a mockup network library):
|
|
|
|
>>> from pyogp.lib.base.exc import HTTPError
|
|
>>> from pyogp.lib.base.tests.mockup_client import MockupClient
|
|
>>> from pyogp.lib.base.tests.base import StdLibClient
|
|
>>> client = MockupClient(StdLibClient())
|
|
|
|
Now we can use it. Let's post something to our test server:
|
|
|
|
>>> response = client.GET('http://localhost:12345/network/get')
|
|
>>> response.body
|
|
'Hello, World'
|
|
|
|
Let's try a 404:
|
|
|
|
>>> client.GET('http://localhost:12345/foobar')
|
|
Traceback (most recent call last):
|
|
...
|
|
HTTPError: 404 Not Found
|
|
|
|
The error object also has some more information in it:
|
|
|
|
>>> try:
|
|
... client.GET('http://localhost:12345/foobar')
|
|
... except HTTPError, error:
|
|
... pass
|
|
|
|
Let's check what's available
|
|
|
|
>>> error.code
|
|
404
|
|
>>> error.msg
|
|
'Not Found'
|
|
>>> error.fp.read()
|
|
'resource not found.'
|
|
|
|
|
|
POSTing something
|
|
~~~~~~~~~~~~~~~~~
|
|
|
|
>>> response = client.POST('http://localhost:12345/network/post','test me')
|
|
>>> response.body
|
|
'returned: test me'
|
|
|
|
|
|
|
|
|