Collection of different tools for async web scraping, crawling and parsing
Verified details
These details have been verified by PyPIProject links
GitHub Statistics
Maintainers
Project description
aiofetch
A Python toolkit for asynchronous web scraping with built-in error tracking and metadata management.
Features
Web Processing
- Asynchronous file downloading with progress tracking
- Rate limiting with configurable delays
- Smart retry logic with timeout handling
- Domain-aware crawling with URL validation
Content Processing
- Flexible HTML content parsing
- Custom selector-based metadata extraction
- Automated link and image extraction
- URL normalization and path handling
File & Data Management
- Asynchronous file operations
- Concurrent chunk-based downloads
- Smart path handling and file naming
- JSON data management with validation
Error Handling & Progress Tracking
- Comprehensive error tracking and reporting
- Progress monitoring for long operations
- Detailed logging with configurable outputs
- Operation statistics and summaries
Metadata Management
- Efficient in-memory caching
- Field-based search functionality
- Automatic metadata indexing
- Structured data validation
Installation
pip install aiofetch
Key Components
- AsyncDownloader: Parallel file downloading with progress tracking
- BatchProcessor: Process items in configurable batches
- RateLimiter: Control request frequency
- MetadataExtractor: HTML metadata extraction with custom selectors
- PathHandler: Path and filename utilities
- FileIO: Async/sync file operations
- BaseCrawler: Extensible crawler base class with domain validation
- LoggerFactory: Enhanced logging with file and console outputs
Requirements
- Python 3.9+
- aiofiles
- aiohttp
- BeautifulSoup4
Quick start
import asyncio
from aiofetch import (
AsyncDownloader,
MetadataExtractor,
ContentParser,
FileIO
)
async def main():
# Initialize components
downloader = AsyncDownloader(concurrent_limit=20)
parser = ContentParser()
file_io = FileIO()
# Download files
urls = [
("https://example.com/file1.pdf", "downloads/file1.pdf"),
("https://example.com/file2.pdf", "downloads/file2.pdf")
]
await downloader.download_batch(urls)
# Parse HTML content
html = """<html><body>
<h1>Title</h1>
<img src="image.jpg" alt="Test">
</body></html>"""
# Extract metadata
extractor = MetadataExtractor()
metadata = extractor.extract_from_html(html, {
'title': 'h1',
'images': ('img', 'src')
})
# Save results
await file_io.save_json(metadata, 'output/metadata.json')
if __name__ == "__main__":
asyncio.run(main())
License
MIT License - see LICENSE file for details
Contributing
Contributions are welcome! Please feel free to submit a Pull Request or Issue.
Author
Akram Rakhmetulla (akram042006@gmail.com)
Project details
Verified details
These details have been verified by PyPIProject links
GitHub Statistics
Maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
aiofetch-0.0.4.tar.gz
(13.5 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
aiofetch-0.0.4-py3-none-any.whl
(12.7 kB
view details)
File details
Details for the file aiofetch-0.0.4.tar.gz.
File metadata
- Download URL: aiofetch-0.0.4.tar.gz
- Upload date:
- Size: 13.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
34b676dc904071a2ecaff3b8f8d9dee0f43535bedbd87c8e145c746b9dcb3393
|
|
| MD5 |
32abac5477ff8ad7af070d0635073f17
|
|
| BLAKE2b-256 |
13e1c0fa27b1a7797ab4d4575cbcb5e2d21bcb34f6fa887094f2c727aeeb867e
|
Provenance
The following attestation bundles were made for aiofetch-0.0.4.tar.gz:
Publisher:
workflow.yml on spike1236/aiofetch
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
aiofetch-0.0.4.tar.gz -
Subject digest:
34b676dc904071a2ecaff3b8f8d9dee0f43535bedbd87c8e145c746b9dcb3393 - Sigstore transparency entry: 169555882
- Sigstore integration time:
-
Permalink:
spike1236/aiofetch@a0392ea5e8eeffafdb46999e6abf5d8520495c89 -
Branch / Tag:
refs/tags/v0.0.4 - Owner: https://github.com/spike1236
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
workflow.yml@a0392ea5e8eeffafdb46999e6abf5d8520495c89 -
Trigger Event:
push
-
Statement type:
File details
Details for the file aiofetch-0.0.4-py3-none-any.whl.
File metadata
- Download URL: aiofetch-0.0.4-py3-none-any.whl
- Upload date:
- Size: 12.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9acd95d6e9b559162da059e67ebfcdf0fb8c8beefe94627a6861ec260d5dc521
|
|
| MD5 |
bb6ec7a17455987a7f9effc87c9a28a5
|
|
| BLAKE2b-256 |
eb9f72ee02878de48d01ee2f8878b420144b48037503e2363ad02339823a2db8
|
Provenance
The following attestation bundles were made for aiofetch-0.0.4-py3-none-any.whl:
Publisher:
workflow.yml on spike1236/aiofetch
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
aiofetch-0.0.4-py3-none-any.whl -
Subject digest:
9acd95d6e9b559162da059e67ebfcdf0fb8c8beefe94627a6861ec260d5dc521 - Sigstore transparency entry: 169555884
- Sigstore integration time:
-
Permalink:
spike1236/aiofetch@a0392ea5e8eeffafdb46999e6abf5d8520495c89 -
Branch / Tag:
refs/tags/v0.0.4 - Owner: https://github.com/spike1236
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
workflow.yml@a0392ea5e8eeffafdb46999e6abf5d8520495c89 -
Trigger Event:
push
-
Statement type:
