Skip to main content

This code is under the Apache License 2.0. http://www.apache.org/licenses/LICENSE-2.0

This is a python port of a ruby port of arc90’s readability project

http://lab.arc90.com/experiments/readability/

In few words, Given a html document, it pulls out the main body text and cleans it up. It also can clean up title based on latest readability.js code.

Based on:

Installation:

easy_install readability-lxml
or
pip install readability-lxml

Usage:

from readability.readability import Document
import urllib
html = urllib.urlopen(url).read()
readable_article = Document(html).summary()
readable_title = Document(html).short_title()

Command-line usage:

python -m readability.readability -u http://pypi.python.org/pypi/readability-lxml

Using positive/negative keywords example:

python -m readability.readability -p intro -n newsindex,homepage-box,news-section -u http://python.org

Document() kwarg options:

  • attributes:

  • debug: output debug messages

  • min_text_length:

  • retry_length:

  • url: will allow adjusting links to be absolute

  • positive_keywords: the list of positive search patterns in classes and ids, for example: [“news-item”, “block”]

  • negative_keywords: the list of negative search patterns in classes and ids, for example: [“mysidebar”, “related”, “ads”]

Updates

  • 0.2.5 Update setup.py for uploading .tar.gz to pypi

  • 0.2.6 Don’t crash on documents with no title

  • 0.2.6.1 Document.short_title() properly works

  • 0.3 Added Document.encoding, positive_keywords and negative_keywords

Metadata

Release files for readability-lxml 0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for readability-lxml 0.3
File Size Uploaded
readability-lxml-0.3.tar.gz 12.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for readability-lxml 0.3
File Interpreter ABI Platform
readability_lxml-0.3-py2.7.egg Legacy Egg format - - Details

Total release size: 37.6 kB

Release files / readability-lxml-0.3.tar.gz

Download URL readability-lxml-0.3.tar.gz
Size 12.3 kB
Tags Source
SHA-256 checksum
How to use checksums
20dbbe0613092519b8a58b1c932f36fb154884053df80ed208ad9b67dae1d00f
BLAKE2b-256 checksum
How to use checksums
b7c8d80abc0f80a495a1f674ca091afe5fa0f414221afbf3967155f5604b7a34
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / readability_lxml-0.3-py2.7.egg

Download URL readability_lxml-0.3-py2.7.egg
Size 25.4 kB
Tags Egg
SHA-256 checksum
How to use checksums
94eb1211a1beee5821bfbb7d78345a3b0dfdcf5c145216c82d3d10104c2ff23c
BLAKE2b-256 checksum
How to use checksums
0ea1f2e871c2994c01ab357ea5eb7a123f2555466fd3968c90a4bda70c3a05c9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

0.9

2 release files

0.8.4

2 release files

0.8.1

2 release files

0.7.1

1 release file

0.7

1 release file

0.6.2

1 release file

0.6.1

1 release file

0.6.0.5

1 release file

0.6.0.4

1 release file

0.6.0.3

1 release file

0.5.1

1 release file

0.5

1 release file

0.3.0.6

1 release file

0.3.0.5

1 release file

This release

0.3 This release

2 release files

0.2.6.1

1 release file

0.2.6

1 release file

0.2.5

1 release file

0.2.3

1 release file

0.2.2

1 release file

0.2.1

1 release file

0.2

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page