0.1.0 - Initial Release (with TicTacToe)

Author: adamjeffries

.gitignore

@@ -127,3 +127,6 @@ dmypy.json
 
 # Pyre type checker
 .pyre/
+
+# Temp Files
+temp.*

README.md

@@ -1 +1,26 @@
-# kaggle-environments
+# [<img src="https://kaggle.com/static/images/site-logo.png" height="50" style="margin-bottom:-15px" />](https://kaggle.com) Environments
+
+> **ALPHA RELEASE** - Breaking changes may be introduced!
+
+```bash
+pip install kaggle-environments
+```
+
+## TLDR;
+
+```python
+from kaggle_environments import make
+
+# Setup a tictactoe environment.
+env = make("tictactoe")
+
+# Basic agent which marks the first available cell.
+def my_agent(obs):
+  return [c for c in range(len(obs.board)) if obs.board[c] == 0][0]
+
+# Run the basic agent against a default agent which chooses a "random" move.
+env.run([my_agent, "random"])
+
+# Render an html ipython replay of the tictactoe game.
+env.render(mode="ipython")
+```

kaggle_environments/__init__.py

@@ -0,0 +1,37 @@
+# Copyright 2020 Kaggle Inc
+#
+# 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.
+
+from importlib import import_module
+from os import listdir
+from .core import *
+from . import utils
+
+version = "0.1.0"
+
+__all__ = ["environments", "evaluate", "make", "register", "utils", "version"]
+
+# Register Environments.
+
+for name in listdir(utils.envs_path):
+    try:
+        env = import_module(f".envs.{name}.{name}", __name__)
+        register(name, {
+            "agents": getattr(env, "agents", []),
+            "html_renderer": getattr(env, "html_renderer", None),
+            "interpreter": getattr(env, "interpreter"),
+            "renderer": getattr(env, "renderer"),
+            "specification": getattr(env, "specification"),
+        })
+    except:
+        pass