pyLynx 2.0.1b2__tar.gz

pylynx-2.0.1b2/LICENSE

@@ -0,0 +1,232 @@
+The MIT License (MIT)
+
+Copyright (c) 2023 Chester Alfred
+
+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.
+
+
+testlib.h
+
+The MIT License (MIT)
+
+Copyright (c) 2015 Mike Mirzayanov
+
+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.
+
+
+python-fire
+
+Copyright 2017 Google Inc. All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+
+cyaron
+
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

pylynx-2.0.1b2/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

pylynx-2.0.1b2/Lynx/modules/__init__.py

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

pylynx-2.0.1b2/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

pylynx-2.0.1b2/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

pylynx-2.0.1b2/Lynx/modules/init.py

@@ -0,0 +1,57 @@
+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 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 just giving a flag.",
+)
+@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.",
+)
+def init(problem, language, checker, validator, testcase, time_limit, memory_limit):
+    """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
+        )
+    else:  # Other languages will be supported in the future
+        assert False  # This should never happen

pylynx-2.0.1b2/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).

pylynx-2.0.1b2/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;
+}

pylynx-2.0.1b2/Lynx/templates/cpp/programs/std.cpp

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

pylynx-2.0.1b2/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;
+}

pylynx-2.0.1b2/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

pylynx-2.0.1b2/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): ...

pylynx-2.0.1b2/Lynx/utils/__init__.py

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

pylynx-2.0.1b2/Lynx/utils/config.py

@@ -0,0 +1,18 @@
+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): ...

pylynx-2.0.1b2/Lynx/utils/constants.py

@@ -0,0 +1,51 @@
+import os
+
+VERSION = "2.0.1b2"
+
+# Some directories
+LYNX_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+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"]

pylynx-2.0.1b2/Lynx/utils/language/__init__.py

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