libreoffice pipe

### 配置和使用 LibreOffice Pipe

对于希望利用 LibreOffice 的管道 (pipe) 功能来实现远程控制或自动化操作的需求，可以按照如下方式配置：

#### 创建并启动带有命名管道的服务实例

为了通过管道连接到 LibreOffice 实例，需要创建一个新的服务实例，并指定一个唯一的名称用于识别该管道。这可以通过命令行完成：

soffice "--accept=pipe,name=myPipe;urp;" --nologo --headless &

这条命令会启动 LibreOffice 并监听名为 `myPipe` 的本地命名管道。

#### 使用 uno 接口编程访问 LibreOffice

一旦设置了管道，就可以借助 UNO API 来编写程序与之交互。Python 是一种常用的选择，因为它有 pyuno 库支持直接调用这些接口。下面是一个简单的例子展示如何打开文档并通过 Python 脚本执行基本的操作[^1]：

import os
from com.sun.star.connection import NoConnectException
from com.sun.star.uno import Exception as UnoException
from com.sun.star.beans import PropertyValue
from com.sun.star.frame import XComponentLoader
from com.sun.star.lang import XMultiServiceFactory, XComponent
from com.sun.star.bridge import XUnoUrlResolver


def connect_to_lo(pipe_name='myPipe'):
    localContext = uno.getComponentContext()
    resolver = localContext.ServiceManager.createInstanceWithContext(
        "com.sun.star.bridge.UnoUrlResolver", localContext)

    try:
        context = resolver.resolve(f"uno:pipe,name={pipe_name};urp;StarOffice.ComponentContext")
        desktop = context.ServiceManager.createInstanceWithContext("com.sun.star.frame.Desktop", context)
        return desktop
    except NoConnectException:
        raise ConnectionError('Failed to connect to the LibreOffice instance.')
    except UnoException as e:
        raise RuntimeError(str(e))


desktop = connect_to_lo()

loader_properties = (
    PropertyValue(Name="Hidden", Value=True),
)

url_of_the_document = f"file://{os.getcwd()}/example.odt"
document = desktop.loadComponentFromURL(url_of_the_document, "_blank", 0, loader_properties)

if document is not None:
    text_content = document.getText().getString()
    print(text_content[:100])  # 打印前100字符的内容作为示例
else:
    print("Document could not be loaded.")

# 关闭文档而不保存更改
document.close(True)

这段代码展示了怎样建立到运行中的 LibreOffice 实例的连接，并加载指定路径下的 ODT 文件读取部分内容后关闭它。