o .j@s`dZddlmZmZddlmZddlmZddlm Z ddl m Z m Z GdddZ dgZd S) z"The ORG property from :rfc:`6350`.)AnyClassVar)Self)JCalParsingError) Parameters)DEFAULT_ENCODING to_unicodec@sPeZdZUdZdZeeed<eed<e edfed< d%de ee fdBde edfe eBeBfdd Z d efd d Zed eeBd e edffddZded efddZd efddZed efddZed e edffddZed e edffddZddlmZded e fddZed e d efd!d"Zed e efd#d$Z dS)&vOrga vCard ORG (Organization) structured property per :rfc:`6350#section-6.6.4`. The ORG property specifies the organizational name and units associated with the vCard. Its value is a structured type consisting of components separated by semicolons. The components are the organization name, followed by zero or more levels of organizational unit names: .. code-block:: text organization-name; organizational-unit-1; organizational-unit-2; ... Semicolons are field separators and are NOT escaped. Commas and backslashes within field values ARE escaped per :rfc:`6350`. Examples: A property value consisting of an organizational name, organizational unit #1 name, and organizational unit #2 name. .. code-block:: ics ORG:ABC\, Inc.;North American Division;Marketing The same example in icalendar. .. code-block:: pycon >>> from icalendar.prop import vOrg >>> org = vOrg(("ABC, Inc.", "North American Division", "Marketing")) >>> org.to_ical() b'ABC\\, Inc.;North American Division;Marketing' >>> vOrg.from_ical(r"ABC\, Inc.;North American Division;Marketing") ('ABC, Inc.', 'North American Division', 'Marketing') TEXT default_valueparams.fieldsNcCsJt|tr ||}t|dkrtdtdd|D|_t||_dS)a%Initialize ORG with variable fields or parse from vCard format string. Parameters: fields: Either a tuple or list of one or more strings, or a vCard format string with semicolon-separated fields params: Optional property parameters z2ORG must have at least 1 field (organization name)css|]}t|VqdSN)str.0frG/home/thesage/.local/lib/python3.10/site-packages/icalendar/prop/org.py Esz vOrg.__init__..N) isinstancer from_icallen ValueErrortupler rr )selfr r rrr__init__4s  z vOrg.__init__returncs0ddlmfdd|jD}d|tS)z6Generate vCard format with semicolon-separated fields.rvTextcsg|] }|tqSr)to_icaldecoderrrrr Lsz vOrg.to_ical..;)icalendar.prop.textr r joinencoder)rpartsrrrr!Hs z vOrg.to_icalicalcCs>ddlm}t|}||}t|dkrtd|t|S)zParse vCard ORG format into a tuple of fields. Parameters: ical: vCard format string with semicolon-separated fields Returns: Tuple of field values with one or more fields r)split_on_unescaped_semicolonrz ORG must have at least 1 field: )icalendar.parserr*rrrr)r)r*r rrrrOs  zvOrg.from_icalothercCst|to |j|jkS)z self == other)rr r )rr,rrr__eq__asz vOrg.__eq__cCs|jjd|jd|jdS)zString representation.(z , params=)) __class____name__r r rrrr__repr__esz vOrg.__repr__cCs |jdS)z$The organization name (first field).rr r2rrrnamei z vOrg.namecCs|jddS)z@The organizational unit names (remaining fields after the name).rNr4r2rrrunitsnsz vOrg.unitscCs|jS)z#The organization fields as a tuple.r4r2rrr ical_valuesszvOrg.ical_valuer)VALUEr5cCs&||j|jg}||j|S)zBThe jCal representation of this property according to :rfc:`7265`.)r to_jcalr9lowerextendr )rr5resultrrrr:zs z vOrg.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. zLORG must have at least 4 elements (name, params, value_type, org name), got N)start) rvalidate_propertyr enumeratevalidate_value_typerrrfrom_jcal_property)clsr>ifieldrrr from_jcals zvOrg.from_jcalcCs |dgS)zExamples of vOrg.)zABC Inc.zNorth American Division Marketingr)rFrrrexamplesr6z vOrg.examplesr)!r1 __module__ __qualname____doc__r rr__annotations__rrdictrlistrbytesr! staticmethodrobjectboolr-r3propertyr5r7r8icalendar.paramr9r: classmethodrrIrKrrrrr s8 $   r N)rNtypingrricalendar.compatibilityricalendar.errorrr+ricalendar.parser_toolsrrr __all__rrrrs