o /hG@sBdZdgZddlZddlmZddlmZGdddejjZ dS)z;Property is a single CSS property in a CSSStyleDeclaration.PropertyN) Deprecated) PropertyValuecsJeZdZdZ d7fdd ZddZd d Zd d Zd dZddZ e ee ddZ ddZ e dde ddZ e ddddZddZe ddeddZdd Zd!d"Ze eed#dZd$d%Ze d&d'Zejd(d'Ze d)dd*dZe d+d,Zejd-d,Zd.d/Ze ed0dZed1d2d3Zed1d4d5Ze eed6dZZS)8ra:A CSS property in a StyleDeclaration of a CSSStyleRule (cssutils). Format:: property = name : IDENT S* ; expr = value : term [ operator term ]* ; term : unary_operator? [ NUMBER S* | PERCENTAGE S* | LENGTH S* | EMS S* | EXS S* | ANGLE S* | TIME S* | FREQ S* | function ] | STRING S* | IDENT S* | URI S* | hexcolor ; function : FUNCTION S* expr ')' S* ; /* * There is a constraint on the color that it must * have either 3 or 6 hex-digits (i.e., [0-9a-fA-F]) * after the "#"; e.g., "#000" is OK, but "#abcd" is not. */ hexcolor : HASH S* ; prio : IMPORTANT_SYM S* ; NFcsxtgdgg|_d|_||_||_d|_d|_d|_t |d|jd<|r-||_ ||_ d|_ d|_ |r:||_dSdS)a :param name: a property name string (will be normalized) :param value: a property value string :param priority: an optional priority string which currently must be u'', u'!important' or u'important' :param _mediaQuery: if ``True`` value is optional (used by MediaQuery) :param parent: the parent object, normally a :class:`cssutils.css.CSSStyleDeclaration` NFrparentr)super__init__seqs wellformed _mediaQueryr_Property__nametoken_name _literalnamername propertyValue _priority_literalprioritypriority)selfrvaluerr r __class__I/var/www/html/myenv/lib/python3.10/site-packages/cssutils/css/property.pyr /s"   zProperty.__init__c Cs*d|jjd|jd|jjd|jd S)Nz cssutils.css.z(name=z, value=z , priority=))r__name__ literalnamercssTextrrrrr__repr__Ss*zProperty.__repr__cCsHd|jjd|jjd|jd|jjd|jd|jdt|dd S) N<.z object name=z value=z priority=z valid=z at 0xx>) r __module__rrrrrvalididr rrr__str__VsHzProperty.__str__cCs z|jjWStyYdSw)z%Return True if validation is enabled.T)r validatingAttributeErrorr rrr _isValidatingYs   zProperty._isValidatingcCs tj|S)z#Return serialized property cssText.)cssutilsser do_Propertyr rrr _getCssTextas zProperty._getCssTextcCsH||}|j|dd}|rd}|j|dd}|j|dd}|jr.|s.||_d|_d|_dS|}||dkrHd}|j d| ||n|sXd}|j d | |||rm||d d krl| d |d nd}|j d | |||rd|_ ||_||_||_| r|dSdSdS|j d | |dS)a :exceptions: - :exc:`~xml.dom.SyntaxErr`: Raised if the specified CSS string value has a syntax error and is unparsable. - :exc:`~xml.dom.NoModificationAllowedErr`: Raised if the rule is readonly. T)propertynameendonly)propertyvalueendonly)propertypriorityendonlyN:Fz%Property: No ":" after name found: %sz$Property: No property name found: %s!rz%Property: No property value found: %s) _tokenize2 _tokensupto2r rrrpop _tokenvalue_logerror _valuestrinsertr r,validate)rr tokenizer nametokensr valuetokensprioritytokens colontokenrrr _setCssTextesZ       zProperty._setCssTextz"A parsable textual representation.)fgetfsetdoccsddddfdd }g}jd||d|id\}}|o$d }t|tr2|d }|_nd}d sGd }jjd ||d|rvd_d _  j _ |j d < rsj tjjvrsjjd|dddS dSd _dS)z :exceptions: - :exc:`~xml.dom.SyntaxErr`: Raised if the specified name has a syntax error and is unparsable. NT)rr csFd|kr|d<|ddSdd<jd||S)NrrEOFFr Property: Unexpected ident.)r:lowerappendr;r<)expectedseqtokenr@newrrr_identsz!Property._setName.._identrIDENTrMrNr@ productionsr rrFzProperty: No name found: %s)rOz Property: Unknown Property name.rO neverraiseN)_parser7 isinstancelistrr;r<r=r r _normalizerr r,r-profile knownNameswarn)rrrRnewseqr rMrOrrPr_setNames<        zProperty._setNamecC|jSrX)rr rrrzProperty.zName of this property.)rHcCrbrX)rr rrrrcrdz7Readonly literal (not normalized) name of this propertycCsB|jr|st|d|jd<dS||jd_|jo|jdj|_dS)a See css.PropertyValue :exceptions: - :exc:`~xml.dom.SyntaxErr`: Raised if the specified CSS string value has a syntax error (according to the attached property) or is unparsable. - :exc:`~xml.dom.InvalidModificationErr`: TODO: Raised if the specified CSS string value represents a different type of values than the values allowed by the CSS property. rrN)r rr rr rrrrr_setPropertyValues  zProperty._setPropertyValuecCs |jdS)Nr)r r rrrrcs z+(cssutils) PropertyValue object of propertycCs|jr|jjSdS)Nr)rrr rrr _getValue szProperty._getValuecC||dSrXrf)rrrrr _setValueszProperty._setValuez3The textual value of this Properties propertyValue.cC ||_dSrX)r)rrrrr _setPrioritys zProperty._setPrioritycCrb)zPriority of this property.)rr rrrrzProperty.prioritycs"jrd_d_|rjddSt|tr#d|kr#d|}ddddfdd }dfd d }g}jd | |||d d\}}|oPd}|rddsdd}j d ||rj oj|_ d_j _|jd<jdvrjdjdSdSdS)a priority a string, currently either u'', u'!important' or u'important' Format:: prio : IMPORTANT_SYM S* ; "!"{w}"important" {return IMPORTANT_SYM;} :exceptions: - :exc:`~xml.dom.SyntaxErr`: Raised if the specified priority has a syntax error and is unparsable. In this case a priority not equal to None, "" or "!{w}important". As CSSOM defines CSSStyleDeclaration.getPropertyPriority resulting in u'important' this value is also allowed to set a Properties priority rz0Property: No priority in a MediaQuery - ignored.N importantz!%sT)literalpriorityr csJ|}d|kr|krnn||dSdd<jd||S)Nr6rnFr zProperty: Unexpected char.r:rLr;r<rMrNrOr@valrPrr_charFs  z Property.priority.._charcsB|}d|kr|d<||dSdd<jd||S)NrnrorIFr rJrprqrPrrrRQs  z!Property.priority.._identr6)CHARrSrTr roFzProperty: Invalid priority: %srrnz#Property: No CSS priority value: %srX)r rrr;r<rZstrr\rYr7infor=r ror )rrrsrRr`r rMrrPrr"s>          cCrbrX)rr rrrrcurdz;Readonly literal (not normalized) priority of this propertycCrb)zAThe Parent Node (normally a CSSStyledeclaration) of this Property_parentr rrrryrmzProperty.parentcCrkrXry)rrrrrr~s cCs*d}d}z|jj}Wn tyYnw|dur#|j|jkr#tjjg}|jr|j r|jtjj vrtj |j|j |\}}}|sR|j j dd||j f|jddn:|rx|sx|s`dtjj}n|}|j jd|d||j f|jddd}n|r|j jdd||j f|jdd|jd vrd}|S) aC Validate value against `profiles` which are checked dynamically. properties in e.g. @font-face rules are checked against ``cssutils.profile.CSS3_FONT_FACE`` only. For each of the following cases a message is reported: - INVALID (so the property is known but not valid) ``ERROR Property: Invalid value for "{PROFILE-1[/PROFILE-2...]" property: ...`` - VALID but not in given profiles or defaultProfiles ``WARNING Property: Not valid for profile "{PROFILE-X}" but valid "{PROFILE-Y}" property: ...`` - VALID in current profile ``DEBUG Found valid "{PROFILE-1[/PROFILE-2...]" property...`` - UNKNOWN property ``WARNING Unknown Property name...`` is issued so for example:: cssutils.log.setLevel(logging.DEBUG) parser = cssutils.CSSParser() s = parser.parseString('''body { unknown-property: x; color: 4; color: rgba(1,2,3,4); color: red }''') # Log output: WARNING Property: Unknown Property name. [2:9: unknown-property] ERROR Property: Invalid value for "CSS Color Module Level 3/CSS Level 2.1" property: 4 [3:9: color] DEBUG Property: Found valid "CSS Color Module Level 3" value: rgba(1, 2, 3, 4) [4:9: color] DEBUG Property: Found valid "CSS Level 2.1" value: red [5:9: color] and when setting an explicit default profile:: cssutils.profile.defaultProfiles = cssutils.profile.CSS_LEVEL_2 s = parser.parseString('''body { unknown-property: x; color: 4; color: rgba(1,2,3,4); color: red }''') # Log output: WARNING Property: Unknown Property name. [2:9: unknown-property] ERROR Property: Invalid value for "CSS Color Module Level 3/CSS Level 2.1" property: 4 [3:9: color] WARNING Property: Not valid for profile "CSS Level 2.1" but valid "CSS Color Module Level 3" value: rgba(1, 2, 3, 4) [4:9: color] DEBUG Property: Found valid "CSS Level 2.1" value: red [5:9: color] FNz-Property: Invalid value for "%s" property: %s/TrVz>Property: Not valid for profile "%s" but valid "%s" value: %s z$Property: Found valid "%s" value: %srv)r parentRuler+typeFONT_FACE_RULEr-r]CSS3_FONT_FACErrr^validateWithProfiler;r<joinrdefaultProfilesr_debugr)rr'profilesrulematching validprofilesnotvalidprofilesrrrr?sb>         zProperty.validatezCCheck if value of this property is valid in the properties context.z'Use ``property.propertyValue`` instead.cCrbrX)rr rrr _getCSSValueszProperty._getCSSValuecCrhrXrirerrr _setCSSValue szProperty._setCSSValuez4(DEPRECATED) Use ``property.propertyValue`` instead.)NNrFN) rr& __qualname____doc__r r!r)r,r0rEpropertyrrarrrfrrgrjrrlrsetterrorr?r'rrrcssValue __classcell__rrrrr sr$$CA  Q    ) r__all__r-cssutils.helperrrrutilBaserrrrrs