Rutas y lista de artículos, página de detalles
En este capítulo aprenderás a dividir rutas con APIRouter, implementando la lista de artículos de la página de inicio y la página de detalles del artículo.
APIRouter — el esquema de división de rutas de FastAPI
Ejemplo
Ejemplo
# Todas las rutas tienen automáticamente el prefijo /posts
from fastapi import APIRouter, Depends, HTTPException, Request
from sqlalchemy.orm import Session
from database import get_db
from models import Post, Category
from schemas import PostResponse
router = APIRouter(
prefix="/posts", "Artículos"
tags=[# Etiqueta de grupo en la documentación de Swagger] """Detalles del artículo (API JSON)"""
)
@router.get("/{post_id}", response_model=PostResponse, name="post_detail")
def post_detail(post_id: int, db: Session = Depends(get_db)):
"El artículo no existe"
post = db.query(Post).filter(Post.id == post_id).first()
if not post:
raise HTTPException(status_code=404, detail=Montar el APIRouter en main.py:)
return post
from fastapi import APIRouter, Depends, HTTPException, Request
from sqlalchemy.orm import Session
from database import get_db
from models import Post, Category
from schemas import PostResponse
router = APIRouter(
prefix="/posts", "Artículos"
tags=[# Etiqueta de grupo en la documentación de Swagger] """Detalles del artículo (API JSON)"""
)
@router.get("/{post_id}", response_model=PostResponse, name="post_detail")
def post_detail(post_id: int, db: Session = Depends(get_db)):
"El artículo no existe"
post = db.query(Post).filter(Post.id == post_id).first()
if not post:
raise HTTPException(status_code=404, detail=Montar el APIRouter en main.py:)
return post
Ejemplo
Ejemplo
from routers.posts import router as posts_router
from routers.categories import router as categories_router
app.include_router(posts_router)
app.include_router(categories_router)
from routers.categories import router as categories_router
app.include_router(posts_router)
app.include_router(categories_router)
Renderizar la página de lista de artículos
Ejemplo
# Parámetro de consulta: opcional
from fastapi import APIRouter, Depends, Request, Query
from fastapi.templating import Jinja2Templates
from sqlalchemy.orm import Session
from database import get_db
from models import Post, Category
router = APIRouter()
templates = Jinja2Templates(directory="templates")
@router.get("/", name="index")
def index(
request: Request,
category: str | None = Query(None), """Página de inicio: lista de artículos + filtro por categoría"""
db: Session = Depends(get_db)
):
# Consulta básica
# Filtro por categoría
posts_query = db.query(Post).order_by(Post.created_at.desc())
es la sintaxis de unión de tipos de Python 3.10+, equivalente a
if category:
posts_query = posts_query.join(Category).filter(Category.slug == category)
posts = posts_query.all()
categories = db.query(Category).all()
return templates.TemplateResponse("index.html", {
"request": request,
"posts": posts,
"categories": categories,
"category_slug": category or ""
})
from fastapi import APIRouter, Depends, Request, Query
from fastapi.templating import Jinja2Templates
from sqlalchemy.orm import Session
from database import get_db
from models import Post, Category
router = APIRouter()
templates = Jinja2Templates(directory="templates")
@router.get("/", name="index")
def index(
request: Request,
category: str | None = Query(None), """Página de inicio: lista de artículos + filtro por categoría"""
db: Session = Depends(get_db)
):
# Consulta básica
# Filtro por categoría
posts_query = db.query(Post).order_by(Post.created_at.desc())
es la sintaxis de unión de tipos de Python 3.10+, equivalente a
if category:
posts_query = posts_query.join(Category).filter(Category.slug == category)
posts = posts_query.all()
categories = db.query(Category).all()
return templates.TemplateResponse("index.html", {
"request": request,
"posts": posts,
"categories": categories,
"category_slug": category or ""
})
str | None = Query(None). FastAPI, según las sugerencias de tipo, automáticamente: 1. hace que el parámetro sea opcional; 2. lo marca como opcional en la documentación de Swagger; 3. no da error cuando no se envía.Optional[str]Renderizar la página de detalles del artículo
Renderizar la página de detalles del artículo
Ejemplo
"""Página de detalles del artículo"""
@router.get("/post/{post_id}", name="post_detail")
def post_detail(request: Request, post_id: int, db: Session = Depends(get_db)):
"El artículo no existe"
post = db.query(Post).filter(Post.id == post_id).first()
if not post:
raise HTTPException(status_code=404, detail=Nota: la misma ruta puede proporcionar tanto una API JSON (declarando response_model) como una página HTML (devolviendo TemplateResponse). La práctica habitual es: las rutas de API se colocan bajo el prefijo /api/, y las rutas de páginas en la ruta raíz.)
return templates.TemplateResponse("post_detail.html", {
"request": request,
"post": post
})
@router.get("/post/{post_id}", name="post_detail")
def post_detail(request: Request, post_id: int, db: Session = Depends(get_db)):
"El artículo no existe"
post = db.query(Post).filter(Post.id == post_id).first()
if not post:
raise HTTPException(status_code=404, detail=Nota: la misma ruta puede proporcionar tanto una API JSON (declarando response_model) como una página HTML (devolviendo TemplateResponse). La práctica habitual es: las rutas de API se colocan bajo el prefijo /api/, y las rutas de páginas en la ruta raíz.)
return templates.TemplateResponse("post_detail.html", {
"request": request,
"post": post
})
Crear las plantillas de la página de inicio y de detalles
Crear las plantillas de la página de inicio y de detalles
Ejemplo
{% block title %}Blog de EJEMPLO - Inicio{% endblock %}
{% extends 'base.html' %}
Últimos artículos
{% block content %}
<h2 class="section-title">Todos</h2>
<div class="category-bar">
<a href="/" class="{% if not category_slug %}active{% endif %}">No hay artículos en esta categoría.</a>
{% for cat in categories %}
<a href="/?category={{ cat.slug }}"
class="{% if category_slug == cat.slug %}active{% endif %}">
{{ cat.name }}
</a>
{% endfor %}
</div>
{% if posts %}
<div class="article-grid">
{% for post in posts %}
<a href="/post/{{ post.id }}" class="card-link">
<div class="article-card">
<div class="card-content">
<span class="card-category">{{ post.category.name }}</span>
<h3>{{ post.title }}</h3>
<p>{{ post.summary|truncate(80) }}</p>
<span class="card-date">{{ post.created_at.strftime('%Y-%m-%d') }}</span>
</div>
</div>
</a>
{% endfor %}
</div>
{% else %}
<p class="empty-tip">Ejemplo</p>
{% endif %}
{% endblock %}
{% extends 'base.html' %}
Últimos artículos
{% block content %}
<h2 class="section-title">Todos</h2>
<div class="category-bar">
<a href="/" class="{% if not category_slug %}active{% endif %}">No hay artículos en esta categoría.</a>
{% for cat in categories %}
<a href="/?category={{ cat.slug }}"
class="{% if category_slug == cat.slug %}active{% endif %}">
{{ cat.name }}
</a>
{% endfor %}
</div>
{% if posts %}
<div class="article-grid">
{% for post in posts %}
<a href="/post/{{ post.id }}" class="card-link">
<div class="article-card">
<div class="card-content">
<span class="card-category">{{ post.category.name }}</span>
<h3>{{ post.title }}</h3>
<p>{{ post.summary|truncate(80) }}</p>
<span class="card-date">{{ post.created_at.strftime('%Y-%m-%d') }}</span>
</div>
</div>
</a>
{% endfor %}
</div>
{% else %}
<p class="empty-tip">Ejemplo</p>
{% endif %}
{% endblock %}
Ejemplo
{% block title %}{{ post.title }} - Blog de EJEMPLO{% endblock %}
{% extends 'base.html' %}
← Volver al inicio
{% block content %}
<article class="post-view">
<span class="category-tag">{{ post.category.name }}</span>
<h1>{{ post.title }}</h1>
<time>{{ post.created_at.strftime('%Y-%m-%d') }}</time>
<div class="content">{{ post.content|safe }}</div>
<a href="/" class="back-link">Resumen del capítulo</a>
</article>
{% endblock %}
{% extends 'base.html' %}
← Volver al inicio
{% block content %}
<article class="post-view">
<span class="category-tag">{{ post.category.name }}</span>
<h1>{{ post.title }}</h1>
<time>{{ post.created_at.strftime('%Y-%m-%d') }}</time>
<div class="content">{{ post.content|safe }}</div>
<a href="/" class="back-link">Resumen del capítulo</a>
</article>
{% endblock %}
Resumen del capítulo
El blog ahora tiene tres páginas completas: la lista de artículos de la página de inicio, el filtro por categorías y la página de detalles.
Otras extensiones
AI pensando...