技术文档：Python 跨栏谜题库（.puz 文件解析器）

本文档将详细介绍如何安装、使用及操作 Python 跨栏谜题库（以下简称为 puz.py），该库是基于 .puz 文件格式实现的 Python 库。

1. 安装指南

要安装 puz.py，请确保您的系统中已安装 Python。以下为安装步骤：

pip install puz

2. 项目的使用说明

puz.py 提供了丰富的功能，用于处理 .puz 格式的跨栏谜题文件。以下是一些基本的使用示例：

加载谜题文件

import puz
p = puz.read('testfiles/washpost.puz')

打印谜题提示及答案

numbering = p.clue_numbering()

print '横线'
for clue in numbering.across:
    answer = ''.join(
        p.solution[clue['cell'] + i]
        for i in range(clue['len']))
    print clue['num'], clue['clue'], '-', answer

print '竖线'
for clue in numbering.down:
    answer = ''.join(
        p.solution[clue['cell'] + i * numbering.width]
        for i in range(clue['len']))
    print clue['num'], clue['clue'], '-', answer

打印谜题网格

for row in range(p.height):
    cell = row * p.width
    # 使用 p.solution 替换 p.fill 来打印答案
    print ' '.join(p.fill[cell:cell + p.width])

解锁打乱后的答案

p.unlock_solution(7844)
# p.solution 已经解锁

保存修改后的谜题

p.fill = 'LAMB' + p.fill[4:]
p.save('mine.puz')

3. 项目API使用文档

以下是 puz.py 中的主要类和方法：

• puz.Puzzle: 为主类，用于处理谜题文件。
  • read(filename): 读取并解析指定路径的谜题文件。
  • save(filename): 将修改后的谜题保存到指定路径。
  • unlock_solution(key): 解锁打乱后的答案。
  • clue_numbering(): 获取提示编号。

4. 项目安装方式

puz.py 的安装方式已在“安装指南”中详细介绍。请参考上述步骤进行安装。

---

本文档基于 puz.py 的 README 文件和 GitHub 项目 Wiki 编写，旨在帮助用户更好地了解和使用该库。如需了解更多信息，请参考项目官方文档。