Webpreview 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.
#Installation
$ pip install webpreview
#Usage
## Preview a Web Page
API: `web_preview(url, timeout?, headers?)`
Use `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.
$ from webpreview import web_preview
$ title, description, image = web_preview("aurl.com")
# specifing timeout which gets passed to requests.get()
$ title, description, image = web_preview("a_slow_url.com", timeout=1000)
# passing headers
$ headers = {'User-Agent': 'Mozilla/5.0'}
$ title, description, image = web_preview("a_slow_url.com", headers=headers)
## Open Graph
API: `OpenGraph(url, properties, timeout?, headers?)`
`OpenGraph` extracts Open Graph meta properties. Consider following meta tags.
<!--doc snippet at aurl.com -->
<meta property="og:title" content="a title" />
<meta property="og:description" content="a description" />
<meta property="article:published_time" content="2013-09-17T05:59:00+01:00" />
<meta property="og:price:amount" content="15.00" />
Below is a snippet showing its usage.
$ from webpreview import OpenGraph
# pass a URL and a list of meta properties
$ og = OpenGraph("http://aurl.com", ["og:title", "article:published_time", "og:price:amount"])
# OpenGraph dynamically assigns corresponding properties to its instance. As you will see it excludes `og:` from the supplied properties.
$ og.title
=> "a title"
$ og.published_time
=> "2013-09-17T05:59:00+01:00"
# It converts `:` in a property into `_`.
$ og.price_amount
=> "15.00"
## Twitter Card
API: `TwitterCard(url, properties, timeout?, headers?)`
`TwitterCard` extracts Twitter Card meta properties from the given webpage. Its usage is similar to `OpenGraph`.
$ from webpreview import TwitterCard
$ tc = TwitterCard("aurl.com", ["twitter:title", "twitter:image"])
$ tc.title
$ tc.image
## Schema
API: `Schema(url, properties, timeout?, headers?)`
Webpreview supports Schema through the class `Schema`. Right now it extracts properties in meta tags only.
$ from webpreview import Schema
$ aschema = Schema("aurl.com", ["name", "camelCaseProperty"]
$ aschema.name
# It makes Camel Case properties available as Snake Case.
$ aschema.camel_case_property
Metadata
Release files for webpreview 1.3.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| webpreview-1.3.2-py3-none-any.whl | Python 3 | none | any | Details for webpreview-1.3.2-py3-none-any.whl |
Release files / webpreview-1.3.2-py3-none-any.whl
| Download URL | webpreview-1.3.2-py3-none-any.whl |
|---|---|
| Size | 9.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3d501c2c8dfb98ed0a6d31239dc3573080b3a9a443bbac1db7ec7bda66e1373d
|
|
BLAKE2b-256 checksum How to use checksums |
d81dffc96d0ed74aeb182a87ce5f546449ff860918e73740aef2745951e89939
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for webpreview 1.3.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.