# article-parser
[](https://pypi.org/project/article-parser/)
[](https://pypi.org/project/article-parser/)
[](https://pypi.org/project/article-parser/)
[](https://pypi.org/project/article-parser/)
**Extract article or news by url or html, parse the title and content.**
*[English](https://github.com/myifeng/article-parser/blob/master/README.md) ∙ [简体中文](https://github.com/myifeng/article-parser/blob/master/README.zh-CN.md)*
## How to install
[`article-parser`](https://pypi.org/project/article-parser/) is available on pypi
https://pypi.org/project/article-parser/
```
$ pip install article-parser
```
## Basic Usage
```python
>>> import article_parser
article_parser.parse(
url='', # The URL of the article.
html='', # The HTML of the article.
threshold=0.9, # The ratio of text to the entire document, default 0.9.
output='html', # Result output format, support ``markdown`` and ``html``, default ``html``.
**kwargs # Optional arguments that `request` takes. optional
),
## ouput markdown
>>> title, content = article_parser.parse(url="http://www.chinadaily.com.cn/a/202009/22/WS5f6962b2a31024ad0ba7afcb.html", output='markdown', timeout=5)
## output html
>>> title, content = article_parser.parse(url="http://www.chinadaily.com.cn/a/202009/22/WS5f6962b2a31024ad0ba7afcb.html", timeout=5)
```
## Example
[Djokovic wins record 36th Masters title in Rome - Chinadaily.com.cn](http://www.chinadaily.com.cn/a/202009/22/WS5f6962b2a31024ad0ba7afcb.html)
* Markdown
```python
>>> import article_parser
>>> title, content = article_parser.parse(url="http://www.chinadaily.com.cn/a/202009/22/WS5f6962b2a31024ad0ba7afcb.html", output='markdown', timeout=5)
>>> print(title)
>>> print('----------------')
>>> print(content)
Djokovic wins record 36th Masters title in Rome
----------------
Serbia's Novak Djokovic kisses the trophy after winning the final against
Argentina's Diego Schwartzman at Italian Open, Foro Italico, Rome, Italy, Sept
21, 2020. [Photo/Agencies]
ROME - Novak Djokovic won a record 36th Masters crown as he beat Diego
Schwartzman in the men's final of the ATP Italian Open on Monday.
Djokovic, the world number one and the top seed at the tournament, won 7-5,
6-3 against Argentine Schwartzman to lift his 36th Masters title, one more
than Rafael Nadal.
The Serb said he did not play his best tennis this time in Rome, but could
find it when needed.
Simona Halep, top seed of the women's draw, won her first title in Rome after
defending champion Karolina Pliskova of the Czech Republic retired while
trailing 6-0, 2-1 in the final.
```
* HTML
```python
>>> import article_parser
>>> title, content = article_parser.parse(url="http://www.chinadaily.com.cn/a/202009/22/WS5f6962b2a31024ad0ba7afcb.html", timeout=5)
>>> print(title)
>>> print('----------------')
>>> print(content)
Djokovic wins record 36th Masters title in Rome
----------------
<div id="Content">
<figure class="image" style="display: table;">
<img data-from="newsroom" id="img-5f6962b2a31024adbd959228" src="//img2.chinadaily.com.cn/images/202009/22/5f6962b2a31024adbd959228.jpeg"/>
<figcaption style="font-size: 14px; display: table-caption; caption-side: bottom;">
Serbia's Novak Djokovic kisses the trophy after winning the final against Argentina's Diego Schwartzman at Italian Open, Foro Italico, Rome, Italy, Sept 21, 2020. [Photo/Agencies]
</figcaption>
</figure>
<p dir="ltr">ROME - Novak Djokovic won a record 36th Masters crown as he beat Diego Schwartzman in the men's final of the ATP Italian Open on Monday.</p>
<p dir="ltr">Djokovic, the world number one and the top seed at the tournament, won 7-5, 6-3 against Argentine Schwartzman to lift his 36th Masters title, one more than Rafael Nadal.</p>
<p dir="ltr">The Serb said he did not play his best tennis this time in Rome, but could find it when needed.</p>
<p dir="ltr">Simona Halep, top seed of the women's draw, won her first title in Rome after defending champion Karolina Pliskova of the Czech Republic retired while trailing 6-0, 2-1 in the final.</p>
</div>
```
## Contributors
[](https://github.com/myifeng/article-parser/graphs/contributors)
Raw data
{
"_id": null,
"home_page": "https://github.com/myifeng/article-parser",
"name": "article-parser",
"maintainer": "myifeng",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "myifengs@gmail.com",
"keywords": "article news html parser extractor",
"author": "myifeng",
"author_email": "myifengs@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/67/a1/eeebb88a0ec9c7ff7656dde8a37ea012befe734511d7f001f7b4e93a5bdf/article-parser-1.7.1.tar.gz",
"platform": null,
"description": "# article-parser\n\n\n[](https://pypi.org/project/article-parser/)\n[](https://pypi.org/project/article-parser/)\n[](https://pypi.org/project/article-parser/)\n[](https://pypi.org/project/article-parser/)\n\n\n\n**Extract article or news by url or html, parse the title and content.**\n\n*[English](https://github.com/myifeng/article-parser/blob/master/README.md) \u2219 [\u7b80\u4f53\u4e2d\u6587](https://github.com/myifeng/article-parser/blob/master/README.zh-CN.md)*\n\n## How to install\n\n[`article-parser`](https://pypi.org/project/article-parser/) is available on pypi\nhttps://pypi.org/project/article-parser/\n\n```\n$ pip install article-parser\n```\n\n## Basic Usage\n\n```python\n>>> import article_parser\n\narticle_parser.parse(\n url='', # The URL of the article.\n html='', # The HTML of the article.\n threshold=0.9, # The ratio of text to the entire document, default 0.9.\n output='html', # Result output format, support ``markdown`` and ``html``, default ``html``.\n **kwargs # Optional arguments that `request` takes. optional\n ),\n\n\n## ouput markdown\n>>> title, content = article_parser.parse(url=\"http://www.chinadaily.com.cn/a/202009/22/WS5f6962b2a31024ad0ba7afcb.html\", output='markdown', timeout=5)\n\n## output html\n>>> title, content = article_parser.parse(url=\"http://www.chinadaily.com.cn/a/202009/22/WS5f6962b2a31024ad0ba7afcb.html\", timeout=5)\n\n```\n\n## Example\n[Djokovic wins record 36th Masters title in Rome - Chinadaily.com.cn](http://www.chinadaily.com.cn/a/202009/22/WS5f6962b2a31024ad0ba7afcb.html)\n\n\n* Markdown\n\n```python\n>>> import article_parser\n>>> title, content = article_parser.parse(url=\"http://www.chinadaily.com.cn/a/202009/22/WS5f6962b2a31024ad0ba7afcb.html\", output='markdown', timeout=5)\n>>> print(title)\n>>> print('----------------')\n>>> print(content)\n\nDjokovic wins record 36th Masters title in Rome\n----------------\n\nSerbia's Novak Djokovic kisses the trophy after winning the final against\nArgentina's Diego Schwartzman at Italian Open, Foro Italico, Rome, Italy, Sept\n21, 2020. [Photo/Agencies]\n\nROME - Novak Djokovic won a record 36th Masters crown as he beat Diego\nSchwartzman in the men's final of the ATP Italian Open on Monday.\n\nDjokovic, the world number one and the top seed at the tournament, won 7-5,\n6-3 against Argentine Schwartzman to lift his 36th Masters title, one more\nthan Rafael Nadal.\n\nThe Serb said he did not play his best tennis this time in Rome, but could\nfind it when needed.\n\nSimona Halep, top seed of the women's draw, won her first title in Rome after\ndefending champion Karolina Pliskova of the Czech Republic retired while\ntrailing 6-0, 2-1 in the final.\n```\n\n\n* HTML\n```python\n>>> import article_parser\n>>> title, content = article_parser.parse(url=\"http://www.chinadaily.com.cn/a/202009/22/WS5f6962b2a31024ad0ba7afcb.html\", timeout=5)\n>>> print(title)\n>>> print('----------------')\n>>> print(content)\n\nDjokovic wins record 36th Masters title in Rome\n----------------\n<div id=\"Content\">\n\n<figure class=\"image\" style=\"display: table;\">\n<img data-from=\"newsroom\" id=\"img-5f6962b2a31024adbd959228\" src=\"//img2.chinadaily.com.cn/images/202009/22/5f6962b2a31024adbd959228.jpeg\"/>\n<figcaption style=\"font-size: 14px; display: table-caption; caption-side: bottom;\">\n Serbia's Novak Djokovic kisses the trophy after winning the final against Argentina's Diego Schwartzman at Italian Open, Foro Italico, Rome, Italy, Sept 21, 2020. [Photo/Agencies]\n </figcaption>\n</figure>\n<p dir=\"ltr\">ROME - Novak Djokovic won a record 36th Masters crown as he beat Diego Schwartzman in the men's final of the ATP Italian Open on Monday.</p>\n<p dir=\"ltr\">Djokovic, the world number one and the top seed at the tournament, won 7-5, 6-3 against Argentine Schwartzman to lift his 36th Masters title, one more than Rafael Nadal.</p>\n<p dir=\"ltr\">The Serb said he did not play his best tennis this time in Rome, but could find it when needed.</p>\n<p dir=\"ltr\">Simona Halep, top seed of the women's draw, won her first title in Rome after defending champion Karolina Pliskova of the Czech Republic retired while trailing 6-0, 2-1 in the final.</p>\n</div>\n```\n## Contributors\n\n[](https://github.com/myifeng/article-parser/graphs/contributors)\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A parser to parse article from url or html",
"version": "1.7.1",
"project_urls": {
"Homepage": "https://github.com/myifeng/article-parser"
},
"split_keywords": [
"article",
"news",
"html",
"parser",
"extractor"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9aa2bcf03bf55ed7094e6998cd9b32dca4391b06dc96d651771842722fb7d3c0",
"md5": "47d3cd728232911f58ceff1c5d199f7e",
"sha256": "88ee735c5c833ed356b1a5360f2dee388e087c2ce8a5d303efbc1888a9bb9e07"
},
"downloads": -1,
"filename": "article_parser-1.7.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "47d3cd728232911f58ceff1c5d199f7e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 5566,
"upload_time": "2024-03-29T08:05:14",
"upload_time_iso_8601": "2024-03-29T08:05:14.285449Z",
"url": "https://files.pythonhosted.org/packages/9a/a2/bcf03bf55ed7094e6998cd9b32dca4391b06dc96d651771842722fb7d3c0/article_parser-1.7.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "67a1eeebb88a0ec9c7ff7656dde8a37ea012befe734511d7f001f7b4e93a5bdf",
"md5": "fd7587dd3d6e4667e617e0a74560d834",
"sha256": "ea5c2f75ddf2778beb1211057467c6df2337ae0dd00668ae18fe0e8035fafde5"
},
"downloads": -1,
"filename": "article-parser-1.7.1.tar.gz",
"has_sig": false,
"md5_digest": "fd7587dd3d6e4667e617e0a74560d834",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 4735,
"upload_time": "2024-03-29T08:05:15",
"upload_time_iso_8601": "2024-03-29T08:05:15.765846Z",
"url": "https://files.pythonhosted.org/packages/67/a1/eeebb88a0ec9c7ff7656dde8a37ea012befe734511d7f001f7b4e93a5bdf/article-parser-1.7.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-29 08:05:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "myifeng",
"github_project": "article-parser",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "article-parser"
}
JSON
