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")
'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](https://www.crummy.com/software/BeautifulSoup/bs4/doc/).
# Links
* [Homepage](https://www.crummy.com/software/BeautifulSoup/bs4/)
* [Documentation](https://www.crummy.com/software/BeautifulSoup/bs4/doc/)
* [Discussion group](https://groups.google.com/group/beautifulsoup/)
* [Development](https://code.launchpad.net/beautifulsoup/)
* [Bug tracker](https://bugs.launchpad.net/beautifulsoup/)
* [Complete changelog](https://bazaar.launchpad.net/~leonardr/beautifulsoup/bs4/view/head:/CHANGELOG)
# Note on Python 2 sunsetting
Beautiful Soup's support for Python 2 was discontinued on December 31,
2020: one year after the sunset date for Python 2 itself. From this
point onward, new Beautiful Soup development will exclusively target
Python 3. The final release of Beautiful Soup 4 to support Python 2
was 4.9.3.
# Supporting the project
If you use Beautiful Soup as part of your professional work, please consider a
[Tidelift subscription](https://tidelift.com/subscription/pkg/pypi-beautifulsoup4?utm_source=pypi-beautifulsoup4&utm_medium=referral&utm_campaign=readme).
This will support many of the free software projects your organization
depends on, not just Beautiful Soup.
If you use Beautiful Soup for personal projects, the best way to say
thank you is to read
[Tool Safety](https://www.crummy.com/software/BeautifulSoup/zine/), a zine I
wrote about what Beautiful Soup has taught me about software
development.
# 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 using Pytest:
```
$ pytest
```
beautifulsoup4-4.12.1.tar.gz （69个子文件） 
beautifulsoup4-4.12.1 doc 
Makefile 5KB source index.rst 121KB conf.py 8KB
6.1.jpg 22KB AUTHORS 2KB LICENSE 1KB test-all-versions 288B PKG-INFO 3KB doc.ptbr Makefile 5KB source index.rst 115KB conf.py 8KB 6.1.jpg 22KB doc.jp 
index.html 275KB doc.ru Makefile 5KB source index.rst 478B conf.py 8KB 6.1.jpg 22KB bs4ru.rst 155KB
NEWS.txt 69KB pyproject.toml 2KB bs4 __init__.py 33KB dammit.py 40KB builder __init__.py 24KB _lxml.py 15KB _html5lib.py 19KB _htmlparser.py 15KB diagnose.py 7KB tests __init__.py 47KB test_builder_registry.py 5KB test_tag.py 9KB test_builder.py 1KB test_docs.py 1KB test_formatter.py 4KB test_soup.py 18KB test_htmlparser.py 6KB test_navigablestring.py 5KB test_lxml.py 7KB test_element.py 2KB test_css.py 17KB test_dammit.py 15KB test_pageelement.py 14KB fuzz crash-0d306a50c8ed8bcd0785b67000fcd5dea1d33f08.testcase 3KB clusterfuzz-testcase-minimized-bs4_fuzzer-6241471367348224.testcase 19B clusterfuzz-testcase-minimized-bs4_fuzzer-6600557255327744.testcase 124B clusterfuzz-testcase-minimized-bs4_fuzzer-5984173902397440.testcase 50KB clusterfuzz-testcase-minimized-bs4_fuzzer-6124268085182464.testcase 10KB clusterfuzz-testcase-minimized-bs4_fuzzer-5167584867909632.testcase 19KB clusterfuzz-testcase-minimized-bs4_fuzzer-5703933063462912.testcase 5B clusterfuzz-testcase-minimized-bs4_fuzzer-5843991618256896.testcase 35B clusterfuzz-testcase-minimized-bs4_fuzzer-6450958476902400.testcase 3KB clusterfuzz-testcase-minimized-bs4_fuzzer-4999465949331456.testcase 30B clusterfuzz-testcase-minimized-bs4_fuzzer-4818336571064320.testcase 23B test_fuzz.py 4KB test_html5lib.py 8KB test_tree.py 47KB formatter.py 7KB css.py 10KB element.py 91KB .gitignore 1KB doc.ko 6.1.jpg 22KB index.html 251KB index.css 9KB README.md 2KB CHANGELOG 69KB doc.zh Makefile 5KB source index.rst 95KB conf.py 8KB 6.1.jpg 22KB scripts demonstrate_parser_differences.py 5KB资源评论
