Repolode
Enviar
pypa

pypa/flit

Una herramienta sencilla para compilar y publicar paquetes y módulos de Python puro en PyPI con una configuración mínima.

Ver en GitHubSitio web
Estrellas
2,262
Forks
173
Issues abiertos
125
Último commit
hace 11 días

¿Qué es?

Flit empaqueta un único módulo o paquete de Python importable y lo sube a PyPI. Su objetivo es reducir la cantidad de decisiones que debe tomar quien mantiene el proyecto sobre el empaquetado y evitar errores habituales. El nombre del paquete en PyPI coincide con el nombre de importación, y los subpaquetes y archivos de datos que contiene se incluyen automáticamente.

El flujo de trabajo habitual consiste en añadir una versión y una docstring de una línea al módulo, ejecutar `flit init` para generar un archivo pyproject.toml y, después, ejecutar `flit publish`. La versión y la descripción se leen del propio módulo. Los scripts de línea de comandos y otros metadatos se configuran en pyproject.toml. Los archivos flit.ini antiguos se pueden convertir con un módulo auxiliar incluido.

Para el desarrollo local, `flit install` instala un paquete en un entorno, opcionalmente como enlace simbólico para que los cambios surtan efecto de inmediato. Quienes instalan un wheel publicado obtienen un paquete estándar, mientras que al instalar el sdist, pip usa Flit en un entorno temporal.

Funciones clave

  • 01Publica un único módulo o paquete en PyPI con su nombre de importación.
  • 02Lee la versión y la descripción del módulo para evitar duplicarlas.
  • 03Genera un archivo pyproject.toml con `flit init`.
  • 04Incluye automáticamente los subpaquetes y los archivos de datos.
  • 05Instala paquetes localmente para el desarrollo, opcionalmente como enlaces simbólicos.

Casos de uso

  • Publicar una biblioteca pequeña de Python puro en PyPI sin escribir setup.py.
  • Convertir un proyecto antiguo basado en flit.ini a pyproject.toml.
  • Configurar una instalación local editable de un paquete durante el desarrollo.

Inicio rápido

  1. 1

    Instala flit con pip

    python3 -m pip install flit
  2. 2

    Añade un docstring de una línea y __version__ a tu módulo

  3. 3

    Ejecuta flit init en el directorio del módulo para crear pyproject.toml

    flit init
  4. 4

    Sube tu paquete a PyPI

    flit publish

Antes de usarlo

  • Solo empaqueta un módulo o paquete importable cada vez.
  • Para distribuir módulos de Python 2, también deben importarse sin errores en Python 3.

Temas

#python#packaging#pypi#build-tool#pyproject

Preguntas frecuentes

¿Qué es flit?
Una herramienta sencilla para compilar y publicar paquetes y módulos de Python puro en PyPI con una configuración mínima. Flit empaqueta un único módulo o paquete de Python importable y lo sube a PyPI. Su objetivo es reducir la cantidad de decisiones que debe tomar quien mantiene el proyecto sobre el empaquetado y evitar errores habituales. El nombre del paquete en PyPI coincide con el nombre de importación, y los subpaquetes y archivos de datos que contiene se incluyen automáticamente.
¿flit es gratuito? ¿Qué licencia tiene?
flit es open source bajo la licencia BSD-3-Clause. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿flit sigue mantenido?
Mantenimiento activo. El último commit de flit fue el 27 oct 2026.
¿Para qué puedo usar flit?
Publicar una biblioteca pequeña de Python puro en PyPI sin escribir setup.py. Convertir un proyecto antiguo basado en flit.ini a pyproject.toml. Configurar una instalación local editable de un paquete durante el desarrollo.
¿Cómo se instala flit?
Instala flit con pip: python3 -m pip install flit Añade un docstring de una línea y __version__ a tu módulo Ejecuta flit init en el directorio del módulo para crear pyproject.toml: flit init Sube tu paquete a PyPI: flit publish
¿Dónde consigo flit?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/pypa/flit

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados