Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/opensmock/reusetale
ReuseTale is a project to support the analysis of a re-use feedback in an industrial context. ReuseTale help us to import, visualize and analyse some projects datas (source-code and contributors).
https://github.com/opensmock/reusetale
components molecule pharo smalltalk
Last synced: 23 days ago
JSON representation
ReuseTale is a project to support the analysis of a re-use feedback in an industrial context. ReuseTale help us to import, visualize and analyse some projects datas (source-code and contributors).
- Host: GitHub
- URL: https://github.com/opensmock/reusetale
- Owner: OpenSmock
- License: mit
- Created: 2021-02-12T17:13:27.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2021-09-24T06:57:14.000Z (over 3 years ago)
- Last Synced: 2024-11-12T04:34:44.784Z (3 months ago)
- Topics: components, molecule, pharo, smalltalk
- Language: Smalltalk
- Homepage:
- Size: 402 KB
- Stars: 0
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ReuseTale
ReuseTale goal is to support the analysis of software reuse in an industrial context. ReuseTale makes it available tools to import, to visualize and to analyse some projects data. The original objective is to study the reuse of code elements between projects over fifteen years of software development. A descriptive part of the data is used, as well as a formatting in the form of 2D visualizations. All the provided tools are reusable for other studies. The input data set consists of two CSV files the format of which is described below.
These two files are here :
* [Prototypes_data.csv](https://github.com/OpenSmock/ReuseTale/blob/main/Prototypes_data.csv)
* [SubSystems_data.csv](https://github.com/OpenSmock/ReuseTale/blob/main/SubSystems_data.csv)
## Prototypes data
This file contains on each lines some prototypes and there used subsystem, each prototypes is separated by an empty line. Each columns details theses collected datas : Total components, Total classes (including components), Total classes (without components), Total methods, Prototype period start (DD MM YYYY - date of first publication), Prototype period stop (DD MM YYYY - date of last publication), Prototype's developers (each developper is identified by a Number, i.e. dev 1, dev 2 and dev 3), number of publications of the prototype.
## SubSystems data
This file contains on each columns a subsystem. Each lines details theses collected datas for each subsystem : Description, number of publications, date of first publication, date of last publication, number of subsystem developers.
## Software in use
For formatting we use the [Pharo](https://pharo.org/) development environment and for programming graphics the [Roassal3](https://github.com/ObjectProfile/Roassal3) library.
## How to install and use the project
This section detail how to install the project from scratch.
### Get Pharo 9 (also available for Pharo 8)
Download and install the [Pharo Launcher](https://pharo.org/download.html) for your operating system (Windows, GNU/Linux or MacOs).
The Pharo launcher help to download and install some Pharo images, some documentation here to [install a Pharo 9 image with the Pharo Launcher](https://pharo-project.github.io/pharo-launcher/create-images/).
When the pharo 9 image is created, start it and execute the loading project code below.
### Loading project into Pharo
For Pharo 9, open a Playground and execute this code :
```Smalltalk
Metacello new
repository: 'github://OpenSmock/ReuseTale:main';
baseline: 'ReuseTale';
load.
```
The project works on Pharo 8 (same script to import it) without graph exportation.
### Import datas from files
#### Method A : Import datas with our Wizard
This is an UI to import your own files.
```Smalltalk
"First file"
RTPrototypeDataRepository openFileToBuildSubSystemsData.
```
```Smalltalk
"Second file"
RTPrototypeDataRepository openFileToBuildPrototypesData.
```
#### Method B : Import datas manualy ("DoIt" method)
These scripts imports project data files (two .csv files in project root).
Open a Playground and execute this code :
```Smalltalk
"First file"
RTPrototypeDataRepository buildSubSystemsDataFromFilename: 'SubSystems_data.csv' asFileReference.
```
Open a Playground and execute this code :
```Smalltalk
"Second file"
RTPrototypeDataRepository buildPrototypesDataFromFilename: 'Prototypes_data.csv' asFileReference.
```
### How to consult some stat view
Browse the Pharo classes packages to our projet : "ReuseTale" and go to the "RTGraphs" class. In class side select the script yout want to run and display the stat view in a window. Each opened stat view is automaticaly exported into a PDF file at the root of the pharo image.
### Navigate on imported datas
#### Prototypes datas
```Smalltalk
RTPrototypeDataRepository prototypes inspect.
```
#### SubSystems datas
```Smalltalk
RTPrototypeDataRepository subSystems inspect.
```
### Remove imported datas
```Smalltalk
RTPrototypeDataRepository reset.
```
## To know more...
Some related links :
* [15 years of reuse experience in evolutionary prototyping for the defense industry](https://doi.org/10.1007/978-3-030-64694-3_6) : The paper at the beginning of the project
* [Molecule: live prototyping with component-oriented programming](https://hal.inria.fr/hal-02966704)
* [Molecule, a component oriented framework for Pharo](https://github.com/OpenSmock/Molecule)
Some related videos :
[](https://www.youtube.com/embed/k9raUDp5ugA)
## Credits
* **Pierre Laborde** - *Initial work* - [labordep](https://github.com/labordep)
* **Steven Costiou** - *Initial work* - [StevenCostiou](https://github.com/StevenCostiou)
* **Eric Le Pors** - *Initial work* - [ELePors](https://github.com/ELePors)
* **Alain Plantec** - *Initial work* - [plantec](https://github.com/plantec)
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.