@cparra/apexdocs 2.25.0-alpha.8 → 2.25.0

package/src/core/markdown/__test__/generating-enum-docs.spec.ts

@@ -1,385 +0,0 @@
-import { assertEither, extendExpect } from './expect-extensions';
-import { apexBundleFromRawString, generateDocs } from './test-helpers';
-
-describe('Generates enum documentation', () => {
-  beforeAll(() => {
-    extendExpect();
-  });
-
-  describe('documentation output', () => {
-    it('returns the name of the enum', async () => {
-      const input = `
-     public enum MyEnum {
-        VALUE1,
-        VALUE2
-      }
-    `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data.docs[0].fileName).toBe('MyEnum'));
-    });
-
-    it('returns the type as enum', async () => {
-      const input = `
-     public enum MyEnum {
-        VALUE1,
-        VALUE2
-      }
-    `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data.docs[0].source.type).toBe('enum'));
-    });
-
-    it('does not return enums out of scope', async () => {
-      const input1 = `
-     global enum MyEnum {
-        VALUE1,
-        VALUE2
-      }
-    `;
-
-      const input2 = `
-      public enum MyEnum {
-          VALUE1,
-          VALUE2
-        }
-      `;
-
-      const result = await generateDocs([apexBundleFromRawString(input1), apexBundleFromRawString(input2)], {
-        scope: ['global'],
-      })();
-      expect(result).documentationBundleHasLength(1);
-    });
-
-    it('does not return enums that have an @ignore in the docs', async () => {
-      const input = `
-      /**
-        * @ignore
-        */
-      public enum MyEnum {
-        VALUE1,
-        VALUE2
-      }
-      `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(0);
-    });
-  });
-
-  describe('documentation content', () => {
-    it('generates a heading with the enum name', async () => {
-      const input = `
-     public enum MyEnum {
-        VALUE1,
-        VALUE2
-      }
-    `;
-
-      const output = `# MyEnum Enum`;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data).firstDocContains(output));
-    });
-
-    it('displays type level annotations', async () => {
-      const input = `
-        @NamespaceAccessible
-        public enum MyEnum {
-           VALUE1,
-           VALUE2
-         }
-       `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data).firstDocContains('NAMESPACEACCESSIBLE'));
-    });
-
-    it('displays the description', async () => {
-      const input = `
-     /**
-      * This is a description
-      */
-     public enum MyEnum {
-        VALUE1,
-        VALUE2
-      }
-    `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data).firstDocContains('This is a description'));
-    });
-
-    it('display custom documentation tags', async () => {
-      const input = `
-     /**
-      * @custom-tag My Value
-      */
-     public enum MyEnum {
-        VALUE1,
-        VALUE2
-      }
-    `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data).firstDocContains('Custom Tag'));
-      assertEither(result, (data) => expect(data).firstDocContains('My Value'));
-    });
-
-    it('displays the group', async () => {
-      const input = `
-     /**
-      * @group MyGroup
-      */
-     public enum MyEnum {
-        VALUE1,
-        VALUE2
-      }
-    `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data).firstDocContains('Group'));
-      assertEither(result, (data) => expect(data).firstDocContains('MyGroup'));
-    });
-
-    it('displays the author', async () => {
-      const input = `
-     /**
-      * @author John Doe
-      */
-     public enum MyEnum {
-        VALUE1,
-        VALUE2
-      }
-    `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data).firstDocContains('Author'));
-      assertEither(result, (data) => expect(data).firstDocContains('John Doe'));
-    });
-
-    it('displays the date', async () => {
-      const input = `
-     /**
-      * @date 2021-01-01
-      */
-     public enum MyEnum {
-        VALUE1,
-        VALUE2
-      }
-    `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data).firstDocContains('Date'));
-      assertEither(result, (data) => expect(data).firstDocContains('2021-01-01'));
-    });
-
-    it('displays descriptions', async () => {
-      const input = `
-      /**
-        * @description This is a description
-        */
-      public enum MyEnum {}
-      `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data).firstDocContains('This is a description'));
-    });
-
-    it('displays descriptions with links', async () => {
-      const input1 = `
-      /**
-        * @description This is a description with a {@link EnumRef} reference
-        */
-      public enum MyEnum {}
-      `;
-
-      const input2 = 'public enum EnumRef {}';
-
-      const result = await generateDocs([apexBundleFromRawString(input1), apexBundleFromRawString(input2)])();
-      expect(result).documentationBundleHasLength(2);
-      assertEither(result, (data) => expect(data).firstDocContains('Description'));
-      assertEither(result, (data) =>
-        expect(data).firstDocContains('This is a description with a [EnumRef](./EnumRef.md) reference'),
-      );
-    });
-
-    it('displays descriptions with emails', async () => {
-      const input = `
-      /**
-        * @description This is a description with an {@email test@testerson.com} email
-        */
-      public enum MyEnum {}
-      `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) =>
-        expect(data).firstDocContains(
-          'This is a description with an [test@testerson.com](mailto:test@testerson.com) email',
-        ),
-      );
-    });
-
-    it('displays sees with accurately resolved links', async () => {
-      const input1 = `
-      /**
-        * @see EnumRef
-        */
-      public enum MyEnum {}
-      `;
-
-      const input2 = 'public enum EnumRef {}';
-
-      const result = await generateDocs([apexBundleFromRawString(input1), apexBundleFromRawString(input2)])();
-      expect(result).documentationBundleHasLength(2);
-      assertEither(result, (data) => expect(data).firstDocContains('See'));
-      assertEither(result, (data) => expect(data).firstDocContains('[EnumRef](./EnumRef.md)'));
-    });
-
-    it('displays sees without links when the reference is not found', async () => {
-      const input = `
-      /**
-        * @see EnumRef
-        */
-      public enum MyEnum {}
-      `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data).firstDocContains('See'));
-      assertEither(result, (data) => expect(data).firstDocContains('EnumRef'));
-    });
-
-    it('displays the namespace if present in the config', async () => {
-      const input = `
-      public enum MyEnum {}
-      `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)], { namespace: 'MyNamespace' })();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data).firstDocContains('## Namespace'));
-      assertEither(result, (data) => expect(data).firstDocContains('MyNamespace'));
-    });
-
-    it('does not display the namespace if not present in the config', async () => {
-      const input = `
-      public enum MyEnum {}
-      `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data).firstDocContainsNot('## Namespace'));
-    });
-
-    it('displays a mermaid diagram', async () => {
-      const input = `
-      /**
-        * @mermaid
-        * \`\`\`mermaid
-        * graph TD
-        *   A[Square Rect] -- Link text --> B((Circle))
-        *   A --> C(Round Rect)
-        *   B --> D{Rhombus}
-        *   C --> D
-        * \`\`\`
-        */
-      public enum MyEnum {
-        VALUE1,
-        VALUE2
-      }
-      `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data).firstDocContains('```mermaid'));
-      assertEither(result, (data) => expect(data).firstDocContains('graph TD'));
-    });
-
-    it('displays an example code block', async () => {
-      const input = `
-      /**
-        * @example
-        * \`\`\`apex
-        * public class MyClass {
-        *   public void myMethod() {
-        *     System.debug('Hello, World!');
-        *   }
-        * }
-        * \`\`\`
-        */
-      public enum MyEnum {
-        VALUE1,
-        VALUE2
-      }
-      `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data).firstDocContains('```apex'));
-      assertEither(result, (data) => expect(data).firstDocContains('public class MyClass'));
-    });
-
-    it('displays values', async () => {
-      const input = `
-      public enum MyEnum {
-        VALUE1,
-        VALUE2
-      }
-      `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)])();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data).firstDocContains('## Values'));
-      assertEither(result, (data) => expect(data).firstDocContains('VALUE1'));
-      assertEither(result, (data) => expect(data).firstDocContains('VALUE2'));
-    });
-
-    it('displays values sorted when sortMembersAlphabetically is true', async () => {
-      const input = `
-      public enum MyEnum {
-        VALUE2,
-        VALUE1
-      }
-      `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)], { sortMembersAlphabetically: true })();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data).firstDocContains('## Values'));
-      assertEither(result, (data) => {
-        const value1Index = data.docs[0].content.indexOf('VALUE1');
-        const value2Index = data.docs[0].content.indexOf('VALUE2');
-        expect(value1Index).toBeLessThan(value2Index);
-      });
-    });
-
-    it('does not sort values when sortMembersAlphabetically is false', async () => {
-      const input = `
-      public enum MyEnum {
-        VALUE2,
-        VALUE1
-      }
-      `;
-
-      const result = await generateDocs([apexBundleFromRawString(input)], { sortMembersAlphabetically: false })();
-      expect(result).documentationBundleHasLength(1);
-      assertEither(result, (data) => expect(data).firstDocContains('## Values'));
-      assertEither(result, (data) => {
-        const value1Index = data.docs[0].content.indexOf('VALUE1');
-        const value2Index = data.docs[0].content.indexOf('VALUE2');
-        expect(value1Index).toBeGreaterThan(value2Index);
-      });
-    });
-  });
-});