Examples and documentation.

4 files changed, 88 insertions, 0 deletions

diff --git a/examples/pathoc.py b/examples/libpathod_pathoc.py
index 4c3fae52..ca53b08f 100755..100644
--- a/examples/pathoc.py
+++ b/examples/libpathod_pathoc.py
@@ -4,3 +4,4 @@ from libpathod import pathoc
 p = pathoc.Pathoc("google.com", 80)
 p.connect()
 print p.request("get:/")
+print p.request("get:/foo")
diff --git a/examples/test_context.py b/examples/test_context.py
new file mode 100644
index 00000000..f3da83cb
--- /dev/null
+++ b/examples/test_context.py
@@ -0,0 +1,22 @@
+import requests
+from libpathod import test
+
+def test_simple():
+    """
+        Testing the requests module with
+        a pathod context manager.
+    """
+    # Start pathod in a separate thread
+    with test.Daemon() as d:
+        # Get a URL for a pathod spec
+        url = d.p("200:b@100")
+        # ... and request it
+        r = requests.put(url)
+
+        # Check the returned data
+        assert r.status_code == 200
+        assert len(r.content) == 100
+
+        # Check pathod's internal log
+        log = d.last_log()["request"]
+        assert log["method"] == "PUT"
diff --git a/examples/test_setup.py b/examples/test_setup.py
new file mode 100644
index 00000000..2918a4dd
--- /dev/null
+++ b/examples/test_setup.py
@@ -0,0 +1,28 @@
+import requests
+from libpathod import test
+
+class Test:
+    """
+        Testing the requests module with
+        a pathod instance started for
+        each test.
+    """
+    def setUp(self):
+        self.d = test.Daemon()
+
+    def tearDown(self):
+        self.d.shutdown()
+
+    def test_simple(self):
+        # Get a URL for a pathod spec
+        url = self.d.p("200:b@100")
+        # ... and request it
+        r = requests.put(url)
+
+        # Check the returned data
+        assert r.status_code == 200
+        assert len(r.content) == 100
+
+        # Check pathod's internal log
+        log = self.d.last_log()["request"]
+        assert log["method"] == "PUT"
diff --git a/examples/test_setupall.py b/examples/test_setupall.py
new file mode 100644
index 00000000..c8948971
--- /dev/null
+++ b/examples/test_setupall.py
@@ -0,0 +1,37 @@
+import requests
+from libpathod import test
+
+class Test:
+    """
+        Testing the requests module with 
+        a single pathod instance started 
+        for the test suite.
+    """
+    @classmethod
+    def setUpAll(cls):
+        cls.d = test.Daemon()
+
+    @classmethod
+    def tearDownAll(cls):
+        cls.d.shutdown()
+
+    def setUp(self):
+        # Clear the pathod logs between tests
+        self.d.clear_log()
+
+    def test_simple(self):
+        # Get a URL for a pathod spec
+        url = self.d.p("200:b@100")
+        # ... and request it
+        r = requests.put(url)
+
+        # Check the returned data
+        assert r.status_code == 200
+        assert len(r.content) == 100
+
+        # Check pathod's internal log
+        log = self.d.last_log()["request"]
+        assert log["method"] == "PUT"
+
+    def test_two(self):
+        assert not self.d.log()