# Cadena de herramientas de Python

La compatibilidad con Python es experimental. Elide ejecuta Python 3.13 con su biblioteca estándar y herramientas de
paquetes opcionales. El formateo de Python y el descubrimiento de pruebas con `elide test` siguen sin estar disponibles.

| Tarea | Comando | Estado |
| --- | --- | --- |
| Añadir Python a una instalación | `elide setup python` | Disponible |
| Ejecutar un script, `-c` o `-m` | `elide python ...`, `elide run app.py` | Disponible |
| Ejecutar un punto de entrada de `pyproject.toml` | `elide run NAME` | Disponible |
| Usar paquetes de un entorno virtual | `VIRTUAL_ENV=.venv elide python app.py` | Disponible |
| Ejecutar unittest o pytest | `elide python -m unittest`, `elide python -m pytest` | Disponible |
| Instalar paquetes de PyPI | `elide install --ecosystems=pypi`, `elide uv install` | Requiere el componente de Python y pytools |
| Descubrir pruebas de Python | `elide test` | No disponible |
| Formato, LSP, plantilla de `elide init` | | No disponible |

## Añadir Python

Python es un componente opcional:

```bash
elide setup python
```

Sin él, los comandos de Python imprimen
`Python support is not installed. Run 'elide setup python' to add it.` y terminan con el código `2`. Consulte
[Python con Elide](/docs/python) para los canales y la instalación con gestores de paquetes.

## Ejecutar Python

`elide python` acepta los mismos argumentos que `python`; `elide run` y `elide app.py` sin subcomando también ejecutan
archivos `.py`:

```bash
elide python app.py --name Elide
elide python -m json.tool input.json
elide run app.py
```

Las opciones del intérprete (`-I`, `-B`, `-u`, `-W`, ...) se enumeran en
[Python con Elide](/docs/python#interpreter-options).

## Ejecutar scripts del proyecto

`elide run NAME` ejecuta un punto de entrada de `[project.scripts]` del `pyproject.toml` del directorio actual. No se
necesita `elide.pkl`.

```toml
# pyproject.toml
[project]
name = "greet"
version = "0.1.0"
requires-python = ">=3.13"

[project.scripts]
greet = "greet.cli:main"
```

```python
# greet/cli.py
import sys


def greeting(name: str) -> str:
    return f"Hello, {name}!"


def main() -> int:
    print(greeting(sys.argv[1] if len(sys.argv) > 1 else "world"))
    return 0
```

```bash
elide run greet Elide
```

```terminaloutput
Hello, Elide!
```

`elide greet Elide` hace lo mismo. Los argumentos que siguen al nombre van a `sys.argv`, y el entero que devuelve la
función es el código de salida. Tiene prioridad un archivo llamado `greet`, un script de `elide.pkl` o un script de
`package.json` con el mismo nombre; consulte [Configurar un proyecto](/docs/projects#add-a-script).

## Paquetes

Use `elide install --ecosystems=pypi` para las dependencias declaradas, o `elide uv install PACKAGE`.
Los paquetes van al entorno automático del proyecto, sin activación. Consulte
[Paquetes y entornos virtuales](/docs/python-packages).

## Pruebas

Ejecute unittest o pytest mediante `elide python -m`; consulte [Pruebas de Python](/docs/python-testing). `elide test` solo
ejecuta pruebas de JavaScript, TypeScript y JUnit.

## Ejemplos

- [Python que llama a JavaScript](/docs/code-samples#python-calling-javascript)
- [JavaScript que importa Python](/docs/code-samples#javascript-importing-python)
- [Script de Python](/docs/code-samples#python-script)

`elide init` no tiene plantilla de Python.

## Limitaciones conocidas

- **Extensiones en C**: algunos módulos de extensión en C no se cargan.
- **pip**: no se incluye; `elide python -m pip` falla con `No module named pip`.
- Más información: [Python con Elide](/docs/python#known-limitations).
