compatibilidad-con-nodejs.md

Compatibilidad con Node.js

Tau Prolog está preparado para ser utilizado tanto en Node.js como en un navegador, sin ser necesario ningún cambio. En esta página se describen los pasos necesarios para importar tanto la biblioteca como los módulos de Tau Prolog en Node.js.

Nota: Recuerda que Node.js busca los paquetes en su repositorio de paquetes globales, a menos que la ruta se preceda de un punto para indicar que busque en el directorio actual. Por lo tanto, aunque almacenes la biblioteca de Tau Prolog en el mismo directorio, tendrás que utilizar una ruta de la forma "./tau-prolog.js".

Importar la biblioteca

Para importar la biblioteca de Tau Prolog, hay que utilizar la función require de Node.js:

const pl = require("tau-prolog");

Todos los métodos de Tau Prolog están contenidos en un objeto JavaScript llamado pl. Esta variable puede tomar cualquier nombre en Node.js, pero, por compatibilidad con la versión de navegador, se recomienda utilizar el nombre pl. A partir de ahora, ya se puede utilizar la biblioteca tal y como se describe en otras secciones del manual (véase Un tutorial sencillo del manual de Tau Prolog), exceptuando la importación de la biblioteca y los módulos de Tau Prolog.

Cargar módulos

Dado que no es posible asegurar que la biblioteca de Tau Prolog esté contenida en el objeto pl, al importar un módulo se devolverá una función de carga (un loader) que recibirá la referencia a la biblioteca y cargará el módulo correspondiente en ella:

const pl = require("tau-prolog");
const loader = require("tau-prolog/modules/lists.js");
loader(pl);

Una versión abreviada de esto sería:

const pl = require("tau-prolog");
require("tau-prolog/modules/lists.js")(pl);

Con esto, se han cargado todos los predicados que exportan los módulos importados. En nuestro ejemplo, los predicados del módulo lists. Es importante tener en cuenta que en Node.js, el núcleo y cada uno de los módulos deben ser descargados e importados por separado. Por ejemplo, si queremos cargar dos módulos:

const pl = require("tau-prolog");
require("tau-prolog/modules/lists.js")(pl);
require("tau-prolog/modules/random.js")(pl);

Ejemplo de uso

El siguiente código carga un pequeño programa Prolog que almacena información sobre productos y tiendas donde se venden los mismos.

// Import Tau Prolog core and create a session
const pl = require("tau-prolog");
const session = pl.create(1000);
const show = x => console.log(session.format_answer(x));

// Get Node.js argument: node ./script.js item
const item = process.argv[2];

// Program and goal
const program = `
	% Products
	item(id(1), name(bread)).
	item(id(2), name(water)).
	item(id(3), name(apple)).
	% Shops
	shop(id(1), name(tau), location(spain)).
	shop(id(2), name(swi), location(netherlands)).
	% Stock
	stock(item(1), shop(1), count(23), price(0.33)).
	stock(item(2), shop(1), count(17), price(0.25)).
	stock(item(2), shop(2), count(34), price(0.31)).
	stock(item(3), shop(2), count(15), price(0.45)).
`;
const goal = `
	item(id(ItemID), name(${item})),
	stock(item(ItemID), shop(ShopID), _, price(Price)),
	shop(id(ShopID), name(Shop), _).
`;

// Consult program, query goal, and show answers
session.consult(program, {
	success: function() {
		session.query(goal, {
			success: function() {
				session.answers(show);
			}
		})
	}
});

Este script de Node.js recibe un producto como argumento, y consulta en la base de datos el nombre de las tiendas que venden dicho producto y su precio. Si ejecutamos este programa con distintas entradas (donde $ representa el prompt de la línea de comandos), obtenemos:

$ nodejs ./script.js bread
ItemID = 1, ShopID = 1, Price = 0.33, Shop = tau ;
false.

$ nodejs ./script.js water
ItemID = 2, ShopID = 1, Price = 0.25, Shop = tau ;
ItemID = 2, ShopID = 2, Price = 0.31, Shop = swi ;
false.

$ nodejs ./script.js apple
ItemID = 3, ShopID = 2, Price = 0.45, Shop = swi ;
false.

$ nodejs ./script.js milk
false.