javacore-analyser 2.0rc1__tar.gz → 2.1.0.dev66__tar.gz

javacore_analyser-2.1.0.dev66/.travis.yml

@@ -0,0 +1,28 @@
+language: python
+python:
+ - "3.9"
+before_install:
+ - pip install 'urllib3<2.0' #Enforce SSL version to be able to run twine
+ - pip install -U pytest
+ - pip install -U build
+ - pip install -U twine
+ - pip install codecov
+install:
+ - pip install -r requirements.txt
+ - pip install .
+env:
+ global:
+  - PYTHONPATH=src:test
+script:
+ - pytest
+ - python -m build
+after_success:
+ - codecov
+deploy:
+  provider: script
+  #script: python -m twine upload --skip-existing --verbose --password $TWINE_TEST_TOKEN --repository testpypi dist/* #test instance
+  script: python -m twine upload --skip-existing --verbose --password $TWINE_PROD_TOKEN dist/* #production instance.
+  on:
+   all_branches: true # uncomment for testing purposes
+   # branch: prod # uncomment on production
+   # tags: true # uncomment on production

{javacore_analyser-2.0rc1 → javacore_analyser-2.1.0.dev66}/CONTRIBUTING.md

@@ -85,9 +85,9 @@ Change the second parameter to the directory where you want the output report be
 
 To run web application:
 1. Right click on **javacore_analyser_web.py** directory in **Project** view and select **Modify Run Configuration...**.
-2. Add the following **Environmental variables:**
-   * **DEBUG:True**
-   * **REPORTS_DIR:/tmp/web_reports**  
+2. Add the following parameters:  
+   **debug=True reports_dir=/tmp/web_reports**  
+
    You can change the report dir to the location when you want to store the report. 
    The application will start on http://localhost:5000
 
@@ -96,6 +96,25 @@ To run web application:
 Follow the steps from [Packaging projects](https://packaging.python.org/en/latest/tutorials/packaging-projects/).
 Currently Chris has an API keys for test and production pypi
 
+## Build container localy  
+To build a container:  
+`podman build -t javacore-analyser .`
+
+or 
+
+`docker build -t javacore-analyser .`
+
+To start the container:  
+`podman run -it --rm --name javacore-analyser --mount type=bind,src="local-dir-on-fs",target=/reports -p 5001:5000 javacore-analyser`  
+
+or
+
+`docker run -it --rm --name javacore-analyser --mount type=bind,src="local-dir-on-fs",target=/reports -p 5001:5000 javacore-analyser`
+
+`src` parameter specifies where you want to store reports locally  
+`-p` specifies port mapping. The application in container is running on port 5000. You can map it to another port on 
+your machine (5001 in this example).
+
 ## Testing
 As default the tests in Pycharm are ran in the current selected directory. However we want to run them in main 
 directory of the tool (**javacore-analyser** directory, not **test** directory). 

javacore_analyser-2.1.0.dev66/Dockerfile

@@ -0,0 +1,15 @@
+#
+# Copyright IBM Corp. 2024 - 2024
+# SPDX-License-Identifier: Apache-2.0
+#
+
+FROM python:3
+
+EXPOSE 5000/tcp
+ENV REPORTS_DIR=/reports
+RUN mkdir /reports
+VOLUME ["/reports"]
+
+RUN pip install --no-cache-dir javacore-analyser
+
+CMD [ "javacore_analyser_web" ]

{javacore_analyser-2.0rc1 → javacore_analyser-2.1.0.dev66}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: javacore_analyser
-Version: 2.0rc1
+Version: 2.1.0.dev66
 Summary: The tool to review IBM Javacore files
 Project-URL: Homepage, https://github.com/IBM/javacore-analyser
 Project-URL: Issues, https://github.com/IBM/javacore-analyser/issues
@@ -209,6 +209,7 @@ License:                                  Apache License
            See the License for the specific language governing permissions and
            limitations under the License.
         
+License-File: LICENSE
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Environment :: Web Environment
@@ -226,12 +227,12 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.9
-Requires-Dist: dicttoxml
 Requires-Dist: flask
 Requires-Dist: importlib-resources
 Requires-Dist: lxml
 Requires-Dist: py7zr
 Requires-Dist: pyana
+Requires-Dist: tqdm
 Requires-Dist: waitress
 Description-Content-Type: text/markdown
 
@@ -280,9 +281,7 @@ This is recommended for geeks only:
 #### Running cmd application: 
 1. Install application if not done yet
 2. Activate your created virtual environment according to activate Virtual Environment according to [Creating virtual environments](https://docs.python.org/3/tutorial/venv.html#creating-virtual-environments)
-3. Install the requirements using pip: 
- `pip install requirements.txt` 
-4. Run the following command from cmd: `javacore-analyser-batch <input-data> <generated-reports-dir>`
+3. Run the following command from cmd: `javacore-analyser-batch <input-data> <generated-reports-dir>`
 Where `<input-data>` is one of the following:
 * The directory containing javacores and optionally verbose gc
 * Archive (7z, zip, tar.gz, tar.bz2) containing the same
@@ -292,17 +291,28 @@ You can type the following command to obtain the help:
 
 #### Running web application:
 1. Repeat steps 1-3 from cmd application
-2. OPTIONAL: set the following variables:
-  ```
-  export REPORTS_DIR=/tmp/reports  
-  export PORT=5000
-  ``` 
- The first parameter sets where the reports need to be stored. If not set, then the `reports` dir will be created in current location.  
- The first parameter set the port to use by application. If not specified, 5000 will be used.  
-3. Execute the following command from cmd:  
-  `javacore_analyser_web`
+2. Execute the following command from cmd:  
+  `javacore_analyser_web --port=500 --reports-dir=/data/reports_dir`
+
+     The first parameter set the port to use by application. If not specified, 5000 will be used.  
+     The second parameter sets where the reports need to be stored. If not set, then the `reports` dir will be created in current location.  
 
   Now you can type (http://localhost:5000/).  
+
+### Running container image
+There is an unofficial Docker/Podman container managed by one of projects developers. Use the following command 
+to start it:
+
+`podman run -it --rm --name javacore-analyser --mount type=bind,src="/local-reports-dir",target=/reports -p 5001:5000 ghcr.io/kkazmierczyk/javacore-analyser:latest`
+
+or  
+`docker run -it --rm --name javacore-analyser --mount type=bind,src="/local-reports-dir",target=/reports -p 5001:5000 ghcr.io/kkazmierczyk/javacore-analyser:latest`  
+
+The `mount` option specifies where you want locally to store the reports. The reports in the container are stored in 
+`/reports` directory. If you remove mount option, the application will work but the reports will not persist after 
+restart.  
+The application is running in the container on port 5000. By using `-p 5001:5000` option, you specify to map container 
+port 5000 to port 5001 on your machine. Therefore the application will be available under `http://localhost:5001/`.
  
 <!-- The following are OPTIONAL, but strongly suggested to have in your repository. -->
 <!--

{javacore_analyser-2.0rc1 → javacore_analyser-2.1.0.dev66}/README.md

@@ -43,9 +43,7 @@ This is recommended for geeks only:
 #### Running cmd application: 
 1. Install application if not done yet
 2. Activate your created virtual environment according to activate Virtual Environment according to [Creating virtual environments](https://docs.python.org/3/tutorial/venv.html#creating-virtual-environments)
-3. Install the requirements using pip: 
- `pip install requirements.txt` 
-4. Run the following command from cmd: `javacore-analyser-batch <input-data> <generated-reports-dir>`
+3. Run the following command from cmd: `javacore-analyser-batch <input-data> <generated-reports-dir>`
 Where `<input-data>` is one of the following:
 * The directory containing javacores and optionally verbose gc
 * Archive (7z, zip, tar.gz, tar.bz2) containing the same
@@ -55,17 +53,28 @@ You can type the following command to obtain the help:
 
 #### Running web application:
 1. Repeat steps 1-3 from cmd application
-2. OPTIONAL: set the following variables:
-  ```
-  export REPORTS_DIR=/tmp/reports  
-  export PORT=5000
-  ``` 
- The first parameter sets where the reports need to be stored. If not set, then the `reports` dir will be created in current location.  
- The first parameter set the port to use by application. If not specified, 5000 will be used.  
-3. Execute the following command from cmd:  
-  `javacore_analyser_web`
+2. Execute the following command from cmd:  
+  `javacore_analyser_web --port=500 --reports-dir=/data/reports_dir`
+
+     The first parameter set the port to use by application. If not specified, 5000 will be used.  
+     The second parameter sets where the reports need to be stored. If not set, then the `reports` dir will be created in current location.  
 
   Now you can type (http://localhost:5000/).  
+
+### Running container image
+There is an unofficial Docker/Podman container managed by one of projects developers. Use the following command 
+to start it:
+
+`podman run -it --rm --name javacore-analyser --mount type=bind,src="/local-reports-dir",target=/reports -p 5001:5000 ghcr.io/kkazmierczyk/javacore-analyser:latest`
+
+or  
+`docker run -it --rm --name javacore-analyser --mount type=bind,src="/local-reports-dir",target=/reports -p 5001:5000 ghcr.io/kkazmierczyk/javacore-analyser:latest`  
+
+The `mount` option specifies where you want locally to store the reports. The reports in the container are stored in 
+`/reports` directory. If you remove mount option, the application will work but the reports will not persist after 
+restart.  
+The application is running in the container on port 5000. By using `-p 5001:5000` option, you specify to map container 
+port 5000 to port 5001 on your machine. Therefore the application will be available under `http://localhost:5001/`.
  
 <!-- The following are OPTIONAL, but strongly suggested to have in your repository. -->
 <!--

{javacore_analyser-2.0rc1 → javacore_analyser-2.1.0.dev66}/pyproject.toml

@@ -8,9 +8,9 @@ requires = ["hatchling", "versioningit"]
 build-backend = "hatchling.build"
 
 [project]
-#dynamic = ["version"]
+dynamic = ["version"]
 name = "javacore_analyser"
-version = "2.0rc1"
+#version = "2.0rc1"
 authors = [
     { name="Krzysztof Kazmierczyk", email="kazm@ibm.com" },
     { name="Piotr Aniola", email="Piotr.Aniola@ibm.com" },
@@ -40,13 +40,13 @@ classifiers = [
     "Natural Language :: English",
 ]
 dependencies = [
-    "dicttoxml",
     "py7zr",
     "lxml",
     "pyana",
     "importlib-resources",
     "flask",
-    "waitress"
+    "waitress",
+    "tqdm"
 ]
 
 [project.scripts]

{javacore_analyser-2.0rc1 → javacore_analyser-2.1.0.dev66}/requirements.txt

@@ -1,7 +1,7 @@
-dicttoxml
 py7zr
 lxml
 pyana
 importlib-resources
 waitress # Production WSGI server
-flask # WSGI server for development the code
+flask # WSGI server for development the code
+tqdm

{javacore_analyser-2.0rc1 → javacore_analyser-2.1.0.dev66}/src/javacore_analyser/abstract_snapshot_collection.py

@@ -59,7 +59,7 @@ class AbstractSnapshotCollection(abc.ABC):
         self.thread_snapshots.append(snapshot)
 
     def index_of(self, snapshot):
-        for i in range(len(self.thread_snapshotssnaps)):
+        for i in range(len(self.thread_snapshots)):
             if self.thread_snapshots[i] == snapshot: return i
         return -1
 
@@ -142,7 +142,7 @@ class AbstractSnapshotCollection(abc.ABC):
         result = 0
         for i in self.thread_snapshots:
             el = i.get_java_stack_depth()
-            if el>result:
+            if el > result:
                 result = el
         return result
 

{javacore_analyser-2.0rc1 → javacore_analyser-2.1.0.dev66}/src/javacore_analyser/constants.py

@@ -30,10 +30,11 @@ ENCODING = '1TICHARSET'
 DATA_OUTPUT_SUBDIR = '/data/'
 DEFAULT_FILE_DELIMITER = ';'
 
-MIN_JAVACORE_SIZE = 5 * 1024 # Minimal Javacore size in bytes
+MIN_JAVACORE_SIZE = 5 * 1024  # Minimal Javacore size in bytes
 
 DATE_FORMAT = "%Y-%m-%d %H:%M:%S"
 
 # Web application constants
 DEFAULT_REPORTS_DIR = "reports"
 DEFAULT_PORT = 5000
+TEMP_DIR = "temp_data"  # Folder to store temporary data for creating reports

{javacore_analyser-2.0rc1 → javacore_analyser-2.1.0.dev66}/src/javacore_analyser/data/expand.js

@@ -15,6 +15,8 @@ $('.show').click(function () {
     }
 });
 
+
+
 function expand_it(whichEl, link) {
     whichEl.style.display = (whichEl.style.display == "none") ? "" : "none";
     //if (link) {

javacore_analyser-2.1.0.dev66/src/javacore_analyser/data/html/processing_data.html

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+
+<!--
+# Copyright IBM Corp. 2024 - 2024
+# SPDX-License-Identifier: Apache-2.0
+-->
+
+<html lang="en">
+<head>
+    <meta http-equiv="refresh" content="30" /> <!-- Refresh this page every 30s until generated page appears -->
+    <meta charset="UTF-8">
+    <title>The page is being generated</title>
+</head>
+<body>
+    <h1>The page is being generated. Once it is ready, it will appear here.</h1>
+</body>
+</html>

{javacore_analyser-2.0rc1 → javacore_analyser-2.1.0.dev66}/src/javacore_analyser/data/jquery/search.js

@@ -49,10 +49,32 @@ $(function() {
     searchInNode(rootNode, searchTerm);
   }
 
+    function processChild(child) {
+        try {
+            if (isDomNode(child) && child.classList.contains('toggle_expand')) {
+                for (i = 0; i < child.childNodes.length; ++i) {
+                    grandchild = child.childNodes[i];
+                    if (isDomNode(grandchild) && grandchild.text == '[+] Expand') {
+                        grandchild.text = '[-] Collapse';
+                    }
+                }
+            }
+        } catch(err) {
+            console.log(err);
+        }
+    }
+
     function searchInNode(node, searchTerm) {
         if (!isDomNode(node)) return;
         if (node.textContent.toUpperCase().match(searchTerm.toUpperCase())) {
             // expand the node here
+            if (!node.classList.contains('show-all')) {
+                node.classList.add('show-all');
+                for (i = 0; i < node.childNodes.length; ++i) {
+                    child = node.childNodes[i];
+                    processChild(child);
+                }
+            }
             if (node.getAttribute('style') && node.style.display == "none") {
                 node.style.display = "";
             }

{javacore_analyser-2.0rc1 → javacore_analyser-2.1.0.dev66}/src/javacore_analyser/data/jquery/wait2scripts.js

@@ -145,12 +145,34 @@ const loadChartGC = function() {
   });
 
   // 3. find the HEAP_SIZE
-  const MB_SIZE = Math.pow(1024, 2)
+  const MB_SIZE = Math.pow(1024, 2);
+  let heapAsString = document.getElementById('sys_info_table').rows[2].cells[1].innerHTML;
   let HEAP_SIZE;
-  if(document.getElementById('sys_info_table').rows[2].cells[1].innerHTML.slice(-1).toLowerCase() === 'g')
-    HEAP_SIZE = Number(document.getElementById('sys_info_table').rows[2].cells[1].innerHTML.slice(0, -1)) * MB_SIZE * 1024;
-  else
-    HEAP_SIZE = Number(document.getElementById('sys_info_table').rows[2].cells[1].innerHTML.slice(0, -1)) * MB_SIZE;
+  let heapUnit = heapAsString.slice(-1).toLowerCase();
+
+  if(!isNaN(Number(heapUnit))) {
+     HEAP_SIZE = Number(heapAsString);
+  }
+  else {
+
+      switch (heapUnit) {
+        case "g":
+            HEAP_SIZE =
+                Number(heapAsString.slice(0, -1)) * MB_SIZE * 1024;
+        break;
+        case "m":
+            HEAP_SIZE =
+                Number(heapAsString.slice(0, -1)) * MB_SIZE;
+        break;
+        case "k":
+            HEAP_SIZE =
+                Number(heapAsString.slice(0, -1)) * 1024;
+        break;
+        default:
+            console.log("Hmm, what now .. heap unit undefined!");
+        break;
+      }
+  }
 
   // 4. create input data for GC chart
   //        start with gc collection done after the first javacore creation

javacore_analyser-2.1.0.dev66/src/javacore_analyser/data/xml/javacores/javacore.xsl

@@ -0,0 +1,174 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+# Copyright IBM Corp. 2024 - 2024
+# SPDX-License-Identifier: Apache-2.0
+-->
+
+<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+    <xsl:template match="text()"/> <!-- these are not the nodes you're looking for -->
+    <xsl:template match="/">
+        <html height="100%">
+            <head>
+                <link rel="stylesheet" href="../data/style.css"/>
+                <link rel="stylesheet" href="../data/jquery/jq.css" />
+                <link rel="stylesheet" href="../data/jquery/theme.blue.css" />
+                <link rel="stylesheet" href="../data/jquery/theme.default.min.css" />
+                <script type="text/javascript" src="../data/jquery/jquery.min.js"> _ </script>
+                <script type="text/javascript" src="../data/jquery/jquery.tablesorter.min.js"> _ </script>
+                <script type="text/javascript" src="../data/jquery/jquery.tablesorter.widgets.min.js"> _ </script>
+                <script type="text/javascript" src="../data/jquery/wait2scripts.js"> _ </script>
+                <script type="text/javascript" src="../data/jquery/sorting.js"> _ </script>
+                <script type="text/javascript" src="../data/expand.js"> _ </script>
+                <script src="../data/jquery/jquery.mark.min.js"> _ </script>
+                <script type="text/javascript" src="../data/jquery/search.js"> _ </script>
+            </head>
+
+            <body id="doc_body" height="100%">
+                <div class="searchbar">
+                    <input id="search-input" type="search" />
+                    <button data-search="search" id="search-button">Search</button>
+                    <button data-search="next">Next</button>
+                    <button data-search="prev">Prev</button>
+                    <button data-search="clear">✖</button>
+                </div>
+                <div class="content">
+                    <p class="right"><a href="../index.html"> Back to Main page </a></p>
+                    <h2>Wait Report for: <b>{id}</b></h2>
+                    <div id="all_threads">
+                        <table id="javacore_threads_table" class="tablesorter_blue">
+                            <thead>
+                                <tr>
+                                    <th class="sixty">Thread name</th>
+                                    <th>Total CPU usage (s)</th>
+                                    <th>% CPU usage</th>
+                                    <th>Memory allocated since last GC (MB)</th>
+                                    <th>Java stack depth</th>
+                                    <th>Status</th>
+                                </tr>
+                            </thead>
+                            <tbody>
+                                <xsl:for-each select="//Thread/all_snapshot_collection/snapshot_collection/stack[file_name='{id}']">
+                                    <xsl:variable name="i" select="position()" />
+                                    <tr>
+                                        <td class="left">
+                                            <div>
+                                                <xsl:attribute name="id">
+                                                    <xsl:value-of select="concat('stack',$i)"/>
+                                                </xsl:attribute>
+                                                <a target="_blank">
+                                                    <xsl:attribute name="href">
+                                                        <xsl:value-of select="concat('../threads/thread_', thread_hash, '.html')"/>
+                                                    </xsl:attribute>
+                                                    <xsl:value-of select="thread_name"/>
+                                                </a>
+                                                <xsl:choose>
+                                                    <xsl:when test="stack_depth &gt; 0">
+                                                    <div>
+                                                        <div class="toggle_expand">
+                                                            <a href="javaScript:;" class="show">[+] Expand</a> <!-- "show" class is used in expand.js -->
+                                                        </div>
+                                                        <p class="stacktrace">
+                                                            <xsl:for-each select="*[starts-with(name(), 'line')]">
+                                                                <span>
+                                                                    <xsl:attribute name="class">
+                                                                        <xsl:value-of select="@kind"/>
+                                                                    </xsl:attribute>
+                                                                    <xsl:value-of select="current()"/>
+                                                                </span>
+                                                                <br/>
+                                                            </xsl:for-each>
+                                                        </p>
+                                                    </div>
+                                                    </xsl:when>
+                                                    <xsl:otherwise>
+                                                        No stack
+                                                    </xsl:otherwise>
+                                                </xsl:choose>
+                                            </div>
+                                        </td>
+                                        <td>
+                                            <xsl:choose>
+                                                <xsl:when test="cpu_usage &gt;= 0">
+                                                    <xsl:value-of select='format-number(cpu_usage, "0.00")'/>
+                                                </xsl:when>
+                                                <xsl:otherwise>
+                                                    <div class="warning">[!]
+                                                        <span class="warningtooltip">Error computing CPU usage, javacores may be corrupted</span>
+                                                    </div>
+                                                </xsl:otherwise>
+                                            </xsl:choose>
+                                        </td>
+                                        <td>
+                                            <xsl:choose>
+                                                <xsl:when test="cpu_percentage &gt;= 0">
+                                                    <xsl:value-of select='format-number(cpu_percentage, "0.0")'/>
+                                                </xsl:when>
+                                                <xsl:otherwise>
+                                                    <div class="warning">[!]
+                                                        <span class="warningtooltip">Error computing CPU percentage, javacores may be corrupted</span>
+                                                    </div>
+                                                </xsl:otherwise>
+                                            </xsl:choose>
+                                        </td>
+                                        <td><xsl:value-of select='format-number(allocated_memory div 1024 div 1024, "0.00")'/></td>
+                                        <td><xsl:value-of select='java_stack_depth'/></td>
+                                        <xsl:choose>
+                                        <xsl:when test="state='CW'">
+                                            <td class="waiting">Waiting on condition</td>
+                                        </xsl:when>
+                                        <xsl:when test="state='R'">
+                                            <td class="runnable">Runnable</td>
+                                        </xsl:when>
+                                        <xsl:when test="state='P'">
+                                            <td class="parked">
+                                                <xsl:choose>
+                                                    <xsl:when test="blocked_by=''">
+                                                        Parked
+                                                    </xsl:when>
+                                                    <xsl:otherwise>
+                                                        <a target="_blank">
+                                                            <xsl:attribute name="href">
+                                                                <xsl:value-of select="concat('../threads/thread_', blocked_by/@thread_hash, '.html')"/>
+                                                            </xsl:attribute>
+                                                            <xsl:attribute name="title">
+                                                                <xsl:value-of select="blocked_by/@name" />
+                                                            </xsl:attribute>
+                                                            Parked on <xsl:value-of select="blocked_by/@thread_id"/>
+                                                        </a>
+                                                    </xsl:otherwise>
+                                                </xsl:choose>
+                                            </td>
+                                        </xsl:when>
+                                        <xsl:when test="state='B'">
+                                            <td class="blocked">
+                                                <a target="_blank">
+                                                    <xsl:attribute name="href">
+                                                        <xsl:value-of select="concat('../threads/thread_', blocked_by/@thread_hash, '.html')"/>
+                                                    </xsl:attribute>
+                                                    <xsl:attribute name="title">
+                                                                <xsl:value-of select="blocked_by/@name" />
+                                                    </xsl:attribute>
+                                                    Blocked by <xsl:value-of select="blocked_by/@thread_id"/>
+                                                </a>
+                                            </td>
+                                        </xsl:when>
+                                        <xsl:otherwise>
+                                            <td><xsl:value-of select="state"/></td>
+                                        </xsl:otherwise>
+                                    </xsl:choose>
+                                </tr>
+                            </xsl:for-each>
+                            </tbody>
+                        </table>
+                    </div>
+                </div>
+            </body>
+            <script type="text/javascript" src="../data/expand.js"> _ <!-- underscore character is required to prevent converting to <script /> which does not work --> </script>
+        </html>
+        <xsl:call-template name="expand_it"/>
+    </xsl:template>
+    <xsl:template name="expand_it">
+        <script language="JavaScript"></script>
+    </xsl:template>
+</xsl:stylesheet>

{javacore_analyser-2.0rc1 → javacore_analyser-2.1.0.dev66}/src/javacore_analyser/data/xml/report.xsl

@@ -748,7 +748,7 @@
 
                     <p></p>
                     <div class="margined">
-                        <a href="https://w3.ibm.com/w3publisher/wait2-tool" target="_blank">Documentation</a>
+                        <a href="https://github.com/IBM/javacore-analyser/wiki" target="_blank">Documentation</a>
                     </div>
                     <div class="margined">
                         In case of any issues with the tool use Slack group: