[+] Better external running instructions

Author: hykilpikonna

README.md

@@ -12,7 +12,23 @@ Final Project for CSC207
 
 ### Run a specific class in an external terminal
 
-`./gradlew classes testClasses && build/jdk19/Contents/Home/bin/java -cp "build/classes/java/main:build/classes/java/test" org.hydev.mcpm.<class>`
+This is very useful to test terminal operations since the Gradle running environment isn't a tty, and IntelliJ IDEA's built-in terminal barely supports Xterm escape sequences.
+
+For this, I've set up a custom gradle task `printCp` that will print out the classpath needed to run the classes with dependencies. It will print in stderr instead of stdout in order for bash to easily separate out the classpath. You can obtain the classpath in a bash variable by:
+
+`cp="$(./gradlew classes testClasses printCp 2>&1 > /dev/null)" && echo "$cp"`
+
+(Unfortunately since Windows doesn't support Bash, you'll need to use a Bash-compatible environment on Windows, either cygwin / git bash or WSL)
+
+Then, you can run your class with:
+
+`java19 -cp "$cp" org.hydev.mcpm.<class>`
+
+For example, you can test the progress bar with:
+
+`java19 -cp "$cp" org.hydev.mcpm.client.interaction.ProgressBar`
+
+If you don't have JDK 19 installed or if you don't know where it's installed, you can use our JDK downloader tool to download a local version of JDK 19 without installing on the system. (TODO: Add tutorial after merging PR #8)
 
 ## Brainstorm
 

build.gradle

@@ -75,6 +75,10 @@ if (hasProperty('buildScan')) {
     }
 }
 
+task printCp() {
+    System.err.println sourceSets.main.runtimeClasspath.asPath;
+}
+
 test {
     useJUnitPlatform()
     testLogging.showStandardStreams = true