transición

Informar un problema Ver código fuente

Compilación nocturna · 9.2 · 9.1 · 9.0 · 8.7 · 8.6

Representa una transición de configuración a través de un borde de dependencia. Por ejemplo, si //package:foo depende de //package:bar con una transición de configuración, la configuración de //package:bar (y sus dependencias) será la configuración de //package:foo más los cambios especificados por la función de transición.

Miembros

• transition
• and_then

transición

transition transition(*, implementation, inputs, outputs)

Es una transición que lee un conjunto de parámetros de configuración de compilación de entrada y escribe un conjunto de parámetros de configuración de compilación de salida.

Ejemplo:

def _transition_impl(settings, attr):
    # This transition just reads the current CPU value as a demonstration.
    # A real transition could incorporate this into its followup logic.
    current_cpu = settings["//command_line_option:cpu"]
    return {"//command_line_option:compilation_mode": "dbg"}

build_in_debug_mode = transition(
    implementation = _transition_impl,
    inputs = ["//command_line_option:cpu"],
    outputs = ["//command_line_option:compilation_mode"],
)

Puedes averiguar más detalles aquí.

Parámetros

Parámetro	Descripción
implementation	callable; required La función que implementa esta transición. Esta función siempre tiene dos parámetros: settings y attr. El parámetro settings es un diccionario cuyo conjunto de claves se define con el parámetro inputs. Por lo tanto, para cada parámetro de configuración de compilación --//foo=bar, si inputs contiene //foo, settings tendrá una entrada settings['//foo']='bar'. El parámetro attr es una referencia a ctx.attr. Esto le da a la función de implementación acceso a los atributos de la regla para que sean posibles las transiciones parametrizadas por atributos. Esta función debe devolver un dict desde el identificador de configuración de compilación hasta el valor de configuración de compilación, lo que representa la transición de configuración: para cada entrada en el dict devuelto, la transición actualiza ese parámetro de configuración al valor nuevo. Todos los demás parámetros de configuración permanecen sin cambios. Esta función también puede devolver un list de dict o un dict de dict en el caso de una transición dividida.
inputs	sequence de strings; obligatorio Lista de parámetros de configuración de compilación que puede leer esta transición. Esta se convierte en el conjunto de claves del parámetro de configuración del parámetro de la función de implementación.
outputs	sequence de strings; obligatorio Lista de parámetros de configuración de compilación que puede escribir esta transición. Debe ser un superconjunto del conjunto de claves del diccionario que devuelve esta transición.

and_then

transition transition.and_then(transition)

Devuelve una nueva transición que aplica esta transición seguida de la proporcionada. La segunda transición lee la configuración de compilación que produjo la primera. Las transiciones originales no se modifican. El resultado es en sí mismo una transición y se puede componer aún más.

Una composición se puede usar como regla o transición de atributo en cualquier lugar donde se puedan usar sus transiciones de componentes. Como máximo, una de las transiciones compuestas puede segmentar la configuración de ejecución (p.ej., config.exec). Cuando dos transiciones de la cadena dividen la configuración, el resultado tiene el producto cartesiano de sus divisiones; la clave de cada división combinada es la concatenación separada por comas de las claves de los componentes.

Parámetros

Parámetro	Descripción
transition	transition: obligatorio Es la transición que se aplicará después de esta.