Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Prosoul is a software quality models manager to create, import/export, view and edit models

Project description

Prosoul is a software quality models manager to create, import/export, view and edit models.

Description

The goal of this project is to create a web editor and viewer for software quality models that are used to show metrics in a meaning way. Also, importers and exporters for the different quality models used in the industry will be implemented so they can be used as models or evolved for the creation of new quality models.

In the initial version the metrics supported will be the CROSSMINER ones.

Based on the models, visualizations and assessment for the projects are generated. In the inital version Kibana dashoards will be created using GrimoireLab.

The final goal is to have a tool for “Automatic Project Assessment and Visualization based on Evolved Quality Models”.

The original name for this project was Meditor but is was chaged to Prosoul because meditor already was used in pip.

Source code and contributions

All the source code is available in the Prosoul GitHub repository. Please, upload pull requests if you have proposals to change the source code, and open an issue if you want to report a bug, ask for a new feature, or just comment something.

The code of conduct must be followed in all contributions to the project.

Execution

Prosoul is a Django application so to run it you need django installed.

prosoul/django_prosoul $ python3 manage.py makemigrations
prosoul/django_prosoul $ python3 manage.py migrate
prosoul/django_prosoul $ python3 manage.py runserver

By default the applicacion will be accesible in: http://127.0.0.1:8000/

A docker image is also available to execute the application:

prosoul/docker $ docker-compose up

Basic Usage

There is two introductory videos: showing the import and view feature, and howto use the editor for adding a new quality model:

Import / Export

Import and export for quality models can be done using the web interface or from the command line:

  • Import a model from a OSSMeter JSON file:
prosoul/django_prosoul $ PYTHONPATH=. prosoul/prosoul_import.py -f prosoul/data/ossmeter_qm.json --format ossmeter
  • Export a model to a GrimoireLab JSON file:
prosoul/django_prosoul $ PYTHONPATH=. prosoul/prosoul_export.py -f prosoul/data/ossmeter_qm_grimoirelab.json --format grimoirelab -m "Default OSSMETER quality model"

Requirements

  • Python >=3.4
  • setuptools
  • django
  • kidash
  • requests

Architecture

A draft diagram for the architecture is:

Prosoul in CROSSMINER

There is a specific guide for using prosoul in CROSSMINER for creating the visualization for a quality model and generating the assessment of the projects in CROSSMINER.

There is a demo online of prosoul for CROSSMINER.

ROADMAP

The ROADMAP for Prosoul is based on GitHub milestones. The current active work is done in the issues related to the current milestone.

License

Licensed under GNU General Public License (GPL), version 3 or later.

Project details


Release history Release notifications

This version
History Node

0.1.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django-prosoul-0.1.1.tar.gz (98.4 kB) Copy SHA256 hash SHA256 Source None Apr 20, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page