bokeh.core.property.descriptor_factory¶

すべてのBokeh属性に1つの基底クラスを提供する.

Bokeh属性の働き方は、Python記述子オブジェクトを貢献することです HasProps 授业。そして，これらの記述子は属性アクセスをBokeh Propertyクラスに戻し，後者は検証，直列化，文書要求を処理する.

♪the PropertyDescriptorFactory クラスは2つの方法を提供する autocreate そして make_descriptors 元類で使われています MetaHasProps クラス作成中に宣言された属性に対応する必要な記述子を作成してインストールします。

このメカニズムはBokehをより人間的にするのに役立つ。たとえば，DataSpec属性は固定値と列データソース列への参照の間で調停される.ユーザは非常に簡単な文法を使用することができ、属性は自動的に正しく直列化され、検証される：

from bokeh.models import Circle

c = Circle()

c.x = 10      # serializes to {'value': 10}

c.x = 'foo'   # serializes to {'field': 'foo'}

c.x = [1,2,3] # raises a ValueError validation exception

Bokeh全体には他にも似たような例が多い。このようにして、ユーザは、検証、直列化、および文書に関する下位の詳細に関心を持たずに、簡単かつ自然に操作することができる。

注釈

これらのクラスは，Bokehモデルと属性システムを実現する非常に下位の機器の一部を構成している.これらのクラスまたはそれらの方法のいずれも、任意の標準的な用法に適用される可能性はあまりなく、またはBokeh自身のインフラ上で直接開発された誰でもない。

class PropertyDescriptorFactory[ソース]¶

すべてのBokeh属性の基底クラス.

A Bokeh property really consist of two parts: the familiar "property" portion, such as Int, String, etc., as well as an associated Python descriptor that delegates attribute access (e.g. range.start) to the property instance.

以下のクラス定義を考慮してください。

from bokeh.model import Model
from bokeh.core.properties import Int

class SomeModel(Model):
    foo = Int(default=10)

次のような点が観察されます

>>> m = SomeModel()

# The class itself has had a descriptor for 'foo' installed
>>> getattr(SomeModel, 'foo')
<bokeh.core.property.descriptors.BasicPropertyDescriptor at 0x1065ffb38>

# which is used when 'foo' is accessed on instances
>>> m.foo
10

classmethod autocreate()[ソース]¶

由 MetaHasProps メタクラスは、属性タイプのみを使用して属性を割り当てる際に、この記述子の新しいインスタンスを作成するために使用される。例：

class Foo(Model):

    bar = String   # no parens used here

make_descriptors(name)[ソース]¶

戻ります。 PropertyDescriptor インスタンスは、この属性に対する特性アクセスを委任するために使用される。

パラメータ: name (str) -- これらの記述子が用いる属性の名前
戻り値: 明細書. [PropertyDescriptor]

戻り記述子は MetaHasProps メタクラスを追加します HasProps クラス作成中のサブクラス。

の子類 PropertyDescriptorFactory この関数を実現して、その要求に特定された記述子を返す責任がある。