Metadata-Version: 2.4
Name: yace
Version: 0.8.0
Summary: yace aka Yet Another Code Emitter / Your Artisanal Code Emitter
Author-email: "Simon A. F. Lund" <os@safl.dk>
Maintainer-email: "Simon A. F. Lund" <os@safl.dk>
License-Expression: GPL-2.0-only
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Framework :: Pytest
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Software Development
Classifier: Topic :: Text Processing
Classifier: Topic :: Utilities
Requires-Python: >=3.12
Description-Content-Type: text/x-rst; charset=UTF-8
License-File: LICENSE
Requires-Dist: jinja2
Requires-Dist: pyyaml
Requires-Dist: pydantic<3.0,>=2.0
Requires-Dist: libclang~=14.0.1
Provides-Extra: dev
Requires-Dist: coverage; extra == "dev"
Requires-Dist: kmdo; extra == "dev"
Requires-Dist: pudb; extra == "dev"
Requires-Dist: sphinx; extra == "dev"
Requires-Dist: wheel; extra == "dev"
Provides-Extra: all
Requires-Dist: yace[dev]; extra == "all"
Dynamic: license-file

.. image:: docs/src/_static/yace-mascot.png
   :alt: yace

Welcome to yace
===============

.. image:: https://img.shields.io/pypi/v/yace.svg
   :target: https://pypi.org/project/yace
   :alt: PyPI

.. image:: https://github.com/safl/yace/actions/workflows/docs.yml/badge.svg
   :target: https://github.com/safl/yace/actions
   :alt: Build Status

.. image:: https://coveralls.io/repos/github/safl/yace/badge.svg?branch=main
   :target: https://coveralls.io/github/safl/yace?branch=main

.. image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit
   :target: https://github.com/safl/yace/blob/main/.pre-commit-config.yaml
   :alt: pre-commit

**yace** generates the bindings of a C API for other languages. You describe the
FFI boundary of the API as a C header, in a subset of C99 that can be described
equivalently in C, C++, Python, Rust and Zig, and **yace** generates, for each,
code that is idiomatic for that language: for C, a C API with pretty-printers
for every struct, union and enum. A field of bits, an integer whose parts are
named by masks, is printed part by part, and read and written by part in every
language. Headers outside the subset are parsed too, with every place they step
outside it reported.

* The project is hosted on `GitHUB`_

* Documentation is available at `safl.dk/yace`_

**yace** is a new project, with a bunch of things it want to get done, why?
Because there are some projects that need a better way to handle C headers and
libraries bindings. If you want to help out, then don't be shy, there are
plenty of things to do.

.. _GitHUB: https://github.com/safl/yace
.. _safl.dk/yace: https://safl.dk/yace

