{
"info": {
"author": "ludbek",
"author_email": "sth.srn@gmail.com",
"bugtrack_url": null,
"classifiers": [
"Programming Language :: Python :: 2.7",
"Programming Language :: Python :: 3.3",
"Programming Language :: Python :: 3.4",
"Programming Language :: Python :: 3.5",
"Programming Language :: Python :: 3.6",
"Programming Language :: Python :: 3.7"
],
"description": "[](https://travis-ci.org/ludbek/webpreview)\n\n# About\nWebpreview helps preview a webpage. It extracts [Open Graph](http://ogp.me/), [Twitter Card](https://dev.twitter.com/cards/overview) and [Schema](http://schema.org/) meta tags. Given a URL of a page, it extracts title, thumbnail, description, etc as per request.\n\n#Installation\n\n $ pip install webpreview\n\n#Usage\n## Preview a Web Page\nAPI: `web_preview(url, timeout?, headers?, content?, absolute_image_url?, parser?)`\n\nUse `web_preview` for extracting title, description and thumbnail image. It tries to extract them from Open Graph properties, if not found it falls back to Twitter Card, and so on till Schema. If non works it tries to extract from the webpage's content.\n\n $ from webpreview import web_preview\n $ title, description, image = web_preview(\"aurl.com\")\n\n # specifing timeout which gets passed to requests.get()\n $ title, description, image = web_preview(\"a_slow_url.com\", timeout=1000)\n\n # passing headers\n $ headers = {'User-Agent': 'Mozilla/5.0'}\n $ title, description, image = web_preview(\"a_slow_url.com\", headers=headers)\n\n # pass html content thus avoiding making http call again to fetch content.\n $ content = \"\"\"Dummy HTML\"\"\"\n $ title, description, image = web_preview(\"aurl.com\", content=content)\n\n # specifing the parser\n # by default webpreview uses 'html.parser'\n $ title, description, image = web_preview(\"aurl.com\", content=content, parser='lxml')\n\n## Open Graph\nAPI: `OpenGraph(url, properties, timeout?, headers?, content?, parser?)`\n\n`OpenGraph` extracts Open Graph meta properties. Consider following meta tags.\n\n \n \n \n \n \n\nBelow is a snippet showing its usage.\n\n $ from webpreview import OpenGraph\n\n # pass a URL and a list of meta properties\n $ og = OpenGraph(\"http://aurl.com\", [\"og:title\", \"article:published_time\", \"og:price:amount\"])\n\n # OpenGraph dynamically assigns corresponding properties to its instance. As you will see it excludes `og:` from the supplied properties.\n $ og.title\n => \"a title\"\n $ og.published_time\n => \"2013-09-17T05:59:00+01:00\"\n\n\t# It converts `:` in a property into `_`.\n $ og.price_amount\n => \"15.00\"\n\n## Twitter Card\nAPI: `TwitterCard(url, properties, timeout?, headers?, content?, parser?)`\n\n`TwitterCard` extracts Twitter Card meta properties from the given webpage. Its usage is similar to `OpenGraph`.\n\n $ from webpreview import TwitterCard\n $ tc = TwitterCard(\"aurl.com\", [\"twitter:title\", \"twitter:image\"])\n $ tc.title\n $ tc.image\n\n## Schema\nAPI: `Schema(url, properties, timeout?, headers?, content?, parser?)`\n\nWebpreview supports Schema through the class `Schema`. Right now it extracts properties in meta tags only.\n\n $ from webpreview import Schema\n $ aschema = Schema(\"aurl.com\", [\"name\", \"camelCaseProperty\"]\n $ aschema.name\n # It makes Camel Case properties available as Snake Case.\n $ aschema.camel_case_property\n\n\n\n\n",
"description_content_type": "",
"docs_url": null,
"download_url": "",
"downloads": {
"last_day": -1,
"last_month": -1,
"last_week": -1
},
"home_page": "https://github.com/ludbek/webpreview",
"keywords": "OpenGraph TwitterCard Schema Facebook Twitter Google+",
"license": "LICENSE.txt",
"maintainer": "",
"maintainer_email": "",
"name": "webpreview",
"package_url": "https://pypi.org/project/webpreview/",
"platform": "",
"project_url": "https://pypi.org/project/webpreview/",
"project_urls": {
"Homepage": "https://github.com/ludbek/webpreview"
},
"release_url": "https://pypi.org/project/webpreview/1.6.0/",
"requires_dist": [
"requests (>=2.10.0)",
"beautifulsoup4 (>=4.4.0)"
],
"requires_python": "",
"summary": "Extracts OpenGraph, TwitterCard and Schema properties from a webpage.",
"version": "1.6.0"
},
"last_serial": 4919728,
"releases": {
"0.1.0dev": [
{
"comment_text": "",
"digests": {
"md5": "3ce3560debfe0c7568dcd8afbca5927b",
"sha256": "b3f07d9f9e4613e269182f19005c815cbc7b76e40bdd50087e81ed1c29d2c148"
},
"downloads": -1,
"filename": "webpreview-0.1.0dev.tar.gz",
"has_sig": false,
"md5_digest": "3ce3560debfe0c7568dcd8afbca5927b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5540,
"upload_time": "2015-04-07T15:32:26",
"url": "https://files.pythonhosted.org/packages/c0/8d/452f983243e17c762eb39bfbe1aa6f025497fdf0b6347b53895f47ca3fac/webpreview-0.1.0dev.tar.gz"
},
{
"comment_text": "",
"digests": {
"md5": "e6dfc371c8c4c9a9ea48adcbb204cb96",
"sha256": "6a602b25542316740e6c30aae1b5fe9a2e78cfae5adacd02fe9506942757adeb"
},
"downloads": -1,
"filename": "webpreview-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "e6dfc371c8c4c9a9ea48adcbb204cb96",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5806,
"upload_time": "2014-12-03T10:52:23",
"url": "https://files.pythonhosted.org/packages/e8/3b/f7948f00d40f7a835c26e14afd53a6af3e131ea3e762ce35aab99d07b0d9/webpreview-0.1.0.tar.gz"
}
],
"1.0.0dev": [
{
"comment_text": "",
"digests": {
"md5": "76ffbbf56e042d7c56b50982fe87095f",
"sha256": "35631672c375fd052982518c6a27bc69f0b40ce6555132ceb0127bcba03d927c"
},
"downloads": -1,
"filename": "webpreview-1.0.0dev.tar.gz",
"has_sig": false,
"md5_digest": "76ffbbf56e042d7c56b50982fe87095f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5538,
"upload_time": "2015-03-05T06:14:04",
"url": "https://files.pythonhosted.org/packages/07/8d/c7341ec8839dc91ca5076f53cff4a5c139321cfb3751dfa567068affcb35/webpreview-1.0.0dev.tar.gz"
}
],
"1.0.1dev": [
{
"comment_text": "",
"digests": {
"md5": "4fba29b9fbe18cebea952e4361a4ca70",
"sha256": "676dfec50d380bfb1fd5eb6c9e7f5e4e037a4a3d3d159370ca474e8866a93fc1"
},
"downloads": -1,
"filename": "webpreview-1.0.1dev.tar.gz",
"has_sig": false,
"md5_digest": "4fba29b9fbe18cebea952e4361a4ca70",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5591,
"upload_time": "2015-04-07T15:32:53",
"url": "https://files.pythonhosted.org/packages/34/ba/af6e36a60f3417a54202431752c5585f5fe5fc474bd0c4e5e166c0d40e63/webpreview-1.0.1dev.tar.gz"
}
],
"1.0.2dev": [
{
"comment_text": "",
"digests": {
"md5": "1266a1ccf210e63284f7b9cffe878c59",
"sha256": "766a48a11c5abffbc8b72f706078077e3bcf2b8914d583415c0e82e7240c6a9c"
},
"downloads": -1,
"filename": "webpreview-1.0.2dev.tar.gz",
"has_sig": false,
"md5_digest": "1266a1ccf210e63284f7b9cffe878c59",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5616,
"upload_time": "2015-04-08T15:45:00",
"url": "https://files.pythonhosted.org/packages/4f/9f/a72b6580e4290f9134d84b2c0e04b2b1ce9cf9da7d8ae828bfb8ef73f8e4/webpreview-1.0.2dev.tar.gz"
}
],
"1.0.4": [
{
"comment_text": "",
"digests": {
"md5": "92bed9a380b224b2f28cb69d56911fdb",
"sha256": "96eb202c6dc1d7962bea68c3f4588a23be09c63bff91e7878ce3ce31d3154b47"
},
"downloads": -1,
"filename": "webpreview-1.0.4.tar.gz",
"has_sig": false,
"md5_digest": "92bed9a380b224b2f28cb69d56911fdb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6647,
"upload_time": "2015-04-20T15:06:26",
"url": "https://files.pythonhosted.org/packages/c1/bd/1b5479eb9e6871714a66d4dc90093815abe0a855e7709da26f30c5f96336/webpreview-1.0.4.tar.gz"
}
],
"1.1.0": [
{
"comment_text": "",
"digests": {
"md5": "e869319a5c58c7a857a09d58d8c358f3",
"sha256": "9e8b8fd7b79b3e922e75c0c5af090f653abc2c9d7bcb7afcc196b6bd0cf2ab73"
},
"downloads": -1,
"filename": "webpreview-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "e869319a5c58c7a857a09d58d8c358f3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6545,
"upload_time": "2016-06-04T12:40:42",
"url": "https://files.pythonhosted.org/packages/dc/d3/11abe23176a3a8496bcf61493f01565b47327c237981ea6ec5088f33adb6/webpreview-1.1.0.tar.gz"
}
],
"1.2.0": [
{
"comment_text": "",
"digests": {
"md5": "faa9a193ce3b8cd50d714686d93153ee",
"sha256": "9f804015861861b03a82c717b17376f001295daac6b93c2281290bfb50b9a9f7"
},
"downloads": -1,
"filename": "webpreview-1.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "faa9a193ce3b8cd50d714686d93153ee",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9052,
"upload_time": "2017-02-28T15:42:07",
"url": "https://files.pythonhosted.org/packages/dc/61/c052e8ca5f6e1a087bd2d1edc1fd592997cb11de6e9b0f2071e4e5bb31cf/webpreview-1.2.0-py3-none-any.whl"
}
],
"1.3.0": [
{
"comment_text": "",
"digests": {
"md5": "4e5967602fa226880297f86f7a3ae0a2",
"sha256": "cd9090925ae7bcbb0a0a1923cba2d7fad5272ca37829b80e0f58d3f22f63f6a7"
},
"downloads": -1,
"filename": "webpreview-1.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4e5967602fa226880297f86f7a3ae0a2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9078,
"upload_time": "2017-05-09T15:35:36",
"url": "https://files.pythonhosted.org/packages/0f/de/9a19f06b588e3b8117427e4b1806f9fd386c1180bd8cd9eaacfe3859551e/webpreview-1.3.0-py3-none-any.whl"
}
],
"1.3.1": [
{
"comment_text": "",
"digests": {
"md5": "1c8c5eaa7361bcc049c3a841814e0f24",
"sha256": "ba362f88d2c181f5804eb991ce115dd202a79097fb89d08308ea481fafd9fe7a"
},
"downloads": -1,
"filename": "webpreview-1.3.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1c8c5eaa7361bcc049c3a841814e0f24",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9192,
"upload_time": "2017-05-09T15:48:46",
"url": "https://files.pythonhosted.org/packages/9f/50/84893212c726cec5b6ef24ef3129fb6eefd7cc93f05b0bf31c581aa23490/webpreview-1.3.1-py3-none-any.whl"
}
],
"1.3.2": [
{
"comment_text": "",
"digests": {
"md5": "220a400ced7ae6a0ff380be02cfce28d",
"sha256": "3d501c2c8dfb98ed0a6d31239dc3573080b3a9a443bbac1db7ec7bda66e1373d"
},
"downloads": -1,
"filename": "webpreview-1.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "220a400ced7ae6a0ff380be02cfce28d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9191,
"upload_time": "2017-06-17T04:45:21",
"url": "https://files.pythonhosted.org/packages/d8/1d/ffc96d0ed74aeb182a87ce5f546449ff860918e73740aef2745951e89939/webpreview-1.3.2-py3-none-any.whl"
}
],
"1.3.3": [
{
"comment_text": "",
"digests": {
"md5": "d8c28208e0b86f28a3a76f184fb4aeed",
"sha256": "2d61d2d0273ea5e6a779b581b9de28703e2c7f6a37706de4b88c9cac589c2cda"
},
"downloads": -1,
"filename": "webpreview-1.3.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d8c28208e0b86f28a3a76f184fb4aeed",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 7314,
"upload_time": "2018-05-31T12:01:22",
"url": "https://files.pythonhosted.org/packages/48/a6/19522650b2c2dd3a3c78bdea53b5a4ad228e294ee6c1ffe31e893a26f1d6/webpreview-1.3.3-py3-none-any.whl"
}
],
"1.4.0": [
{
"comment_text": "",
"digests": {
"md5": "99d48f05ef49ac3e8f3e3dae2377a37e",
"sha256": "9cf8209edcddb800766925b73786591060bc41cf92b5871372f8eb195564ff3f"
},
"downloads": -1,
"filename": "webpreview-1.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "99d48f05ef49ac3e8f3e3dae2377a37e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 8065,
"upload_time": "2018-06-20T09:40:07",
"url": "https://files.pythonhosted.org/packages/26/af/41e396ec1e9c1777440c4eb2a2257b4bf5321eb3696dc4f181e959af025c/webpreview-1.4.0-py3-none-any.whl"
}
],
"1.5.0": [
{
"comment_text": "",
"digests": {
"md5": "a5bc6aa0bc28964c675cc36988157e15",
"sha256": "24693ad6cfce393b81e5210bd37fed767ce093a58af3f7a4b49ca73482717319"
},
"downloads": -1,
"filename": "webpreview-1.5.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a5bc6aa0bc28964c675cc36988157e15",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9104,
"upload_time": "2018-12-01T22:55:47",
"url": "https://files.pythonhosted.org/packages/85/b1/1742395a8599ec265d6d2007ee80fde251469675d71a6055e5e8e3462a64/webpreview-1.5.0-py3-none-any.whl"
}
],
"1.6.0": [
{
"comment_text": "",
"digests": {
"md5": "54a22a061e730b372f2435a581876623",
"sha256": "b2916980f03f40ef40f6bc2421077f409efec2200336acc8cff788c29aecf434"
},
"downloads": -1,
"filename": "webpreview-1.6.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "54a22a061e730b372f2435a581876623",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9165,
"upload_time": "2019-03-09T21:38:28",
"url": "https://files.pythonhosted.org/packages/91/00/73ebd3d699bfc47f3265a63316917260460d665b45891537a581aa517ad0/webpreview-1.6.0-py3-none-any.whl"
}
]
},
"urls": [
{
"comment_text": "",
"digests": {
"md5": "54a22a061e730b372f2435a581876623",
"sha256": "b2916980f03f40ef40f6bc2421077f409efec2200336acc8cff788c29aecf434"
},
"downloads": -1,
"filename": "webpreview-1.6.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "54a22a061e730b372f2435a581876623",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9165,
"upload_time": "2019-03-09T21:38:28",
"url": "https://files.pythonhosted.org/packages/91/00/73ebd3d699bfc47f3265a63316917260460d665b45891537a581aa517ad0/webpreview-1.6.0-py3-none-any.whl"
}
]
}