o .j@svdZddlmZmZmZddlmZddlmZddl m Z ddl m Z m Z GdddeZGd d d Zdd gZd S) zN property from :rfc:`6350`.)AnyClassVar NamedTuple)Self)JCalParsingError) Parameters)DEFAULT_ENCODING to_unicodec@sBeZdZUdZeed< eed< eed< eed< eed<dS)NFieldszNamed fields for vCard N (Name) property per :rfc:`6350#section-6.2.2`. Provides named access to the five name components. familygiven additionalprefixsuffixN)__name__ __module__ __qualname____doc__str__annotations__rrE/home/thesage/.local/lib/python3.10/site-packages/icalendar/prop/n.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)"vNa vCard N (Name) structured property per :rfc:`6350#section-6.2.2`. The N property represents a person's name. It consists of a single structured text value. Each component in the structure may have multiple values, separated by commas. The structured property value corresponds, in sequence, to the following fields: - family names (also known as surnames) - given names - additional names - honorific prefixes - honorific suffixes 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 vN >>> n = vN(("Doe", "John", "M.", "Dr.", "Jr.,M.D.,A.C.P.")) >>> n.to_ical() b'Doe;John;M.;Dr.;Jr.\\,M.D.\\,A.C.P.' >>> vN.from_ical(r"Doe;John;M.;Dr.;Jr.\,M.D.\,A.C.P.") NFields(family='Doe', given='John', additional='M.', prefix='Dr.', suffix='Jr.,M.D.,A.C.P.') TEXT default_valueparamsfieldsN.cCsft|tr ||}t|tr||_nt|dkr"tdt|tdd|D|_t||_dS)a2Initialize N with five fields or parse from vCard format string. Parameters: fields: Either an NFields, tuple, or list of five strings, one per field, or a vCard format string with semicolon-separated fields params: Optional property parameters "N must have exactly 5 fields, got css|]}t|VqdSN)r.0frrr SszvN.__init__..N) isinstancer from_icalr rlen ValueErrorrr)selfrrrrr__init__?s   z vN.__init__returncs0ddlmfdd|jD}d|tS)z6Generate vCard format with semicolon-separated fields.rvTextcsg|] }|tqSr)to_icaldecoderr r+rr ZszvN.to_ical..;)icalendar.prop.textr,rjoinencoder)r(partsrr+rr-Vs z vN.to_icalicalcCsHddlm}t|}||}t|dkr tdt|d|t|S)zParse vCard N format into an NFields named tuple. Parameters: ical: vCard format string with semicolon-separated fields Returns: NFields named tuple with five field values. r)split_on_unescaped_semicolonrrz: )icalendar.parserr6r r&r'r )r5r6rrrrr%]s  z vN.from_icalothercCst|to |j|jkS)z self == other)r$rr)r(r8rrr__eq__osz vN.__eq__cCs|jjd|jd|jdS)zString representation.(z , params=)) __class__rrrr(rrr__repr__ssz vN.__repr__cCs|jS)z!The name fields as a named tuple.)rr=rrr ical_valuewsz vN.ical_valuer)VALUEnamecCs&||j|jg}||j|S)zBThe jCal representation of this property according to :rfc:`7265`.)rto_jcalr@lowerextendr)r(rAresultrrrrB~s z vN.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. zAN must have 8 elements (name, params, value_type, 5 fields), got N)start) rvalidate_propertyr& enumeratevalidate_value_typertuplerfrom_jcal_property)clsrFifieldrrr from_jcals z vN.from_jcalcCs |dgS)zExamples of vN.)DoeJohnzM.zDr.zJr.r)rOrrrexampless z vN.examplesr) rrrrrrrrrr dictrrMlistr)bytesr- staticmethodr%objectboolr9r>propertyr?icalendar.paramr@rB classmethodrrRrUrrrrrs0   rN)rtypingrrricalendar.compatibilityricalendar.errorrr7ricalendar.parser_toolsrr r r__all__rrrrs