Upgrade Gradle to Version 7.5.1 (#456)

* Upgraded Gradle and added JavaDoc action

* Update README.md

* Create gradle.properties

Added to show deprecated Gradle features

* Fixed deprecated Gradle features

* Update build.gradle

---------

Co-authored-by: Ivan Ho <41582274+Corppet@users.noreply.github.com>

.github/workflows/publish-javadoc.yml

@@ -0,0 +1,21 @@
+# modified from https://github.com/MathieuSoysal/Javadoc-publisher.yml
+
+name: Publish Javadoc
+
+on:
+  push:
+    branches:
+      - dev
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Publish JavaDoc
+        uses: MathieuSoysal/Javadoc-publisher.yml@v2.3.0
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          javadoc-branch: javadoc
+          java-version: 8
+          target-folder: docs
+          project: gradle

README.md

@@ -23,16 +23,16 @@ LEGUP (**L**ogic **E**ngine for **G**rid-**U**sing **P**uzzles) is a better way
 - [License](#license)
 
 ## Background
-Dr. van Heuveln has taught logic courses on a frequent basis for the past 15 years, and noted that a good number of students struggle with the systems of modern formal logic that were developed in the late 1800's and early 1900's, and that have been universally used in logic courses since. These traditional systems use abstract linear symbol strings such as `(P & Q) -> (R v S)`, and deploy even more abstract rules such as & Elim to infer new symbol strings from old ones, thus engaging the user in logical reasoning. 
+Dr. van Heuveln has taught logic courses on a frequent basis for the past 15 years, and noted that a good number of students struggle with the systems of modern formal logic that were developed in the late 1800's and early 1900's, and that have been universally used in logic courses since. These traditional systems use abstract linear symbol strings such as `(P & Q) -> (R v S)`, and deploy even more abstract rules such as & Elim to infer new symbol strings from old ones, thus engaging the user in logical reasoning.
 
-This project brings about the idea that there are more pedagogically effective ways for students to learn the basic and important principles of logical reasoning. 
+This project brings about the idea that there are more pedagogically effective ways for students to learn the basic and important principles of logical reasoning.
 
 LEGUP uses a more visual representation in a more concrete and engaging environment. These and other features of the LEGUP interface are suspected to have several advantages over more traditional interfaces in terms of learning logic.
 
 ## Use Cases
 The LEGUP interface allows the user to solve different types of grid-based logical puzzles. Probably the best known example of such a puzzle is the popular Sudoku puzzle, but there are many other types of puzzles that are based on the principle of filling in cells of a square or rectangular grid with different kinds of objects. In all cases, the user is provided certain clues that will force a unique configuration of objects in the grid. These types of puzzles are often advertised as "logic puzzles," and are claimed to train one's logical mind as, using deduction, users should be able to infer which object goes where.
 
-So, how does the LEGUP interface differ from online platforms for grid-based games? The most important difference is that the LEGUP interface requires the user to explicitly indicate their logical reasoning. Thus, solving the puzzle due to some lucky guesses is no longer an option! The interface will congratulate the user less on the fact that the user was able to solve the puzzle, but more on how the user solved the puzzle. This is essential to logic. Logic is not about the truth or the correct or best answer, but about deductive implication and valid inference. What follows from what, and why? 
+So, how does the LEGUP interface differ from online platforms for grid-based games? The most important difference is that the LEGUP interface requires the user to explicitly indicate their logical reasoning. Thus, solving the puzzle due to some lucky guesses is no longer an option! The interface will congratulate the user less on the fact that the user was able to solve the puzzle, but more on how the user solved the puzzle. This is essential to logic. Logic is not about the truth or the correct or best answer, but about deductive implication and valid inference. What follows from what, and why?
 
 LEGUP also provides a single interface that is capable of supporting many different types of puzzles. Since most of the interface remains the same, however, users wil start to recognize certain similarities between the different puzzles. In particular, since they have to explicitly state their reasoning, users should start to see strong similarities in their logical reasoning patterns from puzzle to puzzle, is the very basis of the abstract logical reasoning principles taught in traditional logic courses. However, rather than being "thrown in the water" with abstract principles based on obscure symbols, users instead are dealing with a concrete, fun, and engaging logic puzzle. As such, LEGUP aims to give its users a "leg up" when it comes to the understanding of logic.
 
@@ -42,10 +42,12 @@ If you are an educator interested in using LEGUP, go to the [releases page](http
 ## For Students
 If you are a student interested in learning the basics of logic, LEGUP is a great way for you to get started. If your instructor is using LEGUP in the classroom and you are looking for extra practice, you can reference the sample puzzle files can be found in the [puzzle files folder](https://github.com/Bram-Hub/Legup/tree/master/puzzles%20files) to get more practice.
 
-Additionally, if you are interested in computer science and programming, please consider contributing to LEGUP! Not only would it a great way to practice logical reasoning, but it is also a great way to dip your toes into open source software and contributing to open source projects. 
+Additionally, if you are interested in computer science and programming, please consider contributing to LEGUP! Not only would it a great way to practice logical reasoning, but it is also a great way to dip your toes into open source software and contributing to open source projects.
 
 ## Documentation
-Documentation is actively being worked on on the [LEGUP wiki](https://github.com/Bram-Hub/Legup/wiki). 
+Documentation is actively being worked on on the [LEGUP wiki](https://github.com/Bram-Hub/Legup/wiki).
+
+The Javadocs for our application are currently hosted directly on [our Github Pages site](https://bram-hub.github.io/LEGUP/).
 
 Documentation is very much in the early stages, and we would greatly appreciate anyone who is willing to help write and structure the documentation. Currently, the priority is to write detailed documentation on how Nurikabe works, as it is the puzzle that is the most developed within LEGUP.
 
@@ -75,7 +77,7 @@ GNU General Public License for more details.
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <https://www.gnu.org/licenses/>.
  ```
- 
+
 The look and feel of LEGUP uses [FlatLaf](https://github.com/JFormDesigner/FlatLaf), which is licensed under the [Apache-2.0 license](https://www.apache.org/licenses/LICENSE-2.0.html).
 
 Some of the icons used in LEGUP were taken from or derived from the icons found on https://fonts.google.com/icons, which is licensed under the [Apache-2.0 license](https://www.apache.org/licenses/LICENSE-2.0.html).

build.gradle

@@ -16,33 +16,33 @@ sourceCompatibility = 1.8
 dependencies {
     implementation 'org.jetbrains:annotations:20.1.0'
     implementation 'org.jetbrains:annotations:20.1.0'
-    compile 'com.formdev:flatlaf:3.0'
-    compile project(':legup-update')
-    compile 'com.google.firebase:firebase-admin:6.3.0'
-    compile 'org.apache.httpcomponents:httpclient:4.5.1'
-    compile group: 'org.slf4j', name: 'slf4j-api', version: '1.7.25'
-    compile group: 'org.slf4j', name: 'slf4j-simple', version: '1.7.25'
+    implementation 'com.formdev:flatlaf:3.0'
+    implementation project(':legup-update')
+    implementation 'com.google.firebase:firebase-admin:6.3.0'
+    implementation 'org.apache.httpcomponents:httpclient:4.5.1'
+    implementation group: 'org.slf4j', name: 'slf4j-api', version: '1.7.25'
+    implementation group: 'org.slf4j', name: 'slf4j-simple', version: '1.7.25'
 
-//    compile 'com.google.code.gson:gson:2.8.2'
-//    compile 'commons-cli:commons-cli:1.4'
-//    compile 'commons-io:commons-io:2.6'
-    compile 'org.apache.commons:commons-lang3:3.12.0'
-    compile 'org.apache.logging.log4j:log4j-api:2.17.2'
-    compile 'org.apache.logging.log4j:log4j-core:2.17.2'
+//    implementation 'com.google.code.gson:gson:2.8.2'
+//    implementation 'commons-cli:commons-cli:1.4'
+//    implementation 'commons-io:commons-io:2.6'
+    implementation 'org.apache.commons:commons-lang3:3.12.0'
+    implementation 'org.apache.logging.log4j:log4j-api:2.17.2'
+    implementation 'org.apache.logging.log4j:log4j-core:2.17.2'
 
-    testCompile group: 'junit', name: 'junit', version: '4.12'
-    testCompile 'junit:junit:4.+'
+    testImplementation group: 'junit', name: 'junit', version: '4.12'
+    testImplementation 'junit:junit:4.+'
 }
 
 task customFatJar(type: Jar) {
     manifest {
         attributes('Implementation-Title': 'Legup',
-                'Implementation-Version': version,
+                'Implementation-Version': archiveVersion,
                 'Main-Class': 'edu.rpi.legup.Legup',
                 'SplashScreen-Image': 'edu/rpi/legup/images/Legup/LegupSplash.png')
     }
-    archiveName = 'Legup.jar'
-    baseName = 'Legup.jar'
+    archiveFileName = 'Legup.jar'
+    archiveBaseName = 'Legup.jar'
     from {
         configurations.compile.collect {
             it.isDirectory() ? it : zipTree(it)
@@ -52,21 +52,23 @@ task customFatJar(type: Jar) {
 }
 
 jar {
+    duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+
     from {
-        configurations.compile.collect {
+        configurations.compileClasspath.collect {
             it.isDirectory() ? it : zipTree(it)
         }
-        configurations.runtime.collect {
+        configurations.runtimeClasspath.collect {
             it.isDirectory() ? it : zipTree(it)
         }
     }
     manifest {
         attributes('Implementation-Title': 'Legup',
-                'Implementation-Version': version,
+                'Implementation-Version': archiveVersion,
                 'Main-Class': 'edu.rpi.legup.Legup',
                 'SplashScreen-Image': 'edu/rpi/legup/images/Legup/LegupSplash.png')
     }
-    archiveName = 'Legup.jar'
+    archiveFileName = 'Legup.jar'
 }
 
 /*

gradle.properties

@@ -0,0 +1 @@
+org.gradle.warning.mode=all

gradle/wrapper/gradle-wrapper.properties

@@ -1,5 +1,5 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-5.0-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.5.1-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

legup-update/build.gradle

@@ -11,12 +11,12 @@ repositories {
 }
 
 dependencies {
-    compile 'com.google.code.gson:gson:2.8.2'
-    compile 'commons-cli:commons-cli:1.4'
-    compile 'commons-io:commons-io:2.6'
-    compile 'org.apache.commons:commons-lang3:3.7'
-    compile 'org.apache.logging.log4j:log4j-api:2.10.0'
-    compile 'org.apache.logging.log4j:log4j-core:2.10.0'
+    implementation 'com.google.code.gson:gson:2.8.2'
+    implementation 'commons-cli:commons-cli:1.4'
+    implementation 'commons-io:commons-io:2.6'
+    implementation 'org.apache.commons:commons-lang3:3.7'
+    implementation 'org.apache.logging.log4j:log4j-api:2.10.0'
+    implementation 'org.apache.logging.log4j:log4j-core:2.10.0'
 
-    testCompile group: 'junit', name: 'junit', version: '4.12'
+    testImplementation group: 'junit', name: 'junit', version: '4.12'
 }