vprof

vprof

vprof es un paquete de Python que proporciona visualizaciones ricas e interactivas para diversas características del programa Python, como el tiempo de ejecución y el uso de memoria. Es compatible con Python 3.4+ y se distribuye bajo licencia BSD.

El proyecto está en desarrollo activo y es posible que algunas de sus características no funcionen como se esperaba.

Capturas de pantalla

Contribuyendo

¡Se recomiendan encarecidamente todas las contribuciones! Puede agregar nuevas funciones, informar y corregir errores existentes y escribir documentos y tutoriales. ¡No dudes en abrir un problema o enviar una solicitud de extracción!

Requisitos previos

Dependencias para construir vprof desde el código fuente:

• Pitón 3.4+

• pip

• npm >= 3.3.12

Se requiere npm para compilar vprof únicamente a partir de fuentes.

Dependencias

Todas las dependencias de los módulos Python y npm se enumeran en package.json y requirements.txt .

Instalación

vprof se puede instalar desde PyPI

 instalación de pip vprof

Para compilar vprof a partir de fuentes, clone este repositorio y ejecute

 python3 setup.py deps_install && python3 setup.py build_ui && python3 setup.py instalar

Para instalar solo las dependencias vprof , ejecute

 python3 setup.py deps_install

Uso

 vprof -c <config> <fuente>

<config> es una combinación de modos admitidos:

• c - gráfico de llama de CPU

  ️

  No disponible para Windows #62

Muestra el gráfico de llamas de CPU para <src> .

• p - perfilador

Ejecuta el generador de perfiles Python integrado en <src> y muestra los resultados.

• m - gráfico de memoria

Muestra los objetos que CPython GC rastrea y que se dejan en la memoria después de la ejecución del código. También muestra el uso de la memoria del proceso después de la ejecución de cada línea de <src> .

• h - mapa de calor del código

Muestra todo el código ejecutado de <src> con tiempos de ejecución de líneas y recuentos de ejecución.

<src> puede ser un archivo fuente de Python (por ejemplo, testscript.py ) o una ruta al paquete (por ejemplo, myproject/test_package ).

Para ejecutar scripts con argumentos utilice comillas dobles

 vprof -c cmh "testscript.py --foo --bar"

Los modos se pueden combinar.

 vprof -c cm testscript.py

vprof también puede perfilar funciones. Para hacer esto, inicie vprof en modo remoto:

 vprof-r

vprof abrirá una nueva pestaña en el navegador web predeterminado y luego esperará las estadísticas.

Para perfilar una ejecución de función

 de vprof importar runnerdef foo(arg1, arg2):
    ...runner.run(foo, 'cmhp', args=(arg1, arg2), host='localhost', puerto=8000)

donde cmhp es el modo de creación de perfiles, host y port son el nombre de host y el puerto del servidor vprof iniciado en modo remoto. Las estadísticas obtenidas se mostrarán en una nueva pestaña del navegador web predeterminado, abierta con el comando vprof -r .

vprof puede guardar estadísticas de perfil en un archivo y representar visualizaciones desde un archivo guardado previamente.

 vprof -c cmh src.py --archivo de salida perfil.json

escribe el perfil en el archivo y

 vprof --archivo de entrada perfil.json

representa visualizaciones de un archivo previamente guardado.

Consulte vprof -h para obtener una lista completa de los parámetros admitidos.

Para mostrar la ayuda de la interfaz de usuario, presione h cuando se muestren las visualizaciones.

También puede consultar el directorio examples para obtener más ejemplos de perfiles.

Pruebas

 python3 setup.py test_python && python3 setup.py test_javascript && python3 setup.py e2e_test

Licencia

BSD