randomdice 0.1.7

A sample Python package

randomdice™

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Author: aiwonderland Date: 2025-10-01 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

快速开始

安装（开发 / 本地测试）

cd /d d:\evan\codes_evan\randomdice
py -3 -m pip install --upgrade build
py -3 -m build
py -3 -m pip install dist\randomdice-*.whl

也可以直接从 Git 仓库安装：

pip install git+https://github.com/<owner>/<repo>.git

依赖与版本

• 兼容 Python 3.8+（在本仓库中使用标准库 random）
• 在打包或 CI 中需要 build / twine 等工具

常用示例（在 Python 交互式环境或脚本中）

Die（掷骰子）

from randomdice import Die
d6 = Die("D6")
print(d6)                # e.g. Die(type=D6, sides=6)
print(d6.roll())         # 单次掷骰
print(d6.roll(5))        # 多次掷骰，返回列表

# 自定义面值
d_custom = Die()
d_custom.DIYdie(5, sidevalue=['A','B','C','D','E'])
print(d_custom.roll(3))

Coin（抛硬币）

from randomdice import Coin
c = Coin(2)              # coin_number = 2
print(c.flip(3))         # 每个硬币抛三次，返回二维列表

SpinWheel（转盘 / 奖励转盘）

from randomdice import SpinWheel
wheel = SpinWheel(["Red","Green","Blue"])
print(wheel.spin(4))     # 返回 4 次转盘结果

# 高级：创建加权转盘（若实现了权重接口）
# new = wheel.DIYwheelsegments([...], whith_wheel=True, segment_size=10, weights=[...])

Card（牌组）

from randomdice import Card
deck = Card("standard")
print(deck.draw(5))      # 抽 5 张牌
print(deck)              # 查看剩余牌数

Target（目标选择）

• 参见 randomdice/target.py 中的 API 文档与示例（生成不同大小的矩阵目标）

测试与调试

# 在项目根目录运行
py -3 -m pip install --upgrade pytest
pytest -q

• 测试文件位于 project/tests/（示例：tests/test_die.py）
• 如果导入出现问题，请确认在包模式下运行（从 project 根目录或已安装包）

发布与分发（替代方案）

• 若无法上传 PyPI，可使用 GitHub Releases 上传 wheel：
  1. 本地 build：py -3 -m build
  2. 在 Release 页面上传 dist/* 作为 release assets
  3. 用户可用 pip 直接安装 release asset 的 URL

贡献 & 报告问题

• 欢迎提交 Issue 描述复现步骤和错误信息
• 按功能分支提交 PR（例如：fix/die-init 或 feat/spinwheel-weights）
• 在 PR 中包含单元测试或示例以说明变更

许可

• MIT License（见仓库根目录 LICENSE 文件）

常见问题（FAQ）

• “导入失败：cannot import name 'Die'” — 确保 package 已正确安装或在项目根目录运行脚本；避免使用与模块同名的脚本（如 die.py 放在脚本同目录下会遮蔽包）。
• “如何发布到 PyPI” — 推荐先在 Test PyPI 测试；若无法创建 API token，可使用 GitHub Releases 作为替代分发方式。

结束语

• README 中示例基于仓库内文件（randomdice/die.py, coin.py, spinwheel.py, card.py, target.py）。如需我把上述示例直接加入 README.md 文件并提交更改，或需要补全 target / spinwheel 的详细 API 示例，请回复说明要补充的部分。

在当前 PowerShell 会话中设置，随后运行 twine 上传