models/version: Add purl property

Author: Turbo87

app/models/version.js

@@ -9,6 +9,7 @@ import { alias } from 'macro-decorators';
 import semverParse from 'semver/functions/parse';
 
 import ajax from '../utils/ajax';
+import { addRegistryUrl } from '../utils/purl';
 
 const EIGHT_DAYS = 8 * 24 * 60 * 60 * 1000;
 
@@ -52,6 +53,15 @@ export default class Version extends Model {
     return this.belongsTo('crate').id();
   }
 
+  /**
+   * Returns the Package URL (PURL) for this version.
+   * @type {string}
+   */
+  get purl() {
+    let basePurl = `pkg:cargo/${this.crateName}@${this.num}`;
+    return addRegistryUrl(basePurl);
+  }
+
   get editionMsrv() {
     if (this.edition === '2018') {
       return '1.31.0';

tests/models/version-test.js

@@ -1,13 +1,16 @@
 import { module, test } from 'qunit';
 
 import { calculateReleaseTracks } from '@crates-io/msw/utils/release-tracks';
+import window from 'ember-window-mock';
+import { setupWindowMock } from 'ember-window-mock/test-support';
 
 import { setupTest } from 'crates-io/tests/helpers';
 import setupMsw from 'crates-io/tests/helpers/setup-msw';
 
 module('Model | Version', function (hooks) {
   setupTest(hooks);
   setupMsw(hooks);
+  setupWindowMock(hooks);
 
   hooks.beforeEach(function () {
     this.store = this.owner.lookup('service:store');
@@ -345,4 +348,36 @@ module('Model | Version', function (hooks) {
     assert.ok(version.published_by);
     assert.strictEqual(version.published_by.name, 'JD');
   });
+
+  module('purl', function () {
+    test('generates PURL for crates.io version', async function (assert) {
+      let { db, store } = this;
+
+      window.location = 'https://crates.io';
+
+      let crate = db.crate.create({ name: 'serde' });
+      db.version.create({ crate, num: '1.0.136' });
+
+      let crateRecord = await store.findRecord('crate', crate.name);
+      let versions = (await crateRecord.versions).slice();
+      let version = versions[0];
+
+      assert.strictEqual(version.purl, 'pkg:cargo/serde@1.0.136');
+    });
+
+    test('generates PURL with registry URL for non-crates.io hosts', async function (assert) {
+      let { db, store } = this;
+
+      window.location = 'https://staging.crates.io';
+
+      let crate = db.crate.create({ name: 'test-crate' });
+      db.version.create({ crate, num: '2.5.0' });
+
+      let crateRecord = await store.findRecord('crate', crate.name);
+      let versions = (await crateRecord.versions).slice();
+      let version = versions[0];
+
+      assert.strictEqual(version.purl, 'pkg:cargo/test-crate@2.5.0?repository_url=https%3A%2F%2Fstaging.crates.io%2F');
+    });
+  });
 });