yamlscript 0.2.22__py3-none-win_amd64.whl

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

@@ -0,0 +1,153 @@
+# 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.22'
+
+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.
+  # Confirm platform and determine file extension:
+  if sys.platform == 'linux':
+    libys_name = \
+      "libys.so.%s" % yamlscript_version
+  elif sys.platform == 'darwin':
+    libys_name = \
+      "libys.dylib.%s" % yamlscript_version
+  elif sys.platform == 'win32':
+    libys_name = 'libys.dll'
+  else:
+    raise Exception(
+      "Unsupported platform '%s' for yamlscript." % sys.platform)
+
+  # We currently bind to an exact version of libys.
+  # eg 'libys.so.0.2.22'
+  # 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 the platform library path plus common install locations.
+  if sys.platform == 'win32':
+    library_path = os.environ.get('PATH')
+    library_paths = library_path.split(os.pathsep) if library_path else []
+  else:
+    library_path = os.environ.get('LD_LIBRARY_PATH')
+    library_paths = library_path.split(os.pathsep) if library_path else []
+    library_paths.append('/usr/local/lib')
+
+  home = os.environ.get('HOME') or os.path.expanduser('~')
+  if home:
+    library_paths.append(os.path.join(home, '.local', 'lib'))
+
+  libys_path = None
+  for path in library_paths:
+    full_path = os.path.join(path, libys_name)
+    if os.path.isfile(full_path):
+      libys_path = full_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.22.dist-info/METADATA

@@ -0,0 +1,33 @@
+Metadata-Version: 2.4
+Name: yamlscript
+Version: 0.2.22
+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
+License-File: License
+Requires-Dist: pyyaml
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

yamlscript-0.2.22.dist-info/RECORD

@@ -0,0 +1,7 @@
+yamlscript-0.2.22.data/purelib/yamlscript/__init__.py,sha256=_MI5fKKzBzQEOeW2c3noIYjOtwx1tAGlMLKOelDP3v8,4769
+yamlscript-0.2.22.data/purelib/yamlscript/libys/libys.dll,sha256=MvEpY_8C9VBZuhles6PRiFy5ODUhaNRJwHqq7MQCw-c,60092416
+yamlscript-0.2.22.dist-info/licenses/License,sha256=p8zkBa2O7oxOXPqo0vhuPEheBvp60GSYQvK9TwCf65w,1072
+yamlscript-0.2.22.dist-info/METADATA,sha256=OCoFKYWupEqaiAfeYNU3cemsAGtpj13h15LKUw6PHDc,1056
+yamlscript-0.2.22.dist-info/WHEEL,sha256=GjDPPQwEcripVP6P2r3RxLa-h5Lb9ifGB7FYYtbLDT0,98
+yamlscript-0.2.22.dist-info/top_level.txt,sha256=U1bWDl8Bms9lndIZd3ITPWc-iAHZVErB56tY8C6otwg,11
+yamlscript-0.2.22.dist-info/RECORD,,

yamlscript-0.2.22.dist-info/WHEEL

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

yamlscript-0.2.22.dist-info/licenses/License

@@ -0,0 +1,19 @@
+Copyright 2021 Ingy döt Net
+
+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.

yamlscript-0.2.22.dist-info/top_level.txt

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