mirascript 0.0.6__py3-none-any.whl

mirascript/vm/types/const.py

@@ -0,0 +1,39 @@
+from dataclasses import dataclass
+from typing import Any, Callable, Dict, Optional, Union
+from .module import VmModule
+from .extern import VmExtern
+
+## 标记未初始化的值
+Uninitialized = type("Uninitialized", (), {})()
+
+
+## 标记当前未返回的值
+NotReturned = type("NotReturned", (), {})()
+
+
+# 类型别名
+VmPrimitive = Union[type(None), str, int, float, bool]
+        
+VmRecord = dict
+VmArray = list
+VmConst = Union[type(None), str, int, float, bool, dict, list]
+
+
+
+VM_ARRAY_MAX_LENGTH = 2 ** 31 - 1
+
+class VmFunctionLike():
+    def __call__(self, *args): ... # type: ignore
+
+
+VmImmutable = Union[ VmConst ,  VmModule]
+
+VmValue =Union[ VmImmutable , VmExtern]
+VmUninitialized = type(Uninitialized)
+VmAny = Union[VmValue , VmUninitialized]
+
+kVmFunction = 'mirascript_vm_function'
+def getVmFunctionInfo(value) :
+    if (not callable(value)):
+        return None
+    return getattr(value, kVmFunction, None)

mirascript/vm/types/context.py

@@ -0,0 +1,130 @@
+# -*- coding: utf-8 -*-
+from typing import Any, Callable, Dict, Iterable, Optional
+from collections.abc import Mapping
+
+from mirascript.vm.error import VmError
+from mirascript.vm.types.const import Uninitialized
+from .checker import is_vm_any
+
+# from .function import VmFunction
+from .extern import wrap_to_vm_value
+
+# 依赖的外部函数和类型需在其他模块实现或导入
+# from . import wrap_to_vm_value, is_vm_any
+
+# 全局共享上下文
+VmSharedContext: Dict[str, Any] = {}
+
+# def define_vm_context_value(name: str, value: Any, override: bool = False):
+# 	if not override and name in VmSharedContext:
+# 		raise RuntimeError(f"Global variable '{name}' is already defined.")
+# 	v = value
+# 	# 如果是函数且不是VmFunction，自动包裹
+# 	if callable(value) :
+# 		v = VmFunction(value, isLib=True, fullName=f"global.{name}")
+# 	VmSharedContext[name] = v if v is not None else None
+
+_K_VM_CONTEXT = "__mira_vm_context__"
+
+
+class VmContext:
+    def __init__(self):
+        setattr(self, _K_VM_CONTEXT, True)
+
+    def keys(self) -> Iterable[str]:
+        return VmSharedContext.keys()
+
+    def get(self, key: str) -> Any:
+        # return VmSharedContext.get(key, None)
+        val = VmSharedContext.get(key, Uninitialized)
+        if val is Uninitialized:
+            raise VmError(f"Global variable '{key}' is not defined.", None)
+        return val
+
+    def has(self, key: str) -> bool:
+        return key in VmSharedContext
+
+    def __getattr__(self, key):
+        return self.get(key)
+
+    def __getitem__(self, key):
+        return self.get(key)
+
+
+class ValueVmContext(VmContext):
+    def __init__(self, env: Dict[str, Any]):
+        super().__init__()
+        self.env = env
+        self._cached_keys = None
+
+    def keys(self) -> Iterable[str]:
+        if self._cached_keys is None:
+            self._cached_keys = list(self.env.keys())
+        return list(self._cached_keys) + list(VmSharedContext.keys())
+
+    def get(self, key: str) -> Any:
+        # return self.env.get(key, None)
+        val = self.env.get(key, Uninitialized)
+        if val is Uninitialized:
+            raise VmError(f"Global variable '{key}' is not defined.", None)
+        return val
+
+    def has(self, key: str) -> bool:
+        return key in self.env
+
+
+class FactoryVmContext(VmContext):
+    def __init__(
+        self,
+        getter: Callable[[str], Any],
+        enumerator: Optional[Callable[[], Iterable[str]]] = None,
+    ):
+        super().__init__()
+        self.getter = getter
+        self.enumerator = enumerator
+
+    def keys(self) -> Iterable[str]:
+        if not self.enumerator:
+            return VmSharedContext.keys()
+        return list(self.enumerator()) + list(VmSharedContext.keys())
+
+    def get(self, key: str) -> Any:
+        value = self.getter(key)
+        if value is not None:
+            return value
+        return VmSharedContext.get(key, None)
+
+    def has(self, key: str) -> bool:
+        return self.getter(key) is not None or key in VmSharedContext
+
+
+def create_vm_context(*args) -> VmContext:
+    if len(args) == 0 or (args[0] is None and (len(args) < 2 or args[1] is None)):
+        return VmContext()
+    if callable(args[0]):
+        return FactoryVmContext(args[0], args[1] if len(args) > 1 else None)
+    
+    
+    vm_values = args[0] if len(args) > 0 else None
+    extern_values = args[1] if len(args) > 1 else None
+    env = dict(VmSharedContext)
+    if vm_values:
+        for key, value in vm_values.items():
+            if not is_vm_any(value, False):
+                continue
+            env[key] = value if value is not None else None
+    if extern_values:
+        for key, value in extern_values.items():
+            env[key] = None if value is None else wrap_to_vm_value(value, None)
+    return ValueVmContext(env)
+
+
+def is_vm_context(context: Any) -> bool:
+    return (
+        isinstance(context, VmContext)
+        and getattr(context, _K_VM_CONTEXT, False) is True
+    )
+
+
+# DefaultVmContext 实例
+DefaultVmContext = VmContext()

mirascript/vm/types/extern.py

@@ -0,0 +1,123 @@
+# -*- coding: utf-8 -*-
+from typing import Any
+
+from mirascript.vm.error import VmError
+from .wrapper import VmWrapper
+
+# from .module import VmModule
+# from ..error import VmError
+
+
+def wrap_to_vm_value(value, caller=None):
+    if value is None:
+        return None
+    if callable(value):
+        return value
+    if isinstance(value, VmWrapper):
+        return value
+    if isinstance(value, (str, int, float, bool)):
+        return value
+    # Python 没有 bigint，symbol，undefined
+    return VmExtern(value, None)
+
+
+def unwrap_from_vm_value(value):
+    if value is None or not isinstance(value, VmExtern):
+        return value
+    if value.caller is None or not callable(value.value):
+        return value.value
+    caller = value.caller.value
+    func = value.value
+
+    def proxy(*args, **kwargs):
+        return func(*args, **kwargs)
+
+    return proxy
+
+
+class VmExtern(VmWrapper):
+    
+    _VM_EXTERN_SYMBOL='mirascript.vm.extern'
+
+    def __init__(self, value, caller=None):
+        super().__init__(value)
+        self.caller = caller
+        setattr(self, self._VM_EXTERN_SYMBOL, True)
+
+    def access(self, key: str, read: bool) -> bool:
+        
+        if key.startswith("_"):
+            return False
+        if callable(self.value) and key in ("prototype", "arguments", "caller"):
+            return False
+        if hasattr(self.value, key):
+            return True
+        
+        if not read:
+            return True
+        
+        if not key  in self.value:
+            return False
+        
+        if key == "constructor":
+            return False
+        # 跳过内建属性
+        return True
+
+    def has(self, key: str) -> bool:
+        return self.access(key, True)
+
+    def get(self, key: str) -> Any:
+        if not self.has(key):
+            return None
+        
+        prop = self.value[key]
+        return wrap_to_vm_value(prop, self)
+
+    def set(self, key: str, value):
+        if not self.access(key, False):
+            return False
+        prop = unwrap_from_vm_value(value)
+        self.value[key] = prop
+        return True
+
+    def call(self, args):
+        if not callable(self.value):
+            raise VmError.from_("Not a callable extern",None,None)
+        caller = self.caller.value if self.caller else None
+        unwrapped_args = [unwrap_from_vm_value(a) for a in args]
+        # Python 没有 Reflect.apply，直接调用
+        ret = self.value(*unwrapped_args)
+        return wrap_to_vm_value(ret, self)
+
+    @property
+    def callable(self) -> bool:
+        return callable(self.value)
+
+    def keys(self):
+        keys = []
+        for key, _ in self.value.items():
+            if self.has(key):
+                keys.append(key)
+        return keys
+
+    def same(self, other) -> bool:
+        return (
+            isinstance(other, VmExtern)
+            and self.value is other.value
+            and self.caller is other.caller
+        )
+
+    @property
+    def type(self):
+        return "extern"
+
+    @property
+    def describe(self) -> str:
+        return type(self.value).__name__
+
+
+def is_vm_extern(value) -> bool:
+    if value is None or not isinstance(value, object):
+        return False
+    return hasattr(value, VmExtern._VM_EXTERN_SYMBOL)

mirascript/vm/types/function.py

@@ -0,0 +1,28 @@
+
+# VmFunction 相关实现，Python 版
+from functools import wraps
+from ..helpers import CpEnter, CpExit
+
+from .const import kVmFunction
+
+
+def VmFunction(fn, option = None):
+    if not callable(fn):
+        raise TypeError("Invalid function")
+    option = option or {}
+    if option.get("injectCp"):
+        original = fn
+
+        @wraps(original)
+        def wrapped(*args):
+            try:
+                CpEnter()
+                return original(*args)
+            finally:
+                CpExit()
+        fn = wrapped
+        
+        setattr(fn, kVmFunction, option.get('fullName', getattr(original, '__name__', 'unknown')))
+
+    return fn
+

mirascript/vm/types/module.py

@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+from typing import Any
+from .wrapper import VmWrapper
+
+class VmModule(VmWrapper):
+	"""
+	Mirascript 模块包装器
+	"""
+	def __init__(self, name: str, value: dict):
+		super().__init__(value)
+		self.name = name
+
+	def has(self, key):
+		return key in self.value
+
+	def get(self, key: str) -> Any:
+		if not self.has(key):
+			return None
+		return self.value.get(key, None)
+
+	def keys(self):
+		return list(self.value.keys())
+
+	def same(self, other) -> bool:
+		return self is other
+
+	@property
+	def type(self):
+		return 'module'
+
+	@property
+	def describe(self) -> str:
+		return self.name

mirascript/vm/types/script.py

@@ -0,0 +1,17 @@
+# -*- coding: utf-8 -*-
+
+K_VM_SCRIPT = '__mirascript_vm_script__'
+
+class VmScript:
+	"""
+	Mirascript 脚本对象，包装可调用对象及元数据
+	"""
+	def __init__(self, func, source: str):
+		self.func = func
+		self.source = source
+		setattr(self, K_VM_SCRIPT, True)
+	def __call__(self, global_ctx=None):
+		return self.func(global_ctx) if global_ctx is not None else self.func()
+
+def is_vm_script(value) -> bool:
+	return callable(value) and getattr(value, K_VM_SCRIPT, False) is True

mirascript/vm/types/types.py

@@ -0,0 +1,143 @@
+# -*- coding: utf-8 -*-
+from abc import ABC, abstractmethod
+from .const import VmAny
+
+class VmWrapper(ABC):
+	"""
+	Mirascript 特殊值的包装器基类
+	"""
+	def __init__(self, value):
+		self.value = value
+
+	@abstractmethod
+	def has(self, key: str) -> bool:
+		pass
+
+	@abstractmethod
+	def get(self, key: str) -> VmAny:
+		pass
+
+	@abstractmethod
+	def keys(self) -> list[str]:
+		pass
+
+	@abstractmethod
+	def same(self, other) -> bool:
+		pass
+
+	@property
+	@abstractmethod
+	def type(self)->str:
+		pass
+
+	@property
+	@abstractmethod
+	def describe(self) -> str:
+		pass
+
+	def toJSON(self):
+		return None
+
+	def __str__(self):
+		return f'<{self.type} {self.describe}>'
+
+
+class VmModule(VmWrapper):
+	"""
+	Mirascript 模块包装器
+	"""
+	def __init__(self, name: str, value: dict):
+		super().__init__(value)
+		self.name = name
+
+	def has(self, key: str) -> bool:
+		return key in self.value
+
+	def get(self, key: str) -> VmAny:
+		if not self.has(key):
+			return None
+		return self.value.get(key, None)
+
+	def keys(self) -> list[str]:
+		return list(self.value.keys())
+
+	def same(self, other) -> bool:
+		return self is other
+
+	@property
+	def type(self):
+		return 'module'
+
+	@property
+	def describe(self) -> str:
+		return self.name
+
+
+class VmExtern(VmWrapper):
+	def __init__(self, value, caller=None):
+		super().__init__(value)
+		self.caller = caller
+
+	def _access(self, key: str, read: bool) -> bool:
+		if key.startswith('_'):
+			return False
+		if callable(self.value) and key in ('prototype', 'arguments', 'caller'):
+			return False
+		if hasattr(self.value, key):
+			return True
+		if not read:
+			return True
+		if not hasattr(self.value, key):
+			return False
+		if key == 'constructor':
+			return False
+		# 跳过内建属性
+		return True
+
+	def has(self, key: str) -> bool:
+		return self._access(key, True)
+
+	def get(self, key: str) -> Any:
+		if not self.has(key):
+			return None
+		prop = getattr(self.value, key, None)
+		return wrap_to_vm_value(prop, self)
+
+	def set(self, key: str, value):
+		if not self._access(key, False):
+			return False
+		prop = unwrap_from_vm_value(value)
+		setattr(self.value, key, prop)
+		return True
+
+	def call(self, args):
+		if not callable(self.value):
+			raise Exception('Not a callable extern')
+		caller = self.caller.value if self.caller else None
+		unwrapped_args = [unwrap_from_vm_value(a) for a in args]
+		# Python 没有 Reflect.apply，直接调用
+		ret = self.value(*unwrapped_args)
+		return wrap_to_vm_value(ret, self)
+
+	@property
+	def callable(self) -> bool:
+		return callable(self.value)
+
+	def keys(self) -> list[str]:
+		keys = []
+		for key in dir(self.value):
+			if self.has(key):
+				keys.append(key)
+		return keys
+
+	def same(self, other) -> bool:
+		return isinstance(other, VmExtern) and self.value is other.value and self.caller is other.caller
+
+	@property
+	def type(self):
+		return 'extern'
+
+	@property
+	def describe(self) -> str:
+		return type(self.value).__name__
+

mirascript/vm/types/wrapper.py

@@ -0,0 +1,56 @@
+from abc import ABC, abstractmethod
+
+
+class VmWrapper(ABC):
+    
+    
+    _VM_WRAPPER_SYMBOL='mirascript.vm.wrapper'
+    
+    
+    
+    def __init__(self,value):
+        
+        self.value=value
+        # 设置标识符号
+        setattr(self, self._VM_WRAPPER_SYMBOL, True)
+        pass
+    
+    @abstractmethod
+    def has(self,key):
+        pass
+    @abstractmethod
+    def get(self,key):
+        pass
+    @abstractmethod
+    def keys(self):
+        pass
+    @abstractmethod
+    def same(self,other):
+        pass
+    
+    @property
+    @abstractmethod
+    def type(self):
+        return None
+    
+    @property
+    @abstractmethod
+    def describe(self):
+        return None
+    
+    
+    ## Convert the object to JSON
+    def toJSON(self):
+        return None
+    
+    ## 转为字符串
+    def toString(self):
+        if self.describe is  None:
+            return f"<{self.type}>"
+        return f"<{self.type} {self.describe}>"
+    
+def isVmWrapper(v):
+    if v is None or not isinstance(v,object):
+        return False
+   
+    return hasattr(v,VmWrapper._VM_WRAPPER_SYMBOL)

mirascript-0.0.6.dist-info/METADATA

@@ -0,0 +1,17 @@
+Metadata-Version: 2.1
+Name: mirascript
+Version: 0.0.6
+Summary: cloudpss mirascript
+Home-page: https://www.cloudpss.net
+Author: cloudpss
+Author-email: zhangdaming@cloudpss.net
+License: MIT Licence
+Keywords: cloudpss,cloudpss-mirascript,mirascript
+Platform: any
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+MiraScript 的 Python 绑定允许在 Python 中使用 MiraScript 编译器。它提供了一个简单的接口来编译 MiraScript 脚本，并返回编译结果和诊断信息。

mirascript-0.0.6.dist-info/RECORD

@@ -0,0 +1,26 @@
+mirascript/__init__.py,sha256=MTrrkzcQqU9pZtvnwBDbHKmxGEh63ttmI1m1s3NzLJM,293
+mirascript/deep_nonlocal_fix.py,sha256=6JVPiiH68emz-92qB2MQXgMMP8fCj0Ig7vTiGFY33FA,6385
+mirascript/diagnostics.py,sha256=9Tdb7GHwDVw2BXsaWWtJl1XHuMs9wWOhGC2SpdQhwPQ,2183
+mirascript/emit.py,sha256=suUcLP6_zwp-jhu80kgXzoQtoPXMmVyoFKQyVzPOZe0,48852
+mirascript/main.py,sha256=nhbI7x1NVkDbRTSZi37C4hNgXN0kAF7jgP_91dt3VIk,739
+mirascript/subtle.py,sha256=HE8mTIUsC2fHPh3r7X10aHxaO0ViK5CY2N2VXCi7oZI,233
+mirascript/vm/VmWrapper.py,sha256=5f0H-OuXStP5Xj0ZI3OcAmdxeukvd1tpAzhi0ANkO2Y,857
+mirascript/vm/__init__.py,sha256=sTMYi45oM8UAmkHy_m--EqHJpL8hobYIcW97zUpkF8c,439
+mirascript/vm/env.py,sha256=QsoSwAtPmZTGjcFFWWoYzwRMpO8pkTeaFI1_1F1XzFY,344
+mirascript/vm/error.py,sha256=mGYxSmkrhv6QLWgu3SGo7Nt6RffkTdwarJtlFUo_H9Y,431
+mirascript/vm/helpers.py,sha256=RgvrfVQj4b942m1FPNgiuowYDJOcTxbJ6ASAMgVyOLM,3082
+mirascript/vm/operations.py,sha256=WwF15jpvNCcZ9LCHNh1hnHF4kI1nU6wLT_8dE7F_Sjo,14196
+mirascript/vm/types/__init__.py,sha256=e4rOUSXBVJHvz74l8MGo3HSqXoGLo_VsVNuWfgdEBMc,831
+mirascript/vm/types/checker.py,sha256=g8-WWWzcu816yt4gpSln2KzuyvSJ3YDGp41jaljyDlo,2510
+mirascript/vm/types/const.py,sha256=cqttlQtd5vNTYE1T5J6MFjo4RTBqlPm6eWYZuBervbU,956
+mirascript/vm/types/context.py,sha256=3UJrhOUT2ZNAXgavOkYB2SFl2g7ImUgj5AMzjlCFmN4,3987
+mirascript/vm/types/extern.py,sha256=zvvrr3yO9uUnhvX-BANTYw_b73x3sC9xLKCwXAFqTqE,3335
+mirascript/vm/types/function.py,sha256=blYYgGe5j1RZdGur8rMKjAgRLH6Wx56GeZ5fQN--LUU,678
+mirascript/vm/types/module.py,sha256=vjVgLaHNmwQad5woMklzcMQR9xBqEllqQ14xd2QQzkk,604
+mirascript/vm/types/script.py,sha256=OmZdxGtIrHSYPhoHTyNVXYPMtP3bqtbPPz8LtatEvlo,488
+mirascript/vm/types/types.py,sha256=_VRnkTqp35XXMzLbK_gDNpjaurT8YcFFDUEuaaXhYhE,2897
+mirascript/vm/types/wrapper.py,sha256=a1-UI_zgYk1bTL07lbRWJHevDaVvcnkJ0QY7e-D4e50,1085
+mirascript-0.0.6.dist-info/METADATA,sha256=HrWiUkAN_Juak5jPAi8mB2klvDsTtKj8cRniNJzCWlo,704
+mirascript-0.0.6.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+mirascript-0.0.6.dist-info/top_level.txt,sha256=I-eqKgnvXv-32Ugvcg7P6CrGz1cjPstqxe_wdLwCme0,11
+mirascript-0.0.6.dist-info/RECORD,,

mirascript-0.0.6.dist-info/WHEEL

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

mirascript-0.0.6.dist-info/top_level.txt

@@ -0,0 +1 @@
+mirascript