Metadata-Version: 2.4
Name: XGM_dev
Version: 0.0.3
Summary: XGM设备驱动程序包，包含三个不同设备的驱动程序
Home-page: 
Author: XGM Device Driver Team
Author-email: 
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: waveforms
Provides-Extra: quark
Requires-Dist: quark; extra == "quark"
Provides-Extra: quarkstudio
Requires-Dist: quarkstudio[remote]; extra == "quarkstudio"
Provides-Extra: full
Requires-Dist: quark; extra == "full"
Requires-Dist: quarkstudio[remote]; extra == "full"
Dynamic: author
Dynamic: license-file
Dynamic: requires-python

# XGM_dev

XGM设备驱动程序包，包含三个不同设备的驱动程序。

## 版本

当前版本：0.0.3

## 包含的设备驱动

本包包含以下三个设备的驱动程序：

1. **systemq_qa** - QA版本设备驱动
2. **systemq_xy** - XY版本设备驱动
3. **systemq_z** - Z版本设备驱动

## 安装

### ⚠️ 重要提示

由于 `quark` 和 `quarkstudio` 的某些依赖项存在兼容性问题（特别是 `twiceredis`），**推荐使用方案1或方案2**。

### 方案1：跳过依赖安装（推荐）

如果您的环境中已经安装了 `quark` 或 `quarkstudio`：

```bash
# 只安装基础包，不安装依赖
pip install XGM_dev --no-deps

# 然后手动安装必需的依赖
pip install numpy waveforms

# 确保您已有 quark 环境（代码需要 from quark.driver import BaseDriver）
# 如果还没有，请从您的私有源或其他方式安装
```

### 方案2：基础安装（只安装核心依赖）

```bash
# 基础安装，只包含 numpy 和 waveforms
pip install XGM_dev
```

**注意**：这种方式不会自动安装 `quark` 或 `quarkstudio`，您需要单独安装它们。

### 方案3：尝试完整安装（可能失败）

```bash
# 尝试安装所有依赖（如果遇到错误，请使用方案1或方案2）
pip install XGM_dev[quark]
# 或
pip install XGM_dev[quarkstudio]
# 或
pip install XGM_dev[full]
```

## 依赖

### 必需依赖（自动安装）

- `numpy` - 数值计算库
- `waveforms` - 波形处理库

### 运行时必需但需单独安装

- `quark` 或 `quarkstudio[remote]` - 用于驱动基类 BaseDriver
  - 代码中使用：`from quark.driver import BaseDriver`
  - **这些依赖在安装时可能会失败**（由于 `twiceredis` 的兼容性问题）
  - 请使用方案1，或从您的私有源/本地环境安装

## 依赖问题解决指南

### 问题描述

安装时可能遇到以下错误：

```
SyntaxError: Missing parentheses in call to 'print'
error: metadata-generation-failed
```

这是因为 `quark`/`quarkstudio` 的依赖项 `twiceredis` 使用了 Python 2 语法，在 Python 3 环境下无法安装。

### ✅ 推荐解决方案

#### 方案1：跳过依赖安装（最简单）

```bash
# 1. 只安装基础包，跳过所有依赖
pip install XGM_dev --no-deps

# 2. 安装核心依赖
pip install numpy waveforms

# 3. 使用环境中已有的 quark（如果已安装）
# 验证：python -c "from quark.driver import BaseDriver; print('OK')"
```

#### 方案2：从私有源安装 quark

```bash
# 1. 安装基础包
pip install XGM_dev --no-deps
pip install numpy waveforms

# 2. 从您的私有源或修复后的源安装 quark
pip install quark --index-url <您的私有源URL>
```

#### 方案3：使用本地已修复的包

如果您有修复后的 `quark` 包：

```bash
pip install XGM_dev --no-deps
pip install numpy waveforms
pip install path/to/fixed/quark
```

### 验证安装

安装后验证是否可以正常导入：

```python
# 测试基础包
from systemq_qa.XGM_QA24 import Driver as QADriver
print("✅ systemq_qa 导入成功")

# 测试 quark（必需）
from quark.driver import BaseDriver
print("✅ quark 导入成功")
```

## 使用

安装后，可以导入相应的驱动模块：

```python
from systemq_qa.XGM_QA24 import Driver as QADriver
from systemq_xy.XGM_MDS24 import Driver as XYDriver
from systemq_z.XGM_MDS24 import Driver as ZDriver
```

## 许可证

[添加许可证信息]

## 作者

XGM Device Driver Team

