pyscript-programming-language 1.12.4__tar.gz → 1.12.5__tar.gz

{pyscript_programming_language-1.12.4/pyscript_programming_language.egg-info → pyscript_programming_language-1.12.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyscript-programming-language
-Version: 1.12.4
+Version: 1.12.5
 Summary: PyScript Programming Language
 Home-page: https://azzammuhyala.github.io/pyscript
 Author: azzammuhyala

pyscript_programming_language-1.12.5/changelog.md

@@ -0,0 +1,14 @@
+# Change Log
+
+## [1.12.5] - 12/03/2026
+
+### Added
+- Type hints in almost all core implementations and built-in modules.
+- _etc._
+
+### Fixed
+- **Fixed some bugs**.
+- `return` statements will not consume the following line, including `as`, `assert`, and `throw`/`raise`.
+- Changed the token type name separator `-` to `_`.
+- Parser improvements.
+- _etc._

{pyscript_programming_language-1.12.4 → pyscript_programming_language-1.12.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pyscript-programming-language"
-version = "1.12.4"
+version = "1.12.5"
 description = "PyScript Programming Language"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.10"

{pyscript_programming_language-1.12.4 → pyscript_programming_language-1.12.5}/pyscript/__main__.py

@@ -166,11 +166,11 @@ def argument_error(argument, message):
 argv = sys.argv[1:]
 
 file_idx = sum(1 for arg in argv if arg.startswith('-'))
-end_idx = argv.index('--', 0, file_idx) if '--' in argv[:file_idx] else -1
-end_com = file_idx if end_idx == -1 else end_idx
-arg_com = argv[:end_com]
-com_idx = argv.index('-c', 0, end_com)        if '-c'        in arg_com else \
-         (argv.index('--command', 0, end_com) if '--command' in arg_com else -1)
+end_idx  = argv.index('--', 0, file_idx) if '--' in argv[:file_idx] else -1
+end_com  = file_idx if end_idx == -1 else end_idx
+arg_com  = argv[:end_com]
+com_idx  = argv.index('-c', 0, end_com)        if '-c'        in arg_com else \
+          (argv.index('--command', 0, end_com) if '--command' in arg_com else -1)
 
 args = parser.parse_args(argv if com_idx == -1 else argv[:com_idx + 2])
 arg = args.arg if com_idx == -1 else argv[com_idx + 2:]
@@ -213,11 +213,11 @@ code = 0
 flags = DEFAULT
 
 for condition, flag in [
-    (args.notebook or USE_NOTEBOOK,                                          NOTEBOOK),
-    (args.debug,                                                             DEBUG),
+    (args.notebook           or USE_NOTEBOOK,                                NOTEBOOK),
     (args.classic_line_shell or is_environ(ENV_PYSCRIPT_CLASSIC_LINE_SHELL), CLASSIC_LINE_SHELL),
     (args.no_color           or is_environ('NO_COLOR'),                      NO_COLOR),
     (args.no_color_prompt    or is_environ(ENV_PYSCRIPT_NO_COLOR_PROMPT),    NO_COLOR_PROMPT),
+    (args.debug,                                                             DEBUG),
     (args.q,                                                                 DONT_SHOW_BANNER_ON_SHELL)
 ]:
     if condition:

{pyscript_programming_language-1.12.4 → pyscript_programming_language-1.12.5}/pyscript/core/analyzer.py

@@ -3,7 +3,7 @@ from .checks import is_list
 from .constants import TOKENS, DEFAULT
 from .context import PysContext
 from .exceptions import PysTraceback
-from .nodes import PysNode, PysKeywordNode, PysIdentifierNode, PysAttributeNode, PysSubscriptNode
+from .nodes import *
 from .position import PysPosition
 from .utils.decorators import typechecked
 
@@ -37,7 +37,7 @@ class PysAnalyzer(Pys):
         self.visit(self.node)
         return self.error
 
-    def throw(self, message, position):
+    def throw(self, message: str, position: PysPosition) -> None:
         if self.error is None:
             self.error = PysTraceback(
                 SyntaxError(message),
@@ -50,12 +50,12 @@ class PysAnalyzer(Pys):
                 position
             )
 
-    def visit(self, node):
+    def visit(self, node: PysNode) -> None:
         func = getattr(self, 'visit_' + type(node).__name__.removeprefix('Pys'), None)
         if not self.error and func:
             func(node)
 
-    def visit_DictionaryNode(self, node):
+    def visit_DictionaryNode(self, node: PysDictionaryNode) -> None:
         for key, value in node.pairs:
 
             self.visit(key)
@@ -66,35 +66,35 @@ class PysAnalyzer(Pys):
             if self.error:
                 return
 
-    def visit_SetNode(self, node):
+    def visit_SetNode(self, node: PysSetNode) -> None:
         for element in node.elements:
             self.visit(element)
             if self.error:
                 return
 
-    def visit_ListNode(self, node):
+    def visit_ListNode(self, node: PysListNode) -> None:
         for element in node.elements:
             self.visit(element)
             if self.error:
                 return
 
-    def visit_TupleNode(self, node):
+    def visit_TupleNode(self, node: PysTupleNode) -> None:
         for element in node.elements:
             self.visit(element)
             if self.error:
                 return
 
-    def visit_AttributeNode(self, node):
+    def visit_AttributeNode(self, node: PysAttributeNode) -> None:
         self.visit(node.target)
 
-    def visit_SubscriptNode(self, node):
+    def visit_SubscriptNode(self, node: PysSubscriptNode) -> None:
         self.visit(node.target)
         if self.error:
             return
 
         self.visit_slice_SubscriptNode(node.slice)
 
-    def visit_CallNode(self, node):
+    def visit_CallNode(self, node: PysCallNode) -> None:
         self.visit(node.target)
         if self.error:
             return
@@ -118,13 +118,13 @@ class PysAnalyzer(Pys):
             if self.error:
                 return
 
-    def visit_ChainOperatorNode(self, node):
+    def visit_ChainOperatorNode(self, node: PysChainOperatorNode) -> None:
         for expression in node.expressions:
             self.visit(expression)
             if self.error:
                 return
 
-    def visit_TernaryOperatorNode(self, node):
+    def visit_TernaryOperatorNode(self, node: PysTernaryOperatorNode) -> None:
         if node.style == 'general':
             self.visit(node.condition)
             if self.error:
@@ -147,27 +147,27 @@ class PysAnalyzer(Pys):
 
             self.visit(node.invalid)
 
-    def visit_BinaryOperatorNode(self, node):
+    def visit_BinaryOperatorNode(self, node: PysBinaryOperatorNode) -> None:
         self.visit(node.left)
         if self.error:
             return
 
         self.visit(node.right)
 
-    def visit_UnaryOperatorNode(self, node):
+    def visit_UnaryOperatorNode(self, node: PysUnaryOperatorNode) -> None:
         self.visit(node.value)
 
-    def visit_IncrementalNode(self, node):
-        operator = 'increase' if node.operand.type == TOKENS['DOUBLE-PLUS'] else 'decrease'
+    def visit_IncrementalNode(self, node: PysIncrementalNode) -> None:
+        operator = 'increase' if node.operand.type == TOKENS['DOUBLE_PLUS'] else 'decrease'
         self.visit_declaration_AssignmentNode(node.target, f"cannot {operator} literal", operator)
 
-    def visit_StatementsNode(self, node):
+    def visit_StatementsNode(self, node: PysStatementsNode) -> None:
         for element in node.body:
             self.visit(element)
             if self.error:
                 return
 
-    def visit_AssignmentNode(self, node):
+    def visit_AssignmentNode(self, node: PysAssignmentNode) -> None:
         self.visit_declaration_AssignmentNode(
             node.target,
             "cannot assign to expression here. Maybe you meant '==' instead of '='?"
@@ -177,7 +177,7 @@ class PysAnalyzer(Pys):
 
         self.visit(node.value)
 
-    def visit_IfNode(self, node):
+    def visit_IfNode(self, node: PysIfNode) -> None:
         for condition, body in node.cases_body:
             self.visit(condition)
             if self.error:
@@ -190,7 +190,7 @@ class PysAnalyzer(Pys):
         if node.else_body:
             self.visit(node.else_body)
 
-    def visit_SwitchNode(self, node):
+    def visit_SwitchNode(self, node: PysSwitchNode) -> None:
         self.visit(node.target)
         if self.error:
             return
@@ -213,7 +213,7 @@ class PysAnalyzer(Pys):
 
         self.in_switch -= 1
 
-    def visit_MatchNode(self, node):
+    def visit_MatchNode(self, node: PysMatchNode) -> None:
         if node.target:
             self.visit(node.target)
             if self.error:
@@ -231,7 +231,7 @@ class PysAnalyzer(Pys):
         if node.default:
             self.visit(node.default)
 
-    def visit_TryNode(self, node):
+    def visit_TryNode(self, node: PysTryNode) -> None:
         self.visit(node.body)
         if self.error:
             return
@@ -249,7 +249,7 @@ class PysAnalyzer(Pys):
         if node.finally_body:
             self.visit(node.finally_body)
 
-    def visit_WithNode(self, node):
+    def visit_WithNode(self, node: PysWithNode) -> None:
         for context, _ in node.contexts:
             self.visit(context)
             if self.error:
@@ -257,7 +257,7 @@ class PysAnalyzer(Pys):
 
         self.visit(node.body)
 
-    def visit_ForNode(self, node):
+    def visit_ForNode(self, node: PysForNode) -> None:
         if len(node.header) == 2:
             declaration, iteration = node.header
 
@@ -286,7 +286,7 @@ class PysAnalyzer(Pys):
         if node.else_body:
             self.visit(node.else_body)
 
-    def visit_WhileNode(self, node):
+    def visit_WhileNode(self, node: PysWhileNode) -> None:
         self.visit(node.condition)
         if self.error:
             return
@@ -302,7 +302,7 @@ class PysAnalyzer(Pys):
         if node.else_body:
             self.visit(node.else_body)
 
-    def visit_DoWhileNode(self, node):
+    def visit_DoWhileNode(self, node: PysDoWhileNode) -> None:
         self.in_loop += 1
 
         self.visit(node.body)
@@ -318,7 +318,7 @@ class PysAnalyzer(Pys):
         if node.else_body:
             self.visit(node.else_body)
 
-    def visit_RepeatNode(self, node):
+    def visit_RepeatNode(self, node: PysRepeatNode) -> None:
         self.in_loop += 1
 
         self.visit(node.body)
@@ -334,7 +334,7 @@ class PysAnalyzer(Pys):
         if node.else_body:
             self.visit(node.else_body)
 
-    def visit_ClassNode(self, node):
+    def visit_ClassNode(self, node: PysClassNode) -> None:
         for decorator in node.decorators:
             self.visit(decorator)
             if self.error:
@@ -363,7 +363,7 @@ class PysAnalyzer(Pys):
         self.in_function = in_function
         self.in_switch = in_switch
 
-    def visit_FunctionNode(self, node):
+    def visit_FunctionNode(self, node: PysFunctionNode) -> None:
         if node.constructor and self.in_class == 0:
             self.throw("constructor function outside of class", node.name.position)
             return
@@ -410,7 +410,7 @@ class PysAnalyzer(Pys):
         self.in_class = in_class
         self.in_switch = in_switch
 
-    def visit_GlobalNode(self, node):
+    def visit_GlobalNode(self, node: PysGlobalNode) -> None:
         if self.in_function == 0:
             self.throw("global outside of function", node.position)
 
@@ -419,7 +419,7 @@ class PysAnalyzer(Pys):
                 self.throw(f"name {identifier.value!r} is parameter and global", identifier.position)
                 return
 
-    def visit_ReturnNode(self, node):
+    def visit_ReturnNode(self, node: PysReturnNode) -> None:
         if self.in_function == 0:
             self.throw("return outside of function", node.position)
             return
@@ -427,7 +427,7 @@ class PysAnalyzer(Pys):
         if node.value:
             self.visit(node.value)
 
-    def visit_ThrowNode(self, node):
+    def visit_ThrowNode(self, node: PysThrowNode) -> None:
         self.visit(node.target)
         if self.error:
             return
@@ -435,7 +435,7 @@ class PysAnalyzer(Pys):
         if node.primary:
             self.visit(node.primary)
 
-    def visit_AssertNode(self, node):
+    def visit_AssertNode(self, node: PysAssertNode) -> None:
         self.visit(node.condition)
         if self.error:
             return
@@ -443,7 +443,7 @@ class PysAnalyzer(Pys):
         if node.message:
             self.visit(node.message)
 
-    def visit_DeleteNode(self, node):
+    def visit_DeleteNode(self, node: PysDeleteNode) -> None:
         for target in node.targets:
             type = target.__class__
 
@@ -469,43 +469,49 @@ class PysAnalyzer(Pys):
                 self.throw("cannot delete literal", target.position)
                 return
 
-    def visit_ContinueNode(self, node):
+    def visit_ContinueNode(self, node: PysContinueNode) -> None:
         if self.in_loop == 0:
             self.throw("continue outside of loop", node.position)
 
-    def visit_BreakNode(self, node):
+    def visit_BreakNode(self, node: PysBreakNode) -> None:
         if self.in_loop == 0 and self.in_switch == 0:
             self.throw("break outside of loop or switch case", node.position)
 
-    def visit_slice_SubscriptNode(self, nslice):
-        type = nslice.__class__
+    def visit_slice_SubscriptNode(self, node: PysNode | slice | tuple[PysNode | slice]) -> None:
+        type = node.__class__
 
         if type is slice:
-            if nslice.start is not None:
-                self.visit(nslice.start)
+            if node.start is not None:
+                self.visit(node.start)
                 if self.error:
                     return
 
-            if nslice.stop is not None:
-                self.visit(nslice.stop)
+            if node.stop is not None:
+                self.visit(node.stop)
                 if self.error:
                     return
 
-            if nslice.step is not None:
-                self.visit(nslice.step)
+            if node.step is not None:
+                self.visit(node.step)
                 if self.error:
                     return
 
         elif type is tuple:
-            for element in nslice:
+            for element in node:
                 self.visit_slice_SubscriptNode(element)
                 if self.error:
                     return
 
         else:
-            self.visit(nslice)
+            self.visit(node)
+
+    def visit_declaration_AssignmentNode(
+        self,
+        node: PysIdentifierNode | PysAttributeNode | PysSubscriptNode | PysSetNode | PysListNode | PysTupleNode,
+        message: str,
+        operator_name: str = 'assign'
+    ) -> None:
 
-    def visit_declaration_AssignmentNode(self, node, message, operator_name='assign'):
         type = node.__class__
 
         if type is PysAttributeNode:

{pyscript_programming_language-1.12.4 → pyscript_programming_language-1.12.5}/pyscript/core/cache.py

@@ -3,8 +3,8 @@ from .constants import PYSCRIPT_PATH, CORE_PATH, LIBRARIES_PATH, SITE_PACKAGES_P
 from .utils.debug import print_display, print_traceback, clear_shell
 from .utils.decorators import inheritable, singleton
 
-from typing import Literal
 from types import ModuleType
+from typing import Literal
 
 import sys
 

{pyscript_programming_language-1.12.4 → pyscript_programming_language-1.12.5}/pyscript/core/checks.py

@@ -26,7 +26,7 @@ is_python_extensions = frozenset([
 ]).__contains__
 
 is_equals = frozenset([
-    TOKENS['EQUAL'], TOKENS['EQUAL-COLON']
+    TOKENS['EQUAL'], TOKENS['EQUAL_COLON']
 ]).__contains__
 
 is_blacklist_python_builtins = frozenset([

{pyscript_programming_language-1.12.4 → pyscript_programming_language-1.12.5}/pyscript/core/constants.py

@@ -31,15 +31,15 @@ TOKENS = MappingProxyType({
     'IDENTIFIER': 2,
     'NUMBER': 3,
     'STRING': 4,
-    'NOT-IN': 5,
-    'IS-NOT': 6,
+    'NOT_IN': 5,
+    'IS_NOT': 6,
     'NEWLINE': ord('\n'),
     'EXCLAMATION': ord('!'),
     'COMMENT': ord('#'),
     'PERCENT': ord('%'),
     'AMPERSAND': ord('&'),
-    'RIGHT-PARENTHESIS': ord(')'),
-    'LEFT-PARENTHESIS': ord('('),
+    'RIGHT_PARENTHESIS': ord(')'),
+    'LEFT_PARENTHESIS': ord('('),
     'STAR': ord('*'),
     'PLUS': ord('+'),
     'COMMA': ord(','),
@@ -48,52 +48,52 @@ TOKENS = MappingProxyType({
     'SLASH': ord('/'),
     'COLON': ord(':'),
     'SEMICOLON': ord(';'),
-    'LESS-THAN': ord('<'),
+    'LESS_THAN': ord('<'),
     'EQUAL': ord('='),
-    'GREATER-THAN': ord('>'),
+    'GREATER_THAN': ord('>'),
     'QUESTION': ord('?'),
     'AT': ord('@'),
-    'LEFT-SQUARE': ord('['),
-    'RIGHT-SQUARE': ord(']'),
+    'LEFT_SQUARE': ord('['),
+    'RIGHT_SQUARE': ord(']'),
     'CIRCUMFLEX': ord('^'),
-    'LEFT-CURLY': ord('{'),
+    'LEFT_CURLY': ord('{'),
     'PIPE': ord('|'),
-    'RIGHT-CURLY': ord('}'),
+    'RIGHT_CURLY': ord('}'),
     'TILDE': ord('~'),
-    'DOUBLE-AMPERSAND': ord('&') + DOUBLE,
-    'DOUBLE-STAR': ord('*') + DOUBLE,
-    'DOUBLE-PLUS': ord('+') + DOUBLE,
-    'DOUBLE-MINUS': ord('-') + DOUBLE,
-    'DOUBLE-SLASH': ord('/') + DOUBLE,
-    'DOUBLE-LESS-THAN': ord('<') + DOUBLE,
-    'DOUBLE-EQUAL': ord('=') + DOUBLE,
-    'DOUBLE-GREATER-THAN': ord('>') + DOUBLE,
-    'DOUBLE-QUESTION': ord('?') + DOUBLE,
-    'DOUBLE-PIPE': ord('|') + DOUBLE,
-    'TRIPLE-DOT': ord('.') + TRIPLE,
-    'EQUAL-EXCLAMATION': ord('!') + WITH_EQUAL,
-    'EQUAL-PERCENT': ord('%') + WITH_EQUAL,
-    'EQUAL-AMPERSAND': ord('&') + WITH_EQUAL,
-    'EQUAL-STAR': ord('*') + WITH_EQUAL,
-    'EQUAL-PLUS': ord('+') + WITH_EQUAL,
-    'EQUAL-MINUS': ord('-') + WITH_EQUAL,
-    'EQUAL-SLASH': ord('/') + WITH_EQUAL,
-    'EQUAL-COLON': ord(':') + WITH_EQUAL,
-    'EQUAL-LESS-THAN': ord('<') + WITH_EQUAL,
-    'EQUAL-GREATER-THAN': ord('>') + WITH_EQUAL,
-    'EQUAL-AT': ord('@') + WITH_EQUAL,
-    'EQUAL-CIRCUMFLEX': ord('^') + WITH_EQUAL,
-    'EQUAL-PIPE': ord('|') + WITH_EQUAL,
-    'EQUAL-TILDE': ord('~') + WITH_EQUAL,
-    'EQUAL-DOUBLE-STAR': ord('*') + DOUBLE + WITH_EQUAL,
-    'EQUAL-DOUBLE-SLASH': ord('/') + DOUBLE + WITH_EQUAL,
-    'EQUAL-DOUBLE-LESS-THAN': ord('<') + DOUBLE + WITH_EQUAL,
-    'EQUAL-DOUBLE-GREATER-THAN': ord('>') + DOUBLE + WITH_EQUAL,
+    'DOUBLE_AMPERSAND': ord('&') + DOUBLE,
+    'DOUBLE_STAR': ord('*') + DOUBLE,
+    'DOUBLE_PLUS': ord('+') + DOUBLE,
+    'DOUBLE_MINUS': ord('-') + DOUBLE,
+    'DOUBLE_SLASH': ord('/') + DOUBLE,
+    'DOUBLE_LESS_THAN': ord('<') + DOUBLE,
+    'DOUBLE_EQUAL': ord('=') + DOUBLE,
+    'DOUBLE_GREATER_THAN': ord('>') + DOUBLE,
+    'DOUBLE_QUESTION': ord('?') + DOUBLE,
+    'DOUBLE_PIPE': ord('|') + DOUBLE,
+    'TRIPLE_DOT': ord('.') + TRIPLE,
+    'EQUAL_EXCLAMATION': ord('!') + WITH_EQUAL,
+    'EQUAL_PERCENT': ord('%') + WITH_EQUAL,
+    'EQUAL_AMPERSAND': ord('&') + WITH_EQUAL,
+    'EQUAL_STAR': ord('*') + WITH_EQUAL,
+    'EQUAL_PLUS': ord('+') + WITH_EQUAL,
+    'EQUAL_MINUS': ord('-') + WITH_EQUAL,
+    'EQUAL_SLASH': ord('/') + WITH_EQUAL,
+    'EQUAL_COLON': ord(':') + WITH_EQUAL,
+    'EQUAL_LESS_THAN': ord('<') + WITH_EQUAL,
+    'EQUAL_GREATER_THAN': ord('>') + WITH_EQUAL,
+    'EQUAL_AT': ord('@') + WITH_EQUAL,
+    'EQUAL_CIRCUMFLEX': ord('^') + WITH_EQUAL,
+    'EQUAL_PIPE': ord('|') + WITH_EQUAL,
+    'EQUAL_TILDE': ord('~') + WITH_EQUAL,
+    'EQUAL_DOUBLE_STAR': ord('*') + DOUBLE + WITH_EQUAL,
+    'EQUAL_DOUBLE_SLASH': ord('/') + DOUBLE + WITH_EQUAL,
+    'EQUAL_DOUBLE_LESS_THAN': ord('<') + DOUBLE + WITH_EQUAL,
+    'EQUAL_DOUBLE_GREATER_THAN': ord('>') + DOUBLE + WITH_EQUAL,
     'NONE': SPECIAL,
-    'MINUS-GREATER-THAN': ord('-') + SPECIAL,
-    'EQUAL-ARROW': ord('>') + SPECIAL,
-    'EXCLAMATION-GREATER-THAN': ord('!') + SPECIAL,
-    'EXCLAMATION-TILDE': ord('~') + SPECIAL
+    'MINUS_GREATER_THAN': ord('-') + SPECIAL,
+    'EQUAL_ARROW': ord('>') + SPECIAL,
+    'EXCLAMATION_GREATER_THAN': ord('!') + SPECIAL,
+    'EXCLAMATION_TILDE': ord('~') + SPECIAL
 })
 
 # keywords

{pyscript_programming_language-1.12.4 → pyscript_programming_language-1.12.5}/pyscript/core/handlers.py

@@ -1,18 +1,20 @@
 from .cache import pys_sys
 from .constants import ENV_PYSCRIPT_NO_GIL
+from .context import PysContext
 from .objects import PysFunction
+from .position import PysPosition
 from .utils.generic import is_environ
 
 from types import MethodType
+from typing import Any
 
 wrapper_function = (MethodType, classmethod, staticmethod)
 
 if not is_environ(ENV_PYSCRIPT_NO_GIL):
     from threading import RLock
-
     lock = RLock()
 
-    def handle_call(object, context, position):
+    def handle_call(object: Any, context: PysContext, position: PysPosition) -> None:
         with lock:
 
             if (ins := isinstance)(object, PysFunction):
@@ -35,7 +37,7 @@ if not is_environ(ENV_PYSCRIPT_NO_GIL):
     GIL = pys_sys.gil = True
 else:
 
-    def handle_call(object, context, position):
+    def handle_call(object: Any, context: PysContext, position: PysPosition) -> None:
 
         if (ins := isinstance)(object, PysFunction):
             code = object.__code__

{pyscript_programming_language-1.12.4 → pyscript_programming_language-1.12.5}/pyscript/core/highlight.py

@@ -508,7 +508,7 @@ def pys_highlight(
                     type_format = 'identifier-function'
                 else:
                     j = i + 1
-                    if (j < len(tokens) and tokens[j].type == TOKENS['LEFT-PARENTHESIS']):
+                    if (j < len(tokens) and tokens[j].type == TOKENS['LEFT_PARENTHESIS']):
                         type_format = 'identifier-function'
                     else:
                         type_format = 'identifier-constant' if tvalue.isupper() else 'identifier'