fix rendering and document generation

4 years ago · df5bb7d681
parent 6f95e66c0d
commit df5bb7d681
3 changed files with 123 additions and 47 deletions
--- a/src/utils/template.ts
+++ b/src/utils/template.ts
@ -7,22 +7,24 @@ import {
 } from "./types";
 type HTMLContent = string;

-export const htmlTemplate = (content: HTMLContent) => `
-    <!DOCTYPE html>
-    <html lang="en">
-    <head>
-    <meta charset="utf-8" />
-    <meta
-        name="description"
-        content="Web site created with EthDoc"
-    />
-    <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css" integrity="sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh" crossorigin="anonymous">
-    </head>
-    <body>
-        ${content}
-    </body>
-    </html>
-`;
+export const htmlTemplate = (content: HTMLContent) => {
+  return `
+  <!DOCTYPE html>
+  <html lang="en">
+  <head>
+  <meta charset="utf-8" />
+  <meta
+      name="description"
+      content="Web site created with EthDoc"
+  />
+  <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css" integrity="sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh" crossorigin="anonymous">
+  </head>
+  <body>
+      ${content}
+  </body>
+  </html>
+`
+};

 export const template = (
  name: string,
@ -69,7 +71,6 @@ export const template = (
            <p>Returns:</p>
           
            ${renderParameterDocumentation(item.outputs)}
-
            `
    )
    .join("\n")}
@ -77,22 +78,11 @@ export const template = (
    </div>
 `;

-// const contractDocTemplate: TemplateDoc<ContractDoc> = {
-//     author: (author: string) => '',//`Author: ${author}`,
-//     details: (details: string) => `<p class="lead text-muted">${details}</p>`,
-//     title: (title: string) => {
-//         return title ?
-//             `<small>${title}</small>`
-//             : ''
-//     },
-//     notice: (notice: string) => `<p class="lead text-muted">${notice}</p>`,
-//     methods: () => '' // Methods is managed by getMethod()
-// }
 const devMethodDocTemplate: Partial<TemplateDoc<MethodDoc>> = {
  author: (author: string) => `<p>Created By ${author}</p>`,
  details: (details: string) => `<p>${details}</p>`,
  return: (value: string) => `<p>Return : ${value}</p>`,
-  notice: (notice: string) => `<p>${notice}</p>`,
+  notice: (notice: string) => notice ? `<p>${notice}</p>` : '',
  // returns: () => '', // Implemented by getParams()
  params: () => "", // Implemented by getParams()
 };
@ -114,11 +104,9 @@ export const renderHeader = (

 export const renderParameterDocumentation = (
  parameters: ParameterDocumentation[]
-) => `
-        ${
+) => `${
  parameters.length > 0
-    ? `
-            <table class="table table-sm table-bordered table-striped">
+    ? `<table class="table table-sm table-bordered table-striped">
                <thead>
                    <tr>
                        <th>Name</th>
@ -127,18 +115,17 @@ export const renderParameterDocumentation = (
                    </tr>
                </thead>
                <tbody>
-                    ${parameters.map(
+    ${parameters.map(
      (output) => `<tr>
-                                <td>${output.name}</td>
-                                <td>${output.type}</td>
-                                <td>${output.description}</td>
-                                </tr>`
-    )}
-                </tbody>
-            </table>`
+        <td>${output.name}</td>
+        <td>${output.type}</td>
+        <td>${output.description}</td>
+        </tr>`
+    ).join("")}
+              </tbody>
+      </table>`
    : "<p>No parameters</p>"
-  }
-`;
+  }`;

 export const getMethodDetails = (devMethod?: Partial<MethodDoc>) => {
  return !devMethod
--- a/src/utils/utils.test.ts
+++ b/src/utils/utils.test.ts
@ -45,10 +45,95 @@ describe("Publisher tests", () => {
        buildFakeArtifactWithComments()
      );

-      console.log("Template", template);
-
      expect(template).toBeDefined();
    });
+
+    test('getContractDoc', () => {
+      const template = getContractDoc(
+        'Owner',
+        {
+          ...buildFakeArtifactWithComments(),
+          abi: [
+            {
+              "inputs": [],
+              "stateMutability": "nonpayable",
+              "type": "constructor"
+            },
+            {
+              "anonymous": false,
+              "inputs": [
+                {
+                  "indexed": true,
+                  "internalType": "address",
+                  "name": "oldOwner",
+                  "type": "address"
+                },
+                {
+                  "indexed": true,
+                  "internalType": "address",
+                  "name": "newOwner",
+                  "type": "address"
+                }
+              ],
+              "name": "OwnerSet",
+              "type": "event"
+            },
+            {
+              "inputs": [
+                {
+                  "internalType": "address",
+                  "name": "newOwner",
+                  "type": "address"
+                }
+              ],
+              "name": "changeOwner",
+              "outputs": [],
+              "stateMutability": "nonpayable",
+              "type": "function"
+            },
+            {
+              "inputs": [],
+              "name": "getOwner",
+              "outputs": [
+                {
+                  "internalType": "address",
+                  "name": "",
+                  "type": "address"
+                }
+              ],
+              "stateMutability": "view",
+              "type": "function"
+            }
+          ] as any,
+          devdoc: {
+            "details": "Set & change owner",
+            "methods": {
+              "changeOwner(address)": {
+                "details": "Change owner",
+                "params": {
+                  "newOwner": "address of new owner"
+                }
+              },
+              "constructor": {
+                "details": "Set contract deployer as owner"
+              },
+              "getOwner()": {
+                "details": "Return owner address ",
+                "returns": {
+                  "_0": "address of owner"
+                }
+              }
+            },
+            "title": "Owner"
+          } as any,
+          userdoc: {
+            "methods": {}
+          } as any
+        }
+      )
+
+      expect(template).toBeDefined();
+    })
  });

  describe("getFunctionDocumentation", () => {
--- a/src/utils/utils.ts
+++ b/src/utils/utils.ts
@ -41,13 +41,17 @@ export const createDocumentation = (
 export const getContractDoc = (name: string, contract: CompiledContract) => {
  const contractDoc: ContractDocumentation = getContractDocumentation(contract);

-  const functionsDocumentation = contract.abi.map((def: ABIDescription) => {
+  const onlyFunctions = contract.abi.filter((item) => {
+    return item.type !== "event"
+  })
+
+  const functionsDocumentation = onlyFunctions.map((def: ABIDescription) => {
    if (def.type === "constructor") {
      def.name = "constructor";
      // because "constructor" is a string and not a { notice } object for userdoc we need to do that
      const methodDoc = {
        ...(contract.devdoc.methods.constructor || {}),
-        notice: contract.userdoc.methods.constructor as string,
+        notice: Object.keys(contract.userdoc.methods['constructor']).length > 0 ? contract.userdoc.methods['constructor'] as string : "",
      };
      return getFunctionDocumentation(def, methodDoc);
    } else {