Parses Microsofts Rich Text Format (RTF) documents. It creates an in-memory object which represents the tree structure of the RTF document. This object can in turn be rendered by using one of the renderers.
So far, rtfparse provides only one renderer (Decapsulate_HTML) which liberates the HTML code encapsulated in RTF. This will come handy, for examle, if you ever need to extract the HTML from a HTML-formatted email message saved by Microsoft Outlook.
MS Outlook also tends to use RTF compression, so the CLI of rtfparse can optionally do that, too.
You can of course write your own renderers of parsed RTF documents and consider contributing them to this project.
Install rtfparse from your local repository with pip:
pip install rtfparse
Installation creates an executable file rtfparse in your python scripts folder which should be in your $PATH.
Use the rtfparse executable from the command line. Read rtfparse --help.
rtfparse writes logs into ~/rtfparse/ into these files:
rtfparse.debug.log
rtfparse.info.log
rtfparse.errors.log
rtfparse --rtf-file "path/to/rtf_file.rtf" --decapsulate-html --output-file "path/to/extracted.html"
For this, the CLI of rtfparse uses extract_msg and compressed_rtf.
rtfparse --msg-file "path/to/email.msg" --decapsulate-html --output-file "path/to/extracted.html"
rtfparse --msg-file "path/to/email.msg" --output-file "path/to/extracted.rtf"
When extracting the RTF from the .msg file, you can save the attachments (which includes images embedded in the email text) in a directory:
rtfparse --msg-file "path/to/email.msg" --output-file "path/to/extracted.rtf" --attachments-dir "path/to/dir"
In rtfparse version 1.x you will be able to embed these images in the decapsulated HTML. This functionality will be provided by the package embedimg.
rtfparse --msg-file "path/to/email.msg" --output-file "path/to/extracted.rtf" --attachments-dir "path/to/dir" --embed-img
In the current version the option --embed-img does nothing.
from pathlib import Path
from rtfparse.parser import Rtf_Parser
from rtfparse.renderers.html_decapsulator import HTML_Decapsulator
source_path = Path(r"path/to/your/rtf/document.rtf")
target_path = Path(r"path/to/your/html/decapsulated.html")
# Create parent directory of `target_path` if it does not already exist:
target_path.parent.mkdir(parents=True, exist_ok=True)
parser = Rtf_Parser(rtf_path=source_path)
parsed = parser.parse_file()
renderer = HTML_Decapsulator()
with open(target_path, mode="w", encoding="utf-8") as html_file:
renderer.render(parsed, html_file)
If you find a working official Microsoft link to the RTF specification and add it here, you'll be remembered fondly.