Metadata-Version: 2.4
Name: XGM_dev
Version: 0.0.2
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
Requires-Dist: quarkstudio[remote]
Provides-Extra: full
Requires-Dist: quark; extra == "full"
Dynamic: author
Dynamic: license-file
Dynamic: requires-python

# XGM_dev

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

## 版本

当前版本：0.0.2

## 包含的设备驱动

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

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

## 安装

### 基本安装

使用 pip 安装：

```bash
pip install XGM_dev
```

### 完整安装（包含所有依赖）

```bash
# 安装完整版本（包含所有可选依赖）
pip install XGM_dev[full]
```

### 依赖说明

当前版本使用 `quarkstudio[remote]` 作为主要依赖，它已经包含了 BaseDriver 的功能。如果遇到安装问题，可以参考下面的解决方案。

## 依赖

### 必需依赖

- numpy
- waveforms
- quarkstudio[remote] - 用于驱动基类 BaseDriver 和远程功能

### 可选依赖

- quark（旧版本，仅用于兼容性，推荐使用 quarkstudio[remote]）

**注意**：`quarkstudio[remote]` 是推荐使用的依赖，如果遇到安装问题，可以参考下面的解决方案。

## 依赖问题解决指南

### 问题描述

安装时可能遇到以下错误：
```
SyntaxError: Missing parentheses in call to 'print'
```

这是因为 `quark` 的依赖项 `twiceredis` 使用了 Python 2 语法。

### 解决方案

#### 方案1：使用已安装的 quark

如果您的环境中已经安装了 `quark`，可以直接使用：

```bash
pip install XGM_dev --no-deps
pip install numpy waveforms
# quark 已经存在于您的环境中
```

#### 方案2：手动安装修复后的依赖

```bash
# 先安装基础包
pip install XGM_dev

# 然后尝试从特定源安装 quark，或使用本地版本
```

#### 方案3：联系维护者

如果以上方案都不行，建议：
- 检查是否有修复版本的 `quark` 包
- 或使用本地/私有源安装 `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

