libfyaml 1.0.0a2__tar.gz

libfyaml-1.0.0a2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018-2025 Pantelis Antoniou <pantelis.antoniou@konsulko.com>
+
+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.

libfyaml-1.0.0a2/MANIFEST.in

@@ -0,0 +1,17 @@
+# Include essential files for source distribution
+include README.md
+include LICENSE
+include QUICKSTART.md
+include docs/API.md
+include pyproject.toml
+include setup.py
+
+# Include package sources
+recursive-include libfyaml *.c *.py *.pyi
+
+# Exclude build artifacts
+global-exclude *.pyc
+global-exclude *.pyo
+global-exclude *.so
+global-exclude *.pyd
+global-exclude __pycache__

libfyaml-1.0.0a2/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: libfyaml
+Version: 1.0.0a2
+Summary: Python bindings for libfyaml's generic YAML/JSON value model
+Author-email: Pantelis Antoniou <pantelis.antoniou@konsulko.com>
+Maintainer: libfyaml contributors
+License: MIT
+Project-URL: Homepage, https://github.com/pantoniou/libfyaml
+Project-URL: Documentation, https://github.com/pantoniou/libfyaml/tree/master/python-libfyaml
+Project-URL: Repository, https://github.com/pantoniou/libfyaml
+Project-URL: Bug Reports, https://github.com/pantoniou/libfyaml/issues
+Project-URL: Changelog, https://github.com/pantoniou/libfyaml/blob/master/CHANGELOG.md
+Keywords: yaml,json,parser,fast,performance,memory-efficient
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: BSD
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Programming Language :: C
+Classifier: Programming Language :: Python :: 3
+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: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# libfyaml Python Binding
+
+Python bindings for libfyaml's generic YAML/JSON value model.
+
+The binding exposes lazy `FyGeneric` wrappers on top of libfyaml's generic API.
+It supports value-oriented parsing, access, conversion, and emission while
+keeping the same data model used by the C generic runtime.
+
+## Highlights
+
+* YAML and JSON parsing through libfyaml
+* lazy wrappers for mappings, sequences, and scalars
+* direct correspondence with the C `fy_generic` API
+* wheels built from the bundled libfyaml source tree on supported platforms
+
+## Platform Support
+
+The core libfyaml library supports Linux, macOS, FreeBSD, NetBSD, OpenBSD, and
+Windows.
+
+The Python packaging in this directory currently targets:
+
+* wheel builds on Linux and macOS
+* source builds on macOS and the BSDs
+* Windows support is not yet part of the Python wheel build matrix
+
+## Build Modes
+
+When the full libfyaml repository is available, the Python extension builds
+against a bundled static `libfyaml` produced from the parent source tree.
+
+When the repository sources are not available, the build falls back to a
+system-installed `libfyaml` discovered through `pkg-config` or standard system
+paths.
+
+## Links
+
+* API reference: `docs/API.md`
+* Quickstart: `QUICKSTART.md`
+* Project repository: <https://github.com/pantoniou/libfyaml>

libfyaml-1.0.0a2/QUICKSTART.md

@@ -0,0 +1,41 @@
+# Quickstart
+
+## Install From Source
+
+Source builds are the expected path on macOS, FreeBSD, NetBSD, and OpenBSD
+when a prebuilt wheel is not available. Windows support for the Python binding
+is still being validated.
+
+From a full libfyaml checkout:
+
+```bash
+python3 -m pip install ./python-libfyaml
+```
+
+This builds a bundled static `libfyaml` and links the Python extension against
+it.
+
+From an environment with `libfyaml` already installed:
+
+```bash
+LIBFYAML_USE_SYSTEM=1 python3 -m pip install ./python-libfyaml
+```
+
+## Basic Usage
+
+```python
+import libfyaml as fy
+
+doc = fy.loads("server: {host: localhost, port: 8080}")
+server = doc["server"]
+
+print(str(server["host"]))
+print(int(server["port"]))
+```
+
+## Tests
+
+```bash
+cd python-libfyaml
+python3 -m pytest tests/
+```

libfyaml-1.0.0a2/README.md

@@ -0,0 +1,40 @@
+# libfyaml Python Binding
+
+Python bindings for libfyaml's generic YAML/JSON value model.
+
+The binding exposes lazy `FyGeneric` wrappers on top of libfyaml's generic API.
+It supports value-oriented parsing, access, conversion, and emission while
+keeping the same data model used by the C generic runtime.
+
+## Highlights
+
+* YAML and JSON parsing through libfyaml
+* lazy wrappers for mappings, sequences, and scalars
+* direct correspondence with the C `fy_generic` API
+* wheels built from the bundled libfyaml source tree on supported platforms
+
+## Platform Support
+
+The core libfyaml library supports Linux, macOS, FreeBSD, NetBSD, OpenBSD, and
+Windows.
+
+The Python packaging in this directory currently targets:
+
+* wheel builds on Linux and macOS
+* source builds on macOS and the BSDs
+* Windows support is not yet part of the Python wheel build matrix
+
+## Build Modes
+
+When the full libfyaml repository is available, the Python extension builds
+against a bundled static `libfyaml` produced from the parent source tree.
+
+When the repository sources are not available, the build falls back to a
+system-installed `libfyaml` discovered through `pkg-config` or standard system
+paths.
+
+## Links
+
+* API reference: `docs/API.md`
+* Quickstart: `QUICKSTART.md`
+* Project repository: <https://github.com/pantoniou/libfyaml>