tree-sitter-mlua 0.1.0__tar.gz

tree_sitter_mlua-0.1.0/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 Munif Tanjim
+
+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_mlua-0.1.0/PKG-INFO

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: tree-sitter-mlua
+Version: 0.1.0
+Summary: MapleStory Worlds .mlua grammar for tree-sitter
+Author: taerim0
+Author-email: Munif Tanjim <hello@muniftanjim.dev>
+License: MIT
+Project-URL: Homepage, https://github.com/taerim0/tree-sitter-mlua
+Keywords: incremental,parsing,tree-sitter,mlua
+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.md
+Provides-Extra: core
+Requires-Dist: tree-sitter~=0.24; extra == "core"
+Dynamic: license-file
+
+# tree-sitter-mlua
+
+[![CI][ci]](https://github.com/taerim0/tree-sitter-mlua/actions/workflows/ci.yml)
+
+Tree-sitter grammar for **MapleStory Worlds' `.mlua` script/interface format**.
+
+`.mlua` is a class-based DSL layered on top of a Lua-like expression/statement
+language: the top level is one `script Name [extends Base] ... end`
+declaration containing `property`/`method`/`member`/`emitter`/`handler`/
+`constructor`/`operator` members (each optionally preceded by `@Decorator`
+annotations), and method **bodies** are ordinary Lua statements/expressions.
+`.d.mlua` files (native-API declarations, no method bodies) parse with the
+same grammar.
+
+There was no public tree-sitter grammar for this format anywhere at the time
+this was written — confirmed by inspecting real MapleStory Worlds project
+`.mlua` files directly, not assumed from documentation alone.
+
+## Acknowledgement
+
+This grammar is forked from [tree-sitter-grammars/tree-sitter-lua][ts-lua]
+(MIT licensed, by Munif Tanjim) — `.mlua` method bodies are real Lua, so the
+statement/expression/string/comment/number rules and the external scanner are
+reused near-verbatim from that project rather than re-derived from scratch.
+Only the top-level rules (`chunk`, `script`/`property`/`method`/`member`/
+`emitter`/`handler`/`constructor`/`operator` declarations, decorators, and the
+`type` rule for property/parameter/return types, including generics like
+`List<Vector2>`) are new.
+
+[ts-lua]: https://github.com/tree-sitter-grammars/tree-sitter-lua
+
+[ci]: https://img.shields.io/github/actions/workflow/status/taerim0/tree-sitter-mlua/ci.yml?logo=github&label=CI

tree_sitter_mlua-0.1.0/README.md

@@ -0,0 +1,32 @@
+# tree-sitter-mlua
+
+[![CI][ci]](https://github.com/taerim0/tree-sitter-mlua/actions/workflows/ci.yml)
+
+Tree-sitter grammar for **MapleStory Worlds' `.mlua` script/interface format**.
+
+`.mlua` is a class-based DSL layered on top of a Lua-like expression/statement
+language: the top level is one `script Name [extends Base] ... end`
+declaration containing `property`/`method`/`member`/`emitter`/`handler`/
+`constructor`/`operator` members (each optionally preceded by `@Decorator`
+annotations), and method **bodies** are ordinary Lua statements/expressions.
+`.d.mlua` files (native-API declarations, no method bodies) parse with the
+same grammar.
+
+There was no public tree-sitter grammar for this format anywhere at the time
+this was written — confirmed by inspecting real MapleStory Worlds project
+`.mlua` files directly, not assumed from documentation alone.
+
+## Acknowledgement
+
+This grammar is forked from [tree-sitter-grammars/tree-sitter-lua][ts-lua]
+(MIT licensed, by Munif Tanjim) — `.mlua` method bodies are real Lua, so the
+statement/expression/string/comment/number rules and the external scanner are
+reused near-verbatim from that project rather than re-derived from scratch.
+Only the top-level rules (`chunk`, `script`/`property`/`method`/`member`/
+`emitter`/`handler`/`constructor`/`operator` declarations, decorators, and the
+`type` rule for property/parameter/return types, including generics like
+`List<Vector2>`) are new.
+
+[ts-lua]: https://github.com/tree-sitter-grammars/tree-sitter-lua
+
+[ci]: https://img.shields.io/github/actions/workflow/status/taerim0/tree-sitter-mlua/ci.yml?logo=github&label=CI

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

@@ -0,0 +1,43 @@
+"""MapleStory Worlds .mlua 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_mlua-0.1.0/bindings/python/tree_sitter_mlua/__init__.pyi

@@ -0,0 +1,9 @@
+from typing import Final
+from typing_extensions import CapsuleType
+
+HIGHLIGHTS_QUERY: Final[str]
+INJECTIONS_QUERY: Final[str]
+LOCALS_QUERY: Final[str]
+TAGS_QUERY: Final[str]
+
+def language() -> CapsuleType: ...

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

@@ -0,0 +1,35 @@
+#include <Python.h>
+
+typedef struct TSLanguage TSLanguage;
+
+TSLanguage *tree_sitter_mlua(void);
+
+static PyObject* _binding_language(PyObject *Py_UNUSED(self), PyObject *Py_UNUSED(args)) {
+    return PyCapsule_New(tree_sitter_mlua(), "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_mlua-0.1.0/bindings/python/tree_sitter_mlua.egg-info/PKG-INFO

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: tree-sitter-mlua
+Version: 0.1.0
+Summary: MapleStory Worlds .mlua grammar for tree-sitter
+Author: taerim0
+Author-email: Munif Tanjim <hello@muniftanjim.dev>
+License: MIT
+Project-URL: Homepage, https://github.com/taerim0/tree-sitter-mlua
+Keywords: incremental,parsing,tree-sitter,mlua
+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.md
+Provides-Extra: core
+Requires-Dist: tree-sitter~=0.24; extra == "core"
+Dynamic: license-file
+
+# tree-sitter-mlua
+
+[![CI][ci]](https://github.com/taerim0/tree-sitter-mlua/actions/workflows/ci.yml)
+
+Tree-sitter grammar for **MapleStory Worlds' `.mlua` script/interface format**.
+
+`.mlua` is a class-based DSL layered on top of a Lua-like expression/statement
+language: the top level is one `script Name [extends Base] ... end`
+declaration containing `property`/`method`/`member`/`emitter`/`handler`/
+`constructor`/`operator` members (each optionally preceded by `@Decorator`
+annotations), and method **bodies** are ordinary Lua statements/expressions.
+`.d.mlua` files (native-API declarations, no method bodies) parse with the
+same grammar.
+
+There was no public tree-sitter grammar for this format anywhere at the time
+this was written — confirmed by inspecting real MapleStory Worlds project
+`.mlua` files directly, not assumed from documentation alone.
+
+## Acknowledgement
+
+This grammar is forked from [tree-sitter-grammars/tree-sitter-lua][ts-lua]
+(MIT licensed, by Munif Tanjim) — `.mlua` method bodies are real Lua, so the
+statement/expression/string/comment/number rules and the external scanner are
+reused near-verbatim from that project rather than re-derived from scratch.
+Only the top-level rules (`chunk`, `script`/`property`/`method`/`member`/
+`emitter`/`handler`/`constructor`/`operator` declarations, decorators, and the
+`type` rule for property/parameter/return types, including generics like
+`List<Vector2>`) are new.
+
+[ts-lua]: https://github.com/tree-sitter-grammars/tree-sitter-lua
+
+[ci]: https://img.shields.io/github/actions/workflow/status/taerim0/tree-sitter-mlua/ci.yml?logo=github&label=CI

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+

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

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

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

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

tree_sitter_mlua-0.1.0/pyproject.toml

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

tree_sitter_mlua-0.1.0/queries/highlights.scm

@@ -0,0 +1,86 @@
+; Keywords
+
+[
+  "script"
+  "extends"
+  "end"
+  "property"
+  "member"
+  "constructor"
+  "operator"
+  "static"
+  "readonly"
+] @keyword
+
+["method" "emitter" "handler" "function" "local"] @keyword.function
+
+"return" @keyword.return
+
+[(break_statement) (continue_statement)] @keyword
+"goto" @keyword
+
+(label_statement) @label
+
+["if" "then" "elseif" "else"] @keyword.conditional
+
+["while" "repeat" "until" "for" "in" "do"] @keyword.repeat
+
+"@" @punctuation.special
+
+; Types
+
+(type name: (identifier) @type)
+(script_declaration name: (identifier) @type)
+
+; Declarations
+
+(decorator name: (identifier) @attribute)
+(property_declaration name: (identifier) @property)
+(member_declaration name: (identifier) @constant)
+(method_declaration name: (identifier) @function.method)
+(constructor_declaration name: (identifier) @constructor)
+(operator_declaration name: (identifier) @function.method)
+(emitter_declaration name: (identifier) @function.method)
+(handler_declaration name: (identifier) @function.method)
+(parameter name: (identifier) @variable.parameter)
+
+(call
+  function: (variable name: (identifier) @function.call))
+(call
+  function: (variable field: (identifier) @function.method.call))
+
+; Variables
+
+((identifier) @variable.builtin
+  (#eq? @variable.builtin "self"))
+
+((identifier) @constant
+  (#match? @constant "^[A-Z][A-Z_0-9]*$"))
+
+(identifier) @variable
+
+(variable
+  field: (identifier) @field)
+
+; Operators and punctuation
+
+(binary_expression operator: _ @operator)
+(unary_expression operator: _ @operator)
+(compound_assignment_statement operator: _ @operator)
+
+"=" @operator
+
+["and" "or" "not"] @keyword.operator
+
+[";" ":" "," "." "::"] @punctuation.delimiter
+
+["(" ")" "[" "]" "{" "}" "<" ">"] @punctuation.bracket
+
+; Literals
+
+(number) @number
+(string) @string
+(comment) @comment
+[(true) (false)] @boolean
+(nil) @constant.builtin
+(vararg_expression) @constant

tree_sitter_mlua-0.1.0/queries/injections.scm

@@ -0,0 +1,4 @@
+; No language injections are defined for .mlua yet -- MSW's mlua has no
+; FFI/cdef-style embedded-language convention the way LuaJIT does, which is
+; what the upstream tree-sitter-lua injections.scm this was forked from
+; existed for.

tree_sitter_mlua-0.1.0/queries/locals.scm

@@ -0,0 +1,46 @@
+; Scopes
+[
+  (chunk)
+  (script_declaration)
+  (do_statement)
+  (while_statement)
+  (repeat_statement)
+  (if_statement)
+  (for_numeric_statement)
+  (for_generic_statement)
+  (method_declaration)
+  (constructor_declaration)
+  (operator_declaration)
+  (emitter_declaration)
+  (handler_declaration)
+  (function_definition)
+  (function_definition_statement)
+  (local_function_definition_statement)
+] @local.scope
+
+; Definitions
+(local_variable_declaration
+  (variable_list
+    (variable name: (identifier) @local.definition)))
+
+(for_generic_statement
+  left: (variable_list
+    (identifier) @local.definition))
+
+(for_numeric_statement
+  name: (identifier) @local.definition)
+
+(parameter
+  name: (identifier) @local.definition)
+
+(property_declaration
+  name: (identifier) @local.definition)
+
+(method_declaration
+  name: (identifier) @local.definition)
+
+(constructor_declaration
+  name: (identifier) @local.definition)
+
+; References
+(identifier) @local.reference

tree_sitter_mlua-0.1.0/queries/tags.scm

@@ -0,0 +1,32 @@
+(script_declaration
+  name: (identifier) @name) @definition.class
+
+(method_declaration
+  name: (identifier) @name) @definition.method
+
+(constructor_declaration
+  name: (identifier) @name) @definition.method
+
+(operator_declaration
+  name: (identifier) @name) @definition.method
+
+(emitter_declaration
+  name: (identifier) @name) @definition.method
+
+(handler_declaration
+  name: (identifier) @name) @definition.method
+
+(function_definition_statement
+  name: (identifier) @name) @definition.function
+
+(local_function_definition_statement
+  name: (identifier) @name) @definition.function
+
+(property_declaration
+  name: (identifier) @name) @definition.property
+
+(member_declaration
+  name: (identifier) @name) @definition.constant
+
+(call
+  function: (variable name: (identifier) @name)) @reference.call

tree_sitter_mlua-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tree_sitter_mlua-0.1.0/setup.py

@@ -0,0 +1,77 @@
+from os import path
+from sysconfig import get_config_var
+
+from setuptools import Extension, find_packages, setup
+from setuptools.command.build import build
+from setuptools.command.build_ext import build_ext
+from setuptools.command.egg_info import egg_info
+from wheel.bdist_wheel import bdist_wheel
+
+
+class Build(build):
+    def run(self):
+        if path.isdir("queries"):
+            dest = path.join(self.build_lib, "tree_sitter_mlua", "queries")
+            self.copy_tree("queries", dest)
+        super().run()
+
+
+class BuildExt(build_ext):
+    def build_extension(self, ext: Extension):
+        if self.compiler.compiler_type != "msvc":
+            ext.extra_compile_args = ["-std=c11", "-fvisibility=hidden"]
+        else:
+            ext.extra_compile_args = ["/std:c11", "/utf-8"]
+        if path.exists("src/scanner.c"):
+            ext.sources.append("src/scanner.c")
+        if ext.py_limited_api:
+            ext.define_macros.append(("Py_LIMITED_API", "0x030A0000"))
+        super().build_extension(ext)
+
+
+class BdistWheel(bdist_wheel):
+    def get_tag(self):
+        python, abi, platform = super().get_tag()
+        if python.startswith("cp") and not get_config_var("Py_GIL_DISABLED"):
+            python, abi = "cp310", "abi3"
+        return python, abi, platform
+
+
+class EggInfo(egg_info):
+    def find_sources(self):
+        super().find_sources()
+        self.filelist.recursive_include("queries", "*.scm")
+        self.filelist.include("src/tree_sitter/*.h")
+
+
+setup(
+    packages=find_packages("bindings/python"),
+    package_dir={"": "bindings/python"},
+    package_data={
+        "tree_sitter_mlua": ["*.pyi", "py.typed"],
+        "tree_sitter_mlua.queries": ["*.scm"],
+    },
+    ext_package="tree_sitter_mlua",
+    ext_modules=[
+        Extension(
+            name="_binding",
+            sources=[
+                "bindings/python/tree_sitter_mlua/binding.c",
+                "src/parser.c",
+            ],
+            define_macros=[
+                ("PY_SSIZE_T_CLEAN", None),
+                ("TREE_SITTER_HIDE_SYMBOLS", None),
+            ],
+            include_dirs=["src"],
+            py_limited_api=not get_config_var("Py_GIL_DISABLED"),
+        )
+    ],
+    cmdclass={
+        "build": Build,
+        "build_ext": BuildExt,
+        "bdist_wheel": BdistWheel,
+        "egg_info": EggInfo,
+    },
+    zip_safe=False
+)