OpenGraphKit

OpenGraphKit 是一个 Swift 包，提供了一种从 HTML 内容、URL 和 URL 请求中轻松解析 OpenGraph 元数据的方法。它与 Apple 平台和 Linux 兼容。

特性

从 HTML 字符串解析 OpenGraph 元数据
从 URL 获取和解析 OpenGraph 元数据
支持自定义 URL 请求
使用 Swift 并发的异步 API
跨平台支持（Apple 平台和 Linux）

安装

Swift Package Manager

将以下内容添加到您的 Package.swift 文件中

dependencies: [
    .package(url: "https://github.com/engali94/OpenGraphKit.git", from: "0.1")
]

要使用 Swift Package Index 将 OpenGraphKit 集成到您的 Xcode 项目中，请按照以下步骤操作

在 Xcode 中，选择 "File" → "Add Packages..."
输入 URL：https://github.com/engali94/OpenGraphKit.git
选择符合您需求的版本规则（例如，“Up to Next Major” 用于自动更新到新版本）
单击 “Add Package”

您还可以访问我们的 Swift Package Index 页面获取更多信息、其他集成方法并查看生成的文档。

用法

所有属性都是可选的，因为并非所有 OpenGraph 元数据都可能存在于每个页面中。

从 HTML 解析

import OpenGraphKit

let parser = OpenGraphParser()
let html = """
<html>
<head>
<meta property="og:title" content="Example Title">
<meta property="og:description" content="This is an example description.">
</head>
<body>Page content</body>
</html>
"""

do {
    let metadata = try parser.parse(html: html)
    print("Title: \(metadata.title ?? "N/A")")
    // ... print other metadata properties
} catch {
    print("Error: \(error)")
}

从 URL 解析

import OpenGraphKit

let parser = OpenGraphParser()
let url = URL(string: "https://example.com")!

do {
    let metadata = try await parser.parse(url: url)
    print("Title: \(metadata.title ?? "N/A")")
    // ... print other metadata properties

} catch {
    print("Error: \(error)")
}

使用自定义 URLRequest 解析

import OpenGraphKit

let parser = OpenGraphParser()
var request = URLRequest(url: URL(string: "https://example.com")!)
do {
    let metadata = try await parser.parse(urlRequest: request)
    print("Title: \(metadata.title ?? "N/A")")
    // ... print other metadata properties
} catch {
    print("Error: \(error)")
}

贡献

欢迎对 OpenGraphKit 做出贡献！请随时提交 Pull Request。

许可

OpenGraphKit 在 MIT 许可下发布。有关详细信息，请参见 LICENSE。