feat-no media types in paths

__tests__/no-file-extensions-in-paths-oas2.ts

@@ -0,0 +1,75 @@
+import { DiagnosticSeverity } from '@stoplight/types';
+import testRule from './__helpers__/helper';
+
+testRule('no-file-extensions-in-paths', [
+  {
+    name: 'valid case',
+    document: {
+      swagger: "2.0",
+      info: { version: '1.0' },
+      paths: { 'resources': {} }
+    },
+    errors: [],
+  },
+
+  {
+    name: 'an API definition that is returning a json file',
+    document: {
+      swagger: "2.0",
+      info: { version: '1.0' },
+      paths: { 'resources.json': {} }
+    },
+    errors: [
+      {
+        message: 'Paths must not include file extensions such as .json, .xml, .html and .txt. Use the OpenAPI `content` keyword to tell consumers which Media Types are available.',
+        path: ["paths", "resources.json"],
+        severity: DiagnosticSeverity.Error,
+      },
+    ],
+  },
+  {
+    name: 'an API definition that is returning a xml file',
+    document: {
+      swagger: "2.0",
+      info: { version: '1.0' },
+      paths: { 'resources.xml': {} }
+    },
+    errors: [
+      {
+        message: 'Paths must not include file extensions such as .json, .xml, .html and .txt. Use the OpenAPI `content` keyword to tell consumers which Media Types are available.',
+        path: ["paths", "resources.xml"],
+        severity: DiagnosticSeverity.Error,
+      },
+    ],
+  },
+  {
+    name: 'an API definition that is returning a html file',
+    document: {
+      swagger: "2.0",
+      info: { version: '1.0' },
+      paths: { 'resources.html': {} }
+    },
+    errors: [
+      {
+        message: 'Paths must not include file extensions such as .json, .xml, .html and .txt. Use the OpenAPI `content` keyword to tell consumers which Media Types are available.',
+        path: ["paths", "resources.html"],
+        severity: DiagnosticSeverity.Error,
+      },
+    ],
+  },
+  {
+    name: 'an API definition that is returning a txt file',
+    document: {
+      swagger: "2.0",
+      info: { version: '1.0' },
+      paths: { 'resources.txt': {} }
+    },
+    errors: [
+      {
+        message: 'Paths must not include file extensions such as .json, .xml, .html and .txt. Use the OpenAPI `content` keyword to tell consumers which Media Types are available.',
+        path: ["paths", "resources.txt"],
+        severity: DiagnosticSeverity.Error,
+      },
+    ],
+  }
+]);

__tests__/no-file-extensions-in-paths-oas3.ts

@@ -0,0 +1,75 @@
+import { DiagnosticSeverity } from '@stoplight/types';
+import testRule from './__helpers__/helper';
+
+testRule('no-file-extensions-in-paths', [
+  {
+    name: 'valid case',
+    document: {
+      openapi: '3.1.0',
+      info: { version: '1.0' },
+      paths: { 'resources': {} }
+    },
+    errors: [],
+  },
+
+  {
+    name: 'an API definition that is returning a json file',
+    document: {
+      openapi: '3.1.0',
+      info: { version: '1.0' },
+      paths: { 'resources.json': {} }
+    },
+    errors: [
+      {
+        message: 'Paths must not include file extensions such as .json, .xml, .html and .txt. Use the OpenAPI `content` keyword to tell consumers which Media Types are available.',
+        path: ["paths", "resources.json"],
+        severity: DiagnosticSeverity.Error,
+      },
+    ],
+  },
+  {
+    name: 'an API definition that is returning a xml file',
+    document: {
+      openapi: '3.1.0',
+      info: { version: '1.0' },
+      paths: { 'resources.xml': {} }
+    },
+    errors: [
+      {
+        message: 'Paths must not include file extensions such as .json, .xml, .html and .txt. Use the OpenAPI `content` keyword to tell consumers which Media Types are available.',
+        path: ["paths", "resources.xml"],
+        severity: DiagnosticSeverity.Error,
+      },
+    ],
+  },
+  {
+    name: 'an API definition that is returning a html file',
+    document: {
+      openapi: '3.1.0',
+      info: { version: '1.0' },
+      paths: { 'resources.html': {} }
+    },
+    errors: [
+      {
+        message: 'Paths must not include file extensions such as .json, .xml, .html and .txt. Use the OpenAPI `content` keyword to tell consumers which Media Types are available.',
+        path: ["paths", "resources.html"],
+        severity: DiagnosticSeverity.Error,
+      },
+    ],
+  },
+  {
+    name: 'an API definition that is returning a txt file',
+    document: {
+      openapi: '3.1.0',
+      info: { version: '1.0' },
+      paths: { 'resources.txt': {} }
+    },
+    errors: [
+      {
+        message: 'Paths must not include file extensions such as .json, .xml, .html and .txt. Use the OpenAPI `content` keyword to tell consumers which Media Types are available.',
+        path: ["paths", "resources.txt"],
+        severity: DiagnosticSeverity.Error,
+      },
+    ],
+  }
+]);

src/ruleset.ts

@@ -279,6 +279,21 @@ export default {
       severity: DiagnosticSeverity.Warning,
     },
 
+    // Author: Advanced API & Integrations Team (https://www.oneadvanced.com/)
+    "no-file-extensions-in-paths": {
+      description: "Paths must not include file extensions such as .json, .xml, .html and .txt",
+      message:
+        "Paths must not include file extensions such as .json, .xml, .html and .txt. Use the OpenAPI `content` keyword to tell consumers which Media Types are available.",
+        given: "$.paths[*]~",
+        then: {
+        function: pattern,
+        functionOptions: {
+          notMatch: "\.(json|xml|html|txt)$",
+        },
+      },
+      severity: DiagnosticSeverity.Error,
+    },
+
     // Author: Advanced API & Integrations Team (https://www.oneadvanced.com/)
     "adv-security-schemes-defined": {
       description: "All APIs MUST have a security scheme defined.",