Skip to content

Commit e70a046

Browse files
authored
Create CONTRIBUTING.md
1 parent a99e604 commit e70a046

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

CONTRIBUTING.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
## Contributing
2+
3+
Please see [the wiki](wiki) for more information regarding development.
4+
5+
### Installation
6+
7+
The project includes a maven configuration file using the tycho plug-in, which is part of the [maven eclipse plugin](http://www.eclipse.org/m2e/). Running `mvn install` will install *most* dependencies. Note that if you are not using maven, this plugin depends on https://github.com/khatchad/edu.cuny.citytech.refactoring.common, the **Eclipse SDK**, **Eclipse SDK tests**, and the **Eclipse testing framework**. The latter three can be installed from the "Install New Software..." menu option under "Help" in Eclipse.
8+
9+
### Generating Entry Points Files
10+
11+
Each time we run the evaluation, a text file is generated in the working directory. Then, before the next time you run the evaluation on the same project, move or copy `entry_points.txt` into project directory or workspace directory of the project. While evaluating the project, if the file exists, the tool will ignore the explicit entry points that are added manually and recognize the explicit entry points through the file only.
12+
13+
### Dependencies
14+
15+
You should have the following projects in your workspace:
16+
17+
1. [WALA stream branch](https://github.com/ponder-lab/WALA/tree/streams). Though, not all projecst are necessary. You can close thee ones related to JavaScript and Android.
18+
1. [SAFE](https://github.com/ponder-lab/safe).
19+
1. [Common Eclipse Java Refactoring Framework](https://github.com/ponder-lab/Common-Eclipse-Java-Refactoring-Framework).
20+
21+
It's also possible just to use `mvn install` if you do not intend on changing any of the dependencies.
22+
23+
### Running the Evaluator
24+
25+
#### Configuring the Evaluation
26+
27+
A file named `eval.properties` can be placed at the project root. The following keys are available:
28+
29+
Key | Value Type | Description
30+
---------------- | ---------- | ----------
31+
nToUseForStreams | Integer | The value of N to use while building the nCFA for stream types.
32+
33+
[wiki]: https://github.com/ponder-lab/Java-8-Stream-Refactoring/wiki
34+
[annotations]: https://github.com/ponder-lab/edu.cuny.hunter.streamrefactoring.annotations
35+
[wala]: https://github.com/wala/WALA
36+
[safe]: https://github.com/tech-srl/safe

0 commit comments

Comments
 (0)