o .j)@svdZddlmZmZmZddlmZddlmZddl m Z ddl m Z m Z GdddeZGd d d Zdd gZd S) zADR property of :rfc:`6350`.)AnyClassVar NamedTuple)Self)JCalParsingError) Parameters)DEFAULT_ENCODING to_unicodec@sVeZdZUdZeed< eed< eed< eed< eed< eed< eed<d S) AdrFieldszNamed fields for vCard ADR (Address) property per :rfc:`6350#section-6.3.1`. Provides named access to the seven address components. po_boxextendedstreetlocalityregion postal_codecountryN)__name__ __module__ __qualname____doc__str__annotations__rrG/home/thesage/.local/lib/python3.10/site-packages/icalendar/prop/adr.pyr s r c@seZdZUdZdZeeed<eed<e ed< d!de ee fdBde edfe eBeBe Bfdd Zd efd d Zed eeBd e fddZded efddZd efddZed e fddZddlmZded e fddZede d efddZed e efdd ZdS)"vAdravCard ADR (Address) structured property per :rfc:`6350#section-6.3.1`. The ADR property represents a delivery address as a single text value. The structured type value consists of a sequence of seven address components. The component values must be specified in their corresponding position. - post office box - extended address (e.g., apartment or suite number) - street address - locality (e.g., city) - region (e.g., state or province) - postal code - country name (full name) When a component value is missing, the associated component separator MUST still be specified. Semicolons are field separators and are NOT escaped. Commas and backslashes within field values ARE escaped per :rfc:`6350`. Examples: .. code-block:: pycon >>> from icalendar.prop import vAdr >>> adr = vAdr(("", "", "123 Main St", "Springfield", "IL", "62701", "USA")) >>> adr.to_ical() b';;123 Main St;Springfield;IL;62701;USA' >>> vAdr.from_ical(";;123 Main St;Springfield;IL;62701;USA") AdrFields(po_box='', extended='', street='123 Main St', locality='Springfield', region='IL', postal_code='62701', country='USA') TEXT default_valueparamsfieldsN.cCsft|tr ||}t|tr||_nt|dkr"tdt|tdd|D|_t||_dS)a8Initialize ADR with seven fields or parse from vCard format string. Parameters: fields: Either an AdrFields, tuple, or list of seven strings, one per field, or a vCard format string with semicolon-separated fields params: Optional property parameters $ADR must have exactly 7 fields, got css|]}t|VqdSN)r.0frrr Ysz vAdr.__init__..N) isinstancer from_icalr rlen ValueErrorrr)selfrrrrr__init__Es   z vAdr.__init__returncs0ddlmfdd|jD}d|tS)z6Generate vCard format with semicolon-separated fields.rvTextcsg|] }|tqSr)to_icaldecoderr"r-rr bsz vAdr.to_ical..;)icalendar.prop.textr.rjoinencoder)r*partsrr-rr/\s z vAdr.to_icalicalcCsHddlm}t|}||}t|dkr tdt|d|t|S)zParse vCard ADR format into an AdrFields named tuple. Parameters: ical: vCard format string with semicolon-separated fields Returns: AdrFields named tuple with seven field values. r)split_on_unescaped_semicolonrr z: )icalendar.parserr8r r(r)r )r7r8rrrrr'es  zvAdr.from_icalothercCst|to |j|jkS)z self == other)r&rr)r*r:rrr__eq__ysz vAdr.__eq__cCs|jjd|jd|jdS)zString representation.(z , params=)) __class__rrrr*rrr__repr__}sz vAdr.__repr__cCs|jS)z$The address fields as a named tuple.)rr?rrr ical_valueszvAdr.ical_valuer)VALUEnamecCs&||j|jg}||j|S)zBThe jCal representation of this property according to :rfc:`7265`.)rto_jcalrBlowerextendr)r*rCresultrrrrDs z vAdr.to_jcal jcal_propertycCstt||t|dkrtdt|t|ddddD] \}}t|t||q|t|ddt|S)zParse jCal from :rfc:`7265`. Parameters: jcal_property: The jCal property to parse. Raises: ~error.JCalParsingError: If the provided jCal is invalid. zDADR must have 10 elements (name, params, value_type, 7 fields), got N)start) rvalidate_propertyr( enumeratevalidate_value_typertuplerfrom_jcal_property)clsrHifieldrrr from_jcals zvAdr.from_jcalcCs |dgS)zExamples of vAdr.)rUz 123 Main St SpringfieldIL62701USAr)rQrrrexampless z vAdr.examplesr!) rrrrrrrrrr dictrrOlistr+bytesr/ staticmethodr'objectboolr;r@propertyrAicalendar.paramrBrD classmethodrrTrZrrrrr!s0    rN)rtypingrrricalendar.compatibilityricalendar.errorrr9ricalendar.parser_toolsrr r r__all__rrrrs