Build empty jars for hamcrest-core and -library. (#236)

Existing maven builds that depend upon either `hamcrest-core-1.3.jar`
or `hamcrest-library.jar` will not upgrade their version for a pom-only
artifact. This change re-introduces a jar file for -core and -library,
but with no real classes. This allows Maven builds to correctly detect
the latest version of the jar. The transitive dependency on `hamcrest.jar`
brings in the latest version of the classes that were previously in
both `hamcrest-core.jar` or `hamcrest-library.jar`.

Author: tumbarumba

build.gradle

@@ -7,11 +7,11 @@ version = "2.1-SNAPSHOT"
 
 subprojects {
     apply plugin: 'java-library'
-    apply plugin: 'osgi'
 
     sourceCompatibility = JavaVersion.VERSION_1_7
     targetCompatibility = JavaVersion.VERSION_1_7
-    
+
+    group = rootProject.group
     version = rootProject.version
 
     repositories {
@@ -24,19 +24,6 @@ subprojects {
         }
     }
 
-    jar {
-        manifest {
-            attributes 'Implementation-Title': project.name,
-                    'Implementation-Vendor': 'hamcrest.org',
-                    'Implementation-Version': version,
-                    'Automatic-Module-Name': 'org.hamcrest'
-            instruction 'Import-Package', '''javax.xml.namespace; resolution:=optional,
-                                         javax.xml.xpath; resolution:=optional,
-                                         org.w3c.dom; resolution:=optional,
-                                         *'''
-        }
-    }
-
     task sourcesJar(type: Jar) {
         classifier = 'sources'
         from sourceSets.main.allSource
@@ -83,13 +70,6 @@ def pomConfigurationFor(String pomName, String pomDescription) {
     }
 }
 
-def appendDependency(Object dependencies, String artifactId) {
-    def dependency = dependencies.appendNode('dependency')
-    dependency.appendNode('groupId',    'org.hamcrest')
-    dependency.appendNode('artifactId', artifactId)
-    dependency.appendNode('version',    rootProject.version)
-}
-
 def publishToOssrh = project.hasProperty('ossrhUsername') && project.hasProperty('ossrhPassword')
 
 publishing {
@@ -105,26 +85,26 @@ publishing {
                     'Core API and libraries of hamcrest matcher framework.')
         }
 
+        def hamcrestCoreProject = project(':hamcrest-core')
         hamcrestCore(MavenPublication) {
-            artifactId 'hamcrest-core'
+            from hamcrestCoreProject.components.java
+            artifactId hamcrestCoreProject.name
+            artifact hamcrestCoreProject.sourcesJar
+            artifact hamcrestCoreProject.javadocJar
             pom pomConfigurationFor(
                     'Hamcrest Core',
                     'Core Hamcrest API - deprecated, please use "hamcrest" instead')
-            pom.withXml {
-                def dependencies = asNode().appendNode('dependencies')
-                appendDependency(dependencies, 'hamcrest')
-            }
         }
 
+        def hamcrestLibraryProject = project(':hamcrest-library')
         hamcrestLibrary(MavenPublication) {
-            artifactId 'hamcrest-library'
+            from hamcrestLibraryProject.components.java
+            artifactId hamcrestLibraryProject.name
+            artifact hamcrestLibraryProject.sourcesJar
+            artifact hamcrestLibraryProject.javadocJar
             pom pomConfigurationFor(
                     'Hamcrest Library',
                     'A library of Hamcrest matchers - deprecated, please use "hamcrest" instead')
-            pom.withXml {
-                def dependencies = asNode().appendNode('dependencies')
-                appendDependency(dependencies, 'hamcrest-core')
-            }
         }
     }
     repositories {

hamcrest-core/hamcrest-core.gradle

@@ -0,0 +1,18 @@
+dependencies {
+    api project(':hamcrest')
+}
+
+jar {
+    manifest {
+        attributes 'Implementation-Title': project.name,
+                'Implementation-Vendor': 'hamcrest.org',
+                'Implementation-Version': version,
+                'Automatic-Module-Name': 'org.hamcrest'
+    }
+}
+
+javadoc {
+    title = "Hamcrest Core $version API"
+    options.showFromPackage()
+    options.showFromPrivate()
+}

hamcrest-core/src/main/java/org/hamcrest/HamcrestCoreIsDeprecated.java

@@ -0,0 +1,9 @@
+package org.hamcrest;
+
+/**
+ * All the classes in <code>hamcrest-core.jar</code> have moved to
+ * <code>hamcrest.jar</code>. Please use that dependency instead.
+ */
+@Deprecated
+class HamcrestCoreIsDeprecated {
+}

hamcrest-core/src/main/java/org/hamcrest/package-info.java

@@ -0,0 +1,5 @@
+/**
+ * All classes in <code>hamcrest-core.jar</code> have been migrated to
+ * <code>hamcrest.jar</code>. Please use that dependency instead.
+ */
+package org.hamcrest;

hamcrest-core/src/main/resources/README.txt

@@ -0,0 +1,5 @@
+Hamcrest Core
+=============
+
+All the classes in hamcrest-core.jar and hamcrest-library.jar has moved
+into hamcrest.jar. Please update your dependencies.

hamcrest-library/hamcrest-library.gradle

@@ -0,0 +1,17 @@
+dependencies {
+    api project(':hamcrest-core')
+}
+
+jar {
+    manifest {
+        attributes 'Implementation-Title': project.name,
+                'Implementation-Vendor': 'hamcrest.org',
+                'Implementation-Version': version,
+                'Automatic-Module-Name': 'org.hamcrest'
+    }
+}
+
+javadoc {
+    title = "Hamcrest Library $version API"
+    options.showFromPackage()
+}

hamcrest-library/src/main/java/org/hamcrest/HamcrestLibraryIsDeprecated.java

@@ -0,0 +1,9 @@
+package org.hamcrest;
+
+/**
+ * All the classes in <code>hamcrest-library.jar</code> have moved to
+ * <code>hamcrest.jar</code>. Please use that dependency instead.
+ */
+@Deprecated
+class HamcrestLibraryIsDeprecated {
+}

hamcrest-library/src/main/java/org/hamcrest/package-info.java

@@ -0,0 +1,5 @@
+/**
+ * All classes in <code>hamcrest-library.jar</code> have been migrated to
+ * <code>hamcrest.jar</code>. Please use that dependency instead.
+ */
+package org.hamcrest;

hamcrest-library/src/main/resources/README.txt

@@ -0,0 +1,5 @@
+Hamcrest Library
+================
+
+All the classes in hamcrest-core.jar and hamcrest-library.jar has moved
+into hamcrest.jar. Please update your dependencies.

hamcrest/hamcrest.gradle

@@ -1,24 +1,24 @@
-version = rootProject.version
+apply plugin: 'osgi'
 
-sourceSets {
-    main {
-        java {
-            srcDirs rootProject.file('hamcrest-core/src/main/java'),
-                    rootProject.file('hamcrest-library/src/main/java')
-        }
-    }
-    test {
-        java {
-            srcDirs rootProject.file('hamcrest-core/src/test/java'),
-                    rootProject.file('hamcrest-library/src/test/java')
-        }
-    }
-}
+version = rootProject.version
 
 dependencies {
     testImplementation(group: 'junit', name: 'junit', version: '4.12') {
         transitive = false
     }
 }
 
+jar {
+    manifest {
+        attributes 'Implementation-Title': project.name,
+                'Implementation-Vendor': 'hamcrest.org',
+                'Implementation-Version': version,
+                'Automatic-Module-Name': 'org.hamcrest'
+        instruction 'Import-Package', '''javax.xml.namespace; resolution:=optional,
+                                         javax.xml.xpath; resolution:=optional,
+                                         org.w3c.dom; resolution:=optional,
+                                         *'''
+    }
+}
+
 javadoc.title = "Hamcrest $version API"