screwdriver-api 6.0.7 → 6.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "screwdriver-api",
-  "version": "6.0.7",
+  "version": "6.0.9",
   "description": "API server for the Screwdriver.cd service",
   "main": "index.js",
   "scripts": {

package/plugins/templates/README.md

@@ -58,6 +58,18 @@ You can get a single template by providing the template name and the specific ve
 * `tag` - Tag of the template (e.g. `stable`, `latest`, etc)
 * `version` - Version of the template
 
+##### Get a single template using templateId
+
+You can get a single template by providing the template id.
+
+`GET /templates/{id}`
+
+###### Arguments
+
+'id'
+
+* `id` - Id of the template
+
 ##### Create a template
 Creating a template will store the template data (`config`, `name`, `version`, `description`, `maintainer`) into the datastore.
 

package/plugins/templates/getTemplateById.js

@@ -0,0 +1,46 @@
+'use strict';
+
+const boom = require('@hapi/boom');
+const joi = require('joi');
+const schema = require('screwdriver-data-schema');
+const getSchema = schema.models.template.get;
+const idSchema = schema.models.template.base.extract('id');
+
+module.exports = () => ({
+    method: 'GET',
+    path: '/template/{id}',
+    options: {
+        description: 'Get a single template',
+        notes: 'Returns a template record',
+        tags: ['api', 'templates'],
+        auth: {
+            strategies: ['token'],
+            scope: ['user', 'build']
+        },
+
+        handler: async (request, h) => {
+            const { templateFactory } = request.server.app;
+
+            return templateFactory
+                .get({ id: request.params.id })
+                .then(async template => {
+                    if (!template) {
+                        throw boom.notFound('Template does not exist');
+                    }
+
+                    return h.response(template);
+                })
+                .catch(err => {
+                    throw err;
+                });
+        },
+        response: {
+            schema: getSchema
+        },
+        validate: {
+            params: joi.object({
+                id: idSchema
+            })
+        }
+    }
+});

package/plugins/templates/index.js

@@ -11,6 +11,7 @@ const listVersionsWithMetricsRouter = require('./listVersionsWithMetric');
 const removeRoute = require('./remove');
 const removeTagRoute = require('./removeTag');
 const updateTrustedRoute = require('./updateTrusted');
+const getTemplateByIdRoute = require('./getTemplateById');
 
 /**
  * Template API Plugin
@@ -83,7 +84,8 @@ const templatesPlugin = {
             listVersionsWithMetricsRouter(),
             removeRoute(),
             removeTagRoute(),
-            updateTrustedRoute()
+            updateTrustedRoute(),
+            getTemplateByIdRoute()
         ]);
     }
 };