kivy / kivy / 25517353690

59%

Build Type

push

github

Committed by web-flow

Commit Message

Add Lottie animation provider and LottieWidget (#9293)

* Add Lottie core provider (ThorVG backend)

Register lottie in core provider config and kivy.__init__. Implement LottieBase, null and ThorVG backends (markers, eos, texture refresh on stop).

* Add LottieWidget UIX widget

LottieWidget with eos/state handling; factory registration and default style alongside Image/AsyncImage.

* Add Lottie provider and widget tests

Unit tests for LottieBase/ThorVG, LottieWidget, bundled test JSON, and provider registry completeness for lottie.

* Add Lottie widget examples with bundled JSON

Examples: async status (markers), quality (blur), slot theme (logo + logoFill), spinning star (ButtonBehavior + spin/grow markers).

* lottie: migrate from thorvg-python to kivy.lib.thorvg

Switches the ``lottie_thorvg`` core provider and the Lottie docs/tests/
examples from the external ``thorvg-python`` pip package to Kivy's
internal :mod:`kivy.lib.thorvg` Cython binding.  No more external pip
install is required on desktop platforms - ThorVG is statically linked
into the Kivy build.

Provider changes (kivy/core/lottie/lottie_thorvg.py):

  * Replaced ``import thorvg_python as tvg`` /
    ``from thorvg_python.base import Result`` with
    ``from kivy.lib import thorvg as tvg`` /
    ``from kivy.lib.thorvg import Result``.
  * Dropped the per-instance ``self._engine`` and the ``Engine`` /
    ``engine.term()`` plumbing - ``kivy.lib.thorvg`` initialises and
    terminates the ThorVG engine itself at module load / interpreter
    shutdown, matching the svg_thorvg and img_thorvg_svg providers.
  * Collapsed the six duplicate ``canvas.destroy(); engine.term();
    return`` error-cleanup blocks in ``load()`` to plain ``return``
    statements; the locals are Python-owned so dropping their
    references lets ``__dealloc__`` tear the ThorVG handles down
    cleanly.
  * Simplified ``_teardown`` accordingly.
  * Replaced ``tvg.__version__`` (thorvg-python attribute) with the
    ... (continued)

Coverage Stats

3238 of 6451 branches covered (50.19%)

1072 of 1216 new or added lines in 8 files covered. (88.16%)

731 existing lines in 40 files now uncovered.

28351 of 47812 relevant lines covered (59.3%)

1.17 hits per line