kivy / kivy / 25974339468

60%

Build Type

push

github

Committed by web-flow

Commit Message

Remove deprecated kv-lang templates (Kivy 3.0) (#9308)

The kv-lang templates feature (the ``[Name@Base]:`` syntax,
``Builder.template()``, ``Builder.templates``, ``Factory.is_template()``)
has been deprecated since Kivy 1.7. This commit hard-removes it in
preparation for Kivy 3.0; the modern dynamic-class syntax
(``<Name@Base>:``) is the replacement.

Core
----
* parser: drop ``[Name@Base]:`` template parsing; the parser now raises
  ``ParserException`` when the syntax is encountered.
* builder: remove ``Builder.template()``, ``Builder.templates``, the
  ``template_ctx`` parameter on ``_apply_rule``, and the
  ``Factory.is_template()`` branch. Clean up related imports.
* factory: remove ``Factory.is_template()`` and the ``is_template=``
  kwarg on ``Factory.register()``.

Built-in templates promoted to Python classes
---------------------------------------------
The three built-in templates in ``kivy/data/style.kv`` are now public
Python classes with explicit Kivy ``Property`` declarations. They are
still looked up via the Factory under the same names:

* ``kivy.uix.filechooser.FileListEntry``
* ``kivy.uix.filechooser.FileIconEntry``
* ``kivy.uix.accordion.AccordionItemTitle``

AccordionItem
-------------
* Remove ``AccordionItem.title_template`` and ``title_args``.
* Add ``AccordionItem.title_class``, modeled on
  ``RecycleView.viewclass``: accepts either a class object or a string
  resolved through the Factory. Defaults to ``AccordionItemTitle``.

FileChooser
-----------
* Rename the internal ``_ENTRY_TEMPLATE`` attribute on layouts/views
  to ``_ENTRY_CLASS`` to drop template-era vocabulary.
* ``FileListEntry`` / ``FileIconEntry`` are now importable from
  ``kivy.uix.filechooser``.

Documentation & tests
---------------------
* Remove the templates sections from ``kivy/lang/__init__.py`` and
  ``doc/sources/guide/lang.rst``.
* Add a "Kivy 2.x.x -> 3.x.x" section to ``doc/sources/migration.rst``
  covering the template removal, the ``title_class``... (continued)

Coverage Stats

3248 of 6441 branches covered (50.43%)

107 of 124 new or added lines in 8 files covered. (86.29%)

46 existing lines in 11 files now uncovered.

28688 of 48004 relevant lines covered (59.76%)

1.18 hits per line