Skip to content
SAApy - System Architecture Assessment Toolset
Python ANTLR PLpgSQL SQLPL
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
antlr/grammars-v4/tsql
data
dock
docs
saapy
samples
tasks
tests
.gitignore
.travis.yml
LICENSE
README.md
pip.conf
pytest.ini
requirements.txt
setup.cfg
setup.py

README.md

Build Status

SAApy - System Architecture Assessment Toolkit

The assessment toolkit provides a set of tools implemented in python helping build a graph from software system artifacts such as source code structures, dependencies, issues, commit history, and others, and analyze the software system for its quality and technical debt based on this graph.

The framework is a research tool and is not of stable production quality yet.

Installation Steps

To setup saapy based environment please follow steps similar to below. The saapy library is not on pypi yet hence a somewhat unconventional process.

  1. Make sure you have python 3.5+ installed and use it as a default python environment in the next steps.
  2. Create the projects root directory:
    mkdir ~/Projects && cd ~/Projects
  3. Clone saapy from GitHub. If you have it already cloned, you can skip this step.
    git clone https://github.com/ashapochka/saapy.git
  4. Create python3 virtual environment to isolate saapy specific installation.
    pyvenv saapyenv
  5. Activate the environment and run further steps in it (check on terminal cmd prefix)
    source saapyenv/bin/activate
  6. Install numpy explicitly otherwise pymc installation fails later on.
    pip install numpy
  7. Install saapy third party dependencies in a batch (can take a couple of minutes).
    pip install -r saapy/requirements.txt
  8. Install saapy itself in the development mode.
    pip install -e ./saapy

Assessment Environment

First, make sure you executed the steps in the Installation section. To prepare the assessment environment for a specific project follow the steps:

  1. Create a project working directory.
    mkdir ~/Projects/prj1 && cd ~/Projects/prj1
  2. Activate the environment if inactive.
    source ../saapyenv/bin/activate
  3. Add any files required for processing into the working directory.
  4. Run Jupyter notebook server to write and execute assessment notebooks based on the saapy.
    jupyter-notebook --working-dir=`pwd`

(c) Andriy Shapochka

You can’t perform that action at this time.