معرفی شرکت ها
dockerjudge-1.3.1
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
A Docker Based Online Judge Engine
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | dockerjudge-1.3.1 |
| نام | dockerjudge |
| نسخه کتابخانه | 1.3.1 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | 汪心禾 |
| ایمیل نویسنده | wangxinhe06@gmail.com |
| آدرس صفحه اصلی | https://github.com/wxh06/dockerjudge |
| آدرس اینترنتی | https://pypi.org/project/dockerjudge/ |
| مجوز | Apache-2.0 |
<!-- markdownlint-disable MD013 MD033 -->
<p align="center">
<a href="https://github.com/piterator-org">
<img src="https://static.piterator.com/piterator/logo.svg" alt="Piterator" width="20%">
<br>
Made by <strong>Piterator</strong> with <3
</a>
</p>
# dockerjudge
[](https://codeclimate.com/github/wxh06/dockerjudge/maintainability)
[](https://github.com/wxh06/dockerjudge/actions?query=workflow%3A%22Python+package%22)
[](https://github.com/wxh06/dockerjudge/actions?query=workflow%3A%22Upload+Python+Package%22)
[](https://www.transifex.com/piterator/dockerjudge/)
[](https://dev.azure.com/wangxinhe/wangxinhe/_build/latest?definitionId=1)
[](https://dev.azure.com/wangxinhe/wangxinhe/_test/analytics?definitionId=1)
[](https://travis-ci.com/wxh06/dockerjudge)
[](https://codecov.io/gh/wxh06/dockerjudge)
[](https://dockerjudge.readthedocs.io/en/latest/)
[](https://www.python.org/downloads/)
[](https://github.com/wxh06/dockerjudge/releases)
[](https://pypi.org/project/dockerjudge/#history)
[](https://pypi.org/project/dockerjudge/#files)
[](LICENSE)
[](https://app.fossa.com/projects/git%2Bgithub.com%2Fwxh06%2Fdockerjudge?ref=badge_shield)
🎌 **🇺🇸 English** | [🇨🇳 大陆简体](README.zh_Hans_CN.md)
**A LXC based online judge engine**, which supports [10+ programming language processors](#supported-processors):
- [Shell](https://en.wikipedia.org/wiki/Unix_shell)
- [Bash (**B**ourne-**A**gain **sh**ell)](https://en.wikipedia.org/wiki/Bash_(Unix_shell))
- [C](https://en.wikipedia.org/wiki/C_(programming_language))/[C++](https://en.wikipedia.org/wiki/C%2B%2B)
- [GCC (The **G**NU **C**ompiler **C**ollection)](https://gcc.gnu.org/)
- [LLVM Clang](https://clang.llvm.org/)
- [.NET](https://docs.microsoft.com/en-us/dotnet/) ([C#](https://docs.microsoft.com/en-us/dotnet/csharp/) & [Visual Basic](https://docs.microsoft.com/en-us/dotnet/visual-basic/))
- [Mono](https://www.mono-project.com/)
- [Go](https://golang.org/)
- [`go`](https://golang.org/dl/)
- [`gccgo` (GCC)](https://golang.org/doc/install/gccgo)
- [Java](https://www.oracle.com/java/)
- [OpenJDK](https://openjdk.java.net/)
- [Node.js](https://nodejs.org/en/)
- [`node`](https://nodejs.org/en/download/)
- [PHP](https://www.php.net/)
- [`php`](https://www.php.net/downloads)
- [Python](https://www.python.org/)
- [CPython](https://www.python.org/downloads/)
- [PyPy](https://www.pypy.org/)
- [Ruby](https://www.ruby-lang.org/en/)
- [`ruby`](https://www.ruby-lang.org/en/downloads/)
- [Swift](https://swift.org/)
- [`swiftc`](https://swift.org/swift-compiler/)
## Supported processors
Read the [docs](https://dockerjudge.readthedocs.io/en/latest/processor.html#module-dockerjudge.processor) for more information.
Processor | Language(s)\* | Required [Docker image](https://hub.docker.com/)
--------- | ------------- | ------------------------------------------------
`Bash` | Shell | [`bash`](https://hub.docker.com/_/bash)
`Clang` | <ul><li>C (`c`)</li><li>**C++ (`cpp`)**</li></ul> | [`clangbuiltlinux/ubuntu`](https://hub.docker.com/r/clangbuiltlinux/ubuntu)
`GCC` | <ul><li>C (`c`)</li><li>**C++ (`cpp`)**</li><li>Go (`go`)</li></ul> | [`gcc`](https://hub.docker.com/_/gcc)
`Go` | Go | [`golang`](https://hub.docker.com/_/golang)
`Mono` | <ul><li>Visual Basic (`vb`)</li><li>**C# (`csharp`)**</li></ul> | [`mono`](https://hub.docker.com/_/mono)
`Node` | Node.js | [`node`](https://hub.docker.com/_/node)
`OpenJDK` | Java | [`openjdk`](https://hub.docker.com/_/openjdk)
`PHP` | PHP | [`php`](https://hub.docker.com/_/php)
`PyPy` | Python | [`pypy`](https://hub.docker.com/_/pypy)
`Python`| Python | [`python`](https://hub.docker.com/_/python)
`Ruby` | Ruby | [`ruby`](https://hub.docker.com/_/ruby)
`Swift` | Swift | [`swift`](https://hub.docker.com/_/swift)
**\*** The `language` argumnets of the processors which support multiple languages should be provided, or the `source` will be judged in the default language (usually C++ or C#, emboldened in the table).
## Installation
Read the [docs](https://dockerjudge.readthedocs.io/en/latest/installation.html) for more information.
### Docker
To run `dockerjudge`, [Docker Engine](https://www.docker.com/) is required.
#### Install using the convenience script (for servers)
```sh
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
```
See [Install Docker Engine \| Docker Documentation](https://docs.docker.com/engine/install/) for more information.
### Package
#### From the [Python Package Index (PyPI)](https://pypi.org/)
[dockerjudge · PyPI](https://pypi.org/project/dockerjudge/)
- [PyPI](https://pypi.org/simple/dockerjudge/)
- [阿里巴巴开源镜像站 (Alibaba Open Source Mirror)](https://mirrors.aliyun.com/pypi/simple/dockerjudge/)
- [清华大学开源软件镜像站 | Tsinghua Open Source Mirror](https://pypi.tuna.tsinghua.edu.cn/simple/dockerjudge/)
##### Via [pip](https://pip.pypa.io/)
```sh
pip install dockerjudge
```
##### Via [Easy install](https://setuptools.readthedocs.io/en/latest/easy_install.html) (deprecated)
```sh
easy_install dockerjudge
```
#### From [GitHub](https://github.com/)
[wxh06/dockerjudge: A Docker Based Online Judge Engine](https://github.com/wxh06/dockerjudge)
- HTTPS: `https://github.com/wxh06/dockerjudge.git`
- SSH: `git@github.com:wxh06/dockerjudge.git`
```sh
git clone https://github.com/wxh06/dockerjudge.git
cd dockerjudge
make pip && make # python3 -m pip install -Ur requirements.txt && python3 setup.py build
sudo make install # python3 setup.py install
```
## Usage
Read the [docs](https://dockerjudge.readthedocs.io/en/latest/__init__.html) for more information.
```python
>>> from dockerjudge import judge
>>> from dockerjudge.processor import GCC, Clang, Bash, Python, Node, OpenJDK, PHP, Ruby, Mono, Swift
>>>
>>> judge(
... GCC(GCC.Language.c), # or `GCC('c')` / `GCC('C')`, which means compile the source code in the C programming language with `gcc` command
... b'''
... #include <stdio.h>
... int main() {
... int a, b;
... scanf("%d %d", &a, &b);
... printf("%d", a / b);
... return 0;
... }
... ''',
... [
... (b'1 1', b'1'), # AC
... (b'1 2', b'0.5'), # WA
... (b'0 0', b'') # RE
... ]
... )
[
[
(<Status.AC: 'Accepted'>, (b'1', b''), 0.001),
(<Status.WA: 'Wrong Answer'>, (b'0', b''), 0.001),
(<Status.RE: 'Runtime Error'>, (None, b'Floating point exception (core dumped)\n'), 0.01)
],
b''
]
>>>
>>> judge(GCC(GCC.Language.c), b'', [(b'', b'')]) # CE
[
[
(<Status.CE: 'Compilation Error'>, (None, None), 0.0)
],
b"/usr/bin/ld: /usr/lib/x86_64-linux-gnu/crt1.o: in function `_start':\n(.text+0x20): undefined reference to `main'\ncollect2: error: ld returned 1 exit status\n"
]
>>>
>>> judge(
... GCC(GCC.Language.cpp), # or `GCC('cpp')` / `GCC('C++')`, which means compile the source code in the C++ programming language with `g++` command
... b'''
... #include <cstdio>
... int main() {
... printf("Hello, world!");
... while (true)
... ;
... }
... ''',
... [
... (b'', b'Hello, world!') # TLE
... ],
... {
... 'limit': {
... 'time': .1
... }
... }
... )
[
[
(<Status.TLE: 'Time Limit Exceeded'>, (None, b'bash: line 1: 35 Killed timeout -sKILL 0.1 sh -c ./a.out > /dockerjudge/1.out < /dockerjudge/1.in\n'), 0.100)
],
b''
]
>>>
>>> judge(
... GCC(
... GCC.Language.c,
... 'latest', # The GCC version number, such as `4`, `4.8`, etc.
... {'bin': 'a'} # The binary filename, which passes to `gcc`'s `-o` option
... ),
... b'''
... #include <stdio.h>
... int main() {
... int a, b;
... freopen("a.in", "r", stdin); // Open `a.in` as stdin
... scanf("%d %d", &a, &b); // Scan from `a.in`
... freopen("a.out", "w", stdout); // Open `a.out` as stdout
... printf("%d", a / b); // Print to `a.out`
... return 0;
... }
... ''',
... [
... (b'1 1', b'1'), # AC
... (b'1 2', b'0.5'), # WA
... (b'0 0', b'') # RE
... ],
... {
... 'iofilename': {
... 'in': 'a.in',
... 'out': 'a.out'
... }
... }
... )
[
[
(<Status.AC: 'Accepted'>, (b'1', b''), 0.001),
(<Status.WA: 'Wrong Answer'>, (b'0', b''), 0.001),
(<Status.RE: 'Runtime Error'>, (None, b'Floating point exception (core dumped)\n'), 0.001)
],
b''
]
>>>
>>> judge(
... GCC(GCC.Language.c, filenames={'bin': 'a'}),
... b'''
... #include <stdio.h>
... int main() {
... int a, b;
... scanf("%d %d", &a, &b);
... printf("%d", a / b);
... return 0;
... }
... ''',
... [
... (b'1 1', b'1'),
... (b'0 0', b'')
... ],
... {
... 'iofilename': {
... 'out': 'a.out' # ONF
... }
... }
... )
[
[
(<Status.ONF: 'Output Not Found'>, (None, b''), 0.001),
(<Status.RE: 'Runtime Error'>, (None, b'Floating point exception (core dumped)\n'), 0.001)
],
b''
]
>>>
>>> judge( # BTW, GCC starting from 4.9 also supports Go, named `gccgo`
... GCC(GCC.Language.go),
... b'package main\n'
... b''
... b'import "fmt"\n'
... b''
... b'func main() {\n'
... br' fmt.Printf("hello, world\n")'b'\n'
... b'}\n',
... [(b'', b'hello, world')]
... )
[
[
(<Status.AC: 'Accepted'>, (b'hello, world\n', b''), 0.02)
],
b''
]
>>>
>>> judge(
... Clang( # Besides GCC, LLVM Clang is also supported (The same arguments as GCC's)
... Clang.Language.c, # Only C and C++ supported
... 11 # The version number of LLVM CLang is **required**!
... ),
... b'', # CE
... [
... (b'', b'')
... ]
... )
[
[
(<Status.CE: 'Compilation Error'>, (None, None), 0.0)
],
b"/usr/bin/ld: /usr/bin/../lib/gcc/x86_64-linux-gnu/9/../../../x86_64-linux-gnu/crt1.o: in function `_start':\n'
b"(.text+0x24): undefined reference to `main'\n"
b'clang: error: linker command failed with exit code 1 (use -v to see invocation)\n'
]
>>>
>>> # Other programming languages are also supported
>>> judge(Bash(), b'echo Hello, world!', [(b'', b'Hello, world!')]) # Bash
[
[
(<Status.AC: 'Accepted'>, (b'Hello, world!\n', b''), 0.001)
],
b''
]
>>>
>>> judge(Python(3), b"print('Hello, world!')", [(b'', b'Hello, world!')]) # Python 3
[
[
(<Status.AC: 'Accepted'>, (b'Hello, world!\n', b''), 0.05)
],
b"Listing '.'...\n"
b"Compiling './__init__.py'...\n"
]
>>> judge(PyPy(), b"print('Hello, world!')", [(b'', b'Hello, world!')]) # PyPy 3
[
[
(<Status.AC: 'Accepted'>, (b'Hello, world!\n', b''), 0.075)
],
b"Listing '.'...\n"
b"Compiling './__init__.py'...\n"
]
>>>
>>> judge(Node(12), b'console.log("Hello World")', [(b'', b'Hello World')]) # Node.js
[
[
(<Status.AC: 'Accepted'>, (b'Hello World\n', b''), 0.05)
],
b''
]
>>>
>>> judge( # Java / OpenJDK
... OpenJDK(), # The default public class name is `Main`
... b'''
... public class Main {
... public static void main(String[] args) {
... System.out.println("Hello, world!");
... }
... }
... ''',
... [
... (b'', b'Hello, world!')
... ]
... )
[
[
(<Status.AC: 'Accepted'>, (b'Hello, world!\n', b''), 0.1)
],
b''
]
>>>
>>> judge(PHP(), b'<?php echo "Hello, world!";', [(b'', b'Hello, world!')]) # PHP
[
[
(<Status.AC: 'Accepted'>, (b'Hello, world!', b''), 0.05)
],
b'No syntax errors detected in index.php\n'
]
>>>
>>> judge(Ruby(), b'print "Hello, world!";', [(b'', b'Hello, world!')]) # Ruby
[
[
(<Status.AC: 'Accepted'>, (b'Hello, world!', b''), 0.05)
],
b'Syntax OK\n'
]
>>>
>>> judge(
... Mono(Mono.Language.csharp), # C# (Mono)
... b'''
... using System;
...
... public class HelloWorld
... {
... public static void Main(string[] args)
... {
... Console.WriteLine ("Hello Mono World");
... }
... }
... ''',
... [
... (b'', b'Hello Mono World')
... ]
... )
[
[
(<Status.AC: 'Accepted'>, (b'Hello Mono World\n', b''), 0.02)
],
b'Microsoft (R) Visual C# Compiler version 3.5.0-beta1-19606-04 (d2bd58c6)\n'
b'Copyright (C) Microsoft Corporation. All rights reserved.\n'
b'\n'
]
>>> judge(
... Mono(Mono.Language.vb), # Visual Basic (Mono)
... b'''
... Imports System
...
... Module HelloWorld
... Sub Main()
... Console.WriteLine("Hello World!")
... End Sub
... End Module
... ''',
... [
... (b'', b'Hello World!')
... ]
... )
[
[
(<Status.AC: 'Accepted'>, (b'Hello World!\n', b''), 0.024)
],
b'Visual Basic.Net Compiler version 0.0.0.5943 (Mono 4.7 - tarball)\n'
b'Copyright (C) 2004-2010 Rolf Bjarne Kvinge. All rights reserved.\n'
b'\n'
b"Assembly 'mono, Version=0.0, Culture=neutral, PublicKeyToken=null' saved successfully to '/dockerjudge/0/mono.exe'.\r\n"
b'Compilation successful\r\n'
b'Compilation took 00:00:00.0000000\n'
]
>>>
>>> judge(Swift(), b'print("Hello, world!")', [(b'', b'Hello, world!')]) # Swift
[
[
(<Status.AC: 'Accepted'>, (b'Hello, world!\n', b''), 0.2)
],
b''
]
```
## [License](LICENSE)
Licensed under [the **Apache License, Version 2.0**](https://www.apache.org/licenses/LICENSE-2.0)
<a href="https://www.apache.org/foundation/press/kit/#wide"><img src="https://www.apache.org/foundation/press/kit/asf_logo_wide.svg" alt="Wide Apache Software Foundation Logo with Feather.svg" height="32" align="right"></a>
[](https://app.fossa.com/projects/git%2Bgithub.com%2Fwxh06%2Fdockerjudge?ref=badge_large)
نیازمندی
| مقدار | نام |
|---|---|
| >=3.7 | docker |
| >=3.7 | docker[tls] |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.6 | Python |
نحوه نصب
نصب پکیج whl dockerjudge-1.3.1:
pip install dockerjudge-1.3.1.whl
نصب پکیج tar.gz dockerjudge-1.3.1:
pip install dockerjudge-1.3.1.tar.gz