Skip to content

A logic programming library for Clojure & ClojureScript

License

Notifications You must be signed in to change notification settings

clojure/core.logic

Repository files navigation

core.logic

A logic programming library for Clojure & ClojureScript. core.logic offers Prolog-like relational programming, constraint logic programming, and nominal logic programming for Clojure. At its heart is an original implementation of miniKanren as described in William Byrd's dissertation Relational Programming in miniKanren: Techniques, Applications, and Implementations as well as the extensions described in cKanren and αKanren. It is designed to be easily extended to forms of logic programming beyond the ones provided.

Releases and dependency information

This project follows the version scheme MAJOR.MINOR.PATCH where each component provides some relative indication of the size of the change, but does not follow semantic versioning. In general, all changes endeavor to be non-breaking (by moving to new names rather than by breaking existing names).

Latest stable release: 1.1.0

CLI/deps.edn dependency information:

org.clojure/core.logic {:mvn/version "1.1.0"}

Leiningen dependency information:

[org.clojure/core.logic "1.1.0"]

Maven dependency information:

<dependency>
  <groupId>org.clojure</groupId>
  <artifactId>core.logic</artifactId>
  <version>1.1.0</version>
</dependency>

Example usage

(use 'clojure.core.logic)

(run* [q]
  (== q true))  
;;=> (true)

Running the tests

Assuming you have V8 installed from source:

lein cljsbuild once adv
d8 resources/tests.js

If you have another JS engine installed use that instead.

Reasoned Schemer

If you wish to work through The Reasoned Schemer with core.logic make sure to look over this first.

If you're interested in using core.logic from ClojureScript look here.

For more information & documentation please consult the wiki.

Differences from core.unify

core.unify provides a la carte unification facilities that are not deeply tied into the operation of a logic engine. While core.logic does provide a similar simple unifier interface with support for specifying fine-grained constraints, if you have no need for a logic programming system, core.unify may be a better fit.

YourKit

YourKit has given an open source license for their profiler, greatly simplifying the profiling of core.logic performance.

YourKit supports open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of YourKit Java Profiler and YourKit .NET Profiler, innovative and intelligent tools for profiling Java and .NET applications.

Developer information

Copyright and license

Copyright © David Nolen, Rich Hickey & contributors.

Licensed under the EPL (see the file epl.html).