compile_file#
Import |
|
Defined in |
|
Install |
|
Since |
0.1 |
Stability |
Public: follows semantic versioning. Below 1.0, a minor release may change it, and the CHANGELOG says how. |
- scenet.pipeline.compile_file(path, *, library=None, metrics=None)[source]#
Compile one panel from a file.
- Parameters:
path (
Path) – A*.panel.yamldocument.library (
PuppetLibrary|None) – Characters to draw from. Defaults to the two shipped puppets.metrics (
FontMetrics|None) – Font to measure lettering against.
- Return type:
- Returns:
The compiled panel.
- Raises:
FileReadError – The file cannot be read: a
MissingFileError, also aFileNotFoundError, when it is not there.PanelSyntaxError – The document is malformed or invalid, or a file it names cannot be read or is not what it says.
UnknownPuppetError – A cast member references a puppet the library lacks.
UnknownPoseError – A cast member’s
poseis one its puppet does not declare.UnknownExpressionError – A cast member’s
expressionis one its puppet does not declare.LayoutError – The staging cannot be satisfied: a depth order that is a cycle, or a panel with no cast to place.
BalloonPlacementError – A balloon or a caption has no legal position.
SfxPlacementError – A sound effect has no legal position.
Note
Files the document names are read from the folder it is in, whatever the working directory. One panel only, as
compile_source.Example
>>> from pathlib import Path >>> from tempfile import TemporaryDirectory >>> from scenet import compile_file >>> with TemporaryDirectory() as folder: ... path = Path(folder) / "hello.panel.yaml" ... _ = path.write_text("cast: {a: {reference: alice}}", encoding="utf-8") ... result = compile_file(path) >>> [actor.id for actor in result.core.actors] ['a']
See also
compile_source, for text.compile_book_file, for any document and its pages.