Adding examples and updating readme.

Author: Josh Mervine

README.md

@@ -87,6 +87,7 @@ to send the OAuth header in the body or URLEncoded.
 
 ```
 git clone https://github.com/jmervine/python-maxcdn.git
+cd python-maxcdn
 
 make          # setup and test
 make setup    # installation w/ deps
@@ -98,3 +99,19 @@ make int/all  # integration w/ python2 python3.2 python3.3 python3.4
 make nose     # verbose test output w/ nosetests
 ```
 
+# Examples
+
+Running examples:
+
+```
+git clone https://github.com/jmervine/python-maxcdn.git
+cd python-maxcdn
+make setup
+
+export PYTHONPATH=./build:./maxcdn:$PYTHONPATH
+
+./examples/simple.py
+./examples/report.py # [hourly|daily|monthly]
+./examples/purge.py  # [zoneid]
+```
+

examples/purge.py

@@ -0,0 +1,47 @@
+#!/usr/bin/env python
+import pprint   as pp
+from   os       import environ as env
+from   sys      import exit, argv
+from   textwrap import dedent
+from   maxcdn   import MaxCDN
+
+try:
+    zoneid = argv[1]
+except:
+    zoneid = None
+
+if not "ALIAS" in env or not "KEY" in env or not "SECRET" in env:
+    print(dedent("""\
+        Usage: purge.py zoneid
+
+          Add credentials to your environment like so:
+
+          $ export ALIAS=<alias>
+          $ export KEY=<key>
+          $ export SECRET=<secret>
+        """))
+    exit(1)
+
+maxcdn = MaxCDN(env["ALIAS"], env["KEY"], env["SECRET"])
+
+if zoneid is None:
+    zones = maxcdn.get("/zones/pull.json")
+    for zone in zones["data"]["pullzones"]:
+        print("Purging zone: %s (%s)" % (
+            zone["name"], zone["id"]))
+
+        pp.pprint(maxcdn.purge(zone["id"]))
+else:
+    print("Purging zone: %s" % (zoneid))
+    res = maxcdn.purge(zoneid)
+    try:
+        if res["code"] == 200:
+            print("SUCCESS!")
+        else:
+            print("Failed with code: " + res["code"])
+            exit(res["code"])
+    except KeyError:
+        print("Something went terribly wrong!")
+        pp.pprint(res)
+        exit(1)
+

examples/report.py

@@ -0,0 +1,47 @@
+#!/usr/bin/env python
+import pprint as pp
+from os import environ as env
+from maxcdn import MaxCDN
+
+try:
+    report = "/"+argv[1]
+except:
+    report = ""
+
+if not "ALIAS" in env or not "KEY" in env or not "SECRET" in env:
+    print(dedent("""\
+        Usage: report.py [monthly|daily|hourly]
+
+          Add credentials to your environment like so:
+
+          $ export ALIAS=<alias>
+          $ export KEY=<key>
+          $ export SECRET=<secret>
+        """))
+    exit(1)
+
+
+maxcdn = MaxCDN(env["ALIAS"], env["KEY"], env["SECRET"])
+
+zones = maxcdn.get("/zones/pull.json")
+for zone in zones["data"]["pullzones"]:
+    print("Zone report for: %s (%s)" % (
+        zone["name"], zone["url"]))
+
+    # summary
+    fetch = maxcdn.get("/reports/%s/stats.json%s" % (zone["id"], report))
+    for key, val in fetch["data"]["summary"].iteritems():
+        print(" - %s: %s" % (key, val))
+
+    # popularfiles
+    print(" ")
+    print("Popular Files:")
+
+    fetch = maxcdn.get("/reports/%s/popularfiles.json?page_size=10" % (zone["id"]))
+    for file in fetch["data"]["popularfiles"]:
+        print(" - url: " + file["uri"])
+        print("   - hits: " + file["hit"])
+        print("   - size: " + file["size"])
+
+    print(" ")
+

examples/simple.py

@@ -0,0 +1,28 @@
+#!/usr/bin/env python
+import pprint as pp
+from os import environ as env
+from maxcdn import MaxCDN
+
+if not "ALIAS" in env or not "KEY" in env or not "SECRET" in env:
+    print(dedent("""\
+        Usage: simple.py
+
+          Add credentials to your environment like so:
+
+          $ export ALIAS=<alias>
+          $ export KEY=<key>
+          $ export SECRET=<secret>
+    """))
+    exit(1)
+
+maxcdn = MaxCDN(env["ALIAS"], env["KEY"], env["SECRET"])
+
+print("GET '/account.json'")
+pp.pprint(maxcdn.get("/account.json"))
+
+print("GET '/account.json/address'")
+pp.pprint(maxcdn.get("/account.json/address"))
+
+print("GET '/reports/stats.json/hourly'")
+pp.pprint(maxcdn.get("/reports/stats.json/hourly"))
+