add javadoc jar

Author: baev

allure-java-commons/src/main/java/io/qameta/allure/Attachment.java

@@ -16,18 +16,24 @@
 public @interface Attachment {
 
     /**
-     * Attachment name.
+     * The attachment name.
+     *
+     * @return the attachment name.
      */
     String value() default "{method}";
 
     /**
      * Valid attachment MimeType, for example "text/plain" or "application/json".
+     *
+     * @return the attachment type.
      */
     String type() default "";
 
     /**
      * Optional attachment file extension. By default file extension will be determined by
      * provided media type. Should be started with dot.
+     *
+     * @return the attachment file extension.
      */
     String fileExtension() default "";
 }

allure-java-commons/src/main/java/io/qameta/allure/Link.java

@@ -26,22 +26,30 @@
 
     /**
      * Alias for {@link #name()}.
+     *
+     * @return the link name.
      */
     String value() default "";
 
     /**
      * Name for link, by default url.
+     *
+     * @return the link name.
      */
     String name() default "";
 
     /**
      * Url for link. By default will search for system property `allure.link.{type}.pattern`, and use it
      * to generate url.
+     *
+     * @return the link url.
      */
     String url() default "";
 
     /**
      * This type is used for create an icon for link. Also there is few reserved types such as issue and tms.
+     *
+     * @return the link type.
      */
     String type() default "custom";
 }

allure-java-commons/src/main/java/io/qameta/allure/aspects/AttachmentsAspects.java

@@ -32,6 +32,8 @@ public static AllureLifecycle getLifecycle() {
 
     /**
      * Sets lifecycle for aspects. Usually used in tests.
+     *
+     * @param lifecycle allure lifecycle to set.
      */
     public static void setLifecycle(final AllureLifecycle lifecycle) {
         AttachmentsAspects.lifecycle = lifecycle;
@@ -56,6 +58,9 @@ public void anyMethod() {
     /**
      * Process data returned from method annotated with {@link Attachment}.
      * If returned data is not a byte array, then use toString() method, and get bytes from it.
+     *
+     * @param joinPoint the join point to process.
+     * @param result    the returned value.
      */
     @AfterReturning(pointcut = "anyMethod() && withAttachmentAnnotation()", returning = "result")
     public void attachment(final JoinPoint joinPoint, final Object result) {

allure-java-commons/src/main/java/io/qameta/allure/aspects/StepsAspects.java

@@ -67,6 +67,8 @@ public void stepStop() {
 
     /**
      * For tests only.
+     *
+     * @param allure allure lifecycle to set.
      */
     public static void setLifecycle(final AllureLifecycle allure) {
         lifecycle = allure;

build.gradle

@@ -65,8 +65,14 @@ subprojects { project ->
         from sourceSets.main.allJava
     }
 
+    task javadocJar(type: Jar, dependsOn: javadoc) {
+        classifier = 'javadoc'
+        from javadoc.destinationDir
+    }
+
     artifacts {
         archives sourceJar
+        archives javadocJar
     }
 
     repositories {