kaggle-environments 1.17.12__py2.py3-none-any.whl → 1.18.0__py2.py3-none-any.whl

kaggle_environments/main.py

@@ -15,7 +15,7 @@
 import argparse
 import json
 import traceback
-from typing import *
+from typing import Optional
 from . import errors, utils
 from .agent import Agent
 from .core import environments, evaluate, make
@@ -27,12 +27,9 @@ parser.add_argument(
     choices=["list", "evaluate", "run", "step", "load", "act", "dispose", "http-server"],
     help="List environments. Evaluate many episodes. Run a single episode. Step the environment. Load the environment. Start http server.",
 )
-parser.add_argument("--environment", type=str,
-                    help="Environment to run against.")
+parser.add_argument("--environment", type=str, help="Environment to run against.")
 parser.add_argument("--debug", type=bool, help="Print debug statements.")
-parser.add_argument(
-    "--agents", type=str, nargs="*", help="Agent(s) to run with the environment."
-)
+parser.add_argument("--agents", type=str, nargs="*", help="Agent(s) to run with the environment.")
 parser.add_argument(
     "--configuration",
     type=json.loads,
@@ -58,9 +55,7 @@ parser.add_argument(
     type=json.loads,
     help="Single agent state used for evaluation (default={}).",
 )
-parser.add_argument(
-    "--episodes", type=int, help="Number of episodes to evaluate (default=1)"
-)
+parser.add_argument("--episodes", type=int, help="Number of episodes to evaluate (default=1)")
 parser.add_argument(
     "--render",
     type=json.loads,
@@ -71,28 +66,21 @@ parser.add_argument(
     type=str,
     help="Shortcut to the --render {mode=''} argument (default json).",
 )
-parser.add_argument(
-    "--port", type=int, help="http-server Port (default=8000)."
-)
-parser.add_argument(
-    "--host", type=str, help="http-server Host (default=127.0.0.1)."
-)
-parser.add_argument(
-    "--in", type=str, help="Episode replay file to load. Only works when the action is load."
-)
+parser.add_argument("--port", type=int, help="http-server Port (default=8000).")
+parser.add_argument("--host", type=str, help="http-server Host (default=127.0.0.1).")
+parser.add_argument("--in", type=str, help="Episode replay file to load. Only works when the action is load.")
 parser.add_argument(
     "--out", type=str, help="Output file to write the results of the episode. Does nothing in http-server mode."
 )
 parser.add_argument(
-    "--log", type=str, help="Agent log file to write the std out, resource, and step timing for each agent. Also used to load logs from a file with the load action."
+    "--log",
+    type=str,
+    help="Agent log file to write the std out, resource, and step timing for each agent. Also used to load logs from a file with the load action.",
 )
 
 
 def render(args, env):
-    mode = \
-        args.display \
-        if args.display is not None \
-        else utils.get(args.render, str, "json", path=["mode"])
+    mode = args.display if args.display is not None else utils.get(args.render, str, "json", path=["mode"])
 
     if mode == "human" or mode == "ansi" or mode == "txt":
         args.render["mode"] = "ansi"
@@ -111,11 +99,7 @@ def action_list(args):
 
 
 def action_evaluate(args):
-    return json.dumps(
-        evaluate(
-            args.environment, args.agents, args.configuration, args.steps, args.episodes
-        )
-    )
+    return json.dumps(evaluate(args.environment, args.agents, args.configuration, args.steps, args.episodes))
 
 
 cached_agent = None
@@ -183,7 +167,9 @@ def action_load(args):
     if args.in_path is not None:
         with open(args.in_path, mode="r") as replay_file:
             json_args = json.load(replay_file)
-        env = make(json_args["name"], json_args["configuration"], json_args["info"], json_args["steps"], args.logs, args.debug)
+        env = make(
+            json_args["name"], json_args["configuration"], json_args["info"], json_args["steps"], args.logs, args.debug
+        )
     else:
         env = make(args.environment, args.configuration, args.info, args.steps, args.logs, args.debug)
     return render(args, env)
@@ -229,7 +215,7 @@ def parse_args(args):
         }
     )
 
-  
+
 def action_handler(args):
     try:
         if args.action == "list":
@@ -269,21 +255,20 @@ def action_http(args):
         log_path = args.log_path
 
     # Setup logging to console for Flask
-    dictConfig({
-        'version': 1,
-        'formatters': {'default': {
-            'format': '%(levelname)s: %(message)s',
-        }},
-        'handlers': {'wsgi': {
-            'class': 'logging.StreamHandler',
-            'stream': 'ext://sys.stdout',
-            'formatter': 'default'
-        }},
-        'root': {
-            'level': 'INFO',
-            'handlers': ['wsgi']
+    dictConfig(
+        {
+            "version": 1,
+            "formatters": {
+                "default": {
+                    "format": "%(levelname)s: %(message)s",
+                }
+            },
+            "handlers": {
+                "wsgi": {"class": "logging.StreamHandler", "stream": "ext://sys.stdout", "formatter": "default"}
+            },
+            "root": {"level": "INFO", "handlers": ["wsgi"]},
         }
-    })
+    )
 
     app = Flask(__name__, static_url_path="", static_folder="")
     app.route("/", methods=["GET", "POST"])(lambda: http_request(request))

kaggle_environments/static/player.html

@@ -124,44 +124,84 @@
 
       const Renderer = styled((props) => {
         const context = useContext(Context);
-        const { animate, debug, playing, renderer, speed } = context;
-        const ref = preact.createRef();
-
-        useEffect(async () => {
-          if (!ref.current) return;
-          const renderFrame = async (start, step, lastFrame) => {
-            if (step !== context.step) return;
-            if (lastFrame === 1) {
+        const { animate, debug, playing, renderer, speed, step } = context;
+
+        const ref = useRef(null);
+        const animationFrameId = useRef();
+
+        useEffect(() => {
+          const element = ref.current;
+          if (!element) return;
+
+          // A single function to render a static frame (for resizes and step changes)
+          const renderStaticFrame = async () => {
+            if (!ref.current) return;
+            try {
+              // Pass a frame of 1 to indicate a final/static state
+              await renderer({
+                ...context,
+                frame: 1,
+                height: ref.current.clientHeight,
+                width: ref.current.clientWidth,
+                hooks: preactHooks,
+                parent: ref.current,
+                preact,
+                styled,
+              });
+            } catch (error) {
+              if (debug) console.error("Static render failed:", error);
+            }
+          };
+
+          // --- Resize Handling ---
+          const observer = new ResizeObserver(() => {
+            renderStaticFrame();
+          });
+          observer.observe(element);
+
+          // --- Animation Loop ---
+          let start = Date.now();
+          const renderAnimation = async () => {
+            // Stop the loop if the component unmounts or if animate is turned off
+            if (!ref.current || !animate) return;
+
+            const frame = Math.min((Date.now() - start) / speed, 1);
+            if (frame === 1) {
               start = Date.now();
             }
-            const frame =
-              playing || animate
-                ? Math.min((Date.now() - start) / speed, 1)
-                : 1;
+
             try {
-              if (debug) console.time("render");
-              if (typeof renderer === "function") {
-                await renderer({
-                  ...context,
-                  frame,
-                  height: ref.current.clientHeight,
-                  hooks: preactHooks,
-                  parent: ref.current,
-                  preact,
-                  styled,
-                  width: ref.current.clientWidth,
-                });
-              }
+              await renderer({
+                ...context,
+                frame,
+                height: ref.current.clientHeight,
+                width: ref.current.clientWidth,
+                hooks: preactHooks,
+                parent: ref.current,
+                preact,
+                styled,
+              });
             } catch (error) {
-              if (debug) console.error(error);
-              console.log({ ...context, frame, error });
-            } finally {
-              if (debug) console.timeEnd("render");
+              if (debug) console.error("Animation render failed:", error);
             }
-            window.requestAnimationFrame(() => renderFrame(start, step, frame));
+
+            animationFrameId.current = requestAnimationFrame(renderAnimation);
           };
 
-          await renderFrame(Date.now(), context.step);
+          // --- Initial Action ---
+          if (animate) {
+            // If animate is on, start the animation loop
+            renderAnimation();
+          } else {
+            // Otherwise, just render a single static frame for the current step
+            renderStaticFrame();
+          }
+
+          // --- Cleanup ---
+          return () => {
+            observer.disconnect();
+            cancelAnimationFrame(animationFrameId.current);
+          };
         }, [ref.current, context.step, context.renderer]);
 
         return h`<div className=${props.className} ref=${ref} />`;

kaggle_environments/utils.py

@@ -49,11 +49,11 @@ def has(o, classinfo=None, default=None, path=None, is_callable=None):
         for p in path:
             cur = cur[p]
         if classinfo is not None and not isinstance(cur, classinfo):
-            raise "Not a match"
-        if is_callable == True and not callable(cur):
-            raise "Not callable"
-        if is_callable == False and callable(cur):
-            raise "Is callable"
+            raise ValueError("Not a match")
+        if is_callable and not callable(cur):
+            raise ValueError("Not callable")
+        if not is_callable and callable(cur):
+            raise ValueError("Is callable")
         return True
     except:
         if default is not None and o is not None and len(path) > 0:
@@ -137,7 +137,7 @@ def default_schema(schema, data):
         else:
             obj = data
             for k, v in default.items():
-                if not k in obj:
+                if k not in obj:
                     obj[k] = v
         properties = get(schema, dict, {}, ["properties"])
         for key, prop_schema in properties.items():
@@ -180,15 +180,11 @@ def get_player(window_kaggle, renderer):
         value = f"""
 window.kaggle = {json.dumps(window_kaggle, indent=2)};\n\n
         """
-        return read_file(renderer[1]).replace(
-            key, value
-        )
+        return read_file(renderer[1]).replace(key, value)
 
     key = "/*window.kaggle*/"
     value = f"""
 window.kaggle = {json.dumps(window_kaggle, indent=2)};\n\n
 window.kaggle.renderer = {renderer.strip()};\n\n
     """
-    return read_file(Path.joinpath(root_path, "static", "player.html")).replace(
-        key, value
-    )
+    return read_file(Path.joinpath(root_path, "static", "player.html")).replace(key, value)

{kaggle_environments-1.17.12.dist-info → kaggle_environments-1.18.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kaggle-environments
-Version: 1.17.12
+Version: 1.18.0
 Summary: Kaggle Environments
 Home-page: https://github.com/Kaggle/kaggle-environments
 Author: Kaggle
@@ -37,7 +37,7 @@ Dynamic: summary
 # [<img src="https://kaggle.com/static/images/site-logo.png" height="50" style="margin-bottom:-15px" />](https://kaggle.com) Environments
 
 ```bash
-pip install kaggle-environments
+uv pip install kaggle-environments
 ```
 
 # TLDR;
@@ -320,72 +320,3 @@ The following rendering modes are supported:
 out = env.render(mode="ansi")
 print(out)
 ```
-
-# Command Line
-
-```sh
-> python main.py -h
-```
-
-## List Registered Environments
-
-```sh
-> python main.py list
-```
-
-## Evaluate Episode Rewards
-
-```sh
-python main.py evaluate --environment tictactoe --agents random random --episodes 10
-```
-
-## Run an Episode
-
-```sh
-> python main.py run --environment tictactoe --agents random /pathtomy/agent.py --debug True
-```
-
-## Load an Episode
-
-This is useful when converting an episode json output into html.
-
-```sh
-python main.py load --environment tictactoe --steps [...] --render '{"mode": "html"}'
-```
-
-# HTTP Server
-
-The HTTP server contains the same interface/actions as the CLI above merging both POST body and GET params.
-
-## Setup
-
-```bash
-python main.py http-server --port=8012 --host=0.0.0.0
-```
-
-### Running Agents on Separate Servers
-
-```python
-# How to run agent on a separate server.
-import requests
-import json
-
-path_to_agent1 = "/home/ajeffries/git/playground/agent1.py"
-path_to_agent2 = "/home/ajeffries/git/playground/agent2.py"
-
-agent1_url = f"http://localhost:5001?agents[]={path_to_agent1}"
-agent2_url = f"http://localhost:5002?agents[]={path_to_agent2}"
-
-body = {
-    "action": "run",
-    "environment": "tictactoe",
-    "agents": [agent1_url, agent2_url]
-}
-resp = requests.post(url="http://localhost:5000", data=json.dumps(body)).json()
-
-# Inflate the response replay to visualize.
-from kaggle_environments import make
-env = make("tictactoe", steps=resp["steps"], debug=True)
-env.render(mode="ipython")
-print(resp)
-```

{kaggle_environments-1.17.12.dist-info → kaggle_environments-1.18.0.dist-info}/RECORD

@@ -1,13 +1,21 @@
-kaggle_environments/__init__.py,sha256=zh-xNmwXXBfdG2cZpmn8RHybvKdHcaYyA86k8yMYw0I,2176
+kaggle_environments/__init__.py,sha256=iRg6HLV8H1EaxsVF_maFrYK5REcSCG1A_dOHsRBzX3E,2175
 kaggle_environments/agent.py,sha256=IgRagzcTi6F73nPeViDdh9wvHnx8fQhFmXJNutovGZE,6706
-kaggle_environments/api.py,sha256=eLBKqr11Ku4tdsMUdUqy74FIVEA_hdV3_QUpX84x3Z8,798
+kaggle_environments/api.py,sha256=kBC_2ezY7-6JWlgvv-Hi4law6Ilkk2FnV2u_4qEe_rc,745
 kaggle_environments/core.py,sha256=PzF9NR0rFfFikspJ3HE0uI8UOiv_tlDhGSbu11g9vQQ,27860
 kaggle_environments/errors.py,sha256=SzKjkZP7pJbf9g0GDjGq4XG194hCQXLMwrlMCcm7Ai8,3336
-kaggle_environments/helpers.py,sha256=xkOMXaOMifYHHstDZo8bexk-Qq9suPM7Gkfi2JbXu8M,10627
-kaggle_environments/main.py,sha256=10wtcEFcGIjdOd9AEps5WOAwslc6Wsx3eZ43LXJa8jE,11705
+kaggle_environments/helpers.py,sha256=Qy49B35Ifks6P8r4L1kLQDpQ-OVdW6qUTnprQWFz6so,11160
+kaggle_environments/main.py,sha256=3Z2Ew3_0Ve3s-rwBTz8aF0oygh6JOv5iFigeUt6ioYM,11656
 kaggle_environments/schemas.json,sha256=zGzLyhqPdH6QQ0d48SrP5LKbvupprrWvgfQBerLqmhw,3307
 kaggle_environments/status_codes.json,sha256=6a8HuS_Vth95W0f2fov21QLdRfA3KbizUvjKmJhYtBc,995
-kaggle_environments/utils.py,sha256=FcI17PA4QK2-hyNp0dryS0TQ2pFlH9K19zDUMmuF4-E,5713
+kaggle_environments/utils.py,sha256=HUJ7vuTQ-NUxFHqjCEN3Cdcg34DuE4gYrSzLPnTFxp0,5700
+kaggle_environments/envs/cabt/cabt.js,sha256=JOGgC7aw4L41-x0PdHvbYXoc0KqcEAIkqkKLFiVEZzU,4707
+kaggle_environments/envs/cabt/cabt.json,sha256=dYQshH6VRK1AMgZYFv5g4XbGX1cJbdNPXmdILpolgQI,547
+kaggle_environments/envs/cabt/cabt.py,sha256=HCT7f4M_QYbqjzWHriRnTazzAxjK4UvQknxfiYDkNpc,4011
+kaggle_environments/envs/cabt/cg/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kaggle_environments/envs/cabt/cg/cg.dll,sha256=enpFzyM9OYg8LT2SsJhbVkautkNhaaUALicB5WcENI8,1020416
+kaggle_environments/envs/cabt/cg/game.py,sha256=PdJSPA95Vhq3ezyysEh4aDgfU9KqXfmEsd4AzbJwGNI,2150
+kaggle_environments/envs/cabt/cg/libcg.so,sha256=XYncRauAGs5sv84-8bDCLoQVHZDcTBZQ-aN7xilkBlo,907616
+kaggle_environments/envs/cabt/cg/sim.py,sha256=js-EX5EXEsFmnI5OLx2sI8B1jdHF9CPOdJ72L1mWC0g,1195
 kaggle_environments/envs/chess/chess.js,sha256=QYA1arYF_qOfchN8HHQ4hL5z3C9XeT5hYigT75CgvKo,274596
 kaggle_environments/envs/chess/chess.json,sha256=fc8Qa1IHWmYbiEgorXIjMj2JmqP95x_reqFe6Mon2Wk,1692
 kaggle_environments/envs/chess/chess.py,sha256=41LMA8--APQOhl6aeWgJvkSaRBjAch2FgS7ELIoOT3w,245361
@@ -191,12 +199,12 @@ kaggle_environments/envs/mab/mab.py,sha256=bkSIxkstS98Vr3eOA9kxQkseDqa1MlG2Egfze
 kaggle_environments/envs/open_spiel/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 kaggle_environments/envs/open_spiel/html_playthrough_generator.py,sha256=qzvi9wMZKz1WfpaIpBxP5LPlVYKAk9npEtdKLXYHMWo,950
 kaggle_environments/envs/open_spiel/observation.py,sha256=yrJ_iZ9sBUTB6YOyEpKNwYiQEWmsPPtaDYtL4zsw1Ko,4834
-kaggle_environments/envs/open_spiel/open_spiel.py,sha256=HzN1ngjeOqxLoetI1g56PdlioRY26VoCJMQpbD4S-Vk,17517
+kaggle_environments/envs/open_spiel/open_spiel.py,sha256=61hBT2JNyuPVH9aadik_ZXz248mRqqDAQA5XvxGV9hQ,19396
 kaggle_environments/envs/open_spiel/proxy.py,sha256=8Shane4KWYKvbP9nV3l8VQfAFOfFSUrS78h_4xQthVM,4881
 kaggle_environments/envs/open_spiel/proxy_test.py,sha256=QkmRo_uS0DgDDm2pbU2vwal5KOMCWKw92rC2_g3MziM,1837
-kaggle_environments/envs/open_spiel/test_open_spiel.py,sha256=MwyjH-e00-3SP8_r10drYTFvplacbo0cDCI0XKtE4wU,3596
+kaggle_environments/envs/open_spiel/test_open_spiel.py,sha256=AOJzHOICB0SK27QKaFFsKFO_Ui3pqXgE-mWjlrH7IBQ,6080
 kaggle_environments/envs/open_spiel/games/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-kaggle_environments/envs/open_spiel/games/chess/chess.js,sha256=1WEZrngIX-0zNltBg1lWj8aqTWTMGIzCLSR83sUXa3g,19277
+kaggle_environments/envs/open_spiel/games/chess/chess.js,sha256=RAvh0cUTqg1b-drcP9RQFNDP17V8uGQoVSgJFF5uBjU,45639
 kaggle_environments/envs/open_spiel/games/connect_four/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 kaggle_environments/envs/open_spiel/games/connect_four/connect_four.js,sha256=iO74ar3Hh64VYEx9v3eysgrPU-Mcokl9dkFxie6uISg,14893
 kaggle_environments/envs/open_spiel/games/connect_four/connect_four_proxy.py,sha256=2otG99felDYhNhWpsadbM9YUaHtrXqhV1GFNEHhuPwA,2348
@@ -223,10 +231,10 @@ kaggle_environments/envs/tictactoe/test_tictactoe.py,sha256=6CgQbRz-yxNoMfD5tzmC
 kaggle_environments/envs/tictactoe/tictactoe.js,sha256=NZDT-oSG0a6a-rso9Ldh9qkJwVrxrAsjKUC3_tJu3tw,8002
 kaggle_environments/envs/tictactoe/tictactoe.json,sha256=zMXZ8-fpT7FBhzz2FFBvRLn4XwtngjEqOieMvI6cCj8,1121
 kaggle_environments/envs/tictactoe/tictactoe.py,sha256=uq3sTHWNMg0dxX2v9pTbJAKM7fwerxQt7OQjCX96m-Y,3657
-kaggle_environments/static/player.html,sha256=HfXiMfIij7pafsCZq1zwiZRq1zCnmtq4i2ZGIOJV5xw,25561
-kaggle_environments-1.17.12.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-kaggle_environments-1.17.12.dist-info/METADATA,sha256=eG1NSoDEsW_ylRhfCNM44T5YOlc98XgWVW5ej263ihg,10956
-kaggle_environments-1.17.12.dist-info/WHEEL,sha256=JNWh1Fm1UdwIQV075glCn4MVuCRs0sotJIq-J6rbxCU,109
-kaggle_environments-1.17.12.dist-info/entry_points.txt,sha256=HbVC-LKGQFV6lEEYBYyDTtrkHgdHJUWQ8_qt9KHGqz4,70
-kaggle_environments-1.17.12.dist-info/top_level.txt,sha256=v3MMWIPMQFcI-WuF_dJngHWe9Bb2yH_6p4wat1x4gAc,20
-kaggle_environments-1.17.12.dist-info/RECORD,,
+kaggle_environments/static/player.html,sha256=ek33T_8ecmWuxE5dWKO7jlYWLTPXru-cs0PrkBlNjAM,26749
+kaggle_environments-1.18.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+kaggle_environments-1.18.0.dist-info/METADATA,sha256=u5aIqDcf5OhVm9ObJ257CT7AHkgoIHVkAHKmPD9DqB0,9477
+kaggle_environments-1.18.0.dist-info/WHEEL,sha256=7wAbZI8A1UjN-j4-aYf66qBxOZ0Ioy0QNykkY5NcGJo,109
+kaggle_environments-1.18.0.dist-info/entry_points.txt,sha256=HbVC-LKGQFV6lEEYBYyDTtrkHgdHJUWQ8_qt9KHGqz4,70
+kaggle_environments-1.18.0.dist-info/top_level.txt,sha256=v3MMWIPMQFcI-WuF_dJngHWe9Bb2yH_6p4wat1x4gAc,20
+kaggle_environments-1.18.0.dist-info/RECORD,,

{kaggle_environments-1.17.12.dist-info → kaggle_environments-1.18.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (78.1.1)
 Root-Is-Purelib: true
 Tag: py2-none-any
 Tag: py3-none-any