pyLynx 2.0.1b3__py3-none-any.whl

Lynx/__init__.py

@@ -0,0 +1,49 @@
+# Copyright (c) 2023-present FredB-mine
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+import click
+from Lynx.utils.constants import VERSION
+
+
+def print_version(ctx, param, value):
+    if not value or ctx.resilient_parsing:
+        return
+    click.echo(VERSION)
+    ctx.exit()
+
+
+# register CLI group, must be placed before importing submodules
+@click.group()
+@click.option(
+    "--version",
+    is_flag=True,
+    is_eager=True,
+    expose_value=False,
+    callback=print_version,
+    help="Show the version of lynx.",
+)
+def cli():
+    """lynx: Next generation testcase tool set for OI / ACM contests."""
+    pass
+
+
+import Lynx.modules.generate
+import Lynx.modules.compare
+import Lynx.modules.init

Lynx/modules/__init__.py

@@ -0,0 +1 @@
+# just for setuptools to find

Lynx/modules/compare.py

@@ -0,0 +1,32 @@
+import click
+import os
+import Lynx.utils.config as config
+
+from Lynx import cli
+from Lynx.utils.language import cpp
+
+
+@cli.command()
+@click.argument("problem", type=click.Path())
+@click.argument("program1", type=click.File("r"))
+@click.argument("program2", type=click.File("r"), required=False)
+@click.option(
+    "--testcase", type=int, default=0, help="The index of the testcase to compare."
+)
+# checker will be supported in the future when cyaron implements it.
+# @click.option(
+#     "--checker",
+#     is_flag=True,
+#     default=False,
+#     help="Use checker (special judge).",
+# )
+def compare(problem, program1, program2, testcase):
+    """This command compares two programs using a lynx problem description.
+
+    PROBLEM is the lynx problem directory.
+
+    PROGRAM1 is the program to compare with.
+
+    PROGRAM2 is the second program to compare with, it is set to the standard solution to the problem by default.
+    """
+    pass

Lynx/modules/generate.py

@@ -0,0 +1,42 @@
+import click
+import os
+import random
+import Lynx.utils.config as config
+
+from cyaron import *
+from Lynx import cli
+from Lynx.utils.language import cpp
+from Lynx.utils.constants import SUPPORTED_OJ
+
+# Warning: This may cause security risks. We should try to replace it.
+from importlib import import_module
+
+
+@cli.command()
+@click.argument("problem", type=click.Path())
+@click.option(
+    "--oj",
+    type=click.Choice(SUPPORTED_OJ),
+    default="hydro",
+    help="The online judge to upload the problem to, used when packing data.",
+)
+@click.option(
+    "--seed",
+    type=int,
+    required=False,
+    help="The random seed to specify (optional).",
+)
+@click.option(
+    "--no-validate",
+    is_flag=True,
+    default=False,
+    help="Not to validate when generating data.",
+)
+def generate(problem, oj, seed, no_validate):
+    """This command generates testcases of a lynx problem."""
+    # check if the problem directory exists
+    if seed is not None:
+        random.seed(seed)  # Write unit tests for setting seed.
+
+    # maybe you forget to specify --no-validator?
+    pass

Lynx/modules/init.py

@@ -0,0 +1,80 @@
+import click
+import os
+import Lynx.utils.config as config
+
+from Lynx import cli
+from Lynx.utils.log import *
+from Lynx.utils.language import cpp
+from Lynx.utils.constants import CPP_STANDARDS, CHECKERS, VALIDATORS
+
+
+@cli.command()
+@click.argument("problem", type=click.Path())
+@click.option(  # language
+    "--language",
+    default="c++14",
+    help="The language (standard) used when generating data.",
+    type=click.Choice(CPP_STANDARDS),
+)
+@click.option(  # checker
+    "--checker",
+    type=click.Choice(CHECKERS),
+    default="custom",
+    help="Use a checker (special judge). You can specify the checker provided by testlib or use your customized checker by default.",
+)
+@click.option(  # validator
+    "--validator",
+    type=click.Choice(VALIDATORS),
+    default="custom",
+    help="Use a validator. You can also use the validator provided by testlib in a similar way as the checker.",
+)
+@click.option("--testcase", type=int, default=20, help="The number of testcases.")
+@click.option(
+    "--time-limit",
+    type=int,
+    default=1000,
+    help="The time limit of the problem, uses ms as unit.",
+)
+@click.option(
+    "--memory-limit",
+    type=int,
+    default=512,
+    help="The memory limit of the problem, uses MB as unit.",
+)
+# no checker
+@click.option(
+    "--no-checker",
+    is_flag=True,
+    default=False,
+    help="Do not use a checker (special judge).",
+)
+def init(
+    problem,
+    language,
+    checker,
+    validator,
+    testcase,
+    time_limit,
+    memory_limit,
+    no_checker,
+):
+    """This command initializes a lynx problem directory."""
+    # Turn the problem path into an absolute path
+    if not os.path.isabs(problem):
+        problem = os.path.join(os.getcwd(), problem)
+    debug(f"problem route is {problem}")
+    if os.path.exists(problem):
+        error_and_exit(f"Problem directory {problem} already exists.")
+    if language in CPP_STANDARDS:
+        cpp.init_problem(
+            problem,
+            language,
+            checker,
+            validator,
+            testcase,
+            time_limit,
+            memory_limit,
+            no_checker,
+        )
+    else:  # Other languages will be supported in the future
+        assert False  # This should never happen

Lynx/templates/cpp/problem_zh.md

@@ -0,0 +1,3 @@
+Write your problem here!
+
+Lynx follows hydro problem format. You can find the format [here](https://hydro.js.org/docs/user/problem-format.html).

Lynx/templates/cpp/programs/checker.cpp

@@ -0,0 +1,14 @@
+/**
+ * This checker will be compiled into an executive,
+ * and the testcase-tools will provide it with the input
+ * file and the output file in a way that testlib recognizes.
+ *
+ * So you can use the built-in io functions in testlib.h
+ * to write your checker.
+ */
+#include "testlib.h"
+
+int main(int argc, char *argv[]) {
+    registerTestlibCmd(argc, argv);
+    return 0;
+}

Lynx/templates/cpp/programs/std.cpp

@@ -0,0 +1 @@
+// Write your standard solution to the problem here.

Lynx/templates/cpp/programs/validator.cpp

@@ -0,0 +1,17 @@
+/**
+ * This validator will be compiled into an executive,
+ * and the testcase-tools will provide it with the input
+ * file in a way that testlib recognizes.
+ *
+ * So you can use the built-in io functions in testlib.h
+ * to write your validator.
+ *
+ * You can just leave it empty if you don't need to check the output.
+ * Just remember to specify --no-validator when generating in that case.
+ */
+#include "testlib.h"
+
+int main(int argc, char *argv[]) {
+    registerValidation(argc, argv);
+    return 0;
+}

Lynx/templates/cpp/testdata/config.yaml

@@ -0,0 +1,95 @@
+# 题目类型，可以为 default(比对输出，可以含spj), objective(客观题), interactive(交互题)
+type: default
+
+# 全局时空限制（此处的限制优先级低于测试点的限制）
+time: 1s
+memory: 128m
+
+# 输入输出文件名（例：使用 foo.in 和 foo.out），若使用标准 IO 删除此配置项即可
+filename: foo
+
+# 此部分设置当题目类型为 default 时生效
+# 比较器类型，支持的值有 default（直接比对，忽略行末空格和文件末换行）, ccr, cena, hustoj, lemon, qduoj, syzoj, testlib(比较常用)
+checker_type: default
+# 比较器文件（当比较器类型不为 default 时填写）
+# 文件路径（位于压缩包中的路径）
+# 将通过扩展名识别语言，与编译命令处一致。在默认配置下，C++ 扩展名应为 .cc 而非 .cpp
+checker: chk.cc
+
+# 此部分设置当题目类型为interactive时生效
+# 交互器路径（位于压缩包中的路径）
+interactor: interactor.cc
+
+# Extra files 额外文件
+# These files will be copied to the working directory 这些文件将被复制到工作目录。
+# 提示：您无需手动上传 testlib.h。
+user_extra_files:
+  - extra_input.txt
+judge_extra_files:
+  - extra_file.txt
+
+# Test Cases 测试数据列表
+# If neither CASES or SUBTASKS are set(or config.yaml doesn't exist), judge will try to locate them automaticly.
+# 如果 CASES 和 SUBTASKS 都没有设置或 config.yaml 不存在， 系统会自动尝试识别数据点。
+# We support these names for auto mode: 自动识别支持以下命名方式：
+# 1. [name(optional)][number].(in/out/ans)         RegExp: /^([a-zA-Z]*)([0-9]+).in$/
+#   examples:
+#     - c1.in / c1.out
+#     - 1.in / 1.out
+#     - c1.in / c1.ans
+# 2. input[number].txt / output[number].txt        RegExp: /^(input)([0-9]+).txt$/
+#   - example: input1.txt / input2.txt
+#
+# The CASES option has higher priority than the SUBTASKS option!
+# 在有 CASES 设置项时，不会读取 SUBTASKS 设置项！
+#
+# The CASES option has been deprecated in the new version, please use the more personalized SUBTASKS!
+# CASES 已于新版本中被废弃，请使用个性化程度更高的SUBTASKS！
+# score: 50     # 单个测试点分数
+# time: 1s      # 时间限制
+# memory: 256m  # 内存限制
+# cases:
+#   - input: abc.in
+#     output: def.out
+#   - input: ghi.in
+#     output: jkl.out
+# 或使用Subtask项：
+subtasks:
+  - score: 30
+    type: min # 可选 min/max/sum，分别表示分数取所有测试点最小值、所有测试点最大值、所有测试点之和
+    time: 1s
+    memory: 64m
+    cases:
+      - time: 0.5s
+        memory: 32m # 可对单个测试点单独设置时间限制和内存限制
+        input: a.in
+        output: a.out
+      - input: b.in
+        output: b.out
+  - score: 70
+    time: 0.5s
+    memory: 32m
+    if: [0] # 可选，传入数组，表示仅在subtask0通过时此subtask才计分
+    cases:
+      - input: c.in
+        output: c.out
+      - input: d.in
+        output: d.out
+
+# 提交语言限制
+# 列举出所有本题允许使用的语言对应的代码（需要和评测机 lang.yaml 内的语言代码相同）
+# 使用语言ID而非名称！对于有子类的选项，请详细至子分类！
+langs:
+  - c
+  - cc
+  - cc.cc11o2
+  - pas
+
+# 时间内存倍率
+# 对某语言设置时间或内存倍率（需要和评测机 lang.yaml 内的语言代码相同）
+# 部分语言默认已存在倍率，请前往控制面板中查看！
+# 使用语言ID而非名称！对于有子类的选项，请详细至子分类！
+time_limit_rate:
+  py.py3: 2
+memory_limit_rate:
+  java: 1.5

Lynx/templates/generator.py

@@ -0,0 +1,9 @@
+from cyaron import *
+from Lynx.utils.config import SubtaskManager
+
+
+class Subtask(SubtaskManager):
+    def __init__(self): ...
+
+
+def generate(testcase_id: int, io: IO): ...

Lynx/utils/__init__.py

@@ -0,0 +1 @@
+# just for setuptools to find

Lynx/utils/config.py

@@ -0,0 +1,20 @@
+import yaml
+import os
+
+
+# Used to manage the range of variables more easily
+# It will be replaced by some features of cyaron in the future.
+class SubtaskManager: ...
+
+
+class CppProblemConfig:
+    def __init__(self, problem_path: str):
+        self.problem_path = problem_path
+        self.problem_config_path = os.path.join(problem_path, "problem.yaml")
+        self.testdata_config_path = os.path.join(
+            problem_path, "testdata", "config.yaml"
+        )
+
+    def init_configs(
+        self, standard, testcase, time_limit, memory_limit, no_checker
+    ): ...

Lynx/utils/constants.py

@@ -0,0 +1,52 @@
+import os
+
+VERSION = "2.0.1b3"
+
+# Some directories
+LYNX_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+TESTLIB_ROOT = os.path.join(LYNX_ROOT, "..", "testlib")
+TEMPLATES_ROOT = os.path.join(LYNX_ROOT, "templates")
+CPP_TEMPLATES_ROOT = os.path.join(TEMPLATES_ROOT, "cpp")
+
+# Standards
+CPP_STANDARDS = ["c++98", "c++03", "c++11", "c++14", "c++17"]
+
+# Testlib checkers and validators
+CHECKERS = [
+    "custom",
+    "nyesno",
+    "ncmp",
+    "casencmp",
+    "lcmp",
+    "rncmp",
+    "yesno",
+    "dcmp",
+    "hcmp",
+    "pointscmp",
+    "rcmp",
+    "fcmp",
+    "rcmp9",
+    "rcmp4",
+    "wcmp",
+    "rcmp6",
+    ".gitignore",
+    "casewcmp",
+    "acmp",
+    "icmp",
+    "pointsinfo",
+    "uncmp",
+    "caseicmp",
+]
+VALIDATORS = [
+    "custom",
+    "validate-using-testset-and-group",
+    "undirected-graph-validator",
+    "bipartite-graph-validator",
+    "nval",
+    "undirected-tree-validator",
+    "sval",
+    "ival",
+    "case-nval",
+]
+
+SUPPORTED_OJ = ["luogu", "hydro", "qdu"]

Lynx/utils/language/__init__.py

@@ -0,0 +1 @@
+# just for setuptools to find.

Lynx/utils/language/cpp.py

@@ -0,0 +1,51 @@
+import os
+import shutil
+
+from Lynx.utils.log import *
+from Lynx.utils.constants import *
+from Lynx.utils.config import CppProblemConfig
+
+"""The structure of a problem directory is as follows:
+.
+├── {problem_path}
+│   ├── problem.yaml
+│   ├── problem_zh.md
+│   ├── testdata
+│   │   ├── config.yaml
+│   │   ├── a1.in
+│   │   └── a1.out
+│   └── additional_file
+│       ├── a.png
+│       └── b.pdf
+└── ...
+"""
+
+
+def init_problem(
+    problem_path: str,
+    standard: str,
+    checker: str,
+    validator: str,
+    testcase: int,
+    time_limit: int,
+    memory_limit: int,
+    no_checker: bool,
+):
+    shutil.copytree(CPP_TEMPLATES_ROOT, problem_path)
+    shutil.copyfile(
+        os.path.join(TEMPLATES_ROOT, "generator.py"),
+        os.path.join(problem_path, "programs", "generator.py"),
+    )
+    os.remove(os.path.join(problem_path, "additional_file", ".gitkeep"))
+    if checker != "custom":
+        shutil.copy2(
+            os.path.join(TESTLIB_ROOT, "checkers", f"{checker}.cpp"),
+            os.path.join(problem_path, "programs", "checker.cpp"),
+        )
+    if validator != "custom":
+        shutil.copy2(
+            os.path.join(TESTLIB_ROOT, "validators", f"{validator}.cpp"),
+            os.path.join(problem_path, "programs", "validator.cpp"),
+        )
+    config = CppProblemConfig(problem_path)
+    config.init_configs(standard, testcase, time_limit, memory_limit, no_checker)

Lynx/utils/log.py

@@ -0,0 +1,17 @@
+import click
+
+
+def error(message: str) -> None:
+    """Print an error message."""
+    click.echo(click.style(f"ERROR: {message}", fg="red"))
+
+
+def error_and_exit(message: str, code: int = 1) -> None:
+    """Print an error message and exit."""
+    error(message)
+    raise click.exceptions.Exit(code)
+
+
+def debug(message: str) -> None:
+    """Print a debug message."""
+    click.echo(click.style(f"DEBUG: {message}", fg="blue"))