Merge pull request #8 from Nosto/feature/add-internal-publish-task-and-add-fork-info-to-readme

Update readme to describe the fork and add gradle task for Nosto internal publishing

Author: anttip

README.md

@@ -1,3 +1,17 @@
+# Nosto Fork of GraphQL-Java Annotations adds support for partial updates and publishToNostoRepo gradle task for internal use
+
+Adds support for binding to `java.util.Optional` parameters. Binding to Optional parameters allows implementing partial updates. With a partial update the mutate call can update only some of the Optional fields without needing to repeat all the existing values of an object.
+
+The mapping from an optional field in GraphQL schema that binds to `java.util.Optional` is the following:
+1. value given to the field in GraphQL call is mapped into `java.util.Optional` of the underlying type
+2. null given to the field in GraphQL call is mapped into `Optional.empty` to signal the removal of a possibly existing value of the field
+3. field not included in the GraphQL call is mapped into null to signal `undefined` so any possibly existing value(s) should not be modified
+
+## Internal publishing to Nosto repository
+
+Update the version in the `gradle.properties` file and run `./gradlew publishToNostoRepo` to publish the library to the Nosto repository.
+
+
 ![logo](graphql-annotations.png?raw=true)
 # GraphQL-Java Annotations
 ![build](https://github.com/Enigmatis/graphql-java-annotations/actions/workflows/build.yml/badge.svg)

build.gradle

@@ -24,6 +24,14 @@ apply plugin: 'biz.aQute.bnd.builder'
 apply plugin: 'maven-publish'
 
 
+// The upstream project build releases seem to be compiled with Java 11 so keeping compatibility so that our changes can be applied to the upstream project
+compileJava {
+    options.release = 11
+}
+compileTestJava {
+    options.release = 11
+}
+
 // custom tasks for creating source/javadoc jars
 tasks.register('sourcesJar', Jar) {
     dependsOn classes
@@ -143,7 +151,29 @@ publishing {
             }
         }
     }
+
+    repositories {
+        maven {
+            url 'https://repo.nos.to/content/repositories/NostoDependencies/'
+            credentials {
+                username = project.hasProperty('mavenUser') ? project.mavenUser : ""
+                password = project.hasProperty('mavenPassword') ? project.mavenPassword : ""
+            }
+        }
+    }
+}
+
+tasks.register('publishToNostoRepo') {
+    dependsOn 'publishMavenPublicationToMavenRepository'
 }
+gradle.taskGraph.whenReady { taskGraph ->
+    if (taskGraph.hasTask(':publishToNostoRepo')) {
+        if (!project.hasProperty('mavenUser') || !project.hasProperty('mavenPassword')) {
+            throw new GradleException("mavenUser and mavenPassword must be defined for publishToNostoRepo task")
+        }
+    }
+}
+
 
 afterReleaseBuild.dependsOn nexusPublishing
 
@@ -158,6 +188,7 @@ nexusPublishing {
 
 // to publish to local maven repo skip signing: ./gradlew publishToMavenLocal  -x signGraphqlJavaPublication
 signing {
+    required = { !version.endsWith("nosto") }
     def signingKey = System.getenv("MAVEN_CENTRAL_PGP_KEY")
     useInMemoryPgpKeys(signingKey, "")
     sign publishing.publications

gradle.properties

@@ -5,4 +5,4 @@ org.gradle.daemon=true
 org.gradle.parallel=true
 org.gradle.jvmargs=-Dfile.encoding=UTF-8
 
-version = 21.5
+version = 21.5-nosto