📑 Table of Contents

• 🔧 Core Features
• 🚀 Installation
• 🎯 Quick Start
• 🤝 Contributions

⚠️ Important Considerations

Rate Limiting & Ethics

• Client-side filtering means you may fetch more pages than requested to reach your target count
• Be respectful with request volumes — this tool is for educational and personal projects, not for scraping at scale
• Consider implementing delays between requests for larger operations

🔧 Core Features

🚀 Installation

One-liner with uv (recommended):

uv add pywuzzuf

Classic pip:

pip install pywuzzuf

Poetry:

poetry add pywuzzuf

Requires Python 3.12+

🎯 Quick Start

Get the first 10 "Python Developer" jobs posted in the last 24 hours:

import asyncio
from pywuzzuf import WuzzufClient, SearchFilters, DateRange

async def main():
    async with WuzzufClient() as client:
        results = await client.jobs.search("Python Developer") \
            .filter(SearchFilters(posted_within=DateRange.LAST_24_HOURS)) \
            .limit(10) \
            .all()

        for job in results.items:
            company = job.company.attributes.name if job.company else "Unknown"
            print(f"📌 {job.attributes.title} @ {company}")
            
            if job.quality.has_anomalies:
                print(f"   ⚠️  Missing: {', '.join(job.quality.missing_fields)}")

asyncio.run(main())

Output:

📌 Senior Python Engineer @ Instabug
📌 Backend Python Developer @ Paymob
   ⚠️  Missing: salary_range
📌 Python Team Lead @ Vezeeta
...

🤝 Contributions