hare-wren
=========

`hare-wren`_ provides support for embedding `Wren <https://wren.io>`_ scripts into
Hare programs, as well as an optional lightweight "standard" library for Wren
via wren::api.

.. _hare-wren: https://sr.ht/~sircmpwn/hare-wren

.. code-block:: hare

   const vm = wren::new(wren::stdio_config);
   defer wren::destroy(vm);
    
   wren::interpret(vm, "main", `System.print("Hello world!")`)!;

This documentation primarily covers the integration between Hare and Wren. For
the full details on Wren, consult `the upstream Wren documentation
<https://wren.io>`_.

.. warning::
   Programs which use hare-wren must link to libc! Use ``hare build -lc ...``
   for this purpose.

Getting started
---------------

See `hare-wren`_ for the source code and details on installing hare-wren.

.. toctree::
   :maxdepth: 2
   :caption: Contents:

   cli/index.rst
   modules/index.rst
   embedding/index.rst
   stdlib/index.rst
   wren/index.rst