ChaiScript

Estado maestro:

Estado de desarrollo:

ChaiScript

http://www.chaiscript.com

(c) 2009-2012 Jonathan Turner (c) 2009-2017 Jason Turner

Lanzamiento bajo la licencia BSD, consulte "license.txt" para obtener más detalles.

Introducción

ChaiScript es uno de los únicos lenguajes de programación integrados diseñados desde cero para apuntar directamente a C++ y aprovechar las técnicas modernas de desarrollo de C++, trabajando con el desarrollador sobre cómo esperarían que funcionara. Al ser una aplicación C++ nativa, tiene algunas ventajas sobre los lenguajes de secuencias de comandos integrados existentes:

1. Utiliza un enfoque de solo encabezado, lo que facilita la integración con proyectos existentes.
2. Mantiene la seguridad de tipos entre su aplicación C++ y los scripts de usuario.
3. Admite una variedad de técnicas de C++ que incluyen devoluciones de llamada, funciones sobrecargadas, métodos de clase y contenedores stl.

Requisitos

ChaiScript requiere un compilador de C++ 17 para compilar con soporte para plantillas variadas. Ha sido probado con gcc 7 y clang 6 (con libcxx).

Instalación usando vcpkg

Puede descargar e instalar ChaiScript utilizando el administrador de dependencias vcpkg:

 git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg integrate install
vcpkg install chaiscript

Los miembros del equipo de Microsoft y los contribuyentes de la comunidad mantienen actualizado el puerto ChaiScript en vcpkg. Si la versión no está actualizada, cree un problema o una solicitud de extracción en el repositorio de vcpkg.

Uso

• Agregue el directorio de inclusión de ChaiScript a la ruta de búsqueda del encabezado de su proyecto
• Agregue #include <chaiscript/chaiscript.hpp> a su archivo fuente
• Cree una instancia del motor ChaiScript en su aplicación. Por ejemplo, cree un nuevo motor con el nombre chai así: chaiscript::ChaiScript chai
• El comportamiento predeterminado es cargar la biblioteca estándar ChaiScript desde un módulo cargable. Una segunda opción es compilar la biblioteca en su código; vea un ejemplo a continuación.

Una vez creado una instancia, el motor está listo para comenzar a ejecutar la fuente ChaiScript. Tiene dos opciones principales para procesar el código fuente de ChaiScript: una línea a la vez usando chai.eval(string) y un archivo a la vez usando chai.eval_file(fname)

Para que las funciones de su código C++ sean visibles para los scripts, deben estar registradas en el motor de scripting. Para hacerlo, llame a agregar:

 chai.add(chaiscript::fun(&my_function), "my_function_name");

Una vez registrada, la función será visible para los scripts como "my_function_name"

Ejemplos

ChaiScript es similar a ECMAScript (también conocido como JavaScript(tm)), pero con algunas modificaciones para hacerlo más fácil de usar. Para ver ejemplos de uso, consulte el directorio "samples" y, para una visión más profunda del lenguaje, las pruebas unitarias en el directorio "unittests" cubren la mayor parte del terreno.

Para ver ejemplos de cómo registrar partes de su aplicación C++, consulte "example.cpp" en el directorio "samples". Ejemplo.cpp es detallado y muestra todas las formas posibles de trabajar con la biblioteca. Para obtener más documentación, genere la documentación de doxygen en la carpeta de compilación o consulte el sitio web http://www.chaiscript.com.

El ejemplo completo más corto posible es el siguiente:

 // / main.cpp

# include < chaiscript/chaiscript.hpp >

double function ( int i, double j)
{
  return i * j;
}

int main ()
{
  chaiscript::ChaiScript chai;
  chai. add ( chaiscript::fun (&function), " function " );

  double d = chai. eval < double >( " function(3, 4.75); " );
}