Manual de usuario de calibre, Publicación 2.73.0
Instale calibre usando el instalador binario. A continuación, abra una sesión de terminal y vaya al directorio del código de calibre previamente descargado, por ejemplo:
cd / home / kovid / work / calibre
calibre es el directorio que contiene los subdirectorios src y resources
El siguiente paso es establecer la variable de entorno CALIBRE _ DEVELOP _ FROM a la ruta absoluta del directorio src. Siguiendo el ejemplo anterior, sería / home / kovid / work / calibre / src. La manera de establecer variables de entorno depende de la distribución de Linux y la shell que esté utilizando.
Una vez que haya establecido la variable de entorno, abra una nueva sesión de terminal y compruebe que se ha establecido correctamente usando esta orden:
echo $ CALIBRE _ DEVELOP _ FROM
Al establecer esta variable de entorno, calibre cargará todo su código Python desde la ubicación especificada.
¡ Eso es todo! Ya está listo para empezar a modificar el código de calibre. Por ejemplo, abra el archivo src / calibre /__ init __. py en su editor favorito y añada la línea:
print(" Hello, world!")
cerca del inicio del archivo. Ahora ejecute la orden calibredb. La primera línea de salida deberá ser Hello, world!.
1.12.6 Mantener una instalación « normal » y otra de « desarrollo » de calibre en el mismo equipo
El árbol del código fuente de calibre es muy estable y rara vez se rompe, pero si siente la necesidad de ejecutar a partir del código fuente en una biblioteca de prueba separada y ejecutar la versión oficial de calibre en la biblioteca habitual, puede lograr esto fácilmente usando archivos. bat o scripts de shell para ejectuar calibre. El siguiente ejemplo muestra cómo hacer esto en Windows utilizando archivos. bat( las instrucciones para otras plataformas son las mismas, sólo tiene que utilizar un script de shell en lugar de un archivo. bat)
Para ejecutar la versión oficial de calibre con la biblioteca habitual: calibre-normal. bat::. calibre. exe "--with-library = C:\ path \ to \ everyday \ library folder "
calibre-dev. bat::.
set CALIBRE _ DEVELOP _ FROM = C:\ path \ to \ calibre \ checkout \ src calibre. exe "--with-library = C:\ path \ to \ test \ library folder "
1.12.7 Consejos de depuración
Python es un lenguaje de programación dinámico con excelentes prestaciones para la introspección. Kovid escribió el código central de calibre sin siquiera utilizar un depurador. Hay varias estrategias para depurar el código de calibre:
Usar sentencias de impresión
Ésta es la forma favorita de Kovid para depurar. Basta con insertar sentencias de impresión en los puntos de interés y ejecutar el programa en la terminal. Por ejemplo, puede iniciar la interfaz gráfica desde la terminal como:
1.12. Configurar un entorno de desarrollo de calibre 285