CjIBSrSSKJr SSKrSSKrSSKJrJr SSKJ r J r SSK J r J r Jr SSKJr SSKr\ "SS 55r\ "S S 55r"S S \5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5rg)z This module provides a number of classes for validating input. See [Validating Input](/widgets/input/#validating-input) for details. ) annotationsN)ABCabstractmethod) dataclassfield)CallablePatternSequence)urlparsec\rSrSr%Sr\"\S9rS\S'\ S Sj5r \ SSj5r \ SSj5r \ SS j5r\ SS j5rS rg )ValidationResultz4The result of calling a `Validator.validate` method.)default_factorySequence[Failure]failuresc[SU55nUVVs/sHo"RHo3PM M nnnU(a[R5$[R U5$s snnf)zMerge multiple ValidationResult objects into one. Args: results: List of ValidationResult objects to merge. Returns: Merged ValidationResult object. c38# UHoRv M g7fN)is_valid).0results d/home/rurouni/.local/share/pipx/venvs/strix-agent/lib/python3.13/site-packages/textual/validation.py )ValidationResult.merge..&s=W6Ws)allrr successfailure)resultsrrrrs rmergeValidationResult.merges[=W==*1Q'gGG'Q #++- -#++H5 5 RsA)c[5$)zVConstruct a successful ValidationResult. Returns: A successful ValidationResult. r rrValidationResult.success-s  !!r$c[U5$)zsConstruct a failure ValidationResult. Args: failures: The failures. Returns: A failure ValidationResult. r"rs rrValidationResult.failure6s ))r$cxURVs/sHnURcMURPM sn$s snf)zUtility for extracting failure descriptions as strings. Useful if you don't care about the additional metadata included in the `Failure` objects. Returns: A list of the string descriptions explaining the failing validations. )r descriptionselfrs rfailure_descriptions%ValidationResult.failure_descriptionsBs> == ("" G  (   s77c2[UR5S:H$)z&True if the validation was successful.r)lenrr,s rrValidationResult.is_validQs4==!Q&&r$r#N)rzSequence['ValidationResult']returnz'ValidationResult'r3r )rrr3r )r3z list[str])r3bool)__name__ __module__ __qualname____firstlineno____doc__rlistr__annotations__ staticmethodrrrpropertyr-r__static_attributes__r#r$rr r sz>"'"=H=J66 "" * *    ''r$r cZ\rSrSr%SrS\S'SrS\S'SrS\S'S S jrS S jr S r g)FailureWz'Information about a validation failure. Validator validatorN str | Nonevaluer*cURcTURRbURRUlgURRU5Ulggr)r*rDfailure_descriptiondescribe_failurer1s r __post_init__Failure.__post_init__bsL    #~~11=#'>>#E#E #'>>#B#B4#H $r$c#`# URv URv URv g7fr)rFrDr*r1s r __rich_repr__Failure.__rich_repr__js%jjnns,.)r*)r3None)r3zrich.repr.Result) r6r7r8r9r:r<rFr*rJrMr?r#r$rrArAWs313E:9"K"tIr$rAcp\rSrSrSrS S Sjjr\S Sj5rS SjrSSjr SSSjjr S r g)rCpaBase class for the validation of string values. Commonly used in conjunction with the `Input` widget, which accepts a list of validators via its constructor. This validation framework can also be used to validate any 'stringly-typed' values (for example raw command line input from `sys.args`). To implement your own `Validator`, subclass this class. Example: ```python def is_palindrome(value: str) -> bool: """Check has string has the same code points left to right, as right to left.""" return value == value[::-1] class Palindrome(Validator): def validate(self, value: str) -> ValidationResult: if is_palindrome(value): return self.success() else: return self.failure("Not a palindrome!") ``` NcXlgrrH)r,rHs r__init__Validator.__init__s #6  r$cg)abValidate the value and return a ValidationResult describing the outcome of the validation. Implement this method when defining custom validators. Args: value: The value to validate. Returns: The result of the validation ([`self.success()`][textual.validation.Validator.success) or [`self.failure(...)`][textual.validation.Validator.failure]). Nr#r,rFs rvalidateValidator.validatesr$cUR$)aReturn a string description of the Failure. Used to provide a more fine-grained description of the failure. A Validator could fail for multiple reasons, so this method could be used to provide a different reason for different types of failure. !!! warning This method is only called if no other description has been supplied. If you supply a description inside a call to `self.failure(description="...")`, or pass a description into the constructor of the validator, those will take priority, and this method won't be called. Args: failure: Information about why the validation failed. Returns: A string description of the failure. rSr+s rrIValidator.describe_failures$'''r$c[5$)zShorthand for `ValidationResult(True)`. Return `self.success()` from [`validate()`][textual.validation.Validator.validate] to indicated that validation *succeeded*. Returns: A ValidationResult indicating validation succeeded. r"r1s rrValidator.successs  !!r$cp[U[5(aU/n[U=(d [XUS9/5nU$)aShorthand for signaling validation failure. Return `self.failure(...)` from [`validate()`][textual.validation.Validator.validate] to indicated that validation *failed*. Args: description: The failure description that will be used. When used in conjunction with the Input widget, this is the description that will ultimately be available inside the handler for `Input.Changed`. If not supplied, the `failure_description` from the `Validator` will be used. If that is not supplied either, then the `describe_failure` method on `Validator` will be called. value: The value that was considered invalid. This is optional, and only needs to be supplied if required in your `Input.Changed` handler. failures: The reasons the validator failed. If not supplied, a generic `Failure` will be included in the ValidationResult returned from this function. Returns: A ValidationResult representing failed validation, and containing the metadata supplied to this function. )rDrFr*) isinstancerAr )r,r*rFrrs rrValidator.failures;0 h ( ( zH!  W4+VW  r$rSr)rHrEr3rOrFstrr3r rrAr3rEr4NNN)r*rErFrErz"Failure | Sequence[Failure] | Noner3r ) r6r7r8r9r:rTrrXrIrrr?r#r$rrCrCpse.     (("#' 7; 5   r$rCcp^\rSrSrSrS S U4Sjjjr"SS\5rS SjrS Sjr Sr U=r $) RegexzGA validator that checks the value matches a regex (via `re.fullmatch`).c:>[TU]US9 XlX lgNrS)superrTregexflags)r,rkrlrH __class__s rrTRegex.__init__s& -@A E 2r$c\rSrSrSrSrg)Regex.NoResultszYIndicates validation failed because the regex could not be found within the value string.r#Nr6r7r8r9r:r?r#r$r NoResultsrpsgr$rscURn[R"X!URS9SLnU(d%[R X5/nUR US9$UR5$)zEnsure that the value matches the regex. Args: value: The value that should match the regex. Returns: The result of the validation. )rlNr')rkre fullmatchrlrfrsrr)r,rFrk has_matchrs rrXRegex.validatesW LLTZZ@L 45H<<<2 2||~r$c>SUR<SURS3$)Describes why the validator failed. Args: failure: Information about why the validation failed. Returns: A string description of the failure. zMust match regular expression z (flags=z).)rkrlr+s rrIRegex.describe_failures"0 ~Xdjj\QSTTr$)rlrk)rN)rkzstr | Pattern[str]rlzint | re.RegexFlagrHrEr3rOrarc) r6r7r8r9r:rTrArsrXrIr? __classcell__rms@rrfrfs]Q %&*. 3! 3" 3( 3  3 3hGh U Ur$rfc^\rSrSrSrS S U4Sjjjr"SS\5r"SS\5rSSjr SS jr SS jr S r U=r $)Numberi zKValidator that ensures the value is a number, with an optional range check.c:>[TU]US9 XlX lgrirjrTminimummaximumr,rrrHrms rrTNumber.__init__s& -@A ^ ^r$c\rSrSrSrSrg)Number.NotANumberiziIndicates a failure due to the value not being a valid number (decimal/integer, inc. scientific notation)r#Nrrr#r$r NotANumberrswr$rc\rSrSrSrSrg)Number.NotInRangeizTIndicates a failure due to the number not being within the range [minimum, maximum].r#Nrrr#r$r NotInRangersbr$rc[U5n[ R"U5(d[ R"U5(a)[R[R X5/5$URU5(d)[R[RX5/5$UR5$![a, [R[R X5/5s$f=f)zEnsure that `value` is a valid number, optionally within a range. Args: value: The value to validate. Returns: The result of the validation. ) float ValueErrorr rrrmathisnanisinf_validate_rangerr)r,rF float_values rrXNumber.validate!s N,K ::k " "djj&=&=#++V->->t-K,LM M##K00#++""4/0 ||~ N#++V->->t-K,LM M Ns B;;3C10C1cxURbXR:agURbXR:agg)z_Return a boolean indicating whether the number is within the range specified in the attributes.FT)rrrWs rrNumber._validate_range8s1 << # (< << # (<r$cd[U[R5(ag[U[R5(aqURcUR bSUR S3$URbUR cSURS3$SURSUR S3$g)rzzMust be a valid number.NMust be less than or equal to .!Must be greater than or equal to Must be between  and )r_rrrrrr+s rrINumber.describe_failure@s gv00 1 1, !2!2 3 3||# (@7 ~QGG)dll.B:4<<.JJ)$,,uT\\N!LLr$rrrd)r float | NonerrrHrEr3rOra)rFrr3r5rc)r6r7r8r9r:rTrArrrXrrIr?r|r}s@rrr swU!% $*. _ _ _( _  _ _xWxcWc.r$rcP^\rSrSrSr"SS\5rSU4SjjrS SjrSr U=r $) IntegeriVzKValidator which ensures the value is an integer which falls within a range.c\rSrSrSrSrg)Integer.NotAnIntegeriYz?Indicates a failure due to the value not being a valid integer.r#Nrrr#r$r NotAnIntegerrYsMr$rc>[TU]U5nUR(dU$[U5nUR5$![a, [ R [RX5/5s$f=f)zEnsure that `value` is an integer, optionally within a range. Args: value: The value to validate. Returns: The result of the validation. ) rjrXrintrr rrrr)r,rFnumber_validation_result int_valuerms rrXInteger.validate\ss$)7#3E#: '00+ + QE I||~ Q#++W-A-A$-N,OP P Qs A3A65A6c[U[R[R45(ag[U[R5(aqUR cUR bSUR S3$UR bUR cSUR S3$SUR SUR S3$g)rzzMust be a valid integer.Nrrrrr)r_rrrrrrr+s rrIInteger.describe_failureqs g 2 2G4H4HI J J- !3!3 4 4||# (@7 ~QGG)dll.B:4<<.JJ)$,,uT\\N!LLr$r#rarc) r6r7r8r9r:rArrXrIr?r|r}s@rrrVs#UNwN*r$rcr^\rSrSrSrS S U4Sjjjr"SS\5rS SjrS Sjr Sr U=r $) Lengthiz5Validate that a string is within a range (inclusive).c:>[TU]US9 XlX lgrirrs rrTLength.__init__s& -@A N Nr$c\rSrSrSrSrg)Length.IncorrectizKIndicates a failure due to the length of the value being outside the range.r#Nrrr#r$r IncorrectrsYr$rcDURSL=(a [U5UR:nURSL=(a [U5UR:nU(dU(a)[R [ R X5/5$UR5$)zEnsure that value falls within the maximum and minimum length constraints. Args: value: The value to validate. Returns: The result of the validation. N)rr0rr rrrr)r,rF too_shorttoo_longs rrXLength.validatestLL,JUdll1J <[TU]US9 Xlgri)rjrTfunction)r,rrHrms rrTFunction.__init__s -@A hr$c\rSrSrSrSrg)Function.ReturnedFalseizIIndicates validation failed because the supplied function returned False.r#Nrrr#r$r ReturnedFalsersWr$rcURU5nU(aUR5$UR[R X5S9$)zValidate that the supplied function returns True. Args: value: The value to pass into the supplied function. Returns: A ValidationResult indicating success if the function returned True, and failure if the function return False. r')rrrrr)r,rFrs rrXFunction.validates===' <<> !||X%;%;D%H|IIr$cUR$)rzrSr+s rrIFunction.describe_failures'''r$)rr)rzCallable[[str], bool]rHrEr3rOrarc) r6r7r8r9r:rTrArrXrIr?r|r}s@rrrsTS +/i'i(i  iiXX J ( (r$rcB\rSrSrSr"SS\5rS SjrS SjrSr g) URLizGValidator that checks if a URL is valid (ensuring a scheme is present).c\rSrSrSrSrg)URL.InvalidURLiz$Indicates that the URL is not valid.r#Nrrr#r$r InvalidURLrs2r$rc[R[RX5/5n[ U5n[ UR UR/5(dU$UR5$![a Us$f=f)zValidates that `value` is a valid URL (contains a scheme). Args: value: The value to validate. Returns: The result of the validation. ) r rrrr rschemenetlocrr)r,rF invalid_url parsed_urls rrX URL.validatesz'..t0K/LM  !%J )):+<+<=>>""? ||~   s2A// A>=A>cg)rzzMust be a valid URL.r#r+s rrIURL.describe_failures&r$r#Nrarc) r6r7r8r9r:rArrXrIr?r#r$rrrsQ3W3& &r$r)r: __future__rrruabcrr dataclassesrrtypingrr r urllib.parser rich.reprrichr rArCrfrrrrrr#r$rrs# #(..! >'>' >'B  0kk\+UI+U\GYGT.f.b1Y1h'(y'(T"&)"&r$