wechat-article-parser 0.0.4__tar.gz → 0.0.5__tar.gz

{wechat_article_parser-0.0.4 → wechat_article_parser-0.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wechat-article-parser
-Version: 0.0.4
+Version: 0.0.5
 Summary: WeChat MP article parser - extract metadata and content from WeChat public account articles
 License-Expression: MIT
 License-File: LICENSE
@@ -76,6 +76,7 @@ print(result.article_markdown)
 - `timeout`：请求超时时间，单位秒，默认 15
 - `user_agent`：自定义 User-Agent，不传则使用内置默认值
 - `proxy`：HTTP/HTTPS 代理地址，不传则直连
+- `include_raw_html`：是否在返回结果中带上原始 HTML 网页源代码，默认 `False`
 
 ```python
 result = parse(
@@ -83,6 +84,7 @@ result = parse(
     timeout=30,
     user_agent="MyBot/1.0",
     proxy="http://user:pass@127.0.0.1:7890",
+    include_raw_html=True,
 )
 ```
 
@@ -108,6 +110,7 @@ result = parse(
 | `article_description` | `str` | 文章摘要 |
 | `article_markdown` | `str` | 文章正文的 Markdown 内容 |
 | `article_publish_time` | `int` | 发布时间（Unix 时间戳） |
+| `raw_html` | `str` | 原始 HTML 网页源代码（仅在 `include_raw_html=True` 时填充，否则为空字符串） |
 | `images` | `list[str]` | 文章中提取的所有图片链接 |
 | `is_valid` | `bool` | 关键字段是否全部解析成功（属性） |
 
@@ -206,6 +209,12 @@ pytest tests/test_parser.py::test_fetch_all -s --url "https://mp.weixin.qq.com/s
 pytest tests/test_parser.py::test_fetch_markdown -s --url "https://mp.weixin.qq.com/s/xxxxx"
 ```
 
+### 测试单个链接 - 打印原始 HTML 网页源代码
+
+```bash
+pytest tests/test_parser.py::test_fetch_raw_html -s --url "https://mp.weixin.qq.com/s/xxxxx"
+```
+
 ### 通过 HTTP 代理运行测试
 
 所有测试命令都支持 `--proxy` 参数，传入后所有请求都会经由该代理；不传则直连。常用于 IP 被微信限流时换出口：

{wechat_article_parser-0.0.4 → wechat_article_parser-0.0.5}/README.md

@@ -61,6 +61,7 @@ print(result.article_markdown)
 - `timeout`：请求超时时间，单位秒，默认 15
 - `user_agent`：自定义 User-Agent，不传则使用内置默认值
 - `proxy`：HTTP/HTTPS 代理地址，不传则直连
+- `include_raw_html`：是否在返回结果中带上原始 HTML 网页源代码，默认 `False`
 
 ```python
 result = parse(
@@ -68,6 +69,7 @@ result = parse(
     timeout=30,
     user_agent="MyBot/1.0",
     proxy="http://user:pass@127.0.0.1:7890",
+    include_raw_html=True,
 )
 ```
 
@@ -93,6 +95,7 @@ result = parse(
 | `article_description` | `str` | 文章摘要 |
 | `article_markdown` | `str` | 文章正文的 Markdown 内容 |
 | `article_publish_time` | `int` | 发布时间（Unix 时间戳） |
+| `raw_html` | `str` | 原始 HTML 网页源代码（仅在 `include_raw_html=True` 时填充，否则为空字符串） |
 | `images` | `list[str]` | 文章中提取的所有图片链接 |
 | `is_valid` | `bool` | 关键字段是否全部解析成功（属性） |
 
@@ -191,6 +194,12 @@ pytest tests/test_parser.py::test_fetch_all -s --url "https://mp.weixin.qq.com/s
 pytest tests/test_parser.py::test_fetch_markdown -s --url "https://mp.weixin.qq.com/s/xxxxx"
 ```
 
+### 测试单个链接 - 打印原始 HTML 网页源代码
+
+```bash
+pytest tests/test_parser.py::test_fetch_raw_html -s --url "https://mp.weixin.qq.com/s/xxxxx"
+```
+
 ### 通过 HTTP 代理运行测试
 
 所有测试命令都支持 `--proxy` 参数，传入后所有请求都会经由该代理；不传则直连。常用于 IP 被微信限流时换出口：

{wechat_article_parser-0.0.4 → wechat_article_parser-0.0.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "wechat-article-parser"
-version = "0.0.4"
+version = "0.0.5"
 description = "WeChat MP article parser - extract metadata and content from WeChat public account articles"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -26,3 +26,4 @@ packages = ["src/wechat_article_parser"]
 
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
+pythonpath = ["src"]

{wechat_article_parser-0.0.4 → wechat_article_parser-0.0.5}/src/wechat_article_parser/models.py

@@ -46,6 +46,9 @@ class ArticleResult:
     article_markdown: str = ""
     article_publish_time: int = 0
 
+    # 原始 HTML 网页源代码（仅在调用方显式要求时才会填充）
+    raw_html: str = ""
+
     # 文章中提取的图片列表
     images: list[str] = field(default_factory=list)
 

{wechat_article_parser-0.0.4 → wechat_article_parser-0.0.5}/src/wechat_article_parser/parser.py

@@ -482,6 +482,7 @@ def parse(
     timeout: int = _TIMEOUT,
     user_agent: str | None = None,
     proxy: str | None = None,
+    include_raw_html: bool = False,
 ) -> ArticleResult:
     """抓取并解析微信公众号文章（同步方式）。
 
@@ -490,6 +491,7 @@ def parse(
         timeout: 请求超时时间（秒）。
         user_agent: 自定义 User-Agent，不传则使用内置默认值。
         proxy: HTTP/HTTPS 代理地址，例如 "http://user:pass@host:port"，不传则直连。
+        include_raw_html: 是否在结果中返回原始 HTML 网页源代码，默认不返回。
 
     Returns:
         包含解析数据的 ArticleResult。
@@ -503,7 +505,10 @@ def parse(
     ) as client:
         response = client.get(url)
         response.raise_for_status()
-        return _parse_html(url, response.text)
+        result = _parse_html(url, response.text)
+        if include_raw_html:
+            result.raw_html = response.text
+        return result
 
 
 async def parse_async(
@@ -512,6 +517,7 @@ async def parse_async(
     timeout: int = _TIMEOUT,
     user_agent: str | None = None,
     proxy: str | None = None,
+    include_raw_html: bool = False,
 ) -> ArticleResult:
     """抓取并解析微信公众号文章（异步方式）。
 
@@ -520,6 +526,7 @@ async def parse_async(
         timeout: 请求超时时间（秒）。
         user_agent: 自定义 User-Agent，不传则使用内置默认值。
         proxy: HTTP/HTTPS 代理地址，例如 "http://user:pass@host:port"，不传则直连。
+        include_raw_html: 是否在结果中返回原始 HTML 网页源代码，默认不返回。
 
     Returns:
         包含解析数据的 ArticleResult。
@@ -533,4 +540,7 @@ async def parse_async(
     ) as client:
         response = await client.get(url)
         response.raise_for_status()
-        return _parse_html(url, response.text)
+        result = _parse_html(url, response.text)
+        if include_raw_html:
+            result.raw_html = response.text
+        return result

{wechat_article_parser-0.0.4 → wechat_article_parser-0.0.5}/tests/test_parser.py

@@ -127,3 +127,17 @@ def test_fetch_markdown(url: str, proxy: str | None) -> None:
     """
     result = parse(url, proxy=proxy)
     print(f"\n{result.article_markdown}")
+
+
+def test_fetch_raw_html(url: str, proxy: str | None) -> None:
+    """抓取指定 URL 并打印原始 HTML 网页源代码。
+
+    用法: pytest tests/test_parser.py::test_fetch_raw_html -s --url <URL> [--proxy <PROXY>]
+    """
+    result = parse(url, proxy=proxy, include_raw_html=True)
+    assert result.raw_html, "raw_html should not be empty when include_raw_html=True"
+    print(f"\n{'='*60}")
+    print(f"URL:        {url}")
+    print(f"raw_html长度: {len(result.raw_html)}")
+    print(f"{'='*60}")
+    print(result.raw_html)