Metadata-Version: 2.1
Name: dockerjudge
Version: 1.2.5
Summary: A Docker Based Online Judge Engine
Home-page: https://github.com/wxh06/dockerjudge
Author: 汪心禾
Author-email: wangxinhe06@gmail.com
License: Apache-2.0
Download-URL: https://pypi.org/simple/dockerjudge/
Project-URL: Bug Tracker, https://github.com/wxh06/dockerjudge/issues
Project-URL: Documentation, https://dockerjudge.readthedocs.io
Project-URL: Release notes, https://github.com/wxh06/dockerjudge/releases
Project-URL: Source Code, https://github.com/wxh06/dockerjudge/tree/master
Description: <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 &lt;3
          </a>
        </p>
        
        # dockerjudge
        [![Maintainability](https://api.codeclimate.com/v1/badges/dfe666a2140cd3390e56/maintainability)](https://codeclimate.com/github/wxh06/dockerjudge/maintainability)
        [![Python package](https://github.com/wxh06/dockerjudge/workflows/Python%20package/badge.svg)](https://github.com/wxh06/dockerjudge/actions?query=workflow%3A%22Python+package%22)
        [![Upload Python Package](https://github.com/wxh06/dockerjudge/workflows/Upload%20Python%20Package/badge.svg)](https://github.com/wxh06/dockerjudge/actions?query=workflow%3A%22Upload+Python+Package%22)
        [![Transifex](https://github.com/wxh06/dockerjudge/workflows/Transifex/badge.svg)](https://www.transifex.com/piterator/dockerjudge/)
        [![Build Status](https://dev.azure.com/wangxinhe/wangxinhe/_apis/build/status/wxh06.dockerjudge)](https://dev.azure.com/wangxinhe/wangxinhe/_build/latest?definitionId=1)
        [![Azure DevOps tests](https://img.shields.io/azure-devops/tests/wangxinhe/wangxinhe/1)](https://dev.azure.com/wangxinhe/wangxinhe/_test/analytics?definitionId=1)
        [![Build Status](https://travis-ci.com/wxh06/dockerjudge.svg)](https://travis-ci.com/wxh06/dockerjudge)
        [![CodeCov](https://codecov.io/gh/wxh06/dockerjudge/graph/badge.svg)](https://codecov.io/gh/wxh06/dockerjudge)
        [![Documentation Status](https://readthedocs.org/projects/dockerjudge/badge/)](https://dockerjudge.readthedocs.io/en/latest/)
        [![Python Version](https://img.shields.io/pypi/pyversions/dockerjudge.svg)](https://www.python.org/downloads/)
        [![GitHub pre-release](https://img.shields.io/github/release-pre/wxh06/dockerjudge.svg)](https://github.com/wxh06/dockerjudge/releases)
        [![PyPI](https://img.shields.io/pypi/v/dockerjudge.svg)](https://pypi.org/project/dockerjudge/#history)
        [![Wheel](https://img.shields.io/pypi/wheel/dockerjudge.svg)](https://pypi.org/project/dockerjudge/#files)
        [![License](https://img.shields.io/github/license/wxh06/dockerjudge.svg)](LICENSE)
        [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fwxh06%2Fdockerjudge.svg?type=shield)](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>
        
        
        [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fwxh06%2Fdockerjudge.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fwxh06%2Fdockerjudge?ref=badge_large)
        
Keywords: docker,online-judge,online-judge-engine
Platform: UNKNOWN
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: tls
