i@dZddlmZmZmZmZddlGddeZy)z podgen.person ~~~~~~~~~~~~~ This file contains the Person class, which is used to represent a person or an entity. :copyright: 2016, Thorben Dahl :license: FreeBSD and LGPL, see license.* for more details. )absolute_importdivisionprint_functionunicode_literals)*ceZdZdZd dZdZedZejdZedZ e jdZ d Z d Z y) PersonacData-oriented class representing a single person or entity. A Person can represent both real persons and less personal entities like organizations. Example:: >>> p.authors = [Person("Example Radio", "mail@example.org")] .. note:: At any time, one of name or email must be present. Both cannot be None or empty at the same time. .. warning:: **Any names and email addresses** you put into a Person object will eventually be included and **published** together with the feed. If you want to keep a name or email address private, then you must make sure it isn't used in a Person object (or to be precise: that the Person object with the name or email address isn't used in any Podcast or Episode.) Example of use:: >>> from podgen import Person >>> Person("John Doe") Person(name=John Doe, email=None) >>> Person(email="johndoe@example.org") Person(name=None, email=johndoe@example.org) >>> Person() ValueError: You must provide either a name or an email address. NcZ|j||s td||_||_y)aCreate new person with a name, email or both. You don't need to provide both a name and an email, but you must provide one of them. :param name: This person's name. :type name: str or None :param email: This person's email address. The address it made public when the feed is published, so be careful about adding a personal email address here. The spambots are always on lookout! :type email: str or None z3You must provide either a name or an email address.N) _is_valid ValueError _Person__name_Person__emailselfnameemails F/root/podcast_feed/.venv/lib/python3.12/site-packages/podgen/person.py__init__zPerson.__init__3s2~~dE*() )  c|xs|S)z/Check whether one of name and email are usable.rs rr zPerson._is_validGs }urc|jS)z7This person's name. :type: :obj:`str` )r rs rrz Person.nameKs {{rc|j||jstd|d|jd||_y)NzCThe name or email must be present at any time, cannot set name to "z" as long as email is "")r rr r )rnew_names rrz Person.nameSs:~~h 3)14::?@ @ rc|jS)zGThis person's public email address. :type: :obj:`str` )rrs rrz Person.email[s ||rc|j|j|std|d|jd||_y)NzDThe name or email must be present at any time, cannot set email to "z" as long as name is "r)r rr r)r new_emails rrz Person.emailcs:~~dii3)2DII?@ @! rc|j |jS|j |jS|jd|jdS)Nz ())rrrs r__str__zPerson.__str__ks= :: 99  YY ::  $ DII6 6rc<d|jd|jdS)Nz Person(name=z, email=r!)rrrs r__repr__zPerson.__repr__ss.2iiDDr)NN) __name__ __module__ __qualname____doc__rr propertyrsetterrr"r$rrrr r suB( [[ \\!!7Err N) r( __future__rrrrbuiltinsobjectr rrrr.s& SRcEVcEr