BhD S r SSKrSSKJr SSKJrJr SSKJr SSKJ r SSK
r
SSK r SSK r S=r
r0 SS_S S
_S S_S S_S
S_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_r/ SQrS S KJrJrJrJrJr S S KJrJr S r " S S!5 r " S" S#5 r " S$ S%5 r \R< SSSSSS\S4S& j5 r S S'K J!r! S S(K"J#r#J$r$J%r%J&r& S S)K'J(r(J)r) g)*z~The Awesome Document Factory.
The public API is what is accessible from this "root" packages without
importing sub-modules.
N)datetime)getctimegetmtime)Path)urljoinz65.1 stylesheets
media_typeprint attachmentspdf_identifier pdf_variant pdf_version pdf_formsuncompressed_pdfFcustom_metadatapresentational_hintssrgboptimize_images jpeg_qualitydpi
full_fontshintingcache) CSSDEFAULT_OPTIONSHTMLVERSION
AttachmentDocumentPage __version__default_url_fetcher )fetchr" path2url
ensure_urlurl_is_absolute)LOGGERPROGRESS_LOGGERc [ [ U R S5 5 S5 nUb2 UR SS5 R 5 nU( a [ X5 $ U$ )zdReturn the base URL for the document.
See https://www.w3.org/TR/html5/urls.html#document-base-url
baseNhref )nextitergetstripr )
html_documentfallback_base_urlfirst_base_elementr, s E/var/www/html/env/lib/python3.13/site-packages/weasyprint/__init__.py_find_base_urlr6 c sW d=#5#5f#= >E%!%%fb1779 ,3 3 c b \ rS rSrSrSSSSSSS\S4 S jrS S jrS rS r S
S jr
SS
jr S r g)r q a HTML document parsed by tinyhtml5.
You can just create an instance with a positional argument:
``doc = HTML(something)``
The class will try to guess if the input is a filename, an absolute URL,
or a :term:`file object`.
Alternatively, use **one** named argument so that no guessing is involved:
:type filename: str or pathlib.Path
:param filename:
A filename, relative to the current directory, or absolute.
:param str url:
An absolute, fully qualified URL.
:type file_obj: :term:`file object`
:param file_obj:
Any object with a ``read`` method.
:param str string:
A string of HTML source.
Specifying multiple inputs is an error:
``HTML(filename="foo.html", url="localhost://bar.html")``
will raise a :obj:`TypeError`.
You can also pass optional named arguments:
:param str encoding:
Force the source character encoding.
:type base_url: str or pathlib.Path
:param base_url:
The base used to resolve relative URLs (e.g. in
``
``). If not provided, try to use the input
filename, URL, or ``name`` attribute of
:term:`file objects `.
:type url_fetcher: :term:`callable`
:param url_fetcher:
A function or other callable with the same signature as
:func:`default_url_fetcher` called to fetch external resources such as
stylesheets and images. (See :ref:`URL Fetchers`.)
:param str media_type:
The media type to use for ``@media``. Defaults to ``'print'``.
**Note:** In some cases like ``HTML(string=foo)`` relative URLs will be
invalid if ``base_url`` is not provided.
Nr
c
t [ R " SU=( d U=( d U=( d
[ USS5 5 [ U[ 5 ( a [ U5 n[
XX4XWU5 n
U
u pp}[ U [
5 ( a [ R " U SS9n
O)SS0nU
b XS' Ub XnS' [ R " U 40 UD6n
S S S 5 [ X5 U l
Xl Xl [ R R U
S S 9U l U R R" U l g ! , ( d f Ni= f)
Nz'Step 1 - Fetching and parsing HTML - %snamez HTML stringF)namespace_html_elementsr< transport_encodingoverride_encoding)content_language)r) infogetattr
isinstancer str_select_source tinyhtml5parser6 base_url url_fetcherr
cssselect2ElementWrapperfrom_html_rootwrapper_element
etree_element)selfguessfilenameurlfile_objstringencodingrG rH r result source_typesourceprotocol_encodingkwargss r5 __init__
HTML.__init__ s# 5
5X
5
5 Hfm 4 6 h % %8}H SFkK
I X&#&&" O3U;$03D/0'2:./" :6: 'v8
&$ ) 8 8 G G T H + ! 1 1 ? ? Vs
.AD))
D7c 6 U( a [ [ /$ [ /$ N)HTML5_UA_STYLESHEETHTML5_UA_FORM_STYLESHEET)rN formss r5 _ua_stylesheetsHTML._ua_stylesheets s ')AB B#$$r7 c . [ R " 5 /$ r] )HTML5_UA_COUNTER_STYLEcopyrN s r5 _ua_counter_styleHTML._ua_counter_style s &++-..r7 c [ /$ r] )HTML5_PH_STYLESHEETrf s r5 _ph_stylesheetsHTML._ph_stylesheets s #$$r7 c [ U5 [ [ 5 -
H n[ R " SU5 M [ R 5 nUR U5 Un[ R " XX#5 $ )a Lay out and paginate the document, but do not (yet) export it.
This returns a :class:`document.Document` object which provides
access to individual pages and various meta-data.
See :meth:`write_pdf` to get a PDF directly.
:type font_config: :class:`text.fonts.FontConfiguration`
:param font_config:
A font configuration handling ``@font-face`` rules.
:type counter_style: :class:`css.counters.CounterStyle`
:param counter_style:
A dictionary storing ``@counter-style`` rules.
:param options:
The ``options`` parameter includes by default the
:data:`DEFAULT_OPTIONS` values.
:returns: A :class:`document.Document` object.
z Unknown rendering option: %s.)setr r( warningre updater _render)rN font_config
counter_styleoptionsunknown new_optionss r5 render HTML.render s_ & 7|c/&::G NN:G D ;%**, 7# =JJr7 c [ R 5 nUR U5 UnU R " XE40 UD6R " XU40 UD6$ )aM Render the document to a PDF file.
This is a shortcut for calling :meth:`render`, then
:meth:`Document.write_pdf() `.
:type target:
:class:`str`, :class:`pathlib.Path` or :term:`file object`
:param target:
A filename where the PDF file is generated, a file object, or
:obj:`None`.
:param float zoom:
The zoom factor in PDF units per CSS units. **Warning**:
All CSS units are affected, including physical units like
``cm`` and named sizes like ``A4``. For values other than
1, the physical CSS units will thus be "wrong".
:type finisher: :term:`callable`
:param finisher:
A finisher function or callable that accepts the document and a
:class:`pydyf.PDF` object as parameters. Can be passed to perform
post-processing on the PDF right before the trailer is written.
:type font_config: :class:`text.fonts.FontConfiguration`
:param font_config:
A font configuration handling ``@font-face`` rules.
:type counter_style: :class:`css.counters.CounterStyle`
:param counter_style:
A dictionary storing ``@counter-style`` rules.
:param options:
The ``options`` parameter includes by default the
:data:`DEFAULT_OPTIONS` values.
:returns:
The PDF as :obj:`bytes` if ``target`` is not provided or
:obj:`None`, otherwise :obj:`None` (the PDF is written to
``target``).
)r re rp rw write_pdf)rN targetzoomfinisherrr rs rt rv s r5 rz HTML.write_pdf sX J &**, 7# KK >g >
Y
X
:18
: ;r7 )rG rM r rH rL )F)NN)Nr# NNN)
__name__
__module__ __qualname____firstlineno____doc__r" rZ ra rg rk rw rz __static_attributes__ r7 r5 r r q sG ,Z "DdT td 0W@8%
/%K4 7;26*;r7 r c > \ rS rSrSrSSSSSSS\SSSSSS4S jrSrg)r i
a CSS stylesheet parsed by tinycss2.
An instance is created in the same way as :class:`HTML`, with the same
arguments.
An additional argument called ``font_config`` must be provided to handle
``@font-face`` rules. The same ``text.fonts.FontConfiguration`` object
must be used for different ``CSS`` objects applied to the same document.
``CSS`` objects have no public attributes or methods. They are only meant
to be used in the :meth:`HTML.write_pdf` and :meth:`HTML.render` methods
of :class:`HTML` objects.
NFr
c < [ R " SU=( d U=( d
[ USS5 5 [ XX4UXxU S9nU u nnnnUS:X a UR 5 n[ U[ 5 ( a [ R " U5 nO[ R " UUUS9u nnS S S 5 Xpl
U
=( d [ R " 5 U l
Uc / OUU l U c 0 OU n [ XWXR U R X5 g ! , ( d f Nn= f)Nz&Step 2 - Fetching and parsing CSS - %sr; z
CSS stringrG rH check_css_mime_typerR )environment_encodingrX )r) r@ rA rD readrB rC tinycss2parse_stylesheetparse_stylesheet_bytesrG rI Matchermatcher
page_rulespreprocess_stylesheet)rN rO rP rQ rR rS rT rG rH _check_mime_typer rr rs r r rU rV rW rX
stylesheets r5 rZ CSS.__init__ s
4 F Fwx F H SF 02 I VX7Hj( &#&& % 6 6v >
'/'F'F&7(9$
H !
6*"4"4"6 * 2"
+ 3
*k<< OO[ 9 Vs
A!D
D)rG r r r r r r r r" rZ r r r7 r5 r r
s/
"DdT td 05 #T $ 9r7 r c : \ rS rSrSrSSSSSS\SSSSS4 S jrSrg)r i; ao File attachment for a PDF document.
An instance is created in the same way as :class:`HTML`, except that the
HTML specific arguments (``encoding`` and ``media_type``) are not
supported.
:param str name:
The name of the attachment to be included in the PDF document.
May be :obj:`None`.
:param str description:
A description of the attachment to be included in the PDF document.
May be :obj:`None`.
:type created: :obj:`datetime.datetime`
:param created:
Creation date and time. Default is current date and time.
:type modified: :obj:`datetime.datetime`
:param modified:
Modification date and time. Default is current date and time.
:param str relationship:
A string that represents the relationship between the attachment and
the PDF it is embedded in. Default is 'Unspecified', other common
values are defined in ISO-32000-2:2020, 7.11.3.
N Unspecifiedc
l [ XX4XVUS9U l Xl Xl Xl S U l U
c< U( a [ R " [ U5 5 n
O[ R " 5 n
U c< U( a [ R " [ U5 5 n O[ R " 5 n Xl Xl g )N)rG rH )
rD rW r; description relationshipmd5r
fromtimestampr nowr createdmodified)
rN rO rP rQ rR rS rG rH r; r r r r s
r5 rZ Attachment.__init__T s % SF#% & ( ?"00(1CD",,. #11(82DE#<<>
r7 )r r r r r; r rW r r r7 r5 r r ; s+ 0 "DdT t9LdT +!r7 r c # # Ub [ U5 nXX#U4 Vs/ s H
nUc M UPM n n[ U 5 S:w a( SR U 5 =( d Sn
[ SU
35 eU b` [ U S5 ( a Sn O-[ U [ 5 ( a Sn O[ U 5 ( a S n OSn [ SXVUS
.X0D6n U n U v SSS5 gUb+ Uc [ U5 n[ US 5 nSX5S4v SSS5 gUb [ Xb5 n U( a0 U S S
:w a' [ R " SU S U S 5 SSUS4v OBU R S5 n
Uc U R SU5 nSU ; a SU S X]4v O SU S UU
4v SSS5 gUb@ Uc5 [ USS5 nU( a! UR! S5 ( d [ U5 nSX5S4v gUc eSXES4v gs snf ! , ( d f g= f! , ( d f g= f! , ( d f g= f7f)zCIf only one input is given, return it with normalized ``base_url``.Nr# z, nothingz!Expected exactly one source, got r rR rP rQ r rb mime_typeztext/cssz%Unsupported stylesheet type %s for %sredirected_urlrS r- rT r; r s & +`4' 4 d
4 4
u E E u D
4 % u!" T#( * G G +
Y; Y;x+9 +9\0! 0!f $ ;N',</ </~ ' % $r7