Docs (#607)

* added mkdocstrings

* divided content into larger categories

docs/api/benchmark.md

@@ -0,0 +1,4 @@
+# Benchmark Module
+
+::: prediction_market_agent_tooling.benchmark
+    handler: python

docs/api/config.md

@@ -0,0 +1,4 @@
+# Configuration Module
+
+::: prediction_market_agent_tooling.config
+    handler: python

docs/api/deploy.md

@@ -0,0 +1,4 @@
+# Deploy Module
+
+::: prediction_market_agent_tooling.deploy
+    handler: python

docs/api/gtypes.md

@@ -0,0 +1,4 @@
+# Global Types
+
+::: prediction_market_agent_tooling.gtypes
+    handler: python

docs/api/index.md

@@ -0,0 +1,15 @@
+# Reference
+
+Welcome to the API Reference for **Prediction Market Agent Tooling**. 
+
+This section provides detailed documentation of all modules. It is recommended to use the search function to quickly navigate to the function/module you want to learn about.
+
+## Core Modules
+
+- [Benchmark](benchmark.md)
+- [Deploy](deploy.md)
+- [Markets](markets.md)
+- [Monitor](monitor.md)
+- [Tools](tools.md)
+- [Configuration](config.md)
+- [Global Types](gtypes.md)

docs/api/markets.md

@@ -0,0 +1,4 @@
+# Markets Module
+
+::: prediction_market_agent_tooling.markets
+    handler: python

docs/api/monitor.md

@@ -0,0 +1,4 @@
+# Monitor Module
+
+::: prediction_market_agent_tooling.monitor
+    handler: python

docs/api/tools.md

@@ -0,0 +1,4 @@
+# Tools Module
+
+::: prediction_market_agent_tooling.tools
+    handler: python

docs/requirements.txt

@@ -1,2 +1,5 @@
 mkdocs
 mkdocs-material
+mkdocstrings
+mkdocstrings-python
+ruff

mkdocs.yml

@@ -1,4 +1,5 @@
 site_name: Prediction Market Agent Tooling
+
 nav:
   - Home: index.md
   - Prediction Market Agents:
@@ -10,9 +11,49 @@ nav:
       - Benchmarker: benchmarker.md
       - Example Agent: exampleagent.md
       - Deploy with Safe: deploywithsafe.md
+  - Reference:
+      - Overview: api/index.md
+      - Core Modules:
+          - Benchmark: api/benchmark.md
+          - Deploy: api/deploy.md
+          - Markets: api/markets.md
+          - Monitor: api/monitor.md
+          - Tools: api/tools.md
+          - Configuration: api/config.md
+          - Global Types: api/gtypes.md
   - Contributing: contributing.md
 
 theme:
   name: material
   features:
     - navigation.expand
+
+plugins:
+  - search
+  - mkdocstrings:
+      default_handler: python
+      handlers:
+        python:
+          options:
+            show_source: true
+            show_root_heading: true
+            show_root_toc_entry: true
+            show_if_no_docstring: true
+            separate_signature: true
+            members_order: source
+            docstring_section_style: table
+            show_signature_annotations: true
+            show_bases: true
+            show_inheritance: true
+            show_submodules: true
+            merge_init_into_class: true
+            show_if_no_docstring: true
+            inherited_members: true
+            members: true
+            filters: ["!^_"]
+
+markdown_extensions:
+  - pymdownx.highlight
+  - pymdownx.superfences
+  - pymdownx.details
+  - pymdownx.emoji

prediction_market_agent_tooling/__init__.py

@@ -0,0 +1,39 @@
+"""
+Prediction Market Agent Tooling
+
+This package provides tools and utilities for interacting with prediction markets.
+"""
+
+import pkgutil
+import importlib
+import sys
+
+# Define all modules that should be available
+__all__ = []
+
+# Ensure package is importable from subdirectories
+package_name = __name__
+
+for loader, module_name, is_pkg in pkgutil.walk_packages(__path__, prefix=package_name + "."):
+    try:
+        imported_module = importlib.import_module(module_name)
+        globals()[module_name.split(".")[-1]] = imported_module
+        __all__.append(module_name.split(".")[-1])
+    except ImportError as e:
+        print(f"Warning: Could not import {module_name}: {e}")
+
+# Recursively ensure all submodules are imported
+def recursive_import(package):
+    for loader, module_name, is_pkg in pkgutil.walk_packages(package.__path__, prefix=package.__name__ + "."):
+        try:
+            imported_module = importlib.import_module(module_name)
+            globals()[module_name.split(".")[-1]] = imported_module
+            __all__.append(module_name.split(".")[-1])
+            if is_pkg:
+                recursive_import(imported_module)  # Recursively import nested submodules
+        except ImportError as e:
+            print(f"Warning: Could not import {module_name}: {e}")
+
+# Import all submodules recursively
+recursive_import(importlib.import_module(package_name))
+