openscad-parser 0.9.2__py3-none-any.whl

openscad_parser/__init__.py

@@ -0,0 +1,484 @@
+#######################################################################
+# Arpeggio PEG Grammar for OpenSCAD
+#######################################################################
+
+from __future__ import unicode_literals
+
+from arpeggio import (
+    ParserPython, Optional, ZeroOrMore, OneOrMore, EOF, Kwd, Not,  # And,
+    RegExMatch as _
+)
+
+
+# --- The parser ---
+
+def getOpenSCADParser(reduce_tree=False, debug=False):
+    return ParserPython(
+        openscad_language, comment, reduce_tree=reduce_tree,
+        memoization=True, autokwd=True, debug=debug
+        )
+
+
+# --- OpenSCAD language parsing root ---
+
+def openscad_language():
+    return (ZeroOrMore([use_statement, include_statement, statement]), EOF)
+
+
+# --- Lexical and basic rules ---
+
+def comment_line():
+    return _(r'//.*?$', str_repr='comment')
+
+
+def comment_multi():
+    return _(r'(?ms)/\*.*?\*/', str_repr='comment')
+
+
+def comment():
+    return [comment_line, comment_multi]
+
+
+def TOK_STRING():
+    return ('"', _(r'([^"\\]|\\.|\\$)*', str_repr='string'), '"')
+
+
+def TOK_NUMBER():
+    return _(
+        r'[+-]?(0x[0-9A-Fa-f]+|'
+        r'\d+([.]\d*)?([eE][+-]?\d+)?'
+        r'|[.]\d+([eE][+-]?\d+)?)'
+        )
+
+
+def TOK_ID():
+    return _(r"(\$?[_A-Za-z][A-Za-z0-9_]*)", str_repr='string')
+
+
+def TOK_COMMA():
+    return ','
+
+
+def TOK_LOGICAL_OR():
+    return "||"
+
+
+def TOK_LOGICAL_AND():
+    return "&&"
+
+
+def TOK_LOGICAL_NOT():
+    return "!"
+
+
+def TOK_BINARY_OR():
+    return ("|", Not('|'))
+
+
+def TOK_BINARY_AND():
+    return ("&", Not('&'))
+
+
+def TOK_BINARY_NOT():
+    return "~"
+
+
+def TOK_BINARY_SHIFT_LEFT():
+    return "<<"
+
+
+def TOK_BINARY_SHIFT_RIGHT():
+    return ">>"
+
+
+def TOK_GT():
+    return (">", Not('>', '='))
+
+
+def TOK_LT():
+    return ("<", Not('<', '='))
+
+
+def TOK_GTE():
+    return ">="
+
+
+def TOK_LTE():
+    return "<="
+
+
+def TOK_EQUAL():
+    return "=="
+
+
+def TOK_NOTEQUAL():
+    return "!="
+
+
+def TOK_ASSIGN():
+    return ('=', Not('='))
+
+
+def TOK_USE():
+    return Kwd('use')
+
+
+def TOK_INCLUDE():
+    return Kwd('include')
+
+
+def TOK_MODULE():
+    return Kwd('module')
+
+
+def TOK_FUNCTION():
+    return Kwd('function')
+
+
+def TOK_IF():
+    return Kwd('if')
+
+
+def TOK_ELSE():
+    return Kwd('else')
+
+
+def TOK_FOR():
+    return Kwd('for')
+
+
+def TOK_INTERSECTION_FOR():
+    return Kwd('intersection_for')
+
+
+def TOK_LET():
+    return Kwd('let')
+
+
+def TOK_ASSERT():
+    return Kwd('assert')
+
+
+def TOK_ECHO():
+    return Kwd('echo')
+
+
+def TOK_EACH():
+    return Kwd('each')
+
+
+def TOK_TRUE():
+    return Kwd('true')
+
+
+def TOK_FALSE():
+    return Kwd('false')
+
+
+def TOK_UNDEF():
+    return Kwd('undef')
+
+
+# --- Grammar rules ---
+
+def use_statement():
+    return (TOK_USE, '<', _(r'[^>]+'), '>')
+
+
+def include_statement():
+    return (TOK_INCLUDE, '<', _(r'[^>]+'), '>')
+
+
+def statement():
+    return [
+            ";",
+            ('{', ZeroOrMore(statement), '}'),
+            module_definition,
+            function_definition,
+            module_instantiation,
+            assignment
+        ]
+
+
+def module_definition():
+    return (TOK_MODULE, TOK_ID, '(', parameters, ')', statement)
+
+
+def function_definition():
+    return (TOK_FUNCTION, TOK_ID, '(', parameters, ')', TOK_ASSIGN, expr, ';')
+
+
+def assignment():
+    return (TOK_ID, TOK_ASSIGN, expr, ';')
+
+
+def module_instantiation():
+    return [
+            modifier_show_only,
+            modifier_highlight,
+            modifier_background,
+            modifier_disable,
+            ifelse_statement,
+            single_module_instantiation
+        ]
+
+
+def modifier_show_only():
+    return ('!', module_instantiation)
+
+
+def modifier_highlight():
+    return ('#', module_instantiation)
+
+
+def modifier_background():
+    return ('%', module_instantiation)
+
+
+def modifier_disable():
+    return ('*', module_instantiation)
+
+
+def ifelse_statement():
+    return [
+            (TOK_IF, '(', expr, ')', child_statement,
+                TOK_ELSE, child_statement),
+            (TOK_IF, '(', expr, ')', child_statement)
+        ]
+
+
+def single_module_instantiation():
+    return [
+            modular_for,
+            modular_intersection_for,
+            modular_let,
+            modular_assert,
+            modular_echo,
+            modular_call
+        ]
+
+
+def child_statement():
+    return [
+            ';',
+            ('{', ZeroOrMore([assignment, child_statement]), '}'),
+            module_instantiation
+        ]
+
+
+# --- Modules and Module Control Structures ---
+
+def modular_for():
+    return [
+            (TOK_FOR, "(", assignments_expr, ")", child_statement),
+            (TOK_FOR, "(", assignments_expr, ";", expr, ";", assignments_expr,
+                ")", child_statement)
+        ]
+
+
+def modular_intersection_for():
+    return (TOK_INTERSECTION_FOR, "(", assignments_expr, ")", child_statement)
+
+
+def modular_let():
+    return (TOK_LET, "(", assignments_expr, ")", child_statement)
+
+
+def modular_assert():
+    return (TOK_ASSERT, "(", arguments, ")", child_statement)
+
+
+def modular_echo():
+    return (TOK_ECHO, "(", arguments, ")", child_statement)
+
+
+def modular_call():
+    return (TOK_ID, "(", arguments, ")", child_statement)
+
+
+# --- Parameter and argument lists ---
+
+def parameters():
+    return (ZeroOrMore(parameter, sep=TOK_COMMA), ZeroOrMore(TOK_COMMA))
+
+
+def parameter():
+    return [
+            (TOK_ID, TOK_ASSIGN, expr),
+            TOK_ID
+        ]
+
+
+def arguments():
+    return (ZeroOrMore(argument, sep=TOK_COMMA), Optional(TOK_COMMA))
+
+
+def argument():
+    return [
+            (TOK_ID, TOK_ASSIGN, expr),
+            expr
+        ]
+
+
+# --- Expressions ---
+
+def assignments_expr():
+    return (ZeroOrMore(assignment_expr, sep=TOK_COMMA), Optional(TOK_COMMA))
+
+
+def assignment_expr():
+    return (TOK_ID, TOK_ASSIGN, expr)
+
+
+def expr():
+    return [
+            let_expr,
+            assert_expr,
+            echo_expr,
+            funclit_def,
+            ternary_expr,
+            prec_logical_or
+        ]
+
+
+def let_expr():
+    return (TOK_LET, '(', assignments_expr, ')', expr)
+
+
+def assert_expr():
+    return (TOK_ASSERT, '(', arguments, ')', Optional(expr))
+
+
+def echo_expr():
+    return (TOK_ECHO, '(', arguments, ')', Optional(expr))
+
+
+def funclit_def():
+    return (TOK_FUNCTION, '(', parameters, ')', expr)
+
+
+def ternary_expr():
+    return (prec_logical_or, '?', expr, ':', expr)
+
+
+def prec_logical_or():
+    return OneOrMore(prec_logical_and, sep=TOK_LOGICAL_OR)
+
+
+def prec_logical_and():
+    return OneOrMore(prec_equality, sep=TOK_LOGICAL_AND)
+
+
+def prec_equality():
+    return OneOrMore(prec_comparison, sep=[TOK_EQUAL, TOK_NOTEQUAL])
+
+
+def prec_comparison():
+    return OneOrMore(prec_binary_or, sep=[TOK_LTE, TOK_GTE, TOK_LT, TOK_GT])
+
+
+def prec_binary_or():
+    return OneOrMore(prec_binary_and, sep=TOK_BINARY_OR)
+
+
+def prec_binary_and():
+    return OneOrMore(prec_binary_shift, sep=TOK_BINARY_AND)
+
+
+def prec_binary_shift():
+    return OneOrMore(prec_addition, sep=[TOK_BINARY_SHIFT_LEFT, TOK_BINARY_SHIFT_RIGHT])
+
+
+def prec_addition():
+    return OneOrMore(prec_multiplication, sep=['+', '-'])
+
+
+def prec_multiplication():
+    return OneOrMore(prec_unary, sep=['*', '/', '%'])
+
+
+def prec_unary():
+    return (ZeroOrMore(['+', '-', TOK_LOGICAL_NOT, TOK_BINARY_NOT]), prec_exponent)
+
+
+def prec_exponent():
+    return [
+        (prec_call, '^', prec_unary),
+        prec_call
+    ]
+
+
+def prec_call():
+    return (primary, ZeroOrMore([call_expr, lookup_expr, member_expr]))
+
+
+def call_expr():
+    return ('(', arguments, ')')
+
+
+def lookup_expr():
+    return ('[', expr, ']')
+
+
+def member_expr():
+    return ('.', TOK_ID)
+
+
+def primary():
+    return [
+            ('(', expr, ')'),
+            ('[', expr, ':', expr, Optional(':', expr), ']'),
+            ('[', vector_elements, Optional(TOK_COMMA), ']'),
+            TOK_UNDEF,
+            TOK_TRUE,
+            TOK_FALSE,
+            TOK_STRING,
+            TOK_NUMBER,
+            TOK_ID
+        ]
+
+
+# --- Vector and list comprehension ---
+
+def vector_elements():
+    return ZeroOrMore(vector_element, sep=TOK_COMMA)
+
+
+def vector_element():
+    return [listcomp_elements, expr]
+
+
+def listcomp_elements():
+    return [
+            ('(', listcomp_elements, ')'),
+            listcomp_let,
+            listcomp_each,
+            listcomp_for,
+            listcomp_ifelse,
+        ]
+
+
+def listcomp_let():
+    return (TOK_LET, '(', assignments_expr, ')', listcomp_elements)
+
+
+def listcomp_each():
+    return (TOK_EACH, vector_element)
+
+
+def listcomp_for():
+    return [
+            (TOK_FOR, '(', assignments_expr, ';', expr, ';',
+                assignments_expr, ')', vector_element),
+            (TOK_FOR, '(', assignments_expr, ')', vector_element),
+        ]
+
+
+def listcomp_ifelse():
+    return [
+            (TOK_IF, '(', expr, ')', vector_element, TOK_ELSE, vector_element),
+            (TOK_IF, '(', expr, ')', vector_element)
+        ]
+
+
+# vim: set ts=4 sw=4 expandtab:

openscad_parser-0.9.2.dist-info/METADATA

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: openscad_parser
+Version: 0.9.2
+Summary: A PEG parser to read OpenSCAD language source code.
+Author-email: Revar Desmera <revarbat@gmail.com>
+Maintainer-email: Revar Desmera <revarbat@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/belfryscad/openscad_parser
+Project-URL: Repository, https://github.com/belfryscad/openscad_parser
+Project-URL: Bug Tracker, https://github.com/belfryscad/openscad_parser/issues
+Project-URL: Releases, https://github.com/belfryscad/openscad_parser/releases
+Project-URL: Usage, https://github.com/belfryscad/openscad_parser/README.rst
+Project-URL: Documentation, https://github.com/belfryscad/openscad_parser/WRITING_DOCS.md
+Keywords: openscad,openscad parser,parser
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Manufacturing
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Artistic Software
+Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Classifier: Topic :: Multimedia :: Graphics :: 3D Rendering
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: arpeggio>=2.0.3
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Dynamic: license-file

openscad_parser-0.9.2.dist-info/RECORD

@@ -0,0 +1,6 @@
+openscad_parser/__init__.py,sha256=hKNgLYMjgrwrIlLC2EnxkTjw2cQaKhtZu2e9ZITHUSI,8813
+openscad_parser-0.9.2.dist-info/licenses/LICENSE,sha256=N5Lw8pkdPzzYkAvuqPTtqP76sRGLHnVYrOKhY9w4aWo,1082
+openscad_parser-0.9.2.dist-info/METADATA,sha256=FeWCZVTZWb9-gQNBs4ZTKe2SYHM2NpLyhzZCF3upgoc,1595
+openscad_parser-0.9.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+openscad_parser-0.9.2.dist-info/top_level.txt,sha256=Jm01hgOXBGEBiYRGDw9rc3PArzW1ER15xoBoHC-dQT4,16
+openscad_parser-0.9.2.dist-info/RECORD,,

openscad_parser-0.9.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

openscad_parser-0.9.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Belfry OpenSCAD Libraries
+
+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.

openscad_parser-0.9.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+openscad_parser