Generator-Objekt (generator)

Dieses Objekt wird von generator() zurückgegeben und enthält einen Generator, der verwendet wird, um Dateien von einem Typ in einen anderen durch ein ausführbares Programm zu transformieren (z.B. idl-Dateien in Quellcode und Header).

Zurückgegeben von

Generator-Objekt-Objekte werden von den folgenden Funktionen und Methoden zurückgegeben

Generator-Objekt-Methoden

generator.process()

Nimmt eine Liste von Dateien, bewirkt deren Verarbeitung und gibt ein Objekt mit dem Ergebnis zurück, das dann beispielsweise in eine Build-Zieldefinition übergeben werden kann.

Signatur

# Takes a list of files, causes them to be processed and returns an object containing the result
generated_list process(
  str | file | custom_tgt | custom_idx | generated_list source...,  # List of sources to process

  # Keyword arguments:
  env                : env | list[str] | dict[str]  # environment variables to set, such as
  extra_args         : list[str]                    # If present, will be used to replace an entry `@EXTRA_ARGS@` in the argument list
  preserve_path_from : str                          # If given, specifies that the output files need to maintain their directory structure
)

Argumente

Die Methode akzeptiert zwischen 1 und unendlich variablen Argumenten (source...) vom Typ str | file | custom_tgt | custom_idx | generated_list.

Liste der zu verarbeitenden Quellen.

Die Methode generator.process() akzeptiert die folgenden Schlüsselwortargumente

Name Typ Beschreibung Schlagwörter
env env | list[str] | dict[str]

Umgebungsvariablen, die gesetzt werden sollen, wie z.B. {'NAME1': 'value1', 'NAME2': 'value2'} oder ['NAME1=value1', 'NAME2=value2'], oder ein env-Objekt, das eine ausgefeiltere Verwaltung der Umgebung ermöglicht.

(seit 1.3.0)
extra_args list[str]

Falls vorhanden, wird es verwendet, um einen Eintrag @EXTRA_ARGS@ in der Argumentenliste zu ersetzen.
preserve_path_from str

Wenn angegeben, wird spezifiziert, dass die Ausgabedateien ihre Verzeichnisstruktur innerhalb des temporären Verzeichnisses des Ziels beibehalten müssen. Der gebräuchlichste Wert dafür ist meson.current_source_dir(). Mit diesem Wert wird bei der Verarbeitung einer Datei namens subdir/one.input eine Datei {target private directory}/subdir/one.out generiert, im Gegensatz zu {target private directory}/one.out.

(seit 0.45.0)

Die Ergebnisse der Suche sind