iLdZddlmZmZmZmZddlddlmZddl m Z ddl Z ddl Z ddl Z ddlZddlmZddlZddlmZdd lmZd ZGd d eZy) z podgen.media ~~~~~~~~~~~~ This file contains the Media class, which represents a pointer to a media file. :copyright: 2016, Thorben Dahl :license: FreeBSD and LGPL, see license.* for more details. )absolute_importdivisionprint_functionunicode_literals)*)urlparse) raise_fromN)TinyTag)NotSupportedByItunesWarning)versionc t}|SN)requestsSessionr nameversion_full_strheaders)requests_sessions E/root/podcast_feed/.venv/lib/python3.12/site-packages/podgen/media.py_get_new_requests_sessionrs $ ceZdZdZdddddddd Z d!d Zed Zejd ZedZ edZ e jdZ e dZ edZ e jdZ dZedZejdZedZe d"dZdZdZdZdZdZdZe dZd Zy )#Mediaa Data-oriented class representing a pointer to a media file. A media file can be a sound file (most typical), video file or a document. You should provide the absolute URL at which this media can be found, and the media's file size in bytes. Optionally, you can provide the type of media (expressed using MIME types). When not given in the constructor, it will be found automatically by looking at the url's file extension. If the url's file extension isn't supported by iTunes, you will get an error if you don't supply the type. You are also highly encouraged to provide the duration of the media. .. note:: iTunes is lazy and will just look at the URL to figure out if a file is of a supported file type. You must therefore ensure your URL ends with a supported file extension. .. note:: A warning called :class:`~podgen.warnings.NotSupportedByItunesWarning` will be issued if your URL or type isn't compatible with iTunes. See the Python documentation for more details on :mod:`warnings`. Media types supported by iTunes: * Audio * M4A * MP3 * Video * MOV * MP4 * M4V * Document * PDF * EPUB All attributes will always have a value, except size which can be 0 if the size cannot be determined by any means (eg. if it's a stream) and duration which is optional (but recommended). .. seealso:: :ref:`podgen.Media-guide` for a more gentle introduction. z audio/x-m4az audio/mpegzvideo/quicktimez video/mp4z video/x-m4vzapplication/pdfzdocument/x-epub)m4amp3movmp4m4vpdfepubNcd|_d|_d|_d|_||_||_|xs|j ||_||_|xs t|_ yr) _url_size_type _durationurlsizeget_typetypedurationrr)selfr&r'r)r*rs r__init__zMedia.__init__fs^    .DMM#.   0 O4M4O rc|jS)aThe URL at which this media is publicly accessible. Only absolute URLs are allowed, so make sure it starts with http:// or https://. The server should support HEAD-requests and byte-range requests. Ensure you quote parts of the URL that are not supposed to carry any special meaning to the browser, typically the name of your file. Common offenders include the slash character when not used to separate folders, the hash mark (#) and the question mark (?). Use :func:`urllib.parse.quote` in Python3 and :func:`urllib.quote` in Python2. :type: :obj:`str` )r"r+s rr&z Media.urls"yyrcb|s tdt|}|jjddj }||j vrt jd|ztd|jdvr)t jd|jztd||_ y) Nzurl cannot be empty or None.z-File extension %s is not supported by iTunes. stacklevel)httphttpsz\URL scheme %s is not supported by iTunes. Make sure you use absolute URLs and HTTP or HTTPS.) ValueErrorrpathsplitlower file_typeswarningswarnr schemer")r+r& parsed_urlfile_extensions rr&z Media.urls:; ;c] #..s3B7==?  0 MMI*+,G%& (   $5 5 MME&--./J%& ( rcjdt|jjjddzS)zYThe file extension of :attr:`~.Media.url`. Read-only. :type: :obj:`str` r0r1)rr&r8r9r.s rr@zMedia.file_extensions. Xdhh',,2237;;;rc|jS)aThe media's file size in bytes. You can either provide the number of bytes as an :obj:`int`, or you can provide a human-readable :obj:`str` with a unit, like MB or GiB. An unknown size is represented as 0. This should ONLY be used in exceptional cases, where it is theoretically impossible to determine the file size (for example if it's a stream). Setting the size to 0 will issue a UserWarning. :type: :obj:`str` (which will be converted to and stored as :obj:`int`) or :obj:`int` .. note:: If you provide a string, it will be translated to int when the assignment happens. Thus, on subsequent accesses, you will get the resulting int, not the string you put in. .. note:: The units are case-insensitive. This means that the ``B`` is always assumed to mean "bytes", even if it is lowercase (``b``). Likewise, ``m`` is taken to mean mega, not milli. )r#r.s rr'z Media.sizes6zzrc t|}|dkr td||_|jdk(rt j ddyy#t$r|j ||_Yyt$r}|d|_n|Yd}~yd}~wwxYw)Nrz6File size must be 0 if unknown, or a positive integer.zSize is set to 0. This should ONLY be done when there is no possible way to determine the media's size, like if the media is a stream.r3)intr7r#r'r<r= _str_to_bytes TypeError)r+r'es rr'z Media.sizes t9Dax "-..DJyyA~ M*+,  1**40DI |  sAA B -B 5 BB c 8ddddddddd d }t|jjjd d }t |j d }|j d} t|||zS#t$rtd|zwxYw)zParse ``size`` and return the number of bytes it names. See :attr:`.Media.size` for more information on this conversion.iii@Biiʚ;i@lJ)l) bkbkibmbmibgbgibtbtib bkimgtz 0123456789.zThe unit %s was not recognized.) strr:stripreplacefloatrstriplstriproundKeyErrorr7)r'unitsnumberunits rrFzMedia._str_to_bytess   4y &&(00b9t{{8,-{{=) G%+-. . G>EF F Gs 0BBc|jS)a(The MIME type of this media. See https://en.wikipedia.org/wiki/Media_type for an introduction. :type: :obj:`str` .. note:: If you leave out type when creating a new Media object, the type will be auto-detected from the :attr:`~podgen.Media.url` attribute. However, this won't happen automatically other than during initialization. If you want to autodetect type when assigning a new value to url, you should use :meth:`~podgen.Media.get_type`. )r$r.s rr)z Media.types"zzrc|s td|jj}||jj vrt j d|ztd||_y)NzType cannot be empty or Nonez)Media type %s is not supported by iTunes.r2r3) r7rXr:r;valuesr<r=r r$)r+r)s rr)z Media.type s[;< <zz|!!# t--/ / MMEL5! E rct|jjddj} |j|S#t $r"}t td|z|Yd}~yd}~wwxYw)aGuess the MIME type from the URL. This is used to fill in :attr:`~.Media.type` when it is not given (and thus called implicitly by the constructor), but you can call it yourself. Example:: >>> from podgen import Media >>> m = Media("http://example.org/1.mp3", 136532744) >>> # The type was detected from the url: >>> m.type audio/mpeg >>> # Ops, I changed my mind... >>> m.url = "https://example.org/1.m4a" >>> # As you can see, the type didn't change: >>> m.type audio/mpeg >>> # So update type yourself >>> m.type = m.get_type(m.url) >>> m.type audio/x-m4a :param url: The URL which should be used to guess the MIME type. :type url: str :returns: The guessed MIME type. :raises: ValueError if the MIME type couldn't be guessed from the URL. r0r1zThe file extension %s was not recognized, which means it's not supported by iTunes. If this is intended, please provide the type yourself so clients can see what type of file it is.N)rr8r9r:r;r^r r7)r+r&r@rHs rr(zMedia.get_typesy:"#++11#6r:@@B &??>2 2 & zP!!"$%  & & &sA A1A,,A1c|jS)a6The duration of the media file. :type: :class:`datetime.timedelta` :raises: :obj:`TypeError` if you try to assign anything other than :class:`datetime.timedelta` or :obj:`None` to this attribute. Raises :obj:`ValueError` if a negative timedelta value is given. )r%r.s rr*zMedia.duration<s~~rc|d|_yt|tjs t d|j dkrt d|z||_y)Nz/duration must be a datetime.timedelta instance!rz%expected a positive timedelta, got %s)r% isinstancedatetime timedeltarG total_secondsr7)r+r*s rr*zMedia.durationGsT  !DNHh&8&89MN N  # # % )DxOP P%DNrc|jy|jjdz|jjdzz}|jjdzdz}|jjdz}|rd|||fzSd||fzS)aw:attr:`.duration`, formatted as a string according to iTunes' specs. That is, HH:MM:SS if it lasts more than an hour, or MM:SS if it lasts less than an hour. This is just an alternate, read-only view of :attr:`.duration`. If :attr:`.duration` is :obj:`None`, then this will be :obj:`None` as well. :type: :obj:`str` Ni<z%02d:%02d:%02dz %02d:%02d)r*daysseconds)r+hoursminutesrps r duration_strzMedia.duration_strRs == MM&&+MM))T12E}},,2b8Gmm++b0G'5'7*CCC"gw%777rc>|r|sV|xs t}|j|dd}|j|s |jd}|s |jd}t ||||S#t$rt d|zwxYw#t$rt d|zwxYw)aCreate new Media object, with size and/or type fetched from the server when not given. See :meth:`.Media.fetch_duration` for a (slow!) way to fill in the duration as well. Example (assuming the server responds with Content-Length: 252345991 and Content-Type: audio/mpeg):: >>> from podgen import Media >>> # Assume an episode is hosted at example.com >>> m = Media.create_from_server_response( ... "http://example.com/episodes/ep1.mp3") >>> m Media(url=http://example.com/episodes/ep1.mp3, size=252345991, type=audio/mpeg, duration=None) :param url: The URL at which the media can be accessed right now. :type url: str :param size: Size of the file. Will be fetched from server if not given. :type size: int or None :param type: The media type of the file. Will be fetched from server if not given. :type type: str or None :param duration: The media's duration. :type duration: :class:`datetime.timedelta` or :obj:`None` :param requests_: Either the `requests `_ module itself, or a :class:`requests.Session` object. Defaults to a new :class:`~requests.Session`. :type requests_: :mod:`requests` or :class:`requests.Session` :returns: New instance of Media with url, size and type filled in. :raises: The appropriate requests exceptions are thrown when networking errors occur. RuntimeError is thrown if some information isn't given and isn't found in the server's response.Tg$@)allow_redirectstimeoutzContent-LengthzEContent-Length not returned by server when sending HEAD request to %sz Content-TypezJContent-Type header not returned by server when sending HEAD request to %s)rheadraise_for_statusrr^ RuntimeErrorr)clsr&r'r)r* requests_rs rcreate_from_server_responsez!Media.create_from_server_responselsN!@%>%@IsD$GA   P99%56D.99^4D S$h// P&(IKN(OPPP  .&(P),(-...sA) B)BBc pd|jd|jd|jd|jd S)Nz Media(url=z, size=z, type=z , duration=))r&r'r)r*r.s r__str__z Media.__str__s%$))TYY ? ?rc"|jSr)rr.s r__repr__zMedia.__repr__s||~rc@|jj}|d=|S)Nr)__dict__copyr+states r __getstate__zMedia.__getstate__s" ""$ $ % rcX|jj|t|_yr)rupdaterrrs r __setstate__zMedia.__setstate__s U# 9 ;rc|jj|jd}|jd}t |d} |r|}n t |d}|j dD]}|j|~ |r|s|jyyy#tttf$r<|r8|s6 |jtj|#t$rYwxYwwxYw#|r|s|jwwwxYw)a%Download the media file. This method will block until the file is downloaded in its entirety. .. note:: The destination will not be populated atomically; if you need this, you must give provide a temporary file as destination and rename the file yourself. :param destination: Where to save the media file. Either a filename, or a file-like object. The file-like object will *not* be closed by PodGen. :type destination: :obj:`fd` or :obj:`str`. T)streamNwritewb) chunk_size)rgetr&rxhasattropen iter_contentr ExceptionKeyboardInterruptInterruptedErrorcloseosremoveFileNotFoundError)r+ destinationr|fddestination_is_fdchunks rdownloadzMedia.downloads"  ! ! % %dhht % <  #K9   +t,489+ ,r,.>? +HHJIIk* )   + ,rs<:BC)2%CC) C$!C)#C$$C))C,,Dc0|j||_y)adPopulate :attr:`.Media.duration` by analyzing the given file. Use this method when you have the media file on the local file system. Use :meth:`.Media.fetch_duration` if you need to download the file from the server. :param filename: Path to the media file which shall be used to determine this media's duration. The file extension must match its file type, since it is used to determine what type of media file it is. For a list of supported formats, see https://pypi.python.org/pypi/tinytag/ :type filename: str N)_get_duration_ofr*)r+filenames rpopulate_duration_fromzMedia.populate_duration_froms--h7 rchtjtj|jS)agReturn the duration of the media file located at ``filename``. Use :meth:`.Media.populate_duration_from` if you want to populate the duration property of a Media instance using a local file. :param filename: Path to the media file which shall be used to determine this media's duration. The file extension must match its file type, since it is used to determine what type of media file it is. For a list of supported formats, see https://pypi.python.org/pypi/tinytag/ :type filename: str :returns: datetime.timedelta )rp)rirjr rr*)rs rrzMedia._get_duration_ofs$!!'++h*?*H*HIIrc<d} tjd|j5}|j}|j |ddd|j ||rt j|yy#1swY3xYw#|rt j|wwxYw)asDownload :attr:`.Media.url` locally and use it to populate :attr:`.Media.duration`. Use this method when you don't have the media file on the local file system. Use :meth:`~.Media.populate_duration_from` otherwise. This method will take quite some time, since the media file must be downloaded before it can be analyzed. NF)deletesuffix)tempfileNamedTemporaryFiler@rrrrr)r+rrs rfetch_durationzMedia.fetch_durations $,, )<)<>AC77 b!>  ' ' 1 (# >>  (#s"!BA5B5A>:BB)rNNN)NNNN)__name__ __module__ __qualname____doc__r;r,propertyr&setterr@r' staticmethodrFr)r(r*rs classmethodr}rrrrrrrrrrrr+s|/b  !J9="& 6$ ZZ <<8 [[(GG,$ [[  %&N__&&882>B=A8080t? <)V8 JJ $rr)r __future__rrrrbuiltinsfuture.moves.urllib.parser future.utilsr rrr<ritinytagr rpodgen.warningsr podgenr robjectrrrrrsG SR.# 7 k$Fk$r