Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vijos/vj4
The online judge service with millions of submissions, since 2005.
https://github.com/vijos/vj4
mongodb online-judge python vijos
Last synced: 27 days ago
JSON representation
The online judge service with millions of submissions, since 2005.
- Host: GitHub
- URL: https://github.com/vijos/vj4
- Owner: vijos
- License: agpl-3.0
- Created: 2016-05-08T09:55:54.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-01-01T17:43:03.000Z (12 months ago)
- Last Synced: 2024-08-10T14:16:25.797Z (5 months ago)
- Topics: mongodb, online-judge, python, vijos
- Language: Python
- Homepage: https://vijos.org
- Size: 5.75 MB
- Stars: 531
- Watchers: 25
- Forks: 109
- Open Issues: 121
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Next generation of Vijos, built with asyncio on Python 3.
***
## Overview
- Problem Categories and Tags
- Solution Sharing & Voting
- Online Coding and Testing (a.k.a. Scratchpad Mode)
- Discussions & Comments
- Trainings
- Contests (ACM & OI)
- Dynamic Ranking System
- Real-time Status Updates
- Online Judge as a Service (a.k.a. Domain): create your own OJ website without dev-ops!
- Management UI
- Sandboxed & Distributed Judging: see [jd4](https://github.com/vijos/jd4), [winjudge](https://github.com/iceb0y/winjudge) and [windows-container](https://github.com/iceb0y/windows-container)
- Secure (we are also CTF players)
- Modern Architecture & User Interface
## Usage
### Pre-built docker package
There is pre-built docker package at `vijos/vj4`. This is maintained by [@moesoha](https://github.com/moesoha). Source code is available at https://github.com/vijos/vj4-docker.
### Manual build
#### Prerequisites
* [Python 3.7+, <=3.9](https://www.python.org/downloads/)
* [MongoDB 3.0+, <=5.0](https://www.mongodb.com/docs/v5.0/installation/)
* [Node.js 10.0+](https://nodejs.org/en/download/package-manager/)
* [RabbitMQ](http://www.rabbitmq.com/)
#### Install requirements
In the root of the repository, where `requirements.txt` and `package.json` locates:
```bash
python3 -m pip install -r requirements.txt
yarn
```
You don't need root privilege to run `yarn`. It installs stuffs in the project directory. We recommend using Node 10.
You may want to use [tuna](https://pypi.tuna.tsinghua.edu.cn/) if you are in China.
Some requirements may need `Python.h` and `ffi.h`. In Debian/Ubuntu you can use
```bash
apt install python3-dev libffi-dev
```
to resolve this.
#### IP Geo-Location
To enable IP geo-location translation, you need to follow the instruction on [MaxMind GeoLite2](http://dev.maxmind.com/geoip/geoip2/geolite2/) to obtain a GeoLite2 City Database, unzip it, and put it in the project root directory with the filename `GeoLite2-City.mmdb`.
You may also want to install [libmaxminddb](https://github.com/maxmind/libmaxminddb/blob/master/README.md) for higher performance.
## Development
In the root of the repository:
```bash
yarn build # or: yarn build:watch
python3 -m vj4.server --debug
```
> Set `--listen` (default: http://127.0.0.1:8888) to listen on a different address.
As an intuitive example, you may want to add a super administrator and a problem to start:
```bash
alias pm="python3 -m"
pm vj4.model.user add -1 icebox 12345 [email protected]
pm vj4.model.user set_superadmin -1
pm vj4.model.adaptor.problem add system "Dummy Problem" "# It *works*" -1 1000 # you can also use web UI
```
You need to run these scripts on a regular basis to maintain correct RP and ranks for all users:
```bash
pm vj4.job.rp recalc_all
pm vj4.job.rank run_all
```
### Watch and Restart
Frontend source codes can be recompiled automatically by running:
```bash
yarn build:watch
```
However you need to manually restart the server for server-side code to take effect.
## Production
```bash
yarn build:production
python3 -m vj4.server --listen=unix:/var/run/vj4.sock
```
* Set `--listen` (default: http://127.0.0.1:8888) to listen on a different address.
* Set `--prefork` (default: 1) to specify the number of worker processes.
* Set `--ip-header` (default: '') to use IP address in request headers.
* Set `--url-prefix` (default: https://vijos.org) to set URL prefix.
* Set `--cdn-prefix` (default: /) to set CDN prefix.
* Set `--smtp-host`, `--smtp-user`, `--smtp-password`, and `--mail-from` to specify a SMTP server.
* Set `--db-host` (default: localhost) and/or `--db-name` (default: test) to use a different
database.
Better to use a reverse proxy like Nginx or h2o.
## Judging
To enable vj4 to judge, at least one judge user and one judge daemon instance are needed.
* Use following commands to create a judge user:
```bash
alias pm="python3 -m"
pm vj4.model.user add -2 judge 123456 [email protected]
pm vj4.model.user set_judge -2
```
### Use jd4
* See https://github.com/vijos/jd4 for more details about the judge daemon.
### Use HydroJudge
* You can also use [HydroJudge](https://hydro.js.org/plugins/hydrojudge/) from [Hydro](https://github.com/hydro-dev/Hydro).
## Notes
Have fun!
Maximum line width: 100
Indentation: 2 spaces
[JavaScript Style Guide](https://github.com/airbnb/javascript)
No commercial use, except get permission from us.
## References
* [aiohttp](http://aiohttp.readthedocs.org/en/stable/)
* [Jinja2 Documentation](http://jinja.pocoo.org/docs/)
* [Motor: Asynchronous Python driver for MongoDB](http://motor.readthedocs.org/en/stable/)
* [Webpack Module Bundler](https://webpack.js.org/)