sysmlpy 0.64.0__tar.gz → 0.65.0__tar.gz

{sysmlpy-0.64.0 → sysmlpy-0.65.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sysmlpy
-Version: 0.64.0
+Version: 0.65.0
 Summary: 
 License-File: LICENSE
 Author: Jon R. Fox (mycr0ft)

{sysmlpy-0.64.0 → sysmlpy-0.65.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "sysmlpy"
-version = "0.64.0"
+version = "0.65.0"
 description = ""
 authors = [{ name = "Jon R. Fox (mycr0ft)", email = "jon.fox@drfox.com" }]
 readme = "README.md"
@@ -27,6 +27,7 @@ kuzu = ["kuzu"]
 
 [tool.poetry.scripts]
 sysmlpy = "sysmlpy.__main__:main"
+sysmlpy-lsp = "sysmlpy.lsp.stdio:main"
 
 [tool.poetry.group.dev.dependencies]
 pytest = ">=8.0,<9.0"

{sysmlpy-0.64.0 → sysmlpy-0.65.0}/src/sysmlpy/__init__.py

@@ -30,7 +30,7 @@ __all__ = [
     "render_state_transition_view_svg", "boxes_view",
 ]
 __author__ = "Jon Fox"
-__version__ = "0.64.0"
+__version__ = "0.65.0"
 
 from sysmlpy.usage import (
     Item, Attribute, Part, Port, Action, Reference, UseCase, Requirement, Interface, Message,

sysmlpy-0.65.0/src/sysmlpy/lsp/__init__.py

@@ -0,0 +1,24 @@
+# LSP package (v0.65.0 — Adoption Roadmap Goal 5)
+#
+# A minimal Language Server Protocol (LSP 3.17) implementation exposing
+# sysmlpy's parse/analyze pipeline to editors:
+#
+#   textDocument/didOpen|didChange|didClose → publishDiagnostics
+#   textDocument/hover | /documentSymbol | /definition | /completion
+#
+# Layout:
+#   protocol.py — JSON-RPC Content-Length framing + LSP constants
+#   server.py   — transport-agnostic language server (dict in → dict out)
+#   stdio.py    — stdio transport; ``python -m sysmlpy.lsp`` entry point
+#
+# See docs/LSP.md for VS Code / Neovim wiring instructions.
+
+from sysmlpy.lsp.protocol import (
+    encode_message, read_message, ErrorCodes, SymbolKind,
+)
+from sysmlpy.lsp.server import Document, DocumentIndex, SysmlLanguageServer
+
+__all__ = [
+    "encode_message", "read_message", "ErrorCodes", "SymbolKind",
+    "Document", "DocumentIndex", "SysmlLanguageServer",
+]

sysmlpy-0.65.0/src/sysmlpy/lsp/__main__.py

@@ -0,0 +1,9 @@
+# -*- coding: utf-8 -*-
+"""``python -m sysmlpy.lsp`` — run the language server over stdio."""
+
+import sys
+
+from sysmlpy.lsp.stdio import main
+
+if __name__ == "__main__":
+    sys.exit(main())

sysmlpy-0.65.0/src/sysmlpy/lsp/protocol.py

@@ -0,0 +1,106 @@
+# -*- coding: utf-8 -*-
+"""JSON-RPC / LSP protocol helpers (v0.65.0 — Adoption Roadmap Goal 5).
+
+Implements the ``Content-Length`` message framing used by the Language
+Server Protocol over byte streams, plus the small set of LSP constants
+the server needs.  Deliberately dependency-free so the server core can
+be tested in-process without a transport.
+
+Message framing (both sides):
+
+    Content-Length: <bytes>\\r\\n
+    [Content-Type: application/vscode-jsonrpc; charset=utf-8]\\r\\n
+    \\r\\n
+    <JSON payload>
+"""
+
+from __future__ import annotations
+
+import json
+from typing import BinaryIO, Dict, Any, Optional
+
+HEADER_ENCODING = "ascii"
+PAYLOAD_ENCODING = "utf-8"
+
+
+class ErrorCodes:
+    """JSON-RPC / LSP error codes used by the server."""
+
+    PARSE_ERROR = -32700
+    INVALID_REQUEST = -32600
+    METHOD_NOT_FOUND = -32601
+    INVALID_PARAMS = -32602
+    INTERNAL_ERROR = -32603
+    SERVER_NOT_INITIALIZED = -32002
+
+
+class SymbolKind:
+    """LSP SymbolKind values used in documentSymbol results."""
+
+    FILE = 1
+    MODULE = 2
+    NAMESPACE = 3
+    PACKAGE = 4
+    CLASS = 5
+    METHOD = 6
+    PROPERTY = 7
+    FIELD = 8
+    ENUM = 10
+    INTERFACE = 11
+    FUNCTION = 12
+    VARIABLE = 13
+    CONSTANT = 14
+    ENUM_MEMBER = 22
+    STRUCT = 23
+
+
+def encode_message(payload: Dict[str, Any]) -> bytes:
+    """Encode a JSON-RPC message dict with LSP ``Content-Length`` framing."""
+    body = json.dumps(payload, ensure_ascii=False).encode(PAYLOAD_ENCODING)
+    header = f"Content-Length: {len(body)}\r\n\r\n".encode(HEADER_ENCODING)
+    return header + body
+
+
+def read_message(stream: BinaryIO) -> Optional[Dict[str, Any]]:
+    """Read one framed JSON-RPC message from a binary stream.
+
+    Returns the decoded message dict, or ``None`` on clean EOF before any
+    header bytes.  Raises ``ValueError`` on malformed framing.
+
+    Tolerates ``\\n``-only header terminators in addition to the spec's
+    ``\\r\\n`` (some clients get this wrong; being lenient costs nothing).
+    """
+    # Read header lines until the blank separator.
+    content_length: Optional[int] = None
+    saw_header_bytes = False
+    while True:
+        line = stream.readline()
+        if not line:
+            if not saw_header_bytes:
+                return None  # clean EOF
+            raise ValueError("EOF while reading message header")
+        stripped = line.strip()
+        if not stripped:
+            if content_length is None and not saw_header_bytes:
+                continue  # tolerate stray blank lines between messages
+            break  # end of headers
+        saw_header_bytes = True
+        name, _, value = stripped.partition(b":")
+        if name.strip().lower() == b"content-length":
+            try:
+                content_length = int(value.strip())
+            except ValueError:
+                raise ValueError(
+                    f"Malformed Content-Length header: {value!r}"
+                ) from None
+
+    if content_length is None:
+        raise ValueError("Missing Content-Length header")
+
+    body = stream.read(content_length)
+    if len(body) < content_length:
+        raise ValueError(
+            f"EOF while reading message body "
+            f"({len(body)} of {content_length} bytes)"
+        )
+    return json.loads(body.decode(PAYLOAD_ENCODING))