slash-command 0.2.0__py3-none-any.whl

slash_command/__init__.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+from ._parser import Command, Document, Text, parse
+
+__all__ = ["parse", "Text", "Command", "Document"]
+
+__version__ = "0.1.0"

slash_command/_parser.py

@@ -0,0 +1,108 @@
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass, field
+
+_NAME_RE = re.compile(r"[a-zA-Z][a-zA-Z0-9_-]*")
+_WS = frozenset(" \t\n\r")
+_HWS = frozenset(" \t")  # horizontal whitespace only
+
+
+@dataclass
+class Text:
+    content: str
+
+
+@dataclass
+class Command:
+    name: str
+    args: list[str] = field(default_factory=list)
+
+
+Document = list[Text | Command]
+
+
+def _word_boundary(text: str, pos: int) -> bool:
+    return pos == 0 or text[pos - 1] in _WS
+
+
+def _parse_args(text: str, pos: int) -> tuple[list[str], int]:
+    """Return (args, new_pos) starting right after the command name."""
+    n = len(text)
+
+    # Must have at least one horizontal space before args.
+    if pos >= n or text[pos] not in _HWS:
+        return [], pos
+
+    # Skip horizontal whitespace.
+    while pos < n and text[pos] in _HWS:
+        pos += 1
+
+    if pos >= n or text[pos] == "\n":
+        return [], pos
+
+    # Quoted form: first non-space char is a quote.
+    if text[pos] in "\"'":
+        args: list[str] = []
+        start = pos  # save for unterminated-quote backtrack
+        while pos < n and text[pos] in "\"'":
+            quote = text[pos]
+            pos += 1
+            end = text.find(quote, pos)
+            if end == -1:
+                # Unterminated quote — backtrack, emit command with no args.
+                return [], start
+            args.append(text[pos:end])
+            pos = end + 1
+            while pos < n and text[pos] in _HWS:
+                pos += 1
+        return args, pos
+
+    # Raw form: scan to EOL, stop early at the next command trigger.
+    raw_start = pos
+    while pos < n and text[pos] != "\n":
+        if text[pos] == "/" and _word_boundary(text, pos):
+            m = _NAME_RE.match(text, pos + 1)
+            if m:
+                break
+        pos += 1
+
+    raw = text[raw_start:pos].rstrip()
+    if raw:
+        return [raw], pos  # pos is EOL, EOF, or start of next command trigger
+    return [], pos
+
+
+def _try_command(text: str, pos: int) -> tuple[Command, int] | None:
+    """Try to parse a command at pos (text[pos] must be '/')."""
+    m = _NAME_RE.match(text, pos + 1)
+    if not m:
+        return None
+    name = m.group()
+    args, end = _parse_args(text, m.end())
+    return Command(name, args), end
+
+
+def parse(text: str) -> Document:
+    """Parse *text* into an ordered sequence of Text and Command segments."""
+    segments: Document = []
+    pos = 0
+    text_start = 0
+    n = len(text)
+
+    while pos < n:
+        if text[pos] == "/" and _word_boundary(text, pos):
+            result = _try_command(text, pos)
+            if result is not None:
+                cmd, end = result
+                if pos > text_start:
+                    segments.append(Text(text[text_start:pos]))
+                segments.append(cmd)
+                text_start = pos = end
+                continue
+        pos += 1
+
+    if text_start < n:
+        segments.append(Text(text[text_start:]))
+
+    return segments

slash_command-0.2.0.dist-info/METADATA

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: slash_command
+Version: 0.2.0
+Summary: Slash Command Language (SCL) — Python implementation
+Project-URL: Homepage, https://github.com/monperrus/slash_command
+Project-URL: Bug Tracker, https://github.com/monperrus/slash_command/issues
+Author-email: Martin Monperrus <martin2020+claude@monperrus.net>
+License: MIT
+License-File: LICENSE
+Keywords: command,island-parsing,llm,parser,slash
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Text Processing
+Requires-Python: >=3.11
+Provides-Extra: dev
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# slash_command
+
+Python implementation of the **Slash Command Language (SCL)** — a minimal
+syntax for embedding executable commands within natural-language text.
+
+See the [SCL specification](https://github.com/monperrus/slash_command) for the full
+grammar, normative algorithm, and conformance criteria.
+
+## Install
+
+```bash
+pip install slash_command
+```
+
+## Usage
+
+```python
+from slash_command import parse, Text, Command
+
+doc = parse('Please /search "quantum computing" and then /exit')
+
+for segment in doc:
+    if isinstance(segment, Command):
+        print(f"command: {segment.name!r}, args: {segment.args}")
+    else:
+        print(f"text: {segment.content!r}")
+```
+

slash_command-0.2.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+slash_command/__init__.py,sha256=-V2dToZinaMfAcUhjEnLwzMWloFgwh8yXACco2jg-oI,163
+slash_command/_parser.py,sha256=BWA6gQM86RhCf3CgZGlliwi669mdSM6ZQUQmnqwQCws,2973
+slash_command-0.2.0.dist-info/METADATA,sha256=rLfuU9wWSXd9p0GDOVflx_k0ON-R-dIYDzcYUc4E8JA,1701
+slash_command-0.2.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+slash_command-0.2.0.dist-info/licenses/LICENSE,sha256=cZcVt0H9cnb7yEUhuaOjEY44tOenoE73-XlnbE3fTG8,1073
+slash_command-0.2.0.dist-info/RECORD,,

slash_command-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

slash_command-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Martin Monperrus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.