A NREPL client for Protege
Clojure Java Shell
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
nrepl-clojure
nrepl-plugin
.gitignore
README.md
build-plugin.sh

README.md

Protege-Nrepl

This is a plugin for the Protege Ontology Editor, which enables nrepl connection to an existing editor. The pomegranate library is included in the bundle, which means that new maven dependencies or classpath directories can be added dynamically. Access to the Protege internal data structures is possible, meaning that the Protege instance can be manipulated remotely.

Although, it is not tied to it, Protege-Nrepl is being developed for use with the Tawny-OWL library; currently, the release version of Protege and Tawny use different versions of the OWL API, so a specialized build of Protege is needed.

Build

Both maven and leiningen are required to build the plugin. To build,

cd nrepl-plugin
mvn install

A small build.sh script is included which copies the jar file into protege.

Usage

Install the plugin as a normal Protege plugin. This adds a single menu item into "Tools", called NREPL, which can be used to launch a REPL for the current Protege workspace.

The protege.model Clojure namespace provides a number of different vars, dynamically scoped to the current workspace which you can use to affect the running Protege instance (if you don't want to do this, there isn't much point in launching a REPL within Protege!), as well as some utility functions.

As Clojure itself and the nrepl server, protege-nrepl packages pomegranate which enables the addition of new dependencies or directories to the classpath in the existing JVM. The easiest way to do this is to use lein-sync which creates the relevant function calls from a leiningen project.

Init

protege-nrepl loads an init file when launching clojure (this happens when the NREPL menu item is clicked and not when Protege is launched. This file is found at ~/.protege-nrepl/init.clj, or equivalent on different OSes.

My init.clj is shown in full at https://github.com/phillord/tawny-protege/README.md, and enables use with Tawny-OWL. This setting -- which autoconnects a nrepl once the dialog is started, is generally useful.

;; initing the dialog takes ages -- so auto connect
(dosync (ref-set protege.model/auto-connect-on-default true))

Mailing List

There is a mailing list

License

The contents of this file are subject to the LGPL License, Version 3.0.

Copyright (C) 2012, 2013, Newcastle University

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this program. If not, see http://www.gnu.org/licenses/.