avrae-ls 0.7.1__tar.gz → 0.8.1__tar.gz

{avrae_ls-0.7.1 → avrae_ls-0.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: avrae-ls
-Version: 0.7.1
+Version: 0.8.1
 Summary: Language server for Avrae draconic aliases
 Author: 1drturtle
 License: MIT License
@@ -40,6 +40,8 @@ Description-Content-Type: text/markdown
 
 # Avrae Draconic Alias Language Server
 
+[![Tests](https://github.com/1drturtle/avrae-ls/actions/workflows/ci.yml/badge.svg)](https://github.com/1drturtle/avrae-ls/actions/workflows/ci.yml)
+
 Language Server Protocol (LSP) implementation targeting Avrae-style draconic aliases. It provides syntax/semantic diagnostics, a mocked execution command, and a thin configuration layer driven by a workspace `.avraels.json` file. Credit to Avrae team for all code yoinked!
 
 ## Install (released package)
@@ -105,12 +107,12 @@ Language Server Protocol (LSP) implementation targeting Avrae-style draconic ali
 
 - Mock execution never writes back to Avrae: cvar/uvar/gvar mutations only live for the current run and reset before the next.
 - Network is limited to gvar fetches (when `enableGvarFetch` is true) and `verify_signature`; other Avrae/Discord calls are replaced with mocked context data from `.avraels.json`.
-- `get_gvar`/`using` values are pulled from local var files first; remote fetches go to `https://api.avrae.io/customizations/gvars/<id>` (or your `avraeService.baseUrl`) using `avraeService.token` and are cached for the session.
+- `get_gvar`/`using` values are pulled from local var files first; remote fetches go to `https://api.avrae.io/customizations/gvars/<id>` (or your `avraeService.baseUrl`) using `avraeService.token` and are cached for the session. In var files, a gvar can be a direct value or a `{ "filePath": "relative/or/absolute/path" }` object (also supports `"path"`) that loads file contents as the gvar value.
 - `signature()` returns a mock string (`mock-signature:<int>`). `verify_signature()` POSTs to `/bot/signature/verify`, reuses the last successful response per signature, and includes `avraeService.token` if present.
 
 ## Troubleshooting gvar fetch / verify_signature
 
-- `get_gvar` returns `None` or `using(...)` raises `ModuleNotFoundError`: ensure the workspace `.avraels.json` sets `enableGvarFetch: true`, includes a valid `avraeService.token`, or seed the gvar in a var file referenced by `varFiles`.
+- `get_gvar` returns `None` or `using(...)` raises `ModuleNotFoundError`: ensure the workspace `.avraels.json` sets `enableGvarFetch: true`, includes a valid `avraeService.token`, or seed the gvar in a var file referenced by `varFiles` (including `filePath` gvar entries).
 - HTTP 401/403/404 from fetch/verify calls: check the token (401/403) and the gvar/signature id (404). Override `avraeService.baseUrl` if you mirror the API.
 - Slow or flaky calls: disable remote fetches by flipping `enableGvarFetch` off to rely purely on local vars.
 

{avrae_ls-0.7.1 → avrae_ls-0.8.1}/README.md

@@ -1,5 +1,7 @@
 # Avrae Draconic Alias Language Server
 
+[![Tests](https://github.com/1drturtle/avrae-ls/actions/workflows/ci.yml/badge.svg)](https://github.com/1drturtle/avrae-ls/actions/workflows/ci.yml)
+
 Language Server Protocol (LSP) implementation targeting Avrae-style draconic aliases. It provides syntax/semantic diagnostics, a mocked execution command, and a thin configuration layer driven by a workspace `.avraels.json` file. Credit to Avrae team for all code yoinked!
 
 ## Install (released package)
@@ -65,12 +67,12 @@ Language Server Protocol (LSP) implementation targeting Avrae-style draconic ali
 
 - Mock execution never writes back to Avrae: cvar/uvar/gvar mutations only live for the current run and reset before the next.
 - Network is limited to gvar fetches (when `enableGvarFetch` is true) and `verify_signature`; other Avrae/Discord calls are replaced with mocked context data from `.avraels.json`.
-- `get_gvar`/`using` values are pulled from local var files first; remote fetches go to `https://api.avrae.io/customizations/gvars/<id>` (or your `avraeService.baseUrl`) using `avraeService.token` and are cached for the session.
+- `get_gvar`/`using` values are pulled from local var files first; remote fetches go to `https://api.avrae.io/customizations/gvars/<id>` (or your `avraeService.baseUrl`) using `avraeService.token` and are cached for the session. In var files, a gvar can be a direct value or a `{ "filePath": "relative/or/absolute/path" }` object (also supports `"path"`) that loads file contents as the gvar value.
 - `signature()` returns a mock string (`mock-signature:<int>`). `verify_signature()` POSTs to `/bot/signature/verify`, reuses the last successful response per signature, and includes `avraeService.token` if present.
 
 ## Troubleshooting gvar fetch / verify_signature
 
-- `get_gvar` returns `None` or `using(...)` raises `ModuleNotFoundError`: ensure the workspace `.avraels.json` sets `enableGvarFetch: true`, includes a valid `avraeService.token`, or seed the gvar in a var file referenced by `varFiles`.
+- `get_gvar` returns `None` or `using(...)` raises `ModuleNotFoundError`: ensure the workspace `.avraels.json` sets `enableGvarFetch: true`, includes a valid `avraeService.token`, or seed the gvar in a var file referenced by `varFiles` (including `filePath` gvar entries).
 - HTTP 401/403/404 from fetch/verify calls: check the token (401/403) and the gvar/signature id (404). Override `avraeService.baseUrl` if you mirror the API.
 - Slow or flaky calls: disable remote fetches by flipping `enableGvarFetch` off to rely purely on local vars.
 

{avrae_ls-0.7.1 → avrae_ls-0.8.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "avrae-ls"
-version = "0.7.1"
+version = "0.8.1"
 description = "Language server for Avrae draconic aliases"
 authors = [
   { name = "1drturtle" }

{avrae_ls-0.7.1 → avrae_ls-0.8.1}/src/avrae_ls/context.py

@@ -14,6 +14,7 @@ from .config import AvraeLSConfig, ContextProfile, VarSources
 from .cvars import derive_character_cvars
 
 log = logging.getLogger(__name__)
+_SKIP_GVAR = object()
 
 
 @dataclass
@@ -63,7 +64,7 @@ class ContextBuilder:
             data = _read_json_file(path)
             if data is None:
                 continue
-            merged = merged.merge(VarSources.from_data(data))
+            merged = merged.merge(_var_sources_from_file(path, data))
         return merged
 
     def _merge_character_cvars(self, character: Dict[str, Any], vars: VarSources) -> VarSources:
@@ -366,3 +367,49 @@ def _read_json_file(path: Path) -> Dict[str, Any] | None:
     except json.JSONDecodeError as exc:
         log.warning("Failed to parse var file %s: %s", path, exc)
         return None
+
+
+def _var_sources_from_file(path: Path, data: Dict[str, Any]) -> VarSources:
+    parsed = VarSources.from_data(data)
+    return VarSources(
+        cvars=parsed.cvars,
+        uvars=parsed.uvars,
+        svars=parsed.svars,
+        gvars=_resolve_gvar_file_refs(path, parsed.gvars),
+    )
+
+
+def _resolve_gvar_file_refs(var_file: Path, gvars: Dict[str, Any]) -> Dict[str, Any]:
+    resolved: dict[str, Any] = {}
+    for key, value in gvars.items():
+        parsed = _parse_gvar_value(var_file, key, value)
+        if parsed is _SKIP_GVAR:
+            continue
+        resolved[str(key)] = parsed
+    return resolved
+
+
+def _parse_gvar_value(var_file: Path, key: Any, value: Any) -> Any:
+    if not isinstance(value, dict):
+        return value
+
+    file_path = value.get("filePath")
+    if file_path is None:
+        file_path = value.get("path")
+    if file_path is None:
+        return value
+    if not isinstance(file_path, str) or not file_path.strip():
+        log.warning("Invalid gvar file path for '%s' in %s; expected a non-empty string.", key, var_file)
+        return _SKIP_GVAR
+
+    gvar_path = Path(file_path)
+    if not gvar_path.is_absolute():
+        gvar_path = var_file.parent / gvar_path
+    try:
+        return gvar_path.read_text()
+    except FileNotFoundError:
+        log.warning("Gvar content file not found for '%s': %s", key, gvar_path)
+        return _SKIP_GVAR
+    except OSError as exc:
+        log.warning("Failed to read gvar content file for '%s' (%s): %s", key, gvar_path, exc)
+        return _SKIP_GVAR