Overview

HTTPS SSH

This code is part of the SAsSy project undertaken at the University of Aberdeen.

The program is wirtten in python (version 3.3) and uses the folling libs:
PyQt5 - for GUI rdflib - manipulating ontologies pyparsing - parsing argumentation KB yaml - parsing logging configuration
The full project is split into 4 git repositories:
https://bitbucket.org/rkutlak/sassy - the main project https://bitbucket.org/rkutlak/sassyargumentation - the argumentation lib https://bitbucket.org/rkutlak/sassygraph - graphics lib https://bitbucket.org/rkutlak/sassynlg - NLG lib
To download the necessary packages use the following git commands:
git clone https://rkutlak@bitbucket.org/rkutlak/sassy.git cd sassy git submodule init git submodule update # sometimes the modules are not updated - do that manually cd sassynlg git checkout master git pull cd ../sassygraph git checkout master git pull cd ../sassyargumentation git checkout master git pull cd ..
And run the program:
python3 sassy/main.py
Subdirectories of SAsSy:
resources/ - various resource files test/ - source code for tests
src is divided in various packages:
formats - input and output parsers/generators for various formats ui - user interface

To run the tests run 'python3 -m argumentation.test.main' from the package folder. Only modules named "test_*.py" will be executed and from those only methods starting "test_" are executed as actual tests.

To find coverage of the tests, install the package coverage and run the tests:
cd tests coverage run main.py coverage html

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Installation: I. Download and install Python 3

  • for simplicity use the official binary for your system downloaded from
    http://python.org/getit
  • the source is being developed on Python version 3.3 on Mac
  1. Download and install Qt5 - again, binary from http://qt-project.org/ should be sufficient - the source is being developed using Qt 5
  2. Download and install PyQt5
  1. First download and install SIP (the latest version)
    • extract the archive and inside the sip folder run:

    python3 configure.py make sudo make install

  2. Download and install PyQt5 from source
    • again extract the downloaded source code and inside the folder run:

    python3 configure.py make sudo make install

This will take a while to compile, PyQt should automatically use the Qt version installed by default in /Applications

In case the configure script cannot find Qt or SIP, pass the path as a parameter: python3 configure.py --qmake=/path/to/qmake --sip=/path/to/sip

  1. rdflib https://pypi.python.org/pypi/rdflib/ You should be able to install rdflib from the main python package site: sudo easy_install rdflib # or easy_install3 if python 3 is not your default
  2. PyParsing
    https://pypi.python.org/pypi/pyparsing Same as rdflib, you should be able to install pyparsing

You should now have all the necessary packages installed in your python3 dist.

You can test whether individual packages work by running python3 and importing one package at a time (e.g., import PyQt5). No errors should occur.