From 43aee89f174b393f8b3665a410ad272760cab6d9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C2=A7dei8bit=C2=A7?=
<83183656+dei8bit@users.noreply.github.com>
Date: Tue, 7 May 2024 11:48:21 -0300
Subject: [PATCH] Update index.md in docs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
EN: The Spanish translation have a gap with the documentation in English, regarding some new implementations that are considered pertinent to include as soon as possible. ☺
ES: La traducción en español tenia un desfasaje con la documentación en ingles , respecto a algunas implementaciones nuevas que se estiman pertinentes de incluir cuanto antes. ☺
---
docs/es/docs/index.md | 80 +++++++++++++++++++++++++++----------------
1 file changed, 50 insertions(+), 30 deletions(-)
diff --git a/docs/es/docs/index.md b/docs/es/docs/index.md
index 631be74637..644231c9f0 100644
--- a/docs/es/docs/index.md
+++ b/docs/es/docs/index.md
@@ -132,18 +132,6 @@ $ pip install fastapi
-También vas a necesitar un servidor ASGI para producción cómo Uvicorn o Hypercorn.
-
-
-
-```console
-$ pip install "uvicorn[standard]"
-
----> 100%
-```
-
-
-
## Ejemplo
### Créalo
@@ -202,11 +190,24 @@ Corre el servidor con:
```console
-$ uvicorn main:app --reload
+$ fastapi dev main.py
+ ╭────────── FastAPI CLI - Development mode ───────────╮
+ │ │
+ │ Serving at: http://127.0.0.1:8000 │
+ │ │
+ │ API docs: http://127.0.0.1:8000/docs │
+ │ │
+ │ Running in development mode, for production use: │
+ │ │
+ │ fastapi run │
+ │ │
+ ╰─────────────────────────────────────────────────────╯
+
+INFO: Will watch for changes in these directories: ['/home/user/code/awesomeapp']
INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
-INFO: Started reloader process [28720]
-INFO: Started server process [28722]
+INFO: Started reloader process [2248755] using WatchFiles
+INFO: Started server process [2248757]
INFO: Waiting for application startup.
INFO: Application startup complete.
```
@@ -214,16 +215,17 @@ INFO: Application startup complete.
-Sobre el comando uvicorn main:app --reload...
+Sobre el comando fastapi dev main.py...
-El comando `uvicorn main:app` se refiere a:
+El comando `fastapi dev` lee tu archivo `main.py` , detecta la aplicacion **FastAPI** en él, y comienza un servidor usando Uvicorn.
-* `main`: el archivo `main.py` (el"modulo" de Python).
-* `app`: el objeto creado dentro de `main.py` con la línea `app = FastAPI()`.
-* `--reload`: hace que el servidor se reinicie después de cambios en el código. Esta opción solo debe ser usada en desarrollo.
+Por defecto, `fastapi dev` empezara con auto-reload activado para desarrollo local.
+
+Puedes leer mas acerca de eso en FastAPI CLI docs.
+
### Revísalo
Abre tu navegador en http://127.0.0.1:8000/items/5?q=somequery.
@@ -263,10 +265,11 @@ Ahora modifica el archivo `main.py` para recibir un Dependency Injection** poderoso y fácil de usar.
* Seguridad y autenticación incluyendo soporte para **OAuth2** con **JWT tokens** y **HTTP Basic** auth.
* Técnicas más avanzadas, pero igual de fáciles, para declarar **modelos de JSON profundamente anidados** (gracias a Pydantic).
+* Integracion de **GraphQL** con Strawberry y otras librerias.
* Muchas características extra (gracias a Starlette) como:
* **WebSockets**
- * **GraphQL**
* pruebas extremadamente fáciles con HTTPX y `pytest`
* **CORS**
* **Cookie Sessions**
@@ -436,28 +438,46 @@ Benchmarks independientes de TechEmpower muestran que aplicaciones de **FastAPI*
Para entender más al respecto revisa la sección Benchmarks.
-## Dependencias Opcionales
+## Dependencias
Usadas por Pydantic:
* email_validator - para validación de emails.
+* pydantic-settings - para manejo de configuraciones.
+* pydantic-extra-types - para tipos adicionales usados con Pydantic.
Usados por Starlette:
* httpx - Requerido si quieres usar el `TestClient`.
* jinja2 - Requerido si quieres usar la configuración por defecto de templates.
* python-multipart - Requerido si quieres dar soporte a "parsing" de formularios, con `request.form()`.
-* itsdangerous - Requerido para dar soporte a `SessionMiddleware`.
-* pyyaml - Requerido para dar soporte al `SchemaGenerator` de Starlette (probablemente no lo necesites con FastAPI).
-* graphene - Requerido para dar soporte a `GraphQLApp`.
+
Usado por FastAPI / Starlette:
* uvicorn - para el servidor que carga y sirve tu aplicación.
* orjson - Requerido si quieres usar `ORJSONResponse`.
* ujson - Requerido si quieres usar `UJSONResponse`.
+* * `fastapi-cli` - para proveer el comando `fastapi`.
-Puedes instalarlos con `pip install fastapi[all]`.
+Cuando instalas `fastapi` este viene con estas librerias por defecto
+
+## `fastapi-slim`
+
+Si no deseas las librerias que vienen por defecto, puede optar por instalar `fastapi-slim`.
+
+Cuando haces la instalacion con el comando:
+```bash
+pip install fastapi
+```
+
+...esto incluye el mismo codigo y dependencias que:
+
+```bash
+pip install "fastapi-slim[standard]"
+```
+
+Las dependencias por deefcto son las mencionadas arriba previamente
## Licencia