Metadata-Version: 2.4
Name: chromedriver-sync
Version: 1.0.1
Summary: 自动检测环境并从 dreamshao/chromedriver 下载对应驱动的工具
Home-page: https://github.com/dreamshao/chromedriver
Author: dreamshao
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: requests
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 🚀 ChromeDriver Sync Manager

**ChromeDriver Sync** 是一个轻量级的 Python 工具，旨在解决自动化测试中最头疼的问题：**Chrome 浏览器与驱动版本不匹配**。

它会自动检测你电脑上安装的 Chrome 版本和系统架构（Windows/Mac/Linux），并从 [dreamshao/chromedriver](https://github.com/dreamshao/chromedriver) 镜像仓库中精准下载对应的驱动文件。

---

## ✨ 核心特性

* **智能检测**：自动识别本地 Chrome 版本（支持 v115+ 后的新架构）。
* **全平台支持**：支持 Windows (32/64)、macOS (Intel/M1/M2/M3)、Linux (64位)。
* **交互式补救**：如果找不到完全匹配的版本，会询问是否尝试下载最新的稳定版。
* **速度优势**：专为国内开发者优化，避开 Google 官方源连接不稳定的问题。

---

## 📦 安装方式

通过 `pip` 即可一键安装：

```bash
pip install chromedriver-sync

```

---

## 🛠 使用方法

安装完成后，直接在你的终端（Terminal/Command Prompt）输入以下命令：

```bash
chromedriver-sync

```

### 运行效果展示

1. **自动匹配**：程序会输出 `检测到系统平台: mac-arm64` 和 `检测到 Chrome 版本: 121`。
2. **自动下载**：匹配成功后自动下载压缩包。
3. **解压就绪**：驱动会解压到当前执行命令的目录下，你可以直接在代码中引用。

---

## 🐍 在 Python 代码中调用

如果你想在代码运行初期自动更新驱动，可以这样集成：

```python
from chromedriver_sync.main import sync

# 运行同步逻辑，确保驱动是最新的
sync()

# 接下来启动你的 Selenium
from selenium import webdriver
driver = webdriver.Chrome()

```

---

## ❓ 常见问题 (FAQ)

**Q: 为什么我运行后提示“未找到匹配版本”？**
A: 这通常是因为你的 Chrome 刚刚更新，而官方驱动尚未发布。此时输入 `y` 下载仓库中最新的版本，通常是可以向下兼容的。

**Q: 如何将驱动安装到系统路径？**
A: 建议将下载后的 `chromedriver` 移动到 `/usr/local/bin` (Mac/Linux) 或将其所在文件夹添加到 Windows 的 `PATH` 环境变量中。

---

## 🌟 贡献与支持

如果你觉得这个工具有帮到你，请给 [dreamshao/chromedriver](https://github.com/dreamshao/chromedriver) 点一个 **Star** ⭐！这也是我持续更新驱动版本的动力。
