Secuencias de comandos avanzadas de Marionette
Los programadores informáticos avanzados de Marionette pueden crear nodos personalizados para utilizarlos en su propio trabajo o para distribuirlos a otras personas. Consulte la página principal del wiki para programadores: developer.vectorworks.net para obtener información adicional sobre la creación de nodos Marionette.
Los programadores informáticos avanzados pueden hacer uso de diversas bibliotecas Python. Durante el desarrollo, puede probar varios paquetes de bibliotecas Python para asegurarse de que está utilizando el mejor para su script. Los paquetes disponibles se incluyen en el wiki del desarrollador (para un acceso rápido, haga clic en Repositorio de bibliotecas Python en la sección Contenido de las preferencias de Marionette); además, puede solicitar que Vectorworks cargue allí paquetes específicos.
En tus nodos Marionette, puedes referenciar los paquetes biblioteca Python incluidos en la página del programador informático Vectorworks. El paquete apropiado para la plataforma y versión que especificó es descargado automáticamente en la ejecución de su secuencia de comandos por los usuarios de su secuencia de comandos.
Referenciación de una biblioteca Python
Para referenciar un paquete de biblioteca Python en su nodo Marionette personalizado, la siguiente sintaxis del constructor Marionette. Node especifica la versión y las dependencias del paquete para el nodo:
this.CustomNode("CustomNodeName", "OptionalLocalizedName", "OptionalNodeVersionNumber", [('Geopy', '2.2.0'), ('scipy', '1.7.3')])
La sección entre corchetes de la sintaxis de ejemplo ilustra cómo especificar dos paquetes Python diferentes de los que depende el nodo, junto con un número de versión opcional para cada uno.
Si la biblioteca Python que necesita no está incluida en el servidor de Vectorworks, use la página web del wiki del programador descrita anteriormente para enviar un mensaje de correo electrónico a Vectorworks sobre el paquete que necesita. El equipo de Marionette hará que el paquete esté disponible en el servidor. Dado que las dependencias de Python están siempre presentes y se instalan bajo demanda, puede estar seguro de que su nodo personalizado funcionará correctamente en todas las versiones.
Instalación de la biblioteca Python
Durante la ejecución del script, si el paquete Python referenciado ya está instalado, el script se ejecuta.
Si el paquete de librería Python aún no ha sido instalado, el usuario del script tiene la oportunidad de instalar el paquete automáticamente desde los servidores de Vectorworks.
Para instalar los archivos de biblioteca Python requeridos:
Si Marionette detecta que es necesario instalar un archivo de biblioteca desde los servidores de Vectorworks, se abre el cuadro de diálogo Instalar paquetes Python.
Se incluyen los paquetes necesarios, junto con sus detalles. Haga clic en Sí para instalar los paquetes en una carpeta PythonExternals separada dentro de la carpeta del usuario; si la carpeta no existe, se autogenerará.
Cuando finaliza la instalación, se abre el cuadro de diálogo Detalles de la instalación. Haga clic en Detalles para ver un archivo de texto con los resultados de la instalación; muestra qué paquetes se instalaron, dónde se instalaron y el éxito de la instalación.
Una vez que se han instalado correctamente los paquetes de bibliotecas Python necesarios, se ejecuta la secuencia de comandos.
Instalación manual de las bibliotecas Python
|
Modo |
Herramienta |
Conjunto de herramientas |
|
Preferencias
|
Marionette
|
Herramientas básicas |
Durante el desarrollo, puedes instalar manualmente ciertas librerías Python para asegurarte de que estás usando la mejor para el nodo personalizado que estás escribiendo.
Para instalar una librería Python:
Haga clic en la herramienta y modo.
Se abrirá el cuadro de diálogo Preferencias de Marionette.
Haga clic en Repositorio de bibliotecas Python en la sección Contenido para ver qué bibliotecas Python están disponibles en el servidor de Vectorworks.
Haga clic en Instalar biblioteca Python.
Se abre el cuadro de diálogo Ubicación de la biblioteca Python.
Introducir la dirección URL del archivo de biblioteca Python para instalar el archivo de biblioteca que está presente en esa ubicación.
Pruebe la secuencia de comandos; si el archivo de biblioteca le resulta útil y lo necesita para su desarrollo personalizado de Marionette, solicite que se añada al servidor de Vectorworks poniendo un mensaje de correo electrónico a Vectorworks desde el sitio wiki del programador.
Para ver qué archivos de biblioteca y paquetes tiene instalados, consulte el archivo InstallOutput.txt localizado dentro de la carpeta Python Externals en su carpeta del usuario.
