o .j=@sbdZddlmZmZddlmZddlmZddlm Z ddl m Z m Z Gddde ZdgZd S) z$CAL-ADDRESS values from :rfc:`5545`.)AnyClassVar)Self)JCalParsingError) Parameters)DEFAULT_ENCODING to_unicodecseZdZUdZdZeeed<eed<dZ e dfde ee fdBdee Bded effd d Zd efd d Zd e fddZedee Bd efddZed efddZed efddZddlmZmZmZmZmZmZmZmZm Z m!Z!m"Z"eZ#e$ded efddZ%e          d0dedBdedBdedBdedBd edBd!edBd"edBd#edBd$e&dBd%edBded efd&d'Z'd(ed e(fd)d*Z)ed e(efd+d,Z*ed-e(d efd.d/Z+Z,S)1 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 Nvalueencodingreturncs(t||d}t||}t||_|S)N)r)rsuper__new__rr )clsr rr self __class__O/home/thesage/.local/lib/python3.10/site-packages/icalendar/prop/cal_address.pyr>s  zvCalAddress.__new__cCs d|dS)Nz vCalAddress('z')rrrrr__repr__Js zvCalAddress.__repr__cCs |tSN)encoderrrrrto_icalMs zvCalAddress.to_icalicalcCs||Srr)rrrrr from_icalPszvCalAddress.from_icalcCst|S)z$The ``mailto:`` part of the address.)strrrrr ical_valueTszvCalAddress.ical_valuecCs"|dr |ddSt|S)z3The email address without ``mailto:`` at the start.mailto:N)lower startswithrrrrremailYs zvCalAddress.emailr) CNCUTYPEDELEGATED_FROM DELEGATED_TODIRLANGUAGEPARTSTATROLERSVPSENT_BYVALUEr%cCs|ds d|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%rrr _get_emailps zvCalAddress._get_emailcncutypedelegated_from delegated_to directorylanguagepartstatrolersvpsent_byc Cst|tstdt|j||} || } |dur!|| jd<|dur*|| jd<|dur6||| jd<|durB||| jd<|durK|| jd<|durT|| jd<|dur]|| jd <| durf| | jd <| durs| rnd nd | jd <| dur|| | 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-TOr*r+r,r-TRUEFALSEr.zSENT-BY) isinstancer TypeErrortype__name__r1r )rr%r2r3r4r5r6r7r8r9r:r;email_with_prefixaddrrrrnews2 8       zvCalAddress.newnamecCs||j|j|jgS)z$Return this property in jCal format.)r to_jcalr0r#r )rrErrrrFszvCalAddress.to_jcalcCs|jdddgS)zExamples of vCalAddress.zyou@example.orgz You There)r2)rD)rrrrexamplesszvCalAddress.examples jcal_propertycCs6t||t|dt|d||dt|dS)zParse jCal from :rfc:`7265`. Parameters: jcal_property: The jCal property to parse. Raises: ~error.JCalParsingError: If the provided jCal is invalid. r )rvalidate_propertyvalidate_value_typerrfrom_jcal_property)rrHrrr from_jcals zvCalAddress.from_jcal) NNNNNNNNNN)-rA __module__ __qualname____doc__r rr__annotations__r __slots__rdictrbytesrrrr classmethodrpropertyr r%icalendar.paramr&r'r(r)r*r+r,r-r.r/r0rE staticmethodr1boolrDlistrFrGrM __classcell__rrrrr s . 4      Xr N)rPtypingrricalendar.compatibilityricalendar.errorricalendar.parserricalendar.parser_toolsrrrr __all__rrrrs    j