Added:

 * from ajaxutils import json
 * tests
 * documentation

Bumped version number to 0.2

README.rst

@@ -80,3 +80,75 @@ This will return a ``405: Method not allowed`` response with the following JSON
     }
 
 You can of course set ``require_GET=True`` for GET requests.
+
+You can also use this alternative syntax:
+
+    @ajax(require="GET")
+    def my_cool_view(request):
+        return {
+            'hello': 'world!'
+        }
+
+
+Custom Status Codes
+-------------------
+What if you don't want to return an HTTP 200? Do you want to return a 404? Write::
+
+    from django.http import Http404
+
+    @ajax()
+    def my_cool_view(request):
+        raise Http404
+
+This returns::
+
+    {
+        'status': 'error',
+        'error': 'Not found',
+    }
+
+Or maybe a 400 - Bad Request::
+
+    from django.http import HttpResponseBadRequest
+
+    @ajax()
+    def my_cool_view(request):
+        return HttpResponseBadRequest('My error message')
+
+This returns::
+
+    {
+        'status': 'error',
+        'error': 'My error message',
+    }
+
+and the HTTP response has status code 400.
+
+Another syntax, more Flask-ish::
+
+    @ajax()
+    def my_cool_view(request):
+        return {
+            "i'm a": 'teapot'
+        }, 418
+
+
+From infinity import json
+-------------------------
+
+Tired of writing infinite import statements to choose the best json module? Let ajaxutils do it for you::
+
+    from ajaxutils import json
+
+At the moment, ajaxutils prefers simplejson over the stdlib json. No other json module is used. In the future we will probably provide support to ujson using a Django setting.
+
+Changelog
+=========
+
+v0.2
+----
+
+* Moved JsonResponse to ajaxutils.http
+* Added Custom Status Codes handling
+* Added documentation for @ajax(require=METHOD)
+* Added "from ajaxutils import json"

ajaxutils/__init__.py

@@ -0,0 +1,4 @@
+try:
+    import simplejson as json
+except ImportError:
+    import json

ajaxutils/http.py

@@ -1,10 +1,7 @@
-try:
-    import simplejson as json
-except ImportError:
-    import json
-
 from django.http import HttpResponse
 
+from ajaxutils import json
+
 
 def handler(obj):
     if hasattr(obj, 'isoformat'):

ajaxutils_tests/tests.py

@@ -1,8 +1,8 @@
-import json
-
 from django.test import TestCase
 from django.contrib.auth.models import User
 
+from ajaxutils import json
+
 
 class TestAjaxDecorator(TestCase):
     def setUp(self):
@@ -63,6 +63,12 @@ def test_logged_failure(self):
 
         json.loads(response.content)
 
+    def test_catch_http_404_exception(self):
+        response = self.client.get('/raise/404/')
+        self.assertEqual(response.status_code, 404)
+
+        json.loads(response.content)
+
     def test_custom_status_code(self):
         response = self.client.get('/custom/712/')
         self.assertEqual(response.status_code, 712)

ajaxutils_tests/urls.py

@@ -1,6 +1,6 @@
 from django.conf.urls.defaults import patterns, url
 
-from .views import simple, simple_with_custom_status_code
+from .views import simple, simple_with_custom_status_code, raise_404
 
 from ajaxutils.decorators import ajax
 
@@ -13,6 +13,8 @@
     url(r'^simple_post/$', ajax(require="POST")(simple)),
     url(r'^logged/$', ajax(login_required=True)(simple)),
 
+    url(r'^raise/404/$', ajax()(raise_404)),
+
     url(
         r'^custom/(?P<status_code>\d+)/$',
         ajax()(simple_with_custom_status_code)

ajaxutils_tests/views.py

@@ -2,5 +2,11 @@ def simple(request):
     return {'status': 'success'}
 
 
+def raise_404(request):
+    from django.http import Http404
+
+    raise Http404
+
+
 def simple_with_custom_status_code(request, status_code):
     return {'status': 'success'}, int(status_code)

setup.py

@@ -19,7 +19,7 @@
 
 setup(
     name='django-ajaxutils',
-    version="0.1.2",
+    version="0.2",
     description='Ajax requests for Ponies',
     url='http://github.com/ahref/django-ajaxutils',
     packages=['ajaxutils'],