An open API service indexing awesome lists of open source software.

https://github.com/mariazevedo88/o3smeasures-tool

Eclipse plug-in to evaluate software internal quality of Java projects.
https://github.com/mariazevedo88/o3smeasures-tool

application-metrics aws-s3 csv-export eclipse eclipse-application eclipse-ide eclipse-marketplace eclipse-plugin java java-application-framework java-application-metrics java-metrics java8 jdt junit5 metrics oxygen photon plugin xml-export

Last synced: 2 months ago
JSON representation

Eclipse plug-in to evaluate software internal quality of Java projects.

Awesome Lists containing this project

README

        


[![Build Status](https://travis-ci.org/mariazevedo88/o3smeasures-tool.svg?branch=master)](https://travis-ci.org/mariazevedo88/o3smeasures-tool) ![Java CI](https://github.com/mariazevedo88/o3smeasures-tool/workflows/Java%20CI/badge.svg?branch=master) ![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/mariazevedo88/o3smeasures-tool.svg) ![Eclipse Marketplace](https://img.shields.io/eclipse-marketplace/v/o3smeasures.svg) ![GitHub All Releases](https://img.shields.io/github/downloads/mariazevedo88/o3smeasures-tool/total.svg) ![Eclipse Marketplace](https://img.shields.io/eclipse-marketplace/dt/o3smeasures.svg) ![GitHub](https://img.shields.io/github/license/mariazevedo88/o3smeasures-tool.svg) ![Eclipse Marketplace](https://img.shields.io/eclipse-marketplace/favorites/o3smeasures)

![GitHub repo size](https://img.shields.io/github/repo-size/mariazevedo88/o3smeasures-tool.svg) ![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/mariazevedo88/o3smeasures-tool.svg) ![GitHub language count](https://img.shields.io/github/languages/count/mariazevedo88/o3smeasures-tool.svg) ![GitHub top language](https://img.shields.io/github/languages/top/mariazevedo88/o3smeasures-tool.svg) ![GitHub last commit](https://img.shields.io/github/last-commit/mariazevedo88/o3smeasures-tool.svg) ![GitHub issues](https://img.shields.io/github/issues-raw/mariazevedo88/o3smeasures-tool) ![GitHub pull requests](https://img.shields.io/github/issues-pr-raw/mariazevedo88/o3smeasures-tool)

## o3smeasures

*Plug-in for Eclipse to measure software internal quality. It was developed as part of my dissertation entitled "A Quantitative Study to Characterize the Internal Quality of Open-Source Object-Oriented Software Systems".*

## About o3smeasures
This is a plug-in for Eclipse to measure software internal quality in Java projects.
In the plug-in development, we used the Eclipse IDE (Oxygen), the Java Development Tools (JDT), the Plug-in Development Environment (PDE), and Abstract Syntax Tree (AST). In JDT, there are tools for manipulating Java code. In PDE, there are tools to develop and test plug-ins in the Eclipse IDE.

## Dependencies

- Java 8 or higher
- Eclipse IDE Oxygen or higher
- jUnit 5 (org.junit.jupiter.api, org.junit.jupiter.engine and org.junit.jupiter.params - 5.0.0)
- org.eclipse.ui (3.109.0 or higher)
- org.eclipse.core.resources (3.12.0 or higher)
- org.eclipse.jdt.core (3.13.102 or higher)
- org.eclipse.core.runtime (3.13.0 or higher)
- org.eclipse.jface.text (3.12.2 or higher)

## How to use as an Eclipse Application

o3smeasures can be used as an Eclipse Application, importing the project into your workspace.
After import the o3smeasures project, with the right mouse button you need select the option
Run as -> Eclipse Application. In the runtime eclipse application, select a Java project to be measured and with the right mouse button, go to O3SMeasures -> Analyze Java project.

## Executing tests

After import the o3smeasures project, with the right mouse button you need select the option
Run as -> JUnit Plug-in Test.

## How to install

### On dropins directory

o3smeasures plug-in is installed in the Eclipse directory. You need to paste the .jar on the dropins directory (eclipse -> dropins).
After installed the o3smeasures project into your workspace, select a Java project to be measured and with the right mouse button, go to O3SMeasures -> Analyze Java project.

### Install new Software interface

Run Eclipse, go to Help menu -> Install New Software... On the opening dialog add a new Remote site named o3smeasures with the following url `https://raw.githubusercontent.com/mariazevedo88/o3smeasures-plugin/master/site.xml` and follow the instructions.

### On Eclipse Marketplace

Run Eclipse, go to Help menu -> Eclipse Marketplace... On the opening dialog, search for `o3smeasures`. Finding the plugin, click on the Install button and follow the instructions.

## Displaying the views

The o3smeasures views can be enabled by the eclipse menu Window -> Show View -> Other ... -> o3smeasures.




## Exporting files

To export the measurement results in the O3SMeasures Diagnostic view, with the right mouse button in the view, select the option Export to CSV file to export in the `.csv` format or Export to XML file to export in the `.xml` format.


## Uploading files

In version 2.1.0 or above, it is possible to upload measurement diagnostic reports to an s3 bucket on Amazon (AWS). With the right mouse button in the view, select the option Upload to AWS S3 Bucket to export in the `.csv` or `.xml` format.


The formating options and the bucket configurations has to be defined on the Preferences Page, that can be access by the eclipse menu Window -> Preferences -> o3smeasures Preferences.


## Contributing

[![](https://sourcerer.io/fame/mariazevedo88/mariazevedo88/o3smeasures-tool/images/0)](https://sourcerer.io/fame/mariazevedo88/mariazevedo88/o3smeasures-tool/links/0)[![](https://sourcerer.io/fame/mariazevedo88/mariazevedo88/o3smeasures-tool/images/1)](https://sourcerer.io/fame/mariazevedo88/mariazevedo88/o3smeasures-tool/links/1)[![](https://sourcerer.io/fame/mariazevedo88/mariazevedo88/o3smeasures-tool/images/2)](https://sourcerer.io/fame/mariazevedo88/mariazevedo88/o3smeasures-tool/links/2)[![](https://sourcerer.io/fame/mariazevedo88/mariazevedo88/o3smeasures-tool/images/3)](https://sourcerer.io/fame/mariazevedo88/mariazevedo88/o3smeasures-tool/links/3)[![](https://sourcerer.io/fame/mariazevedo88/mariazevedo88/o3smeasures-tool/images/4)](https://sourcerer.io/fame/mariazevedo88/mariazevedo88/o3smeasures-tool/links/4)[![](https://sourcerer.io/fame/mariazevedo88/mariazevedo88/o3smeasures-tool/images/5)](https://sourcerer.io/fame/mariazevedo88/mariazevedo88/o3smeasures-tool/links/5)[![](https://sourcerer.io/fame/mariazevedo88/mariazevedo88/o3smeasures-tool/images/6)](https://sourcerer.io/fame/mariazevedo88/mariazevedo88/o3smeasures-tool/links/6)[![](https://sourcerer.io/fame/mariazevedo88/mariazevedo88/o3smeasures-tool/images/7)](https://sourcerer.io/fame/mariazevedo88/mariazevedo88/o3smeasures-tool/links/7)