Skip to main content

Screen-scraping library

Project description

Beautiful Soup is a library that makes it easy to scrape information from web pages. It sits atop an HTML or XML parser, providing Pythonic idioms for iterating, searching, and modifying the parse tree.

Quick start

  >>> from bs4 import BeautifulSoup
  >>> soup = BeautifulSoup("<p>Some<b>bad<i>HTML")
  >>> print soup.prettify()
  <html>
   <body>
    <p>
     Some
     <b>
      bad
      <i>
       HTML
      </i>
     </b>
    </p>
   </body>
  </html>
  >>> soup.find(text="bad")
  u'bad'

  >>> soup.i
  <i>HTML</i>

  >>> soup = BeautifulSoup("<tag1>Some<tag2/>bad<tag3>XML", "xml")
  >>> print soup.prettify()
  <?xml version="1.0" encoding="utf-8">
  <tag1>
   Some
   <tag2 />
   bad
   <tag3>
    XML
   </tag3>
  </tag1>

To go beyond the basics, comprehensive documentation is available.

Links

Building the documentation

The bs4/doc/ directory contains full documentation in Sphinx format. Run make html in that directory to create HTML documentation.

Running the unit tests

Beautiful Soup supports unit test discovery from the project root directory:

 $ nosetests
 $ python -m unittest discover -s bs4 # Python 2.7 and up

If you checked out the source tree, you should see a script in the home directory called test-all-versions. This script will run the unit tests under Python 2.7, then create a temporary Python 3 conversion of the source and run the unit tests again under Python 3.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

beautifulsoup4-4.6.3.tar.gz (167.5 kB view details)

Uploaded Source

Built Distributions

beautifulsoup4-4.6.3-py3-none-any.whl (90.4 kB view details)

Uploaded Python 3

beautifulsoup4-4.6.3-py2-none-any.whl (90.5 kB view details)

Uploaded Python 2

File details

Details for the file beautifulsoup4-4.6.3.tar.gz.

File metadata

  • Download URL: beautifulsoup4-4.6.3.tar.gz
  • Upload date:
  • Size: 167.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.7.0

File hashes

Hashes for beautifulsoup4-4.6.3.tar.gz
Algorithm Hash digest
SHA256 90f8e61121d6ae58362ce3bed8cd997efb00c914eae0ff3d363c32f9a9822d10
MD5 a08ea866a5c508d9b4c28c4d21e05df8
BLAKE2b-256 88df86bffad6309f74f3ff85ea69344a078fc30003270c8df6894fca7a3c72ff

See more details on using hashes here.

File details

Details for the file beautifulsoup4-4.6.3-py3-none-any.whl.

File metadata

  • Download URL: beautifulsoup4-4.6.3-py3-none-any.whl
  • Upload date:
  • Size: 90.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.7.0

File hashes

Hashes for beautifulsoup4-4.6.3-py3-none-any.whl
Algorithm Hash digest
SHA256 194ec62a25438adcb3fdb06378b26559eda1ea8a747367d34c33cef9c7f48d57
MD5 4daee55fa151603dd893831a607c0507
BLAKE2b-256 210a47fdf541c97fd9b6a610cb5fd518175308a7cc60569962e776ac52420387

See more details on using hashes here.

File details

Details for the file beautifulsoup4-4.6.3-py2-none-any.whl.

File metadata

  • Download URL: beautifulsoup4-4.6.3-py2-none-any.whl
  • Upload date:
  • Size: 90.5 kB
  • Tags: Python 2
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.7.0

File hashes

Hashes for beautifulsoup4-4.6.3-py2-none-any.whl
Algorithm Hash digest
SHA256 f0abd31228055d698bb392a826528ea08ebb9959e6bea17c606fd9c9009db938
MD5 27ab45d9a6fcc5d99e80c8b3d39f45c0
BLAKE2b-256 f8c7741c97d7366f4779ca73d244904978b43a81fd37d85fcf05ad19d472c1ce

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page