Lección 6: Crear

El objetivo será crear un CRUD de Endpoints (añadir-leer-actualizar-borrar) con Libro para leerlo y gestionarlo de todas las maneras que necesitemos.

El primer objetivo será definir un Endpoint para crear un nuevo libro (POST). Empezamos creando un nuevo test.

# tests/libros/test_views.py

import pytest
from app.libros.models import Libros

@pytest.mark.django_db
def test_add_libro(client):
    # Given
    libros = Libros.objects.all()
    assert len(libros) == 0

    # When
    resp = client.post(
        "/api/libros/",
        {
            "title": "El fin de la eternidad",
            "genre": "Ciencia Ficción",
            "author": "Isaac Asimov",
            "year": "1955",
        },
        content_type="application/json"
    )

    # Then
    assert resp.status_code == 201
    assert resp.data["title"] == "El fin de la eternidad"

    libros = Libros.objects.all()
    assert len(libros) == 1

Al ejecutarlo fallará, como siempre (para más información puedes ver mi explicación de TDD).

Actualizamos la vista.

# app/libros/views.py

from django.http import JsonResponse
from rest_framework.views import APIView # nuevo
from rest_framework.response import Response # nuevo
from rest_framework import status # nuevo
from .serializers import LibroSerializer # nuevo

def ping(request):
    data = {"ping": "pong!"}
    return JsonResponse(data)

# nuevo desde aquí
class LibrosList(APIView):

    def post(self, request):
        serializer = LibroSerializer(data=request.data)
        if serializer.is_valid():
            serializer.save()
            return Response(serializer.data, status=status.HTTP_201_CREATED)
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
# nuevo hasta aquí

Para separar las urls de las diferentes aplicaciones vamos a crear una ruta en urls.py de libros.

# app/libros/urls.py

from django.urls import path
from app.libros.views import ping, LibrosList

urlpatterns = [
    path("ping/", ping, name="ping"),
    path("api/libros/", LibrosList.as_view()),
]

Mientras que dentro de proyecto/urls.py llamaremos las rutas de todas las aplicaciones. En este caso únicamente admin y libros.

# proyecto/urls.py

from django.contrib import admin
from django.urls import path, include # nuevo

urlpatterns = [
    path("admin/", admin.site.urls),
    path("", include("app.libros.urls")), # nuevo
]

Ahora sí se ejecutará el test.

pytest -k views

Otra posibilidad es usar un cliente de HTTP com curl o HTTPie.

# curl
curl -XPOST -H "Content-type: application/json" -d '{
	"title": "El fin de la eternidad",
	"genre": "Ciencia Ficción",
	"author": "Isaac Asimov",
	"year": 1955
}' http://localhost:8000/api/libros/

# HTTPie
http --json \
POST http://localhost:8000/api/libros/ \
title="El fin de la eternidad" \
genre="Ciencia Ficción" \
author="Isaac Asimov" \
year=1955

Nos devolverá.

HTTP/1.1 201 Created
Allow: POST, OPTIONS
Content-Length: 192
Content-Type: application/json
Date: Sun, 11 Jul 2021 21:30:04 GMT
Referrer-Policy: same-origin
Server: WSGIServer/0.2 CPython/3.9.2
Vary: Accept, Cookie
X-Content-Type-Options: nosniff
X-Frame-Options: DENY

{
    "author": "Isaac Asimov",
    "created_at": "2021-07-11T21:30:04.088124Z",
    "genre": "Ciencia Ficción",
    "id": 1,
    "title": "El fin de la eternidad",
    "updated_at": "2021-07-11T21:30:04.088160Z",
    "year": "1955"
}

Esta obra está bajo una Licencia Creative Commons Atribución-NoComercial-SinDerivadas 4.0 Internacional.

Atribución/Reconocimiento-NoComercial-SinDerivados 4.0 Internacional

¿Me ayudas?

Comprame un café
Pulsa sobre la imagen

No te sientas obligado a realizar una donación, pero cada aportación mantiene el sitio en activo logrando que continúe existiendo y sea accesible para otras personas. Además me motiva a crear nuevo contenido.

Comentarios

{{ comments.length }} comentarios

Nuevo comentario

Nueva replica  {{ formatEllipsisAuthor(replyComment.author) }}

Acepto la política de Protección de Datos.

Escribe el primer comentario