tree-sitter-ghactions 0.1.2__cp310-abi3-musllinux_1_2_x86_64.whl

tree_sitter_ghactions/__init__.py

@@ -0,0 +1,53 @@
+"""Parser for Github Actions expressions"""
+
+from importlib.resources import files as _files
+
+from ._binding import language
+
+
+def _get_query(name, file):
+    query = _files(f"{__package__}.queries") / file
+    globals()[name] = query.read_text()
+    return globals()[name]
+
+
+def __getattr__(name):
+    # NOTE: uncomment these to include any queries that this grammar contains:
+
+    if name == "HIGHLIGHTS_QUERY":
+        return _get_query("HIGHLIGHTS_QUERY", "highlights.scm")
+    # if name == "INJECTIONS_QUERY":
+    #     return _get_query("INJECTIONS_QUERY", "injections.scm")
+    # if name == "LOCALS_QUERY":
+    #     return _get_query("LOCALS_QUERY", "locals.scm")
+    # if name == "TAGS_QUERY":
+    #     return _get_query("TAGS_QUERY", "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_ghactions/__init__.pyi

@@ -0,0 +1,10 @@
+from typing import Final
+
+# NOTE: uncomment these to include any queries that this grammar contains:
+
+HIGHLIGHTS_QUERY: Final[str]
+# INJECTIONS_QUERY: Final[str]
+# LOCALS_QUERY: Final[str]
+# TAGS_QUERY: Final[str]
+
+def language() -> object: ...

tree_sitter_ghactions/binding.c

@@ -0,0 +1,32 @@
+#include <Python.h>
+
+typedef struct TSLanguage TSLanguage;
+
+TSLanguage *tree_sitter_ghactions(void);
+
+static PyObject *_binding_language(PyObject *Py_UNUSED(self),
+                                   PyObject *Py_UNUSED(args)) {
+  return PyCapsule_New(tree_sitter_ghactions(), "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_ghactions/queries/highlights.scm

@@ -0,0 +1,83 @@
+; note: all highlights are set to priority 101, for compatibility with bash injections in yaml
+([
+  "${{"
+  "}}"
+] @keyword
+  (#set! priority 101))
+
+([
+  "&&"
+  "||"
+  "=="
+  "!="
+  "<"
+  "<="
+  ">"
+  ">="
+  "+"
+  "-"
+  "!"
+] @operator
+  (#set! priority 101))
+
+([
+  "("
+  ")"
+  "["
+  "]"
+] @punctuation.bracket
+  (#set! priority 101))
+
+([
+  ","
+  "."
+] @punctuation.delimiter
+  (#set! priority 101))
+
+("*" @punctuation.special
+  (#set! priority 101))
+
+((number) @number
+  (#set! priority 101))
+
+((identifier) @variable
+  (#set! priority 101))
+
+; https://docs.github.com/en/actions/reference/workflows-and-actions/contexts
+(dereference_expression
+  object: (identifier) @module.builtin
+  (#any-of? @module.builtin
+    "github" "env" "vars" "job" "jobs" "steps" "runner" "secrets" "strategy" "matrix" "needs"
+    "inputs")
+  (#set! priority 101))
+
+((dereference_expression
+  property: (identifier) @property)
+  (#set! priority 101))
+
+((function_call
+  name: (identifier) @function.call)
+  (#set! priority 101))
+
+; https://docs.github.com/en/actions/reference/workflows-and-actions/expressions#functions
+((function_call
+  name: (identifier) @function.builtin
+  (#any-of? @function.builtin
+    "contains" "startsWith" "endsWith" "format" "join" "toJSON" "fromJSON" "hashFiles" "success"
+    "always" "cancelled" "failure"))
+  (#set! priority 101))
+
+([
+  (true)
+  (false)
+] @boolean
+  (#set! priority 101))
+
+((null) @constant.builtin
+  (#set! priority 101))
+
+((string) @string
+  (#set! priority 101))
+
+((escape) @string.escape
+  (#set! priority 101))

tree_sitter_ghactions-0.1.2.dist-info/METADATA

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: tree-sitter-ghactions
+Version: 0.1.2
+Summary: Parser for Github Actions expressions
+Author-email: Robert Muir <rmuir@apache.org>
+License: MIT
+Project-URL: Homepage, https://github.com/rmuir/tree-sitter-ghactions
+Keywords: incremental,parsing,tree-sitter,github,actions
+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
+Provides-Extra: core
+Requires-Dist: tree-sitter~=0.25; extra == "core"
+
+# tree-sitter-ghactions
+
+Github Actions expressions grammar for [tree-sitter](https://github.com/tree-sitter/tree-sitter)
+
+## Features
+
+* Parses Github Action's expressions: `${{ ... }}`
+* Plays well with `bash` injections in YAML documents
+* Passes parsing tests from [actionlint](https://github.com/rhysd/actionlint)
+
+## Neovim Installation (for use in your editor)
+
+1. Install [nvim-treesitter](https://github.com/nvim-treesitter/nvim-treesitter/tree/main)
+
+2. Configure autocmd for a custom parser:
+   
+```lua
+-- custom parsers
+vim.api.nvim_create_autocmd('User', {
+  pattern = 'TSUpdate',
+  callback = function()
+    require('nvim-treesitter.parsers').ghactions = {
+      install_info = {
+        url = 'https://github.com/rmuir/tree-sitter-ghactions',
+        queries = 'queries',
+      },
+    }
+  end,
+})
+```
+
+3. Configure yaml injection in `~/.config/nvim/queries/yaml/injections.scm`:
+```tsq
+; extends
+
+; github actions
+([
+  (string_scalar)
+  (block_scalar)
+  (double_quote_scalar)
+  (single_quote_scalar)
+] @injection.content
+  (#lua-match? @injection.content "[$]{{.*}}")
+  (#set! injection.language "ghactions"))
+```
+
+4. Run `:TSUpdate` from neovim.
+
+NOTE: these instructions are based upon the `main` branch of `nvim-treesitter`.
+
+## Bindings Installation (for development)
+
+Bindings are published to `pypi`, `npm`, and `crates.io` as `tree-sitter-ghactions`.
+Wasm and source code artifacts are published to [GitHub releases](https://github.com/rmuir/tree-sitter-ghactions/releases)
+
+## Screenshot of highlights
+
+![Syntax highlighting screenshot](https://github.com/user-attachments/assets/0c1f34bb-6f02-4175-9495-97e6fa51334a)

tree_sitter_ghactions-0.1.2.dist-info/RECORD

@@ -0,0 +1,10 @@
+tree_sitter_ghactions/__init__.py,sha256=CvrVfL3drWmCCF9umgQ-Q6XlVTV-ez90wrb-o8tV-yo,1286
+tree_sitter_ghactions/__init__.pyi,sha256=A4sjCd_1pfiO7sWEnEjeKpZC2ximaBTNAhQX7OuSF2Y,245
+tree_sitter_ghactions/_binding.abi3.so,sha256=-kcOI79nhFdw7NiezbKOFuiNzXSMCbLtI6cGm9UTA3E,44696
+tree_sitter_ghactions/binding.c,sha256=0awVAXQAOfAxpD1ztUzMUYyoU53i7oG2U_tB0NdQ2YE,869
+tree_sitter_ghactions/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tree_sitter_ghactions/queries/highlights.scm,sha256=teqXPqTc2R_uUyILMnRBx3sYITIuCLBqfcdUpIWAKi4,1546
+tree_sitter_ghactions-0.1.2.dist-info/METADATA,sha256=m-ltix8RxIGiZZYEBA2UGys5RZcdDm7GESXxU5YOUeY,2252
+tree_sitter_ghactions-0.1.2.dist-info/WHEEL,sha256=RLTeeIVGGszrHIp46_PGEkqkg0ZOBqBbIDNIwOdtd7A,111
+tree_sitter_ghactions-0.1.2.dist-info/top_level.txt,sha256=bxtb4PZqFiemjR4iQZ1pgQlgmcOMsMKJm22F4Gqm_MQ,31
+tree_sitter_ghactions-0.1.2.dist-info/RECORD,,

tree_sitter_ghactions-0.1.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp310-abi3-musllinux_1_2_x86_64
+

tree_sitter_ghactions-0.1.2.dist-info/top_level.txt

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