crawlo 1.1.1__py3-none-any.whl → 1.1.3__py3-none-any.whl

crawlo/pipelines/mysql_batch_pipline.py

@@ -1,273 +0,0 @@
-# -*- coding: utf-8 -*-
-import asyncio
-import aiomysql
-from typing import Optional, List, Dict
-from asyncmy import create_pool
-from crawlo.utils.log import get_logger
-from crawlo.exceptions import ItemDiscard
-from crawlo.utils.tools import make_insert_sql, logger
-
-
-class AsyncmyMySQLPipeline:
-    def __init__(self, crawler):
-        self.crawler = crawler
-        self.settings = crawler.settings
-        self.logger = get_logger(self.__class__.__name__, self.settings.get('LOG_LEVEL'))
-
-        # 配置参数
-        self.table_name = (
-            self.settings.get('MYSQL_TABLE') or
-            getattr(crawler.spider, 'mysql_table', None) or
-            f"{crawler.spider.name}_items"
-        )
-        self.batch_size = self.settings.getint('MYSQL_BATCH_SIZE', 100)
-        self.flush_interval = self.settings.getfloat('MYSQL_FLUSH_INTERVAL', 3.0)  # 秒
-
-        # 连接池相关
-        self._pool_lock = asyncio.Lock()
-        self._pool_initialized = False
-        self.pool = None
-
-        # 缓冲区与锁
-        self.items_buffer: List[Dict] = []
-        self.buffer_lock = asyncio.Lock()
-
-        # 后台任务
-        self.flush_task: Optional[asyncio.Task] = None
-
-        # 注册关闭事件
-        crawler.subscriber.subscribe(self.spider_closed, event='spider_closed')
-
-    @classmethod
-    def from_crawler(cls, crawler):
-        return cls(crawler)
-
-    async def _ensure_pool(self):
-        """确保连接池已初始化（线程安全）"""
-        if self._pool_initialized:
-            return
-
-        async with self._pool_lock:
-            if not self._pool_initialized:
-                try:
-                    self.pool = await create_pool(
-                        host=self.settings.get('MYSQL_HOST', 'localhost'),
-                        port=self.settings.get_int('MYSQL_PORT', 3306),
-                        user=self.settings.get('MYSQL_USER', 'root'),
-                        password=self.settings.get('MYSQL_PASSWORD', ''),
-                        db=self.settings.get('MYSQL_DB', 'scrapy_db'),
-                        minsize=self.settings.get_int('MYSQL_POOL_MIN', 3),
-                        maxsize=self.settings.get_int('MYSQL_POOL_MAX', 10),
-                        echo=self.settings.get_bool('MYSQL_ECHO', False)
-                    )
-                    self._pool_initialized = True
-                    self.logger.debug(f"MySQL连接池初始化完成（表: {self.table_name}）")
-                except Exception as e:
-                    self.logger.error(f"MySQL连接池初始化失败: {e}")
-                    raise
-
-    async def open_spider(self, spider):
-        """爬虫启动时初始化后台刷新任务"""
-        await self._ensure_pool()
-        self.flush_task = asyncio.create_task(self._flush_loop())
-
-    async def _flush_loop(self):
-        """后台循环：定期检查是否需要刷新缓冲区"""
-        while True:
-            await asyncio.sleep(self.flush_interval)
-            if len(self.items_buffer) > 0:
-                await self._flush_buffer()
-
-    async def _flush_buffer(self):
-        """将缓冲区中的数据批量写入数据库"""
-        async with self.buffer_lock:
-            if not self.items_buffer:
-                return
-
-            items_to_insert = self.items_buffer.copy()
-            self.items_buffer.clear()
-
-        try:
-            await self._ensure_pool()
-            first_item = items_to_insert[0]
-            sql = make_insert_sql(table=self.table_name, data=first_item, many=True)
-
-            values = [list(item.values()) for item in items_to_insert]
-
-            async with self.pool.acquire() as conn:
-                async with conn.cursor() as cursor:
-                    affected_rows = await cursor.executemany(sql, values)
-                    await conn.commit()
-
-            spider_name = getattr(self.crawler.spider, 'name', 'unknown')
-            self.logger.info(f"批量插入 {affected_rows} 条记录到 {self.table_name}")
-            self.crawler.stats.inc_value('mysql/insert_success_batch', len(items_to_insert))
-
-        except Exception as e:
-            self.logger.error(f"批量插入失败: {e}")
-            self.crawler.stats.inc_value('mysql/insert_failed_batch', len(items_to_insert))
-            # 可选：重试或丢弃
-            raise ItemDiscard(f"批量插入失败: {e}")
-
-    async def process_item(self, item, spider, kwargs=None) -> dict:
-        """将 item 添加到缓冲区，触发批量插入"""
-        item_dict = dict(item)
-
-        async with self.buffer_lock:
-            self.items_buffer.append(item_dict)
-            if len(self.items_buffer) >= self.batch_size:
-                # 达到批量阈值，立即刷新
-                await self._flush_buffer()
-
-        return item
-
-    async def spider_closed(self):
-        """关闭爬虫时，确保所有剩余数据被写入"""
-        if self.flush_task:
-            self.flush_task.cancel()
-            try:
-                await self.flush_task
-            except asyncio.CancelledError:
-                pass
-
-        # 刷最后一批数据
-        if self.items_buffer:
-            await self._flush_buffer()
-
-        # 关闭连接池
-        if self.pool:
-            self.pool.close()
-            await self.pool.wait_closed()
-            self.logger.info("MySQL连接池已关闭")
-
-
-class AiomysqlMySQLPipeline:
-    def __init__(self, crawler):
-        self.crawler = crawler
-        self.settings = crawler.settings
-        self.logger = get_logger(self.__class__.__name__, self.settings.get('LOG_LEVEL'))
-
-        # 配置
-        self.table_name = (
-            self.settings.get('MYSQL_TABLE') or
-            getattr(crawler.spider, 'mysql_table', None) or
-            f"{crawler.spider.name}_items"
-        )
-        self.batch_size = self.settings.getint('MYSQL_BATCH_SIZE', 100)
-        self.flush_interval = self.settings.getfloat('MYSQL_FLUSH_INTERVAL', 3.0)
-
-        # 连接池
-        self._pool_lock = asyncio.Lock()
-        self._pool_initialized = False
-        self.pool = None
-
-        # 缓冲
-        self.items_buffer: List[Dict] = []
-        self.buffer_lock = asyncio.Lock()
-
-        # 后台任务
-        self.flush_task: Optional[asyncio.Task] = None
-
-        crawler.subscriber.subscribe(self.spider_closed, event='spider_closed')
-
-    @classmethod
-    def create_instance(cls, crawler):
-        return cls(crawler)
-
-    async def _init_pool(self):
-        """延迟初始化连接池（线程安全）"""
-        if self._pool_initialized:
-            return
-
-        async with self._pool_lock:
-            if not self._pool_initialized:
-                try:
-                    self.pool = await aiomysql.create_pool(
-                        host=self.settings.get('MYSQL_HOST', 'localhost'),
-                        port=self.settings.getint('MYSQL_PORT', 3306),
-                        user=self.settings.get('MYSQL_USER', 'root'),
-                        password=self.settings.get('MYSQL_PASSWORD', ''),
-                        db=self.settings.get('MYSQL_DB', 'scrapy_db'),
-                        minsize=self.settings.getint('MYSQL_POOL_MIN', 3),
-                        maxsize=self.settings.getint('MYSQL_POOL_MAX', 10),
-                        cursorclass=aiomysql.DictCursor,
-                        autocommit=False
-                    )
-                    self._pool_initialized = True
-                    self.logger.debug(f"aiomysql连接池已初始化（表: {self.table_name}）")
-                except Exception as e:
-                    self.logger.error(f"aiomysql连接池初始化失败: {e}")
-                    raise
-
-    async def open_spider(self, spider):
-        """爬虫启动时创建后台刷新任务"""
-        await self._init_pool()
-        self.flush_task = asyncio.create_task(self._flush_loop())
-
-    async def _flush_loop(self):
-        """定期刷新缓冲区"""
-        while True:
-            await asyncio.sleep(self.flush_interval)
-            if len(self.items_buffer) > 0:
-                await self._flush_buffer()
-
-    async def _flush_buffer(self):
-        """执行批量插入"""
-        async with self.buffer_lock:
-            if not self.items_buffer:
-                return
-            items_to_insert = self.items_buffer.copy()
-            self.items_buffer.clear()
-
-        try:
-            await self._init_pool()
-            keys = items_to_insert[0].keys()
-            placeholders = ', '.join(['%s'] * len(keys))
-            columns = ', '.join([f'`{k}`' for k in keys])
-            sql = f"INSERT INTO `{self.table_name}` ({columns}) VALUES ({placeholders})"
-
-            values = [list(item.values()) for item in items_to_insert]
-
-            async with self.pool.acquire() as conn:
-                async with conn.cursor() as cursor:
-                    result = await cursor.executemany(sql, values)
-                    await conn.commit()
-
-            spider_name = getattr(self.crawler.spider, 'name', 'unknown')
-            self.logger.info(f"【{spider_name}】批量插入 {result} 条记录到 {self.table_name}")
-            self.crawler.stats.inc_value('mysql/insert_success_batch', len(items_to_insert))
-
-        except aiomysql.Error as e:
-            self.logger.error(f"aiomysql批量插入失败: {e}")
-            self.crawler.stats.inc_value('mysql/insert_failed_batch', len(items_to_insert))
-            raise ItemDiscard(f"MySQL错误: {e.args[1]}")
-        except Exception as e:
-            self.logger.error(f"未知错误: {e}")
-            raise ItemDiscard(f"处理失败: {e}")
-
-    async def process_item(self, item, spider) -> dict:
-        item_dict = dict(item)
-
-        async with self.buffer_lock:
-            self.items_buffer.append(item_dict)
-            if len(self.items_buffer) >= self.batch_size:
-                await self._flush_buffer()
-
-        return item
-
-    async def spider_closed(self):
-        """清理资源并提交剩余数据"""
-        if self.flush_task:
-            self.flush_task.cancel()
-            try:
-                await self.flush_task
-            except asyncio.CancelledError:
-                pass
-
-        if self.items_buffer:
-            await self._flush_buffer()
-
-        if self.pool:
-            self.pool.close()
-            await self.pool.wait_closed()
-            self.logger.info("aiomysql连接池已释放")

crawlo/utils/pqueue.py

@@ -1,174 +0,0 @@
-# -*- coding:UTF-8 -*-
-import sys
-import asyncio
-import warnings
-from urllib.parse import urlparse
-from asyncio import PriorityQueue
-from redis.asyncio import from_url
-from typing import Any, Optional, Dict, Annotated
-from pydantic import (
-    BaseModel,
-    Field,
-    model_validator
-)
-
-from crawlo import Request
-from crawlo.settings.default_settings import REDIS_URL
-
-
-class SpiderPriorityQueue(PriorityQueue):
-    """带超时功能的异步优先级队列"""
-
-    def __init__(self, maxsize: int = 0) -> None:
-        """初始化队列，maxsize为0表示无大小限制"""
-        super().__init__(maxsize)
-
-    async def get(self, timeout: float = 0.1) -> Optional[Request]:
-        """
-        异步获取队列元素，带超时功能
-
-        Args:
-            timeout: 超时时间（秒），默认0.1秒
-
-        Returns:
-            队列元素(优先级, 值)或None(超时)
-        """
-        try:
-            # 根据Python版本选择超时实现方式
-            if sys.version_info >= (3, 11):
-                async with asyncio.timeout(timeout):
-                    return await super().get()
-            else:
-                return await asyncio.wait_for(super().get(), timeout=timeout)
-        except asyncio.TimeoutError:
-            return None
-
-
-class TaskModel(BaseModel):
-    """爬虫任务数据模型 (完全兼容Pydantic V2)"""
-    url: Annotated[str, Field(min_length=1, max_length=2000, examples=["https://example.com"])]
-    meta: Dict[str, Any] = Field(default_factory=dict)
-    priority: Annotated[int, Field(default=0, ge=0, le=10, description="0=最高优先级")]
-
-    @classmethod
-    def validate_url(cls, v: str) -> str:
-        """验证URL格式"""
-        if not v.startswith(('http://', 'https://')):
-            raise ValueError('URL必须以 http:// 或 https:// 开头')
-
-        parsed = urlparse(v)
-        if not parsed.netloc:
-            raise ValueError('URL缺少有效域名')
-
-        return v.strip()
-
-    @model_validator(mode='after')
-    def validate_priority_logic(self) -> 'TaskModel':
-        """跨字段验证示例"""
-        if 'admin' in self.url and self.priority > 5:
-            self.priority = 5  # 自动调整管理页面的优先级
-        return self
-
-
-class DistributedPriorityQueue:
-    def __init__(
-            self,
-            redis_url: str,
-            queue_name: str = "spider_queue",
-            max_connections: int = 10,
-            health_check_interval: int = 30
-    ):
-        """
-        Args:
-            redis_url: redis://[:password]@host:port[/db]
-            queue_name: Redis有序集合键名
-            max_connections: 连接池大小
-            health_check_interval: 连接健康检查间隔(秒)
-        """
-        self.redis = from_url(
-            redis_url,
-            max_connections=max_connections,
-            health_check_interval=health_check_interval,
-            socket_keepalive=True,
-            decode_responses=True
-        )
-        self.queue_name = queue_name
-
-    async def put(self, task: TaskModel) -> bool:
-        """
-        添加任务到队列（使用Pydantic V2的model_dump_json）
-
-        Args:
-            task: 已验证的TaskModel实例
-
-        Returns:
-            bool: 是否成功添加 (Redis的ZADD返回添加数量)
-        """
-        with warnings.catch_warnings():
-            warnings.simplefilter("ignore", category=DeprecationWarning)
-            task_str = task.model_dump_json()  # 正确使用V2的序列化方法
-        return await self.redis.zadd(
-            self.queue_name,
-            {task_str: task.priority}
-        ) > 0
-
-    async def get(self, timeout: float = 1.0) -> Optional[TaskModel]:
-        """
-        获取优先级最高的任务（自动验证）
-
-        Args:
-            timeout: 阻塞超时时间(秒)
-
-        Returns:
-            TaskModel实例或None(超时/队列空)
-        """
-        try:
-            result = await self.redis.bzpopmax(
-                self.queue_name,
-                timeout=timeout
-            )
-            if result:
-                _, task_str, _ = result
-                with warnings.catch_warnings():
-                    warnings.simplefilter("ignore", category=DeprecationWarning)
-                    return TaskModel.model_validate_json(task_str)  # 正确使用V2的反序列化方法
-        except Exception as e:
-            print(f"任务获取失败: {type(e).__name__}: {e}")
-        return None
-
-    async def aclose(self):
-        """安全关闭连接"""
-        await self.redis.aclose()
-
-    async def __aenter__(self):
-        return self
-
-    async def __aexit__(self, exc_type, exc_val, exc_tb):
-        await self.aclose()
-
-
-# 使用示例
-async def demo():
-    async with DistributedPriorityQueue(
-            REDIS_URL,
-            max_connections=20,
-            health_check_interval=10
-    ) as queue:
-        # 添加任务（自动触发验证）
-        task = TaskModel(
-            url="https://example.com/1",
-            priority=1,
-            meta={"depth": 2}
-        )
-
-        if await queue.put(task):
-            print(f"任务添加成功: {task.url}")
-
-        # 获取任务
-        if result := await queue.get(timeout=2.0):
-            print(f"获取任务: {result.url} (优先级={result.priority})")
-            print(f"元数据: {result.meta}")
-
-
-if __name__ == "__main__":
-    asyncio.run(demo())

crawlo-1.1.1.dist-info/METADATA

@@ -1,220 +0,0 @@
-Metadata-Version: 2.4
-Name: crawlo
-Version: 1.1.1
-Summary: Crawlo 是一款基于异步IO的高性能Python爬虫框架，支持分布式抓取。
-Home-page: https://github.com/crawl-coder/Crawlo.git
-Author: crawl-coder
-Author-email: crawlo@qq.com
-License: MIT
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-Requires-Dist: aiohttp>=3.12.14
-Requires-Dist: aiomysql>=0.2.0
-Requires-Dist: aioredis>=2.0.1
-Requires-Dist: asyncmy>=0.2.10
-Requires-Dist: cssselect>=1.2.0
-Requires-Dist: dateparser>=1.2.2
-Requires-Dist: httpx[http2]>=0.27.0
-Requires-Dist: curl-cffi>=0.13.0
-Requires-Dist: lxml>=5.2.1
-Requires-Dist: motor>=3.7.0
-Requires-Dist: parsel>=1.9.1
-Requires-Dist: pydantic>=2.11.7
-Requires-Dist: pymongo>=4.11
-Requires-Dist: PyMySQL>=1.1.1
-Requires-Dist: python-dateutil>=2.9.0.post0
-Requires-Dist: redis>=6.2.0
-Requires-Dist: requests>=2.32.4
-Requires-Dist: six>=1.17.0
-Requires-Dist: ujson>=5.9.0
-Requires-Dist: urllib3>=2.5.0
-Requires-Dist: w3lib>=2.1.2
-Requires-Dist: rich>=14.1.0
-Requires-Dist: astor>=0.8.1
-Requires-Dist: watchdog>=6.0.0
-Provides-Extra: render
-Requires-Dist: webdriver-manager>=4.0.0; extra == "render"
-Requires-Dist: playwright; extra == "render"
-Requires-Dist: selenium>=3.141.0; extra == "render"
-Provides-Extra: all
-Requires-Dist: bitarray>=1.5.3; extra == "all"
-Requires-Dist: PyExecJS>=1.5.1; extra == "all"
-Requires-Dist: pymongo>=3.10.1; extra == "all"
-Requires-Dist: redis-py-cluster>=2.1.0; extra == "all"
-Requires-Dist: webdriver-manager>=4.0.0; extra == "all"
-Requires-Dist: playwright; extra == "all"
-Requires-Dist: selenium>=3.141.0; extra == "all"
-
-# 🕷️ Crawlo - 轻量级异步爬虫框架
-
-> 一个简洁、易用、可扩展的 Python 异步爬虫框架，灵感源自 Scrapy，但更轻量、更易上手。
-
-🚀 支持命令行操作、爬虫生成、合规检查、运行监控与统计分析，适合快速开发中小型爬虫项目。
-
----
-
-## 📦 特性
-
-- ✅ **命令行驱动**：`crawlo startproject`, `crawlo genspider` 等
-- ✅ **自动发现爬虫**：无需手动注册，自动加载 `spiders/` 模块
-- ✅ **异步核心**：基于 `asyncio` 实现高并发抓取
-- ✅ **灵活配置**：通过 `crawlo.cfg` 和 `settings.py` 管理项目
-- ✅ **爬虫检查**：`crawlo check` 验证爬虫定义是否合规
-- ✅ **运行统计**：`crawlo stats` 查看历史运行指标（持久化存储）
-- ✅ **批量运行**：支持 `crawlo run all` 启动所有爬虫
-- ✅ **日志与调试**：结构化日志输出，便于排查问题
-
----
-
-## 🚀 快速开始
-
-### 1. 安装 Crawlo
-
-```bash
-pip install crawlo
-```
-
-> ⚠️ 当前为开发阶段，建议使用源码安装：
->
-> ```bash
-> git clone https://github.com/yourname/crawlo.git
-> pip install -e crawlo
-> ```
-
-### 2. 创建项目
-
-```bash
-crawlo startproject myproject
-cd myproject
-```
-
-生成项目结构：
-
-```
-myproject/
-├── crawlo.cfg
-├── myproject/
-│   ├── __init__.py
-│   ├── settings.py
-│   └── spiders/
-│       ├── __init__.py
-│       └── (你的爬虫将在这里)
-```
-
-### 3. 生成爬虫
-
-```bash
-crawlo genspider example example.com
-```
-
-生成 `spiders/example.py`：
-
-```python
-class ExampleSpider(Spider):
-    name = "example"
-    start_urls = ["https://example.com"]
-    
-    def parse(self, response):
-        # 解析逻辑
-        pass
-```
-
-### 4. 检查爬虫合规性
-
-```bash
-crawlo check
-```
-
-输出示例：
-
-```
-🔍 Checking 1 spider(s)...
-✅ example              ExampleSpider (OK)
-🎉 All spiders are compliant!
-```
-
-### 5. 运行爬虫
-
-```bash
-# 运行单个爬虫
-crawlo run example
-
-# 运行所有爬虫
-crawlo run all
-```
-
-### 6. 查看运行统计
-
-```bash
-crawlo stats
-```
-
-查看最近一次运行的请求、响应、项目数等指标：
-
-```
-📊 Recent Spider Statistics (last run):
-🕷️  example
-    downloader/request_count           1
-    item_scraped_count                 1
-    log_count/INFO                     7
-```
-
----
-
-## 🛠️ 命令列表
-
-| 命令 | 说明 |
-|------|------|
-| `crawlo startproject <name>` | 创建新项目 |
-| `crawlo genspider <name> <domain>` | 生成爬虫模板 |
-| `crawlo list` | 列出所有已注册的爬虫 |
-| `crawlo check` | 检查爬虫定义是否合规 |
-| `crawlo run <spider_name>` | 运行指定爬虫 |
-| `crawlo run all` | 运行所有爬虫 |
-| `crawlo stats` | 查看最近运行的统计信息 |
-| `crawlo stats <spider_name>` | 查看指定爬虫的统计 |
-
----
-
-## 📁 项目结构说明
-
-```ini
-# crawlo.cfg
-[settings]
-default = myproject.settings
-```
-
-```python
-# settings.py
-BOT_NAME = "myproject"
-LOG_LEVEL = "DEBUG"
-CONCURRENT_REQUESTS = 3
-DOWNLOAD_DELAY = 1.0
-# 其他配置...
-```
-
----
-
-## 📊 统计持久化
-
-每次爬虫运行结束后，统计信息会自动保存到：
-
-```
-logs/stats/<spider_name>_YYYYMMDD_HHMMSS.json
-```
-
-可通过 `crawlo stats` 命令读取，支持跨进程查看。
-
----
-
-## 🧪 开发者提示
-
-- 确保 `spiders/__init__.py` 中导入了你的爬虫类，否则无法被发现
-- 使用 `get_project_root()` 自动定位项目根目录（通过查找 `crawlo.cfg`）
-- 所有命令行工具均支持直接运行：`python -m crawlo.commands.list`
-
----
-