i=pdZddlmZmZddlmZddlmZddlm Z ddl m Z m Z Gdde ZdgZd S) z$CAL-ADDRESS values from :rfc:`5545`.)AnyClassVar)Self)JCalParsingError) Parameters)DEFAULT_ENCODING to_unicodec@eZdZUdZdZeeed<eed<dZ e dfde ee fdzdee zded effd Zd efd Zd e fd Zed ee zd efdZed efdZed efdZddlmZmZmZmZmZmZmZmZm Z m!Z!m"Z"eZ#e$ded efdZ%e d%dedzdedzdedzdedzdedzdedzdedzdedzde&dzdedzded efdZ'd ed e(fd!Z)ed e(efd"Z*ed#e(d efd$Z+xZ,S)& vCalAddressa(Calendar User Address Value Name: CAL-ADDRESS Purpose: This value type is used to identify properties that contain a calendar user address. Description: The value is a URI as defined by [RFC3986] or any other IANA-registered form for a URI. When used to address an Internet email transport address for a calendar user, the value MUST be a mailto URI, as defined by [RFC2368]. Example: ``mailto:`` is in front of the address. .. code-block:: ics mailto:jane_doe@example.com Parsing: .. code-block:: pycon >>> from icalendar import vCalAddress >>> cal_address = vCalAddress.from_ical('mailto:jane_doe@example.com') >>> cal_address vCalAddress('mailto:jane_doe@example.com') Encoding: .. code-block:: pycon >>> from icalendar import vCalAddress, Event >>> event = Event() >>> jane = vCalAddress("mailto:jane_doe@example.com") >>> jane.name = "Jane" >>> event["organizer"] = jane >>> print(event.to_ical().decode().replace('\\r\\n', '\\n').strip()) BEGIN:VEVENT ORGANIZER;CN=Jane:mailto:jane_doe@example.com END:VEVENT z CAL-ADDRESS default_valueparamsr Nvalueencodingreturnct||}t||}t||_|S)N)r)r super__new__rr )clsrrr self __class__s U/root/projects/butler/venv/lib/python3.11/site-packages/icalendar/prop/cal_address.pyrzvCalAddress.__new__>sB58444wwsE** ((  cd|dS)Nz vCalAddress('z')rs r__repr__zvCalAddress.__repr__Js't''''rc6|tSN)encoderrs rto_icalzvCalAddress.to_icalMs{{+,,,ricalc||Srr)rr"s r from_icalzvCalAddress.from_icalPss4yyrc t|S)z$The ``mailto:`` part of the address.)strrs r ical_valuezvCalAddress.ical_valueTs4yyrc|dr |ddSt|S)z3The email address without ``mailto:`` at the start.mailto:N)lower startswithr&rs remailzvCalAddress.emailYs; ::<< " "9 - - 8O4yyrr) CNCUTYPEDELEGATED_FROM DELEGATED_TODIRLANGUAGEPARTSTATROLERSVPSENT_BYVALUEr-c^|dsd|S|S)aExtract email and add mailto: prefix if needed. Handles case-insensitive mailto: prefix checking. Parameters: email: Email string that may or may not have mailto: prefix Returns: Email string with mailto: prefix r))r+r,)r-s r _get_emailzvCalAddress._get_emailps5{{}}'' 22 %$U$$ $ rcncutypedelegated_from delegated_to directorylanguagepartstatrolersvpsent_byc "t|ts$tdt|j||} || } | || jd<| || jd<|||| jd<|||| jd<| || jd<| || jd<| || jd <| | | jd <| | rd nd | jd <| || | jd<| S)aCreate a new vCalAddress with RFC 5545 parameters. Creates a vCalAddress instance with automatic mailto: prefix handling and support for all standard RFC 5545 parameters. Parameters: email: The email address (mailto: prefix added automatically if missing) cn: Common Name parameter cutype: Calendar user type (INDIVIDUAL, GROUP, RESOURCE, ROOM) delegated_from: Email of the calendar user that delegated delegated_to: Email of the calendar user that was delegated to directory: Reference to directory information language: Language for text values partstat: Participation status (NEEDS-ACTION, ACCEPTED, DECLINED, etc.) role: Role (REQ-PARTICIPANT, OPT-PARTICIPANT, NON-PARTICIPANT, CHAIR) rsvp: Whether RSVP is requested sent_by: Email of the calendar user acting on behalf of this user Returns: vCalAddress: A new calendar address with specified parameters Raises: TypeError: If email is not a string Examples: Basic usage: >>> from icalendar.prop import vCalAddress >>> addr = vCalAddress.new("test@test.com") >>> str(addr) 'mailto:test@test.com' With parameters: >>> addr = vCalAddress.new("test@test.com", cn="Test User", role="CHAIR") >>> addr.params["CN"] 'Test User' >>> addr.params["ROLE"] 'CHAIR' zEmail must be a string, not Nr.r/zDELEGATED-FROMz DELEGATED-TOr2r3r4r5TRUEFALSEr6zSENT-BY) isinstancer& TypeErrortype__name__r:r )rr-r;r<r=r>r?r@rArBrCrDemail_with_prefixaddrs rnewzvCalAddress.newsFp%%% SQ4;;;OQQRR R NN511s$%% > "DK   $*DK !  %,/NN>,J,JDK( )  #*-..*F*FDK '  !*DK   &.DK #  &.DK #  "&DK   ,0"=&&gDK   %(^^G%<%>>,]1-=sCKKKs ! 0??    r) NNNNNNNNNN)-rK __module__ __qualname____doc__r rr&__annotations__r __slots__rdictrbytesrrrr! classmethodr$propertyr'r-icalendar.paramr.r/r0r1r2r3r4r5r6r7r8rO staticmethodr:boolrNlistrQrSrZ __classcell__)rs@rr r s,,\$1M8C=000 I )(,   S#X% U{         (#((((-----S5[T[CXsX                           D # #   \  !%)#' $## "VV $J V d V d VDjV:V*V*VDjVTkVtVV VVV[VpRCRDRRRR<d<<<[< d t   [     rr N)r]typingrricalendar.compatibilityricalendar.errorricalendar.parserricalendar.parser_toolsrr r&r __all__rrrros** ((((((,,,,,,''''''????????f f f f f #f f f R /r