Skip to main content

A package to fetch web resources and cache HTML content.

Project description

fetch_web_resource

fetch_web_resource 是一个用于抓取网页资源并缓存 HTML 内容的 Python 包。

功能

  • 抓取网页内容
  • 提取网页中的图片和文件链接
  • 缓存抓取的 HTML 内容
  • 使用随机 User-Agent 模拟请求

安装

你可以使用以下命令安装该包:

pip install .

使用方法

初始化

首先,你需要初始化 HTMLFetcher 类:

from web_fetch.web_fetch import HTMLFetcher
import diskcache

cache = diskcache.Cache('./html_cache')
fetcher = HTMLFetcher(cache=cache, max_concurrent_per_domain=5)

抓取网页内容

你可以使用 fetch_html_batch 方法抓取一批网页内容:

results = [
    SearchResult(url="https://example.com/page1"),
    SearchResult(url="https://example.com/page2"),
]

async for result in fetcher.fetch_html_batch(results, timeout=5):
    print(result)

提取 URL 资源

你可以使用 _extract_urls 方法从 HTML 内容中提取图片和文件链接:

html_content = "<html>...</html>"
base_url = "https://example.com"
url_resource = fetcher._extract_urls(html_content, base_url)
print(url_resource)

环境变量

你需要在项目根目录下创建一个 .env 文件,并添加你的 API 密钥:

API_KEY=your_api_key_here

依赖

该项目依赖以下 Python 包:

  • requests
  • beautifulsoup4
  • diskcache
  • python-dotenv
  • htmldate
  • pydantic

贡献

欢迎贡献代码!请 fork 本仓库并提交 pull request。

许可证

该项目使用 MIT 许可证

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

web_fetch-0.1.0.tar.gz (5.3 kB view details)

Uploaded Source

Built Distribution

web_fetch-0.1.0-py3-none-any.whl (5.7 kB view details)

Uploaded Python 3

File details

Details for the file web_fetch-0.1.0.tar.gz.

File metadata

  • Download URL: web_fetch-0.1.0.tar.gz
  • Upload date:
  • Size: 5.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.15

File hashes

Hashes for web_fetch-0.1.0.tar.gz
Algorithm Hash digest
SHA256 a53796f05dfffa26a34525ebb83d43013cd88dd8b78960af9e9dd1e88a20112d
MD5 68b19c94032c99da2303b1fd04a72aed
BLAKE2b-256 c6b5fd9378043084730d6e604f6466e96d0ffb45f753ff8c85915d8b420b2b1a

See more details on using hashes here.

File details

Details for the file web_fetch-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: web_fetch-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 5.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.15

File hashes

Hashes for web_fetch-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f852cd0c53ccfafbeac44645403ed0ea449d3579d6a45250154ebfe232746296
MD5 59144ba0da0cbf9c0bf78beaa5f866ab
BLAKE2b-256 bbd6837ad9a756f2e60772830b8cc4a84c3587272b6af8de45d18ed2f7be7a5c

See more details on using hashes here.

Supported by

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