hjeg-dZddlmZddlZejeZdZddlm Z m Z ddl m Z ddl mZdd l mZdd lmZdd lmZdd lmZdd lmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlm Z ddlm!Z!ddlm"Z"ddlm#Z#ddl$m%Z%ddl$m&Z&ddl$m'Z'ddl$m(Z(ddl$m)Z)ddl$m*Z*dd l$m+Z+dd!l$m,Z,dd"l$m-Z-dd#l$m.Z.dd$l$m/Z/dd%l$m0Z0dd&l$m1Z1dd'l$m2Z2dd(l$m3Z3dd)l$m4Z4dd*l$m5Z5dd+l$m6Z6dd,l$m7Z7dd-l$m8Z8dd.l$m9Z9dd/l:m;Z;dd0l:mZ>dd3l?m@Z@dd4lAmBZBdd5lCmDZDdd6lEmFZFdd7lEmGZGdd8lHmIZIdd9lJmKZKdd:lJmLZLdd;lJmMZMddlRmSZSdd?lRmTZTdd@lUmVZVddAlUmWZWddBlUmXZXddClUmYZYddDlUmZZZddElUm[Z[ddFlUm\Z\ddGlUm]Z]ddHlUm^Z^ddIl_m`Z`ddJlambZbddKlamcZcddLldmeZeddMldmfZfddNldmgZgddOldmhZhddPldmiZiddQldmjZjddRldmkZkddSllmmZmddTlnmoZoddUlpmqZqddVlrmsZsddWlrmtZtddXlumvZvddYlwmxZxddZlymzZzdd[lym{Z{dd\lym|Z|dd]l}m~Z~dd^l}mZdd_l}mZdd`l}mZddal}mZddbl}mZddclmZdddlmZdS)ea Provide property types for Bokeh models Properties are objects that can be assigned as class attributes on Bokeh models, to provide automatic serialization, validation, and documentation. This documentation is broken down into the following sections: .. contents:: :local: Overview -------- There are many property types defined in the module, for example ``Int`` to represent integral values, ``Seq`` to represent sequences (e.g. lists or tuples, etc.). Properties can also be combined: ``Seq(Float)`` represents a sequence of floating point values. For example, the following defines a model that has integer, string, and list[float] properties: .. code-block:: python class SomeModel(Model): foo = Int bar = String(default="something") baz = List(Float, help="docs for baz prop") As seen, properties can be declared as just the property type, e.g. ``foo = Int``, in which case the properties are automatically instantiated on new Model objects. Or the property can be instantiated on the class, and configured with default values and help strings. The properties of this class can be initialized by specifying keyword arguments to the initializer: .. code-block:: python m = SomeModel(foo=10, bar="a str", baz=[1,2,3,4]) But also by setting the attributes on an instance: .. code-block:: python m.foo = 20 Attempts to set a property to a value of the wrong type will result in a ``ValueError`` exception: .. code-block:: python >>> m.foo = 2.3 Traceback (most recent call last): << traceback omitted >> ValueError: expected a value of type Integral, got 2.3 of type float Models with properties know how to serialize themselves, to be understood by BokehJS. Additionally, any help strings provided on properties can be easily and automatically extracted with the Sphinx extensions in the :ref:`bokeh.sphinxext` module. Basic Properties ---------------- .. autoclass:: Alpha .. autoclass:: Angle .. autoclass:: Any .. autoclass:: AnyRef .. autoclass:: Auto .. autoclass:: Bool .. autoclass:: Byte .. autoclass:: Bytes .. autoclass:: Color .. autoclass:: Complex .. autoclass:: CoordinateLike .. autoclass:: DashPattern .. autoclass:: Date .. autoclass:: Datetime .. autoclass:: Either .. autoclass:: Enum .. autoclass:: Float .. autoclass:: FontSize .. autoclass:: Image .. autoclass:: Int .. autoclass:: Interval .. autoclass:: JSON .. autoclass:: MarkerType .. autoclass:: MinMaxBounds .. autoclass:: NonNegative .. autoclass:: NonNegativeInt .. autoclass:: Nothing .. autoclass:: Null .. autoclass:: Percent .. autoclass:: Positive .. autoclass:: PositiveInt .. autoclass:: RGB .. autoclass:: Regex .. autoclass:: Size .. autoclass:: String .. autoclass:: Struct .. autoclass:: Time .. autoclass:: TimeDelta Container Properties -------------------- .. autoclass:: Array .. autoclass:: ColumnData .. autoclass:: Dict .. autoclass:: List .. autoclass:: RelativeDelta .. autoclass:: Seq .. autoclass:: Set .. autoclass:: Tuple .. autoclass:: RestrictedDict DataSpec Properties ------------------- .. autoclass:: AlphaSpec .. autoclass:: AngleSpec .. autoclass:: ColorSpec .. autoclass:: DataSpec .. autoclass:: DistanceSpec .. autoclass:: FontSizeSpec .. autoclass:: MarkerSpec .. autoclass:: NumberSpec .. autoclass:: SizeSpec .. autoclass:: StringSpec .. autoclass:: UnitsSpec Helpers ~~~~~~~ .. autofunction:: expr .. autofunction:: field .. autofunction:: value Special Properties ------------------ .. autoclass:: Instance .. autoclass:: InstanceDefault .. autoclass:: Include .. autoclass:: Nullable .. autoclass:: NonNullable .. autoclass:: NotSerialized .. autoclass:: Object .. autoclass:: Override .. autoclass:: Required .. autoclass:: TypeOfAttr Validation-only Properties -------------------------- .. autoclass:: PandasDataFrame .. autoclass:: PandasGroupBy Validation Control ------------------ By default, Bokeh properties perform type validation on values. This helps to ensure the consistency of any data exchanged between Python and JavaScript, as well as provide detailed and immediate feedback to users if they attempt to set values of the wrong type. However, these type checks incur some overhead. In some cases it may be desirable to turn off validation in specific places, or even entirely, in order to boost performance. The following API is available to control when type validation occurs. .. autoclass:: validate .. autofunction:: without_property_validation ) annotationsN)`AliasAlpha AlphaSpecAngle AngleSpecAnyAnyRefArrayAutoBoolByteBytesColorColorHex ColorSpec ColumnDataComplexCoordinateLike DashPatternDashPatternSpecDataSpecDateDatetimeDeprecatedAliasDict DistanceSpecEitherEnumFactor FactorSeqFloatFontSize FontSizeSpec FontStyleSpecHatchPatternSpecHatchPatternTypeImageIncludeInstanceInstanceDefaultIntIntSpecIntervalJSON LineCapSpec LineJoinSpecList MarkerSpec MarkerType MathString MinMaxBoundsNonEmpty NonNegativeNonNegativeInt NonNullable NotSerializedNothingNullNullDistanceSpecNullStringSpecNullable NumberSpecObjectOverridePandasDataFrame PandasGroupByPercentPositive PositiveIntRGBReadonlyRegex RelativeDeltaRequiredRestrictedDictSeqSetSizeSizeSpecString StringSpecStructTime TimeDelta TextAlignSpecTextBaselineSpecTextLikeTuple TypeOfAttr UnitsSpecUnsetValueErrorexprfieldvalidatevaluewithout_property_validation)rr)r)r )r )r )r)r)rI)r)r\)r )r)r)r2)r7)rO)rP)r[)rL)rN)r)r)r)r)r)r)r$)r%)r&)r-)r0)r1)r3)r>)r?)rA)rR)rT)rX)rY)r])r)r)rV)rW)r^)r)r)r )r!)r))r*)r+)rB)r/)r<)r:)r@)r)r)r.)r8)r9)rF)rG)rH)rQ)rC)rD)rE)r )r)r)r,)r")r=)rS)rJ)rM)r;)r5)rK)rU)rZ)r_)r`)rb)r)r#)r')r()r6)r4)ra)rc)__doc__ __future__rlogging getLogger__name__log__all__property.aliasrrproperty.aliasesr property.anyr r property.autor property.colorrrrIrproperty.constraintsr\property.containerr rrr2r7rOrPr[rLrNproperty.dataspecrrrrrrr$r%r&r-r0r1r3r>r?rArRrTrXrYr]property.datetimerrrVrWproperty.descriptorsr^property.eitherr property.enumrproperty.factorsr r!property.includer)property.instancer*r+rB property.jsonr/property.nothingr<property.nullabler:r@property.numericrrr.r8r9rFrGrHrQproperty.overriderC property.pdrDrEproperty.primitiver rrr,r"r=rSproperty.readonlyrJproperty.requiredrMproperty.serializedr;property.stringr5rKproperty.structrUproperty.text_likerZproperty.vectorizationr_r`rbproperty.visualrr#r'r(r6r4property.validationrarc5lib/python3.11/site-packages/bokeh/core/properties.pyrsoof#"""""g!!a N32222222,,,,,, !!!!!!!!!!!!$$$$$$,,,,,,%%%%%%******$$$$$$$$$$$$((((((############%%%%%%------......((((((((((((((((((......''''''++++++++++++,,,,,,//////&&&&&&******++++++))))))//////------))))))'''''')))))),,,,,,//////((((((######''''''######((((((111111######$$$$$$''''''%%%%%%''''''......%%%%%%%%%%%%******''''''######""""""&&&&&&)))))),,,,,,%%%%%%&&&&&&))))))""""""''''''((((((&&&&&&$$$$$$%%%%%%''''''######%%%%%%$$$$$$&&&&&&''''''''''''......''''''""""""######(((((((((((())))))))))))((((((%%%%%%------""""""))))))''''''))))))<<<<<<<