AST Access?

[pbronez]

I'm looking for a way to access the parsed representation of a Typst doc from Python. Does this library provide that? If not, would you be open to a PR that adds that functionality?

I want to introspect Typst templates to identify the parameters needed to compile them. I will use this to dynamically create a user-facing form for the template so a user can provide the required information and get a compiled PDF directly.

[pbronez]

Looks like the query.rs module is relevant, but this functionality doesn't appear to be documented.

[messense]

query is documented in

typst-py/python/typst/__init__.pyi

Lines 264 to 290 in 42fa8b2

	def query(
	input: Input,
	selector: str,
	field: Optional[str] = None,
	one: bool = False,
	format: Optional[Literal["json", "yaml"]] = None,
	root: Optional[Input] = None,
	font_paths: Union[Fonts, List[Input]] = [],
	ignore_system_fonts: bool = False,
	sys_inputs: Dict[str, str] = {},
	package_path: Optional[PathLike] = None,
	) -> str:
	"""Query a Typst document.
	Args:
	input: .typ file bytes or path to project's main .typ file.
	selector (str): Typst selector like `<label>`.
	field (Optional[str], optional): Field to query.
	one (bool, optional): Query only one element.
	format (Optional[str]): Output format, `json` or `yaml`.
	root (Optional[PathLike], optional): Root path for the Typst project.
	font_paths (Union[Fonts, List[Input]]): Folders with fonts.
	ignore_system_fonts (bool): Ignore system fonts
	sys_inputs (Dict[str, str]): string key-value pairs to be passed to the document via sys.inputs
	package_path: Optional[PathLike]: Path to load local packages from
	Returns:
	str: Return the query result.
	"""