Secuencias de comandos de Marionette avanzadas
Desarrolladores avanzados de Marionette pueden crear nodos personalizados para usar en sus propios trabajos o para distribuir a otros. Consulte la página principal de wiki Desarrolladores: developer.vectorworks.net para información adicional sobre la creación de nodos de Marionette.
Desarrolladores avanzados pueden usar una variedad de bibliotecas de Python. Durante el desarrollo, diferentes paquetes de bibliotecas de Python pueden ser probados para asegurar que se está usando el mejor para la secuencia de comandos correspondiente. Paquetes disponibles están enumerados en la página Desarrollador de wiki (para acceso rápido, haga clic en Repositorio de bibliotecas de Python desde la sección Contenido de las preferencias de Marionette); es más, se puede solicitar la carga de paquetes específicos por parte de Vectorworks.
En los nodos de Marionette, se puede hacer referencia a los paquetes de bibliotecas de Python incluidos en la página del desarrollador de Vectorworks. El paquete correspondiente para la plataforma y versión especificados es automáticamente descargado al ejecutar la secuencia de comandos por usuarios de la secuencia de comandos.
Hacer referencia a una biblioteca de Python
Para hacer referencia a un paquete de biblioteca de Python en el nodo de Marionette personalizado, el siguiente sintaxis de constructor de Marionette.Node especifica las dependencias de versión y paquete para el nodo:
this.CustomNode("CustomNodeName", "OptionalLocalizedName", "OptionalNodeVersionNumber", [('Geopy', '2.2.0'), ('scipy', '1.7.3')])
La sección entre corchetes del sintaxis de ejemplo ilustra cómo especificar dos paquetes de Python diferentes de los que el nodo depende, junto con un número de versión opcional para cada uno.
Si la biblioteca de Python que se necesita no está incluida en el servidor de Vectorworks, usar la página web de wiki Desarrollador descrita más arriba para enviar un correo electrónico a Vectorworks sobre el paquete que se requiere. El equipo de Marionette hará el paquete disponible desde el servidor. Ya que las dependencias de Python siempre están presentes e instaladas a pedido, se puede tener tranquilidad que el nodo personalizado funcionará correctamente en todas las versiones.
Instalación de biblioteca de Python
Durante la ejecución de la secuencia de comandos, si el paquete de Python de referencia ya está instalado, se ejecuta la secuencia de comandos.
Si el paquete de biblioteca de Python aún no ha sido instalado, el usuario de la secuencia de comandos tiene la oportunidad de instalar el paquete automáticamente desde los servidores de Vectorworks.
Para instalar archivos de biblioteca de Python requeridos:
Si Marionette detecta que un archivo de biblioteca debe ser instalado desde los servidores de Vectorworks, se abre el cuadro de diálogo Instalar paquetes de Python.
Los paquetes requeridos son enumerados junto con sus detalles. Haga clic en Sí para instalar los paquetes en una carpeta PythonExternals separada dentro de la carpeta de usuario; si la carpeta no existe, es creada automáticamente.
Cuando la instalación concluye, se abre el cuadro de diálogo Detalles de instalación. Haga clic en Detalles para visualizar un archivo de texto con los resultados de la instalación; éste muestra qué paquetes fueron instalados, dónde fueron instalados y el éxito de la instalación.
Una vez que los paquetes de biblioteca de Python requeridos han sido instalados correctamente, se ejecuta la secuencia de comandos.
Instalar bibliotecas de Python manualmente
|
Modo |
Herramienta |
Conjunto de herramientas |
|
Preferencias
|
Marionette
|
Básico |
Durante el desarrollo, ciertas bibliotecas de Python pueden ser instaladas manualmente para estar seguro que se está usando la mejor para el nodo personalizado que se está escribiendo.
Para instalar una biblioteca de Python:
Haga clic en la herramienta y el modo.
Se abre el cuadro de diálogo Preferencias de Marionette.
Haga clic en Repositorio de bibliotecas de Python desde la sección Contenido para ver qué bibliotecas de Python están disponibles desde el servidor de Vectorworks.
Haga clic Instalar biblioteca de Python.
Se abre el cuadro de diálogo Ubicación de biblioteca de Python.
Ingrese la URL del archivo de biblioteca de Python para instalar el archivo de biblioteca que está presente en esa ubicación.
Probe la secuencia de comandos; si el archivo de biblioteca es útil y se requiere para el desarrollo personalizado de Marionette del usuario, solicite que sea agregado al servidor de Vectorworks enviando un correo electrónico a Vectorworks desde el sitio wiki Desarrollador.
Para ver qué archivos y paquetes de biblioteca están instalados, consulte el archivo InstallOutput.txt ubicado dentro de la carpeta Python Externals en la carpeta de usuario.
