page.insert_link() in fitz. LINK_LAUNCH escape the ":" in the file path

[python-and-cabbage]

1. Start by running the code to hyperlink the "cat" text

import fitz
doc = fitz.open("input.pdf")
page = doc[1]    
rl = page.search_for("cat")
file_path = r'C:/Users/LENOVO/PycharmProjects/pythonProject/2.pdf'
for rect in rl:
    page.insert_link({"kind": fitz.LINK_LAUNCH, "from": rect, "page": 0,"to": fitz.Point(0,0),'file':file_path})
doc.save("output.pdf")
doc.close()

The hyperlink won't open after testing.
2.Use code checks

import fitz
doc = fitz.open("output.pdf")
page = doc[1]                   
lnks = page.get_links()
for l in lnks:
    print(l)
doc.close()

Here are the results：

{'kind': 5, 'xref': 88, 'from': Rect(114.69999694824219, 386.1040344238281, 166.74099731445312, 405.6720275878906), 'file': 'C%3A/Users/LENOVO/PycharmProjects/pythonProject/2.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0, 'id': 'fitz-L0'}

Apparently the ":" was escaped as "%3A"

3.Replace the code：

page.insert_link({'kind': 2, 'xref': 978, 'from': rect, 'type': 'uri', 'uri': 'C:/Users/LENOVO/PycharmProjects/pythonProject/2.pdf'})

4.succeeds

{'kind': 3, 'xref': 88, 'from': Rect(114.69999694824219, 386.1040344238281, 166.74099731445312, 405.6720275878906), 'file': 'C:/Users/LENOVO/PycharmProjects/pythonProject/2.pdf', 'id': 'fitz-L0'}

[JorjMcKie]

You must use a valid HTML file specification to make this work, like file:///C:/Users/....

[python-and-cabbage]

import fitz
doc = fitz.open("input.pdf")
page = doc[1]    
rl = page.search_for("cat")
file_path = 'file:///C:/Users/LENOVO/PycharmProjects/pythonProject/2.pdf'
for rect in rl:
    page.insert_link({"kind": fitz.LINK_LAUNCH, "from": rect, "page": 0,"to": fitz.Point(0,0),'file':file_path})
doc.save("output.pdf")
doc.close()

result

{'kind': 5, 'xref': 88, 'from': Rect(114.69999694824219, 386.1040344238281, 166.74099731445312, 405.6720275878906), 'file': 'file%3A/C%3A/Users/LENOVO/PycharmProjects/pythonProject/2.pdf', 'page': 0, 'to': Point(0.0, 0.0), 'zoom': 0.0, 'id': 'fitz-L0'}

[JorjMcKie]

This script works and adds 2 working links (in relevant viewers on Windows):

import fitz

doc = fitz.open()
r1 = fitz.Rect(0, 0, 50, 50)
r2 = fitz.Rect(0, 50, 50, 100)
l1 = {
    "kind": fitz.LINK_LAUNCH,
    "from": r1,
    "file": "C:/Users/xxxxx/OneDrive/Desktop/roque.xlsx",
}
l2 = {
    "kind": fitz.LINK_URI,
    "from": r2,
    "uri": "file://C:/Users/xxxxx/OneDrive/Desktop/roque.xlsx",
}
page = doc.new_page()
page.insert_link(l1)
page.insert_link(l2)
doc.save("x.pdf")

A "page" specification makes no sense in either case! Use LINK_GOTOR if you need this.

The respective generated PDF definitions are

4 0 obj
<</Type/Page/MediaBox[0 0 595 842]/Rotate 0/Resources 3 0 R/Parent 2 0 R/Annots[5 0 R 6 0 R]>>
endobj

5 0 obj
<</A<</S/Launch/F<</Type/Filespec/F(C:/Users/xxxxx/OneDrive/Desktop/roque.xlsx)/UF(C:/Users/xxxxx/OneDrive/Desktop/roque.xlsx)>>>>/Rect[0 792 50 842]/BS<</W 0>>/Subtype/Link/NM(fitz-L0)>>
endobj

6 0 obj
<</A<</S/URI/URI(file://C:/Users/xxxxx/OneDrive/Desktop/roque.xlsx)>>/Rect[0 742 50 792]/BS<</W 0>>/Subtype/Link/NM(fitz-L1)>>
endobj