@cparra/apexdocs 1.13.8 → 1.14.0

package/README.md

@@ -8,14 +8,21 @@
 
 ## Description
 
-ApexDocs was built as an alternative to the [Java based ApexDoc tool](https://github.com/SalesforceFoundation/ApexDoc) originally created by Aslam Bari and later maintained by Salesforce.org, as that tool is no longer being maintained.
+ApexDocs was built as an alternative to the [Java based ApexDoc tool](https://github.com/SalesforceFoundation/ApexDoc)
+originally created by Aslam Bari and later maintained by Salesforce.org, as that tool is no longer being maintained.
 
-ApexDocs is a Node.js library built on Typescript and hosted on [npm](https://www.npmjs.com/package/@cparra/apexdocs). It offers CLI capabilities to automatically generate a set of files that fully document each one of you classes. Additionally it can be imported and consumed directly by your JavaScript code.
+ApexDocs is a Node.js library built on Typescript and hosted on [npm](https://www.npmjs.com/package/@cparra/apexdocs).
+It offers CLI capabilities to automatically generate a set of files that fully document each one of you classes.
+Additionally, it can be imported and consumed directly by your JavaScript code.
 
 There are some key differences between ApexDocs and the Java based ApexDoc tool:
 
-- **Recursive file search through your module directory structure**. In an `sfdx` based project, all of your classes will be documented by specifying the top-most directory where file search should begin.
-- **Unopinionated documentation site generation**. Instead of creating HTML files, ApexDocs generates a Markdown (.md) file per Apex class being documented. This means you can host your files in static web hosting services that parse Markdown like Github Pages or Netlify, and use site generators like Jekyll or Gatsby. This gives you the freedom to decide how to style your site to match your needs.
+- **Recursive file search through your module directory structure**. In an `sfdx` based project, all of your classes
+  will be documented by specifying the top-most directory where file search should begin.
+- **Unopinionated documentation site generation**. Instead of creating HTML files, ApexDocs generates a Markdown (.md)
+  file per Apex class being documented. This means you can host your files in static web hosting services that parse
+  Markdown like Github Pages or Netlify, and use site generators like Jekyll or Gatsby. This gives you the freedom to
+  decide how to style your site to match your needs.
 
 ### Demo
 
@@ -58,19 +65,20 @@ apexdocs-generate
 
 The CLI supports the following parameters:
 
-| Parameter         | Alias | Description                                                                                                      | Default                             | Required |
-| ----------------- | ----- | ---------------------------------------------------------------------------------------------------------------- | ----------------------------------- | -------- |
-| --sourceDir       | -s    | The directory location which contains your apex .cls classes.                                                    | N/A                                 | Yes      |
-| --targetDir       | -t    | The directory location where documentation will be generated to.                                                 | `docs`                              | No       |
-| --recursive       | -r    | Whether .cls classes will be searched for recursively in the directory provided.                                 | `true`                              | No       |
-| --scope           | -p    | A list of scopes to document. Values should be separated by a space, e.g --scope public private                  | `global namespaceaccessible public` | No       |
-| --targetGenerator | -g    | Define the static file generator for which the documents will be created. Currently supports jekyll and docsify. | `jekyll`                            | No       |
-| --configPath      | -c    | The path to the JSON configuration file that defines the structure of the documents to generate.                 | N/A                                 | No       |
-| --group           | -o    | Define whether the generated files should be grouped by the @group tag on the top level classes.                 | `true`                              | No       |
+| Parameter         | Alias | Description                                                                                                                                 | Default                             | Required |
+| ----------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------| ----------------------------------- | -------- |
+| --sourceDir       | -s    | The directory or directories location(s) which contains your apex .cls classes. Multiple directories can be specified separated by spaces   | N/A                                 | Yes      |
+| --targetDir       | -t    | The directory location where documentation will be generated to.                                                                            | `docs`                              | No       |
+| --recursive       | -r    | Whether .cls classes will be searched for recursively in the directory provided.                                                            | `true`                              | No       |
+| --scope           | -p    | A list of scopes to document. Values should be separated by a space, e.g --scope public private                                             | `global namespaceaccessible public` | No       |
+| --targetGenerator | -g    | Define the static file generator for which the documents will be created. Currently supports jekyll and docsify.                            | `jekyll`                            | No       |
+| --configPath      | -c    | The path to the JSON configuration file that defines the structure of the documents to generate.                                            | N/A                                 | No       |
+| --group           | -o    | Define whether the generated files should be grouped by the @group tag on the top level classes.                                            | `true`                              | No       |
 
 #### Configuration File
 
-You can optionally specify the path to a configuration JSON file through the `--configPath` parameter. This let's you have some additional control over the content outputs.
+You can optionally specify the path to a configuration JSON file through the `--configPath` parameter. This let's you
+have some additional control over the content outputs.
 
 The configuration file allows you to specify the following:
 
@@ -80,7 +88,8 @@ _Note_: Everything in the configuration file is optional. When something is not
 
 Default: None
 
-Allows you to specify the root directory for where the files are being generated. This can be helpful when embedding the generated docs into an existing site so that the links are generated correctly.
+Allows you to specify the root directory for where the files are being generated. This can be helpful when embedding the
+generated docs into an existing site so that the links are generated correctly.
 
 `defaultGroupName`
 
@@ -92,9 +101,11 @@ Defines the `@group` name to be used when a file does not specify it.
 
 Default: None
 
-Defines the name of the language that will be used when generating `@example` blocks. Use this when you are interested in using syntax highlighting for your project.
+Defines the name of the language that will be used when generating `@example` blocks. Use this when you are interested
+in using syntax highlighting for your project.
 
-Even though the source code material for which documentation is generated is always `Apex`, generally you will be able to use a syntax highlighter that recognizes `java` source code, so set this value to `java` in those cases.
+Even though the source code material for which documentation is generated is always `Apex`, generally you will be able
+to use a syntax highlighter that recognizes `java` source code, so set this value to `java` in those cases.
 
 `home` (Object)
 
@@ -104,7 +115,8 @@ Gives you control over the home page.
 
 Default: None
 
-Allows you to embedd custom content into your home page by using the `header` property to point to the a file which contents will be added to the top of the generated home page.
+Allows you to embed custom content into your home page by using the `header` property to point to the a file which
+contents will be added to the top of the generated home page.
 
 Specify the path with the content that you want to embed.
 
@@ -128,7 +140,9 @@ Whether the `@date` tag should be used to add the file's date to the page.
 
 Default: 1
 
-The starting H tag level for the document. Each title will use this as the starting point to generate the approaprite `<h#>` tag. For example, if set to 1, the class' file name at the top of the file will use an `<h1>` tag, the `Properties` title will be `<h2>`, each property name will be an `<h3>`, etc.
+The starting H tag level for the document. Each title will use this as the starting point to generate the
+appropriate `<h#>` tag. For example, if set to 1, the class' file name at the top of the file will use an `<h1>` tag,
+the `Properties` title will be `<h2>`, each property name will be an `<h3>`, etc.
 
 ```
 {
@@ -150,7 +164,8 @@ The starting H tag level for the document. Each title will use this as the start
 
 If you are just interested in the documentation parsing capabilities, you can import ApexDocs into your own project.
 
-Use the `generate` function to create a list of `ClassModel` that includes all of the parsed information from your .cls files.
+Use the `generate` function to create a list of `ClassModel` that includes all the parsed information from your .cls
+files.
 
 `generate(sourceDirectory[,recursive][,scope][,outputDir])`
 
@@ -167,7 +182,8 @@ let documentedClasses = generate('src', true, ['global'], 'docs');
 
 ## Documentation Format
 
-ApexDocs picks up blocks of comments throughout your `.cls` files. The block must begin with `/**` and span through multiple lines, ending with `*/`.
+ApexDocs picks up blocks of comments throughout your `.cls` files. The block must begin with `/**` and span through
+multiple lines, ending with `*/`.
 
 ### Documenting Classes
 
@@ -187,7 +203,10 @@ The following tags are supported on the class level:
 /**
  * @description This is my class description.
  */
- public with sharing class TestClass { }
+public with sharing
+
+class TestClass {
+}
 ```
 
 ### Documenting Enums
@@ -204,7 +223,7 @@ The following tags are supported on the enum level:
 /**
  * @description This is my enum description.
  */
- public Enum ExampleEnum { VALUE_1, VALUE_2 }
+public Enum ExampleEnum{VALUE_1,VALUE_2}
 ```
 
 ### Documenting Properties
@@ -221,7 +240,7 @@ The following tags are supported on the property level:
 /**
  * @description This is my property description.
  */
- public String ExampleProperty { get; set; }
+public String ExampleProperty{get;set;}
 ```
 
 ### Documenting Methods and Constructors
@@ -248,13 +267,13 @@ The following tags are supported on the method level:
  * @example
  * Object result = SampleClass.call('exampleAction');
  */
- public static Object call(String action) {
+public static Object call(String action){
 ```
 
 ### Inline linking
 
-Apexdocs allows you to reference other classes from anywhere in your docs, and automatically creates a link to that class
-file for easy navigation.
+Apexdocs allows you to reference other classes from anywhere in your docs, and automatically creates a link to that
+class file for easy navigation.
 
 Apexdocs recognizes 2 different syntax when linking files:
 
@@ -269,7 +288,7 @@ Apexdocs recognizes 2 different syntax when linking files:
  * @param param1 An <<ExampleClass>> instance. Can also do {@link ExampleClass}
  * @return The result of the operation.
  */
- public static Object class(ExampleClass param1) {
+public static Object class(ExampleClass param1){
 ```
 
 ## Typescript

package/docs/Sample-Classes/SampleClass.md

@@ -1,115 +1,115 @@
----
-layout: default
----
-# SampleClass class
-
-`NamespaceAccessible`
-
-This is a class description.
-
-## Related
-
-[SampleInterface](../Sample-Interfaces/SampleInterface.md)
-
-
-[SampleClass2](../Sample-Classes/SampleClass2.md)
-
----
-## Constructors
-### `SampleClass()`
-
-`NamespaceAccessible`
-
-Constructs a SampleClass without any arguments.
-#### Example
-```
-<pre>
-SampleClass sampleInstance = new SampleClass();
-```
-
-### `SampleClass(String argument)`
-
-`NamespaceAccessible`
-
-Constructs a SampleClass with an argument.
-#### Parameters
-
-| Param | Description |
-| ----- | ----------- |
-|`argument` |  Some argument |
-
----
-## Properties
-
-### `AnotherProp` → `Decimal`
-
-`NamespaceAccessible`
-
-This is a Decimal property.
-
-### `MyProp` → `String`
-
-`NamespaceAccessible`
-
-This is a String property.
-
----
-## Methods
-### `call()` → `void`
-
-`NamespaceAccessible`
-
-Calls the method. This methods allows you to call it.
-
-### `testMethod(String argument)` → `String`
-
-`NamespaceAccessible`
-
-Executes commands based on the passed in argument.
-
-#### Example
-```
-<pre>
-String result = SampleClass.testMethod();
-System.debug(result);
-```
-
----
-## Inner Classes
-
-### SampleClass.AnotherInnerClass class
-
-Inner class belonging to SampleClass.
-
----
-#### Properties
-
-##### `InnerProp` → `public`
-
-Description of the inner property.
-
----
-#### Methods
-##### `innerMethod()` → `void`
-
-Executes from the inner class.
-
----
-### SampleClass.InnerClass class
-
-Inner class belonging to SampleClass.
-
----
-#### Properties
-
-##### `InnerProp` → `public`
-
-Description of the inner property.
-
----
-#### Methods
-##### `innerMethod()` → `void`
-
-Executes from the inner class.
-
----
+---
+layout: default
+---
+# SampleClass class
+
+`NamespaceAccessible`
+
+This is a class description.
+
+## Related
+
+SampleInterface
+
+
+SampleClass2
+
+---
+## Constructors
+### `SampleClass()`
+
+`NamespaceAccessible`
+
+Constructs a SampleClass without any arguments.
+#### Example
+```
+<pre>
+SampleClass sampleInstance = new SampleClass();
+```
+
+### `SampleClass(String argument)`
+
+`NamespaceAccessible`
+
+Constructs a SampleClass with an argument.
+#### Parameters
+
+| Param | Description |
+| ----- | ----------- |
+|`argument` |  Some argument |
+
+---
+## Properties
+
+### `AnotherProp` → `Decimal`
+
+`NamespaceAccessible`
+
+This is a Decimal property.
+
+### `MyProp` → `String`
+
+`NamespaceAccessible`
+
+This is a String property.
+
+---
+## Methods
+### `call()` → `void`
+
+`NamespaceAccessible`
+
+Calls the method. This methods allows you to call it.
+
+### `testMethod(String argument)` → `String`
+
+`NamespaceAccessible`
+
+Executes commands based on the passed in argument.
+
+#### Example
+```
+<pre>
+String result = SampleClass.testMethod();
+System.debug(result);
+```
+
+---
+## Inner Classes
+
+### SampleClass.AnotherInnerClass class
+
+Inner class belonging to SampleClass.
+
+---
+#### Properties
+
+##### `InnerProp` → `public`
+
+Description of the inner property.
+
+---
+#### Methods
+##### `innerMethod()` → `void`
+
+Executes from the inner class.
+
+---
+### SampleClass.InnerClass class
+
+Inner class belonging to SampleClass.
+
+---
+#### Properties
+
+##### `InnerProp` → `public`
+
+Description of the inner property.
+
+---
+#### Methods
+##### `innerMethod()` → `void`
+
+Executes from the inner class.
+
+---

package/docs/Sample-Classes/SampleClass2.md

@@ -1,115 +1,115 @@
----
-layout: default
----
-# SampleClass2 class
-
-`NamespaceAccessible`
-
-This is a class description.
-
-## Related
-
-[SampleInterface](../Sample-Interfaces/SampleInterface.md)
-
-
-[SampleClass](../Sample-Classes/SampleClass.md)
-
----
-## Constructors
-### `SampleClass2()`
-
-`NamespaceAccessible`
-
-Constructs a SampleClass2 without any arguments.
-#### Example
-```
-<pre>
-SampleClass2 sampleInstance = new SampleClass2();
-```
-
-### `SampleClass2(String argument)`
-
-`NamespaceAccessible`
-
-Constructs a SampleClass2 with an argument.
-#### Parameters
-
-| Param | Description |
-| ----- | ----------- |
-|`argument` |  Some argument |
-
----
-## Properties
-
-### `AnotherProp` → `Decimal`
-
-`NamespaceAccessible`
-
-This is a Decimal property.
-
-### `MyProp` → `String`
-
-`NamespaceAccessible`
-
-This is a String property.
-
----
-## Methods
-### `call()` → `void`
-
-`NamespaceAccessible`
-
-Calls the method. This methods allows you to call it.
-
-### `testMethod(String argument)` → `String`
-
-`NamespaceAccessible`
-
-Executes commands based on the passed in argument.
-
-#### Example
-```
-<pre>
-String result = SampleClass2.testMethod();
-System.debug(result);
-```
-
----
-## Inner Classes
-
-### SampleClass2.AnotherInnerClass class
-
-Inner class belonging to SampleClass2.
-
----
-#### Properties
-
-##### `InnerProp` → `public`
-
-Description of the inner property.
-
----
-#### Methods
-##### `innerMethod()` → `void`
-
-Executes from the inner class.
-
----
-### SampleClass2.InnerClass class
-
-Inner class belonging to SampleClass2.
-
----
-#### Properties
-
-##### `InnerProp` → `public`
-
-Description of the inner property.
-
----
-#### Methods
-##### `innerMethod()` → `void`
-
-Executes from the inner class.
-
----
+---
+layout: default
+---
+# SampleClass2 class
+
+`NamespaceAccessible`
+
+This is a class description.
+
+## Related
+
+[SampleInterface](../Sample-Interfaces/SampleInterface.md)
+
+
+[SampleClass](../Sample-Classes/SampleClass.md)
+
+---
+## Constructors
+### `SampleClass2()`
+
+`NamespaceAccessible`
+
+Constructs a SampleClass2 without any arguments.
+#### Example
+```
+<pre>
+SampleClass2 sampleInstance = new SampleClass2();
+```
+
+### `SampleClass2(String argument)`
+
+`NamespaceAccessible`
+
+Constructs a SampleClass2 with an argument.
+#### Parameters
+
+| Param | Description |
+| ----- | ----------- |
+|`argument` |  Some argument |
+
+---
+## Properties
+
+### `AnotherProp` → `Decimal`
+
+`NamespaceAccessible`
+
+This is a Decimal property.
+
+### `MyProp` → `String`
+
+`NamespaceAccessible`
+
+This is a String property.
+
+---
+## Methods
+### `call()` → `void`
+
+`NamespaceAccessible`
+
+Calls the method. This methods allows you to call it.
+
+### `testMethod(String argument)` → `String`
+
+`NamespaceAccessible`
+
+Executes commands based on the passed in argument.
+
+#### Example
+```
+<pre>
+String result = SampleClass2.testMethod();
+System.debug(result);
+```
+
+---
+## Inner Classes
+
+### SampleClass2.AnotherInnerClass class
+
+Inner class belonging to SampleClass2.
+
+---
+#### Properties
+
+##### `InnerProp` → `public`
+
+Description of the inner property.
+
+---
+#### Methods
+##### `innerMethod()` → `void`
+
+Executes from the inner class.
+
+---
+### SampleClass2.InnerClass class
+
+Inner class belonging to SampleClass2.
+
+---
+#### Properties
+
+##### `InnerProp` → `public`
+
+Description of the inner property.
+
+---
+#### Methods
+##### `innerMethod()` → `void`
+
+Executes from the inner class.
+
+---

package/docs/Sample-Interfaces/SampleInterface.md

@@ -1,32 +1,32 @@
----
-layout: default
----
-# SampleInterface interface
-
-This is an interface description.
-
-## Related
-
-[SampleClass](../Sample-Classes/SampleClass.md)
-
----
-## Methods
-### `execute()` → `void`
-
-Executes the command.
-
-### `getValue()` → `String`
-
-Returns a value based on the executed command.
-
-#### Return
-
-**Type**
-
-String
-
-**Description**
-
-Empty value
-
----
+---
+layout: default
+---
+# SampleInterface interface
+
+This is an interface description.
+
+## Related
+
+[SampleClass](../Sample-Classes/SampleClass.md)
+
+---
+## Methods
+### `execute()` → `void`
+
+Executes the command.
+
+### `getValue()` → `String`
+
+Returns a value based on the executed command.
+
+#### Return
+
+**Type**
+
+String
+
+**Description**
+
+Empty value
+
+---

package/docs/index.md

@@ -1,27 +1,12 @@
----
-layout: default
----
-# Classes
-## Sample Classes
-
-### [SampleClass](/Sample-Classes/SampleClass.md)
-
-
-This is a class description.
-
-
-
-### [SampleClass2](/Sample-Classes/SampleClass2.md)
-
-
-This is a class description.
-
-
-## Sample Interfaces
-
-### [SampleInterface](/Sample-Interfaces/SampleInterface.md)
-
-
-This is an interface description.
-
-
+---
+layout: default
+---
+# Classes
+## Sample Classes
+
+### [SampleClass](/Sample-Classes/SampleClass.md)
+
+
+This is a class description.
+
+

package/examples/dir1/SampleClass.cls

@@ -0,0 +1,96 @@
+/**
+ * @description This is a class description.
+ * @group Sample Classes
+ * @see SampleInterface
+ * @see SampleClass2
+ */
+@NamespaceAccessible
+public with sharing class SampleClass {
+    /**
+     * @description Constructs a SampleClass without any arguments.
+     * @example
+     * <pre>
+     * SampleClass sampleInstance = new SampleClass();
+     */
+    @NamespaceAccessible
+    public SampleClass() {
+        System.debug('Constructor');
+    }
+
+    /**
+     * @description Constructs a SampleClass with an argument.
+     * @param argument Some argument
+     */
+    public SampleClass(String argument) {
+        System.debug('Constructor');
+    }
+
+    /**
+     * @description Executes commands based on the passed in argument.
+     * @example
+     * <pre>
+     * String result = SampleClass.testMethod();
+     * System.debug(result);
+     */
+    @NamespaceAccessible
+    public static String testMethod(String argument) {
+        System.debug('Execute');
+        return '';
+    }
+
+
+    /**
+     * @description Calls the method.
+     * This methods allows you to call it.
+     */
+    public static void call() {
+    }
+
+    /**
+     * @description This is a String property.
+     */
+    public String MyProp { get; set; }
+
+    /**
+     * @description This is a Decimal property.
+     */
+    public Decimal AnotherProp { get; private set; }
+
+    /**
+     * @description Inner class belonging to SampleClass.
+     */
+    public class InnerClass {
+        /**
+         * @description Description of the inner property.
+         */
+        public InnerProp {
+            get; set;
+        }
+
+        /**
+         * @description Executes from the inner class.
+         */
+        public void innerMethod() {
+            System.debug('Executing inner method.');
+        }
+    }
+
+    /**
+     * @description Inner class belonging to SampleClass.
+     */
+    public class AnotherInnerClass {
+        /**
+         * @description Description of the inner property.
+         */
+        public InnerProp {
+            get; set;
+        }
+
+        /**
+         * @description Executes from the inner class.
+         */
+        public void innerMethod() {
+            System.debug('Executing inner method.');
+        }
+    }
+}

package/examples/dir2/SampleInterface.cls

@@ -0,0 +1,17 @@
+/**
+ * @description This is an interface description.
+ * @group Sample Interfaces
+ * @see SampleClass
+ */
+public interface SampleInterface {
+    /**
+     * @description Executes the command.
+     */
+    void execute();
+
+    /**
+     * @description Returns a value based on the executed command.
+     * @return Empty value
+     */
+    String getValue();
+}

package/lib/Command/Generate.d.ts

@@ -1,2 +1,2 @@
 import ClassModel from '../Model/ClassModel';
-export declare function generate(sourceDirectory: string, recursive?: boolean, scope?: string[], outputDir?: string, targetGenerator?: string, configPath?: string, group?: boolean): ClassModel[];
+export declare function generate(sourceDirectories: (string | number)[], recursive?: boolean, scope?: string[], outputDir?: string, targetGenerator?: string, configPath?: string, group?: boolean): ClassModel[];

package/lib/Command/Generate.js

@@ -7,7 +7,7 @@ const FileParser_1 = require("../Parser/FileParser");
 const DocsifyDocsProcessor_1 = require("../DocsifyDocsProcessor");
 const JekyllDocsProcessor_1 = require("../JekyllDocsProcessor");
 const AsJsDocsProcessor_1 = require("../AsJsDocsProcessor");
-function generate(sourceDirectory, recursive = true, scope = ['global', 'public', 'namespaceaccessible'], outputDir = 'docs', targetGenerator = 'jekyll', configPath, group) {
+function generate(sourceDirectories, recursive = true, scope = ['global', 'public', 'namespaceaccessible'], outputDir = 'docs', targetGenerator = 'jekyll', configPath, group) {
     Settings_1.default.getInstance().setScope(scope);
     Settings_1.default.getInstance().setOutputDir(outputDir);
     if (targetGenerator === 'jekyll') {
@@ -26,29 +26,32 @@ function generate(sourceDirectory, recursive = true, scope = ['global', 'public'
         Settings_1.default.getInstance().setConfigPath(configPath);
     }
     // TODO: Assert data validation to avoid exposing 'fs' and 'path' errors to callers.
-    const classes = getClassesFromDirectory(sourceDirectory, recursive);
+    const classes = getClassesFromDirectory(sourceDirectories, recursive);
     // tslint:disable-next-line:no-console
     console.log(`Processed ${classes.length} files`);
     return classes;
 }
 exports.generate = generate;
-function getClassesFromDirectory(sourceDirectory, recursive) {
+function getClassesFromDirectory(sourceDirectories, recursive) {
     let classes = [];
-    const directoryContents = fs.readdirSync(sourceDirectory);
-    directoryContents.forEach(currentFile => {
-        const currentPath = path.join(sourceDirectory, currentFile);
-        if (recursive && fs.statSync(currentPath).isDirectory()) {
-            classes = classes.concat(getClassesFromDirectory(currentPath, recursive));
-        }
-        if (!currentFile.endsWith('.cls')) {
-            return;
-        }
-        const rawFile = fs.readFileSync(currentPath);
-        const response = new FileParser_1.default().parseFileContents(rawFile.toString());
-        if (!response) {
-            return;
-        }
-        classes.push(response);
-    });
+    for (const currentDirectory of sourceDirectories) {
+        const sourceDirectory = currentDirectory;
+        const directoryContents = fs.readdirSync(sourceDirectory);
+        directoryContents.forEach(currentFile => {
+            const currentPath = path.join(sourceDirectory, currentFile);
+            if (recursive && fs.statSync(currentPath).isDirectory()) {
+                classes = classes.concat(getClassesFromDirectory([currentPath], recursive));
+            }
+            if (!currentFile.endsWith('.cls')) {
+                return;
+            }
+            const rawFile = fs.readFileSync(currentPath);
+            const response = new FileParser_1.default().parseFileContents(rawFile.toString());
+            if (!response) {
+                return;
+            }
+            classes.push(response);
+        });
+    }
     return classes;
 }

package/lib/Command/__test__/Generte.test.js

@@ -10,18 +10,18 @@ beforeEach(() => {
 });
 it('returns an empty list when there are no files', () => {
     fs.readdirSync.mockReturnValue([]);
-    const classes = Generate_1.generate('src');
+    const classes = Generate_1.generate(['src']);
     expect(classes.length).toBe(0);
 });
 it('returns an empty list when there are no files ending in .cls', () => {
     fs.readdirSync.mockReturnValue(['file.xml', 'README.md']);
-    const classes = Generate_1.generate('src', false);
+    const classes = Generate_1.generate(['src'], false);
     expect(classes.length).toBe(0);
 });
 it('returns parsed files when there are .cls files', () => {
     fs.readdirSync.mockReturnValue(['TestClass.cls', 'README.md']);
     fs.readFileSync.mockReturnValue('Raw class data');
-    Generate_1.generate('src', false);
+    Generate_1.generate(['src'], false);
     expect(FileParser_1.default).toHaveBeenCalledTimes(1);
     const mockFileParserInstance = FileParser_1.default.mock.instances[0];
     const mockParseFileContents = mockFileParserInstance.parseFileContents;

package/lib/cli/generate.js

@@ -6,10 +6,10 @@ const Generate_1 = require("../Command/Generate");
 const FileManager_1 = require("../FileManager");
 const argv = yargs.options({
     sourceDir: {
-        type: 'string',
+        type: 'array',
         alias: 's',
         demandOption: true,
-        describe: 'The directory location which contains your apex .cls classes.',
+        describe: 'The directory or directories location(s) which contains your apex .cls classes.',
     },
     targetDir: {
         type: 'string',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cparra/apexdocs",
-  "version": "1.13.8",
+  "version": "1.14.0",
   "description": "Library with CLI capabilities to generate documentation for Salesforce Apex classes.",
   "keywords": [
     "apex",
@@ -23,7 +23,8 @@
     "prepare": "npm run build",
     "version": "npm run format && git add -A src",
     "postversion": "git push && git push --tags",
-    "generage:sample": "node lib/cli/generate.js -s examples -t docs"
+    "generage:sample": "node lib/cli/generate.js -s examples -t docs",
+    "generage:sample:multiple:directories": "node lib/cli/generate.js -s examples/dir1 examples/dir2 -t docs"
   },
   "author": "Cesar Parra",
   "license": "MIT",

package/src/Command/Generate.ts

@@ -10,7 +10,7 @@ import JekyllDocsProcessor from '../JekyllDocsProcessor';
 import AsJsDocsProcessor from '../AsJsDocsProcessor';
 
 export function generate(
-  sourceDirectory: string,
+  sourceDirectories: (string | number)[],
   recursive: boolean = true,
   scope: string[] = ['global', 'public', 'namespaceaccessible'],
   outputDir: string = 'docs',
@@ -38,32 +38,36 @@ export function generate(
   }
 
   // TODO: Assert data validation to avoid exposing 'fs' and 'path' errors to callers.
-  const classes: ClassModel[] = getClassesFromDirectory(sourceDirectory, recursive);
+  const classes: ClassModel[] = getClassesFromDirectory(sourceDirectories, recursive);
   // tslint:disable-next-line:no-console
   console.log(`Processed ${classes.length} files`);
   return classes;
 }
 
-function getClassesFromDirectory(sourceDirectory: string, recursive: boolean) {
+function getClassesFromDirectory(sourceDirectories: (string | number)[], recursive: boolean) {
   let classes: ClassModel[] = [];
 
-  const directoryContents = fs.readdirSync(sourceDirectory);
-  directoryContents.forEach(currentFile => {
-    const currentPath = path.join(sourceDirectory, currentFile);
-    if (recursive && fs.statSync(currentPath).isDirectory()) {
-      classes = classes.concat(getClassesFromDirectory(currentPath, recursive));
-    }
+  for (const currentDirectory of sourceDirectories) {
+    const sourceDirectory = currentDirectory as string;
+    const directoryContents = fs.readdirSync(sourceDirectory);
+    directoryContents.forEach(currentFile => {
+      const currentPath = path.join(sourceDirectory, currentFile);
+      if (recursive && fs.statSync(currentPath).isDirectory()) {
+        classes = classes.concat(getClassesFromDirectory([currentPath], recursive));
+      }
 
-    if (!currentFile.endsWith('.cls')) {
-      return;
-    }
+      if (!currentFile.endsWith('.cls')) {
+        return;
+      }
+
+      const rawFile = fs.readFileSync(currentPath);
+      const response = new FileParser().parseFileContents(rawFile.toString());
+      if (!response) {
+        return;
+      }
+      classes.push(response);
+    });
+  }
 
-    const rawFile = fs.readFileSync(currentPath);
-    const response = new FileParser().parseFileContents(rawFile.toString());
-    if (!response) {
-      return;
-    }
-    classes.push(response);
-  });
   return classes;
 }

package/src/Command/__test__/Generte.test.ts

@@ -12,7 +12,7 @@ beforeEach(() => {
 it('returns an empty list when there are no files', () => {
   (fs.readdirSync as jest.Mock).mockReturnValue([]);
 
-  const classes = generate('src');
+  const classes = generate(['src']);
 
   expect(classes.length).toBe(0);
 });
@@ -20,7 +20,7 @@ it('returns an empty list when there are no files', () => {
 it('returns an empty list when there are no files ending in .cls', () => {
   (fs.readdirSync as jest.Mock).mockReturnValue(['file.xml', 'README.md']);
 
-  const classes = generate('src', false);
+  const classes = generate(['src'], false);
 
   expect(classes.length).toBe(0);
 });
@@ -29,7 +29,7 @@ it('returns parsed files when there are .cls files', () => {
   (fs.readdirSync as jest.Mock).mockReturnValue(['TestClass.cls', 'README.md']);
   (fs.readFileSync as jest.Mock).mockReturnValue('Raw class data');
 
-  generate('src', false);
+  generate(['src'], false);
 
   expect(FileParser).toHaveBeenCalledTimes(1);
   const mockFileParserInstance = (FileParser as jest.Mock).mock.instances[0];

package/src/cli/generate.ts

@@ -6,10 +6,10 @@ import FileManager from '../FileManager';
 
 const argv = yargs.options({
   sourceDir: {
-    type: 'string',
+    type: 'array',
     alias: 's',
     demandOption: true,
-    describe: 'The directory location which contains your apex .cls classes.',
+    describe: 'The directory or directories location(s) which contains your apex .cls classes.',
   },
   targetDir: {
     type: 'string',