[API Change] Added generics, ClassFinder and Enums

API Change:
The BetterReflectionClass now uses generics to assign a class type

Enums:
Added support for enum classes through the EnumBetterReflectionClass, with the following methods
  + #getEnumConstants()
  + contains(String)
  + getIfPresent(String)
  + getOrNull(String)
  + getOrDefault(String, T)
  + toString(String)
  + toString()

Added a ClassFinder: find and iterate through a java program's classes (both IDE runtime and packed jar)
This class deprecates BetterReflectionUtils#getClassesInPackage(String)

Added unit tests for the ClassFinder class

Author: OxideWaveLength

README.md

@@ -1,43 +1,53 @@
 # Java Better-Reflection
+
 ## Faster Reflections [![Build Status](https://api.travis-ci.com/OxideWaveLength/Java-BetterReflection.svg?branch=main)](https://travis-ci.com/OxideWaveLength/Java-BetterReflection)
 
 BetterReflection is a Java library that caches reflection to achieve lower access time.
 
-> Note: *BetterReflection is essentially caching reflections. There might be better alternatives for what you are trying to achieve.*
+> Note: *BetterReflection is essentially caching reflections. There might be better alternatives for what you are trying
+to achieve.*
 
 #### This library has been created for Java 1.8, results may vary with different Java versions.
 
 ## Installation
-Every update has been packed into a Jar and released on GitHub. This library is also being hosted on Maven Central, starting with version 1.0
+
+Every update has been packed into a Jar and released on GitHub. This library is also being hosted on Maven Central,
+starting with version 1.0
+
 ```xml
 <dependency>
 	<groupId>top.wavelength</groupId>
 	<artifactId>Java-BetterReflection</artifactId>
 	<version>LATEST_VERSION</version>
 </dependency>
 ```
-Note: the package used to be me.wavelength.betterreflection up until version 1.0, where it's been renamed  to top.wavelength.betterreflection
+
+Note: the package used to be me.wavelength.betterreflection up until version 1.0, where it's been renamed to
+top.wavelength.betterreflection
 
 ## Usage
 
-There are no dependencies needed to use this library. Once you've downloaded it and set it up in your IDE you can start using it.
+There are no dependencies needed to use this library. Once you've downloaded it and set it up in your IDE you can start
+using it.
 
 You can temporarily cache a class by simply creating a new instance of BetterReflectionClass
 
 ```Java
-BetterReflectionClass ClassName = new BetterReflectionClass(ClassName.class); // You can also provide a string, containing the package and the name in this format: "com.example.Class".
+BetterReflectionClass<ClassName> className = new BetterReflectionClass<?>(ClassName.class); // You can also provide a string, containing the package and the name in this format: "com.example.Class".
 ```
 
 ## Something more efficient...
-Temporarily caching a class, though, might be worse than using normal reflections, because the BetterReflection class caches everything as soon as instantiated.
-To achieve actually better results than normal reflections you must actually permanently cache said classes.
 
+Temporarily caching a class, though, might be worse than using normal reflections, because the BetterReflection class
+caches everything as soon as instantiated.
+To achieve actually better results than normal reflections you must actually permanently cache said classes.
 
 ### Using the BetterReflection class
 
 The BetterReflection class is a class that keeps in an arraylist the cached classes
 
 #### Create an instance of BetterReflection inside of your main class
+
 ```Java
 private BetterReflection betterReflection;
 
@@ -51,19 +61,22 @@ public BetterReflection getBetterReflection() {
 ```
 
 #### Get the class from the BetterReflection instance you've just created
+
 ```Java
 public class MyClass {
 	...
-	BetterReflectionClass ClassNeeded = exampleClass.getBetterReflection().getBetterReflectionClass(ClassNeeded.class);
+	BetterReflectionClass<ClassNeeded> classNeeded = exampleClass.getBetterReflection().getBetterReflectionClass(ClassNeeded.class);
 	...
 }
 ```
 
-> Note: *There are some cons to using this method. RAM usage could be somewhat high and once there are many classes looping through a list containing all of them might get expensive*
+> Note: *There are some cons to using this method. RAM usage could be somewhat high and once there are many classes
+looping through a list containing all of them might get expensive*
 
 ### Alternative way
 
 #### Creating a class containing public static final fields
+
 ```Java
 public class ListOfMyClasses {
 	...
@@ -73,6 +86,7 @@ public class ListOfMyClasses {
 ```
 
 #### Accessing it from anywhere
+
 ```Java
 import static ListOfMyClasses.*;
 
@@ -98,18 +112,27 @@ public class MyClass {
 There are several ways you can contribute.
 
 ### Tests
-There are never enough tests! You can create a new test anytime you want to, but your test must meet specific requirements.
+
+There are never enough tests! You can create a new test anytime you want to, but your test must meet specific
+requirements.
+
 - Your test must extend the Test class
 - Your test must be added to the correct array inside of the Tester class
 - Your test must use the Timer class to return the time passed
 - Your test must tackle somewhat real scenarios
 - Your test must have a good English description
 
 ### Proper Benchmarks
-If you have some spare time and are generous enough, feel free to implement some proper benchmark and create a pull request. OpenJDK JHM is suggested, but if you're into some other benchmarking libraries feel free to use them instead
+
+If you have some spare time and are generous enough, feel free to implement some proper benchmark and create a pull
+request. OpenJDK JHM is suggested, but if you're into some other benchmarking libraries feel free to use them instead
 
 ### BetterReflection itself
-If you spot issues in the code, think there are better ways to achieve something or think that there are methods that should be added, feel free to add them.
+
+If you spot issues in the code, think there are better ways to achieve something or think that there are methods that
+should be added, feel free to add them.
 
 ### Issues
-Of course, contributing is not limited to code, you can also open issues to report bugs, performance issues or request features.
+
+Of course, contributing is not limited to code, you can also open issues to report bugs, performance issues or request
+features.

build.xml

@@ -1,10 +1,10 @@
 <project name="Java-BetterReflection" basedir="./Java-BetterReflection" default="main">
-    <property name="dir.src"     value="src"/>
-    <property name="dir.build"   value="build"/>
+    <property name="dir.src" value="src"/>
+    <property name="dir.build" value="build"/>
     <property name="dir.classes" value="${dir.build}/classes"/>
-    <property name="dir.jar"     value="${dir.build}/jar"/>
+    <property name="dir.jar" value="${dir.build}/jar"/>
 
-    <property name="main-class"  value="me.wavelength.BetterReflection"/>
+    <property name="main-class" value="me.wavelength.BetterReflection"/>
 
     <target name="clean">
         <delete dir="${dir.build}"/>

pom.xml

@@ -29,7 +29,7 @@
 
     <groupId>top.wavelength</groupId>
     <artifactId>Java-BetterReflection</artifactId>
-    <version>1.0</version>
+    <version>1.1</version>
 
     <properties>
         <maven.compiler.source>1.8</maven.compiler.source>
@@ -46,6 +46,24 @@
             <url>https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/</url>
         </repository>
     </distributionManagement>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-api</artifactId>
+            <version>5.10.0</version>
+            <scope>test</scope>
+        </dependency>
+
+        <!-- JUnit Jupiter Engine -->
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <version>5.10.0</version>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
     <build>
         <plugins>
             <plugin>

src/main/java/top/wavelength/betterreflection/BetterReflection.java

@@ -17,30 +17,35 @@
  **/
 public class BetterReflection {
 
-	private final List<BetterReflectionClass> betterReflectionClasses;
+	private final List<BetterReflectionClass<?>> betterReflectionClasses;
 
-	public static final BetterReflectionClass FIELD = new BetterReflectionClass(Field.class);
+	/**
+	 * @since 1.1
+	 */
+	public static final BetterReflection INSTANCE = new BetterReflection();
+
+	public static final BetterReflectionClass<Field> FIELD = new BetterReflectionClass<>(Field.class);
 
-	private static final Map<Class<?>, BetterReflectionClass> PRIMITIVES = new HashMap<>();
+	private static final Map<Class<?>, BetterReflectionClass<?>> PRIMITIVES = new HashMap<>();
 
 	static {
-		PRIMITIVES.put(Short.class, new BetterReflectionClass(Short.class));
-		PRIMITIVES.put(Byte.class, new BetterReflectionClass(Byte.class));
-		PRIMITIVES.put(Double.class, new BetterReflectionClass(Double.class));
-		PRIMITIVES.put(Integer.class, new BetterReflectionClass(Integer.class));
-		PRIMITIVES.put(Float.class, new BetterReflectionClass(Float.class));
-		PRIMITIVES.put(Boolean.class, new BetterReflectionClass(Boolean.class));
-		PRIMITIVES.put(Long.class, new BetterReflectionClass(Long.class));
-		PRIMITIVES.put(Void.class, new BetterReflectionClass(Void.class));
-
-		PRIMITIVES.put(short.class, new BetterReflectionClass(short.class));
-		PRIMITIVES.put(byte.class, new BetterReflectionClass(byte.class));
-		PRIMITIVES.put(double.class, new BetterReflectionClass(double.class));
-		PRIMITIVES.put(int.class, new BetterReflectionClass(int.class));
-		PRIMITIVES.put(float.class, new BetterReflectionClass(float.class));
-		PRIMITIVES.put(boolean.class, new BetterReflectionClass(boolean.class));
-		PRIMITIVES.put(long.class, new BetterReflectionClass(long.class));
-		PRIMITIVES.put(void.class, new BetterReflectionClass(void.class));
+		PRIMITIVES.put(Short.class, new BetterReflectionClass<>(Short.class));
+		PRIMITIVES.put(Byte.class, new BetterReflectionClass<>(Byte.class));
+		PRIMITIVES.put(Double.class, new BetterReflectionClass<>(Double.class));
+		PRIMITIVES.put(Integer.class, new BetterReflectionClass<>(Integer.class));
+		PRIMITIVES.put(Float.class, new BetterReflectionClass<>(Float.class));
+		PRIMITIVES.put(Boolean.class, new BetterReflectionClass<>(Boolean.class));
+		PRIMITIVES.put(Long.class, new BetterReflectionClass<>(Long.class));
+		PRIMITIVES.put(Void.class, new BetterReflectionClass<>(Void.class));
+
+		PRIMITIVES.put(short.class, new BetterReflectionClass<>(short.class));
+		PRIMITIVES.put(byte.class, new BetterReflectionClass<>(byte.class));
+		PRIMITIVES.put(double.class, new BetterReflectionClass<>(double.class));
+		PRIMITIVES.put(int.class, new BetterReflectionClass<>(int.class));
+		PRIMITIVES.put(float.class, new BetterReflectionClass<>(float.class));
+		PRIMITIVES.put(boolean.class, new BetterReflectionClass<>(boolean.class));
+		PRIMITIVES.put(long.class, new BetterReflectionClass<>(long.class));
+		PRIMITIVES.put(void.class, new BetterReflectionClass<>(void.class));
 	}
 
 	/**
@@ -55,37 +60,42 @@ public BetterReflection() {
 	/**
 	 * @return a copy of the cached classes
 	 */
-	public List<BetterReflectionClass> getBetterReflectionClasses() {
+	public List<BetterReflectionClass<?>> getBetterReflectionClasses() {
 		return new ArrayList<>(betterReflectionClasses);
 	}
 
-	public BetterReflectionClass getBetterReflectionClass(String name) {
-		for (BetterReflectionClass betterReflectionClass : getBetterReflectionClasses())
+	public BetterReflectionClass<?> getBetterReflectionClass(String name) {
+		for (BetterReflectionClass<?> betterReflectionClass : getBetterReflectionClasses())
 			if (betterReflectionClass.getClasz().getCanonicalName() != null && betterReflectionClass.getClasz().getCanonicalName().equals(name))
 				return betterReflectionClass;
 
-		BetterReflectionClass betterReflectionClass = BetterReflectionClass.forName(name);
+		BetterReflectionClass<?> betterReflectionClass = BetterReflectionClass.forName(name);
 		if (betterReflectionClass == null)
 			return null;
 		this.betterReflectionClasses.add(betterReflectionClass);
 		return betterReflectionClass;
 	}
 
-	public BetterReflectionClass getBetterReflectionClass(Class<?> clasz) {
-		for (BetterReflectionClass betterReflectionClass : getBetterReflectionClasses())
+	@SuppressWarnings("unchecked")
+	public <T> BetterReflectionClass<T> getBetterReflectionClass(Class<T> clasz) {
+		for (BetterReflectionClass<?> betterReflectionClass : getBetterReflectionClasses())
 			if (betterReflectionClass.getClasz().equals(clasz))
-				return betterReflectionClass;
+				return (BetterReflectionClass<T>) betterReflectionClass;
 
-		BetterReflectionClass betterReflectionClass = new BetterReflectionClass(clasz);
+		BetterReflectionClass<?> betterReflectionClass;
+		if (clasz.isEnum())
+			betterReflectionClass = new EnumBetterReflectionClass<>((Class<Enum<?>>) clasz);
+		else
+			betterReflectionClass = new BetterReflectionClass<>(clasz);
 		this.betterReflectionClasses.add(betterReflectionClass);
-		return betterReflectionClass;
+		return (BetterReflectionClass<T>) betterReflectionClass;
 	}
 
-	public static Map<Class<?>, BetterReflectionClass> getPrimitives() {
+	public static Map<Class<?>, BetterReflectionClass<?>> getPrimitives() {
 		return PRIMITIVES;
 	}
 
-	public static Object getFieldValue(BetterReflectionClass betterReflectionClass, Object instance, String fieldName) throws IllegalAccessException {
+	public static Object getFieldValue(BetterReflectionClass<?> betterReflectionClass, Object instance, String fieldName) throws IllegalAccessException {
 		return betterReflectionClass.getDeclaredField(fieldName).get(instance);
 	}
 
@@ -102,7 +112,7 @@ public static FutureTask<String> getLatestVersion() {
 			encoding = encoding == null ? "UTF-8" : encoding.substring(encoding.indexOf("charset=") + 8);
 			ByteArrayOutputStream baos = new ByteArrayOutputStream();
 			byte[] buf = new byte[8192];
-			int len = 0;
+			int len;
 			while ((len = in.read(buf)) != -1)
 				baos.write(buf, 0, len);
 			String body = baos.toString(encoding);
@@ -145,7 +155,7 @@ public static FutureTask<Boolean> isUpToDate() {
 	 * @since 0.4
 	 */
 	public static String getVersion() {
-		return "1.0";
+		return "1.1";
 	}
 
 	/**
@@ -175,8 +185,8 @@ public static int[] versionToInts(String version) {
 	}
 
 
-	public static final BetterReflectionClass JAVA_CLASS = new BetterReflectionClass(Class.class);
+	public static final BetterReflectionClass<?> JAVA_CLASS = new BetterReflectionClass<>(Class.class);
 
-	public static final BetterReflectionClass UNSAFE_CLASS = new BetterReflectionClass(Unsafe.class);
+	public static final BetterReflectionClass<Unsafe> UNSAFE_CLASS = new BetterReflectionClass<>(Unsafe.class);
 
 }