Add first experiments

Author: aman

.gitignore

@@ -44,3 +44,5 @@ Thumbs.db
 .ruff_cache/
 openapi.json
 openapi.codegen.json
+
+.env

README.md

@@ -4,7 +4,7 @@ Python SDK for the BodyLoop API for seamless ecosystem integration
 
 The URL of the source repository <https://github.com/bodyloop/bodyloop-sdk-python> has suffix `python` to enable adding SDKs for other lanuages such as JavaScript/TypeScript, C/C++, Rust, etc.
 
-The distribution name (install) of the Python Package name is `bodyloop-sdk` and is available in the global Package Index PyPi at <https://pypi.org/project/bodyloop-sdk>. It omits the suffix since PyPi already tells us that we are in the Python ecosystem. 
+The distribution name (install) of the Python Package name is `bodyloop-sdk` and is available in the global Package Index PyPi at <https://pypi.org/project/bodyloop-sdk>. It omits the suffix since PyPi already tells us that we are in the Python ecosystem.
 
 Examples how to get the package are:
 
@@ -58,6 +58,17 @@ The API generator <https://pypi.org/project/openapi-python-client/> is used.
 ./generate_api_client.sh <ip_or_hostname_of_my_bodyloop_instance>
 ```
 
+Use the experiments to get your feet wet:
+
+```bash
+touch .env
+echo "BODYLOOP_BASE_URL='https://bodyloop-control-pc'" >> .env
+echo "BODYLOOP_API_TOKEN='your_api_token_here'" >> .env
+
+uv run experiments/a_create_client.py
+uv run experiments/b_load_probands.py
+```
+
 ## License
 
 See [LICENSE](LICENSE)

experiments/a_create_client.py

@@ -0,0 +1,28 @@
+#!/usr/bin/env python3
+
+import os
+import sys
+from pathlib import Path
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
+
+# Add the src directory (src-layout project) so `bodyloop_sdk` can be imported
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "src"))
+
+from bodyloop_sdk.client import AuthenticatedClient
+
+base_url = os.getenv("BODYLOOP_BASE_URL")
+api_token = os.getenv("BODYLOOP_API_TOKEN")
+
+# Create a client with SSL verification disabled for local IP
+# Note: In production, you should use proper SSL certificates
+client = AuthenticatedClient(
+    base_url=base_url,
+    verify_ssl=False,
+    token=api_token,
+    timeout=10.0
+)
+
+print(f"Client configured for: {base_url}")

experiments/b_load_probands.py

@@ -0,0 +1,51 @@
+#!/usr/bin/env python3
+
+import os
+import sys
+from pathlib import Path
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
+
+# Add the src directory (src-layout project) so `bodyloop_sdk` can be imported
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "src"))
+
+from bodyloop_sdk.client import AuthenticatedClient
+
+base_url = os.getenv("BODYLOOP_BASE_URL")
+api_token = os.getenv("BODYLOOP_API_TOKEN")
+
+# (a) Create a client with SSL verification disabled for local IP)
+client = AuthenticatedClient(
+    base_url=base_url,
+    verify_ssl=False,
+    token=api_token,
+    timeout=10.0
+)
+
+print(f"Client configured for: {base_url}")
+
+
+# (b) Load probands
+from functools import partial
+from bodyloop_sdk.client.api.probands import get_probands_api_v2_probands_get
+
+get_probands = partial(get_probands_api_v2_probands_get.sync, client=client)
+
+probands = get_probands() or []
+print(f"Total probands: {len(probands)}\n")
+
+# Print first and last proband for sanity check
+if probands:
+    print("First proband:")
+    print(probands[0])
+    print("\nLast proband:")
+    print(probands[-1])
+
+import json
+if probands:
+    print("First proband:")
+    print(json.dumps(probands[0].to_dict(), indent=2))
+    print("\nLast proband:")
+    print(json.dumps(probands[-1].to_dict(), indent=2))

pyproject.toml

@@ -7,6 +7,7 @@ license = { file = "LICENSE" }
 requires-python = ">=3.11"
 dependencies = [
     "attrs>=25.4.0",
+    "dotenv>=0.9.9",
     "httpx>=0.28.1",
     "python-dateutil>=2.9.0.post0",
 ]

src/bodyloop_sdk/__init__.py

@@ -4,14 +4,21 @@
 
 try:
     # Python 3.8+
-    from importlib.metadata import version as _pkg_version
+    from importlib.metadata import PackageNotFoundError, version as _pkg_version
 except ImportError:  # pragma: no cover (for very old Pythons)
-    from importlib_metadata import version as _pkg_version  # type: ignore
+    from importlib_metadata import (  # type: ignore
+        PackageNotFoundError,
+        version as _pkg_version,
+    )
 
 
 def _read_version() -> str:
     # This must match the distribution name in pyproject.toml ([project].name)
-    return _pkg_version("bodyloop-sdk")
+    try:
+        return _pkg_version("bodyloop-sdk")
+    except PackageNotFoundError:
+        # Fallback for running directly from source without an installed package.
+        return "0.0.0.0"
 
 
 __version__ = _read_version()