add GitLab Release badge, run all [GitLab]

services/gitlab/gitlab-base.js

@@ -16,4 +16,50 @@ export default class GitLabBase extends BaseJsonService {
       })
     )
   }
+
+  async fetchPage({ page, requestParams, schema }) {
+    const { res, buffer } = await this._request({
+      ...requestParams,
+      ...{ options: { qs: { page } } },
+    })
+
+    const json = this._parseJson(buffer)
+    const data = this.constructor._validate(json, schema)
+    return { res, data }
+  }
+
+  async fetchPaginatedArrayData({
+    url,
+    options,
+    schema,
+    errorMessages,
+    firstPageOnly = false,
+  }) {
+    const requestParams = this.authHelper.withBasicAuth({
+      url,
+      options: {
+        headers: { Accept: 'application/json' },
+        qs: { per_page: 100 },
+        ...options,
+      },
+      errorMessages,
+    })
+
+    const {
+      res: { headers },
+      data,
+    } = await this.fetchPage({ page: 1, requestParams, schema })
+    const numberOfPages = headers['x-total-pages']
+
+    if (numberOfPages === 1 || firstPageOnly) {
+      return data
+    }
+
+    const pageData = await Promise.all(
+      [...Array(numberOfPages - 1).keys()].map((_, i) =>
+        this.fetchPage({ page: ++i + 1, requestParams, schema })
+      )
+    )
+    return [...data].concat(...pageData)
+  }
 }

services/gitlab/gitlab-release.service.js

@@ -0,0 +1,136 @@
+import Joi from 'joi'
+import { optionalUrl } from '../validators.js'
+import { latest, renderVersionBadge } from '../version.js'
+import { NotFound } from '../index.js'
+import GitLabBase from './gitlab-base.js'
+
+const schema = Joi.array().items(
+  Joi.object({
+    name: Joi.string().required(),
+    tag_name: Joi.string().required(),
+  })
+)
+
+const queryParamSchema = Joi.object({
+  gitlab_url: optionalUrl,
+  include_prereleases: Joi.equal(''),
+  sort: Joi.string().valid('date', 'semver').default('date'),
+  display_name: Joi.string().valid('tag', 'release').default('tag'),
+}).required()
+
+const namedParams = {
+  user: 'shields-ops-group',
+  repo: 'repo-test',
+}
+
+export default class GitLabRelease extends GitLabBase {
+  static category = 'version'
+
+  static route = {
+    base: 'gitlab/v/release',
+    pattern: ':user/:repo',
+    queryParamSchema,
+  }
+
+  static examples = [
+    {
+      title: 'GitLab Release (latest by date)',
+      namedParams,
+      queryParams: { sort: 'date' },
+      staticPreview: renderVersionBadge({ version: 'v2.0.0' }),
+    },
+    {
+      title: 'GitLab Release (latest by SemVer)',
+      namedParams,
+      queryParams: { sort: 'semver' },
+      staticPreview: renderVersionBadge({ version: 'v4.0.0' }),
+    },
+    {
+      title: 'GitLab Release (latest by SemVer pre-release)',
+      namedParams,
+      queryParams: {
+        sort: 'semver',
+        include_prereleases: null,
+      },
+      staticPreview: renderVersionBadge({ version: 'v5.0.0-beta.1' }),
+    },
+    {
+      title: 'GitLab Release (custom instance)',
+      namedParams: {
+        user: 'GNOME',
+        repo: 'librsvg',
+      },
+      queryParams: {
+        sort: 'semver',
+        include_prereleases: null,
+        gitlab_url: 'https://gitlab.gnome.org',
+      },
+      staticPreview: renderVersionBadge({ version: 'v2.51.4' }),
+    },
+    {
+      title: 'GitLab Release (by release name)',
+      namedParams: {
+        user: 'gitlab-org',
+        repo: 'gitlab',
+      },
+      queryParams: {
+        sort: 'semver',
+        include_prereleases: null,
+        gitlab_url: 'https://gitlab.com',
+        display_name: 'release',
+      },
+      staticPreview: renderVersionBadge({ version: 'GitLab 14.2' }),
+    },
+  ]
+
+  static defaultBadgeData = { label: 'release' }
+
+  async fetch({ user, repo, baseUrl, isSemver }) {
+    // https://docs.gitlab.com/ee/api/releases/
+    return this.fetchPaginatedArrayData({
+      schema,
+      url: `${baseUrl}/api/v4/projects/${user}%2F${repo}/releases`,
+      errorMessages: {
+        404: 'project not found',
+      },
+      firstPageOnly: !isSemver,
+    })
+  }
+
+  static transform({ releases, isSemver, includePrereleases, displayName }) {
+    if (releases.length === 0) {
+      throw new NotFound({ prettyMessage: 'no releases found' })
+    }
+
+    const displayKey = displayName === 'tag' ? 'tag_name' : 'name'
+
+    if (!isSemver) {
+      return releases[0][displayKey]
+    }
+
+    return latest(
+      releases.map(t => t[displayKey]),
+      { pre: includePrereleases }
+    )
+  }
+
+  async handle(
+    { user, repo },
+    {
+      gitlab_url: baseUrl = 'https://gitlab.com',
+      include_prereleases: pre,
+      sort,
+      display_name: displayName,
+    }
+  ) {
+    const isSemver = sort === 'semver'
+    const releases = await this.fetch({ user, repo, baseUrl, isSemver })
+    const version = this.constructor.transform({
+      releases,
+      isSemver,
+      includePrereleases: pre !== undefined,
+      displayName,
+    })
+    return renderVersionBadge({ version })
+  }
+}

services/gitlab/gitlab-release.tester.js

@@ -0,0 +1,33 @@
+import { isSemver, withRegex } from '../test-validators.js'
+import { createServiceTester } from '../tester.js'
+export const t = await createServiceTester()
+
+const isGitLabDisplayVersion = withRegex(/^GitLab [1-9][0-9]*.[0-9]*/)
+
+t.create('Release (latest by date)')
+  .get('/shields-ops-group/tag-test.json')
+  .expectBadge({ label: 'release', message: 'v2.0.0', color: 'blue' })
+
+t.create('Release (latest by semver)')
+  .get('/shields-ops-group/tag-test.json?sort=semver')
+  .expectBadge({ label: 'release', message: 'v4.0.0', color: 'blue' })
+
+t.create('Release (latest by semver pre-release)')
+  .get('/shields-ops-group/tag-test.json?sort=semver&include_prereleases')
+  .expectBadge({ label: 'release', message: 'v5.0.0-beta.1', color: 'orange' })
+
+t.create('Release (release display name)')
+  .get('/gitlab-org/gitlab.json?display_name=release')
+  .expectBadge({ label: 'release', message: isGitLabDisplayVersion })
+
+t.create('Release (custom instance')
+  .get('/GNOME/librsvg.json?gitlab_url=https://gitlab.gnome.org')
+  .expectBadge({ label: 'release', message: isSemver, color: 'blue' })
+
+t.create('Release (project not found)')
+  .get('/fdroid/nonexistant.json')
+  .expectBadge({ label: 'release', message: 'project not found' })
+
+t.create('Release (no tags)')
+  .get('/fdroid/fdroiddata.json')
+  .expectBadge({ label: 'release', message: 'no releases found' })