Versión mínima de la política de dependencias #
A los efectos de este documento, 'versión secundaria' tiene el sentido de SemVer (mayor, menor, parche) e incluye versiones tanto principales como secundarias. Para proyectos que usan control de versiones basado en fechas, cada lanzamiento es una 'versión secundaria'.
Matplotlib sigue NEP 29 .
Python y NumPy #
Matplotlib admite:
Todas las versiones secundarias de Python se lanzaron 42 meses antes del proyecto y, como mínimo, las dos versiones secundarias más recientes.
Todas las versiones secundarias de
numpy
lanzadas en los 24 meses anteriores al proyecto y, como mínimo, las últimas tres versiones secundarias.
En setup.py
, la python_requires
variable debe establecerse en la versión mínima admitida de Python. Todas las versiones secundarias admitidas de Python deben estar en la matriz de prueba y tener artefactos binarios creados para el lanzamiento.
La compatibilidad mínima con la versión de Python y NumPy debe ajustarse hacia arriba en cada versión principal y secundaria, pero nunca en una versión de parche.
Consulte también la Lista de versiones de dependencia .
Dependencias de Python #
Para las dependencias de Python, deberíamos admitir al menos:
- con extensiones compiladas
versiones menores lanzadas inicialmente en los 24 meses anteriores a nuestra fecha de lanzamiento planificada o la más antigua que admita nuestro Python + NumPy mínimo
- sin extensiones compiladas
versiones menores lanzadas inicialmente en los 12 meses anteriores a nuestra fecha de lanzamiento planificada o la más antigua que admita nuestro Python mínimo.
Solo eliminaremos estas dependencias cuando necesitemos nuevas funciones o las versiones anteriores ya no admitan nuestro NumPy o Python mínimo.
Dependencias de prueba y documentación #
Dado que estos paquetes solo se necesitan para probar o crear los documentos y no los necesitan los usuarios finales, podemos ser más agresivos a la hora de dejar de admitir versiones anteriores. Sin embargo, debemos tener cuidado de no sobrepasar lo que admiten los empaquetadores posteriores (ya que la mayoría ejecuta las pruebas y crea la documentación como parte del proceso de empaquetado).
Admitiremos al menos versiones secundarias de las dependencias de desarrollo lanzadas en los 12 meses anteriores a nuestro lanzamiento planificado.
Solo los actualizaremos según sea necesario o las versiones ya no admitan nuestro Python y NumPy mínimos.
Dependencias del sistema y C #
Para dependencias del sistema o C (FreeType, GUI frameworks, LaTeX, Ghostscript, FFmpeg) soporte tan antiguo como práctico. Estos pueden ser difíciles de instalar para los usuarios finales y queremos que se puedan usar en tantos sistemas como sea posible. Los revisaremos caso por caso.
Lista de versiones de dependencia #
La siguiente lista muestra las versiones mínimas de las dependencias de Python y NumPy para diferentes versiones de Matplotlib. Siga los enlaces para obtener la especificación completa de las dependencias.
matplotlib |
Pitón |
NumPy |
---|---|---|
3.8 |
1.19.0 |
|
3.7 |
1.17.0 |
|
3.7 |
1.16.0 |
|
3.6 |
1.15.0 |
|
3.6 |
1.11.0 |
|
3.6 |
1.11.0 |
|
3.5 |
1.10.0 |
|
2.7, 3.4 |
1.7.1 |
|
2.7, 3.4 |
1.7.1 |
|
2.7, 3.4 |
1.7.1 |
|
2.7, 3.4 |
1.6 |
|
2.6, 3.3 |
1.6 |
|
2.6, 3.3 |
1.5 |
|
1.2 |
2.6, 3.1 |
1.4 |
1.1 |
2.4 |
1.1 |
1.0 |
2.4 |
1.1 |