fNtPdZdZddlmZddlmZddlmZddlmZddl m Z ddl m Z dd l m Z dd l m Z dd l mZdd l mZdd l mZddl mZddl mZddl mZddl mZddl mZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlm Z ddlm!Z!ddlm"Z"ddlm#Z#dd lm$Z$dd!lm%Z%dd"lm&Z&dd#lm'Z'dd$lm(Z(dd%lm)Z)dd&lm*Z*dd'lm+Z+dd(lm,Z,dd)lm-Z-dd*lm.Z.dd+lm/Z/dd,l0m1Z1gd-Z2Gd.d/e-Z3Gd0d1e-Z4Gd2d3e-Z5Gd4d5e-Z6Gd6d7e7Z8Gd8d9eZ9Gd:d;e9Z:Gd<d=e9Z;Gd>d?e9Z<Gd@dAe9Z=GdBdCe<Z>GdDdEe=Z?GdFdGe9Z@GdHdIe9ZAGdJdKe?e:e9ZBGdLdMe?e:e9ZCGdNdOeCZDGdPdQeDZEGdRdSeBZFGdTdUeEZGGdVdWeCZHGdXdYeCZIGdZd[eIZJGd\d]eIZKGd^d_e>e9ZLGd`daeLZMGdbdceMZNGdddeeNZOGdfdgeOZPGdhdiePZQGdjdkeNZRGdldmeLZSGdndoe>e9ZTGdpdqe>e9ZUGdrdse>e9ZVGdtdue>e9ZWdvZXdwZYGdxdyeJZZGdzd{eJZ[Gd|d}eJZ\Gd~deJZ]Gdde9Z^Gdde?e:e;Z_Gdde_Z`Gdde`ZaGdde_ZbGddebZcGddebZdGdde`ZeGddeaZfGddecZgGddecZhGdde9ZiGdde?e:e;ZjGddejZkGddekZlGddeZmGddemZnGddenZoGddeZpGddeZqGddeZrGddepZsGddepZtGddeZuGddeuesZvGddevZwGddeweZxGddeZyGddeZzGddeZ{Gdde{Z|y)z!Schema interfaces and exceptions reStructuredText) Attribute) Interface)IEnumerableMapping) IInterface)Bool)Complex)Decimal)Field)Int)Integral)Number)Object)Rational)Real)Text)TextLine)ConstraintNotSatisfied)IBeforeObjectAssignedEvent)IContextAwareDefaultFactory) IFromBytes) IFromUnicode) InvalidValue) IValidatable)LenOutOfBounds) NotAContainer)NotAnInterface) NotAnIterator)OrderableOutOfBounds) OutOfBounds)RequiredMissing)SchemaNotCorrectlyImplemented)SchemaNotFullyImplemented)SchemaNotProvided)StopValidation)TooBig)TooLong)TooShort)TooSmall)ValidationError)WrongContainedType) WrongType)_)_rInvalidDottedName InvalidId InvalidURIrrrrr NotUniquerr r!r"r#r$r%r&r'r(r)Unboundr*r+r,IASCII IASCIILine IAbstractBag IAbstractSetIBaseVocabularyrIBoolIBytes IBytesLineIChoice ICollectionIComplex IContainerrIContextSourceBinderIDate IDatetimeIDecimalIDict IDottedNameIField IFieldEventIFieldUpdatedEventIFloatrr IFrozenSetIIdIInt IIntegralIInterfaceField IIterableIIterableSourceIIterableVocabularyILenIListIMappingIMinMax IMinMaxLenIMutableMappingIMutableSequence INativeStringINativeStringLineINumberIObject IOrderable IPasswordIPythonIdentifier IRationalIReal ISequenceISetISourceISourceQueriables ISourceTextITermIText ITextLineITime ITimedeltaITitledTokenizedTermITokenizedTermITreeVocabularyITupleIURIIUnorderedCollection IVocabularyIVocabularyFactoryIVocabularyRegistryIVocabularyTokenizedceZdZedZy)r1z/One or more entries of sequence are not unique.N__name__ __module__ __qualname__r-__doc__n/var/dept/share/cheung/public_html/OutSchool/python/env/lib/python3.12/site-packages/zope/schema/interfaces.pyr1r1s EFGr|r1ceZdZedZy)r0zThe specified URI is not valid.Nrvr{r|r}r0r0s 56Gr|r0ceZdZedZy)r/zThe specified id is not valid.Nrvr{r|r}r/r/s 45Gr|r/ceZdZedZy)r.z'The specified dotted name is not valid.Nrvr{r|r}r.r.s =>Gr|r.ceZdZedZy)r2zThe field is not bound.Nrvr{r|r}r2r2s -.Gr|r2c|eZdZdZdZeededddZeeded ddZ e ed ed d Z e ededddZ e ededZe ededZeededd d ZdZdZdZddZdZy) rEaBasic Schema Field Interface. Fields are used for Interface specifications. They at least provide a title, description and a default value. You can also specify if they are required and/or readonly. The Field Interface is also used for validation and specifying constraints. We want to make it possible for a IField to not only work on its value but also on the object this value is bound to. This enables a Field implementation to perform validation against an object which also marks a certain place. Note that many fields need information about the object containing a field. For example, when validating a value to be set as an object attribute, it may be necessary for the field to introspect the object's state. This means that the field needs to have access to the object when performing validation:: bound = field.bind(object) bound.validate(value) cy)aReturn a copy of this field which is bound to context. The copy of the Field will have the 'context' attribute set to 'object'. This way a Field can implement more complex checks involving the object's location/environment. Many fields don't need to be bound. Only fields that condition validation or properties on an object containing the field need to be bound. Nr{objects r}bindz IField.bindr|TitlezA short summary or labelF)title descriptiondefaultrequired DescriptionzA description of the fieldRequired2Tells whether a field requires its value to exist.Trrrz Read Onlyz-If true, the field's value cannot be changed.rrrr Default ValueRThe field default value may be None or a legal field valuerrz Missing ValuezjIf input for this Field is missing, and that's ok, then this is the value to usez Field Ordera" The order attribute can be used to determine the order in which fields in a schema were defined. If one field is created after another (in the same thread), its order will be greater. (Fields in separate threads could have the same order.) )rrrreadonlycy)a9Check a customized constraint on the value. You can implement this method with your Field to require a certain constraint. This relaxes the need to inherit/subclass a Field you to add a simple constraint. Returns true if the given value is within the Field's constraint. Nr{values r} constraintzIField.constraintrr|cy)zValidate that the given value is a valid field value. Returns nothing but raises an error if the value is invalid. It checks everything specific to a Field and also checks with the additional constraint. Nr{rs r}validatezIField.validaterr|cy)z0Get the value of the field for the given object.Nr{rs r}getz IField.get&rr|Ncy)zuQuery the value of the field for the given object. Return the default if the value hasn't been set. Nr{)rrs r}queryz IField.query)rr|cy)zrSet the value of the field for the object Raises a type error if the field is a read-only field. Nr{)rrs r}setz IField.set/rr|)N)rwrxryrzrrr-rrrrrrr r missing_valuer orderrrrrrr{r|r}rErEs2   j01  E 23  K mKLH  nEF H  '( G  ;< M     E  ?  r|rEceZdZdZy)rNzFields with a value that can be iterated over. The value needs to support iteration; the implementation mechanism is not constrained. (Either `__iter__()` or `__getitem__()` may be used.) Nrwrxryrzr{r|r}rNrN6r|rNceZdZdZy)r>zFields whose value allows an ``x in value`` check. The value needs to support the `in` operator, but is not constrained in how it does so (whether it defines `__contains__()` or `__getitem__()` is immaterial). Nrr{r|r}r>r>?rr|r>ceZdZdZy)r\zField requiring its value to be orderable. The set of value needs support a complete ordering; the implementation mechanism is not constrained. Either `__cmp__()` or 'rich comparison' methods may be used. Nrr{r|r}r\r\Hrr|r\ceZdZdZy)rQznA Field requiring its value to have a length. The value needs to have a conventional __len__ method. Nrr{r|r}rQrQQr|rQcTeZdZdZeedddZeedddZy)rTzField requiring its value to be between min and max. This implies that the value needs to support the IOrderable interface. Start of the rangeFNrrr-End of the range (including the value itself))rwrxryrzr r-minmaxr{r|r}rTrTXs= $% C ?@ Cr|rTcteZdZdZeededdddZeededddd Zy ) rUz DEL (chr(127)) are allowed The value might be constrained to be with length limits. Nrr{r|r}r3r3r|r3ceZdZdZy)r:z0Field containing a byte string without newlines.Nrr{r|r}r:r:s:r|r:ceZdZdZy)r4z7Field containing a 7-bit ASCII string without newlines.Nrr{r|r}r4r4Ar|r4ceZdZdZy)rez Field for source text of object.Nrr{r|r}reres*r|receZdZdZy)rhz3Field containing a unicode string without newlines.Nrr{r|r}rhrhs=r|rhceZdZdZy)rYz A field that always contains the native `str` type, without any newlines. .. versionchanged:: 4.9.0 This is now a distinct type instead of an alias for either `ITextLine` or `IBytesLine`, depending on the platform. Nrr{r|r}rYrYrr|rYceZdZdZy)r]zAbstract interface specifying that the value cannot be orderedNrr{r|r}rprp#sHr|rpc"eZdZdZedZy)r6z)An unordered collection of unique values.z1This ICollection interface attribute must be TruerNrwrxryrzrrr{r|r}r6r6's3 GIFr|r6c"eZdZdZedZy)r5zXAn unordered collection of values, with no limitations on whether members are uniquez2This ICollection interface attribute must be FalserNrr{r|r}r5r5.sHJFr|r5ceZdZdZy)rnzTField containing a value that implements the API of a conventional Python tuple.Nrr{r|r}rnrn9sr|rnceZdZdZy)rRzSField containing a value that implements the API of a conventional Python list.Nrr{r|r}rRrR>sr|rRceZdZdZy)rbzJField containing a value that implements the API of a Python2.4+ set. Nrr{r|r}rbrbCrr|rbceZdZdZy)rIz]Field containing a value that implements the API of a conventional Python 2.4+ frozenset.Nrr{r|r}rIrIHsr|rIc^eZdZdZeeedZeededdZ y) r[zz Field containing an Object value. .. versionchanged:: 4.6.0 Add the *validate_invariants* attribute. z`_ can be used to install a vocabulary registry that uses the :mod:`zope.component` architecture. cy)z Return the vocabulary named *name* for the content object *context*. When the vocabulary cannot be found, `LookupError` is raised. Nr{)rnames r}rzIVocabularyRegistry.get(rr|N)rwrxryrzrr{r|r}rsrss   r|rsceZdZdZdZy)rra An object that can create `IBaseVocabulary`. Objects that implement this interface can be registered with the default :class:`~.VocabularyRegistry` provided by this package. Alternatively, `zope.vocabularyregistry `_ can be used to install a `IVocabularyRegistry` that looks for named utilities using :func:`zope.component.getUtility` which provide this interface. cy)zKThe *context* provides a location that vocabulary can make use of. Nr{rs r}rzIVocabularyFactory.__call__?rr|N)rwrxryrzrr{r|r}rrrr1s   r|rrc0eZdZeedZedZy)rFzThe field that has been changedrzThe object containing the fieldN)rwrxryrrEfieldrrr{r|r}rFrFDs 5 7E8 9Fr|rFc0eZdZdZedZedZy)rGzo A field has been modified Subscribers will get the old and the new value together with the field z*The value of the field before modificationz)The value of the field after modificationN)rwrxryrzr old_value new_valuer{r|r}rGrGMs FGIEFIr|rGN)}rz __docformat__zope.interfacerrzope.interface.common.mappingrzope.interface.interfacesrzope.schema._bootstrapfieldsrr r r r r rrrrrr zope.schema._bootstrapinterfacesrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,zope.schema._messageidr-__all__r1r0r/r. Exceptionr2rErNr>r\rQrTrUrMr8r9rgrXr3r:r4rerhrYr]rZr=r`r_rLrKrHrBrAr@rjrirrrorJrDr^r;r<rarWrpr6r5rnrRrbrIr[rSrVrCrfrlrkrcrdr?r7rOrPrqrtrmrsrrrFrGr{r|r}r+s6" $$<0-00.,1//1--1DGH7999;:;:A8<JF>;3455<?6$d NGG7766??/i/w \w t6 j &6"f" F ZF-J 6- E];;BB+%+>> G G gv 4 w 4 H 4  6  < 9 4U w 4''#GV#(&(#GV#     # () f 2*i&B ByI;II'IJ'JY   < f.z9j*h O LIL  U  '>'  i    0 9  g  @g @ ?) ?(%(  ;  *,> ) 4  &:): G Gr|