"""
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'