update api

.dockerignore

@@ -0,0 +1,24 @@
+# Ignorar el entorno virtual de Python
+venv/
+.venv/
+
+# Ignorar cachés de Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+
+# Ignorar archivos específicos del editor o sistema operativo
+.vscode/
+.idea/
+.DS_Store
+
+# Ignorar archivos de entorno (¡muy importante para la seguridad!)
+.env
+
+# Ignorar el directorio de git
+.git/
+.gitignore
+
+# Archivos de configuración de herramientas
+.pytest_cache/

.gitignore

@@ -0,0 +1,17 @@
+# Ignorar el entorno virtual de Python
+venv/
+.venv/
+
+# Ignorar cachés de Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+
+# Ignorar archivos específicos del editor o sistema operativo
+.vscode/
+.idea/
+.DS_Store
+
+# Ignorar archivos de entorno (¡muy importante para la seguridad!)
+.env

Dockerfile

@@ -0,0 +1,27 @@
+# Dockerfile
+
+# 1. Usar una imagen base oficial de Python
+# Usamos una versión "slim" para que la imagen sea más ligera
+FROM python:3.9-slim
+
+# 2. Establecer el directorio de trabajo dentro del contenedor
+WORKDIR /app
+
+# 3. Copiar el archivo de requerimientos al directorio de trabajo
+COPY requirements.txt .
+
+# 4. Instalar las dependencias de Python
+# --no-cache-dir reduce el tamaño de la imagen
+RUN pip install --no-cache-dir -r requirements.txt
+
+# 5. Copiar todo el código de la aplicación al directorio de trabajo
+COPY . .
+
+# 6. Exponer el puerto en el que se ejecutará la aplicación
+# Hugging Face Spaces espera que la app se ejecute en el puerto 7860, pero con Docker se puede remapear. 
+# Usaremos el 8000 que es el estándar de uvicorn.
+EXPOSE 8000
+
+# 7. Comando para ejecutar la aplicación cuando se inicie el contenedor
+# --host 0.0.0.0 es crucial para que sea accesible desde fuera del contenedor
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -1,12 +1,96 @@
----
-title: My Api Fastapi
-emoji: 🌖
-colorFrom: indigo
-colorTo: blue
-sdk: docker
-pinned: false
-license: mit
-short_description: Como tener una pi en la nubre, despliegue con fast api
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+---
+title: Mi API Completa con FastAPI
+emoji: 🚀
+colorFrom: blue
+colorTo: green
+sdk: docker
+app_port: 8000
+---
+
+# 🚀 Mi API Completa con FastAPI
+
+Este es un Space de demostración para una API creada con FastAPI que incluye todos los métodos HTTP comunes.
+
+La API se ejecuta dentro de un contenedor Docker y te permite gestionar una lista de ítems.
+
+## Documentación Interactiva de la API
+
+FastAPI genera automáticamente una documentación interactiva. Puedes acceder a ella agregando `/docs` a la URL de este Space.
+
+- **Swagger UI**: [URL_DE_TU_SPACE/docs](URL_DE_TU_SPACE/docs)
+- **ReDoc**: [URL_DE_TU_SPACE/redoc](URL_DE_TU_SPACE/redoc)
+
+## Cómo usar los Endpoints
+
+Puedes usar `curl` o cualquier cliente HTTP para interactuar con la API. Reemplaza `URL_DE_TU_SPACE` con la URL de tu aplicación.
+
+### `GET /items` - Obtener todos los ítems
+```bash
+curl -X 'GET' 'URL_DE_TU_SPACE/items' -H 'accept: application/json'
+```
+
+### POST /items - Crear un nuevo ítem
+```bash
+
+curl -X 'POST' \
+  'URL_DE_TU_SPACE/items' \
+  -H 'accept: application/json' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "id": 3,
+    "name": "Monitor Ultrawide",
+    "description": "Un monitor de 34 pulgadas",
+    "price": 499.99
+  }'
+```
+### GET /items/{item_id} - Obtener un ítem por ID
+```bash
+
+curl -X 'GET' 'URL_DE_TU_SPACE/items/1' -H 'accept: application/json'
+PUT /items/{item_id} - Actualizar un ítem completamente
+Bash
+
+curl -X 'PUT' \
+  'URL_DE_TU_SPACE/items/1' \
+  -H 'accept: application/json' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "id": 1,
+    "name": "Laptop Gamer",
+    "description": "Un potente portátil con RTX 4080",
+    "price": 2500.00
+  }'
+```
+### DELETE /items/{item_id} - Eliminar un ítem
+```bash
+
+curl -X 'DELETE' 'URL_DE_TU_SPACE/items/2' -H 'accept: application/json'
+```
+### Cómo Subirlo a Hugging Face Spaces
+
+1.  **Crea una cuenta** en [Hugging Face](https://huggingface.co/).
+2.  Ve a tu perfil y haz clic en **"New Space"**.
+3.  Dale un **nombre** a tu Space (por ejemplo, `mi-api-fastapi`).
+4.  Elige una **licencia**.
+5.  Selecciona **"Docker"** como el SDK del Space.
+6.  Haz clic en **"Create Space"**.
+7.  Sigue las instrucciones para subir tus archivos. La forma más sencilla es:
+    * Ir a la pestaña **"Files and versions"**.
+    * Hacer clic en **"Add file"** y luego **"Upload files"**.
+    * Arrastra y suelta los cuatro archivos (`main.py`, `requirements.txt`, `Dockerfile`, `README.md`) que creaste.
+    * Escribe un mensaje de commit (ej. "Versión inicial") y haz clic en **"Commit changes to main"**.
+
+Hugging Face detectará tu `Dockerfile` y `README.md`, construirá la imagen y desplegará tu aplicación. ¡En unos minutos, tu API estará en línea y lista para usar!
+### Probar en el local
+python -m venv venv
+.\venv\Scripts\Activate.ps1
+pip install -r requirements.txt
+uvicorn main:app --reload
+http://127.0.0.1:8000/docs
+
+### Docker
+docker build -t my_fast_api .
+docker run -d -p 8000:8000 --name mi-api-container my_fast_api
+
+http://127.0.0.1:8000/docs
+http://127.0.0.1:8000/items

app.py

@@ -0,0 +1,134 @@
+# main.py
+from fastapi import FastAPI, HTTPException, status
+from pydantic import BaseModel
+from typing import Optional, List
+
+# --- Modelos de Datos con Pydantic ---
+# Pydantic se encarga de la validación y serialización de datos
+
+class Item(BaseModel):
+    """Modelo base para un ítem. Todos los campos son requeridos."""
+    id: int
+    name: str
+    description: Optional[str] = None
+    price: float
+
+class UpdateItem(BaseModel):
+    """Modelo para actualizar un ítem. Todos los campos son opcionales."""
+    name: Optional[str] = None
+    description: Optional[str] = None
+    price: Optional[float] = None
+
+# --- Instancia de la Aplicación FastAPI ---
+app = FastAPI(
+    title="API de Ejemplo Completa",
+    description="Una API de ejemplo con todos los métodos HTTP para demostrar FastAPI, Docker y Hugging Face Spaces.",
+    version="1.0.0",
+)
+
+# --- "Base de Datos" en Memoria ---
+# Un diccionario simple para simular una base de datos.
+db = {
+    1: Item(id=1, name="Laptop", description="Un potente portátil para desarrollo", price=1200.50),
+    2: Item(id=2, name="Teclado Mecánico", description="Un teclado con switches Cherry MX Blue", price=150.75),
+}
+
+# --- Endpoints de la API ---
+
+@app.get("/", tags=["Root"])
+def read_root():
+    """Endpoint principal de bienvenida."""
+    return {"message": "¡Bienvenido a la API de ejemplo con FastAPI!"}
+
+# --- Métodos para la colección de ítems ---
+
+@app.get("/items", response_model=List[Item], tags=["Items"])
+def get_all_items():
+    """
+    GET: Obtiene una lista de todos los ítems en la base de datos.
+    """
+    return list(db.values())
+
+@app.post("/items", response_model=Item, status_code=status.HTTP_201_CREATED, tags=["Items"])
+def create_item(item: Item):
+    """
+    POST: Crea un nuevo ítem.
+    El ID del ítem en el cuerpo de la petición debe ser único.
+    """
+    if item.id in db:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail=f"El ítem con ID {item.id} ya existe."
+        )
+    db[item.id] = item
+    return item
+
+# --- Métodos para un ítem específico ---
+
+@app.get("/items/{item_id}", response_model=Item, tags=["Items"])
+def get_item_by_id(item_id: int):
+    """
+    GET: Obtiene un ítem específico por su ID.
+    """
+    if item_id not in db:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"El ítem con ID {item_id} no fue encontrado."
+        )
+    return db[item_id]
+
+@app.put("/items/{item_id}", response_model=Item, tags=["Items"])
+def update_item_completely(item_id: int, item: Item):
+    """
+    PUT: Actualiza un ítem completamente.
+    Reemplaza toda la información del ítem existente con la nueva.
+    """
+    if item_id not in db:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"El ítem con ID {item_id} no fue encontrado."
+        )
+    # El ID no debe cambiar en una operación PUT
+    if item_id != item.id:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail="El ID del ítem en la URL no coincide con el ID en el cuerpo de la petición."
+        )
+    db[item_id] = item
+    return db[item_id]
+
+@app.patch("/items/{item_id}", response_model=Item, tags=["Items"])
+def update_item_partially(item_id: int, item_update: UpdateItem):
+    """
+    PATCH: Actualiza un ítem parcialmente.
+    Solo actualiza los campos proporcionados en el cuerpo de la petición.
+    """
+    if item_id not in db:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"El ítem con ID {item_id} no fue encontrado."
+        )
+    
+    stored_item_data = db[item_id].dict()
+    update_data = item_update.dict(exclude_unset=True) # Obtiene solo los campos que se enviaron
+    
+    updated_item_data = stored_item_data.copy()
+    updated_item_data.update(update_data)
+    
+    db[item_id] = Item(**updated_item_data)
+    return db[item_id]
+
+@app.delete("/items/{item_id}", status_code=status.HTTP_204_NO_CONTENT, tags=["Items"])
+def delete_item(item_id: int):
+    """
+    DELETE: Elimina un ítem por su ID.
+    Devuelve un código 204 sin contenido si tiene éxito.
+    """
+    if item_id not in db:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"El ítem con ID {item_id} no fue encontrado."
+        )
+    del db[item_id]
+    # No se devuelve contenido, solo el código de estado 204
+    return

requirements.txt

@@ -0,0 +1,3 @@
+# requirements.txt
+fastapi
+uvicorn[standard]