aDriv4 website!

Linux premium39.web-hosting.com 4.18.0-553.44.1.lve.el8.x86_64 #1 SMP Thu Mar 13 14:29:12 UTC 2025 x86_64
LiteSpeed
198.187.29.188

File Name : examples.py

# $Id: examples.py 9026 2022-03-04 15:57:13Z milde $
# Author: David Goodger <goodger@python.org>
# Copyright: This module has been placed in the public domain.

"""
This module contains practical examples of Docutils client code.

Importing this module from client code is not recommended; its contents are
subject to change in future Docutils releases.  Instead, it is recommended
that you copy and paste the parts you need into your own code, modifying as
necessary.
"""

from docutils import core, io

def html_parts(input_string, source_path=None, destination_path=None,
               input_encoding='unicode', doctitle=True,
               initial_header_level=1):
    """
    Given an input string, returns a dictionary of HTML document parts.

Dictionary keys are the names of parts, and values are Unicode strings;
    encoding is up to the client.

Parameters:

- `input_string`: A multi-line text string; required.
    - `source_path`: Path to the source file or object.  Optional, but useful
      for diagnostic output (system messages).
    - `destination_path`: Path to the file or object which will receive the
      output; optional.  Used for determining relative paths (stylesheets,
      source links, etc.).
    - `input_encoding`: The encoding of `input_string`.  If it is an encoded
      8-bit string, provide the correct encoding.  If it is a Unicode string,
      use "unicode", the default.
    - `doctitle`: Disable the promotion of a lone top-level section title to
      document title (and subsequent section title to document subtitle
      promotion); enabled by default.
    - `initial_header_level`: The initial level for header elements (e.g. 1
      for "<h1>").
    """
    overrides = {'input_encoding': input_encoding,
                 'doctitle_xform': doctitle,
                 'initial_header_level': initial_header_level}
    parts = core.publish_parts(
        source=input_string, source_path=source_path,
        destination_path=destination_path,
        writer_name='html', settings_overrides=overrides)
    return parts

def html_body(input_string, source_path=None, destination_path=None,
              input_encoding='unicode', output_encoding='unicode',
              doctitle=True, initial_header_level=1):
    """
    Given an input string, returns an HTML fragment as a string.

The return value is the contents of the <body> element.

Parameters (see `html_parts()` for the remainder):

- `output_encoding`: The desired encoding of the output.  If a Unicode
      string is desired, use the default value of "unicode" .
    """
    parts = html_parts(
        input_string=input_string, source_path=source_path,
        destination_path=destination_path,
        input_encoding=input_encoding, doctitle=doctitle,
        initial_header_level=initial_header_level)
    fragment = parts['html_body']
    if output_encoding != 'unicode':
        fragment = fragment.encode(output_encoding)
    return fragment

def internals(input_string, source_path=None, destination_path=None,
              input_encoding='unicode', settings_overrides=None):
    """
    Return the document tree and publisher, for exploring Docutils internals.

Parameters: see `html_parts()`.
    """
    if settings_overrides:
        overrides = settings_overrides.copy()
    else:
        overrides = {}
    overrides['input_encoding'] = input_encoding
    output, pub = core.publish_programmatically(
        source_class=io.StringInput, source=input_string,
        source_path=source_path,
        destination_class=io.NullOutput, destination=None,
        destination_path=destination_path,
        reader=None, reader_name='standalone',
        parser=None, parser_name='restructuredtext',
        writer=None, writer_name='null',
        settings=None, settings_spec=None, settings_overrides=overrides,
        config_section=None, enable_exit_status=None)
    return pub.writer.document, pub

Name	Type	Size	Owner/Group	Permission	Last Modified	Actions
.	dir	-	root/root	0755	2025-08-02 07:55:31
..	dir	-	root/root	0755	2025-11-04 10:23:02
__pycache__	dir	-	root/root	0755	2025-08-02 07:55:31
languages	dir	-	root/root	0755	2025-08-02 07:55:31
parsers	dir	-	root/root	0755	2025-08-02 07:55:31
readers	dir	-	root/root	0755	2025-08-02 07:55:31
transforms	dir	-	root/root	0755	2025-08-02 07:55:31
utils	dir	-	root/root	0755	2025-08-02 07:55:31
writers	dir	-	root/root	0755	2025-08-02 07:55:31
__init__.py	text/x-python	10.05 KB	root/root	0644	2025-07-04 01:31:01
__main__.py	text/x-python	3.54 KB	root/root	0644	2025-07-04 01:31:01
core.py	text/x-python	32.27 KB	root/root	0644	2025-07-04 01:31:01
examples.py	text/x-python	3.87 KB	root/root	0644	2025-07-04 01:31:01
frontend.py	text/x-python	39.06 KB	root/root	0644	2025-07-04 01:31:01
io.py	text/x-python	23.4 KB	root/root	0644	2025-07-04 01:31:01
nodes.py	text/x-python	79.11 KB	root/root	0644	2025-07-04 01:31:01
statemachine.py	text/x-python	55.62 KB	root/root	0644	2025-07-04 01:31:01

For more Private tool come to me!

https://t.me/aDriv4vz