#174 Added JavaDocs

bb-eyes/src/main/java/com/cognifide/qa/bb/eyes/guice/EyesModule.java

@@ -22,6 +22,9 @@
 import com.applitools.eyes.selenium.Eyes;
 import com.google.inject.AbstractModule;
 
+/**
+ * Eyes Guice module. Provides an {@link Eyes} instance.
+ */
 public class EyesModule extends AbstractModule {
 
   @Override

bb-eyes/src/main/java/com/cognifide/qa/bb/eyes/guice/EyesProvider.java

@@ -25,6 +25,16 @@
 import com.google.inject.Provider;
 import com.google.inject.name.Named;
 
+/**
+ * Provides a thread-scoped {@link Eyes} instance. Bound in {@link EyesModule}.
+ * <br>
+ * Requires {@code eyes.apiKey} property.
+ * <br>
+ * Additional configurable options:
+ * <ul>
+ * <li>{@code eyes.fullPageScreenshots} - defines if full-page screenshots should be captured</li>
+ * </ul>
+ */
 @ThreadScoped
 public class EyesProvider implements Provider<Eyes> {
 

bb-eyes/src/main/java/com/cognifide/qa/bb/eyes/junit4/WithEyes.java

@@ -29,6 +29,23 @@
 import com.google.inject.Inject;
 import com.google.inject.name.Named;
 
+/**
+ * JUnit 4 {@link TestRule} that enables Eyes integration.
+ * <p>
+ * Example usage:
+ * <pre>
+ * public class ExampleTest {
+ *    &#64;Rule
+ *    &#64;Inject
+ *    public WithEyes withEyes;
+ *
+ *    public void test() {
+ *      // test actions
+ *      withEyes.getEyes().checkWindow("Example checkpoint");
+ *    }
+ * }
+ * </pre>
+ */
 public class WithEyes implements TestRule {
 
   private final WebDriver webDriver;
@@ -42,14 +59,23 @@ public WithEyes(WebDriver webDriver, Eyes eyes, @Named("eyes.appName") String ap
     this.appName = appName;
   }
 
+  /**
+   * @return the avaialable WebDriver instance
+   */
   public WebDriver getWebDriver() {
     return webDriver;
   }
 
+  /**
+   * @return the configured and initialized {@link Eyes} instance.
+   */
   public Eyes getEyes() {
     return eyes;
   }
 
+  /**
+   * {@inheritDoc}
+   */
   @Override
   public Statement apply(Statement base, Description description) {
     return new Statement() {

bb-eyes/src/main/java/com/cognifide/qa/bb/eyes/junit5/WithEyes.java

@@ -26,6 +26,9 @@
 
 import org.junit.jupiter.api.extension.ExtendWith;
 
+/**
+ * Meta-annotation enabling the {@link WithEyesExtension}.
+ */
 @Target({ElementType.ANNOTATION_TYPE, ElementType.METHOD, ElementType.TYPE})
 @Retention(RetentionPolicy.RUNTIME)
 @ExtendWith(WithEyesExtension.class)

bb-eyes/src/main/java/com/cognifide/qa/bb/eyes/junit5/WithEyesExtension.java

@@ -34,8 +34,16 @@
 import com.google.inject.Injector;
 import com.google.inject.Key;
 
+/**
+ * JUnit 5 extension that provides {@link Eyes} capabilities.
+ */
 public class WithEyesExtension implements BeforeEachCallback, AfterEachCallback {
 
+  /**
+   * Opens an {@link Eyes} session before the test.
+   * <br>
+   * {@inheritDoc}
+   */
   @Override
   public void beforeEach(ExtensionContext context) throws Exception {
     Injector injector = InjectorUtils.retrieveInjectorFromStore(context, NAMESPACE);
@@ -44,6 +52,11 @@ public void beforeEach(ExtensionContext context) throws Exception {
     getEyes(context).open(wrappedDriver, String.valueOf(properties.get("eyes.appName")), context.getDisplayName());
   }
 
+  /**
+   * Closes or aborts the opened {@link Eyes} session.
+   * <br>
+   * {@inheritDoc}
+   */
   @Override
   public void afterEach(ExtensionContext context) throws Exception {
     Eyes eyes = getEyes(context);