tfJ/dZddlZddlmZmZmZGddeZGddeZGdd Z Gd d e Z Gd d e Z Gdde Z Gdde Z Gdde ZGdde ZGddeZGdde ZGdde ZGdde ZGddeZGd d!eZGd"d#e ZGd$d%e Zd&ZGd'd(e ZGd)d*eZGd+d,ZGd-d.ZGd/d0ZdS)1z Form-based method objects. This module contains support for descriptive method signatures that can be used to format methods. N)AnyOptionalTupleceZdZdZdZdS) FormExceptionz*An error occurred calling the form method.c8tj|g|R||_dSN) Exception__init__ descriptions)selfargskwargss X/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/twisted/python/formmethod.pyr zFormException.__init__s)4'$''''"N)__name__ __module__ __qualname____doc__r rrrrs)44#####rrceZdZdZdS) InputErrorz, An error occurred with some input. NrrrrrrrrrrrcLeZdZUdZdZeed< d dZdZd dZ dZ d Z d Z dS) ArgumentzBase class for form arguments.NdefaultDefaultct||_||_||j}||_||_||_|si}||_dSr )name allowNonerdefault shortDesclongDeschints)r r r"r#r$r%r!s rr zArgument.__init__%sL " ?)G "   E rc :|j|dSr )r%update)r rs raddHintszArgument.addHints3s &!!!!!rc8|j||Sr )r%get)r r r"s rgetHintzArgument.getHint6sz~~dG,,,rcB|jp|jSr )r#r capitalizer s rgetShortDescriptionzArgument.getShortDescription9s~7!5!5!7!77rc|jpdS)N)r$r.s rgetLongDescriptionzArgument.getLongDescription<s}""rc td)z(Convert the value to the correct format.zimplement in subclass)NotImplementedErrorr vals rcoercezArgument.coerce?s!"9:::r)NNNNrr ) rrrrrr__annotations__r r(r+r/r2r7rrrrrs((NCXY    """----888###;;;;;rrcFeZdZUdZdZeed<dZdZ d dZ dZ dS) StringzA single string.r1rrNrc dt|||||||||_||_dS)N)r"r#r$r%r!)rr minmax) r r r"r#r$r%r!r<r=s rr zString.__init__KsJ       rct|}t||jkrtd|jz|j/t||jkrtd|jzt|S)N)Value must be at least %s characters long(Value must be at most %s characters long)strlenr<rr=)r r6ss rr7z String.coercebsq HH q66DH  H48STT T 8 CFFTX$5$5G$(RSS S3xxr)NNNNrrN) rrrrrrAr8r<r=r r7rrrr:r:DspNC C C  .rr:ceZdZdZdS)TextzA long string.NrrrrrErEksrrEceZdZdZdS)Passwordz-A string which should be obscured when input.NrrrrrGrGos7777rrGceZdZdZdZdS)VerifiedPasswordzCA string that should be obscured when input and needs verification.cbt|dks|d|dkrtdt|d}t||jkrtd|jz|j/t||jkrtd|jz|S)Nrrz%Please enter the same password twice.r?r@)rBrrAr<r=)r valsrCs rr7zVerifiedPassword.coercevs t99>>T!WQ//DEE E QLL q66DH  H48STT T 8 CFFTX$5$5G$(RSS SrN)rrrrr7rrrrIrIss)MMrrIceZdZdZdS)HiddenzSA string which is not displayed. The passed default is used as the value. NrrrrrNrNsrrNc>eZdZUdZdZeeed< ddZdZ dS)IntegerzA single integer.Nrrc Ft|||||||dSr rr r r r!r"r#r$r%s rr zInteger.__init__* $gy(E9UUUUUrc|s |jrdS t|S#t$r#t d|wxYw)Nz5{} is not valid, please enter a whole number, e.g. 10)stripr!int ValueErrorrformatr5s rr7zInteger.coercesoyy{{ t~ 4 s88O   JQQRUVV  s .-ArNNNN) rrrrrrrWr8r r7rrrrPrPs^$(NHSM(((UYVVVVrrPc&eZdZ ddZdZdS) IntegerRangerNc d||_||_t|||||||dS)N)r!r"r#r$r%)r<r=rPr ) r r r<r=r!r"r#r$r%s rr zIntegerRange.__init__sN        rc&t||}|jr|dkr|S||jkr(t d||j||jkr(t d||j|S)Nz/Value {} is too small, it should be at least {}z.Value {} is too large, it should be at most {})rPr7r!r<rrYr=)r r6results rr7zIntegerRange.coercesc** > fnnM DH  AHHDH  DH  @GGDH   rrZrrrr r7rrrr\r\sH     .rr\c:eZdZUdZeeed< ddZdZdS)FloatNrrc Ft|||||||dSr rRrSs rr zFloat.__init__rTrc|s |jrdS t|S#t$rt d|zwxYw)NzInvalid float: %s)rVr!floatrXrr5s rr7z Float.coerces`yy{{ t~ 4 8::  8 8 803677 7 8s .A rZ) rrrrrrer8r r7rrrrbrbsX&*NHUO***UYVVVV88888rrbc,eZdZdZggddddfdZdZdS)Choicea The result of a choice between enumerated types. The choices should be a list of tuples of tag, value, and description. The tag will be the value returned if the user hits "Submit", and the description is the bale for the enumerated type. default is a list of all the values (seconds element in choices). If no defaults are specified, initially the first item will be selected. Only one item can (should) be selected at once. Nrc ||_|r#|s!||ddt|||||||dS)Nrrr!)choicesappendrr )r r rjr"r#r$r%r!s rr zChoice.__init__sj  *7 * NN71:a= ) ) ) $Hey      rcV|jD]\}}}||kr|cStd|z)NzInvalid Choice: %s)rjr)r inIdentidentr6descs rr7z Choice.coercesI $  = = E3  1G;<< |s |jrdS|r|Std)Nz Invalid File)r!r)r files rr7z File.coerceGs3 - -4  -K^,, ,r)rNNNr`rrrrrAs7    -----rrc>t|}|dkrt|S)Nr)rWrX)xs r positiveIntrPs! AAAvv HrcPeZdZUdZdZeeeeefed< ddZ dZ dS)Datez#A date -- (year, month, day) tuple.Nrrcht||||||||_|s d|_dSdS)N)irr)rr r!rrSs rr z Date.__init__\sI $gy(EJJJ" /".D    / /rct|dkr |jrdS tt|\}}}n#t$rt dwxYw||fdkr+t j|st d|z|||fS t j|}n#t$rt dwxYw||krt d|||fS)z(Return tuple of ints (year, month, day).)r1r1r1Nz Invalid date)rKz%d was not a leap year) tupler!maprrXrcalendarisleapmdays IndexError)r ryearmonthdayrs rr7z Date.coerceds ;;, & &4> &4 -";55 D% - - -^,, , - 3<7 " "?4(( ( !9D!@AAAUC'' -N5)EE - - -^,, , - ;;^,, ,UCs8A BB6rZ) rrrrrrrrWr8r r7rrrrrWsf--59NHU3S=12999UY////     rrc.eZdZdZdgdddddfdZdZdS)Submitz0Submit button or a reasonable facsimile thereof.)rsubmitz Submit formrNcbt||||||||_||_dS)N)rjr#r$r%)rgr r!reset)r r rjrr#r$r!r%s rr zSubmit.__init__~sE       # rcN|jr|sdSt||Sr )r!rgr7)r values rr7z Submit.coerces, > .% .4==u-- -rrprrrrr{sT:: 55*.....rrceZdZdZdS)PresentationHintz( A hint to a particular system. Nrrrrrrrrrc&eZdZdZdZdZddZdS)MethodSignaturez$ A signature of a callable. c||_dS)r1N)methodSignature)r sigLists rr zMethodSignature.__init__s&rc8|jD]}|j|kr|cSdSr )rr )r r as r getArgumentzMethodSignature.getArguments7%  Av~~  rFc$t|||Sr ) FormMethod)r callable takesRequests rmethodzMethodSignature.methods$,777rNF)rrrrr rrrrrrrsP''' 888888rrc&eZdZdZddZdZdZdS)rz#A callable object with a signature.Fc0||_||_||_dSr ) signaturerr)r rrrs rr zFormMethod.__init__s"  (rc4t|jjSr )rrrr.s rgetArgszFormMethod.getArgssT^3444rc|j|i|Sr )r)r rkws rcallzFormMethod.callst}d)b)))rNr)rrrrr rrrrrrrsL--)))) 555*****rr)rrtypingrrrr rrrr:rErGrIrNrPr\rbrgrrr~rrrrrrrrrrrrrs ''''''''''#####I### ";";";";";";";";J$$$$$X$$$N688888v888     v   Vh4(((((7(((V88888H888,!=!=!=!=!=X!=!=!=H%%%%%H%%%P                h - - - - -8 - - -   ! ! ! ! ! 8! ! ! H.....V...> 88888888$ * * * * * * * * * *r