feat(openapi): add --dryRun option

__tests__/__snapshots__/index.test.ts.snap

@@ -24,6 +24,8 @@ Options
   --create                    Bypasses the create/update prompt and creates a new API definition.   
   --update                    Automatically update an existing API definition in ReadMe if it's the 
                               only one associated with the current version.                         
+  --dryRun                    Runs the command without creating/updating any OAS specs in ReadMe.   
+                              Useful for debugging.                                                 
   -h, --help                  Display this usage guide                                              
 
 Related commands
@@ -57,6 +59,8 @@ Options
   --create                    Bypasses the create/update prompt and creates a new API definition.   
   --update                    Automatically update an existing API definition in ReadMe if it's the 
                               only one associated with the current version.                         
+  --dryRun                    Runs the command without creating/updating any OAS specs in ReadMe.   
+                              Useful for debugging.                                                 
   -h, --help                  Display this usage guide                                              
 
 Related commands
@@ -90,6 +94,8 @@ Options
   --create                    Bypasses the create/update prompt and creates a new API definition.   
   --update                    Automatically update an existing API definition in ReadMe if it's the 
                               only one associated with the current version.                         
+  --dryRun                    Runs the command without creating/updating any OAS specs in ReadMe.   
+                              Useful for debugging.                                                 
   -h, --help                  Display this usage guide                                              
 
 Related commands

__tests__/cmds/openapi/index.test.ts

@@ -368,6 +368,41 @@ describe('rdme openapi', () => {
       return mock.done();
     });
 
+    it('should return spec create info for dry run', async () => {
+      const registryUUID = getRandomRegistryId();
+
+      const mock = getAPIMock()
+        .get(`/api/v1/version/${version}`)
+        .basicAuth({ user: key })
+        .reply(200, { version })
+        .post('/api/v1/api-registry', body => body.match('form-data; name="spec"'))
+        .reply(201, { registryUUID, spec: { openapi: '3.0.0' } });
+
+      const mockWithHeader = getAPIMockWithVersionHeader(version)
+        .get('/api/v1/api-specification')
+        .basicAuth({ user: key })
+        .reply(200, []);
+
+      await expect(
+        openapi.run({
+          key,
+          version,
+          dryRun: true,
+          workingDirectory: './__tests__/__fixtures__/relative-ref-oas',
+        })
+      ).resolves.toBe('🎭 dry run! The spec at petstore.json will be uploaded to version 1.0.0');
+
+      const output = getCommandOutput();
+      expect(output).toMatch(
+        chalk.yellow(
+          '🎭 dry run! This will not create or update any API definition and is used only for debug purposes!'
+        )
+      );
+
+      mockWithHeader.done();
+      return mock.done();
+    });
+
     describe('CI spec selection', () => {
       beforeEach(() => {
         process.env.TEST_CI = 'true';
@@ -488,6 +523,40 @@ describe('rdme openapi', () => {
       return mock.done();
     });
 
+    it('should return spec update info for dry run', async () => {
+      prompts.inject(['update', 'spec2']);
+      const registryUUID = getRandomRegistryId();
+
+      const mock = getAPIMock()
+        .get(`/api/v1/version/${version}`)
+        .basicAuth({ user: key })
+        .reply(200, { version })
+        .post('/api/v1/api-registry', body => body.match('form-data; name="spec"'))
+        .reply(201, { registryUUID, spec: { openapi: '3.0.0' } });
+
+      const mockWithHeader = getAPIMockWithVersionHeader(version)
+        .get('/api/v1/api-specification')
+        .basicAuth({ user: key })
+        .reply(200, [
+          { _id: 'spec1', title: 'spec1_title' },
+          { _id: 'spec2', title: 'spec2_title' },
+        ]);
+
+      const spec = './__tests__/__fixtures__/ref-oas/petstore.json';
+
+      await expect(
+        openapi.run({
+          key,
+          version,
+          spec,
+          dryRun: true,
+        })
+      ).resolves.toMatch('dry run! The spec with the id spec2 will be updated');
+
+      mockWithHeader.done();
+      return mock.done();
+    });
+
     describe('--update', () => {
       it("should update a spec file without prompts if providing `update` and it's the one spec available", async () => {
         const registryUUID = getRandomRegistryId();

src/cmds/openapi/index.ts

@@ -26,6 +26,7 @@ export type Options = {
   useSpecVersion?: boolean;
   workingDirectory?: string;
   update?: boolean;
+  dryRun?: boolean;
 };
 
 export default class OpenAPICommand extends Command {
@@ -81,13 +82,18 @@ export default class OpenAPICommand extends Command {
         description:
           "Automatically update an existing API definition in ReadMe if it's the only one associated with the current version.",
       },
+      {
+        name: 'dryRun',
+        type: Boolean,
+        description: 'Runs the command without creating/updating any OAS specs in ReadMe. Useful for debugging.',
+      },
     ];
   }
 
   async run(opts: CommandOptions<Options>) {
     super.run(opts);
 
-    const { key, id, spec, create, raw, useSpecVersion, version, workingDirectory, update } = opts;
+    const { dryRun, key, id, spec, create, raw, useSpecVersion, version, workingDirectory, update } = opts;
 
     let selectedVersion = version;
     let isUpdate: boolean;
@@ -98,6 +104,12 @@ export default class OpenAPICommand extends Command {
      */
     const ignoredGHAParameters: Options = { version: undefined, update: undefined };
 
+    if (dryRun) {
+      Command.warn(
+        '🎭 dry run! This will not create or update any API definition and is used only for debug purposes!'
+      );
+    }
+
     if (create && update) {
       throw new Error(
         'The `--create` and `--update` options cannot be used simultaneously. Please use one or the other!'
@@ -224,6 +236,10 @@ export default class OpenAPICommand extends Command {
     };
 
     function createSpec() {
+      if (dryRun) {
+        return `🎭 dry run! The spec at ${specPath} will be uploaded to version ${selectedVersion}`;
+      }
+
       options.method = 'post';
       spinner.start('Creating your API docs in ReadMe...');
       return fetch(`${config.get('host')}/api/v1/api-specification`, options).then(res => {
@@ -237,6 +253,10 @@ export default class OpenAPICommand extends Command {
     }
 
     function updateSpec(specId: string) {
+      if (dryRun) {
+        return `🎭 dry run! The spec with the id ${specId} will be updated`;
+      }
+
       isUpdate = true;
       options.method = 'put';
       spinner.start('Updating your API docs in ReadMe...');