Fe(tdZddlmZddlZddlZddlmZddlmZddl m Z m Z ddl m Z ddlmZdd lmZdd lmZmZdd lmZmZdd lmZmZmZdd lmZe rddlmZej@e!Z"dZ#ejHdZ%GddeZ&Gdde&Z'Gdde&Z(ddZ)Gdde&Z*ddZ+y)z#Docutils transforms used by Sphinx.) annotationsN)sha1)ceil) TYPE_CHECKINGAny)nodes)__)SphinxTransform)loggingrequests)epoch_to_rfc1123rfc1123_to_epoch)get_image_extensionguess_mimetypeparse_data_uri) ensuredir)Sphinx z [:;<>|*" ]c6eZdZddZddZddZed dZy) BaseImageConverterc |jjtjD]%}|j |s|j |'yN)documentfindallrimagematchhandle)selfkwargsnodes J/usr/lib/python3/dist-packages/sphinx/transforms/post_transforms/images.pyapplyzBaseImageConverter.applys<MM))%++6 "Dzz$ D! "cy)NTrr s r!rzBaseImageConverter.match#sr#cyrr%r&s r!rzBaseImageConverter.handle&s r#cjtjj|jjdS)Nimages)ospathjoinapp doctreedirrs r!imagedirzBaseImageConverter.imagedir)s!ww||DHH//::r#N)rrreturnNoner nodes.imager1boolr r4r1r2)r1str)__name__ __module__ __qualname__r"rrpropertyr0r%r#r!rrs%"  ;;r#rc eZdZdZddZddZy)ImageDownloaderdc|jjjgk(ry|jjjryd|dvS)NF://uri)r-buildersupported_image_typessupported_remote_imagesr&s r!rzImageDownloader.match1sB 88   1 1R 7 88   3 3U ##r#c tjj|d}d|vr|jdd}|dk(st |t kDrQtjj |d\}}t|jdj|z}tjtd|}|djdd jtdd td d i}t |t kDr)t|jdj}t!tjj#|j$|tjj#|j$||}i}tjj'|r6t)tj*|j,}t/||d <t1j2|d| } | j4d k\r1t6j9t;d|d| j4fzy|d|j<j>j@|<| j4dk(r0tC|d5} | jE| jFddd| jHj3d} | r#tK| }tjL|||ftO|d} | dk7rtjj |ddk(rtQ| }tjj#|j$|||z} tj|| |j<j>j@jS||d|j<j>j@| <| }|djSd||d| <||d<|j<j>jTjW|j>jX|y#1swYxYw#tZ$r0}t6j9t;d|d|fzYd}~yd}~wwxYw)NrA?rFusedforsecurity_r@/&zIf-Modified-Since)headersiz%Could not fetch remote image: %s [%d]wbz last-modified*)default candidatesz%Could not fetch remote image: %s [%s]).r*r+basenamesplitlenMAX_FILENAME_LENsplitextrencode hexdigestresubCRITICAL_PATH_CHAR_REreplace translateordrr,r0existsrstatst_mtimer r get status_codeloggerwarningr r-envoriginal_image_uriopenwritecontentrMrutimerrpopr)add_filedocname Exception)rr rTfilenameextdirnamer+rM timestamprf last_modifiedmimetypenewpathexcs r!rzImageDownloader.handle8sv3 ]ww''U 4Hh#>>#.q12~X1A!A " 0 0e = # 15ISSUX[[vv3S(CH5k))%5??S3ADS3APQG7|..w~~/GQQS bggll4==': ;77<< wADGww~~d##' (>(>#? /? /J+, T%[':A}}#r"IJ $U Q]]; <=9=U  //5==C'dD)+Q *+!" o >  0 ?IHHTIy#9:)$<s?rww'7'7'A!'D'J-h7C ggll4=='8c>RGJJtW-HHLL3377=?CE{DHHLL33G<"D\"&&s+/3\"8,"U  ##,,TXX-=-=tD)++* ] NN2EF$u+WZI[[ \ \ ]s8IP8AP8P+ F P8+P50P88 Q1&Q,,Q1Nr3r6r8r9r:default_priorityrrr%r#r!r=r=.s$4]r#r=c eZdZdZddZddZy)DataURIExtractorc|jjjgk(ry|jjjdury|dj dS)NFTrAzdata:)r-rBrDsupported_data_uri_images startswithr&s r!rzDataURIExtractor.matchrsM 88   3 3r 9 88   5 5 =E{%%g..r#cTt|d}|Jt|j}|(tj t d|ddd|yt tjj|jdt|jdj}tjj|jd||z}|d|jjj |<t#|d5}|j%|jddd|d j'd ||d |j<||d<|jjj(j+|jj,|y#1swYyxYw) NrAzUnknown image format: %s...r)locationembededFrHrOrSrF)rrryrfrgr rr*r+r,r0rdatarZr-rhrirjrkrnr)rorp)rr rrsdigestr+rws r!rzDataURIExtractor.handleysStE{+   !%..1 ; NN2;N$(  * "'',,t}}i89ejj%8BBDww||DMM9fslC04U  ''- $   GGEJJ   \s#-1\5>>*U   $$TXX%5%5t<   s FF'Nr3r6r|r%r#r!rros/=r#rctjj|}tjt d|}tjj |dt|xsdzS)NrJrrG)r*r+rTr[r\r]rXr)rrryrTs r!get_filename_forrsSww)Hvv+S(;H 77  H %a (,?,I,OR PPr#cveZdZUdZdZdZded<gZded<dfd Zdd Z dd Z dd Z dd Z dd Z ddZxZS)ImageConverteraA base class for image converters. An image converter is kind of Docutils transform module. It is used to convert image files which are not supported by a builder to the appropriate format for that builder. For example, :py:class:`LaTeX builder <.LaTeXBuilder>` supports PDF, PNG and JPEG as image formats. However it does not support SVG images. For such case, using image converters allows to embed these unsupported images into the document. One of the image converters; :ref:`sphinx.ext.imgconverter ` can convert a SVG image to PNG format using Imagemagick internally. There are three steps to make your custom image converter: 1. Make a subclass of ``ImageConverter`` class 2. Override ``conversion_rules``, ``is_available()`` and ``convert()`` 3. Register your image converter to Sphinx using :py:meth:`.Sphinx.add_post_transform` rNNz bool | None availablezlist[tuple[str, str]]conversion_rulesc$t||i|yr)super__init__)rargsr __class__s r!rzImageConverter.__init__s $)&)r#c|jjjsyd|dvryt|j |t|jjjzry|j |j |j_|j sy |j|y#t$rYywxYw)NFrFrST) r-rBrCsetguess_mimetypesr is_availablerget_conversion_rule ValueErrorr&s r!rzImageConverter.matchsxx55 $|$ $ t##D) *S1A1A1W1W-X X >> !'+'8'8':DNN $~~ ((.  s(B:: CCc|j|D]?}|jjjD]}||f}||jvs|ccSAd}t |)NzNo conversion rule found)rr-rBrCrr)rr candidate supportedrulemsgs r!rz"ImageConverter.get_conversion_rulesi--d3 I!XX--CC !9-4000K  )or#ct)z/Return the image converter is available or not.NotImplementedErrorr/s r!rzImageConverter.is_availables!!r#crd|dvrgSd|dvrt|d}||gSgS|djS)NrFrSrPrA)rkeys)rr guesseds r!rzImageConverter.guess_mimetypessU $|$ $I D& &$T%[1G ' 3G9 ; ; %**, ,r#c|j|\}}||dvr |d|}n|dd}|jj|d}t||}t |j t jj|j |}t jj|jj|}|j||rqd|dvr ||dd<n||d|<||d<||jj|<|jjj|jj|yy)NrSrPrRrA)rrhr)rrr0r*r+r,r-srcdirconvertrirorp)rr _from_tosrcpathrrdestpath abs_srcpaths r!rzImageConverter.handles!--d3 s D& &<(/G<(-G88??7+A.#Hc2$-- 77<< x8ggll488??G< << X .d<((*2\"3'*2\"3'"DK4;DHH ' ' 1 HHOO $ $TXX%5%5x @ /r#ct)zConvert an image file to the expected format. *_from* is a path of the source image file, and *_to* is a path of the destination file. r)rrrs r!rzImageConverter.converts "!r#)rrrrr1r2r3)r r4r1ztuple[str, str])r1r5)r r4r1z list[str]r6)rr7rr7r1r5)r8r9r:__doc__r}r__annotations__rrrrrrrr __classcell__)rs@r!rrsN("I{!/1+0*,"-A0"r#rcb|jt|jtddddS)NbuiltinT)versionparallel_read_safeparallel_write_safe)add_post_transformr=r)r-s r!setuprs4?++,"# r#)rrr7ryr7r1r7)r-rr1zdict[str, Any]),r __future__rr*r[hashlibrmathrtypingrrdocutilsr sphinx.localer sphinx.transformsr sphinx.utilr r sphinx.util.http_dater rsphinx.util.imagesrrrsphinx.util.osutilrsphinx.applicationr getLoggerr8rfrWcompiler]rr=rrrrr%r#r!rs)" %-)DRR()   8 $" <0;;">](>]B=)=BQ w"'w"tr#