U õÕ/e,ã@sZdZddlmZddlZe e¡ZdZddlm Z e ddl m Z e ddl m Z e dd l mZedd lmZedd lmZedd lmZedd lmZeddlmZeddlmZeddlmZeddlmZeddlmZeddlmZeddlmZeddlmZeddlmZeddlmZeddlm Z e ddlm!Z!e!ddlm"Z"e"ddlm#Z#e#ddlm$Z$e$ddlm%Z%e%ddlm&Z&e&ddlm'Z'e'dd lm(Z(e(dd!lm)Z)e)dd"lm*Z*e*dd#lm+Z+e+dd$lm,Z,e,dd%lm-Z-e-dd&lm.Z.e.dd'lm/Z/e/dd(lm0Z0e0dd)lm1Z1e1dd*lm2Z2e2dd+lm3Z3e3dd,lm4Z4e4dd-lm5Z5e5dd.l6m7Z7e7dd/l6m8Z8e8dd0l6m9Z9e9dd1l:m;Z;e;dd2lm?Z?e?dd4l@mAZAeAdd5l@mBZBeBdd6lCmDZDeDdd7lEmFZFeFdd8lGmHZHeHdd9lImJZJeJdd:lImKZKeKdd;lLmMZMeMddlLmPZPePdd?lLmQZQeQdd@lLmRZReRddAlLmSZSeSddBlTmUZUeUddClVmWZWeWddDlVmXZXeXddElYmZZZeZddFlYm[Z[e[ddGlYm\Z\e\ddHlYm]Z]e]ddIlYm^Z^e^ddJlYm_Z_e_ddKl`maZaeaddLlbmcZcecddMlbmdZdedddNlbmeZeeeddOlfmgZgegddPlhmiZieiddQljmkZkekddRljmlZlelddSljmmZmemddTljmnZnenddUljmoZoeoddVljmpZpepddWlqmrZrerddXlqmsZsesdS)Yah 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:: Color .. autoclass:: Complex .. autoclass:: DashPattern .. autoclass:: Date .. autoclass:: Datetime .. autoclass:: Either .. autoclass:: Enum .. autoclass:: Float .. autoclass:: FontSize .. autoclass:: Image .. autoclass:: Instance .. autoclass:: Int .. autoclass:: Interval .. autoclass:: JSON .. autoclass:: MarkerType .. autoclass:: MinMaxBounds .. autoclass:: NonNegativeInt .. autoclass:: Null .. autoclass:: Percent .. autoclass:: PositiveInt .. autoclass:: RGB .. autoclass:: Regex .. autoclass:: Size .. autoclass:: String .. autoclass:: Struct .. autoclass:: TimeDelta Container Properties -------------------- .. autoclass:: Array .. autoclass:: ColumnData .. autoclass:: Dict .. autoclass:: List .. autoclass:: RelativeDelta .. autoclass:: Seq .. autoclass:: Tuple .. autoclass:: RestrictedDict DataSpec Properties ------------------- .. autoclass:: AlphaSpec .. autoclass:: AngleSpec .. autoclass:: ColorSpec .. autoclass:: DataSpec .. autoclass:: DistanceSpec .. autoclass:: FontSizeSpec .. autoclass:: MarkerSpec .. autoclass:: NumberSpec .. autoclass:: PropertyUnitsSpec .. autoclass:: SizeSpec .. autoclass:: StringSpec Helpers ~~~~~~~ .. autofunction:: expr .. autofunction:: field .. autofunction:: value Special Properties ------------------ .. autoclass:: Include .. autoclass:: Nullable .. autoclass:: NonNullable .. autoclass:: Override 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)JÚAliasÚAlphaÚ AlphaSpecÚAngleÚ AngleSpecÚAnyÚAnyRefÚArrayÚAutoÚ Base64StringÚBoolÚByteÚColorÚColorHexÚ ColorSpecÚ ColumnDataÚComplexÚ DashPatternÚDataSpecÚDateÚDatetimeÚDictÚ DistanceSpecÚEitherÚEnumÚFactorÚ FactorSeqÚFloatÚFontSizeÚ FontSizeSpecÚHatchPatternSpecÚHatchPatternTypeÚImageÚIncludeÚInstanceÚIntÚIntervalÚJSONÚListÚ MarkerSpecÚ MarkerTypeÚ MathStringÚ MinMaxBoundsÚNonNegativeIntÚ NonNullableÚNullÚNullStringSpecÚNullableÚ NumberSpecÚOverrideÚPandasDataFrameÚ PandasGroupByÚPercentÚ PositiveIntÚPropertyUnitsSpecÚRGBÚReadonlyÚRegexÚ RelativeDeltaÚRestrictedDictÚSeqÚSizeÚSizeSpecÚStringÚ StringSpecÚStructÚ TimeDeltaÚTextLikeÚTupleÚexprÚfieldÚvalidateÚvalueÚwithout_property_validationé)r)r)r )r )r)r)r:)r)r )r)r)r))r?)rG)r=)r>)r)r)r)ÚDashPatternSpec)r)r)rH)rI)r )Ú FontStyleSpec)r!)ÚIntSpec)Ú LineCapSpec)Ú LineJoinSpec)r*)ÚNullDistanceSpec)r1)r3)r9)rA)rC)Ú TextAlignSpec)ÚTextBaselineSpec)rK)r)r)rE)ÚUnsetValueError)r)r)r)r)r$)r%)r()r/)r2)r)r)r')r.)r7)r8)r@)r4)r5)r6)r )r)r&)r)r0)rB)r;)r )r,)r<)rD)rF)r)r)r")r#)r-)r+)rJ)rL)tÚ__doc__Ú __future__rÚloggingÚ getLoggerÚ__name__ÚlogÚ__all__Zproperty.aliasrZ property.anyrr Z property.autor Zproperty.colorrrr:rZproperty.containerr rrr)r?rGr=r>Zproperty.dataspecrrrrNrrrHrIr rOr!rPrQrRr*rSr1r3r9rArCrTrUrKZproperty.datetimerrrEZproperty.descriptorsrVZproperty.eitherrZ property.enumrZproperty.factorsrrZproperty.includer$Zproperty.instancer%Z property.jsonr(Zproperty.nullabler/r2Zproperty.numericrrr'r.r7r8r@Zproperty.overrider4Zproperty.pandasr5r6Zproperty.primitiver rr&rr0rBZproperty.readonlyr;Zproperty.stringr r,r<Zproperty.structrDZproperty.text_likerFZproperty.visualrrr"r#r-r+Zproperty.validationrJrL©r^r^ú9/tmp/pip-unpacked-wheel-f5fndrjf/bokeh/core/properties.pyÚsV(  Q