funbattle

数据竞赛代码骨架仓库：按「平台 / 赛事 ID」分目录，为个人参加的数据竞赛（如 DataFountain） 预留可导入的包结构。

当前状态：只有目录骨架，尚无实现代码。 已搭建的唯一赛题是 DataFountain 557，其 model/、utils/、evalution/ 三个子包都只有空的 __init__.py，不提供任何函数、类或 CLI。赛事数据集和一次性脚本不随此包发布。

环境要求

• Python 3.10 或更高版本
• uv（组织统一的虚拟环境与依赖管理工具）

安装

包尚未发布到 PyPI，需要克隆仓库后从本地安装：

git clone https://github.com/farfarfun/funbattle.git
cd funbattle
uv sync                 # 创建虚拟环境并安装运行时依赖与开发依赖

只想把本仓库装进已有环境时：

uv pip install .        # 可编辑安装：uv pip install -e .

示例

包内尚无实现代码，当前唯一能演示的就是目录骨架可被正常导入：

from importlib import import_module

bt557 = import_module("funbattle.battles.datafountain.bt557")

print(bt557.__name__)  # funbattle.battles.datafountain.bt557
print(bt557.__doc__)  # 赛题数据集页面链接

新增赛事时，在 src/funbattle/battles/<平台>/<赛事 ID>/ 下补充代码，并同步更新本节的 入口说明和可运行示例。

开发

开发依赖（pytest、ruff）定义在 pyproject.toml 的 [dependency-groups].dev 中， 由 uv 管理：

uv sync

运行测试与静态检查：

uv run pytest -q
uv run ruff check .
uv run ruff format --check .

许可证

本项目使用 MIT License。

---

关于 farfarfun

farfarfun 是一个专注于实用工具库的开源组织， 涵盖云存储、数据处理、AI、多媒体与开发工具链等方向。

• 🏠 组织主页：https://github.com/farfarfun
• 📦 PyPI：https://pypi.org/user/niuliangtao/
• 📧 联系：farfarfun@qq.com

本项目基于 MIT 协议开源。