En esta sección veremos como contribuir en el desarrollo de pilas, mostrando las herramientas de desarrollo y dando algunas recomendaciones.
Actualmente utilizamos Git junto a los servicios de github.
Para contribuir en el desarrollo de pilas necesitas una cuenta de usuario en github, nuestros proveedores del servicio de repositorios.
La dirección de acceso web al respositorio es:
Ten en cuenta que el servicio github es gratuito, y solo lleva unos minutos registrarse.
Para obtener la última versión tienes que ejecutar el siguiente comando desde un terminal:
git clone http://github.com/hugoruscitti/pilas
Luego aparecerá un directorio llamado pilas, con el contenido completo del repositorio.
Ingresa en el directorio pilas, ejecuta el comando:
python bin/pilas
debería aparecer en pantalla el asistente de primer inicio.
Si sos desarrollador, la forma de instalación mas recomendable es mediante el comando develop. Esta opción es útil porque te permite mentener actualizada la biblioteca en todo momento.
Para usar esta opción de instalación tienes que ejecutar el siguiente comando:
sudo python setup.py develop
Ten en cuenta que a partir de ahora, cuando uses pilas en el sistema, se leerá el código directamente desde ese directorio en donde has clonado la biblioteca.
Dado que pilas está creciendo, es una buena idea mantener tu copia del motor actualizada.
Para ello tienes que ingresar en el directorio pilas y ejecutar el siguiente comando de manera periódica:
git pull
Usamos el modelo de trabajo de github, haciendo forks y pull requests.
Si quieres obtener mas detalles te recomiendo ver el siguiente artículo:
Definición de la version actual de pilas y funciones para compararla.
Contiene la versión actual de pilas.
Compara dos versiones de pilas.
Sus posibles retornos son
Parámetros: |
|
---|
Compara la versión actual de pilas con una que se pasa como parámetro
Sus posibles retornos son:
Parámetros: | v (str) – versión a comparar con la actual. |
---|
Utilidades de desarrollo para Pilas.
Por defecto la PendingDeprecationWarning en pilas esta en modo once y DeprecationWarning en error.
Si se desea que todos los metodos desaconsejados puedan utilizarse, puede llamar a la funcion pilas.dev.utilizar_desaconsejados(True) con lo cual los DeprecationWarning pasan a estado once.
Para manejo avanzado de estas carasterísticas dirijase a documentación del módulo warnings
Decorador utilizado para marcar una función como deprecada
Las excepciones que puede lanzar este decorador son:
Parámetros: |
|
---|
Lanza la correcta exception/warning de anuncio de que algo está en desuso.
Las excepción/warning que puede lanzar esta función son:
Parámetros: |
|
---|
Permite que se utilicen atributos, métodos y funciones que estan desaconsejados en esta versión.
NOTA: si usted habilita los desaconsejados, los utiliza y luego los deshabilita; estos ya estaran disponibles. Esta función debería llamarse lo mas temprano posible es un juego y una sola ves.
Parámetros: | usar (bool) – Si se debe o no permitir que los atributos deprecados puedan utilizarse. Si el usar es False, todo lo desaconsejado lanza una excepción; de lo contrario, si usar es True solo se lanza un warning. |
---|