Implement companion modifier (#89)

Author: caizixian

docs/src/changelog.md

@@ -12,6 +12,12 @@
 
 ### Security
 
+## [`v0.3.2` (2022-10-12)](https://github.com/anupli/running-ng/releases/tag/v0.3.2)
+### Added
+
+#### Modifiers
+- `Companion`
+
 ## [`v0.3.1` (2022-09-18)](https://github.com/anupli/running-ng/releases/tag/v0.3.1)
 ### Added
 #### Base Syntax

docs/src/references/modifier.md

@@ -72,3 +72,12 @@ Multiple arguments are space separated.
 ### Description
 Specify a wrapper.
 If a wrapper also exist for the benchmark suite you use, this wrapper will follow that.
+
+## `Companion` (preview ⚠️)
+### Keys
+`val`: a single string with [shell-like syntax](https://docs.python.org/3/library/shlex.html#shlex.split).
+Multiple arguments are space separated.
+
+### Description
+Specify a companion program.
+If a companion program also exist for the benchmark suite you use, this companion program will follow that.

src/running/__version__.py

@@ -1,2 +1,2 @@
-VERSION = (0, 3, 1)
+VERSION = (0, 3, 2)
 __VERSION__ = '.'.join(map(str, VERSION))

src/running/benchmark.py

@@ -63,6 +63,8 @@ def attach_modifiers(self, modifiers: List[Modifier]) -> Any:
                     continue
             elif type(m) == Wrapper:
                 b.wrapper.extend(m.val)
+            elif type(m) == Companion:
+                b.companion.extend(m.val)
             elif type(m) == EnvVar:
                 b.env_args[m.var] = m.val
             elif type(m) == ModifierSet:

src/running/modifier.py

@@ -133,3 +133,12 @@ def __init__(self, value_opts=None, **kwargs):
 
     def __str__(self) -> str:
         return "{} JSArg {}".format(super().__str__(), self.val)
+
+@register(Modifier)
+class Companion(Modifier):
+    def __init__(self, value_opts=None, **kwargs):
+        super().__init__(value_opts, **kwargs)
+        self.val = split_quoted(self._kwargs["val"])
+
+    def __str__(self) -> str:
+        return "{} Companion {}".format(super().__str__(), self.val)