yamlstar 0.1.2__tar.gz

yamlstar-0.1.2/PKG-INFO

@@ -0,0 +1,338 @@
+Metadata-Version: 2.4
+Name: yamlstar
+Version: 0.1.2
+Summary: Python bindings for YAMLStar - YAML 1.2 loader
+Home-page: https://github.com/yaml/yamlstar
+Author: Ingy döt Net
+Author-email: ingy@ingy.net
+License: MIT
+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.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.6, <4
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-python
+Dynamic: summary
+
+# YAMLStar Python Bindings
+
+Python bindings for YAMLStar - a pure YAML 1.2 loader implemented in Clojure.
+
+## Features
+
+- **YAML 1.2 Spec Compliance**: 100% compliant with YAML 1.2 core schema
+- **Pure Implementation**: No dependencies on SnakeYAML or other external parsers
+- **Fast Native Performance**: Uses GraalVM native-image shared library
+- **Simple API**: Load YAML documents with a single function call
+- **Multi-Document Support**: Load multiple YAML documents from a single string
+
+## Installation
+
+### Prerequisites
+
+First, build and install the shared library:
+
+```bash
+cd ../libyamlstar
+make native
+sudo make install PREFIX=/usr/local
+```
+
+Or install to user-local directory:
+
+```bash
+cd ../libyamlstar
+make native
+make install PREFIX=~/.local
+```
+
+### Install Python Package
+
+```bash
+pip install .
+```
+
+For development:
+
+```bash
+pip install -e .
+```
+
+## Quick Start
+
+```python
+import yamlstar
+
+# Create a YAMLStar instance
+ys = yamlstar.YAMLStar()
+
+# Load a simple YAML string
+data = ys.load("key: value")
+print(data)  # {'key': 'value'}
+```
+
+## Usage Examples
+
+### Basic Types
+
+```python
+import yamlstar
+
+ys = yamlstar.YAMLStar()
+
+# Strings
+ys.load("hello")  # 'hello'
+
+# Integers
+ys.load("42")  # 42
+
+# Floats
+ys.load("3.14")  # 3.14
+
+# Booleans
+ys.load("true")   # True
+ys.load("false")  # False
+
+# Null
+ys.load("null")  # None
+```
+
+### Collections
+
+```python
+# Mappings (dictionaries)
+data = ys.load("""
+name: Alice
+age: 30
+city: Seattle
+""")
+# {'name': 'Alice', 'age': 30, 'city': 'Seattle'}
+
+# Sequences (lists)
+data = ys.load("""
+- apple
+- banana
+- orange
+""")
+# ['apple', 'banana', 'orange']
+
+# Flow style
+data = ys.load("[a, b, c]")
+# ['a', 'b', 'c']
+```
+
+### Nested Structures
+
+```python
+data = ys.load("""
+person:
+  name: Alice
+  age: 30
+  hobbies:
+    - reading
+    - coding
+    - hiking
+""")
+# {
+#   'person': {
+#     'name': 'Alice',
+#     'age': 30,
+#     'hobbies': ['reading', 'coding', 'hiking']
+#   }
+# }
+```
+
+### Multi-Document YAML
+
+```python
+# Load all documents from a multi-document YAML string
+docs = ys.load_all("""---
+name: Document 1
+---
+name: Document 2
+---
+name: Document 3
+""")
+# [
+#   {'name': 'Document 1'},
+#   {'name': 'Document 2'},
+#   {'name': 'Document 3'}
+# ]
+```
+
+### Type Coercion
+
+YAMLStar follows YAML 1.2 core schema type inference:
+
+```python
+data = ys.load("""
+string: hello
+integer: 42
+float: 3.14
+bool_true: true
+bool_false: false
+null_value: null
+""")
+# {
+#   'string': 'hello',
+#   'integer': 42,
+#   'float': 3.14,
+#   'bool_true': True,
+#   'bool_false': False,
+#   'null_value': None
+# }
+```
+
+### Error Handling
+
+```python
+try:
+    data = ys.load("invalid: yaml: syntax")
+except Exception as e:
+    print(f"Error loading YAML: {e}")
+```
+
+### Version Information
+
+```python
+# Get YAMLStar version
+version = ys.version()
+print(f"YAMLStar version: {version}")
+```
+
+## API Reference
+
+### `YAMLStar` Class
+
+#### `__init__()`
+Create a new YAMLStar instance. Each instance maintains its own GraalVM isolate.
+
+```python
+ys = yamlstar.YAMLStar()
+```
+
+#### `load(yaml_input)`
+Load a single YAML document.
+
+**Parameters:**
+- `yaml_input` (str): String containing YAML content
+
+**Returns:**
+- Python object representing the YAML document (dict, list, str, int, float, bool, or None)
+
+**Raises:**
+- `Exception` if the YAML is malformed
+
+**Example:**
+```python
+data = ys.load("key: value")
+```
+
+#### `load_all(yaml_input)`
+Load all YAML documents from a multi-document string.
+
+**Parameters:**
+- `yaml_input` (str): String containing one or more YAML documents
+
+**Returns:**
+- List of Python objects, one per YAML document
+
+**Raises:**
+- `Exception` if the YAML is malformed
+
+**Example:**
+```python
+docs = ys.load_all("---\ndoc1\n---\ndoc2")
+```
+
+#### `version()`
+Get the YAMLStar version string.
+
+**Returns:**
+- str: Version string
+
+**Example:**
+```python
+version = ys.version()
+```
+
+## Development
+
+### Running Tests
+
+```bash
+# Run all tests
+make test
+
+# Run only pytest tests
+make test-pytest
+
+# Run only FFI tests
+make test-ffi
+```
+
+### Building Distribution
+
+```bash
+# Build source distribution
+make dist
+
+# Build and install in development mode
+make install
+```
+
+## Requirements
+
+- **Python**: 3.6 or higher
+- **libyamlstar**: Shared library (installed separately)
+- **System**: Linux or macOS
+
+## Library Search Path
+
+The package searches for `libyamlstar.so` (or `.dylib` on macOS) in:
+
+1. Development path (relative to package)
+2. Directories in `LD_LIBRARY_PATH` environment variable
+3. `/usr/local/lib` (default install location)
+4. `~/.local/lib` (user-local install location)
+
+## Comparison to PyYAML
+
+| Feature | YAMLStar | PyYAML |
+|---------|----------|--------|
+| YAML Version | 1.2 | 1.1 |
+| Implementation | Pure Clojure | C + Python |
+| Type Inference | YAML 1.2 core schema | YAML 1.1 + custom |
+| Native Performance | Yes (GraalVM) | Yes (C extension) |
+| Dependencies | libyamlstar.so | None |
+
+## License
+
+MIT License - See [License](License) file
+
+## Credits
+
+Created by Ingy döt Net, inventor of YAML.
+
+YAMLStar is built on the YAML Reference Parser (pure Clojure implementation).
+
+## Links
+
+- **GitHub**: https://github.com/yaml/yamlstar
+- **YAML Specification**: https://yaml.org/spec/1.2/spec.html

yamlstar-0.1.2/lib/yamlstar/__init__.py

@@ -0,0 +1,209 @@
+# Copyright 2024 yaml.org
+# MIT License
+
+"""
+Python binding/API for the libyamlstar shared library.
+
+This module provides a Python interface to YAMLStar, a pure YAML 1.2 loader.
+The YAMLStar class has methods for loading YAML documents and converting
+them to Python objects.
+"""
+
+# Version matching the yamlstar shared library
+yamlstar_version = '0.1.2'
+
+import os
+import sys
+import ctypes
+import json
+
+# Require Python 3.6 or greater:
+assert sys.version_info >= (3, 6), \
+  "Python 3.6 or greater required for 'yamlstar'."
+
+# Find the libyamlstar shared library file path:
+def find_libyamlstar_path():
+  # Confirm platform and determine file extension:
+  if sys.platform == 'linux':
+    so = 'so'
+  elif sys.platform == 'darwin':
+    so = 'dylib'
+  elif sys.platform == 'win32':
+    so = 'dll'
+  else:
+    raise Exception(
+      "Unsupported platform '%s' for yamlstar." % sys.platform)
+
+  # We currently bind to an exact version of libyamlstar.
+  # eg 'libyamlstar.so.0.1.2-SNAPSHOT'
+  libyamlstar_name = \
+    "libyamlstar.%s.%s" % (so, yamlstar_version)
+
+  # Use LD_LIBRARY_PATH to find libyamlstar 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')
+
+  # Also check relative to this file (for development)
+  lib_path = os.path.join(os.path.dirname(os.path.dirname(os.path.dirname(__file__))), '..', 'libyamlstar', 'lib')
+  lib_path = os.path.abspath(lib_path)
+  ld_library_paths.insert(0, lib_path)
+
+  libyamlstar_path = None
+  for path in ld_library_paths:
+    full_path = os.path.join(path, libyamlstar_name)
+    if os.path.isfile(full_path):
+      libyamlstar_path = full_path
+      break
+
+  if not libyamlstar_path:
+    raise Exception(
+      """\
+Shared library file '%s' not found
+Search paths: %s
+Build with: cd libyamlstar && make native
+""" % (libyamlstar_name, ':'.join(ld_library_paths)))
+
+  return libyamlstar_path
+
+# Load libyamlstar shared library:
+libyamlstar = ctypes.CDLL(find_libyamlstar_path())
+
+# Create bindings to library functions:
+yamlstar_load = libyamlstar.yamlstar_load
+yamlstar_load.restype = ctypes.c_char_p
+
+yamlstar_load_all = libyamlstar.yamlstar_load_all
+yamlstar_load_all.restype = ctypes.c_char_p
+
+yamlstar_version_fn = libyamlstar.yamlstar_version
+yamlstar_version_fn.restype = ctypes.c_char_p
+
+
+# The YAMLStar class is the main user facing API for this module.
+class YAMLStar():
+  """
+  Interface with the libyamlstar shared library.
+
+  Usage:
+    import yamlstar
+    ys = yamlstar.YAMLStar()
+    data = ys.load("key: value")
+    # Returns: {'key': 'value'}
+
+    docs = ys.load_all("---\\ndoc1\\n---\\ndoc2")
+    # Returns: ['doc1', 'doc2']
+  """
+
+  # YAMLStar instance constructor:
+  def __init__(self):
+    # Create a new GraalVM isolatethread for life of the YAMLStar instance:
+    self.isolatethread = ctypes.c_void_p()
+
+    # Create a new GraalVM isolate:
+    rc = libyamlstar.graal_create_isolate(
+      None,
+      None,
+      ctypes.byref(self.isolatethread),
+    )
+
+    if rc != 0:
+      raise Exception("Failed to create isolate")
+
+  # Load a single YAML document and return the result:
+  def load(self, yaml_input):
+    """
+    Load a single YAML document.
+
+    Args:
+      yaml_input: String containing YAML content
+
+    Returns:
+      Python object representing the YAML document
+
+    Raises:
+      Exception if the YAML is malformed
+    """
+    # Reset any previous error:
+    self.error = None
+
+    # Call 'yamlstar_load' function in libyamlstar shared library:
+    data_json = yamlstar_load(
+      self.isolatethread,
+      ctypes.c_char_p(bytes(yaml_input, "utf8")),
+    ).decode()
+
+    # Decode the JSON response:
+    resp = json.loads(data_json)
+
+    # Check for libyamlstar error in JSON response:
+    self.error = resp.get('error')
+    if self.error:
+      raise Exception(self.error['cause'])
+
+    # Get the response object from loading the YAML string:
+    if 'data' not in resp:
+      raise Exception("Unexpected response from 'libyamlstar'")
+    data = resp.get('data')
+
+    # Return the response object:
+    return data
+
+  # Load all YAML documents and return the results:
+  def load_all(self, yaml_input):
+    """
+    Load all YAML documents from a multi-document string.
+
+    Args:
+      yaml_input: String containing one or more YAML documents
+
+    Returns:
+      List of Python objects, one per YAML document
+
+    Raises:
+      Exception if the YAML is malformed
+    """
+    # Reset any previous error:
+    self.error = None
+
+    # Call 'yamlstar_load_all' function in libyamlstar shared library:
+    data_json = yamlstar_load_all(
+      self.isolatethread,
+      ctypes.c_char_p(bytes(yaml_input, "utf8")),
+    ).decode()
+
+    # Decode the JSON response:
+    resp = json.loads(data_json)
+
+    # Check for libyamlstar error in JSON response:
+    self.error = resp.get('error')
+    if self.error:
+      raise Exception(self.error['cause'])
+
+    # Get the response object from loading the YAML string:
+    if 'data' not in resp:
+      raise Exception("Unexpected response from 'libyamlstar'")
+    data = resp.get('data')
+
+    # Return the response object:
+    return data
+
+  # Get the YAMLStar version:
+  def version(self):
+    """
+    Get the YAMLStar version string.
+
+    Returns:
+      Version string
+    """
+    return yamlstar_version_fn(self.isolatethread).decode()
+
+  # YAMLStar instance destructor:
+  def __del__(self):
+    # Tear down the isolate thread to free resources:
+    if hasattr(self, 'isolatethread'):
+      rc = libyamlstar.graal_tear_down_isolate(self.isolatethread)
+      if rc != 0:
+        raise Exception("Failed to tear down isolate")

yamlstar-0.1.2/lib/yamlstar.egg-info/PKG-INFO

@@ -0,0 +1,338 @@
+Metadata-Version: 2.4
+Name: yamlstar
+Version: 0.1.2
+Summary: Python bindings for YAMLStar - YAML 1.2 loader
+Home-page: https://github.com/yaml/yamlstar
+Author: Ingy döt Net
+Author-email: ingy@ingy.net
+License: MIT
+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.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.6, <4
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-python
+Dynamic: summary
+
+# YAMLStar Python Bindings
+
+Python bindings for YAMLStar - a pure YAML 1.2 loader implemented in Clojure.
+
+## Features
+
+- **YAML 1.2 Spec Compliance**: 100% compliant with YAML 1.2 core schema
+- **Pure Implementation**: No dependencies on SnakeYAML or other external parsers
+- **Fast Native Performance**: Uses GraalVM native-image shared library
+- **Simple API**: Load YAML documents with a single function call
+- **Multi-Document Support**: Load multiple YAML documents from a single string
+
+## Installation
+
+### Prerequisites
+
+First, build and install the shared library:
+
+```bash
+cd ../libyamlstar
+make native
+sudo make install PREFIX=/usr/local
+```
+
+Or install to user-local directory:
+
+```bash
+cd ../libyamlstar
+make native
+make install PREFIX=~/.local
+```
+
+### Install Python Package
+
+```bash
+pip install .
+```
+
+For development:
+
+```bash
+pip install -e .
+```
+
+## Quick Start
+
+```python
+import yamlstar
+
+# Create a YAMLStar instance
+ys = yamlstar.YAMLStar()
+
+# Load a simple YAML string
+data = ys.load("key: value")
+print(data)  # {'key': 'value'}
+```
+
+## Usage Examples
+
+### Basic Types
+
+```python
+import yamlstar
+
+ys = yamlstar.YAMLStar()
+
+# Strings
+ys.load("hello")  # 'hello'
+
+# Integers
+ys.load("42")  # 42
+
+# Floats
+ys.load("3.14")  # 3.14
+
+# Booleans
+ys.load("true")   # True
+ys.load("false")  # False
+
+# Null
+ys.load("null")  # None
+```
+
+### Collections
+
+```python
+# Mappings (dictionaries)
+data = ys.load("""
+name: Alice
+age: 30
+city: Seattle
+""")
+# {'name': 'Alice', 'age': 30, 'city': 'Seattle'}
+
+# Sequences (lists)
+data = ys.load("""
+- apple
+- banana
+- orange
+""")
+# ['apple', 'banana', 'orange']
+
+# Flow style
+data = ys.load("[a, b, c]")
+# ['a', 'b', 'c']
+```
+
+### Nested Structures
+
+```python
+data = ys.load("""
+person:
+  name: Alice
+  age: 30
+  hobbies:
+    - reading
+    - coding
+    - hiking
+""")
+# {
+#   'person': {
+#     'name': 'Alice',
+#     'age': 30,
+#     'hobbies': ['reading', 'coding', 'hiking']
+#   }
+# }
+```
+
+### Multi-Document YAML
+
+```python
+# Load all documents from a multi-document YAML string
+docs = ys.load_all("""---
+name: Document 1
+---
+name: Document 2
+---
+name: Document 3
+""")
+# [
+#   {'name': 'Document 1'},
+#   {'name': 'Document 2'},
+#   {'name': 'Document 3'}
+# ]
+```
+
+### Type Coercion
+
+YAMLStar follows YAML 1.2 core schema type inference:
+
+```python
+data = ys.load("""
+string: hello
+integer: 42
+float: 3.14
+bool_true: true
+bool_false: false
+null_value: null
+""")
+# {
+#   'string': 'hello',
+#   'integer': 42,
+#   'float': 3.14,
+#   'bool_true': True,
+#   'bool_false': False,
+#   'null_value': None
+# }
+```
+
+### Error Handling
+
+```python
+try:
+    data = ys.load("invalid: yaml: syntax")
+except Exception as e:
+    print(f"Error loading YAML: {e}")
+```
+
+### Version Information
+
+```python
+# Get YAMLStar version
+version = ys.version()
+print(f"YAMLStar version: {version}")
+```
+
+## API Reference
+
+### `YAMLStar` Class
+
+#### `__init__()`
+Create a new YAMLStar instance. Each instance maintains its own GraalVM isolate.
+
+```python
+ys = yamlstar.YAMLStar()
+```
+
+#### `load(yaml_input)`
+Load a single YAML document.
+
+**Parameters:**
+- `yaml_input` (str): String containing YAML content
+
+**Returns:**
+- Python object representing the YAML document (dict, list, str, int, float, bool, or None)
+
+**Raises:**
+- `Exception` if the YAML is malformed
+
+**Example:**
+```python
+data = ys.load("key: value")
+```
+
+#### `load_all(yaml_input)`
+Load all YAML documents from a multi-document string.
+
+**Parameters:**
+- `yaml_input` (str): String containing one or more YAML documents
+
+**Returns:**
+- List of Python objects, one per YAML document
+
+**Raises:**
+- `Exception` if the YAML is malformed
+
+**Example:**
+```python
+docs = ys.load_all("---\ndoc1\n---\ndoc2")
+```
+
+#### `version()`
+Get the YAMLStar version string.
+
+**Returns:**
+- str: Version string
+
+**Example:**
+```python
+version = ys.version()
+```
+
+## Development
+
+### Running Tests
+
+```bash
+# Run all tests
+make test
+
+# Run only pytest tests
+make test-pytest
+
+# Run only FFI tests
+make test-ffi
+```
+
+### Building Distribution
+
+```bash
+# Build source distribution
+make dist
+
+# Build and install in development mode
+make install
+```
+
+## Requirements
+
+- **Python**: 3.6 or higher
+- **libyamlstar**: Shared library (installed separately)
+- **System**: Linux or macOS
+
+## Library Search Path
+
+The package searches for `libyamlstar.so` (or `.dylib` on macOS) in:
+
+1. Development path (relative to package)
+2. Directories in `LD_LIBRARY_PATH` environment variable
+3. `/usr/local/lib` (default install location)
+4. `~/.local/lib` (user-local install location)
+
+## Comparison to PyYAML
+
+| Feature | YAMLStar | PyYAML |
+|---------|----------|--------|
+| YAML Version | 1.2 | 1.1 |
+| Implementation | Pure Clojure | C + Python |
+| Type Inference | YAML 1.2 core schema | YAML 1.1 + custom |
+| Native Performance | Yes (GraalVM) | Yes (C extension) |
+| Dependencies | libyamlstar.so | None |
+
+## License
+
+MIT License - See [License](License) file
+
+## Credits
+
+Created by Ingy döt Net, inventor of YAML.
+
+YAMLStar is built on the YAML Reference Parser (pure Clojure implementation).
+
+## Links
+
+- **GitHub**: https://github.com/yaml/yamlstar
+- **YAML Specification**: https://yaml.org/spec/1.2/spec.html

yamlstar-0.1.2/lib/yamlstar.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+setup.cfg
+setup.py
+lib/yamlstar/__init__.py
+lib/yamlstar.egg-info/PKG-INFO
+lib/yamlstar.egg-info/SOURCES.txt
+lib/yamlstar.egg-info/dependency_links.txt
+lib/yamlstar.egg-info/top_level.txt
+test/test_yamlstar.py

yamlstar-0.1.2/lib/yamlstar.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

yamlstar-0.1.2/lib/yamlstar.egg-info/top_level.txt

@@ -0,0 +1 @@
+yamlstar

yamlstar-0.1.2/setup.cfg

@@ -0,0 +1,7 @@
+[metadata]
+description_file = ReadMe.md
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

yamlstar-0.1.2/setup.py

@@ -0,0 +1,46 @@
+#!/usr/bin/env python3
+
+from setuptools import setup
+import re
+from pathlib import Path
+
+# Read version from ../Meta file
+meta_file = Path(__file__).parent.parent / 'Meta'
+meta_content = meta_file.read_text()
+match = re.search(r'^version:\s*(.+)$', meta_content, re.MULTILINE)
+version = match.group(1) if match else None
+
+# Validate version format
+if not version or not re.match(r'^\d+\.\d+\.\d+', version):
+    raise ValueError(f"Invalid or missing version in Meta file: {version}")
+
+setup(
+    name = 'yamlstar',
+    version = version,
+    description = 'Python bindings for YAMLStar - YAML 1.2 loader',
+    long_description = open('ReadMe.md').read() if __name__ == '__main__' else '',
+    long_description_content_type = 'text/markdown',
+    author = 'Ingy döt Net',
+    author_email = 'ingy@ingy.net',
+    url = 'https://github.com/yaml/yamlstar',
+    license = 'MIT',
+    packages = ['yamlstar'],
+    package_dir = {'': 'lib'},
+    python_requires = '>=3.6, <4',
+    install_requires = [],
+    setup_requires = ['wheel'],
+    classifiers = [
+        'Development Status :: 3 - Alpha',
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: MIT License',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Programming Language :: Python :: 3.8',
+        'Programming Language :: Python :: 3.9',
+        'Programming Language :: Python :: 3.10',
+        'Programming Language :: Python :: 3.11',
+        'Programming Language :: Python :: 3.12',
+        'Topic :: Software Development :: Libraries',
+    ],
+)

yamlstar-0.1.2/test/test_yamlstar.py

@@ -0,0 +1,228 @@
+"""
+Tests for yamlstar Python package.
+"""
+import pytest
+import sys
+import os
+
+# Add lib directory to path for testing
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'lib'))
+
+import yamlstar
+
+
+@pytest.fixture
+def ys():
+    """Create a YAMLStar instance for testing."""
+    return yamlstar.YAMLStar()
+
+
+def test_load_simple_scalar(ys):
+    """Test loading a simple scalar value."""
+    result = ys.load("hello")
+    assert result == "hello"
+
+
+def test_load_integer(ys):
+    """Test loading an integer."""
+    result = ys.load("42")
+    assert result == 42
+    assert isinstance(result, int)
+
+
+def test_load_float(ys):
+    """Test loading a float."""
+    result = ys.load("3.14")
+    assert result == 3.14
+    assert isinstance(result, float)
+
+
+def test_load_boolean_true(ys):
+    """Test loading boolean true."""
+    result = ys.load("true")
+    assert result is True
+
+
+def test_load_boolean_false(ys):
+    """Test loading boolean false."""
+    result = ys.load("false")
+    assert result is False
+
+
+def test_load_null(ys):
+    """Test loading null value."""
+    result = ys.load("null")
+    assert result is None
+
+
+def test_load_simple_mapping(ys):
+    """Test loading a simple mapping."""
+    result = ys.load("key: value")
+    assert result == {"key": "value"}
+
+
+def test_load_nested_mapping(ys):
+    """Test loading nested mappings."""
+    yaml_str = """
+outer:
+  inner: value
+"""
+    result = ys.load(yaml_str)
+    assert result == {"outer": {"inner": "value"}}
+
+
+def test_load_mapping_multiple_keys(ys):
+    """Test loading a mapping with multiple keys."""
+    yaml_str = """
+key1: value1
+key2: value2
+key3: value3
+"""
+    result = ys.load(yaml_str)
+    assert result == {
+        "key1": "value1",
+        "key2": "value2",
+        "key3": "value3"
+    }
+
+
+def test_load_simple_sequence(ys):
+    """Test loading a simple sequence."""
+    yaml_str = """
+- item1
+- item2
+- item3
+"""
+    result = ys.load(yaml_str)
+    assert result == ["item1", "item2", "item3"]
+
+
+def test_load_flow_sequence(ys):
+    """Test loading flow-style sequence."""
+    result = ys.load("[a, b, c]")
+    assert result == ["a", "b", "c"]
+
+
+def test_load_type_coercion(ys):
+    """Test YAML 1.2 type coercion."""
+    yaml_str = """
+string: hello
+integer: 42
+float: 3.14
+bool_true: true
+bool_false: false
+null_value: null
+"""
+    result = ys.load(yaml_str)
+    assert result == {
+        "string": "hello",
+        "integer": 42,
+        "float": 3.14,
+        "bool_true": True,
+        "bool_false": False,
+        "null_value": None
+    }
+
+
+def test_load_sequence_of_mappings(ys):
+    """Test loading a sequence of mappings."""
+    yaml_str = """
+- name: Alice
+  age: 30
+- name: Bob
+  age: 25
+"""
+    result = ys.load(yaml_str)
+    assert result == [
+        {"name": "Alice", "age": 30},
+        {"name": "Bob", "age": 25}
+    ]
+
+
+def test_load_mapping_with_sequence_values(ys):
+    """Test loading a mapping with sequence values."""
+    yaml_str = """
+fruits:
+  - apple
+  - banana
+colors:
+  - red
+  - blue
+"""
+    result = ys.load(yaml_str)
+    assert result == {
+        "fruits": ["apple", "banana"],
+        "colors": ["red", "blue"]
+    }
+
+
+def test_load_all_single_document(ys):
+    """Test load_all with a single document."""
+    result = ys.load_all("hello")
+    assert result == ["hello"]
+
+
+def test_load_all_multiple_documents(ys):
+    """Test load_all with multiple documents."""
+    yaml_str = """---
+doc1
+---
+doc2
+---
+doc3"""
+    result = ys.load_all(yaml_str)
+    assert result == ["doc1", "doc2", "doc3"]
+
+
+def test_load_all_with_explicit_markers(ys):
+    """Test load_all with explicit document markers."""
+    yaml_str = """---
+a: 1
+...
+---
+b: 2
+..."""
+    result = ys.load_all(yaml_str)
+    assert result == [{"a": 1}, {"b": 2}]
+
+
+def test_version(ys):
+    """Test getting the version string."""
+    version = ys.version()
+    assert isinstance(version, str)
+    assert len(version) > 0
+
+
+def test_error_handling_malformed_yaml(ys):
+    """Test that malformed YAML raises an exception."""
+    # Unclosed quote is truly malformed
+    malformed_yaml = 'key: "unclosed'
+    with pytest.raises(Exception):
+        ys.load(malformed_yaml)
+
+
+def test_empty_document(ys):
+    """Test loading an empty document."""
+    result = ys.load("")
+    assert result is None
+
+
+def test_whitespace_only(ys):
+    """Test loading whitespace-only document."""
+    result = ys.load("   \n  \n  ")
+    assert result is None
+
+
+def test_quoted_strings(ys):
+    """Test loading quoted strings."""
+    result1 = ys.load("'hello world'")
+    assert result1 == "hello world"
+
+    result2 = ys.load('"hello world"')
+    assert result2 == "hello world"
+
+
+def test_module_version():
+    """Test that the module has a version attribute."""
+    assert hasattr(yamlstar, 'yamlstar_version')
+    assert isinstance(yamlstar.yamlstar_version, str)