/usr/share/doc/python-gtkmvc-doc/userman/_sources/op_special.txt is in python-gtkmvc-doc 1.99.1-1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 | =========================================
Special members for Observable Properties
=========================================
Classes derived from Model, that exports *OPs*, have several special
members. Advanced users might be interested in overriding some of them,
but in general they should be considered as private members. They are
explained here for the sake of completeness.
``__observables__``
A class (static) member that lists property
names. This must be provided as either a tuple or a list by the
user. Wilcards in names can be used to match property names, but
properties with names starting with a double underscore
``__`` will be not matched.
``__properties__``
(Deprecated, do not use anymore) A dictionary mapping
observable properties names and their initial value. This
variable has been substituted by __observables__.
``__derived_properties__``
(Deprecated) Automatically generated static member
that maps the *OPs* exported by all base classes. This does not
contain *OPs* that the class overrides.
``_prop_<property_name>``
This is an
auto-generated variable holding the property value. For example,
a property called ``x`` will generate a variable called
``_prop_x``.
``get_prop_<property_name>``
This public method
is the getter for the property. It is automatically generated only
if the user does not define one. This means that the user can change
the behavior of it by defining their own method. For example, for
property ``x`` the method is ``get_prop_x``. This
method gets only self and returns the corresponding property value.
``set_prop_<property_name>``
This public method
is customizable like
``get_prop_<property_name>``. This does not return
anything, and gets self and the value to be assigned to the
property. The default auto-generated code also calls method
``gtkmvc.Model.notify_property_change`` to notify the
change to all registered observers.
For further details about this topic see meta-classes ``PropertyMeta``
and ``ObservablePropertyMeta`` from package ``support``.
|