o i:(@sdZddlmZdZddlZddlZddlZddlmZddl Z ddl m Z m Z m Z m Z ddlmZdZerVdd lmZmZdd lmZdd lmZdd lmZdd lmZGddde ZGdddeZGddde jZejdddkrddlZGddde eZidddddddddddd d!d"d#d$d%d$d&d$d'd(d)d(d*d(d+d(d,d(d-d.d/d.d0d1d2Z!d9d7d8Z"dS):z0 This package contains Docutils Writer modules. ) annotationsreStructuredTextN)Path) Component languagesnodesutils) universalF)AnyFinal)Output)LanguageModule)StrPath) TransformcseZdZUdZdZded<dZded<dfd d Zd Zd ed < d Z ded< d Z ded< d Z ded< d ddZ d!ddZ d ddZd ddZZS)"Writera Abstract base class for docutils Writers. Each writer module or package must export a subclass also called 'Writer'. Each writer must support all standard node types listed in `docutils.nodes.node_class_names`. The `write()` method is the main entry point. writerr component_typewritersconfig_sectionreturnlist[type[Transform]]csttjtjtjgSN)superget_transformsr MessagesFilterMessagesStripClassesAndElementsself __class___/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/docutils/writers/__init__.pyr/s zWriter.get_transformsNznodes.document | Nonedocumentstr | bytes | NoneoutputzLanguageModule | Nonelanguagez Output | None destinationNonecCs i|_dSr)partsrr!r!r"__init__FszWriter.__init__nodes.documentr cCs6||_t|jj|j|_||_||j |j S)a/ Process a document into its final form. Translate `document` (a Docutils document tree) into the Writer's native format, and write it out to its `destination` (a `docutils.io.Output` subclass object). Normally not overridden or extended in subclasses. ) r#r get_languagesettings language_codereporterr&r' translatewriter%)rr#r'r!r!r"r1Os z Writer.writecCstd)a Do final translation of `self.document` into `self.output`. Called from `write`. Override in subclasses. Usually done with a `docutils.nodes.NodeVisitor` subclass, in combination with a call to `docutils.nodes.Node.walk()` or `docutils.nodes.Node.walkabout()`. The ``NodeVisitor`` subclass must support all standard elements (listed in `docutils.nodes.node_class_names`) and possibly non-standard elements used by the current Reader as well. z"subclass must override this method)NotImplementedErrorrr!r!r"r0ds zWriter.translatecCs<|j|jd<|jjj|jd<|jjj|jd<tj|jd<dS)zAssemble the `self.parts` dictionary. Extend in subclasses. See . wholeencodingerrorsversionN)r%r)r#r-output_encodingoutput_encoding_error_handlerdocutils __version__rr!r!r"assemble_partsrs zWriter.assemble_partsrrrr()r#r+r'r rr$)__name__ __module__ __qualname____doc__r__annotations__rrr#r%r&r'r*r1r0r; __classcell__r!r!rr"r s"        rc@seZdZdZdddZdS)UnfilteredWriterz A writer that passes the document tree on unchanged (e.g. a serializer.) Documents written by UnfilteredWriters are typically reused at a later date using a subclass of `readers.ReReader`. rrcCs t|Sr)rrrr!r!r"rs zUnfilteredWriter.get_transformsNr<)r>r?r@rArr!r!r!r"rD~srDcs.eZdZdZdfdd Zddd d ZZS)DoctreeTranslatorz Generic Docutils document tree translator base class. Adds auxiliary methods and attributes that are used by several Docutils writers to the `nodes.NodeVisitor` abstract superclass. rr(cst||j|_dSr)rr*r-)rr#rr!r"r*s  zDoctreeTranslator.__init__Nuristr output_pathStrPath | NonercCs|dur|jj}|drt|Stj|}|jdkr%t d|dtj |j }|jj r@|dr@t|jj | dSt|}|r[|s[t|j}ttd||}|S)aReturn filesystem path corresponding to a `URI reference`__. The `root_prefix`__ setting` is applied to URI references starting with "/" (but not to absolute Windows paths or "file" URIs). If `output_path` (defaults to the `output_path`__ setting) is not empty, relative paths are adjusted. (To work in the output document, URI references with relative path relate to the output directory. For access by the writer, paths must be relative to the working directory.) Use case: The element refers to the image via a "URI reference". The corresponding filesystem path is required to read the image size from the file or to embed the image in the output. A filesystem path is also expected by the "LaTeX" output format (with relative paths unchanged, relating to the output directory, set `output_path` to the empty string). Provisional: the function's location, interface and behaviour may change without advance warning. __ https://www.rfc-editor.org/rfc/rfc3986.html#section-4.1 __ https://docutils.sourceforge.io/docs/user/config.html#root-prefix __ https://docutils.sourceforge.io/docs/user/config.html#output-path Nfile:z&Cannot get file path corresponding to ./)r-rH startswithrfrom_uriurllibparseurlsplitscheme ValueErrorunquotepath root_prefix removeprefix is_absoluteparentresolver relative_path)rrFrH uri_partsrVdest_dirr!r!r"uri2paths     zDoctreeTranslator.uri2pathr=r)rFrGrHrIrr)r>r?r@rAr*r_rCr!r!rr"rEsrE) c@seZdZdZeddZdS)rzK`pathlib.Path` with `from_uri()` classmethod backported from 3.13. cCs|ds td||dd}|dddkr!|dd}n|ddd kr/|d d}|dddksG|dd d krM|ddd vrM|d d}|d ddkrc|dd d|dd}|tj|}|svtd||S)z,Return a new path from the given 'file' URI.rJz!URI does not start with 'file:': Nraz///r` z //localhost/ rMz:||:zURI is not absolute: )rNrTrPrQrUrY)clsrFrVr!r!r"rOs   0 z Path.from_uriN)r>r?r@rA classmethodrOr!r!r!r"rsrhtml html4css1html4xhtml10html5html5_polyglotxhtmls5s5_htmllatexlatex2exelatexxetexluatexlualatexodfodf_odtodtooffice openoffice libreofficepprint pseudoxmlpformatrlpdf docutils_xml)pdfxml writer_namerGr type[Writer]c Cs||}t||}z td|}W|jSty=z t|}WY|jSty<}z td|d|d}~www)z6Return the Writer class from the `writer_name` module.zdocutils.writers.zWriter "z " not found. N)lowerWRITER_ALIASESget importlib import_module ImportErrorr)rnamemoduleerrr!r!r"get_writer_class s  r)rrGrr)#rA __future__r __docformat__rsysrPpathlibrr9rrrrdocutils.transformsr TYPE_CHECKINGtypingr r docutils.ior docutils.languagesr docutils.nodesrrrrD NodeVisitorrE version_infotyperrr!r!r!r"sx       ^@