tree-sitter-qsharp 0.1.0__tar.gz

tree_sitter_qsharp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bezpechno
+
+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.

tree_sitter_qsharp-0.1.0/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: tree-sitter-qsharp
+Version: 0.1.0
+Summary: Q# grammar for tree-sitter
+Author: bezpechno
+License: MIT
+Project-URL: Homepage, https://github.com/bezpechno/tree-sitter-qsharp
+Keywords: incremental,parsing,tree-sitter,qsharp
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Compilers
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: core
+Requires-Dist: tree-sitter~=0.24; extra == "core"
+Dynamic: license-file
+
+# tree-sitter-qsharp
+
+A [tree-sitter](https://tree-sitter.github.io/) grammar for [Q#](https://learn.microsoft.com/en-us/azure/quantum/overview-what-is-qsharp-and-qdk), Microsoft's quantum programming language.
+
+This is a new project, not affiliated with Microsoft or the tree-sitter organization. Feedback, bug reports, and contributions are welcome.
+
+## What it does
+
+Parses Q# source files into a concrete syntax tree that editors can use for syntax highlighting, code folding, symbol navigation, and indentation.
+
+Built by reading the [Q# language documentation](https://learn.microsoft.com/en-us/azure/quantum/user-guide/language/) and the [Q# compiler source](https://github.com/microsoft/qsharp) as reference. Tested against the Q# files in the microsoft/qsharp repository.
+
+### Supported constructs
+
+- Namespaces, imports, exports, open directives
+- Operations and functions with type parameters, functor clauses, specializations
+- Structs, newtypes, all builtin types
+- Full expression grammar with operator precedence per the [Q# specification](https://learn.microsoft.com/en-us/azure/quantum/user-guide/language/expressions/precedenceandassociativity)
+- Quantum-specific syntax: `use`/`borrow`, `within`/`apply`, `repeat`/`until`/`fixup`, `Adjoint`/`Controlled`
+- All literals: int, bigint, float, imaginary, string, interpolated string, bool, Result, Pauli
+- External scanner for float/range disambiguation (`1.` vs `0..5`)
+
+### Known limitations
+
+- Explicit type arguments on calls (`Foo<Int>(x)`) are not supported due to `<`/`>` ambiguity with comparison operators. Q# type inference handles this in practice.
+- Open-ended step ranges (`...2...`) parse but the AST does not perfectly represent all range component positions.
+- This is a v0.x project. There may be edge cases that are not yet covered.
+
+## Editor query files
+
+| Feature | File |
+|---|---|
+| Syntax highlighting | `queries/highlights.scm` |
+| Code folding | `queries/folds.scm` |
+| Symbol outline | `queries/tags.scm` |
+| Auto-indentation | `queries/indents.scm` |
+| Scope tracking | `queries/locals.scm` |
+| Text objects | `queries/textobjects.scm` |
+
+Capture names follow the [nvim-treesitter](https://github.com/nvim-treesitter/nvim-treesitter/blob/main/CONTRIBUTING.md) conventions.
+
+## Installation
+
+```bash
+npm install tree-sitter-qsharp    # Node.js
+cargo add tree-sitter-qsharp      # Rust
+pip install tree-sitter-qsharp    # Python
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/bezpechno/tree-sitter-qsharp
+cd tree-sitter-qsharp
+tree-sitter generate
+```
+
+## Development
+
+```bash
+tree-sitter generate    # regenerate parser
+tree-sitter test        # run corpus tests
+tree-sitter fuzz        # fuzz test
+tree-sitter parse file.qs          # parse a file
+tree-sitter highlight file.qs      # preview highlighting
+```
+
+## Contributing
+
+If you find Q# code that doesn't parse correctly, please open an issue with the `.qs` file or a minimal reproducing snippet. Pull requests are welcome.
+
+## References
+
+- [Q# language documentation](https://learn.microsoft.com/en-us/azure/quantum/user-guide/language/)
+- [microsoft/qsharp](https://github.com/microsoft/qsharp) — Q# compiler and standard library (MIT)
+- [tree-sitter](https://tree-sitter.github.io/tree-sitter/) — parser generator
+
+## License
+
+MIT

tree_sitter_qsharp-0.1.0/README.md

@@ -0,0 +1,80 @@
+# tree-sitter-qsharp
+
+A [tree-sitter](https://tree-sitter.github.io/) grammar for [Q#](https://learn.microsoft.com/en-us/azure/quantum/overview-what-is-qsharp-and-qdk), Microsoft's quantum programming language.
+
+This is a new project, not affiliated with Microsoft or the tree-sitter organization. Feedback, bug reports, and contributions are welcome.
+
+## What it does
+
+Parses Q# source files into a concrete syntax tree that editors can use for syntax highlighting, code folding, symbol navigation, and indentation.
+
+Built by reading the [Q# language documentation](https://learn.microsoft.com/en-us/azure/quantum/user-guide/language/) and the [Q# compiler source](https://github.com/microsoft/qsharp) as reference. Tested against the Q# files in the microsoft/qsharp repository.
+
+### Supported constructs
+
+- Namespaces, imports, exports, open directives
+- Operations and functions with type parameters, functor clauses, specializations
+- Structs, newtypes, all builtin types
+- Full expression grammar with operator precedence per the [Q# specification](https://learn.microsoft.com/en-us/azure/quantum/user-guide/language/expressions/precedenceandassociativity)
+- Quantum-specific syntax: `use`/`borrow`, `within`/`apply`, `repeat`/`until`/`fixup`, `Adjoint`/`Controlled`
+- All literals: int, bigint, float, imaginary, string, interpolated string, bool, Result, Pauli
+- External scanner for float/range disambiguation (`1.` vs `0..5`)
+
+### Known limitations
+
+- Explicit type arguments on calls (`Foo<Int>(x)`) are not supported due to `<`/`>` ambiguity with comparison operators. Q# type inference handles this in practice.
+- Open-ended step ranges (`...2...`) parse but the AST does not perfectly represent all range component positions.
+- This is a v0.x project. There may be edge cases that are not yet covered.
+
+## Editor query files
+
+| Feature | File |
+|---|---|
+| Syntax highlighting | `queries/highlights.scm` |
+| Code folding | `queries/folds.scm` |
+| Symbol outline | `queries/tags.scm` |
+| Auto-indentation | `queries/indents.scm` |
+| Scope tracking | `queries/locals.scm` |
+| Text objects | `queries/textobjects.scm` |
+
+Capture names follow the [nvim-treesitter](https://github.com/nvim-treesitter/nvim-treesitter/blob/main/CONTRIBUTING.md) conventions.
+
+## Installation
+
+```bash
+npm install tree-sitter-qsharp    # Node.js
+cargo add tree-sitter-qsharp      # Rust
+pip install tree-sitter-qsharp    # Python
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/bezpechno/tree-sitter-qsharp
+cd tree-sitter-qsharp
+tree-sitter generate
+```
+
+## Development
+
+```bash
+tree-sitter generate    # regenerate parser
+tree-sitter test        # run corpus tests
+tree-sitter fuzz        # fuzz test
+tree-sitter parse file.qs          # parse a file
+tree-sitter highlight file.qs      # preview highlighting
+```
+
+## Contributing
+
+If you find Q# code that doesn't parse correctly, please open an issue with the `.qs` file or a minimal reproducing snippet. Pull requests are welcome.
+
+## References
+
+- [Q# language documentation](https://learn.microsoft.com/en-us/azure/quantum/user-guide/language/)
+- [microsoft/qsharp](https://github.com/microsoft/qsharp) — Q# compiler and standard library (MIT)
+- [tree-sitter](https://tree-sitter.github.io/tree-sitter/) — parser generator
+
+## License
+
+MIT

tree_sitter_qsharp-0.1.0/bindings/python/tree_sitter_qsharp/__init__.py

@@ -0,0 +1,43 @@
+"""Q# grammar for tree-sitter"""
+
+from importlib.resources import files as _files
+
+from ._binding import language
+
+
+def _get_query(name, file):
+    try:
+        query = _files(f"{__package__}") / file
+        globals()[name] = query.read_text()
+    except FileNotFoundError:
+        globals()[name] = None
+    return globals()[name]
+
+
+def __getattr__(name):
+    if name == "HIGHLIGHTS_QUERY":
+        return _get_query("HIGHLIGHTS_QUERY", "queries/highlights.scm")
+    if name == "INJECTIONS_QUERY":
+        return _get_query("INJECTIONS_QUERY", "queries/injections.scm")
+    if name == "LOCALS_QUERY":
+        return _get_query("LOCALS_QUERY", "queries/locals.scm")
+    if name == "TAGS_QUERY":
+        return _get_query("TAGS_QUERY", "queries/tags.scm")
+
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+__all__ = [
+    "language",
+    "HIGHLIGHTS_QUERY",
+    "INJECTIONS_QUERY",
+    "LOCALS_QUERY",
+    "TAGS_QUERY",
+]
+
+
+def __dir__():
+    return sorted(__all__ + [
+        "__all__", "__builtins__", "__cached__", "__doc__", "__file__",
+        "__loader__", "__name__", "__package__", "__path__", "__spec__",
+    ])

tree_sitter_qsharp-0.1.0/bindings/python/tree_sitter_qsharp/__init__.pyi

@@ -0,0 +1,17 @@
+from typing import Final
+from typing_extensions import CapsuleType
+
+HIGHLIGHTS_QUERY: Final[str] | None
+"""The syntax highlighting query for this grammar."""
+
+INJECTIONS_QUERY: Final[str] | None
+"""The language injection query for this grammar."""
+
+LOCALS_QUERY: Final[str] | None
+"""The local variable query for this grammar."""
+
+TAGS_QUERY: Final[str] | None
+"""The symbol tagging query for this grammar."""
+
+def language() -> CapsuleType:
+    """The tree-sitter language function for this grammar."""

tree_sitter_qsharp-0.1.0/bindings/python/tree_sitter_qsharp/binding.c

@@ -0,0 +1,35 @@
+#include <Python.h>
+
+typedef struct TSLanguage TSLanguage;
+
+TSLanguage *tree_sitter_qsharp(void);
+
+static PyObject* _binding_language(PyObject *Py_UNUSED(self), PyObject *Py_UNUSED(args)) {
+    return PyCapsule_New(tree_sitter_qsharp(), "tree_sitter.Language", NULL);
+}
+
+static struct PyModuleDef_Slot slots[] = {
+#ifdef Py_GIL_DISABLED
+    {Py_mod_gil, Py_MOD_GIL_NOT_USED},
+#endif
+    {0, NULL}
+};
+
+static PyMethodDef methods[] = {
+    {"language", _binding_language, METH_NOARGS,
+     "Get the tree-sitter language for this grammar."},
+    {NULL, NULL, 0, NULL}
+};
+
+static struct PyModuleDef module = {
+    .m_base = PyModuleDef_HEAD_INIT,
+    .m_name = "_binding",
+    .m_doc = NULL,
+    .m_size = 0,
+    .m_methods = methods,
+    .m_slots = slots,
+};
+
+PyMODINIT_FUNC PyInit__binding(void) {
+    return PyModuleDef_Init(&module);
+}

tree_sitter_qsharp-0.1.0/bindings/python/tree_sitter_qsharp.egg-info/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: tree-sitter-qsharp
+Version: 0.1.0
+Summary: Q# grammar for tree-sitter
+Author: bezpechno
+License: MIT
+Project-URL: Homepage, https://github.com/bezpechno/tree-sitter-qsharp
+Keywords: incremental,parsing,tree-sitter,qsharp
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Compilers
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: core
+Requires-Dist: tree-sitter~=0.24; extra == "core"
+Dynamic: license-file
+
+# tree-sitter-qsharp
+
+A [tree-sitter](https://tree-sitter.github.io/) grammar for [Q#](https://learn.microsoft.com/en-us/azure/quantum/overview-what-is-qsharp-and-qdk), Microsoft's quantum programming language.
+
+This is a new project, not affiliated with Microsoft or the tree-sitter organization. Feedback, bug reports, and contributions are welcome.
+
+## What it does
+
+Parses Q# source files into a concrete syntax tree that editors can use for syntax highlighting, code folding, symbol navigation, and indentation.
+
+Built by reading the [Q# language documentation](https://learn.microsoft.com/en-us/azure/quantum/user-guide/language/) and the [Q# compiler source](https://github.com/microsoft/qsharp) as reference. Tested against the Q# files in the microsoft/qsharp repository.
+
+### Supported constructs
+
+- Namespaces, imports, exports, open directives
+- Operations and functions with type parameters, functor clauses, specializations
+- Structs, newtypes, all builtin types
+- Full expression grammar with operator precedence per the [Q# specification](https://learn.microsoft.com/en-us/azure/quantum/user-guide/language/expressions/precedenceandassociativity)
+- Quantum-specific syntax: `use`/`borrow`, `within`/`apply`, `repeat`/`until`/`fixup`, `Adjoint`/`Controlled`
+- All literals: int, bigint, float, imaginary, string, interpolated string, bool, Result, Pauli
+- External scanner for float/range disambiguation (`1.` vs `0..5`)
+
+### Known limitations
+
+- Explicit type arguments on calls (`Foo<Int>(x)`) are not supported due to `<`/`>` ambiguity with comparison operators. Q# type inference handles this in practice.
+- Open-ended step ranges (`...2...`) parse but the AST does not perfectly represent all range component positions.
+- This is a v0.x project. There may be edge cases that are not yet covered.
+
+## Editor query files
+
+| Feature | File |
+|---|---|
+| Syntax highlighting | `queries/highlights.scm` |
+| Code folding | `queries/folds.scm` |
+| Symbol outline | `queries/tags.scm` |
+| Auto-indentation | `queries/indents.scm` |
+| Scope tracking | `queries/locals.scm` |
+| Text objects | `queries/textobjects.scm` |
+
+Capture names follow the [nvim-treesitter](https://github.com/nvim-treesitter/nvim-treesitter/blob/main/CONTRIBUTING.md) conventions.
+
+## Installation
+
+```bash
+npm install tree-sitter-qsharp    # Node.js
+cargo add tree-sitter-qsharp      # Rust
+pip install tree-sitter-qsharp    # Python
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/bezpechno/tree-sitter-qsharp
+cd tree-sitter-qsharp
+tree-sitter generate
+```
+
+## Development
+
+```bash
+tree-sitter generate    # regenerate parser
+tree-sitter test        # run corpus tests
+tree-sitter fuzz        # fuzz test
+tree-sitter parse file.qs          # parse a file
+tree-sitter highlight file.qs      # preview highlighting
+```
+
+## Contributing
+
+If you find Q# code that doesn't parse correctly, please open an issue with the `.qs` file or a minimal reproducing snippet. Pull requests are welcome.
+
+## References
+
+- [Q# language documentation](https://learn.microsoft.com/en-us/azure/quantum/user-guide/language/)
+- [microsoft/qsharp](https://github.com/microsoft/qsharp) — Q# compiler and standard library (MIT)
+- [tree-sitter](https://tree-sitter.github.io/tree-sitter/) — parser generator
+
+## License
+
+MIT

tree_sitter_qsharp-0.1.0/bindings/python/tree_sitter_qsharp.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+bindings/python/tree_sitter_qsharp/__init__.py
+bindings/python/tree_sitter_qsharp/__init__.pyi
+bindings/python/tree_sitter_qsharp/binding.c
+bindings/python/tree_sitter_qsharp/py.typed
+bindings/python/tree_sitter_qsharp.egg-info/PKG-INFO
+bindings/python/tree_sitter_qsharp.egg-info/SOURCES.txt
+bindings/python/tree_sitter_qsharp.egg-info/dependency_links.txt
+bindings/python/tree_sitter_qsharp.egg-info/not-zip-safe
+bindings/python/tree_sitter_qsharp.egg-info/requires.txt
+bindings/python/tree_sitter_qsharp.egg-info/top_level.txt
+src/parser.c

tree_sitter_qsharp-0.1.0/bindings/python/tree_sitter_qsharp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tree_sitter_qsharp-0.1.0/bindings/python/tree_sitter_qsharp.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

tree_sitter_qsharp-0.1.0/bindings/python/tree_sitter_qsharp.egg-info/requires.txt

@@ -0,0 +1,3 @@
+
+[core]
+tree-sitter~=0.24

tree_sitter_qsharp-0.1.0/bindings/python/tree_sitter_qsharp.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+_binding
+tree_sitter_qsharp

tree_sitter_qsharp-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=62.4.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tree-sitter-qsharp"
+description = "Q# grammar for tree-sitter"
+version = "0.1.0"
+keywords = ["incremental", "parsing", "tree-sitter", "qsharp"]
+classifiers = [
+  "Intended Audience :: Developers",
+  "Topic :: Software Development :: Compilers",
+  "Topic :: Text Processing :: Linguistic",
+  "Typing :: Typed",
+]
+authors = [{ name = "bezpechno" }]
+requires-python = ">=3.10"
+license.text = "MIT"
+readme = "README.md"
+
+[project.urls]
+Homepage = "https://github.com/bezpechno/tree-sitter-qsharp"
+
+[project.optional-dependencies]
+core = ["tree-sitter~=0.24"]
+
+[tool.cibuildwheel]
+build = "cp310-*"
+build-frontend = "build"

tree_sitter_qsharp-0.1.0/queries/folds.scm

@@ -0,0 +1,18 @@
+; folds.scm — Code folding regions for Q#
+
+(block) @fold
+(namespace) @fold
+(callable_decl) @fold
+(struct_decl) @fold
+(newtype_decl) @fold
+(specialization_list) @fold
+(specialization) @fold
+(if_expression) @fold
+(elif_clause) @fold
+(else_clause) @fold
+(for_expression) @fold
+(while_expression) @fold
+(repeat_expression) @fold
+(conjugation_expression) @fold
+(array_expression) @fold
+(param_list) @fold