Configuración inicial de proyecto FastAPI con el editor Cursor

Crear un proyecto paso a paso utilizando FastAPI y gestionar su desarrollo con la herramienta Cursor es fácil y eficiente si se siguen prácticas organizadas. La clave radica en tener un entendimiento claro del proyecto, documentar las iteraciones y aprovechar al máximo las funcionalidades que ofrece Cursor, principalmente mediante archivos markdown como prompts, su herramienta chat y el uso de sus modos de trabajo como el modo agente.

¿Cómo estructurar tu proyecto con Cursor desde cero?

La organización inicial del proyecto determina mucho su éxito futuro. Para esto, es recomendable crear una carpeta "specs" que contenga documentación sobre cada iteración del proyecto. Puedes organizar las iteraciones numerándolas, por ejemplo, "01-setup" con formato markdown. Allí podrás detallar claramente los pasos secuenciales para crear y evolucionar tu proyecto.

Es importante dar contexto al inicio del prompt para que la herramienta Cursor comprenda mejor la tarea asignada. ¡No te olvides de especificar claramente los pasos!

¿Qué debe incluir la estructura inicial del proyecto?

Utilizando el modo agente de Cursor, indicado para tareas secuenciales:

• Define la carpeta raíz del proyecto (Backend).
• Establece subdirectorios y los archivos iniciales como:
• Archivo "pyproject.toml" para gestión de dependencias.
• Carpeta "app" con archivos "main" e "init".
• Carpeta "core" para archivos como configuración.
• Una carpeta de base de datos con archivo "base".

¿Cuál es la forma adecuada de gestionar dependencias?

Cursor facilita la configuración de dependencias desde el archivo "pyproject.toml". Debes aclararle si dicho archivo ya existe o debe ser creado.

• Usa herramientas compatibles como "UV" para gestionar dependencias.
• Solo configura dentro del archivo las dependencias necesarias sin instalarlas de inmediato.

¿Por qué es conveniente utilizar PyDantic settings en FastAPI?

Tras una búsqueda eficiente mediante Cursor, se confirmó que PyDantic settings es la forma recomendada por FastAPI para manejar configuraciones del proyecto:

• Proporciona una gestión clara, organizada y segura para variables de entorno.
• Ideal para configurar datos como nombres de proyecto, versiones y URLs de bases de datos.

Implementar configuración centralizada

Define clases para los settings con atributos esenciales como:

• Nombre del proyecto.
• Versión actual.
• URL para base de datos.

¿Cómo crear y verificar endpoints correctos en FastAPI?

La definición básica de endpoints en FastAPI sigue un formato sencillo que Cursor maneja fácilmente:

• Crea previamente la aplicación FastAPI.
• Define endpoints fundamentales como "/" y "/health" con respuestas básicas correctas.

Verificación local de los endpoints

Antes de ejecutar tu aplicación localmente, recuerda crear y activar un entorno virtual:

• Usa Python versión 3.12 con instalaciones mediante la herramienta "UV".
• Ejecuta comandos de FastAPI para correr la aplicación.
• Verifica tu endpoint mediante un navegador.

Sé proactivo y utiliza las funciones avanzadas del modo agente Cursor que detecta errores como falta de dependencias y reacciona inmediatamente solucionando o indicando corregir el procedimiento realizado.

Finalmente, siempre revisa y ajusta tu prompt inicial dentro del archivo markdown. Una buena configuración inicial facilita todo el desarrollo posterior. Utiliza los comentarios para sugerir mejoras que optimicen el análisis, planificación y ejecución en Cursor.