numberlink 0.1.0__py3-none-any.whl

numberlink/__init__.py

@@ -0,0 +1,37 @@
+"""NumberLink Environment Package for Reinforcement Learning, built on Gymnasium.
+
+The package exposes configuration dataclasses, environment classes, and the ``LEVELS`` mapping of built-in levels.
+Import these symbols for your use or to register the environment using :func:`register_numberlink_v0`.
+
+By default the package does not automatically register Gymnasium ids on import. Library consumers should prefer
+explicit registration via ``numberlink.register_numberlink_v0()``. When installed from PyPI the package also
+exposes packaging entry-points (``project.entry-points."gymnasium.envs"``) so Gymnasium can auto-discover and
+load the environment without an explicit registration call. See the project ``pyproject.toml`` for the
+``gymnasium.envs`` entry-point names.
+"""
+
+from __future__ import annotations
+
+from .config import GeneratorConfig, RenderConfig, RewardConfig, VariantConfig
+from .env import NumberLinkRGBEnv
+from .levels import LEVELS
+from .registration import register_numberlink_v0
+from .vector_env import NumberLinkRGBVectorEnv
+from .viewer import NumberLinkViewer
+
+__version__ = "0.1.0"
+__author__ = "Misagh Soltani"
+
+__all__: list[str] = [
+    "__version__",
+    "__author__",
+    "NumberLinkRGBEnv",
+    "register_numberlink_v0",
+    "GeneratorConfig",
+    "VariantConfig",
+    "RewardConfig",
+    "RenderConfig",
+    "LEVELS",
+    "NumberLinkViewer",
+    "NumberLinkRGBVectorEnv",
+]

numberlink/__main__.py

@@ -0,0 +1,19 @@
+"""Module entry for the package command-line interface.
+
+Running ``python -m numberlink`` invokes the CLI implemented in :mod:`numberlink.cli`.
+"""
+
+from __future__ import annotations
+
+import sys
+
+from .cli import main as cli_main
+
+
+def run() -> None:
+    """Entrypoint used by the ``-m`` switch."""
+    raise SystemExit(cli_main(sys.argv[1:]))
+
+
+if __name__ == "__main__":
+    run()

numberlink/assets/levels/5x5_ha_4c_016.sol.json

@@ -0,0 +1 @@
+[[[1,3],[1,2],[2,2]],[[0,0],[0,1],[0,2],[0,3],[0,4]],[[1,4],[2,4],[3,4],[4,4],[4,3],[4,2],[4,1],[4,0],[3,0],[2,0]],[[1,0],[1,1],[2,1],[3,1],[3,2],[3,3],[2,3]]]

numberlink/assets/levels/5x5_ha_4c_016.txt

@@ -0,0 +1,5 @@
+B...B
+D..AC
+C.AD.
+.....
+.....

numberlink/assets/levels/5x5_ha_4c_026.sol.json

@@ -0,0 +1 @@
+[[[0,0],[0,1],[1,1]],[[0,2],[0,3],[0,4],[1,4],[2,4],[3,4],[4,4],[4,3],[4,2],[4,1]],[[1,2],[2,2],[2,1],[2,0],[1,0]],[[4,0],[3,0],[3,1],[3,2],[3,3],[2,3],[1,3]]]

numberlink/assets/levels/5x5_ha_4c_026.txt

@@ -0,0 +1,5 @@
+A.B..
+CACD.
+.....
+.....
+DB...

numberlink/assets/levels/5x5_ra_4c_011.sol.json

@@ -0,0 +1 @@
+[[[3,1],[2,1],[1,1],[0,1]],[[3,0],[4,0],[4,1],[4,2]],[[1,4],[2,4],[3,4],[4,4],[4,3]],[[0,4],[0,3],[1,3],[2,3],[2,2],[1,2]]]

numberlink/assets/levels/5x5_ra_4c_011.txt

@@ -0,0 +1,5 @@
+.A..D
+..D.C
+.....
+BA...
+..BC.

numberlink/assets/levels/5x5_ra_4c_021.sol.json

@@ -0,0 +1 @@
+[[[1,0],[2,0],[3,0],[4,0]],[[3,1],[3,2],[3,3],[4,3],[4,4]],[[2,4],[2,3],[2,2],[2,1]],[[0,0],[0,1],[0,2],[0,3]]]

numberlink/assets/levels/5x5_ra_4c_021.txt

@@ -0,0 +1,5 @@
+D..D.
+A....
+.C..C
+.B...
+A...B

numberlink/assets/levels/6x6_ha_5c_012.sol.json

@@ -0,0 +1 @@
+[[[3,2],[2,2],[2,3]],[[5,5],[5,4],[5,3],[5,2],[5,1],[5,0],[4,0],[3,0],[2,0],[1,0],[0,0],[0,1]],[[1,2],[1,3],[1,4],[2,4],[3,4],[3,3]],[[4,1],[4,2],[4,3],[4,4],[4,5],[3,5],[2,5],[1,5],[0,5],[0,4],[0,3],[0,2]],[[1,1],[2,1],[3,1]]]

numberlink/assets/levels/6x6_ha_5c_012.txt

@@ -0,0 +1,6 @@
+.BD...
+.EC...
+...A..
+.EAC..
+.D....
+.....B

numberlink/assets/levels/6x6_ha_5c_022.sol.json

@@ -0,0 +1 @@
+[[[4,1],[3,1],[3,0],[2,0],[1,0],[0,0],[0,1],[0,2],[0,3],[0,4],[0,5],[1,5],[2,5],[3,5],[4,5],[5,5],[5,4],[5,3],[4,3]],[[4,4],[3,4],[3,3],[3,2],[2,2]],[[2,1],[1,1],[1,2],[1,3]],[[4,2],[5,2],[5,1],[5,0],[4,0]],[[1,4],[2,4],[2,3]]]

numberlink/assets/levels/6x6_ha_5c_022.txt

@@ -0,0 +1,6 @@
+......
+...CE.
+.CBE..
+......
+DADAB.
+......

numberlink/assets/levels/6x6_ra_5c_017.sol.json

@@ -0,0 +1 @@
+[[[2,5],[1,5],[1,4],[1,3],[0,3]],[[0,2],[0,1],[1,1],[2,1]],[[4,3],[3,3],[3,2],[3,1]],[[3,0],[4,0],[4,1],[5,1]],[[5,3],[5,4],[4,4],[4,5],[3,5],[2,5],[2,4]]]

numberlink/assets/levels/6x6_ra_5c_017.txt

@@ -0,0 +1,6 @@
+..BA..
+......
+.B..EA
+DC....
+...C..
+.D.E..

numberlink/assets/levels/6x6_ra_5c_027.sol.json

@@ -0,0 +1 @@
+[[[0,0],[1,0],[2,0],[3,0],[3,1],[2,1],[2,2]],[[3,0],[4,0],[4,1],[4,2],[5,2],[5,1]],[[2,4],[1,4],[1,3],[1,2],[1,1]],[[0,5],[0,4],[0,3],[0,2]],[[5,3],[4,3],[3,3],[3,4]]]

numberlink/assets/levels/6x6_ra_5c_027.txt

@@ -0,0 +1,6 @@
+A.D..D
+.C....
+..A.C.
+B...E.
+......
+.B.E..

numberlink/assets/levels/7x7_ha_6c_018.sol.json

@@ -0,0 +1 @@
+[[[1,5],[0,5],[0,6]],[[2,3],[1,3],[1,2],[1,1],[2,1],[3,1],[4,1],[5,1],[5,2],[5,3],[5,4]],[[3,6],[4,6],[4,5],[5,5]],[[5,6],[6,6],[6,5],[6,4],[6,3],[6,2],[6,1],[6,0],[5,0],[4,0],[3,0],[2,0],[1,0],[0,0],[0,1],[0,2],[0,3],[0,4],[1,4],[2,4],[3,4],[3,3],[3,2],[2,2]],[[1,6],[2,6],[2,5],[3,5]],[[4,4],[4,3],[4,2]]]

numberlink/assets/levels/7x7_ha_6c_018.txt

@@ -0,0 +1,7 @@
+......A
+.....AE
+..DB...
+.....EC
+..F.F..
+....BCD
+.......

numberlink/assets/levels/7x7_ha_6c_028.sol.json

@@ -0,0 +1 @@
+[[[2,3],[3,3],[3,4]],[[6,2],[5,2],[5,3],[5,4],[5,5],[4,5]],[[2,4],[2,5],[3,5]],[[6,1],[5,1],[4,1],[3,1],[2,1],[1,1],[1,2],[1,3],[1,4],[1,5],[1,6],[2,6],[3,6],[4,6],[5,6],[6,6],[6,5],[6,4],[6,3]],[[0,6],[0,5],[0,4],[0,3],[0,2],[0,1],[0,0],[1,0],[2,0],[3,0],[4,0],[5,0],[6,0]],[[4,4],[4,3],[4,2],[3,2],[2,2]]]

numberlink/assets/levels/7x7_ha_6c_028.txt

@@ -0,0 +1,7 @@
+......E
+.......
+..FAC..
+....AC.
+....FB.
+.......
+EDBD...

numberlink/assets/levels/7x7_ra_6c_013.sol.json

@@ -0,0 +1 @@
+[[[2,5],[3,5],[3,6],[4,6]],[[0,6],[0,5],[1,5],[1,6],[2,6],[2,5],[2,4]],[[1,2],[0,2],[0,3],[0,4]],[[6,0],[6,1],[6,2],[6,3],[5,3]],[[0,0],[0,1],[1,1],[1,2],[2,2],[3,2]],[[4,1],[3,1],[2,1],[2,0]]]

numberlink/assets/levels/7x7_ra_6c_013.txt

@@ -0,0 +1,7 @@
+E...C.B
+..C....
+F...BA.
+..E....
+.F....A
+...D...
+D......

numberlink/assets/levels/7x7_ra_6c_023.sol.json

@@ -0,0 +1 @@
+[[[5,4],[6,4],[6,5],[6,6]],[[3,6],[3,5],[4,5],[5,5]],[[4,3],[3,3],[3,4],[2,4]],[[6,1],[6,2],[6,3],[5,3]],[[4,2],[5,2],[5,1],[5,0]],[[5,6],[4,6],[3,6],[2,6]]]

numberlink/assets/levels/7x7_ra_6c_023.txt

@@ -0,0 +1,7 @@
+.......
+.......
+....C.F
+......B
+..EC...
+E..DABF
+.D....A

numberlink/assets/levels/8x8_ha_6c_014.sol.json

@@ -0,0 +1 @@
+[[[7,5],[6,5],[6,6],[5,6],[4,6],[3,6],[2,6],[1,6],[1,5],[1,4],[1,3],[1,2]],[[1,1],[2,1],[3,1],[4,1],[5,1],[6,1],[6,2],[6,3],[6,4],[5,4],[5,5],[4,5],[3,5]],[[7,4],[7,3],[7,2],[7,1],[7,0],[6,0],[5,0],[4,0],[3,0],[2,0],[1,0],[0,0],[0,1],[0,2],[0,3],[0,4],[0,5],[0,6],[0,7],[1,7],[2,7],[3,7],[4,7],[5,7],[6,7],[7,7],[7,6]],[[2,5],[2,4],[3,4],[4,4],[4,3]],[[5,3],[5,2],[4,2],[3,2]],[[2,2],[2,3],[3,3]]]

numberlink/assets/levels/8x8_ha_6c_014.txt

@@ -0,0 +1,8 @@
+........
+.BA.....
+..F..D..
+..EF.B..
+...D....
+...E....
+........
+....CAC.

numberlink/assets/levels/8x8_ha_6c_024.sol.json

@@ -0,0 +1 @@
+[[[0,6],[0,5],[0,4],[0,3],[0,2],[0,1],[1,1],[2,1],[3,1],[4,1],[5,1],[6,1],[6,2],[6,3],[6,4],[6,5],[6,6],[5,6],[4,6],[3,6],[2,6]],[[1,6],[1,5],[2,5],[3,5],[4,5],[5,5],[5,4],[5,3],[5,2],[4,2]],[[4,3],[4,4],[3,4]],[[0,0],[1,0],[2,0],[3,0],[4,0],[5,0],[6,0],[7,0],[7,1],[7,2],[7,3],[7,4],[7,5],[7,6],[7,7],[6,7],[5,7],[4,7],[3,7],[2,7],[1,7],[0,7]],[[1,4],[2,4],[2,3]],[[3,3],[3,2],[2,2],[1,2],[1,3]]]

numberlink/assets/levels/8x8_ha_6c_024.txt

@@ -0,0 +1,8 @@
+D.....AD
+...FE.B.
+...E..A.
+...FC...
+..BC....
+........
+........
+........

numberlink/assets/levels/8x8_ra_6c_019.sol.json

@@ -0,0 +1 @@
+[[[3,7],[3,6],[2,6],[1,6],[1,7],[0,7]],[[7,0],[6,0],[5,0],[5,1]],[[7,6],[6,6],[6,7],[5,7],[5,6],[5,5]],[[7,7],[7,6],[7,5],[6,5]],[[4,2],[3,2],[3,1],[3,0]],[[2,2],[2,3],[3,3],[4,3],[4,4],[3,4]]]

numberlink/assets/levels/8x8_ra_6c_019.txt

@@ -0,0 +1,8 @@
+.......A
+........
+..F.....
+E...F..A
+..E.....
+.B...C..
+.....D..
+B.....CD

numberlink/assets/levels/8x8_ra_6c_029.sol.json

@@ -0,0 +1 @@
+[[[5,1],[4,1],[3,1],[3,2],[4,2],[4,3],[3,3],[3,4]],[[7,7],[6,7],[5,7],[5,6]],[[0,0],[0,1],[1,1],[2,1]],[[0,6],[1,6],[2,6],[2,7]],[[4,5],[3,5],[3,6],[4,6],[4,7],[3,7]],[[7,3],[7,4],[6,4],[5,4]]]

numberlink/assets/levels/8x8_ra_6c_029.txt

@@ -0,0 +1,8 @@
+C.....D.
+........
+.C.....D
+....A..E
+.....E..
+.A..F.B.
+........
+...F...B

numberlink/assets/levels/9x9_ha_7c_020.sol.json

@@ -0,0 +1 @@
+[[[3,5],[3,4],[4,4]],[[0,1],[0,0],[1,0],[2,0],[3,0],[4,0],[5,0],[6,0],[7,0],[8,0],[8,1],[8,2],[8,3],[8,4],[8,5],[8,6],[7,6]],[[0,2],[0,3],[0,4],[0,5],[0,6],[0,7],[0,8],[1,8],[2,8],[3,8],[4,8],[5,8],[6,8],[7,8],[8,8]],[[2,6],[2,5],[2,4],[2,3],[3,3],[4,3],[5,3],[5,4],[5,5],[4,5]],[[8,7],[7,7],[6,7],[5,7],[4,7],[3,7],[2,7],[1,7],[1,6],[1,5],[1,4],[1,3],[1,2],[1,1]],[[3,2],[4,2],[5,2],[6,2],[6,3],[6,4],[6,5],[6,6],[5,6],[4,6],[3,6]],[[7,5],[7,4],[7,3],[7,2],[7,1],[6,1],[5,1],[4,1],[3,1],[2,1],[2,2]]]

numberlink/assets/levels/9x9_ha_7c_020.txt

@@ -0,0 +1,9 @@
+.BC......
+.E.......
+..G...D..
+..F..AF..
+....AD...
+.........
+.........
+.....GB..
+.......EC

numberlink/assets/levels/9x9_ha_7c_030.sol.json

@@ -0,0 +1 @@
+[[[5,3],[4,3],[4,2],[3,2]],[[7,7],[6,7],[5,7],[5,8],[4,8]],[[3,8],[2,8],[2,7],[2,6],[2,5],[2,4],[3,4],[4,4],[5,4],[6,4],[6,3],[6,2],[5,2]],[[4,7],[4,6],[5,6],[6,6],[7,6],[8,6],[8,5],[8,4],[8,3],[8,2],[8,1],[8,0],[7,0],[6,0],[5,0],[4,0],[3,0],[2,0],[1,0],[0,0],[0,1],[0,2],[0,3],[0,4],[0,5],[0,6],[0,7]],[[3,3],[2,3],[2,2]],[[0,8],[1,8],[1,7],[1,6],[1,5],[1,4],[1,3],[1,2],[1,1],[2,1],[3,1],[4,1],[5,1],[6,1],[7,1],[7,2],[7,3],[7,4],[7,5],[6,5],[5,5],[4,5],[3,5],[3,6],[3,7]],[[6,8],[7,8],[8,8],[8,7]]]

numberlink/assets/levels/9x9_ha_7c_030.txt

@@ -0,0 +1,9 @@
+.......DF
+.........
+..E......
+..AE...FC
+.......DB
+..CA.....
+........G
+.......B.
+.......G.

numberlink/assets/levels/9x9_ra_7c_015.sol.json

@@ -0,0 +1 @@
+[[[5,0],[4,0],[3,0],[3,1],[2,1],[1,1],[1,2]],[[6,1],[5,1],[4,1],[4,2],[3,2],[2,2]],[[7,3],[7,2],[6,2],[6,1],[6,0],[7,0],[8,0]],[[5,5],[5,4],[5,3],[5,2]],[[0,7],[0,8],[1,8],[2,8],[3,8],[3,7],[4,7],[4,8]],[[8,7],[7,7],[6,7],[6,6],[6,5]],[[6,2],[6,3],[6,4],[7,4],[7,5]]]

numberlink/assets/levels/9x9_ra_7c_015.txt

@@ -0,0 +1,9 @@
+.......E.
+..A......
+..B......
+.........
+........E
+A.D..D...
+.BG..F...
+...C.G...
+C......F.

numberlink/assets/levels/9x9_ra_7c_025.sol.json

@@ -0,0 +1 @@
+[[[4,4],[4,3],[4,2],[4,1]],[[8,2],[7,2],[7,1],[7,0]],[[1,4],[1,3],[1,2],[2,2],[2,1],[2,0]],[[6,2],[5,2],[5,1],[5,0]],[[1,6],[1,7],[0,7],[0,6],[0,5],[0,4],[0,3]],[[5,8],[6,8],[6,7],[6,6]],[[1,3],[2,3],[3,3],[3,4],[3,5],[4,5],[4,6],[4,7]]]

numberlink/assets/levels/9x9_ra_7c_025.txt

@@ -0,0 +1,9 @@
+...E.....
+...GC.E..
+C........
+.........
+.A..A..G.
+D.......F
+..D...F..
+B........
+..B......