pengines

A simple python library for interacting with SWI-Prologs Pengines


Keywords
pengines, pengine, prolog, swipl, swi-prolog, logic, programming
License
MIT
Install
pip install pengines==0.1.8

Documentation

Python Pengines

This is a module for interfacing python with the Prolog Pengines knowledge base.

API

Create a basic run pengine server script, and run it with swipl.

:- use_module(library(http/thread_httpd)).
:- use_module(library(http/http_dispatch)).
:- use_module(library(pengines)).

server(Port) :- http_server(http_dispatch, [port(Port)]).

:- server(4242).

Initialize a basic PengineBuilder

from pengines.Builder import PengineBuilder
from pengines.Pengine import Pengine

pengine_builder = PengineBuilder(urlserver="http://localhost:4242")

Create the pengine querying object.

pengine = Pengine(builder=pengine_builder)
pengine.create()

Make your query -- note the lack of ending period -- Pengine performs the query like 'ask(member(X, [1,2,3], [])).'

query = "member(X, [1,2,3])"
pengine.ask(query)
print(pengine.currentQuery.availProofs)

Iterate through the proofs like this:

while pengine.currentQuery.hasMore:
    pengine.doNext(pengine.currentQuery)
    print(pengine.currentQuery.availProofs)

prologterms library

The python library prologterms aims to make it easier to construct prolog programs and query terms from within python.

For an example of how to use prologterms in conjunction with pengines, see:

https://pypi.org/project/prologterms/

from pengines.Builder import PengineBuilder
from pengines.Pengine import Pengine
from prologterms import TermGenerator, PrologRenderer, Program, Var

P = TermGenerator()
X = Var('X')
Y = Var('Y')
Z = Var('Z')
R = PrologRenderer()

p = Program(
    P.ancestor(X,Y) <= (P.parent(X,Z), P.ancestor(Z,Y)),
    P.ancestor(X,Y) <= P.parent(X,Y),
    P.parent('a','b'),
    P.parent('b','c'),
    P.parent('c','d')
)

q = P.ancestor(X,Y)

factory = PengineBuilder(urlserver="http://localhost:4242",
                         srctext=R.render(p),
                         ask=R.render(q))
pengine = Pengine(builder=factory, debug=True)
while pengine.currentQuery.hasMore:
    pengine.doNext(pengine.currentQuery)
for p in pengine.currentQuery.availProofs:
    print('{} <- {}'.format(p[X.name], p[Y.name]))