Rename authToken to apiKey and add configuration fallbacks (#9)

Co-authored-by: Claude <[email protected]>

Author: pditommaso

README.md

@@ -38,13 +38,50 @@ nextflowPlugin {
 
     publishing {
         registry {
-            url = 'https://plugins.nextflow.io/api'
-            authToken = project.findProperty('registry_access_token')
+            // Registry URL (optional, defaults to plugin-registry.seqera.io/api)
+            url = 'https://plugin-registry.seqera.io/api'
+            
+            // API key for authentication (required)
+            apiKey = project.findProperty('npr.apiKey')
         }
     }
 }
 ```
 
+### Registry Configuration
+
+The registry publishing configuration supports multiple ways to provide the URL and API key:
+
+#### Registry URL
+The registry URL can be configured via (in order of priority):
+1. `nextflowPlugin.publishing.registry.url` in build.gradle
+2. Gradle property: `-Pnpr.apiUrl=https://your-registry.com/api`
+3. Environment variable: `NPR_API_URL=https://your-registry.com/api`
+4. Default: `https://plugin-registry.seqera.io/api`
+
+#### API Key
+The API key can be configured via (in order of priority):
+1. `nextflowPlugin.publishing.registry.apiKey` in build.gradle
+2. Gradle property: `-Pnpr.apiKey=your-api-key`
+3. Environment variable: `NPR_API_KEY=your-api-key`
+
+**Note:** The API key is required for publishing. If none is provided, the plugin will show an error with configuration instructions.
+
+#### Example Configurations
+
+Using gradle.properties:
+```properties
+npr.apiUrl=https://my-custom-registry.com/api
+npr.apiKey=your-secret-api-key
+```
+
+Using environment variables:
+```bash
+export NPR_API_URL=https://my-custom-registry.com/api
+export NPR_API_KEY=your-secret-api-key
+./gradlew releasePlugin
+```
+
 This will add some useful tasks to your Gradle build:
 * `assemble` - Compile the Nextflow plugin code and assemble it into a zip file
 * `installPlugin` - Copy the assembled plugin into your local Nextflow plugins dir
@@ -92,5 +129,5 @@ Then use this command:
 
 
 ```
-./gradlew publishPlugins
+./gradlew releasePlugins
 ```

src/main/groovy/io/nextflow/gradle/registry/RegistryClient.groovy

@@ -15,18 +15,18 @@ class RegistryClient {
     private final Gson gson = new Gson()
 
     private final URI url
-    private final String authToken
+    private final String apiKey
 
-    RegistryClient(URI url, String authToken) {
+    RegistryClient(URI url, String apiKey) {
         this.url = !url.toString().endsWith("/")
             ? URI.create(url.toString() + "/")
             : url
-        this.authToken = authToken
+        this.apiKey = apiKey
     }
 
     def publish(String id, String version, File file) {
         def req = new HttpPost(url.resolve("publish"))
-        req.addHeader("Authorization", "Bearer ${authToken}")
+        req.addHeader("Authorization", "Bearer ${apiKey}")
         req.setEntity(MultipartEntityBuilder.create()
             .addTextBody("id", id)
             .addTextBody("version", version)

src/main/groovy/io/nextflow/gradle/registry/RegistryPublishConfig.groovy

@@ -10,14 +10,67 @@ class RegistryPublishConfig {
     /**
      * Location of the registry api
      */
-    String url = 'https://plugins.nextflow.io/api'
+    String url
 
     /**
-     * Registry authentication token
+     * Registry API key
      */
-    String authToken
+    String apiKey
 
     RegistryPublishConfig(Project project) {
         this.project = project
     }
+
+    /**
+     * Get the registry URL, checking fallbacks if not explicitly set
+     */
+    String getResolvedUrl() {
+        // If explicitly set, use it
+        if (url) {
+            return url
+        }
+        
+        // Try gradle property
+        def gradleProp = project.findProperty('npr.apiUrl')
+        if (gradleProp) {
+            return gradleProp.toString()
+        }
+        
+        // Try environment variable
+        def envVar = System.getenv('NPR_API_URL')
+        if (envVar) {
+            return envVar
+        }
+        
+        // Default URL
+        return 'https://plugin-registry.seqera.io/api'
+    }
+
+    /**
+     * Get the API key, checking fallbacks if not explicitly set
+     */
+    String getResolvedApiKey() {
+        // If explicitly set, use it
+        if (apiKey) {
+            return apiKey
+        }
+        
+        // Try gradle property
+        def gradleProp = project.findProperty('npr.apiKey')
+        if (gradleProp) {
+            return gradleProp.toString()
+        }
+        
+        // Try environment variable
+        def envVar = System.getenv('NPR_API_KEY')
+        if (envVar) {
+            return envVar
+        }
+        
+        // No API key found
+        throw new RuntimeException('Registry API key not provided. Set it via:\n' +
+            '  - nextflowPlugin.publishing.registry.apiKey in build.gradle\n' +
+            '  - gradle property: npr.apiKey\n' +
+            '  - environment variable: NPR_API_KEY')
+    }
 }

src/main/groovy/io/nextflow/gradle/registry/RegistryUploadTask.groovy

@@ -30,7 +30,7 @@ class RegistryUploadTask extends DefaultTask {
         final plugin = project.extensions.getByType(NextflowPluginConfig)
         final config = plugin.publishing.registry
 
-        def client = new RegistryClient(new URI(config.url), config.authToken)
+        def client = new RegistryClient(new URI(config.getResolvedUrl()), config.getResolvedApiKey())
         client.publish(project.name, version, project.file(zipFile))
     }
 }