pptx/transition-timing--fast-transition

Metadata

XPath assertions

Render assertions

No render assertions declared.

Generator source

scripts/gen_transition_timing.py

#!/usr/bin/env python3
"""Generate a single ``fixtures/pptx/transition-timing--<id>.pptx``.

Parameterised generator for the ``pptx/transition-timing`` manifest
family. Each case produces a single-slide presentation whose
``<p:transition>`` carries one ``<p:fade/>`` effect child (a fixed
axis — this family tests timing, not effect choice) and the three
timing attributes:

- ``p14:dur`` — PowerPoint 2010+ extension attribute, animation
  duration in milliseconds.
- ``advClick`` — xsd:boolean, whether the slide advances on mouse
  click (default true).
- ``advTm`` — xsd:unsignedInt, delay in milliseconds before the slide
  auto-advances (only meaningful with advClick=0).

python-pptx exposes no high-level transition API, so ``<p:transition>``
is appended directly via lxml with the p14 namespace decl emitted so
``@p14:dur`` serialises cleanly.
"""

from __future__ import annotations

import argparse
import datetime as _dt
from pathlib import Path

from lxml import etree
from pptx import Presentation
from pptx.oxml.ns import qn

_REPO_ROOT = Path(__file__).resolve().parent.parent
_REPRODUCIBLE_DT = _dt.datetime(2000, 1, 1, 0, 0, 0)

_P14_NS = "http://schemas.microsoft.com/office/powerpoint/2010/main"


def _write(dur: str, adv_click: str, adv_tm: str, out: Path) -> None:
    prs = Presentation()
    # "Title Only" layout — a title placeholder on an otherwise plain slide.
    slide = prs.slides.add_slide(prs.slide_layouts[5])
    if slide.shapes.title is not None:
        slide.shapes.title.text = "Transition timing"

    # Append <p:transition p14:dur="..." advClick="..." [advTm="..."]>
    #          <p:fade/>
    #        </p:transition>
    # to <p:sld>. Schema order is (cSld, clrMapOvr, transition, timing,
    # extLst); with no timing/extLst present, appending at end is valid.
    sld = slide._element
    transition = etree.SubElement(
        sld,
        qn("p:transition"),
        nsmap={"p14": _P14_NS},
    )
    transition.set("advClick", adv_click)
    if adv_tm:
        transition.set("advTm", adv_tm)
    transition.set(f"{{{_P14_NS}}}dur", dur)
    etree.SubElement(transition, qn("p:fade"))

    out.parent.mkdir(parents=True, exist_ok=True)
    prs.save(out, zip_date_time=_REPRODUCIBLE_DT)


def main() -> int:
    parser = argparse.ArgumentParser()
    parser.add_argument(
        "--dur",
        required=True,
        help="@p14:dur attribute value (ms).",
    )
    parser.add_argument(
        "--adv-click",
        required=True,
        help="@advClick attribute value ('0' or '1').",
    )
    parser.add_argument(
        "--adv-tm",
        default="",
        help="@advTm attribute value (ms); empty to omit.",
    )
    parser.add_argument(
        "--out",
        required=True,
        help="Output fixture path (absolute or repo-relative).",
    )
    args = parser.parse_args()

    out_path = Path(args.out)
    if not out_path.is_absolute():
        out_path = _REPO_ROOT / out_path
    _write(args.dur, args.adv_click, args.adv_tm, out_path)
    print(out_path)
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

Manifest (expanded)

{
  "$schema": "../manifest.schema.json",
  "id": "pptx/transition-timing--fast-transition",
  "kind": "literal",
  "title": "Slide transition timing attributes",
  "format": "pptx",
  "category": "slide-content",
  "summary": "The <p:transition> element carries timing attributes alongside its effect child: @advClick (auto-advance vs. click-advance), @advTm (delay before auto-advance in ms), and the PowerPoint 2010+ @p14:dur extension attribute (transition animation duration in ms). This family covers three configurations — fast transition (p14:dur=250ms), slow transition (p14:dur=2000ms), and auto-advance (advClick=0 with advTm=5000ms) — each backed by a distinct fixture pptx/transition-timing--<id>.pptx generated from the same gen_transition_timing.py script parameterised by --dur, --adv-click, and --adv-tm.",
  "spec": {
    "source": "ecma-376-5-part-1",
    "clause": "19.5.70",
    "element": "p:transition",
    "rnc_reference": "spec/ecma-376-5/part-1/rnc/pml.rnc",
    "xsd_reference": "spec/ecma-376-5/part-1/xsd/pml.xsd",
    "notes": "ECMA-376 Part 1 clause 19.5.70 defines <p:transition> with attributes @spd (fast|med|slow), @advClick (xsd:boolean, default true), and @advTm (xsd:unsignedInt, delay in ms before auto-advance). The @p14:dur attribute (animation duration in ms) is a PowerPoint 2010+ extension in the http://schemas.microsoft.com/office/powerpoint/2010/main namespace, gated in Office-authored files by a mc:Ignorable='p14' declaration on the sld root. This family axis differs from pptx/slide-transition (which exercises the choice-child effect token): here the effect child is fixed (p:fade) and the varying dimension is the timing attributes carried on <p:transition> itself. python-pptx exposes no high-level transition API, so the generator sets these attributes via lxml."
  },
  "fixtures": {
    "machine": "pptx/transition-timing--fast-transition"
  },
  "generator": {
    "python": "scripts/gen_transition_timing.py",
    "arg_template": "--dur {timing.dur} --adv-click {timing.advClick} --adv-tm {timing.advTm} --out fixtures/pptx/transition-timing--{timing.id}.pptx"
  },
  "_expansion": {
    "parent_id": "pptx/transition-timing",
    "bindings": {
      "timing": "fast-transition"
    }
  },
  "assertions": [
    {
      "id": "transition-present-fast-transition",
      "part": "ppt/slides/slide1.xml",
      "namespaces": {
        "p": "http://schemas.openxmlformats.org/presentationml/2006/main"
      },
      "xpath": "count(//p:transition)",
      "must": "match",
      "value": "^1(\\.0)?$",
      "description": "Slide must carry exactly one <p:transition> element."
    },
    {
      "id": "transition-effect-child-fast-transition",
      "part": "ppt/slides/slide1.xml",
      "namespaces": {
        "p": "http://schemas.openxmlformats.org/presentationml/2006/main"
      },
      "xpath": "local-name(//p:transition/*[1])",
      "must": "equal",
      "value": "fade",
      "description": "The <p:transition> for all timing cases carries a single <p:fade/> effect child; this family tests timing attributes, not effect choice."
    },
    {
      "id": "transition-p14-dur-fast-transition",
      "part": "ppt/slides/slide1.xml",
      "namespaces": {
        "p": "http://schemas.openxmlformats.org/presentationml/2006/main",
        "p14": "http://schemas.microsoft.com/office/powerpoint/2010/main"
      },
      "xpath": "//p:transition/@p14:dur",
      "must": "equal",
      "value": "250",
      "description": "The @p14:dur attribute on <p:transition> must equal 250 (milliseconds)."
    },
    {
      "id": "transition-adv-click-fast-transition",
      "part": "ppt/slides/slide1.xml",
      "namespaces": {
        "p": "http://schemas.openxmlformats.org/presentationml/2006/main"
      },
      "xpath": "string(//p:transition/@advClick)",
      "must": "match",
      "value": "^(1|true|)$",
      "description": "The @advClick attribute on <p:transition> must reflect the case axis (click-advance vs auto-advance)."
    }
  ]
}