yamlscript 0.2.19__py3-none-macosx_14_0_arm64.whl

yamlscript-0.2.19.data/purelib/yamlscript/__init__.py

@@ -0,0 +1,147 @@
+# Copyright 2023-2026 Ingy dot Net
+# This code is licensed under MIT license (See License for details)
+
+"""
+Python binding/API for the libys shared library.
+
+This module can be considered the reference implementation for YAMLScript
+FFI bindings to libys.
+
+The current user facing API consists of a single class, `YAMLScript`, which
+has a single method: `.load(string)`.
+The load() method takes a YAMLScript string as input and returns the Python
+object that the YAMLScript code evaluates to.
+"""
+
+# This value is automatically updated by 'make bump'.
+# The version number is used to find the correct shared library file.
+# We currently only support binding to an exact version of libys.
+yamlscript_version = '0.2.19'
+
+import os, sys
+import ctypes
+import json
+from pathlib import Path
+
+# Require Python 3.6 or greater:
+assert sys.version_info >= (3, 6), \
+  "Python 3.6 or greater required for 'yamlscript'."
+
+# Find the libys shared library file path:
+def find_libys_path():
+  # We currently only support platforms that GraalVM supports.
+  # And Windows is not yet implemented...
+  # Confirm platform and determine file extension:
+  if sys.platform == 'linux':
+    so = 'so'
+  elif sys.platform == 'darwin':
+    so = 'dylib'
+  else:
+    raise Exception(
+      "Unsupported platform '%s' for yamlscript." % sys.platform)
+
+  # We currently bind to an exact version of libys.
+  # eg 'libys.so.0.2.19'
+  libys_name = \
+    "libys.%s.%s" % (so, yamlscript_version)
+
+  # First look for the shared library bundled in platform wheels.
+  bundled_path = \
+    Path(__file__).resolve().parent / 'libys' / libys_name
+  if bundled_path.is_file():
+    return str(bundled_path)
+
+  # Then use LD_LIBRARY_PATH to find libys shared library, or default
+  # to '/usr/local/lib' (where it is installed by default):
+  ld_library_path = os.environ.get('LD_LIBRARY_PATH')
+  ld_library_paths = ld_library_path.split(':') if ld_library_path else []
+  ld_library_paths.append('/usr/local/lib')
+  ld_library_paths.append(os.environ.get('HOME') + '/.local/lib')
+
+  libys_path = None
+  for path in ld_library_paths:
+    path = path + '/' + libys_name
+    if os.path.isfile(path):
+      libys_path = path
+      break
+
+  if not libys_path:
+    raise Exception(
+      """\
+Shared library file '%s' not found
+Try: curl https://yamlscript.org/install | VERSION=%s LIB=1 bash
+See: https://github.com/yaml/yamlscript/wiki/Installing-YAMLScript
+""" % (libys_name, yamlscript_version))
+
+  return libys_path
+
+# Load libys shared library:
+libys = ctypes.CDLL(find_libys_path())
+
+# Create binding to 'load_ys_to_json' function:
+load_ys_to_json = libys.load_ys_to_json
+load_ys_to_json.restype = ctypes.c_char_p
+
+
+# The YAMLScript class is the main user facing API for this module.
+class YAMLScript():
+  """
+  Interface with the libys shared library.
+
+  Usage:
+    import yamlscript
+    ys = yamlscript.YAMLScript()
+    data = ys.load(open('file.ys').read())
+  """
+
+  # YAMLScript instance constructor:
+  def __init__(self, config={}):
+    # config not used yet
+    # self.config = config
+
+    # Create a new GraalVM isolatethread for life of the YAMLScript instance:
+    self.isolatethread = ctypes.c_void_p()
+
+    # Create a new GraalVM isolate:
+    rc = libys.graal_create_isolate(
+      None,
+      None,
+      ctypes.byref(self.isolatethread),
+    )
+
+    if rc != 0:
+      raise Exception("Failed to create isolate")
+
+  # Compile and eval a YAMLScript string and return the result:
+  def load(self, input):
+    # Reset any previous error:
+    self.error = None
+
+    # Call 'load_ys_to_json' function in libys shared library:
+    data_json = load_ys_to_json(
+      self.isolatethread,
+      ctypes.c_char_p(bytes(input, "utf8")),
+    ).decode()
+
+    # Decode the JSON response:
+    resp = json.loads(data_json)
+
+    # Check for libys error in JSON response:
+    self.error = resp.get('error')
+    if self.error:
+      raise Exception(self.error['cause'])
+
+    # Get the response object from evaluating the YAMLScript string:
+    if not 'data' in resp:
+      raise Exception("Unexpected response from 'libys'")
+    data = resp.get('data')
+
+    # Return the response object:
+    return data
+
+  # YAMLScript instance destructor:
+  def __del__(self):
+    # Tear down the isolate thread to free resources:
+    rc = libys.graal_tear_down_isolate(self.isolatethread)
+    if rc != 0:
+      raise Exception("Failed to tear down isolate")

yamlscript-0.2.19.dist-info/METADATA

@@ -0,0 +1,31 @@
+Metadata-Version: 2.4
+Name: yamlscript
+Version: 0.2.19
+Summary: Program in YAML — Code is Data
+Home-page: https://github.com/ingydotnet/yamlscript
+Author: Ingy döt Net
+Author-email: ingy@ingy.net
+License: MIT
+Keywords: yaml,language
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.6, <4
+Description-Content-Type: text/markdown
+Requires-Dist: pyyaml
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

yamlscript-0.2.19.dist-info/RECORD

@@ -0,0 +1,6 @@
+yamlscript-0.2.19.data/purelib/yamlscript/__init__.py,sha256=fYvhDQ__vCSYcN8ELdb30puJoem2Z74PFC-UiqHrM6c,4389
+yamlscript-0.2.19.data/purelib/yamlscript/libys/libys.dylib.0.2.19,sha256=e6c-afdt6Qk7Dj1HSDKU-K4cxPxlEuQSV4zpncE_snA,59140360
+yamlscript-0.2.19.dist-info/METADATA,sha256=pWM4Rdtukx2ciPN-USEcrQbuw_uvhmozz1P140NVy5M,979
+yamlscript-0.2.19.dist-info/WHEEL,sha256=IjHG6Sw94rMrTtb4jpo2tERipQ18kULC4hOv7U1u_9I,106
+yamlscript-0.2.19.dist-info/top_level.txt,sha256=U1bWDl8Bms9lndIZd3ITPWc-iAHZVErB56tY8C6otwg,11
+yamlscript-0.2.19.dist-info/RECORD,,

yamlscript-0.2.19.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: false
+Tag: py3-none-macosx_14_0_arm64
+

yamlscript-0.2.19.dist-info/top_level.txt

@@ -0,0 +1 @@
+yamlscript