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.
¿Me invitas a un café? ☕
Puedes hacerlo usando el terminal.
ssh customer@andros.dev -p 5555
Comentarios
Nuevo comentario
Nueva replica {{ formatEllipsisAuthor(replyComment.author) }}
Escribe el primer comentario
{{ comments.length }} comentarios