y³OJ
a simple, light-weight and highly maintainable online judge system for secondary education
一个简单、轻量化、易于维护的、为中学信息技术学科课业教学设计的 Online Judge 系统。
Online Judge?
在线评测系统（Online Judge，缩写 OJ）是一种在算法竞赛竞赛中用来测试参赛程序的在线系统，也可以用于平时练习。许多 OJ 网站会自发组织一些竞赛。此外，OJ 网站通常会设立用户排名，以用户的提交答案通过数多少或某个题目执行时间快慢为排名依据。（来源：维基百科）
该项目从传统 OJ 的设计出发，针对中学信息技术学科课业教学进行优化：如支持在 Python 中进行文件读取、引入第三方库等操作；同时原生支持交互式测评，并提供了一套 testlib API。
Deploy
环境配置
由于 Sandbox 技术限制，评测端必须部署在 Linux 中。环境需求如下：
- Python 3.6+
- NodeJS 12+
- 包管理器 pip & npm
- 命令行工具 wget & cmake
配置文件为 ./config.yml，请复制 ./config.sample.yml 到 ./config.yml 并填写配置。为了网站安全，请务必填写 secret_key 选项为随机秘钥，登录插件等都依赖于此。
数据目录为 ./data，你可以从 @y3oj/demo-data 从下载示例数据。
为运行 Sandbox 请按照 @t123yh/simple-sandbox 配置系统。
网页端
使用 Flask & jinja2 开发，需要安装相关依赖。
pip install -r requirements.txt
python build-frontend.py
python run.py # start server
前端
使用 Less 生成样式，第三方包托管在 @y3oj/thirdparty-host。
npm install -g less uglifyjs
python build-frontend.py # build static
build-frontend.py 提供两个参数：
--force，构建时强制重新下载第三方包，复制静态文件时强行覆盖。--watch，启用 Watch Mode，依赖于系统 API 检测文件更改时自动重新构建。
评测端
使用 NodeJS 开发，沙盒由 @t123yh/simple-sandbox 提供，使用 websocket 与主程序通信。
再次提醒，请确保已经按照 @t123yh/simple-sandbox 配置系统。
cd y3oj-judger
git clone https://github.com/t123yh/simple-sandbox.git # repo mirror: https://e.coding.net/memset0/y3oj/simple-sandbox.git
cd simple-sandbox && CXX=clang++-9 yarn install && yarn run build && cd ..
npm install
npm run judge-test # run test
npm run judge-start # start judge server
Sandbox Rootfs
另外需要构建一个沙盒所使用的 rootfs。这里用的是 archlinux，参考代码如下
wget -c https://mirrors.tuna.tsinghua.edu.cn/archlinux/iso/latest/archlinux-bootstrap-2021.10.01-x86_64.tar.gz -O sandbox-rootfs.tar.gz
mkdir -p ./sandbox-rootfs
sudo tar -zxvf sandbox-rootfs.tar.gz -C ./sandbox-rootfs # remember `sudo`
cd ./sandbox-rootfs
mount ./root.x86_64/ ./root.x86_64/ --bind
sudo ./root.x86_64/usr/bin/arch-chroot ./root.x86_64/
mkdir -p /sandbox/working
echo "Server = https://mirrors.tuna.tsinghua.edu.cn/archlinux/\$repo/os/\$arch" > /etc/pacman.d/mirrorlist
pacman -Syy
pacman-key --init && pacman-key --populate archlinux
pacman -S python3 python-pip --noconfirm
pip install flask numpy matplotlib pandas flask_wtf requests pyyaml flask_login --index-url https://pypi.douban.com/simple
Docs
请访问 y3oj-docs。
4 Oct 27, 2022
4.7k Jan 8, 2023
1.1k Jan 9, 2023
1.2k Dec 30, 2022
4.7k Dec 29, 2022
16 Jun 17, 2022
1k Jan 7, 2023
2 Oct 31, 2021
32 Dec 19, 2022
2 Mar 07, 2022
3 Aug 02, 2022
1 Feb 10, 2022
4 Jun 01, 2022
0 Mar 21, 2022
189 Dec 13, 2022
1 Nov 16, 2021
0 Jan 03, 2022
367 Dec 27, 2022
14 Oct 14, 2022
21 Mar 08, 2022
5.8k Dec 30, 2022
71 Dec 25, 2022
1 Nov 16, 2021
1 Nov 21, 2021
1 Jun 08, 2022
2 Oct 17, 2021
99 Dec 13, 2022
160 Jan 08, 2023
2 Jan 06, 2022