javacore-analyser 2.0rc3__tar.gz → 2.1rc5__tar.gz

javacore_analyser-2.1rc5/.travis.yml

@@ -0,0 +1,33 @@
+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
+install:
+ - pip install -r requirements.txt
+ - pip install .
+env:
+ global:
+  - PYTHONPATH=src:test
+script:
+# - pytest
+ - python -m build
+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 # We need to consider if we want to publish all versions or every build (which should not be an issue
+ - provider: releases
+   edge: true
+   draft: true
+   file: dist/*
+   on:
+    all_branches: true # uncomment for testing purposes
+    # branch: prod # uncomment on production
+    tags: true # We need to consider if we want to publish all versions or every build (which should not be an issue

{javacore_analyser-2.0rc3 → javacore_analyser-2.1rc5}/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.1rc5/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.0rc3 → javacore_analyser-2.1rc5}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: javacore_analyser
-Version: 2.0rc3
+Version: 2.1rc5
 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
@@ -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.0rc3 → javacore_analyser-2.1rc5}/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.0rc3 → javacore_analyser-2.1rc5}/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.0rc3 → javacore_analyser-2.1rc5}/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.0rc3 → javacore_analyser-2.1rc5}/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.1rc5/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.0rc3 → javacore_analyser-2.1rc5}/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.0rc3 → javacore_analyser-2.1rc5}/src/javacore_analyser/javacore.py

@@ -127,7 +127,8 @@ class Javacore:
     def encode(self, string):
         bts = str.encode(string, self.get_encoding(), 'ignore')
         for i in range(0, len(bts)):
-            if bts[i] < 32 and bts[i] != 9 and bts[i] != 10 and bts[i] != 13 and bts[i] != 1:         # fix for 'XML Syntax error PCDATA invalid char#405'
+            # fix for 'XML Syntax error PCDATA invalid char#405'
+            if bts[i] < 32 and bts[i] != 9 and bts[i] != 10 and bts[i] != 13 and bts[i] != 1:
                 raise CorruptedJavacoreException("Javacore " + self.filename + " is corrupted in line " + string)
         string = bts.decode('utf-8', 'ignore')
         return string
@@ -145,7 +146,7 @@ class Javacore:
                     break
                 line = self.encode(line)
                 if line.startswith(THREAD_INFO):
-                    line = self.processThreadName(line, file)
+                    line = Javacore.process_thread_name(line, file)
                     snapshot = ThreadSnapshot.create(line, file, self)
                     self.snapshots.append(snapshot)
         except Exception as e:
@@ -158,7 +159,8 @@ class Javacore:
         finally:
             file.close()
 
-    def processThreadName(self, line, file):
+    @staticmethod
+    def process_thread_name(line, file):
         count = line.count('"')
         if count == 0: return line  # anonymous native threads
         while True:

{javacore_analyser-2.0rc3 → javacore_analyser-2.1rc5}/src/javacore_analyser/javacore_analyser_batch.py

@@ -12,10 +12,11 @@ import shutil
 import sys
 import tarfile
 import tempfile
-import traceback
 import zipfile
 
+import importlib_resources
 import py7zr
+from importlib_resources.abc import Traversable
 
 from javacore_analyser import logging_utils
 from javacore_analyser.constants import DEFAULT_FILE_DELIMITER
@@ -69,15 +70,20 @@ def main():
     logging.info("Preferred encoding: " + locale.getpreferredencoding())
 
     parser = argparse.ArgumentParser()
-    parser.add_argument("input_param", help="Input file(s) or directory")
-    parser.add_argument("output_param", help="Report output directory")
+    parser.add_argument("input", help="Input javacore file(s) or directory with javacores. "
+                                      "The javacores can be packed "
+                                      "into one of the supported archive formats: zip, gz, bz2, lzma, 7z. "
+                                      "Additional the verbose GC logs from the time "
+                                      "when the javacores were collected can be added. "
+                                      "See doc: https://github.com/IBM/javacore-analyser/wiki")
+    parser.add_argument("output", help="Name of directory where report will be generated")
     parser.add_argument("--separator",
                         help='Input files separator (default "' + DEFAULT_FILE_DELIMITER + '")',
                         default=DEFAULT_FILE_DELIMITER)
     args = parser.parse_args()
 
-    input_param = args.input_param
-    output_param = args.output_param
+    input_param = args.input
+    output_param = args.output
     files_separator = args.separator
 
     logging.info("Input parameter: " + input_param)
@@ -89,17 +95,15 @@ def main():
     # Check whether as input we got list of files or single file
     # Semicolon is separation mark for list of input files
     if files_separator in input_param or fnmatch.fnmatch(input_param, '*javacore*.txt'):
-        # Process list of the files (copy all or them to output dir
+        # Process list of the files (copy all or them to output dir)
         files = input_param.split(files_separator)
     else:
         files = [input_param]
-
     try:
         process_javacores_and_generate_report_data(files, output_param)
     except Exception as ex:
-        traceback.print_exc(file=sys.stdout)
-        logging.error("Processing was not successful. Correct the problem and try again. Exiting with error 13",
-                      exc_info=True)
+        logging.exception(ex)
+        logging.error("Processing was not successful. Correct the problem and try again. Exiting with error 13")
         exit(13)
 
 
@@ -115,12 +119,9 @@ def generate_javecore_set_data(files):
     Returns:
     - JavacoreSet: Generated JavacoreSet object containing the processed data.
     """
-
-
+    javacores_temp_dir = tempfile.TemporaryDirectory()
     try:
         # Location when we store extracted archive or copied javacores files
-        javacores_temp_dir = tempfile.TemporaryDirectory()
-
         javacores_temp_dir_name = javacores_temp_dir.name
         for file in files:
             if os.path.isdir(file):
@@ -137,6 +138,24 @@ def generate_javecore_set_data(files):
         javacores_temp_dir.cleanup()
 
 
+def create_output_files_structure(output_dir):
+    if not os.path.isdir(output_dir):
+        os.mkdir(output_dir)
+    data_output_dir = os.path.normpath(os.path.join(output_dir, 'data'))
+    if not data_output_dir.startswith(output_dir):
+        raise Exception("Security exception: Uncontrolled data used in path expression")
+    if os.path.isdir(data_output_dir):
+        shutil.rmtree(data_output_dir, ignore_errors=True)
+    logging.info("Data dir: " + data_output_dir)
+
+    style_css_resource: Traversable = importlib_resources.files("javacore_analyser") / "data" / "style.css"
+    data_dir = os.path.dirname(str(style_css_resource))
+    os.mkdir(data_output_dir)
+    shutil.copytree(data_dir, data_output_dir, dirs_exist_ok=True)
+    shutil.copy2(os.path.join(data_output_dir, "html", "processing_data.html"),
+                 os.path.join(output_dir, "index.html"))
+
+
 # Assisted by WCA@IBM
 # Latest GenAI contribution: ibm/granite-8b-code-instruct
 def process_javacores_and_generate_report_data(input_files, output_dir):
@@ -150,6 +169,7 @@ def process_javacores_and_generate_report_data(input_files, output_dir):
     Returns:
     None
     """
+    create_output_files_structure(output_dir)
     javacore_set = generate_javecore_set_data(input_files)
     javacore_set.generate_report_files(output_dir)
 

{javacore_analyser-2.0rc3 → javacore_analyser-2.1rc5}/src/javacore_analyser/javacore_analyser_web.py

@@ -2,6 +2,7 @@
 # Copyright IBM Corp. 2024 - 2024
 # SPDX-License-Identifier: Apache-2.0
 #
+import argparse
 import locale
 import logging
 import os
@@ -9,6 +10,7 @@ import re
 import shutil
 import sys
 import tempfile
+import threading
 import time
 from pathlib import Path
 
@@ -16,29 +18,30 @@ from flask import Flask, render_template, request, send_from_directory, redirect
 from waitress import serve
 
 import javacore_analyser.javacore_analyser_batch
-from javacore_analyser.constants import DEFAULT_REPORTS_DIR, DEFAULT_PORT
+from javacore_analyser.constants import DEFAULT_REPORTS_DIR, DEFAULT_PORT, TEMP_DIR
 from javacore_analyser.logging_utils import create_console_logging, create_file_logging
 
 """
 To run the application from cmd type:
-export REPORTS_DIR=/tmp/reports
+
 flask --app javacore_analyser_web run
 """
 app = Flask(__name__)
-with app.app_context():
-    create_console_logging()
-    logging.info("Javacore analyser")
-    logging.info("Python version: " + sys.version)
-    logging.info("Preferred encoding: " + locale.getpreferredencoding())
-    reports_dir = os.getenv("REPORTS_DIR", DEFAULT_REPORTS_DIR)
-    logging.info("Reports directory: " + reports_dir)
-    create_file_logging(reports_dir)
+reports_dir = DEFAULT_REPORTS_DIR
+
+
+# Assisted by watsonx Code Assistant
+def create_temp_data_in_reports_dir(directory):
+    tmp_reports_dir = os.path.join(directory, TEMP_DIR)
+    if os.path.isdir(tmp_reports_dir):
+        shutil.rmtree(tmp_reports_dir, ignore_errors=True)
+    os.mkdir(tmp_reports_dir)
 
 
 @app.route('/')
 def index():
     reports = [{"name": Path(f).name, "date": time.ctime(os.path.getctime(f)), "timestamp": os.path.getctime(f)}
-               for f in os.scandir(reports_dir) if f.is_dir()]
+               for f in os.scandir(reports_dir) if f.is_dir() and Path(f).name is not TEMP_DIR]
     reports.sort(key=lambda item: item["timestamp"], reverse=True)
     return render_template('index.html', reports=reports)
 
@@ -50,8 +53,8 @@ def dir_listing(path):
 
 @app.route('/zip/<path:path>')
 def compress(path):
+    temp_zip_dir = tempfile.TemporaryDirectory()
     try:
-        temp_zip_dir = tempfile.TemporaryDirectory()
         temp_zip_dir_name = temp_zip_dir.name
         zip_filename = path + ".zip"
         report_location = os.path.join(reports_dir, path)
@@ -68,7 +71,7 @@ def compress(path):
 def delete(path):
     # Checking if the report exists. This is to prevent attempt to delete any data by deleting any file outside
     # report dir if you prepare path variable.
-    reports_list = os.listdir(reports_dir)
+    # reports_list = os.listdir(reports_dir)
     report_location = os.path.normpath(os.path.join(reports_dir, path))
     if not report_location.startswith(reports_dir):
         logging.error("Deleted report in report list. Not deleting")
@@ -82,10 +85,19 @@ def delete(path):
 # Latest GenAI contribution: ibm/granite-20b-code-instruct-v2
 @app.route('/upload', methods=['POST'])
 def upload_file():
+
+    report_name = request.values.get("report_name")
+    report_name = re.sub(r'[^a-zA-Z0-9]', '_', report_name)
+
+    # Create a temporary directory to store uploaded files
+    # Note We have to use permanent files and then delete them.
+    # tempfile.Temporary_directory function does not work when you want to access files from another threads.
+    javacores_temp_dir_name = os.path.normpath(os.path.join(reports_dir, TEMP_DIR, report_name))
+    if not javacores_temp_dir_name.startswith(reports_dir):
+        raise Exception("Security exception: Uncontrolled data used in path expression")
+
     try:
-        # Create a temporary directory to store uploaded files
-        javacores_temp_dir = tempfile.TemporaryDirectory()
-        javacores_temp_dir_name = javacores_temp_dir.name
+        os.mkdir(javacores_temp_dir_name)
 
         # Get the list of files from webpage
         files = request.files.getlist("files")
@@ -97,26 +109,46 @@ def upload_file():
             file.save(file_name)
             input_files.append(file_name)
 
-        report_name = request.values.get("report_name")
-        report_name = re.sub(r'[^a-zA-Z0-9]', '_', report_name)
-
         # Process the uploaded file
-        report_output_dir = reports_dir + '/' + report_name
-        javacore_analyser.javacore_analyser_batch.process_javacores_and_generate_report_data(input_files,
-                                                                                             report_output_dir)
-
+        report_output_dir = os.path.join(reports_dir, report_name)
+        processing_thread = threading.Thread(
+            target=javacore_analyser.javacore_analyser_batch.process_javacores_and_generate_report_data,
+            name="Processing javacore data", args=(input_files, report_output_dir)
+        )
+        processing_thread.start()
+
+        time.sleep(1)  # Give 1 second to generate index.html in processing_thread before redirecting
         return redirect("/reports/" + report_name + "/index.html")
     finally:
-        javacores_temp_dir.cleanup()
+        shutil.rmtree(javacores_temp_dir_name, ignore_errors=True)
+
 
 def main():
-    debug = os.getenv("DEBUG", False)
-    port = os.getenv("PORT", DEFAULT_PORT)
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--debug", help="Debug mode. Use only for development", default=False)
+    parser.add_argument("--port", help="Port to run application", default=DEFAULT_PORT)
+    parser.add_argument("--reports-dir", help="Directory where app reports are stored",
+                        default=DEFAULT_REPORTS_DIR)
+    args = parser.parse_args()
+    debug = args.debug
+    port = args.port
+    global reports_dir
+    reports_dir = args.reports_dir
+
+    create_console_logging()
+    logging.info("Javacore analyser")
+    logging.info("Python version: " + sys.version)
+    logging.info("Preferred encoding: " + locale.getpreferredencoding())
+    logging.info("Reports directory: " + reports_dir)
+    create_file_logging(reports_dir)
+    create_temp_data_in_reports_dir(reports_dir)
+
     if debug:
         app.run(debug=True, port=port)  # Run Flask for development
     else:
         serve(app, port=port)  # Run Waitress in production
 
+
 if __name__ == '__main__':
     """
     The application passes the following environmental variables: