# python: Detección de configuración regional y middleware
URL: https://generaltranslation.com/es/docs/python/guides/middleware.mdx
---
title: Detección de configuración regional y middleware
description: Cómo funciona la detección de configuración regional en Flask y FastAPI, y cómo personalizarla
---

El middleware de Python de GT detecta automáticamente la configuración regional del usuario en cada solicitud y la pone a disposición de [`t()`](/docs/python/api/t) y [`get_locale()`](/docs/python/api/get-locale). Esta guía describe cómo funciona la detección y presenta patrones avanzados para personalizarla.

<Callout>
  Para una introducción básica a la detección personalizada de la configuración regional, consulta el [tutorial sobre detección personalizada de la configuración regional](/docs/python/tutorials/custom-locale-detection). Esta guía desarrolla esos patrones.
</Callout>

## Comportamiento predeterminado

Cuando no se proporciona ningún callback `get_locale`, GT analiza la cabecera `Accept-Language`, la compara con las `locales` configuradas y, si no encuentra coincidencias, usa `default_locale`:

<Tabs items={['Flask', 'FastAPI']}>
  <Tab value="Flask">
    ```python
    from flask import Flask
    from gt_flask import initialize_gt

    app = Flask(__name__)
    initialize_gt(app, default_locale='en', locales=['es', 'fr'])
    ```
  </Tab>

  <Tab value="FastAPI">
    ```python
    from fastapi import FastAPI
    from gt_fastapi import initialize_gt

    app = FastAPI()
    initialize_gt(app, default_locale='en', locales=['es', 'fr'])
    ```
  </Tab>
</Tabs>

## Encadenamiento de estrategias de detección

En producción, normalmente te convendrá probar varias fuentes por orden de prioridad. Pasa un callback `get_locale` a `initialize_gt`:

<Tabs items={['Flask', 'FastAPI']}>
  <Tab value="Flask">
    ```python
    from flask import Flask
    from gt_flask import initialize_gt

    app = Flask(__name__)

    def get_locale(request) -> str:
        # 1. Parámetro de consulta explícito
        lang = request.args.get('lang')
        if lang:
            return lang

        # 2. Cookie (preferencia guardada del usuario)
        locale = request.cookies.get('locale')
        if locale:
            return locale

        # 3. Prefijo en la ruta de la URL (/es/about)
        parts = request.path.strip('/').split('/')
        if parts and parts[0] in ('es', 'fr', 'de'):
            return parts[0]

        # 4. Cabecera Accept-Language
        accept = request.headers.get('Accept-Language', '')
        if accept:
            return accept.split(',')[0].split(';')[0].strip()

        return 'en'

    initialize_gt(app, default_locale='en', locales=['es', 'fr', 'de'], get_locale=get_locale)
    ```
  </Tab>

  <Tab value="FastAPI">
    ```python
    from fastapi import FastAPI, Request
    from gt_fastapi import initialize_gt

    app = FastAPI()

    def get_locale(request: Request) -> str:
        # 1. Parámetro de consulta explícito
        lang = request.query_params.get('lang')
        if lang:
            return lang

        # 2. Cookie (preferencia guardada del usuario)
        locale = request.cookies.get('locale')
        if locale:
            return locale

        # 3. Prefijo en la ruta de la URL (/es/about)
        parts = request.url.path.strip('/').split('/')
        if parts and parts[0] in ('es', 'fr', 'de'):
            return parts[0]

        # 4. Cabecera Accept-Language
        accept = request.headers.get('accept-language', '')
        if accept:
            return accept.split(',')[0].split(';')[0].strip()

        return 'en'

    initialize_gt(app, default_locale='en', locales=['es', 'fr', 'de'], get_locale=get_locale)
    ```
  </Tab>
</Tabs>

## Persistir la configuración regional con cookies

Permite que los usuarios elijan su idioma y recuerda su elección:

<Tabs items={['Flask', 'FastAPI']}>
  <Tab value="Flask">
    ```python
    from flask import request, make_response, jsonify

    @app.route('/api/set-language', methods=['POST'])
    def set_language():
        locale = request.json.get('locale', 'en')
        response = make_response(jsonify({'ok': True}))
        response.set_cookie('locale', locale, max_age=365 * 24 * 60 * 60)
        return response
    ```
  </Tab>

  <Tab value="FastAPI">
    ```python
    from fastapi import Request
    from fastapi.responses import JSONResponse

    @app.post('/api/set-language')
    async def set_language(request: Request):
        body = await request.json()
        locale = body.get('locale', 'en')
        response = JSONResponse({'ok': True})
        response.set_cookie('locale', locale, max_age=365 * 24 * 60 * 60)
        return response
    ```
  </Tab>
</Tabs>

## Detección según el perfil de usuario

En las aplicaciones autenticadas, obtén la configuración regional a partir de las preferencias del usuario:

```python
def get_locale(request) -> str:
    user = get_current_user(request)  # tu lógica de autenticación
    if user and user.preferred_locale:
        return user.preferred_locale

    # Usar cookie o cabecera como alternativa
    return request.cookies.get('locale') or 'en'
```

## Leer la configuración regional resuelta

Usa [`get_locale()`](/docs/python/api/get-locale) en cualquier punto del manejo de la solicitud para consultar la configuración regional resuelta:

```python
from gt_flask import get_locale  # o gt_fastapi

@app.route('/api/info')
def info():
    return { 'locale': get_locale() }
```


## Próximos pasos

* [Tutorial sobre detección personalizada de la configuración regional](/docs/python/tutorials/custom-locale-detection) — introducción básica
* [Referencia de la API `get_locale()`](/docs/python/api/get-locale)
* [Patrones de traducción de cadenas](/docs/python/guides/strings) — cómo traducir contenido