wolfram-bridge 0.1.0__tar.gz

wolfram_bridge-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TurinFohlen
+
+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.

wolfram_bridge-0.1.0/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: wolfram_bridge
+Version: 0.1.0
+Summary: Python → Wolfram Language bridge via PTY, with compat layer for NumPy/SciPy/pandas/PyTorch etc.
+Author: TurinFohlen
+License: MIT
+Project-URL: Homepage, https://github.com/TurinFohlen/wolfram-pty
+Project-URL: Repository, https://github.com/TurinFohlen/wolfram-pty
+Keywords: wolfram,mathematica,bridge,pty,compat,numpy,scipy,pandas,pytorch,tensorflow
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pexpect
+Requires-Dist: pyyaml
+Provides-Extra: wxf
+Requires-Dist: wolframclient>=1.4.0; extra == "wxf"
+Provides-Extra: ai
+Requires-Dist: requests; extra == "ai"
+Provides-Extra: plot
+Requires-Dist: matplotlib; extra == "plot"
+Dynamic: license-file
+
+wolfram-pty
+
+A lightweight Python bridge to the Wolfram Engine for restricted environments – zero scientific dependencies, 800+ mapped functions.
+
+https://img.shields.io/pypi/v/wolfram-pty
+https://img.shields.io/badge/License-MIT-yellow.svg
+
+---
+
+🎯 What is it?
+
+wolfram-pty lets you call the full power of Wolfram Language directly from Python – perfect for constrained environments like Termux, Docker containers, Raspberry Pi, CI/CD pipelines where installing heavy scientific libraries (numpy, pandas, etc.) is impractical.
+
+· Zero scientific dependencies – all heavy lifting is done by the Wolfram Engine; Python only needs the standard library.
+· Persistent kernel session – a single kernel instance keeps state across calls.
+· File‑based output – results are saved as JSON/PNG/TXT and read back with Python’s built‑in modules.
+· Automatic caching – identical expressions return cached results instantly.
+· Metadata‑driven compatibility layer – already maps 835+ functions from NumPy, SciPy, pandas, PyTorch, TensorFlow, SymPy, scikit‑learn, Matplotlib and more.
+· Resilient – automatic kernel restart on failure, serialised request queue, no activation race conditions.
+
+---
+
+✨ Features
+
+· 🔥 Zero scientific libraries – no numpy, no pandas, just plain Python.
+· 🚀 Persistent kernel – start once, evaluate many times with full state retention.
+· 📦 File output mode – reliable, parse‑free communication via files.
+· 🧠 Smart cache – reuse results for identical expressions.
+· 🧩 Drop‑in replacements – use familiar NumPy/SciPy syntax, powered by Wolfram.
+· 🛠️ Auto‑recovery – kernel crashes? It restarts automatically.
+· 🔌 Easy configuration – set two environment variables and you’re ready.
+
+---
+
+🚀 Quick Start
+
+Installation
+
+```bash
+pip install wolfram-pty
+```
+
+⚠️ Note: This package does not include the Wolfram Engine. You must obtain a valid licence from Wolfram Research and install it yourself.
+
+Set up the kernel path
+
+Tell wolfram-pty where your Wolfram kernel is:
+
+```bash
+export WOLFRAM_EXEC=/path/to/your/wolfram-kernel   # e.g. /usr/local/bin/math
+export WOLFRAM_PWFILE=~/.Wolfram/Licensing/mathpass   # optional, password file
+```
+
+Basic usage
+
+```python
+from wolfram_pty import WolframKernel
+
+k = WolframKernel()          # singleton kernel, starts only once
+
+# Evaluate an expression, get a string back
+print(k.evaluate("2+2"))     # "4"
+
+# Batch evaluation
+results = k.batch_evaluate(["Range[5]", "Pi", "Det[{{1,2},{3,4}}]"])
+print(results)               # ["{1,2,3,4,5}", "Pi", "-2"]
+
+# Use the familiar NumPy interface (powered by Wolfram)
+from wolfram_pty.compat import numpy as np
+a = np.array([1,2,3])        # bypasses kernel – pure Python list
+b = np.fft.fft(a)            # actually calls Wolfram's Fourier
+print(b)                     # complex array (read from a JSON file)
+```
+
+---
+
+📁 File Output Mode (Core Mechanism)
+
+All results are written to files and read back with standard Python – no parsing hassle, no dependencies.
+
+```python
+# Save result as a JSON file
+file_path = k.evaluate_to_file("Range[5]", fmt="json")
+print(file_path)             # /sdcard/wolfram_out/xxx.json
+
+# Read it with the built‑in json module
+import json
+with open(file_path) as f:
+    data = json.load(f)      # [1,2,3,4,5]
+
+# Generate a plot and save as PNG
+img_path = k.evaluate_to_file("Plot[Sin[x], {x,0,2Pi}]", fmt="png")
+```
+
+---
+
+🧠 Automatic Caching
+
+The second time you ask for the same expression, the result is returned instantly from the cache.
+
+```python
+# First call – kernel runs
+path1 = k.evaluate_to_file("Range[10000]")
+
+# Second call – cache hit, almost instantaneous
+path2 = k.evaluate_to_file("Range[10000]")
+
+# Force recompute (e.g. for random numbers)
+path3 = k.evaluate_to_file("RandomReal[1,1000]", no_cache=True)
+
+# Clean cache files older than 7 days
+k.clear_cache(older_than_days=7)
+```
+
+---
+
+📚 Supported Libraries (835+ functions)
+
+The wolfram_pty.compat submodule provides drop‑in replacements for popular scientific Python libraries – everything is translated to Wolfram calls.
+
+Library Functions Example
+NumPy 200+ np.array, np.fft.fft, np.linalg.solve
+SciPy 143 scipy.integrate.quad, scipy.optimize.minimize
+pandas 125 pd.DataFrame, df.groupby, pd.read_csv
+PyTorch 66 torch.tensor, torch.add, torch.nn.ReLU
+TensorFlow 55 tf.constant, tf.matmul, tf.nn.softmax
+SymPy 71 sympy.symbols, sympy.diff, sympy.solve
+scikit‑learn 60 sklearn.preprocessing.StandardScaler, sklearn.cluster.KMeans
+Matplotlib 47 plt.plot, plt.imshow, seaborn
+Performance 50+ tqdm, logging, time, psutil
+
+How to use them:
+
+```python
+from wolfram_pty.compat import numpy as np
+from wolfram_pty.compat import scipy
+from wolfram_pty.compat import pandas as pd
+# … and so on
+```
+
+---
+
+⚙️ Configuration
+
+All settings are controlled via environment variables:
+
+Variable Default Description
+WOLFRAM_EXEC /root/.../math Path to the Wolfram kernel executable
+WOLFRAM_PWFILE ~/.Wolfram/Licensing/mathpass Path to the password file (optional)
+WOLFRAM_CACHE_DIR /sdcard/wolfram_cache Directory for cached results
+WOLFRAM_OUT_DIR /sdcard/wolfram_out Default output directory for files
+
+---
+
+⚠️ Important Legal Notice
+
+This software only provides a communication interface to the Wolfram Engine and does not include, bundle, or distribute the Wolfram Engine itself.
+Users must obtain a valid licence directly from Wolfram Research and comply with their terms.
+The developers of wolfram-pty assume no liability for any unauthorised use of the Wolfram Engine.
+
+---
+
+📄 License
+
+MIT License © 2025 TurinFohlen
+
+---
+
+🤝 Contributing
+
+Issues and pull requests are welcome! If you’d like to add mappings for more functions, create a YAML file in mappings/ and make sure tests pass.
+
+---
+
+Happy computing – even in the most constrained environments!

wolfram_bridge-0.1.0/README.md

@@ -0,0 +1,175 @@
+wolfram-pty
+
+A lightweight Python bridge to the Wolfram Engine for restricted environments – zero scientific dependencies, 800+ mapped functions.
+
+https://img.shields.io/pypi/v/wolfram-pty
+https://img.shields.io/badge/License-MIT-yellow.svg
+
+---
+
+🎯 What is it?
+
+wolfram-pty lets you call the full power of Wolfram Language directly from Python – perfect for constrained environments like Termux, Docker containers, Raspberry Pi, CI/CD pipelines where installing heavy scientific libraries (numpy, pandas, etc.) is impractical.
+
+· Zero scientific dependencies – all heavy lifting is done by the Wolfram Engine; Python only needs the standard library.
+· Persistent kernel session – a single kernel instance keeps state across calls.
+· File‑based output – results are saved as JSON/PNG/TXT and read back with Python’s built‑in modules.
+· Automatic caching – identical expressions return cached results instantly.
+· Metadata‑driven compatibility layer – already maps 835+ functions from NumPy, SciPy, pandas, PyTorch, TensorFlow, SymPy, scikit‑learn, Matplotlib and more.
+· Resilient – automatic kernel restart on failure, serialised request queue, no activation race conditions.
+
+---
+
+✨ Features
+
+· 🔥 Zero scientific libraries – no numpy, no pandas, just plain Python.
+· 🚀 Persistent kernel – start once, evaluate many times with full state retention.
+· 📦 File output mode – reliable, parse‑free communication via files.
+· 🧠 Smart cache – reuse results for identical expressions.
+· 🧩 Drop‑in replacements – use familiar NumPy/SciPy syntax, powered by Wolfram.
+· 🛠️ Auto‑recovery – kernel crashes? It restarts automatically.
+· 🔌 Easy configuration – set two environment variables and you’re ready.
+
+---
+
+🚀 Quick Start
+
+Installation
+
+```bash
+pip install wolfram-pty
+```
+
+⚠️ Note: This package does not include the Wolfram Engine. You must obtain a valid licence from Wolfram Research and install it yourself.
+
+Set up the kernel path
+
+Tell wolfram-pty where your Wolfram kernel is:
+
+```bash
+export WOLFRAM_EXEC=/path/to/your/wolfram-kernel   # e.g. /usr/local/bin/math
+export WOLFRAM_PWFILE=~/.Wolfram/Licensing/mathpass   # optional, password file
+```
+
+Basic usage
+
+```python
+from wolfram_pty import WolframKernel
+
+k = WolframKernel()          # singleton kernel, starts only once
+
+# Evaluate an expression, get a string back
+print(k.evaluate("2+2"))     # "4"
+
+# Batch evaluation
+results = k.batch_evaluate(["Range[5]", "Pi", "Det[{{1,2},{3,4}}]"])
+print(results)               # ["{1,2,3,4,5}", "Pi", "-2"]
+
+# Use the familiar NumPy interface (powered by Wolfram)
+from wolfram_pty.compat import numpy as np
+a = np.array([1,2,3])        # bypasses kernel – pure Python list
+b = np.fft.fft(a)            # actually calls Wolfram's Fourier
+print(b)                     # complex array (read from a JSON file)
+```
+
+---
+
+📁 File Output Mode (Core Mechanism)
+
+All results are written to files and read back with standard Python – no parsing hassle, no dependencies.
+
+```python
+# Save result as a JSON file
+file_path = k.evaluate_to_file("Range[5]", fmt="json")
+print(file_path)             # /sdcard/wolfram_out/xxx.json
+
+# Read it with the built‑in json module
+import json
+with open(file_path) as f:
+    data = json.load(f)      # [1,2,3,4,5]
+
+# Generate a plot and save as PNG
+img_path = k.evaluate_to_file("Plot[Sin[x], {x,0,2Pi}]", fmt="png")
+```
+
+---
+
+🧠 Automatic Caching
+
+The second time you ask for the same expression, the result is returned instantly from the cache.
+
+```python
+# First call – kernel runs
+path1 = k.evaluate_to_file("Range[10000]")
+
+# Second call – cache hit, almost instantaneous
+path2 = k.evaluate_to_file("Range[10000]")
+
+# Force recompute (e.g. for random numbers)
+path3 = k.evaluate_to_file("RandomReal[1,1000]", no_cache=True)
+
+# Clean cache files older than 7 days
+k.clear_cache(older_than_days=7)
+```
+
+---
+
+📚 Supported Libraries (835+ functions)
+
+The wolfram_pty.compat submodule provides drop‑in replacements for popular scientific Python libraries – everything is translated to Wolfram calls.
+
+Library Functions Example
+NumPy 200+ np.array, np.fft.fft, np.linalg.solve
+SciPy 143 scipy.integrate.quad, scipy.optimize.minimize
+pandas 125 pd.DataFrame, df.groupby, pd.read_csv
+PyTorch 66 torch.tensor, torch.add, torch.nn.ReLU
+TensorFlow 55 tf.constant, tf.matmul, tf.nn.softmax
+SymPy 71 sympy.symbols, sympy.diff, sympy.solve
+scikit‑learn 60 sklearn.preprocessing.StandardScaler, sklearn.cluster.KMeans
+Matplotlib 47 plt.plot, plt.imshow, seaborn
+Performance 50+ tqdm, logging, time, psutil
+
+How to use them:
+
+```python
+from wolfram_pty.compat import numpy as np
+from wolfram_pty.compat import scipy
+from wolfram_pty.compat import pandas as pd
+# … and so on
+```
+
+---
+
+⚙️ Configuration
+
+All settings are controlled via environment variables:
+
+Variable Default Description
+WOLFRAM_EXEC /root/.../math Path to the Wolfram kernel executable
+WOLFRAM_PWFILE ~/.Wolfram/Licensing/mathpass Path to the password file (optional)
+WOLFRAM_CACHE_DIR /sdcard/wolfram_cache Directory for cached results
+WOLFRAM_OUT_DIR /sdcard/wolfram_out Default output directory for files
+
+---
+
+⚠️ Important Legal Notice
+
+This software only provides a communication interface to the Wolfram Engine and does not include, bundle, or distribute the Wolfram Engine itself.
+Users must obtain a valid licence directly from Wolfram Research and comply with their terms.
+The developers of wolfram-pty assume no liability for any unauthorised use of the Wolfram Engine.
+
+---
+
+📄 License
+
+MIT License © 2025 TurinFohlen
+
+---
+
+🤝 Contributing
+
+Issues and pull requests are welcome! If you’d like to add mappings for more functions, create a YAML file in mappings/ and make sure tests pass.
+
+---
+
+Happy computing – even in the most constrained environments!

wolfram_bridge-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "wolfram_bridge"
+version = "0.1.0"
+description = "Python → Wolfram Language bridge via PTY, with compat layer for NumPy/SciPy/pandas/PyTorch etc."
+readme = "README.md"
+license = { text = "MIT" }
+authors = [
+    { name = "TurinFohlen" },
+]
+keywords = ["wolfram", "mathematica", "bridge", "pty", "compat", "numpy", "scipy", "pandas", "pytorch", "tensorflow"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+requires-python = ">=3.9"
+dependencies = [
+    "pexpect",
+    "pyyaml",
+]
+
+[project.optional-dependencies]
+wxf = ["wolframclient>=1.4.0"]
+ai = ["requests"]
+plot = ["matplotlib"]
+
+[project.urls]
+Homepage = "https://github.com/TurinFohlen/wolfram-pty"
+Repository = "https://github.com/TurinFohlen/wolfram-pty"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["wolfram_bridge*"]
+
+[tool.setuptools.package-data]
+"wolfram_bridge.compat" = ["mappings/*.yaml"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+
+[project.entry-points."plugins"]
+# 将来插件可以在此注册。

wolfram_bridge-0.1.0/setup.cfg

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

wolfram_bridge-0.1.0/tests/test_cache.py

@@ -0,0 +1,51 @@
+#!/usr/bin/env python3
+import os
+import time
+import hashlib
+from wolfram_bridge import WolframKernel, CACHE_DIR
+
+def test_cache():
+    print("="*50)
+    print("开始测试缓存功能")
+    print("="*50)
+
+    k = WolframKernel()
+    expr = "Range[1000]"          # 一个中等大小的数组
+    fmt = "wxf"
+
+    # 计算哈希，用于定位缓存文件
+    expr_hash = hashlib.sha256(expr.encode()).hexdigest()
+    cache_path = os.path.join(CACHE_DIR, f"{expr_hash}.{fmt}")
+
+    # 第一次调用（应触发实际计算）
+    print("\n[1] 第一次调用 (应触发内核计算)")
+    path1 = k.evaluate_to_file(expr, fmt=fmt)
+    print(f"    结果文件: {path1}")
+    print(f"    缓存文件是否存在? {os.path.exists(cache_path)}")
+
+    # 短暂等待，确保文件写完毕
+    time.sleep(1)
+
+    # 第二次调用（应命中缓存）
+    print("\n[2] 第二次调用 (应命中缓存，不触发内核)")
+    path2 = k.evaluate_to_file(expr, fmt=fmt)
+    print(f"    结果文件: {path2}")
+    # 缓存文件应该还在
+    print(f"    缓存文件是否存在? {os.path.exists(cache_path)}")
+
+    # 清理缓存
+    print("\n[3] 清除缓存")
+    k.clear_cache()
+    print(f"    缓存文件是否存在? {os.path.exists(cache_path)}")
+
+    # 第三次调用（缓存已清，应重新计算）
+    print("\n[4] 第三次调用 (缓存已清，应重新计算)")
+    path3 = k.evaluate_to_file(expr, fmt=fmt)
+    print(f"    结果文件: {path3}")
+    print(f"    缓存文件是否存在? {os.path.exists(cache_path)}")
+
+    print("\n✅ 测试完成。请观察控制台输出中是否出现内核计算日志（INFO 级别的 'Export[...]' 等）。")
+    print("   如果第二次调用没有出现此类日志，说明缓存生效。")
+
+if __name__ == "__main__":
+    test_cache()