Merge branch '__rultor'

Author: rultor

.gitignore

@@ -9,3 +9,9 @@ output_eo
 polystat_check
 /hadoop/
 /output_hadoop/
+/bin
+/project
+.metals/
+.vscode
+hadoop*
+J2EO*.jar

README.md

@@ -37,6 +37,7 @@ This is a translator of **Java** programming language to [EOLANG](https://www.eo
     ```shell
     ./build.sh
     ```
+    - See the [troubleshooting section](./README.md#troubleshooting) in case of problems
 4. After build process, **j2eo.jar** file will appear in the project root folder (`./j2eo`). With this file, is it
    possible to translate **.java** files or packages to **.eo** packages. Run:
 
@@ -67,6 +68,10 @@ Usage:
 ./test-hadoop.sh
 ```
 
+It will download zipped `hadoop` and unpack it (in a separate folder) into `../j2eo-data` relative to the project's root. Next, it will put the If you no more need that folder, run 
+```sh
+rm -rf ../j2eo-data
+```
 
 ---
 
@@ -103,3 +108,14 @@ bugs in our code. It is also much easier to work with abstraction layer than wit
 - First, the Java source code files are parsed recursively.
 - Then, for each file, translator converts Java AST to EO AST.
 - Then, EO AST is printed out as a source code to output directory in the same directory structure.
+
+## Troubleshooting
+
+### Java
+Make sure you have these in sync (*mentioning* (not pointing to) the same `jdk` directory)
+- `which java`
+- `which javac`
+  - configure alternatives in case of mismatch ([link](https://stackoverflow.com/a/47432365))
+- `echo $JAVA_HOME`
+  - See how to set `$JAVA_HOME` ([link](https://stackoverflow.com/a/18972665))
+  - If it still points to a wrong directory, see where you might have set it ([link](https://unix.stackexchange.com/a/154957)) and edit that place

build.sh

@@ -4,7 +4,8 @@
 set -e
 
 echo "Building J2EO..."
-rm -r build/libs
+# don't throw error if a dir doesn't exist
+rm -rf build/libs
 ./gradlew fatJar -x test
 cp build/libs/* ./
 echo "Build completed"

test-hadoop.sh

@@ -7,12 +7,17 @@ echo "Building J2EO..."
 ./gradlew build -x test jar
 cp build/libs/J2EO-0.4.0.jar .
 
-echo "Cloning Hadoop..."
-git clone https://github.com/apache/hadoop || true
-cd hadoop || exit
-echo "Checking out tested revision..."
-git checkout ec0ff1dc04b2ced199d71543a8260e9225d9e014
-cd ..
+echo "Downloading Hadoop..."
+# get hadoop from https://www.apache.org/dyn/closer.cgi/hadoop/common/hadoop-3.2.3/hadoop-3.2.3-src.tar.gz
+mkdir ../j2eo-data
+wget -O ../j2eo-data/hadoop.tar.gz https://dlcdn.apache.org/hadoop/common/hadoop-3.2.3/hadoop-3.2.3-src.tar.gz
+# unpack
+tar -xf ../j2eo-data/hadoop.tar.gz -C ../j2eo-data
 
 echo "Starting J2EO on Hadoop..."
-java -jar J2EO-0.4.0.jar -o output_hadoop hadoop
+# clean old output
+rm -rf ../j2eo-data/hadoop-eo
+
+# as it's not a part of the project
+# we may want to output to the parent directory
+java -jar J2EO-0.4.0.jar -o ../j2eo-data/hadoop-eo ../j2eo-data/hadoop-3.2.3-src