Added snippets app

Author: macagua

README.md

@@ -1,6 +1,10 @@
 # django_rest_framework_tutorial
 
-My practices about [Django 1.9 Project tutorial](https://docs.djangoproject.com/en/1.9/intro/) and [Django Rest Framework 3.6.4 tutorial Quickstart](http://www.django-rest-framework.org/tutorial/quickstart/).
+My practices about the following tutorials:
+
+- [Django 1.9 Project tutorial](https://docs.djangoproject.com/en/1.9/intro/).
+- [Django Rest Framework 3.6.4 tutorial Quickstart](http://www.django-rest-framework.org/tutorial/quickstart/).
+- [Desarrollo de un API REST con Django REST framework, tutorial 1: Serialización](http://jonathanpumares.com/desarrollo-de-un-api-rest-con-django-rest-framework-tutorial-1-serializacion/).
 
 ## Installation
 
@@ -43,6 +47,14 @@ $ python manage.py runserver
 
 **Tip:** PLEASE add two **groups**, two **users** and later add a user into a group.
 
+### Quickstart App
+
+For add data for *Quickstart* App, please access to the following URL: [http://localhost:8000/admin/quickstart/](http://localhost:8000/admin/quickstart/)
+
+### Snippets App
+
+For add data for *Snippets* App, please access to the following URL: [http://localhost:8000/admin/snippets/](http://localhost:8000/admin/snippets/)
+
 ### Testing the API
 
 You have many APIs Rest for testing, now access to the APIs, both from the command-line, using tools like **curl**, please execute the following command:
@@ -168,6 +180,24 @@ $ curl -H 'Accept: application/json; indent=4' -u admin:password123 http://127.0
 ]
 ```
 
+#### Snippets list endpoint
+
+For testing the **snippets list** API Rest, please execute the following command:
+
+```bash
+$ curl -H 'Accept: application/json; indent=4' -u admin:password123 http://localhost:8000/snippets/list/
+[{"id":1,"title":"","code":"foo = \"bar\"\n","linenos":false,"language":"python","style":"friendly"},{"id":2,"title":"","code":"print \"hello, world\"\n","linenos":false,"language":"python","style":"friendly"},{"id":3,"title":"","code":"print \"hello, world\"","linenos":false,"language":"python","style":"friendly"}]
+```
+
+#### Snippets detail endpoint
+
+For testing the **snippets detail** API Rest, please execute the following command:
+
+```bash
+$ curl -H 'Accept: application/json; indent=4' -u admin:password123 http://localhost:8000/snippets/detail/1/
+{"id":1,"title":"","code":"foo = \"bar\"\n","linenos":false,"language":"python","style":"friendly"}
+```
+
 ## Django Interactive Console
 For make some practices the Django ORM, please execute the following command:
 
@@ -317,3 +347,4 @@ ValidationError: {'email': [u'Enter a valid email address.'], 'created': [u'This
 
 - [Django 1.9 Project tutorial](https://docs.djangoproject.com/en/1.9/intro/).
 - [Django Rest Framework 3.6.4 tutorial Quickstart](http://www.django-rest-framework.org/tutorial/quickstart/).
+- [Desarrollo de un API REST con Django REST framework, tutorial 1: Serialización](http://jonathanpumares.com/desarrollo-de-un-api-rest-con-django-rest-framework-tutorial-1-serializacion/).

snippets/__init__.py

@@ -0,0 +1 @@
+# -*- coding: utf-8 -*-

snippets/admin.py

@@ -0,0 +1,5 @@
+# -*- coding: utf-8 -*-
+
+from django.contrib import admin
+
+# Register your models here.

snippets/apps.py

@@ -0,0 +1,9 @@
+# -*- coding: utf-8 -*-
+
+from __future__ import unicode_literals
+
+from django.apps import AppConfig
+
+
+class SnippetsConfig(AppConfig):
+    name = 'snippets'

snippets/migrations/__init__.py

@@ -0,0 +1,31 @@
+# -*- coding: utf-8 -*-
+
+from __future__ import unicode_literals
+
+from django.db import models
+from pygments.lexers import get_all_lexers
+from pygments.styles import get_all_styles
+    
+LEXERS = [item for item in get_all_lexers() if item[1]]
+LANGUAGE_CHOICES = sorted([(item[1][0], item[0]) for item in LEXERS])
+STYLE_CHOICES = sorted((item, item) for item in get_all_styles())
+    
+    
+class Snippet(models.Model):
+    created = models.DateTimeField(auto_now_add=True)
+    title = models.CharField(max_length=100, blank=True, default='')
+    code = models.TextField()
+    linenos = models.BooleanField(default=False)
+    language = models.CharField(choices=LANGUAGE_CHOICES, default='python', max_length=100)
+    style = models.CharField(choices=STYLE_CHOICES, default='friendly', max_length=100)
+
+    class Meta:
+        verbose_name = "Snippet"
+        verbose_name_plural = "Snippets"
+        ordering = ('created',)
+
+    def __unicode__(self):
+        return "%s" % (self.title)
+
+    def __str__(self):
+        return self.title

snippets/models.py

@@ -0,0 +1,11 @@
+# -*- coding: utf-8 -*-
+
+from django.forms import widgets
+from rest_framework import serializers
+from snippets.models import Snippet, LANGUAGE_CHOICES, STYLE_CHOICES
+    
+    
+class SnippetSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = Snippet
+        fields = ('id', 'title', 'code', 'linenos', 'language', 'style')

snippets/serializers.py

@@ -0,0 +1,5 @@
+# -*- coding: utf-8 -*-
+
+from django.test import TestCase
+
+# Create your tests here.

snippets/tests.py

@@ -0,0 +1,9 @@
+# -*- coding: utf-8 -*-
+
+from django.conf.urls import url
+from snippets import views
+    
+urlpatterns = [
+    url(r'^list/$', views.snippet_list),
+    url(r'^detail/(?P<pk>[0-9]+)/$', views.snippet_detail),
+]

snippets/urls.py

@@ -0,0 +1,64 @@
+# -*- coding: utf-8 -*-
+
+from django.http import HttpResponse
+from django.views.decorators.csrf import csrf_exempt
+from rest_framework.renderers import JSONRenderer
+from rest_framework.parsers import JSONParser
+from snippets.models import Snippet
+from snippets.serializers import SnippetSerializer
+    
+
+class JSONResponse(HttpResponse):
+    """
+    An HttpResponse that renders its content into JSON.
+    """
+    def __init__(self, data, **kwargs):
+        content = JSONRenderer().render(data)
+        kwargs['content_type'] = 'application/json'
+        super(JSONResponse, self).__init__(content, **kwargs)
+
+
+@csrf_exempt
+def snippet_list(request):
+    """
+    List all code snippets, or create a new snippet.
+    """
+    if request.method == 'GET':
+        snippets = Snippet.objects.all()
+        serializer = SnippetSerializer(snippets, many=True)
+        return JSONResponse(serializer.data)
+    
+    elif request.method == 'POST':
+        data = JSONParser().parse(request)
+        serializer = SnippetSerializer(data=data)
+        if serializer.is_valid():
+            serializer.save()
+            return JSONResponse(serializer.data, status=201)
+        return JSONResponse(serializer.errors, status=400)
+
+
+@csrf_exempt
+def snippet_detail(request, pk):
+    """
+    Retrieve, update or delete a code snippet.
+    """
+    try:
+        snippet = Snippet.objects.get(pk=pk)
+    except Snippet.DoesNotExist:
+        return HttpResponse(status=404)
+    
+    if request.method == 'GET':
+        serializer = SnippetSerializer(snippet)
+        return JSONResponse(serializer.data)
+    
+    elif request.method == 'PUT':
+        data = JSONParser().parse(request)
+        serializer = SnippetSerializer(snippet, data=data)
+        if serializer.is_valid():
+            serializer.save()
+            return JSONResponse(serializer.data)
+        return JSONResponse(serializer.errors, status=400)
+    
+    elif request.method == 'DELETE':
+        snippet.delete()
+        return HttpResponse(status=204)

snippets/views.py

@@ -41,6 +41,7 @@
     'django.contrib.staticfiles',
     'rest_framework',
     'quickstart',
+    'snippets',
 ]
 
 MIDDLEWARE_CLASSES = [
@@ -128,6 +129,7 @@
     # Use Django's standard `django.contrib.auth` permissions,
     # or allow read-only access for unauthenticated users.
     'DEFAULT_PERMISSION_CLASSES': [
-        'rest_framework.permissions.DjangoModelPermissionsOrAnonReadOnly'
+        'rest_framework.permissions.DjangoModelPermissionsOrAnonReadOnly',
+        'rest_framework.permissions.DjangoModelPermissions'
     ]
 }

tutorial/settings.py

@@ -32,5 +32,6 @@
 urlpatterns = [
     url(r'^admin/', admin.site.urls),
     url(r'^', include(router.urls)),
-    url(r'^api-auth/', include('rest_framework.urls', namespace='rest_framework'))
+    url(r'^api-auth/', include('rest_framework.urls', namespace='rest_framework')),
+    url(r'^snippets/', include('snippets.urls')),
 ]