From 538980bc1b4f269a8d59da9bfc5021f09912c067 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sat, 24 Jul 2021 00:49:34 +0200
Subject: [PATCH 001/140] Added config file support

---
 README.md                                     |  19 ++
 artwork/prop-tool-logo.png                    | Bin 54739 -> 70267 bytes
 artwork/prop-tool-logo.svg                    | 130 ++++++------
 config.ini                                    |  17 ++
 proptool/checks/base/check.py                 |   2 +-
 proptool/config.py                            |  84 --------
 proptool/config/__init__.py                   |   8 +
 proptool/config/config.py                     |  45 +++++
 proptool/config/config_builder.py             | 188 ++++++++++++++++++
 proptool/config/config_reader.py              | 136 +++++++++++++
 proptool/log.py                               |   8 +-
 proptool/main.py                              |  52 +----
 proptool/prop/file.py                         |   2 +-
 proptool/report/report.py                     |   2 +-
 proptool/utils.py                             |  46 ++++-
 tests/checks/checks_test_case.py              |   2 +-
 tests/checks/test_base_check.py               |   2 +-
 tests/checks/test_brackets.py                 |   2 +-
 tests/checks/test_dangling_keys.py            |   2 +-
 tests/checks/test_empty_translations.py       |   2 +-
 tests/checks/test_formatting_values.py        |   2 +-
 tests/checks/test_key_format.py               |   2 +-
 tests/checks/test_missing_translations.py     |   2 +-
 tests/checks/test_punctuation.py              |   2 +-
 tests/checks/test_quotation_marks.py          |   2 +-
 .../checks/test_starts_with_the_same_case.py  |   2 +-
 tests/checks/test_trailing_white_chars.py     |   2 +-
 .../test_typesetting_quotation_marks.py       |   2 +-
 .../test_white_chars_before_linefeed.py       |   2 +-
 tests/prop/test_items.py                      |   2 +-
 tests/report/test_report.py                   |   2 +-
 31 files changed, 551 insertions(+), 220 deletions(-)
 create mode 100644 config.ini
 delete mode 100644 proptool/config.py
 create mode 100644 proptool/config/__init__.py
 create mode 100644 proptool/config/config.py
 create mode 100644 proptool/config/config_builder.py
 create mode 100644 proptool/config/config_reader.py

diff --git a/README.md b/README.md
index 6923df52..7e1efc3d 100644
--- a/README.md
+++ b/README.md
@@ -180,6 +180,25 @@ keys from base using own comment format:
 prop-tool --base gui --lang es --fix --tpl "COM >~=-> KEY SEP"
 ```
 
+## Config file and command line arguments ##
+
+You can use `prop-tool` by providing all required parameters directly from command line (see `--help`), or you can create
+configuration file and use `--config` option to make `prop-tool` load it and use. Almost all options can be set in configuration
+files, which helps, for example using `prop-tool` as part of CI/CD or GitHub Actions.
+
+Configuration file is plain text file, following [INI file format](https://en.wikipedia.org/wiki/INI_file) and can be created
+using any text editor. Please see commented [config.ini](config.ini) for example configuration file and all available options.
+
+> NOTE: when using configuration file and command line arguments, the order of precedence is this:
+> * default configuration goes first,
+> * if config file is given and can be loaded and parsed, then it overrides default configuration,
+> * if there's any command but line argument `--config` specified, then it overrides whatever is is set in config file.
+> 
+> For example:
+> * by default, `verbose` option is off
+> * your config file sets `verbose = true`, enabling verbose output,
+> * but your invocation is `prop-tool --config config.ini --no-verbose`, therefore `verbose` mode is set `OFF`.
+
 ## Limitations ##
 
 * As of now `prop-tool` do not handle multiline entries.
diff --git a/artwork/prop-tool-logo.png b/artwork/prop-tool-logo.png
index 09c6a95479a4393f8d1623f97965870a26dfa07b..9b2fed0014dff386356bcf68f89fa5beb7f19c39 100644
GIT binary patch
literal 70267
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

literal 54739
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
P1prqK%=IgEU1I(R$T6d_

diff --git a/artwork/prop-tool-logo.svg b/artwork/prop-tool-logo.svg
index 81eae625..43942919 100644
--- a/artwork/prop-tool-logo.svg
+++ b/artwork/prop-tool-logo.svg
@@ -6,10 +6,10 @@
    version="1.1"
    id="svg8"
    inkscape:version="1.1 (ce6663b3b7, 2021-05-25)"
-   sodipodi:docname="laravel-api-response-builder-logo.svg"
+   sodipodi:docname="prop-tool-logo.svg"
    inkscape:export-filename="/home/carlos/dev/projects/prop-tool/artwork/prop-tool-logo.png"
-   inkscape:export-xdpi="37.330002"
-   inkscape:export-ydpi="37.330002"
+   inkscape:export-xdpi="69.980003"
+   inkscape:export-ydpi="69.980003"
    xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
    xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
    xmlns="http://www.w3.org/2000/svg"
@@ -35,9 +35,9 @@
      borderopacity="1.0"
      inkscape:pageopacity="0.0"
      inkscape:pageshadow="2"
-     inkscape:zoom="0.47010135"
-     inkscape:cx="-1241.2217"
-     inkscape:cy="-847.68954"
+     inkscape:zoom="0.97992958"
+     inkscape:cx="903.63636"
+     inkscape:cy="1.5307222"
      inkscape:document-units="mm"
      inkscape:current-layer="layer1"
      showgrid="false"
@@ -51,12 +51,7 @@
      inkscape:window-maximized="1"
      inkscape:pagecheckerboard="true"
      inkscape:document-rotation="0"
-     units="px">
-    <sodipodi:guide
-       position="331.56804,66.231932"
-       orientation="0,-1"
-       id="guide61907" />
-  </sodipodi:namedview>
+     units="px" />
   <metadata
      id="metadata5">
     <rdf:RDF>
@@ -87,11 +82,11 @@
        inkscape:label="icon bg"
        style="display:inline">
       <g
-         transform="matrix(0.17250117,0,0,0.17250117,1.8326528,0.69460313)"
+         transform="matrix(0.09846095,0,0,0.09846095,20.462947,18.919773)"
          id="g966"
-         style="display:inline;fill:#f13360;fill-opacity:1;stroke-width:1.39644">
+         style="display:inline;fill:#f08ca3;fill-opacity:1;stroke-width:2.44653">
         <ellipse
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644"
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653"
            cx="256"
            cy="256"
            id="circle3822"
@@ -100,52 +95,89 @@
         <g
            id="g3854"
            transform="matrix(0.38009637,0,0,0.38009637,71.114523,272.97698)"
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644" />
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653" />
         <g
            id="g3856"
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644" />
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653" />
         <g
            id="g3858"
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644" />
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653" />
         <g
            id="g3860"
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644" />
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653" />
         <g
            id="g3862"
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644" />
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653" />
         <g
            id="g3864"
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644" />
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653" />
         <g
            id="g3866"
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644" />
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653" />
         <g
            id="g3868"
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644" />
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653" />
         <g
            id="g3870"
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644" />
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653" />
         <g
            id="g3872"
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644" />
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653" />
         <g
            id="g3874"
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644" />
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653" />
         <g
            id="g3876"
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644" />
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653" />
         <g
            id="g3878"
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644" />
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653" />
         <g
            id="g3880"
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644" />
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653" />
         <g
            id="g3882"
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644" />
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653" />
         <g
            id="g3884"
-           style="fill:#f13360;fill-opacity:1;stroke-width:1.39644" />
+           style="fill:#f08ca3;fill-opacity:1;stroke-width:2.44653" />
+      </g>
+    </g>
+    <g
+       inkscape:label="gear"
+       inkscape:groupmode="layer"
+       id="layer1"
+       transform="translate(0,-167)"
+       style="display:inline">
+      <flowRoot
+         transform="matrix(0.26458333,0,0,0.26458333,-70.84203,121.4291)"
+         style="font-style:normal;font-weight:normal;font-size:40px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none"
+         id="flowRoot1060"
+         xml:space="preserve"><flowRegion
+           id="flowRegion1062"><rect
+             y="469.90552"
+             x="764"
+             height="248"
+             width="1264"
+             id="rect1064" /></flowRegion><flowPara
+           id="flowPara1066" /></flowRoot>
+      <g
+         id="g5859"
+         style="display:inline;fill:#f13360;fill-opacity:1;stroke-width:2.72022"
+         transform="matrix(0.08678656,0.01760552,-0.01760552,0.08678656,69.272787,185.97749)">
+        <g
+           id="g41414"
+           style="fill:#f13360;fill-opacity:1" />
+        <g
+           id="g41417"
+           style="display:inline;fill:#f13360;fill-opacity:1;stroke-width:0.572672"
+           transform="matrix(4.7500543,0,0,4.7500543,-4362.4607,2895.217)">
+          <path
+             inkscape:connector-curvature="0"
+             id="path3844"
+             d="m 949.01836,-584.63818 12.22,-12.22 c -6.986,-9.995 -15.69,-18.699 -25.685,-25.685 l -12.22,12.22 c -8.682,-5.628 -18.436,-9.741 -28.888,-11.972 v -17.289 c -5.897,-1.043 -11.966,-1.589 -18.162,-1.589 -6.196,0 -12.265,0.546 -18.162,1.589 v 17.289 c -10.452,2.23 -20.205,6.344 -28.888,11.971 l -12.22,-12.22 c -9.995,6.986 -18.699,15.69 -25.685,25.685 l 12.22,12.22 c -5.628,8.682 -9.741,18.436 -11.972,28.888 h -17.289 c -1.043,5.897 -1.589,11.966 -1.589,18.162 0,6.196 0.546,12.265 1.589,18.162 h 17.289 c 2.23,10.452 6.344,20.205 11.972,28.888 l -12.22,12.22 c 6.986,9.995 15.69,18.699 25.685,25.685 l 12.22,-12.22 c 8.682,5.628 18.436,9.741 28.888,11.972 v 17.289 c 5.897,1.043 11.966,1.589 18.162,1.589 6.196,0 12.265,-0.546 18.162,-1.589 v -17.289 c 10.452,-2.23 20.205,-6.344 28.888,-11.972 l 12.22,12.22 c 9.995,-6.986 18.699,-15.69 25.685,-25.685 l -12.22,-12.22 c 5.628,-8.683 9.741,-18.436 11.972,-28.888 h 17.289 c 1.043,-5.897 1.589,-11.966 1.589,-18.162 0,-6.196 -0.546,-12.265 -1.589,-18.162 h -17.289 c -2.231,-10.451 -6.344,-20.204 -11.972,-28.887 z m -72.735,85.306 c -21.128,0 -38.256,-17.128 -38.256,-38.256 0,-21.128 17.128,-38.256 38.256,-38.256 21.128,0 38.256,17.128 38.256,38.256 0,21.128 -17.129,38.256 -38.256,38.256 z"
+             style="fill:#f13360;fill-opacity:1;stroke-width:0.572672" />
+        </g>
       </g>
     </g>
     <g
@@ -360,42 +392,6 @@
         </g>
       </g>
     </g>
-    <g
-       inkscape:label="gear"
-       inkscape:groupmode="layer"
-       id="layer1"
-       transform="translate(0,-167)"
-       style="display:inline">
-      <flowRoot
-         transform="matrix(0.26458333,0,0,0.26458333,-70.84203,121.4291)"
-         style="font-style:normal;font-weight:normal;font-size:40px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none"
-         id="flowRoot1060"
-         xml:space="preserve"><flowRegion
-           id="flowRegion1062"><rect
-             y="469.90552"
-             x="764"
-             height="248"
-             width="1264"
-             id="rect1064" /></flowRegion><flowPara
-           id="flowPara1066" /></flowRoot>
-      <g
-         id="g5859"
-         style="display:inline;stroke-width:2.72022"
-         transform="matrix(0.08855428,0,0,0.08855428,-12.286001,285.0462)">
-        <g
-           id="g41414" />
-        <g
-           id="g41417"
-           style="display:inline;stroke-width:2.72022"
-           transform="translate(5.4102946e-6,1.1968984e-5)">
-          <path
-             inkscape:connector-curvature="0"
-             id="path3844"
-             d="m 949.01836,-584.63818 12.22,-12.22 c -6.986,-9.995 -15.69,-18.699 -25.685,-25.685 l -12.22,12.22 c -8.682,-5.628 -18.436,-9.741 -28.888,-11.972 v -17.289 c -5.897,-1.043 -11.966,-1.589 -18.162,-1.589 -6.196,0 -12.265,0.546 -18.162,1.589 v 17.289 c -10.452,2.23 -20.205,6.344 -28.888,11.971 l -12.22,-12.22 c -9.995,6.986 -18.699,15.69 -25.685,25.685 l 12.22,12.22 c -5.628,8.682 -9.741,18.436 -11.972,28.888 h -17.289 c -1.043,5.897 -1.589,11.966 -1.589,18.162 0,6.196 0.546,12.265 1.589,18.162 h 17.289 c 2.23,10.452 6.344,20.205 11.972,28.888 l -12.22,12.22 c 6.986,9.995 15.69,18.699 25.685,25.685 l 12.22,-12.22 c 8.682,5.628 18.436,9.741 28.888,11.972 v 17.289 c 5.897,1.043 11.966,1.589 18.162,1.589 6.196,0 12.265,-0.546 18.162,-1.589 v -17.289 c 10.452,-2.23 20.205,-6.344 28.888,-11.972 l 12.22,12.22 c 9.995,-6.986 18.699,-15.69 25.685,-25.685 l -12.22,-12.22 c 5.628,-8.683 9.741,-18.436 11.972,-28.888 h 17.289 c 1.043,-5.897 1.589,-11.966 1.589,-18.162 0,-6.196 -0.546,-12.265 -1.589,-18.162 h -17.289 c -2.231,-10.451 -6.344,-20.204 -11.972,-28.887 z m -72.735,85.306 c -21.128,0 -38.256,-17.128 -38.256,-38.256 0,-21.128 17.128,-38.256 38.256,-38.256 21.128,0 38.256,17.128 38.256,38.256 0,21.128 -17.129,38.256 -38.256,38.256 z"
-             style="fill:#5d5d5d;stroke-width:2.72022;fill-opacity:1" />
-        </g>
-      </g>
-    </g>
   </g>
   <style
      type="text/css"
diff --git a/config.ini b/config.ini
new file mode 100644
index 00000000..01724920
--- /dev/null
+++ b/config.ini
@@ -0,0 +1,17 @@
+[prop-tool]
+# Version of configuration file format.
+version = 1
+
+comment_marker = '#'
+separator = "="
+debug = false
+fatal = false
+color = true
+quiet = false
+strict = false
+verbose = false
+
+[KeyFormat]
+pattern = "^[a-z]+[a-zA-Z0-9_.]*[a-zA-Z0-9]+$"
+
+[Punctuation]
diff --git a/proptool/checks/base/check.py b/proptool/checks/base/check.py
index 3d8ef37e..f2f44792 100644
--- a/proptool/checks/base/check.py
+++ b/proptool/checks/base/check.py
@@ -10,7 +10,7 @@
 from abc import ABC, abstractmethod
 from typing import Union
 
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.report.report import Report
 
 
diff --git a/proptool/config.py b/proptool/config.py
deleted file mode 100644
index 4ab01250..00000000
--- a/proptool/config.py
+++ /dev/null
@@ -1,84 +0,0 @@
-"""
-# prop-tool
-# Java *.properties file sync checker and syncing tool.
-#
-# Copyright ©2021 Marcin Orlowski <mail [@] MarcinOrlowski.com>
-# https://github.com/MarcinOrlowski/prop-tool/
-#
-"""
-
-import argparse
-from pathlib import Path
-from typing import List
-
-from .utils import Utils
-
-
-class Config(object):
-    ALLOWED_SEPARATORS: List[str] = ['=', ':']
-    ALLOWED_COMMENT_MARKERS: List[str] = ['#', '!']
-    DEFAULT_COMMENT_TEMPLATE: str = 'COM ==> KEY SEP'
-
-    def __init__(self, args: argparse = None):
-        self.comment_marker: str = '#'
-        self.comment_template: str = Config.DEFAULT_COMMENT_TEMPLATE
-        self.debug = False
-        self.debug_verbose = 1  # Log.VERBOSE_NORMAL
-        self.fatal = False
-        self.files: List[str] = []
-        self.fix: bool = False
-        self.languages: List[str] = []
-        self.no_color = False
-        self.punctuation_exception_langs: List[str] = []
-        self.quiet: bool = False
-        self.separator: str = '='
-        self.strict: bool = False
-        self.verbose: bool = False
-
-        self.checks = {
-            'KeyFormat': {
-                'pattern': r'^[a-z]+[a-zA-Z0-9_.]*[a-zA-Z0-9]+$',
-            },
-            'Punctuation': {
-                'chars': ['.', '?', '!', ':', r'\n'],
-            },
-        }
-
-        if args:
-            self.debug = args.debug
-            self.fatal = args.fatal
-            self.fix = args.fix
-            self.languages = args.languages
-            self.no_color = args.no_color
-            self.quiet = args.quiet
-            self.strict = args.strict
-            self.verbose = args.verbose
-
-            # Separator character.
-            separator = args.separator[0]
-            if separator not in Config.ALLOWED_SEPARATORS:
-                Utils.abort(f'Invalid separator. Must be one of the following: {Config.ALLOWED_SEPARATORS}')
-            self.separator = separator
-
-            # Comment marker character.
-            comment = args.comment[0]
-            if comment not in Config.ALLOWED_COMMENT_MARKERS:
-                Utils.abort(f'Invalid comment marker. Must be one of the following: {Config.ALLOWED_COMMENT_MARKERS}')
-            self.comment_marker = comment
-
-            if args.punctuation_exception_langs is not None:
-                self.punctuation_exception_langs = args.punctuation_exception_langs
-
-            # Comment template.
-            for placeholder in ('COM', 'SEP', 'KEY'):
-                if args.comment_template.find(placeholder) == -1:
-                    Utils.abort(f'Missing literal in comment template: {placeholder}')
-            self.comment_template = args.comment_template
-
-            # base files
-            suffix = '.properties'
-            suffix_len = len(suffix)
-            for file in args.files:
-                if file[suffix_len * -1:] != suffix:
-                    file += suffix
-                self.files.append(str(Path(file)))
diff --git a/proptool/config/__init__.py b/proptool/config/__init__.py
new file mode 100644
index 00000000..fee132ff
--- /dev/null
+++ b/proptool/config/__init__.py
@@ -0,0 +1,8 @@
+"""
+# prop-tool
+# Java *.properties file sync checker and syncing tool.
+#
+# Copyright ©2021 Marcin Orlowski <mail [@] MarcinOrlowski.com>
+# https://github.com/MarcinOrlowski/prop-tool/
+#
+"""
diff --git a/proptool/config/config.py b/proptool/config/config.py
new file mode 100644
index 00000000..5fee0ea3
--- /dev/null
+++ b/proptool/config/config.py
@@ -0,0 +1,45 @@
+"""
+# prop-tool
+# Java *.properties file sync checker and syncing tool.
+#
+# Copyright ©2021 Marcin Orlowski <mail [@] MarcinOrlowski.com>
+# https://github.com/MarcinOrlowski/prop-tool/
+#
+"""
+
+from typing import List
+
+
+class Config(object):
+    VERSION = 1
+
+    ALLOWED_SEPARATORS: List[str] = ['=', ':']
+    ALLOWED_COMMENT_MARKERS: List[str] = ['#', '!']
+    DEFAULT_COMMENT_TEMPLATE: str = 'COM ==> KEY SEP'
+
+    def __init__(self):
+        self.debug = False
+        self.fatal = False
+        self.color = True
+        self.quiet: bool = False
+        self.strict: bool = False
+        self.verbose: bool = False
+
+        self.fix: bool = False
+
+        self.files: List[str] = []
+        self.languages: List[str] = []
+
+        self.separator: str = '='
+
+        self.comment_marker: str = '#'
+        self.comment_template: str = Config.DEFAULT_COMMENT_TEMPLATE
+
+        self.checks = {
+            'KeyFormat':   {
+                'pattern': r'^[a-z]+[a-zA-Z0-9_.]*[a-zA-Z0-9]+$',
+            },
+            'Punctuation': {
+                'chars': ['.', '?', '!', ':', r'\n'],
+            },
+        }
diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
new file mode 100644
index 00000000..980e89f7
--- /dev/null
+++ b/proptool/config/config_builder.py
@@ -0,0 +1,188 @@
+"""
+# prop-tool
+# Java *.properties file sync checker and syncing tool.
+#
+# Copyright ©2021 Marcin Orlowski <mail [@] MarcinOrlowski.com>
+# https://github.com/MarcinOrlowski/prop-tool/
+#
+"""
+import argparse
+from pathlib import Path
+
+from proptool.config.config import Config
+from proptool.config.config_reader import ConfigReader
+from proptool.const import Const
+from proptool.log import Log
+from proptool.utils import Utils
+
+
+class ConfigBuilder(object):
+    # List of options that can be either turned on or off.
+    _onoff_pairs = [
+        'fatal',
+        'strict',
+        'quiet',
+        'verbose',
+        'color',
+    ]
+
+    @staticmethod
+    def build():
+        # get default config
+        config = Config()
+
+        args = ConfigBuilder._parse_args()
+
+        if args.config_file:
+            config_file = Path(args.config_file[0])
+            # override with loaded user config file
+            config = ConfigReader().read(config, config_file)
+
+        # override with command line arguments
+        config = ConfigBuilder._set_from_args(config, args)
+
+        ConfigBuilder._validate(config)
+
+        return config
+
+    @staticmethod
+    def _validate(config: Config) -> None:
+        if not config.files:
+            Log.abort('No base file(s) specified.')
+        if not config.languages:
+            Log.abort('No language(s) specified.')
+        if config.separator not in Config.ALLOWED_SEPARATORS:
+            Log.abort('Invalid separator character.')
+        if config.comment_marker not in Config.ALLOWED_COMMENT_MARKERS:
+            Log.abort('Invalid comment marker.')
+
+    @staticmethod
+    def _set_on_off_option(config: Config, args, option: str) -> Config:
+        """
+        Changes Config's entry if either --<option> or --<no-option> switch is set.
+        If none is set, returns Config object unaltered.
+        :param config:
+        :param args:
+        :param option:
+        :return:
+        """
+        if args.__getattribute__(option):
+            config.__setattr__(option, True)
+        elif args.__getattribute__(f'no_{option}'):
+            config.__setattr__(option, False)
+        return config
+
+    @staticmethod
+    def _set_from_args(config: Config, args) -> Config:
+        # At this point it is assumed that args are in valid state (i.e. no mutually exclusive options are both set etc).
+
+        for option in ConfigBuilder._onoff_pairs:
+            config = ConfigBuilder._set_on_off_option(config, args, option)
+
+        config.fix = args.fix
+        config.languages = args.languages
+
+        config.separator = args.separator
+        config.comment_marker = args.comment
+        config.comment_template = args.comment_template
+
+        # base files
+        suffix = '.properties'
+        suffix_len = len(suffix)
+        if args.files:
+            for file in args.files:
+                if file[suffix_len * -1:] != suffix:
+                    file += suffix
+                Utils.add_if_not_in_list(config.files, str(Path(file)))
+
+        # languages
+        if args.languages:
+            Utils.add_if_not_in_list(config.languages, args.languages)
+
+        return config
+
+    @staticmethod
+    def _parse_args() -> argparse:
+        parser = argparse.ArgumentParser(prog = Const.APP_NAME.lower(), formatter_class = argparse.RawTextHelpFormatter,
+                                         description = '\n'.join(Const.APP_DESCRIPTION))
+
+        group = parser.add_argument_group('Base options')
+        group.add_argument('--config', action = 'store', dest = 'config_file', nargs = 1, metavar = 'FILE',
+                           help = 'Use specified config file. Note: command line arguments can override config!')
+        group.add_argument('-b', '--base', action = 'store', dest = 'files', nargs = '+', metavar = 'FILE',
+                           help = 'List of base files to check.')
+        group.add_argument('-l', '--lang', action = 'store', dest = 'languages', nargs = '+', metavar = 'LANG',
+                           help = 'List of languages to check (space separated if more than one, i.e. "de pl").')
+
+        group = parser.add_argument_group('Additional options')
+        group.add_argument('--fix', action = 'store_true', dest = 'fix',
+                           help = 'Updated translation files in-place. No backup!')
+        # group.add_argument('--pe', '--punctuation-exception', dest = 'punctuation_exception_langs', nargs = '*', metavar = 'LANG',
+        #                    help = 'List of languages for which punctuation mismatch should not be checked for, i.e. "jp"')
+        group.add_argument('--separator', action = 'store', dest = 'separator', metavar = 'CHAR', nargs = 1, default = '=',
+                           help = 'If specified, only given CHAR is considered a valid key/value separator.'
+                                  + f'Must be one of the following: {", ".join(Config.ALLOWED_SEPARATORS)}')
+        group.add_argument('--comment', action = 'store', dest = 'comment', metavar = 'CHAR', nargs = 1, default = '#',
+                           help = 'If specified, only given CHAR is considered valid comment marker.'
+                                  + f'Must be one of the following: {", ".join(Config.ALLOWED_COMMENT_MARKERS)}')
+        group.add_argument('-t', '--template', action = 'store', dest = 'comment_template', metavar = 'TEMPLATE', nargs = 1,
+                           default = Config.DEFAULT_COMMENT_TEMPLATE,
+                           help = f'Format of commented-out entries. Default: "{Config.DEFAULT_COMMENT_TEMPLATE}".')
+
+        group = parser.add_argument_group('Checks controlling options')
+        group.add_argument('-s', '--strict', action = 'store_true', dest = 'strict',
+                           help = 'Enables strict validation mode for all checks involved.')
+        group.add_argument('-ns', '--no-strict', action = 'store_true', dest = 'no_strict',
+                           help = 'Disables strict validation mode for all checks involved (default).')
+
+        group.add_argument('-f', '--fatal', action = 'store_true', dest = 'fatal',
+                           help = 'Enables strict mode. All warnings are treated as errors and are fatal.')
+        group.add_argument('-nf', '--no-fatal', action = 'store_true', dest = 'no_fatal',
+                           help = 'Warnings are non-fatal, errors are fatal (default).')
+
+        group = parser.add_argument_group('Application controls')
+        group.add_argument('-q', '--quiet', action = 'store_true', dest = 'quiet',
+                           help = 'Enables quiet mode, mutting all output but fatal errors.')
+        group.add_argument('-nq', '--no-quiet', action = 'store_true', dest = 'no_quiet',
+                           help = 'Disables quiet mode, enabling all type of messages (default).')
+        group.add_argument('-v', '--verbose', action = 'store_true', dest = 'verbose',
+                           help = 'Produces more verbose reports.')
+        group.add_argument('-nv', '--no-verbose', action = 'store_true', dest = 'no_verbose',
+                           help = 'Disables verbose mode, so only crucial messages are shown (default).')
+        group.add_argument('-d', '--debug', action = 'store_true', dest = 'debug',
+                           help = 'Enables debug output.')
+        group.add_argument('-nd', '--no-debug', action = 'store_true', dest = 'no_debug',
+                           help = 'Disables additional debug output (default).')
+
+        group.add_argument('-c', '--color', action = 'store_true', dest = 'color',
+                           help = 'Enables use of ANSI colors (default).')
+        group.add_argument('-nc', '--no-color', action = 'store_true', dest = 'no_color',
+                           help = 'Disables use of ANSI colors.')
+
+        group = parser.add_argument_group('Misc')
+        group.add_argument('--version', action = 'store_true', dest = 'show_version',
+                           help = 'Displays application version details and quits.')
+
+        args = parser.parse_args()
+
+        # Check use of mutually exclusive pairs
+        for key in ConfigBuilder._onoff_pairs:
+            if args.__getattribute__(key) and args.__getattribute__(f'no_{key}'):
+                parser.error(f'You cannot use "--{key}" and "--no-{key}" at the same time.')
+
+        # Separator character.
+        separator = args.separator[0]
+        if separator not in Config.ALLOWED_SEPARATORS:
+            parser.error(f'Invalid separator. Must be one of the following: {", ".join(Config.ALLOWED_SEPARATORS)}')
+
+        # Comment marker character.
+        comment = args.comment[0]
+        if comment not in Config.ALLOWED_COMMENT_MARKERS:
+            parser.error(f'Invalid comment marker. Must be one of the following: {", ".join(Config.ALLOWED_COMMENT_MARKERS)}')
+
+        # Comment template.
+        for placeholder in ('COM', 'SEP', 'KEY'):
+            if args.comment_template.find(placeholder) == -1:
+                parser.error(f'Missing literal in comment template: "{placeholder}".')
+
+        return args
diff --git a/proptool/config/config_reader.py b/proptool/config/config_reader.py
new file mode 100644
index 00000000..2e33fb07
--- /dev/null
+++ b/proptool/config/config_reader.py
@@ -0,0 +1,136 @@
+"""
+# prop-tool
+# Java *.properties file sync checker and syncing tool.
+#
+# Copyright ©2021 Marcin Orlowski <mail [@] MarcinOrlowski.com>
+# https://github.com/MarcinOrlowski/prop-tool/
+#
+"""
+import configparser
+import json
+from configparser import ConfigParser
+from pathlib import Path
+from typing import Dict, List
+
+from proptool.config.config import Config
+from proptool.log import Log
+from proptool.utils import Utils
+
+
+class ConfigReader(object):
+    def read(self, config: Config, config_file_name: Path) -> Config:
+        """
+        Reads and **MERGES** configuration parameters read from given configuration INI file.
+        Not that certain types (lists, maps/dicts) are MERGED with existing content!
+
+        :param config: Config to merge loaded config file into.
+        :param config_file_name: Path to valid config INI file.
+        :return: Instance of Config with fields containing
+        """
+        # config_file_name = os.path.normpath(config_file_name)
+        # config_file_name_full = os.path.expanduser(config_file_name)
+
+        if not config_file_name.exists():
+            Log.abort(f'Config file not found {config_file_name}')
+
+        parser = configparser.ConfigParser()
+        # Prevent keys CaSe from being altered by default implementation.
+        parser.optionxform = str
+
+        # noinspection PyBroadException
+        try:
+            parser.read(config_file_name)
+        except:
+            # noinspection PyUnresolvedReferences
+            Log.abort(f'Failed parsing config INI file: {config_file_name}')
+
+        # Presence of "prop-tool" section is mandatory.
+        main_section = 'prop-tool'
+        if not parser.has_section(main_section):
+            Log.abort(f'Missing "{main_section}" section.')
+
+        # Ensure we know how to read this config file.
+        config_version = parser.getint(main_section, 'version')
+        if config_version < Config.VERSION:
+            Log.abort(f'Old version ({config_version}) of config INI file. Required {Config.VERSION}')
+
+        bools = [
+            'debug',
+            'fatal',
+            'color',
+            'quiet',
+            'strict',
+            'verbose',
+        ]
+        for single_bool in bools:
+            if parser.has_option(main_section, single_bool):
+                config.__setattr__(single_bool, parser.get(main_section, single_bool))
+
+        config.files = self._merge_if_exists(parser, config.files, main_section, 'files')
+        config.languages = self._merge_if_exists(parser, config.languages, main_section, 'languages')
+
+        if config.debug:
+            for attr_name in dir(config):
+                if attr_name[:2] != '__':
+                    print(f'{attr_name}: {getattr(config, attr_name)}')
+
+        return config
+
+    # #################################################################################################
+
+    def _merge_if_exists(self, config: ConfigParser, merge_into: List[str], config_section: str, config_option: str) -> List[str]:
+        if config.has_option(config_section, config_option):
+            return self._merge_list(merge_into, config_section, config_option)
+        else:
+            return merge_into
+
+    def _merge_list(self, merge_into: List[str], config_section: str, config_option: str) -> List[str]:
+        result = merge_into
+        if self.parser.has_option(config_section, config_option):
+            val = self.parser.get(config_section, config_option).replace('\n', '')
+            new_list = json.loads(val)
+            if new_list is not None:
+                _ = [Utils.add_if_not_in_list(result, Utils.remove_quotes(i)) for i in new_list]
+
+        return result
+
+    # ***************************************************************************
+
+    def __merge_dict(self, old_dict: Dict, ini_parser: ConfigParser, section: str) -> Dict:
+        result = old_dict
+
+        if ini_parser.has_section(section):
+            new_dict = dict(ini_parser.items(section))
+            if new_dict is None:
+                return result
+
+            for k, v in new_dict.items():
+                v = Utils.remove_quotes(v)
+
+                # if key starts with "DEL " then value does not matter and such key is REMOVED from internal storage
+                if k[0:4] == 'DEL ':
+                    key = k[4:]
+                    if key in result:
+                        if not section_name_shown:
+                            # Log.level_push('%%yellow_bright%%**WARN**%r map' % section)
+                            section_name_shown = True
+                        del result[key]
+                    continue
+
+                if k in old_dict and result[k] != v:
+                    if not section_name_shown:
+                        # Log.level_push('%%yellow_bright%%**WARN**%r map' % section)
+                        section_name_shown = True
+                result[k] = v
+
+        return result
+
+    # #################################################################################################
+
+    def __sanitize_dict(self, src_dict: Dict) -> Dict:
+        import collections
+
+        tmp = collections.OrderedDict()
+        for (k, v) in src_dict.items():
+            tmp[Utils.remove_quotes(k)] = Utils.remove_quotes(v)
+        return tmp
diff --git a/proptool/log.py b/proptool/log.py
index 806e63a6..0def684f 100644
--- a/proptool/log.py
+++ b/proptool/log.py
@@ -14,7 +14,7 @@
 from pathlib import PosixPath
 from typing import List, Union
 
-from .config import Config
+from proptool.config.config import Config
 
 
 # #################################################################################################
@@ -82,7 +82,7 @@ class Log(object):
 
     buffer_enabled: bool = True
     debug = False
-    no_color: bool = False
+    color: bool = False
     quiet: bool = False
     skip_empty_lines: bool = False
     verbose: bool = False
@@ -93,7 +93,7 @@ class Log(object):
     def configure(cls, config: Config) -> None:
         cls.buffer_enabled = True
         cls.debug = config.debug
-        cls.no_color = config.no_color
+        cls.color = config.color
         cls.quiet = False
         cls.skip_empty_lines = False
         cls.verbose = config.verbose
@@ -341,7 +341,7 @@ def _format_log_line(message = None, color: Union[str, None] = None, stacktrace_
             if stacktrace_postfix is not None:
                 message += stacktrace_postfix
 
-            if Log.no_color:
+            if Log.color:
                 message = Ansi.strip(message)
 
         return message
diff --git a/proptool/main.py b/proptool/main.py
index f8e942bc..f2d40a4d 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -7,7 +7,6 @@
 #
 """
 
-import argparse
 import copy
 import sys
 from pathlib import Path
@@ -18,56 +17,17 @@
 from proptool.checks.trailing_white_chars import TrailingWhiteChars
 from proptool.checks.typesetting_quotation_marks import TypesettingQuotationMarks
 from proptool.checks.white_chars_before_linefeed import WhiteCharsBeforeLinefeed
+from proptool.config_builder import ConfigBuilder
 from proptool.prop.file import PropFile
-from .config import Config
 from .const import Const
 from .log import Log
 from .utils import Utils
 
 
+# #################################################################################################
+
+
 class PropTool(object):
-    @staticmethod
-    def _parse_args() -> argparse:
-        parser = argparse.ArgumentParser(prog = Const.APP_NAME.lower(), formatter_class = argparse.RawTextHelpFormatter,
-                                         description = '\n'.join(Const.APP_DESCRIPTION))
-
-        group = parser.add_argument_group('Options')
-        # group.add_argument('--config', action = 'store', dest = 'config', nargs = 1, metavar = 'FILE',
-        #                    help = 'Use specified config file. Note command line arguments can override config!')
-        group.add_argument('-b', '--base', action = 'store', dest = 'files', nargs = '+', metavar = 'FILE',
-                           help = 'List of base files to check.')
-        group.add_argument('-l', '--lang', action = 'store', dest = 'languages', nargs = '+', metavar = 'LANG', required = True,
-                           help = 'List of languages to check (space separated if more than one, i.e. "de pl").')
-        group.add_argument('--fix', action = 'store_true', dest = 'fix',
-                           help = 'Updated translation files in-place. No backup!')
-        group.add_argument('--pe', '--punctuation-exception', dest = 'punctuation_exception_langs', nargs = '*', metavar = 'LANG',
-                           help = 'List of languages for which punctuation mismatch should not be checked for, i.e. "jp"')
-        group.add_argument('-s', '--strict', action = 'store_true', dest = 'strict',
-                           help = 'Controls strict validation mode.')
-        group.add_argument('--sep', action = 'store', dest = 'separator', metavar = 'CHAR', nargs = 1, default = '=',
-                           help = 'If specified, only given CHAR is considered a valid separator.'
-                                  + f'Must be one of the following: {", ".join(Config.ALLOWED_SEPARATORS)}')
-        group.add_argument('-c', '--com', action = 'store', dest = 'comment', metavar = 'CHAR', nargs = 1, default = '#',
-                           help = 'If specified, only given CHAR is considered va alid comment marker. '
-                                  + f'Must be one of the following: {", ".join(Config.ALLOWED_COMMENT_MARKERS)}')
-        group.add_argument('-t', '--tpl', action = 'store', dest = 'comment_template', metavar = 'TEMPLATE', nargs = 1,
-                           default = Config.DEFAULT_COMMENT_TEMPLATE,
-                           help = f'Format of commented-out entries. Default: "{Config.DEFAULT_COMMENT_TEMPLATE}"')
-        group.add_argument('-f', '--fatal', action = 'store_true', dest = 'fatal',
-                           help = 'All warnings are fatal (as errors)')
-
-        group = parser.add_argument_group('Other')
-        group.add_argument('-q', '--quiet', action = 'store_true', dest = 'quiet')
-        group.add_argument('-v', '--verbose', action = 'store_true', dest = 'verbose',
-                           help = 'Produces more verbose reports')
-        group.add_argument('-d', '--debug', action = 'store_true', dest = 'debug',
-                           help = 'Enables debug output')
-        group.add_argument('-nc', '--no-color', action = 'store_true', dest = 'no_color',
-                           help = 'Disables use of ANSI colors.')
-        group.add_argument('--version', action = 'store_true', dest = 'show_version',
-                           help = 'Displays application version details and quits.')
-
-        return parser.parse_args()
 
     def main(self) -> int:
         # Cannot rely on argparse here as we have required arguments there.
@@ -75,7 +35,7 @@ def main(self) -> int:
             Log.banner(Const.APP_DESCRIPTION)
             return 0
 
-        config = Config(self._parse_args())
+        config = ConfigBuilder.build()
         Log.configure(config)
 
         errors = 0
@@ -132,6 +92,8 @@ def main(self) -> int:
         return 100 if errors else 0
 
 
+# #################################################################################################
+
 class Main(object):
     @staticmethod
     def start() -> int:
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 193ef1b9..0f555a23 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -24,7 +24,7 @@
 from proptool.checks.trailing_white_chars import TrailingWhiteChars
 from proptool.checks.typesetting_quotation_marks import TypesettingQuotationMarks
 from proptool.checks.white_chars_before_linefeed import WhiteCharsBeforeLinefeed
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.log import Log
 from proptool.prop.items import Blank, Comment, PropItem, Translation
 from proptool.report.group import ReportGroup
diff --git a/proptool/report/report.py b/proptool/report/report.py
index 88651f17..6fe1be85 100644
--- a/proptool/report/report.py
+++ b/proptool/report/report.py
@@ -9,7 +9,7 @@
 
 from typing import List
 
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.log import Log
 
 from .group import ReportGroup
diff --git a/proptool/utils.py b/proptool/utils.py
index 0deaee6f..367cf6a1 100644
--- a/proptool/utils.py
+++ b/proptool/utils.py
@@ -8,7 +8,7 @@
 """
 
 from sys import exit
-from typing import List, Union
+from typing import Dict, List, Union
 
 
 # DO NOT use Log class in Utils. That causes some dependency issues which are NOT
@@ -23,3 +23,47 @@ def abort(msg: Union[str, List[str]] = 'Aborted', rc: int = 10) -> None:
             msg = [msg]
         print(msg)
         exit(rc)
+
+    @staticmethod
+    def add_if_not_in_list(target_list: List[str], items: Union[str, List[str]]) -> None:
+        """
+        Adds given val to specified array, avoids duplicates.
+
+        :param target_list: list to add data to
+        :param items: data item(s) to add to list
+        :return:
+        """
+        if isinstance(items, str):
+            items = [str]
+        if not isinstance(items, list):
+            raise TypeError(f'add_if_not_in_list() accepts str or List[str] only. {type(items)} passed')
+
+        for entry in items:
+            if entry not in target_list:
+                target_list.append(entry)
+
+    @staticmethod
+    def add_if_not_in_dict(dictionary: Dict, key: str, val) -> bool:
+        """
+        Adds given val to specified dict, avoids duplicates.
+
+        :param dictionary: dict to add data to
+        :param key: unique key
+        :param val: data to add to array
+        :return: True if added, False if not added due to existing entry
+        """
+        if key not in dictionary:
+            dictionary[key] = val
+            return True
+        return False
+
+    @staticmethod
+    def remove_quotes(src_str: str) -> str:
+        if len(src_str) >= 2:
+            if src_str[0] == '"':
+                src_str = src_str[1:]
+            end_pos = src_str.rfind('"')
+            if end_pos != -1:
+                src_str = src_str[0:end_pos]
+
+        return src_str
diff --git a/tests/checks/checks_test_case.py b/tests/checks/checks_test_case.py
index a0ba08fd..6553d67d 100644
--- a/tests/checks/checks_test_case.py
+++ b/tests/checks/checks_test_case.py
@@ -11,7 +11,7 @@
 from typing import List, Union
 
 from proptool.checks.base.check import Check
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.prop.file import PropFile
 from proptool.prop.items import Blank, Comment, PropItem, Translation
 from tests.test_case import TestCase
diff --git a/tests/checks/test_base_check.py b/tests/checks/test_base_check.py
index 2ce77fe0..a848c851 100644
--- a/tests/checks/test_base_check.py
+++ b/tests/checks/test_base_check.py
@@ -7,7 +7,7 @@
 #
 """
 from proptool.checks.base.check import Check
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.prop.file import PropFile
 from tests.test_case import TestCase
 
diff --git a/tests/checks/test_brackets.py b/tests/checks/test_brackets.py
index b855b60d..bf8ba7c3 100644
--- a/tests/checks/test_brackets.py
+++ b/tests/checks/test_brackets.py
@@ -8,7 +8,7 @@
 """
 from proptool.checks.base.check import Check
 from proptool.checks.brackets import Brackets
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Blank, Comment, Translation
 from tests.checks.checks_test_case import ChecksTestCase
diff --git a/tests/checks/test_dangling_keys.py b/tests/checks/test_dangling_keys.py
index f416cebf..df19f2ea 100644
--- a/tests/checks/test_dangling_keys.py
+++ b/tests/checks/test_dangling_keys.py
@@ -10,7 +10,7 @@
 
 from proptool.checks.base.check import Check
 from proptool.checks.dangling_keys import DanglingKeys
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from tests.checks.checks_test_case import ChecksTestCase
 
diff --git a/tests/checks/test_empty_translations.py b/tests/checks/test_empty_translations.py
index b43e55a2..20cc48da 100644
--- a/tests/checks/test_empty_translations.py
+++ b/tests/checks/test_empty_translations.py
@@ -10,7 +10,7 @@
 
 from proptool.checks.base.check import Check
 from proptool.checks.empty_translations import EmptyTranslations
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Translation
 from tests.checks.checks_test_case import ChecksTestCase
diff --git a/tests/checks/test_formatting_values.py b/tests/checks/test_formatting_values.py
index ce2e19dd..75aaa9a1 100644
--- a/tests/checks/test_formatting_values.py
+++ b/tests/checks/test_formatting_values.py
@@ -9,7 +9,7 @@
 
 from proptool.checks.base.check import Check
 from proptool.checks.formatting_values import FormattingValues
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.file import PropFile
 from proptool.prop.items import Translation
diff --git a/tests/checks/test_key_format.py b/tests/checks/test_key_format.py
index 66834490..1575e6ab 100644
--- a/tests/checks/test_key_format.py
+++ b/tests/checks/test_key_format.py
@@ -8,7 +8,7 @@
 """
 from proptool.checks.base.check import Check
 from proptool.checks.key_format import KeyFormat
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Translation
 from tests.checks.checks_test_case import ChecksTestCase
diff --git a/tests/checks/test_missing_translations.py b/tests/checks/test_missing_translations.py
index 2fbf2cfc..8e6451d3 100644
--- a/tests/checks/test_missing_translations.py
+++ b/tests/checks/test_missing_translations.py
@@ -10,7 +10,7 @@
 
 from proptool.checks.base.check import Check
 from proptool.checks.missing_translation import MissingTranslation
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Comment
 from tests.checks.checks_test_case import ChecksTestCase
diff --git a/tests/checks/test_punctuation.py b/tests/checks/test_punctuation.py
index c8280fdc..67180b61 100644
--- a/tests/checks/test_punctuation.py
+++ b/tests/checks/test_punctuation.py
@@ -10,7 +10,7 @@
 
 from proptool.checks.base.check import Check
 from proptool.checks.punctuation import Punctuation
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.file import PropFile
 from proptool.prop.items import Translation
diff --git a/tests/checks/test_quotation_marks.py b/tests/checks/test_quotation_marks.py
index 6e3ac6f6..5e326aa3 100644
--- a/tests/checks/test_quotation_marks.py
+++ b/tests/checks/test_quotation_marks.py
@@ -8,7 +8,7 @@
 """
 from proptool.checks.base.check import Check
 from proptool.checks.quotation_marks import QuotationMarks
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Blank, Comment, Translation
 from tests.checks.checks_test_case import ChecksTestCase
diff --git a/tests/checks/test_starts_with_the_same_case.py b/tests/checks/test_starts_with_the_same_case.py
index 33506e33..16ec2338 100644
--- a/tests/checks/test_starts_with_the_same_case.py
+++ b/tests/checks/test_starts_with_the_same_case.py
@@ -10,7 +10,7 @@
 
 from proptool.checks.base.check import Check
 from proptool.checks.starts_with_the_same_case import StartsWithTheSameCase
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.file import PropFile
 from proptool.prop.items import Translation
diff --git a/tests/checks/test_trailing_white_chars.py b/tests/checks/test_trailing_white_chars.py
index 8714e30c..96ab5afc 100644
--- a/tests/checks/test_trailing_white_chars.py
+++ b/tests/checks/test_trailing_white_chars.py
@@ -8,7 +8,7 @@
 """
 from proptool.checks.base.check import Check
 from proptool.checks.trailing_white_chars import TrailingWhiteChars
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Comment, Translation
 from tests.checks.checks_test_case import ChecksTestCase
diff --git a/tests/checks/test_typesetting_quotation_marks.py b/tests/checks/test_typesetting_quotation_marks.py
index d1d79d2b..614dfe61 100644
--- a/tests/checks/test_typesetting_quotation_marks.py
+++ b/tests/checks/test_typesetting_quotation_marks.py
@@ -8,7 +8,7 @@
 """
 from proptool.checks.base.check import Check
 from proptool.checks.typesetting_quotation_marks import TypesettingQuotationMarks
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Blank, Comment, Translation
 from tests.checks.checks_test_case import ChecksTestCase
diff --git a/tests/checks/test_white_chars_before_linefeed.py b/tests/checks/test_white_chars_before_linefeed.py
index 9e8b6dab..26568a03 100644
--- a/tests/checks/test_white_chars_before_linefeed.py
+++ b/tests/checks/test_white_chars_before_linefeed.py
@@ -8,7 +8,7 @@
 """
 from proptool.checks.base.check import Check
 from proptool.checks.white_chars_before_linefeed import WhiteCharsBeforeLinefeed
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Translation
 from tests.checks.checks_test_case import ChecksTestCase
diff --git a/tests/prop/test_items.py b/tests/prop/test_items.py
index b8500669..d457025d 100644
--- a/tests/prop/test_items.py
+++ b/tests/prop/test_items.py
@@ -6,7 +6,7 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.prop.items import Blank, Comment, PropItem, Translation
 from tests.test_case import TestCase
 
diff --git a/tests/report/test_report.py b/tests/report/test_report.py
index ed66fb41..a2e9bce5 100644
--- a/tests/report/test_report.py
+++ b/tests/report/test_report.py
@@ -7,7 +7,7 @@
 #
 """
 
-from proptool.config import Config
+from proptool.config.config import Config
 from proptool.report.report import Report
 from tests.test_case import TestCase
 

From 1f2e794946e91eede2c2e5f05587f273fb582822 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sat, 24 Jul 2021 10:01:17 +0200
Subject: [PATCH 002/140] Reworked CLI args to support +/- options

---
 proptool/config/config_reader.py | 36 +++++++++++---------------------
 proptool/utils.py                |  1 +
 2 files changed, 13 insertions(+), 24 deletions(-)

diff --git a/proptool/config/config_reader.py b/proptool/config/config_reader.py
index 2e33fb07..e9ecd0ec 100644
--- a/proptool/config/config_reader.py
+++ b/proptool/config/config_reader.py
@@ -7,7 +7,6 @@
 #
 """
 import configparser
-import json
 from configparser import ConfigParser
 from pathlib import Path
 from typing import Dict, List
@@ -18,6 +17,11 @@
 
 
 class ConfigReader(object):
+    def __init__(self):
+        self.parser = configparser.ConfigParser()
+        # Prevent keys CaSe from being altered by default implementation.
+        self.parser.optionxform = str
+
     def read(self, config: Config, config_file_name: Path) -> Config:
         """
         Reads and **MERGES** configuration parameters read from given configuration INI file.
@@ -27,30 +31,24 @@ def read(self, config: Config, config_file_name: Path) -> Config:
         :param config_file_name: Path to valid config INI file.
         :return: Instance of Config with fields containing
         """
-        # config_file_name = os.path.normpath(config_file_name)
-        # config_file_name_full = os.path.expanduser(config_file_name)
 
         if not config_file_name.exists():
             Log.abort(f'Config file not found {config_file_name}')
 
-        parser = configparser.ConfigParser()
-        # Prevent keys CaSe from being altered by default implementation.
-        parser.optionxform = str
-
         # noinspection PyBroadException
         try:
-            parser.read(config_file_name)
+            self.parser.read(config_file_name)
         except:
             # noinspection PyUnresolvedReferences
             Log.abort(f'Failed parsing config INI file: {config_file_name}')
 
         # Presence of "prop-tool" section is mandatory.
         main_section = 'prop-tool'
-        if not parser.has_section(main_section):
+        if not self.parser.has_section(main_section):
             Log.abort(f'Missing "{main_section}" section.')
 
         # Ensure we know how to read this config file.
-        config_version = parser.getint(main_section, 'version')
+        config_version = self.parser.getint(main_section, 'version')
         if config_version < Config.VERSION:
             Log.abort(f'Old version ({config_version}) of config INI file. Required {Config.VERSION}')
 
@@ -63,11 +61,11 @@ def read(self, config: Config, config_file_name: Path) -> Config:
             'verbose',
         ]
         for single_bool in bools:
-            if parser.has_option(main_section, single_bool):
-                config.__setattr__(single_bool, parser.get(main_section, single_bool))
+            if self.parser.has_option(main_section, single_bool):
+                config.__setattr__(single_bool, self.parser.get(main_section, single_bool))
 
-        config.files = self._merge_if_exists(parser, config.files, main_section, 'files')
-        config.languages = self._merge_if_exists(parser, config.languages, main_section, 'languages')
+        config.files = self._merge_if_exists(self.parser, config.files, main_section, 'files')
+        config.languages = self._merge_if_exists(self.parser, config.languages, main_section, 'languages')
 
         if config.debug:
             for attr_name in dir(config):
@@ -84,16 +82,6 @@ def _merge_if_exists(self, config: ConfigParser, merge_into: List[str], config_s
         else:
             return merge_into
 
-    def _merge_list(self, merge_into: List[str], config_section: str, config_option: str) -> List[str]:
-        result = merge_into
-        if self.parser.has_option(config_section, config_option):
-            val = self.parser.get(config_section, config_option).replace('\n', '')
-            new_list = json.loads(val)
-            if new_list is not None:
-                _ = [Utils.add_if_not_in_list(result, Utils.remove_quotes(i)) for i in new_list]
-
-        return result
-
     # ***************************************************************************
 
     def __merge_dict(self, old_dict: Dict, ini_parser: ConfigParser, section: str) -> Dict:
diff --git a/proptool/utils.py b/proptool/utils.py
index 367cf6a1..44ea6796 100644
--- a/proptool/utils.py
+++ b/proptool/utils.py
@@ -67,3 +67,4 @@ def remove_quotes(src_str: str) -> str:
                 src_str = src_str[0:end_pos]
 
         return src_str
+

From 4c514c6ff2ca83812644d1c912ebc68c4f590832 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sat, 24 Jul 2021 17:50:50 +0200
Subject: [PATCH 003/140] Variable name cleanup

---
 proptool/main.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/proptool/main.py b/proptool/main.py
index f2d40a4d..8137db70 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -8,16 +8,19 @@
 """
 
 import copy
+import importlib
+import inspect
 import sys
 from pathlib import Path
 
+from proptool.checks.base.check import Check
 from proptool.checks.brackets import Brackets
 from proptool.checks.key_format import KeyFormat
 from proptool.checks.quotation_marks import QuotationMarks
 from proptool.checks.trailing_white_chars import TrailingWhiteChars
 from proptool.checks.typesetting_quotation_marks import TypesettingQuotationMarks
 from proptool.checks.white_chars_before_linefeed import WhiteCharsBeforeLinefeed
-from proptool.config_builder import ConfigBuilder
+from proptool.config.config_builder import ConfigBuilder
 from proptool.prop.file import PropFile
 from .const import Const
 from .log import Log
@@ -53,7 +56,7 @@ def main(self) -> int:
             if not reference_propfile.loaded:
                 Utils.abort(f'File not found: {reference_path}')
 
-            checks = [
+            check_modules = [
                 TrailingWhiteChars,
                 WhiteCharsBeforeLinefeed,
                 KeyFormat,
@@ -61,7 +64,7 @@ def main(self) -> int:
                 QuotationMarks,
                 TypesettingQuotationMarks,
             ]
-            for validator in checks:
+            for validator in check_modules:
                 # Almost any check validates translation against reference file, so we cannot use all checks here,
                 # but there are some that process single file independently so they in fact do not need any reference
                 # file. For them we pass our base file as translation which will do the trick.

From 294ec2427d364b6a643612612b1fb99f343d41d4 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sat, 24 Jul 2021 17:51:32 +0200
Subject: [PATCH 004/140] Added Checker dynamic configuration feature

---
 proptool/checks/base/check.py     | 22 ++++++++++++++++++----
 proptool/config/config.py         |  7 +------
 proptool/config/config_builder.py | 25 +++++++++++++++++++++----
 3 files changed, 40 insertions(+), 14 deletions(-)

diff --git a/proptool/checks/base/check.py b/proptool/checks/base/check.py
index f2f44792..ef6568da 100644
--- a/proptool/checks/base/check.py
+++ b/proptool/checks/base/check.py
@@ -8,7 +8,7 @@
 """
 
 from abc import ABC, abstractmethod
-from typing import Union
+from typing import Dict, Union
 
 from proptool.config.config import Config
 from proptool.report.report import Report
@@ -16,9 +16,12 @@
 
 # noinspection PyUnresolvedReferences
 class Check(ABC):
-    def __init__(self, config: Config):
-        if not isinstance(config, Config):
-            raise ValueError('Invalid type of config passed.')
+    DEFAULT_CHECK_CONFIG = {}
+
+    def __init__(self, config: Union[Config, None] = None):
+        if config:
+            if not isinstance(config, Config):
+                raise ValueError(f'Configuration object must be instance of Config ("{type(self.config)}" given).')
         self.config = config
 
     @abstractmethod
@@ -31,3 +34,14 @@ def need_both_files(self, translation: 'PropFile', reference: Union['PropFile',
             raise ValueError(f'Translation must be valid PropFile object ({type(translation)} given).')
         if reference is None:
             raise ValueError(f'Reference must be valid PropFile object ({type(reference)} given).')
+
+    def need_valid_config(self) -> None:
+        if not isinstance(self.config, Config):
+            raise ValueError(f'Configuration object must be instance of Config ("{type(self.config)}" given).')
+
+    def get_default_config(self) -> Dict:
+        return Check.DEFAULT_CHECK_CONFIG
+
+    # @abstractmethod
+    # def parse_args(self, args: argparse) -> Dict:
+    #     raise NotImplementedError
diff --git a/proptool/config/config.py b/proptool/config/config.py
index 5fee0ea3..967ed58b 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -36,10 +36,5 @@ def __init__(self):
         self.comment_template: str = Config.DEFAULT_COMMENT_TEMPLATE
 
         self.checks = {
-            'KeyFormat':   {
-                'pattern': r'^[a-z]+[a-zA-Z0-9_.]*[a-zA-Z0-9]+$',
-            },
-            'Punctuation': {
-                'chars': ['.', '?', '!', ':', r'\n'],
-            },
+
         }
diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 980e89f7..308815b7 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -18,7 +18,7 @@
 
 class ConfigBuilder(object):
     # List of options that can be either turned on or off.
-    _onoff_pairs = [
+    _on_off_pairs = [
         'fatal',
         'strict',
         'quiet',
@@ -31,8 +31,25 @@ def build():
         # get default config
         config = Config()
 
+        # Set up checks' default configs
+        import proptool.checks
+        from os import listdir
+
+        # Set default configuration options for each checker.
+        check_dir = Path(proptool.checks.__file__).parent
+        check_modules = [f for f in listdir(check_dir) if f[:2] != '__' and (check_dir / f).is_file()]
+        for check_file_name in check_modules:
+            import importlib
+            module = importlib.import_module(f'.{check_file_name[:-3]}', proptool.checks.__name__)
+            import inspect
+            for name, obj in inspect.getmembers(module, inspect.isclass):
+                from proptool.checks.base.check import Check
+                if issubclass(obj, Check) and obj.__name__ != Check.__name__:
+                    config.checks[obj.__name__] = obj.get_default_config(obj)
+        print('%r' % config.checks)
+
+        # Handler CLI args so we can see if there's config file to load
         args = ConfigBuilder._parse_args()
-
         if args.config_file:
             config_file = Path(args.config_file[0])
             # override with loaded user config file
@@ -76,7 +93,7 @@ def _set_on_off_option(config: Config, args, option: str) -> Config:
     def _set_from_args(config: Config, args) -> Config:
         # At this point it is assumed that args are in valid state (i.e. no mutually exclusive options are both set etc).
 
-        for option in ConfigBuilder._onoff_pairs:
+        for option in ConfigBuilder._on_off_pairs:
             config = ConfigBuilder._set_on_off_option(config, args, option)
 
         config.fix = args.fix
@@ -166,7 +183,7 @@ def _parse_args() -> argparse:
         args = parser.parse_args()
 
         # Check use of mutually exclusive pairs
-        for key in ConfigBuilder._onoff_pairs:
+        for key in ConfigBuilder._on_off_pairs:
             if args.__getattribute__(key) and args.__getattribute__(f'no_{key}'):
                 parser.error(f'You cannot use "--{key}" and "--no-{key}" at the same time.')
 

From 8834c15ad4110cd9f0022d9d989dd515a1b37467 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sat, 24 Jul 2021 17:52:19 +0200
Subject: [PATCH 005/140] Added upper_first(), lower_first() helpers

---
 proptool/utils.py | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/proptool/utils.py b/proptool/utils.py
index 44ea6796..344e8809 100644
--- a/proptool/utils.py
+++ b/proptool/utils.py
@@ -68,3 +68,14 @@ def remove_quotes(src_str: str) -> str:
 
         return src_str
 
+    @staticmethod
+    def upper_first(src_str: str) -> str:
+        if src_str:
+            return src_str[0].upper() + src_str[1:]
+        return src_str
+
+    @staticmethod
+    def lower_first(src_str: str) -> str:
+        if src_str:
+            return src_str[0].lower() + src_str[1:]
+        return src_str

From 5b3c5fabefa4da341648893342137eeb205b315b Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sat, 24 Jul 2021 18:09:14 +0200
Subject: [PATCH 006/140] Moved Check configuration to its module default setup
 method

---
 proptool/checks/base/check.py                 |  4 +--
 proptool/checks/brackets.py                   | 30 ++++++++++++-------
 proptool/checks/key_format.py                 | 13 ++++++--
 proptool/checks/punctuation.py                | 12 ++++++--
 .../checks/typesetting_quotation_marks.py     | 20 +++++++++----
 proptool/config/config.py                     |  5 +++-
 proptool/report/report.py                     |  4 +--
 7 files changed, 62 insertions(+), 26 deletions(-)

diff --git a/proptool/checks/base/check.py b/proptool/checks/base/check.py
index ef6568da..e847dd75 100644
--- a/proptool/checks/base/check.py
+++ b/proptool/checks/base/check.py
@@ -19,9 +19,9 @@ class Check(ABC):
     DEFAULT_CHECK_CONFIG = {}
 
     def __init__(self, config: Union[Config, None] = None):
-        if config:
+        if config is not None:
             if not isinstance(config, Config):
-                raise ValueError(f'Configuration object must be instance of Config ("{type(self.config)}" given).')
+                raise ValueError(f'Configuration object must be instance of Config ("{type(config)}" given).')
         self.config = config
 
     @abstractmethod
diff --git a/proptool/checks/brackets.py b/proptool/checks/brackets.py
index 6fe08b2b..1ed87a51 100644
--- a/proptool/checks/brackets.py
+++ b/proptool/checks/brackets.py
@@ -6,13 +6,12 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+from typing import Dict, List
 
-from typing import List
-
-from .base.check import Check
-from proptool.prop.items import Comment, Translation
 from proptool.decorators.overrides import overrides
+from proptool.prop.items import Comment, Translation
 from proptool.report.group import ReportGroup
+from .base.check import Check
 
 
 # #################################################################################################
@@ -32,13 +31,14 @@ class Brackets(Check):
 
     report_title = 'Brackets'
 
-    # Keep matching elements at the same positions (and in order preserving container!)
-    opening: List[str] = ['(', '[', '<', '{']
-    closing: List[str] = [')', ']', '>', '}']
-
     @overrides(Check)
     # Do NOT "fix" the PropFile reference and do not import it, or you step on circular dependency!
     def check(self, translation: 'PropFile', reference: 'PropFile' = None) -> ReportGroup:
+        self.need_valid_config()
+
+        opening = self.config.checks[self.__class__.__name__]['opening']
+        closing = self.config.checks[self.__class__.__name__]['closing']
+
         report = ReportGroup(self.report_title)
 
         for idx, item in enumerate(translation.items):
@@ -51,12 +51,12 @@ def check(self, translation: 'PropFile', reference: 'PropFile' = None) -> Report
             for char_idx, current_char in enumerate(item.value):
                 position: str = f'{idx + 1}:{char_idx + 1}'
 
-                if current_char in self.opening:
+                if current_char in opening:
                     # Every opening brace is pushed to the stack.
                     stack.append(Bracket(char_idx, current_char))
                     continue
 
-                if current_char in self.closing:
+                if current_char in closing:
                     # Every closing brace should take its own pair off the stack
 
                     if not stack:
@@ -67,7 +67,7 @@ def check(self, translation: 'PropFile', reference: 'PropFile' = None) -> Report
                         break
 
                     # Check if what we are about to pop from the stack and see if our current_char matches.
-                    expected = self.closing[self.opening.index(stack[-1].bracket)]
+                    expected = closing[opening.index(stack[-1].bracket)]
                     if current_char == expected:
                         stack.pop()
                         continue
@@ -85,3 +85,11 @@ def check(self, translation: 'PropFile', reference: 'PropFile' = None) -> Report
                 report.create(position, f'No closing character for "{bracket.bracket}" found.', item.key)
 
         return report
+
+    @overrides(Check)
+    def get_default_config(self) -> Dict:
+        return {
+            # Keep matching elements at the same positions
+            'opening': ['(', '[', '<', '{'],
+            'closing': [')', ']', '>', '}'],
+        }
diff --git a/proptool/checks/key_format.py b/proptool/checks/key_format.py
index d45d5c9b..4155a30f 100644
--- a/proptool/checks/key_format.py
+++ b/proptool/checks/key_format.py
@@ -7,11 +7,12 @@
 #
 """
 import re
+from typing import Dict
 
-from .base.check import Check
-from proptool.prop.items import Translation
 from proptool.decorators.overrides import overrides
+from proptool.prop.items import Translation
 from proptool.report.group import ReportGroup
+from .base.check import Check
 
 
 # #################################################################################################
@@ -25,6 +26,8 @@ class KeyFormat(Check):
     @overrides(Check)
     # Do NOT "fix" the PropFile reference and do not import it, or you step on circular dependency!
     def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None) -> ReportGroup:
+        self.need_valid_config()
+
         pattern = self.config.checks['KeyFormat']['pattern']
         compiled_pattern = re.compile(pattern)
 
@@ -40,3 +43,9 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
                 report.error(line_number + 1, 'Invalid key name format.', item.key)
 
         return report
+
+    @overrides(Check)
+    def get_default_config(self) -> Dict:
+        return {
+            'pattern': "^[a-z]+[a-zA-Z0-9_.]*[a-zA-Z0-9]+$",
+        }
diff --git a/proptool/checks/punctuation.py b/proptool/checks/punctuation.py
index a9c681b2..b0aeeee4 100644
--- a/proptool/checks/punctuation.py
+++ b/proptool/checks/punctuation.py
@@ -6,11 +6,12 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+from typing import Dict
 
-from .base.check import Check
-from proptool.prop.items import Translation
 from proptool.decorators.overrides import overrides
+from proptool.prop.items import Translation
 from proptool.report.group import ReportGroup
+from .base.check import Check
 
 
 # #################################################################################################
@@ -25,6 +26,7 @@ class Punctuation(Check):
     @overrides(Check)
     # Do NOT "fix" the PropFile reference and do not import it, or you step on circular dependency!
     def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None) -> ReportGroup:
+        self.need_valid_config()
         self.need_both_files(translation_file, reference_file)
 
         report = ReportGroup('Punctuation mismatch')
@@ -47,3 +49,9 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
                     break
 
         return report
+
+    @overrides(Check)
+    def get_default_config(self) -> Dict:
+        return {
+            'chars': ['.', '?', '!', ':', r'\n'],
+        }
diff --git a/proptool/checks/typesetting_quotation_marks.py b/proptool/checks/typesetting_quotation_marks.py
index 5c807016..8d444d74 100644
--- a/proptool/checks/typesetting_quotation_marks.py
+++ b/proptool/checks/typesetting_quotation_marks.py
@@ -7,8 +7,9 @@
 #
 """
 
-from typing import List
+from typing import Dict, List
 
+from proptool.decorators.overrides import overrides
 from proptool.report.group import ReportGroup
 from .brackets import Brackets
 
@@ -22,10 +23,17 @@ class TypesettingQuotationMarks(Brackets):
 
     report_title = ReportGroup('Print Quotation Marks')
 
-    # Keep matching elements at the same positions (and in order preserving container!)
-    # List based on:
-    # * https://www.overleaf.com/learn/latex/Typesetting_quotations#Reference_guide
-    # * https://en.wikipedia.org/wiki/Quotation_mark
-    # BUG: https://github.com/MarcinOrlowski/prop-tool/issues/19
     opening: List[str] = ['‘', '«', '„', '「', '《']
     closing: List[str] = ['’', '»', '“', '」', '》']
+
+    @overrides(Brackets)
+    def get_default_config(self) -> Dict:
+        return {
+            # Keep matching elements at the same positions
+            # List based on:
+            # * https://www.overleaf.com/learn/latex/Typesetting_quotations#Reference_guide
+            # * https://en.wikipedia.org/wiki/Quotation_mark
+            # BUG: https://github.com/MarcinOrlowski/prop-tool/issues/19
+            'opening': ['‘', '«', '„', '「', '《'],
+            'closing': ['’', '»', '“', '」', '》'],
+        }
diff --git a/proptool/config/config.py b/proptool/config/config.py
index 967ed58b..daa728d4 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -7,7 +7,7 @@
 #
 """
 
-from typing import List
+from typing import Dict, List
 
 
 class Config(object):
@@ -38,3 +38,6 @@ def __init__(self):
         self.checks = {
 
         }
+
+    def add_checker_config(self, key: str, config: Dict) -> None:
+        self.checks[key] = config
diff --git a/proptool/report/report.py b/proptool/report/report.py
index 6fe1be85..7692ab8f 100644
--- a/proptool/report/report.py
+++ b/proptool/report/report.py
@@ -11,7 +11,7 @@
 
 from proptool.config.config import Config
 from proptool.log import Log
-
+from proptool.utils import Utils
 from .group import ReportGroup
 
 
@@ -77,7 +77,7 @@ def dump(self):
             label += f'{sep}warnings: {warnings}'
 
         if label != '':
-            label = label[0].upper() + label[1:]
+            label = Utils.upper_first(label)
 
         if errors > 0:
             Log.push_e(label)

From 79889ebe8a5932801e4174e30b31a0d12bc66433 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sat, 24 Jul 2021 18:09:47 +0200
Subject: [PATCH 007/140] Updated tests to support dynamic configuration of
 Checks

---
 tests/checks/checks_test_case.py              |  7 ++++--
 tests/checks/test_base_check.py               |  2 +-
 tests/checks/test_brackets.py                 | 23 +++++++++++--------
 tests/checks/test_dangling_keys.py            |  3 ++-
 tests/checks/test_empty_translations.py       |  3 ++-
 tests/checks/test_formatting_values.py        |  3 ++-
 tests/checks/test_key_format.py               |  4 +++-
 tests/checks/test_missing_translations.py     |  3 ++-
 tests/checks/test_punctuation.py              |  3 ++-
 tests/checks/test_quotation_marks.py          |  4 +++-
 .../checks/test_starts_with_the_same_case.py  |  8 ++++---
 tests/checks/test_trailing_white_chars.py     |  4 +++-
 .../test_typesetting_quotation_marks.py       |  4 +++-
 .../test_white_chars_before_linefeed.py       |  4 +++-
 14 files changed, 49 insertions(+), 26 deletions(-)

diff --git a/tests/checks/checks_test_case.py b/tests/checks/checks_test_case.py
index 6553d67d..e5fc44fd 100644
--- a/tests/checks/checks_test_case.py
+++ b/tests/checks/checks_test_case.py
@@ -21,13 +21,16 @@ class ChecksTestCase(TestCase):
 
     def setUp(self) -> None:
         self.config: Config = Config()
-        checker = self.get_checker(self.config)
+
+        checker = self.get_checker(None)
         if not issubclass(type(checker), Check):
             raise ValueError('Checker must be subclass of Check')
+        self.config.add_checker_config(checker.__class__.__name__, self.get_checker().get_default_config())
+        checker.config = self.config
         self.checker = checker
 
     @abstractmethod
-    def get_checker(self, config: Config) -> Check:
+    def get_checker(self, config: Union[Config, None] = None) -> Check:
         raise NotImplementedError
 
     def check_single_file(self, entry: PropItem, exp_errors: int = 0, exp_warnings: int = 0) -> None:
diff --git a/tests/checks/test_base_check.py b/tests/checks/test_base_check.py
index a848c851..45e5adc0 100644
--- a/tests/checks/test_base_check.py
+++ b/tests/checks/test_base_check.py
@@ -22,7 +22,7 @@ def test_constructor(self) -> None:
             # Check is abstract class, extending ABC meta, so ordinary
             # instantiation won't work.
             Check.__abstractmethods__ = frozenset()
-            Check(None)
+            Check(False)
 
     def test_need_both_files_no_fault(self) -> None:
         config = Config()
diff --git a/tests/checks/test_brackets.py b/tests/checks/test_brackets.py
index bf8ba7c3..88759c9d 100644
--- a/tests/checks/test_brackets.py
+++ b/tests/checks/test_brackets.py
@@ -6,6 +6,8 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+from typing import Union
+
 from proptool.checks.base.check import Check
 from proptool.checks.brackets import Brackets
 from proptool.config.config import Config
@@ -17,7 +19,7 @@
 class ChecksBrackets(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Config) -> Check:
+    def get_checker(self, config: Union[Config, None] = None) -> Check:
         return Brackets(config)
 
     # #################################################################################################
@@ -58,15 +60,16 @@ def test_opening_and_closing_lists(self) -> None:
         """
         Checks if lists defining opening and closing markers are sane.
         """
-        checker: Brackets = self.get_checker(self.config)
+        checker: Brackets = self.get_checker(None)
+        config = checker.get_default_config()
 
-        self.assertEqual(len(checker.opening), len(checker.closing))
-        self.assertNotEqual([], checker.opening)
-        self.assertNotEqual([], checker.closing)
-        self.assertNotEqual(checker.opening, checker.closing)
+        self.assertEqual(len(config['opening']), len(config['closing']))
+        self.assertNotEqual([], config['opening'])
+        self.assertNotEqual([], config['closing'])
+        self.assertNotEqual(config['opening'], config['closing'])
 
         # ensure no marker is in both lists
-        for op_idx, op_marker in enumerate(checker.opening):
-            self.assertFalse(op_marker in checker.closing, f'Marker {op_marker} (position: {op_idx}) is present in closing too.')
-        for cl_idx, cl_marker in enumerate(checker.closing):
-            self.assertFalse(cl_marker in checker.opening, f'Marker {cl_marker} (position: {cl_idx}) is present in opening too.')
+        for op_idx, op_marker in enumerate(config['opening']):
+            self.assertFalse(op_marker in config['closing'], f'Marker {op_marker} (position: {op_idx}) is present in closing too.')
+        for cl_idx, cl_marker in enumerate(config['closing']):
+            self.assertFalse(cl_marker in config['opening'], f'Marker {cl_marker} (position: {cl_idx}) is present in opening too.')
diff --git a/tests/checks/test_dangling_keys.py b/tests/checks/test_dangling_keys.py
index df19f2ea..98a4bb01 100644
--- a/tests/checks/test_dangling_keys.py
+++ b/tests/checks/test_dangling_keys.py
@@ -7,6 +7,7 @@
 #
 """
 import random
+from typing import Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.dangling_keys import DanglingKeys
@@ -18,7 +19,7 @@
 class TestDanglingKeys(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Config) -> Check:
+    def get_checker(self, config: Union[Config, None] = None) -> Check:
         return DanglingKeys(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_empty_translations.py b/tests/checks/test_empty_translations.py
index 20cc48da..498f53a4 100644
--- a/tests/checks/test_empty_translations.py
+++ b/tests/checks/test_empty_translations.py
@@ -7,6 +7,7 @@
 #
 """
 import random
+from typing import Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.empty_translations import EmptyTranslations
@@ -19,7 +20,7 @@
 class TestEmptyTranslations(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Config) -> Check:
+    def get_checker(self, config: Union[Config, None] = None) -> Check:
         return EmptyTranslations(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_formatting_values.py b/tests/checks/test_formatting_values.py
index 75aaa9a1..b9449c1f 100644
--- a/tests/checks/test_formatting_values.py
+++ b/tests/checks/test_formatting_values.py
@@ -6,6 +6,7 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+from typing import Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.formatting_values import FormattingValues
@@ -19,7 +20,7 @@
 class TestFormattingValues(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Config) -> Check:
+    def get_checker(self, config: Union[Config, None] = None) -> Check:
         return FormattingValues(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_key_format.py b/tests/checks/test_key_format.py
index 1575e6ab..ed4412a6 100644
--- a/tests/checks/test_key_format.py
+++ b/tests/checks/test_key_format.py
@@ -6,6 +6,8 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+from typing import Union
+
 from proptool.checks.base.check import Check
 from proptool.checks.key_format import KeyFormat
 from proptool.config.config import Config
@@ -17,7 +19,7 @@
 class TestKeyFormat(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Config) -> Check:
+    def get_checker(self, config: Union[Config, None] = None) -> Check:
         return KeyFormat(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_missing_translations.py b/tests/checks/test_missing_translations.py
index 8e6451d3..563f1248 100644
--- a/tests/checks/test_missing_translations.py
+++ b/tests/checks/test_missing_translations.py
@@ -7,6 +7,7 @@
 #
 """
 import random
+from typing import Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.missing_translation import MissingTranslation
@@ -19,7 +20,7 @@
 class TestMissingTranslations(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Config) -> Check:
+    def get_checker(self, config: Union[Config, None] = None) -> Check:
         return MissingTranslation(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_punctuation.py b/tests/checks/test_punctuation.py
index 67180b61..9172b617 100644
--- a/tests/checks/test_punctuation.py
+++ b/tests/checks/test_punctuation.py
@@ -7,6 +7,7 @@
 #
 """
 import random
+from typing import Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.punctuation import Punctuation
@@ -20,7 +21,7 @@
 class TestPunctuation(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Config) -> Check:
+    def get_checker(self, config: Union[Config, None] = None) -> Check:
         return Punctuation(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_quotation_marks.py b/tests/checks/test_quotation_marks.py
index 5e326aa3..3255872d 100644
--- a/tests/checks/test_quotation_marks.py
+++ b/tests/checks/test_quotation_marks.py
@@ -6,6 +6,8 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+from typing import Union
+
 from proptool.checks.base.check import Check
 from proptool.checks.quotation_marks import QuotationMarks
 from proptool.config.config import Config
@@ -17,7 +19,7 @@
 class TestQuotationMarks(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Config) -> Check:
+    def get_checker(self, config: Union[Config, None] = None) -> Check:
         return QuotationMarks(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_starts_with_the_same_case.py b/tests/checks/test_starts_with_the_same_case.py
index 16ec2338..5df1f027 100644
--- a/tests/checks/test_starts_with_the_same_case.py
+++ b/tests/checks/test_starts_with_the_same_case.py
@@ -7,6 +7,7 @@
 #
 """
 import random
+from typing import Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.starts_with_the_same_case import StartsWithTheSameCase
@@ -14,13 +15,14 @@
 from proptool.decorators.overrides import overrides
 from proptool.prop.file import PropFile
 from proptool.prop.items import Translation
+from proptool.utils import Utils
 from tests.checks.checks_test_case import ChecksTestCase
 
 
 class TestStartsWithTheSameCase(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Config) -> Check:
+    def get_checker(self, config: Union[Config, None] = None) -> Check:
         return StartsWithTheSameCase(config)
 
     # #################################################################################################
@@ -56,9 +58,9 @@ def test_with_faults(self) -> None:
             if random.randint(0, 1) == 1:
                 expected_faults += 1
                 if ref_value[0].isupper():
-                    trans_value = trans_value[0].lower() + trans_value
+                    trans_value = Utils.lower_first(trans_value)
                 else:
-                    trans_value = trans_value[0].upper() + trans_value
+                    trans_value = Utils.upper_first(trans_value)
             ref_file.append(Translation(key, ref_value))
             trans_file.append(Translation(key, trans_value))
         self.check(trans_file, ref_file, exp_warnings = expected_faults)
diff --git a/tests/checks/test_trailing_white_chars.py b/tests/checks/test_trailing_white_chars.py
index 96ab5afc..9455c38f 100644
--- a/tests/checks/test_trailing_white_chars.py
+++ b/tests/checks/test_trailing_white_chars.py
@@ -6,6 +6,8 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+from typing import Union
+
 from proptool.checks.base.check import Check
 from proptool.checks.trailing_white_chars import TrailingWhiteChars
 from proptool.config.config import Config
@@ -17,7 +19,7 @@
 class TestTrailingWhiteChars(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Config) -> Check:
+    def get_checker(self, config: Union[Config, None] = None) -> Check:
         return TrailingWhiteChars(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_typesetting_quotation_marks.py b/tests/checks/test_typesetting_quotation_marks.py
index 614dfe61..e28e724c 100644
--- a/tests/checks/test_typesetting_quotation_marks.py
+++ b/tests/checks/test_typesetting_quotation_marks.py
@@ -6,6 +6,8 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+from typing import Union
+
 from proptool.checks.base.check import Check
 from proptool.checks.typesetting_quotation_marks import TypesettingQuotationMarks
 from proptool.config.config import Config
@@ -17,7 +19,7 @@
 class ChecksBrackets(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Config) -> Check:
+    def get_checker(self, config: Union[Config, None] = None) -> Check:
         return TypesettingQuotationMarks(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_white_chars_before_linefeed.py b/tests/checks/test_white_chars_before_linefeed.py
index 26568a03..8bf8fc63 100644
--- a/tests/checks/test_white_chars_before_linefeed.py
+++ b/tests/checks/test_white_chars_before_linefeed.py
@@ -6,6 +6,8 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+from typing import Union
+
 from proptool.checks.base.check import Check
 from proptool.checks.white_chars_before_linefeed import WhiteCharsBeforeLinefeed
 from proptool.config.config import Config
@@ -17,7 +19,7 @@
 class TestWhiteCharsBeforeLinefeed(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Config) -> Check:
+    def get_checker(self, config: Union[Config, None] = None) -> Check:
         return WhiteCharsBeforeLinefeed(config)
 
     # #################################################################################################

From ee9f275dbbf002d0ff810a9e3959ee59c52f58fd Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sat, 24 Jul 2021 18:15:57 +0200
Subject: [PATCH 008/140] Updated example config INI

---
 config.ini | 45 ++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 44 insertions(+), 1 deletion(-)

diff --git a/config.ini b/config.ini
index 01724920..084a2d14 100644
--- a/config.ini
+++ b/config.ini
@@ -2,7 +2,7 @@
 # Version of configuration file format.
 version = 1
 
-comment_marker = '#'
+comment = '#'
 separator = "="
 debug = false
 fatal = false
@@ -11,7 +11,50 @@ quiet = false
 strict = false
 verbose = false
 
+[Brackets]
+# Keep matching elements at the same positions
+opening = ['(', '[', '<', '{']
+closing = [')', ']', '>', '}']
+
+[DanglingKeys]
+# strict = true
+
+[EmptyTranslations]
+# strict = true
+
+[FormattingValues]
+# strict = true
+
 [KeyFormat]
+# strict = true
 pattern = "^[a-z]+[a-zA-Z0-9_.]*[a-zA-Z0-9]+$"
 
+[MissingTranslation]
+# strict = true
+
 [Punctuation]
+# strict = true
+chars = ['.', '?', '!', ':', r'\n']
+
+[QuotationMarks]
+# strict = true
+
+[StartsWithTheSameCase]
+# strict = true
+
+[TrailingWhiteChars]
+# strict = true
+
+[TypesettingQuotationMarks]
+# strict = true
+
+# Keep matching elements at the same positions
+# List based on:
+# * https://www.overleaf.com/learn/latex/Typesetting_quotations#Reference_guide
+# * https://en.wikipedia.org/wiki/Quotation_mark
+# BUG: https://github.com/MarcinOrlowski/prop-tool/issues/19
+opening = ['‘', '«', '„', '「', '《']
+closing = ['’', '»', '“', '」', '》']
+
+[WhiteCharsBeforeLinefeed]
+# strict = true

From d06d8e34562fe59e6dbcd278d931a841e72c64b1 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sat, 24 Jul 2021 19:13:14 +0200
Subject: [PATCH 009/140] Simplified entry point code

---
 proptool/main.py | 7 -------
 setup.py         | 4 ++--
 2 files changed, 2 insertions(+), 9 deletions(-)

diff --git a/proptool/main.py b/proptool/main.py
index 8137db70..e9617285 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -8,12 +8,9 @@
 """
 
 import copy
-import importlib
-import inspect
 import sys
 from pathlib import Path
 
-from proptool.checks.base.check import Check
 from proptool.checks.brackets import Brackets
 from proptool.checks.key_format import KeyFormat
 from proptool.checks.quotation_marks import QuotationMarks
@@ -94,10 +91,6 @@ def main(self) -> int:
 
         return 100 if errors else 0
 
-
-# #################################################################################################
-
-class Main(object):
     @staticmethod
     def start() -> int:
         app = PropTool()
diff --git a/setup.py b/setup.py
index eb8bf36f..d0350d59 100755
--- a/setup.py
+++ b/setup.py
@@ -35,8 +35,8 @@
     python_requires = '>=3.6',
     entry_points = {
         'console_scripts': [
-            'prop-tool = proptool.main:Main.start',
-            'proptool = proptool.main:Main.start',
+            'prop-tool = proptool.main:PropTool.start',
+            'proptool = proptool.main:PropTool.start',
         ],
     },
 

From abc2df494db744e943f02fc549337682ca1696f3 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sat, 24 Jul 2021 23:34:05 +0200
Subject: [PATCH 010/140] Lint fixes

---
 .flake8                           | 162 ++++++++++++------------------
 proptool/checks/key_format.py     |   2 +-
 proptool/config/config.py         |   2 +-
 proptool/config/config_builder.py |  23 ++---
 proptool/config/config_reader.py  |  34 +++----
 proptool/utils.py                 |   4 +-
 6 files changed, 95 insertions(+), 132 deletions(-)

diff --git a/.flake8 b/.flake8
index 8491e7a6..5ee1661a 100644
--- a/.flake8
+++ b/.flake8
@@ -6,7 +6,7 @@
 # pip install wemake-python-styleguide
 # flake8 proptool/report/
 #
-# Refactoring hitns:
+# Refactoring hints:
 # https://flake8.codes/wemake-python-styleguide/0.15.3/index.html
 
 max-line-length = 132
@@ -14,101 +14,61 @@ max-line-length = 132
 exclude =
     .git,
     __pycache__,
-    # This contains our built documentation
+# This contains our built documentation
     build,
     dist
 
 # it's not a bug that we aren't using all of hacking
 ignore =
-    # WPS211 Found too many arguments: 6 > 5
-    WPS211,
-    # WPS317 Found incorrect multi-line parameters
-    WPS317,
-    # D205 1 blank line required between summary line and description
-    D205,
-    # D400 First line should end with a period
-    D400,
-    # RST213 Inline emphasis start-string without end-string.
-    RST213,
-    # WPS300 Found local folder import
-    WPS300,
-    # I004 isort found an unexpected blank line in imports
-    I004,
-    # I001 isort found an import in the wrong position
-    I001,
-    # WPS600 Found subclassing a builtin: list
-    WPS600,
-    # WPS305 Found `f` string
-    WPS305,
-    # D401 First line should be in imperative mood
-    D401,
-    # WPS336 Found explicit string concatenation
-    WPS336,
-    # D200 One-line docstring should fit on one line with quotes
-    D200,
-    # WPS237 Found a too complex `f` string
-    WPS237,
-    # WPS302 Found unicode string prefix
-    WPS302,
-    # WPS115 Found upper-case constant in a class
-    WPS115,
-    # WPS360 Found an unnecessary use of a raw string
-    WPS360,
-    # WPS602 Found using `@staticmethod`
-    WPS602,
-    # E251 unexpected spaces around keyword / parameter equals
-    E251,
-    # I003 isort expected 1 blank line in imports, found
-    I003,
-    # WPS615 Found unpythonic getter or setter
-    WPS615,
-    # WPS238 Found too many raises in a function: 5 > 3
-    WPS238,
+    D200, # D200 One-line docstring should fit on one line with quotes
+    D205, # D205 1 blank line required between summary line and description
+    D400, # D400 First line should end with a period
+    D401, # D401 First line should be in imperative mood
+    DAR401, # DAR401 Missing exception(s) in Raises section: -r TypeError
+    E251, # E251 unexpected spaces around keyword / parameter equals
+    I001, # I001 isort found an import in the wrong position
+    I003, # I003 isort expected 1 blank line in imports, found
+    I004, # I004 isort found an unexpected blank line in imports
+    RST213, # RST213 Inline emphasis start-string without end-string.
+    W503, # W503 line break before binary operator
+    WPS115, # WPS115 Found upper-case constant in a class
+    WPS204, #WPS204 Found overused expression: config['opening']; used 5 > 4
+    WPS211, # WPS211 Found too many arguments: 6 > 5
+    WPS237, # WPS237 Found a too complex `f` string
+    WPS238, # WPS238 Found too many raises in a function: 5 > 3
+    WPS300, # WPS300 Found local folder import
+    WPS302, # WPS302 Found unicode string prefix
+    WPS305, # WPS305 Found `f` string
+    WPS317, # WPS317 Found incorrect multi-line parameters
+    WPS336, # WPS336 Found explicit string concatenation
+    WPS360, # WPS360 Found an unnecessary use of a raw string
+    WPS420, # WPS420 Found wrong keyword: pass
+    WPS600, # I001 isort found an import in the wrong position
+    WPS602, # WPS602 Found using `@staticmethod`
+    WPS604, # WPS604 Found incorrect node inside `class` body
+    WPS615, # WPS615 Found unpythonic getter or setter
 
-    # WPS420 Found wrong keyword: pass
-    WPS420,
-    # WPS604 Found incorrect node inside `class` body
-    WPS604
+    D101, # D101 Missing docstring in public class
+    D102, # D102 Missing docstring in public method
+    D107, # D107 Missing docstring in __init__
+    DAR101, # DAR101 Missing parameter(s) in Docstring
+    DAR201, # DAR201 Missing "Returns" in Docstring: - return
+    E241, # E241 multiple spaces after ':'
+    F821, # F821 undefined name 'PropFile'
+    I005, # I005 isort found an unexpected missing import
+    WPS210, # WPS210 Found too many local variables: 14 > 5
+    WPS221, # WPS221 Found line with high Jones Complexity: 17 > 14
+    WPS231, # WPS231 Found function with too much cognitive complexity: 83 > 12
+    WPS232, # WPS232 Found module cognitive complexity that is too high: 27.7 > 8
+    WPS338, # WPS338 Found incorrect order of methods in a class
 
-    # WPS338 Found incorrect order of methods in a class
-    WPS338,
-    # D101 Missing docstring in public class
-    D101,
-    # D102 Missing docstring in public method
-    D102,
-    # D107 Missing docstring in __init__
-    D107,
-    # DAR201 Missing "Returns" in Docstring: - return
-    DAR201,
-    # WPS210 Found too many local variables: 14 > 5
-    WPS210,
-    # WPS231 Found function with too much cognitive complexity: 83 > 12
-    WPS231,
-    # WPS232 Found module cognitive complexity that is too high: 27.7 > 8
-    WPS232,
-    # WPS221 Found line with high Jones Complexity: 17 > 14
-    WPS221,
-    # F821 undefined name 'PropFile'
-    F821,
-    # I005 isort found an unexpected missing import
-    I005,
-    # E241 multiple spaces after ':'
-    E241,
-    # DAR101 Missing parameter(s) in Docstring
-    DAR101,
+    WPS110, # WPS110 Found wrong variable name: item
+    WPS220, # WPS220 Found too deep nesting: 28 > 20
+    WPS226, # WPS226 Found string constant over-use: " > 3
+    WPS605, # WPS605 Found method without arguments
 
-    # WPS226 Found string constant over-use: " > 3
-    WPS226,
-    # WPS220 Found too deep nesting: 28 > 20
-    WPS220,
-    # WPS110 Found wrong variable name: item
-    WPS110,
-    # WPS605 Found method without arguments
-    WPS605,
-
-    # WPS319 Found bracket in wrong position
-    # WPS318 Found extra indentation
-    WPS319, WPS318
+    WPS318, # WPS318 Found extra indentation
+    WPS319, # WPS319 Found bracket in wrong position
 
 per-file-ignores =
     # WPS420 Found wrong keyword: pass
@@ -117,40 +77,48 @@ per-file-ignores =
     proptool/report/warn.py: WPS420, WPS604,
 
     # WPS230 Found too many public instance attributes
-    proptool/config.py: WPS230,
-
-    # WPS214 Found too many methods
+    proptool/config/config.py: WPS230,
+    # WPS204 Found overused expression: config['opening']; used 5 > 4
+    # WPS213 Found too many expressions
+    # WPS301 Found dotted raw import: proptool.checks
+    # WPS421 Found wrong function call: dir, print
     # WPS437 Found protected attribute usage
+    # WPS529 Found implicit `.get()` dict usage
+    # WPS609 Found direct magic attribute usage: __setattr__, __getattr__, ...
+    proptool/config/config_reader.py: WPS609, WPS421, WPS204, WPS529,
+    proptool/config/config_builder.py: WPS609, WPS301, WPS437, WPS213,
+
     # WPS111 Found too short name
+    # WPS214 Found too many methods
     # WPS317 Found incorrect multi-line parameters
+    # WPS323 Found `%` string formatting
     # WPS421 Found wrong function call: print
+    # WPS437 Found protected attribute usage
     # WPS518 Found implicit `enumerate()` call
-    # WPS323 Found `%` string formatting
     proptool/log.py: WPS214, WPS437, WPS111, WPS317, WPS421, WPS518, WPS323,
 
     # WPS201 Found module with too many imports: 13 > 12
     # WPS213 Found too many expressions: 13 > 9
     # WPS317 Found incorrect multi-line parameters
-    # W503 line break before binary operator
     # WPS323 Found `%` string formatting
-    proptool/main.py: WPS201, WPS213, WPS317, W503, WPS323,
+    proptool/main.py: WPS201, WPS213, WPS317, WPS323,
 
-    # WPS430 Found nested function: overrider
     # S101 Use of assert detected. The enclosed code will be removed when compiling to optimised byte code.
     # WPS421 Found wrong function call: dir
+    # WPS430 Found nested function: overrider
     proptool/decorators/overrides.py: WPS430, S101, WPS421,
 
     # WPS201 Found module with too many imports: 21 > 12
     # WPS230 Found too many public instance attributes
     proptool/prop/file.py: WPS201, WPS230,
 
-    # WPS421 Found wrong function call: print
     # WPS100 Found wrong module name
+    # WPS421 Found wrong function call: print
     proptool/utils.py: WPS421, WPS100,
 
     # S311 Standard pseudo-random generators are not suitable for security/cryptographic purposes.
-    # WPS323 Found `%` string formatting
     # WPS214 Found too many methods
+    # WPS323 Found `%` string formatting
     # WPS432 Found magic number
     # WPS609 Found direct magic attribute usage: __abstractmethods__
     tests/*: S311, WPS323, WPS214, WPS432, WPS609
diff --git a/proptool/checks/key_format.py b/proptool/checks/key_format.py
index 4155a30f..3375f059 100644
--- a/proptool/checks/key_format.py
+++ b/proptool/checks/key_format.py
@@ -47,5 +47,5 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
     @overrides(Check)
     def get_default_config(self) -> Dict:
         return {
-            'pattern': "^[a-z]+[a-zA-Z0-9_.]*[a-zA-Z0-9]+$",
+            'pattern': r'^[a-z]+[a-zA-Z0-9_.]*[a-zA-Z0-9]+$',
         }
diff --git a/proptool/config/config.py b/proptool/config/config.py
index daa728d4..33478d41 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -36,7 +36,7 @@ def __init__(self):
         self.comment_template: str = Config.DEFAULT_COMMENT_TEMPLATE
 
         self.checks = {
-
+            # empty set
         }
 
     def add_checker_config(self, key: str, config: Dict) -> None:
diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 308815b7..768f1250 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -7,8 +7,13 @@
 #
 """
 import argparse
+import importlib
+import inspect
+from os import listdir
 from pathlib import Path
 
+import proptool.checks
+from proptool.checks.base.check import Check
 from proptool.config.config import Config
 from proptool.config.config_reader import ConfigReader
 from proptool.const import Const
@@ -31,22 +36,14 @@ def build():
         # get default config
         config = Config()
 
-        # Set up checks' default configs
-        import proptool.checks
-        from os import listdir
-
         # Set default configuration options for each checker.
         check_dir = Path(proptool.checks.__file__).parent
-        check_modules = [f for f in listdir(check_dir) if f[:2] != '__' and (check_dir / f).is_file()]
+        check_modules = [file for file in listdir(check_dir) if file[:2] != '__' and (check_dir / file).is_file()]
         for check_file_name in check_modules:
-            import importlib
             module = importlib.import_module(f'.{check_file_name[:-3]}', proptool.checks.__name__)
-            import inspect
-            for name, obj in inspect.getmembers(module, inspect.isclass):
-                from proptool.checks.base.check import Check
+            for _, obj in inspect.getmembers(module, inspect.isclass):
                 if issubclass(obj, Check) and obj.__name__ != Check.__name__:
                     config.checks[obj.__name__] = obj.get_default_config(obj)
-        print('%r' % config.checks)
 
         # Handler CLI args so we can see if there's config file to load
         args = ConfigBuilder._parse_args()
@@ -84,9 +81,11 @@ def _set_on_off_option(config: Config, args, option: str) -> Config:
         :return:
         """
         if args.__getattribute__(option):
-            config.__setattr__(option, True)
+            val = True
         elif args.__getattribute__(f'no_{option}'):
-            config.__setattr__(option, False)
+            val = False
+        config.__setattr__(option, val)
+
         return config
 
     @staticmethod
diff --git a/proptool/config/config_reader.py b/proptool/config/config_reader.py
index e9ecd0ec..9c9d7474 100644
--- a/proptool/config/config_reader.py
+++ b/proptool/config/config_reader.py
@@ -6,7 +6,7 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
-import configparser
+import collections
 from configparser import ConfigParser
 from pathlib import Path
 from typing import Dict, List
@@ -31,14 +31,13 @@ def read(self, config: Config, config_file_name: Path) -> Config:
         :param config_file_name: Path to valid config INI file.
         :return: Instance of Config with fields containing
         """
-
         if not config_file_name.exists():
             Log.abort(f'Config file not found {config_file_name}')
 
         # noinspection PyBroadException
         try:
             self.parser.read(config_file_name)
-        except:
+        except Exception:
             # noinspection PyUnresolvedReferences
             Log.abort(f'Failed parsing config INI file: {config_file_name}')
 
@@ -79,12 +78,11 @@ def read(self, config: Config, config_file_name: Path) -> Config:
     def _merge_if_exists(self, config: ConfigParser, merge_into: List[str], config_section: str, config_option: str) -> List[str]:
         if config.has_option(config_section, config_option):
             return self._merge_list(merge_into, config_section, config_option)
-        else:
-            return merge_into
+        return merge_into
 
-    # ***************************************************************************
+    # #################################################################################################
 
-    def __merge_dict(self, old_dict: Dict, ini_parser: ConfigParser, section: str) -> Dict:
+    def _merge_dict(self, old_dict: Dict, ini_parser: ConfigParser, section: str) -> Dict:
         result = old_dict
 
         if ini_parser.has_section(section):
@@ -92,33 +90,29 @@ def __merge_dict(self, old_dict: Dict, ini_parser: ConfigParser, section: str) -
             if new_dict is None:
                 return result
 
-            for k, v in new_dict.items():
-                v = Utils.remove_quotes(v)
+            for key, value in new_dict.items():
+                value = Utils.remove_quotes(value)
 
                 # if key starts with "DEL " then value does not matter and such key is REMOVED from internal storage
-                if k[0:4] == 'DEL ':
-                    key = k[4:]
+                if key[:4] == 'DEL ':
+                    key = key[4:]
                     if key in result:
                         if not section_name_shown:
-                            # Log.level_push('%%yellow_bright%%**WARN**%r map' % section)
                             section_name_shown = True
                         del result[key]
                     continue
 
-                if k in old_dict and result[k] != v:
+                if key in old_dict and result[key] != value:
                     if not section_name_shown:
-                        # Log.level_push('%%yellow_bright%%**WARN**%r map' % section)
                         section_name_shown = True
-                result[k] = v
+                result[key] = value
 
         return result
 
     # #################################################################################################
 
-    def __sanitize_dict(self, src_dict: Dict) -> Dict:
-        import collections
-
+    def _sanitize_dict(self, src_dict: Dict) -> Dict:
         tmp = collections.OrderedDict()
-        for (k, v) in src_dict.items():
-            tmp[Utils.remove_quotes(k)] = Utils.remove_quotes(v)
+        for key, value in src_dict.items():
+            tmp[Utils.remove_quotes(key)] = Utils.remove_quotes(value)
         return tmp
diff --git a/proptool/utils.py b/proptool/utils.py
index 344e8809..45d68633 100644
--- a/proptool/utils.py
+++ b/proptool/utils.py
@@ -32,6 +32,8 @@ def add_if_not_in_list(target_list: List[str], items: Union[str, List[str]]) ->
         :param target_list: list to add data to
         :param items: data item(s) to add to list
         :return:
+
+        raises TypeError
         """
         if isinstance(items, str):
             items = [str]
@@ -64,7 +66,7 @@ def remove_quotes(src_str: str) -> str:
                 src_str = src_str[1:]
             end_pos = src_str.rfind('"')
             if end_pos != -1:
-                src_str = src_str[0:end_pos]
+                src_str = src_str[:end_pos]
 
         return src_str
 

From cb1c07fc7042d0f5bd1a9369dc04b19f9dd1d8b9 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 25 Jul 2021 11:06:36 +0200
Subject: [PATCH 011/140] Fixed lints

---
 .flake8                                        | 7 ++++++-
 proptool/checks/brackets.py                    | 1 +
 proptool/checks/dangling_keys.py               | 4 ++--
 proptool/checks/empty_translations.py          | 4 ++--
 proptool/checks/formatting_values.py           | 5 ++---
 proptool/checks/key_format.py                  | 1 +
 proptool/checks/missing_translation.py         | 2 +-
 proptool/checks/punctuation.py                 | 1 +
 proptool/checks/starts_with_the_same_case.py   | 4 ++--
 proptool/checks/white_chars_before_linefeed.py | 2 +-
 proptool/config/config.py                      | 6 +++---
 11 files changed, 22 insertions(+), 15 deletions(-)

diff --git a/.flake8 b/.flake8
index 5ee1661a..22b5bb8a 100644
--- a/.flake8
+++ b/.flake8
@@ -43,6 +43,7 @@ ignore =
     WPS336, # WPS336 Found explicit string concatenation
     WPS360, # WPS360 Found an unnecessary use of a raw string
     WPS420, # WPS420 Found wrong keyword: pass
+    WPS442, # WPS442 Found outer scope names shadowing:
     WPS600, # I001 isort found an import in the wrong position
     WPS602, # WPS602 Found using `@staticmethod`
     WPS604, # WPS604 Found incorrect node inside `class` body
@@ -121,4 +122,8 @@ per-file-ignores =
     # WPS323 Found `%` string formatting
     # WPS432 Found magic number
     # WPS609 Found direct magic attribute usage: __abstractmethods__
-    tests/*: S311, WPS323, WPS214, WPS432, WPS609
+    tests/*: S311, WPS323, WPS214, WPS432, WPS609,
+
+    # WPS431 Found nested class: FakeArgs
+    # WPS437 Found protected attribute usage: _set_on_off_option
+    tests/report/test_config_builder.py: WPS431, WPS437,
diff --git a/proptool/checks/brackets.py b/proptool/checks/brackets.py
index 1ed87a51..80b69bf5 100644
--- a/proptool/checks/brackets.py
+++ b/proptool/checks/brackets.py
@@ -6,6 +6,7 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+
 from typing import Dict, List
 
 from proptool.decorators.overrides import overrides
diff --git a/proptool/checks/dangling_keys.py b/proptool/checks/dangling_keys.py
index a1d69ffa..7812fe27 100644
--- a/proptool/checks/dangling_keys.py
+++ b/proptool/checks/dangling_keys.py
@@ -7,16 +7,16 @@
 #
 """
 
-from .base.check import Check
 from proptool.decorators.overrides import overrides
 from proptool.report.group import ReportGroup
+from .base.check import Check
 
 
 # #################################################################################################
 
-# noinspection PyUnresolvedReferences
 class DanglingKeys(Check):
 
+    # noinspection PyUnresolvedReferences
     @overrides(Check)
     # Do NOT "fix" the PropFile reference and do not import it, or you step on circular dependency!
     def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None) -> ReportGroup:
diff --git a/proptool/checks/empty_translations.py b/proptool/checks/empty_translations.py
index 68d6f0ef..c7252098 100644
--- a/proptool/checks/empty_translations.py
+++ b/proptool/checks/empty_translations.py
@@ -7,10 +7,10 @@
 #
 """
 
-from .base.check import Check
-from proptool.prop.items import Translation
 from proptool.decorators.overrides import overrides
+from proptool.prop.items import Translation
 from proptool.report.group import ReportGroup
+from .base.check import Check
 
 
 # #################################################################################################
diff --git a/proptool/checks/formatting_values.py b/proptool/checks/formatting_values.py
index 1635dc12..f379ebe8 100644
--- a/proptool/checks/formatting_values.py
+++ b/proptool/checks/formatting_values.py
@@ -8,13 +8,12 @@
 """
 
 import re
-
 from typing import List
 
-from .base.check import Check
-from proptool.prop.items import Translation
 from proptool.decorators.overrides import overrides
+from proptool.prop.items import Translation
 from proptool.report.group import ReportGroup
+from .base.check import Check
 
 
 # #################################################################################################
diff --git a/proptool/checks/key_format.py b/proptool/checks/key_format.py
index 3375f059..b981222e 100644
--- a/proptool/checks/key_format.py
+++ b/proptool/checks/key_format.py
@@ -6,6 +6,7 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+
 import re
 from typing import Dict
 
diff --git a/proptool/checks/missing_translation.py b/proptool/checks/missing_translation.py
index 7e5927fa..d44036c2 100644
--- a/proptool/checks/missing_translation.py
+++ b/proptool/checks/missing_translation.py
@@ -7,9 +7,9 @@
 #
 """
 
-from .base.check import Check
 from proptool.decorators.overrides import overrides
 from proptool.report.group import ReportGroup
+from .base.check import Check
 
 
 # #################################################################################################
diff --git a/proptool/checks/punctuation.py b/proptool/checks/punctuation.py
index b0aeeee4..d88062f0 100644
--- a/proptool/checks/punctuation.py
+++ b/proptool/checks/punctuation.py
@@ -6,6 +6,7 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+
 from typing import Dict
 
 from proptool.decorators.overrides import overrides
diff --git a/proptool/checks/starts_with_the_same_case.py b/proptool/checks/starts_with_the_same_case.py
index 1c7f401d..30f27365 100644
--- a/proptool/checks/starts_with_the_same_case.py
+++ b/proptool/checks/starts_with_the_same_case.py
@@ -7,10 +7,10 @@
 #
 """
 
-from .base.check import Check
-from proptool.prop.items import Translation
 from proptool.decorators.overrides import overrides
+from proptool.prop.items import Translation
 from proptool.report.group import ReportGroup
+from .base.check import Check
 
 
 # #################################################################################################
diff --git a/proptool/checks/white_chars_before_linefeed.py b/proptool/checks/white_chars_before_linefeed.py
index d2ae8313..667b3264 100644
--- a/proptool/checks/white_chars_before_linefeed.py
+++ b/proptool/checks/white_chars_before_linefeed.py
@@ -15,7 +15,6 @@
 
 # #################################################################################################
 
-# noinspection PyUnresolvedReferences
 class WhiteCharsBeforeLinefeed(Check):
     r"""
     This check ensures there's no space before "\n", "\r" literals.
@@ -33,6 +32,7 @@ def _scan(self, report: ReportGroup, idx: int, item: Translation, literal: str)
                     return True
         return False
 
+    # noinspection PyUnresolvedReferences
     @overrides(Check)
     # Do NOT "fix" the PropFile reference and do not import it, or you step on circular dependency!
     def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None) -> ReportGroup:
diff --git a/proptool/config/config.py b/proptool/config/config.py
index 33478d41..bb6c733d 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -6,7 +6,6 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
-
 from typing import Dict, List
 
 
@@ -18,11 +17,12 @@ class Config(object):
     DEFAULT_COMMENT_TEMPLATE: str = 'COM ==> KEY SEP'
 
     def __init__(self):
-        self.debug = False
         self.fatal = False
+        self.strict: bool = False
+
+        self.debug = False
         self.color = True
         self.quiet: bool = False
-        self.strict: bool = False
         self.verbose: bool = False
 
         self.fix: bool = False

From c6b1e4afaef36924b8c2cfbfc8459765c05ca36e Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 25 Jul 2021 11:07:43 +0200
Subject: [PATCH 012/140] Added more tests

---
 tests/report/test_config_builder.py | 32 +++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 tests/report/test_config_builder.py

diff --git a/tests/report/test_config_builder.py b/tests/report/test_config_builder.py
new file mode 100644
index 00000000..52b2e0e5
--- /dev/null
+++ b/tests/report/test_config_builder.py
@@ -0,0 +1,32 @@
+"""
+# prop-tool
+# Java *.properties file sync checker and syncing tool.
+#
+# Copyright ©2021 Marcin Orlowski <mail [@] MarcinOrlowski.com>
+# https://github.com/MarcinOrlowski/prop-tool/
+#
+"""
+from proptool.config.config_builder import ConfigBuilder
+from proptool.config.config import Config
+from tests.test_case import TestCase
+
+
+class TestConfigBuilder(TestCase):
+
+    def test_set_on_off_option(self) -> None:
+        class FakeArgs(Config):
+            def __init__(self):
+                self.option = False
+                self.no_option = True
+
+        config = Config()
+        config.option = True
+        self.assertTrue(config.option)
+        args = FakeArgs()
+        ConfigBuilder._set_on_off_option(config, args, 'option')
+        self.assertFalse(config.option)
+
+        args.option = True
+        args.no_option = False
+        ConfigBuilder._set_on_off_option(config, args, 'option')
+        self.assertTrue(config.option)

From ae1b11f336e6e2acdd51d92b75763400bfc1a63d Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 25 Jul 2021 11:12:28 +0200
Subject: [PATCH 013/140] Fixed MD lint

---
 README.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 7e1efc3d..e26bd6e0 100644
--- a/README.md
+++ b/README.md
@@ -190,12 +190,14 @@ Configuration file is plain text file, following [INI file format](https://en.wi
 using any text editor. Please see commented [config.ini](config.ini) for example configuration file and all available options.
 
 > NOTE: when using configuration file and command line arguments, the order of precedence is this:
+>
 > * default configuration goes first,
 > * if config file is given and can be loaded and parsed, then it overrides default configuration,
 > * if there's any command but line argument `--config` specified, then it overrides whatever is is set in config file.
-> 
+>
 > For example:
-> * by default, `verbose` option is off
+>
+> * by default, `verbose` option is off,
 > * your config file sets `verbose = true`, enabling verbose output,
 > * but your invocation is `prop-tool --config config.ini --no-verbose`, therefore `verbose` mode is set `OFF`.
 

From c99b66a5e944344fced20deeacfd93ba6a4cf7fb Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 25 Jul 2021 11:57:37 +0200
Subject: [PATCH 014/140] Added Utils class tests

---
 proptool/utils.py                | 7 ++++---
 tests/report/test_report_item.py | 4 ++--
 tests/test_case.py               | 9 +++++++--
 3 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/proptool/utils.py b/proptool/utils.py
index 45d68633..e3a833c1 100644
--- a/proptool/utils.py
+++ b/proptool/utils.py
@@ -36,7 +36,7 @@ def add_if_not_in_list(target_list: List[str], items: Union[str, List[str]]) ->
         raises TypeError
         """
         if isinstance(items, str):
-            items = [str]
+            items = [items]
         if not isinstance(items, list):
             raise TypeError(f'add_if_not_in_list() accepts str or List[str] only. {type(items)} passed')
 
@@ -61,6 +61,7 @@ def add_if_not_in_dict(dictionary: Dict, key: str, val) -> bool:
 
     @staticmethod
     def remove_quotes(src_str: str) -> str:
+        # FIXME: shall only removed if we have 2 quotes!
         if len(src_str) >= 2:
             if src_str[0] == '"':
                 src_str = src_str[1:]
@@ -71,13 +72,13 @@ def remove_quotes(src_str: str) -> str:
         return src_str
 
     @staticmethod
-    def upper_first(src_str: str) -> str:
+    def upper_first(src_str: Union[str, None]) -> str:
         if src_str:
             return src_str[0].upper() + src_str[1:]
         return src_str
 
     @staticmethod
-    def lower_first(src_str: str) -> str:
+    def lower_first(src_str: Union[str, None]) -> str:
         if src_str:
             return src_str[0].lower() + src_str[1:]
         return src_str
diff --git a/tests/report/test_report_item.py b/tests/report/test_report_item.py
index dda6e5a6..b6219c6f 100644
--- a/tests/report/test_report_item.py
+++ b/tests/report/test_report_item.py
@@ -14,7 +14,7 @@
 class TestReportItem(TestCase):
 
     def test_to_string_with_position(self) -> None:
-        position = self.get_random_string(count = 5)
+        position = self.get_random_string(length = 5)
         msg = self.get_random_string()
 
         expected = f'Line {position}: {msg}'
@@ -38,7 +38,7 @@ def test_to_string_with_trans_key(self) -> None:
 
     def test_to_string_with_trans_key_and_position(self) -> None:
         trans_key = self.get_random_string()
-        position = self.get_random_string(count = 5)
+        position = self.get_random_string(length = 5)
         msg = self.get_random_string()
 
         expected = f'Line {position}: "{trans_key}": {msg}'
diff --git a/tests/test_case.py b/tests/test_case.py
index 1503e005..38a49489 100644
--- a/tests/test_case.py
+++ b/tests/test_case.py
@@ -9,11 +9,16 @@
 
 import random
 import unittest
+from typing import List
 
 
 class TestCase(unittest.TestCase):
-    def get_random_string(self, prefix: str = '', count: int = 16) -> str:
-        for _ in range(count):
+
+    def get_random_string_list(self, count, str_prefix: str = '', str_length: int = 16) -> List[str]:
+        return [self.get_random_string(str_prefix, str_length) for _ in range(count)]
+
+    def get_random_string(self, prefix: str = '', length: int = 16) -> str:
+        for _ in range(length):
             single_char = chr(random.randint(ord('A'), ord('Z')))
             if random.randint(0, 1):
                 single_char = single_char.lower()

From 715b26420bf1aede4a574de82d566757ec9b46b4 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 25 Jul 2021 12:32:26 +0200
Subject: [PATCH 015/140] Added Utils class tests

---
 tests/test_utils.py | 131 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 131 insertions(+)
 create mode 100644 tests/test_utils.py

diff --git a/tests/test_utils.py b/tests/test_utils.py
new file mode 100644
index 00000000..c76b8087
--- /dev/null
+++ b/tests/test_utils.py
@@ -0,0 +1,131 @@
+"""
+# prop-tool
+# Java *.properties file sync checker and syncing tool.
+#
+# Copyright ©2021 Marcin Orlowski <mail [@] MarcinOrlowski.com>
+# https://github.com/MarcinOrlowski/prop-tool/
+#
+"""
+
+from proptool.utils import Utils
+
+from tests.test_case import TestCase
+
+
+class TestUtils(TestCase):
+
+    def test_add_if_not_in_list(self) -> None:
+        count = 10
+        srcs = self.get_random_string_list(count)
+        self.assertEqual(count, len(srcs))
+
+        target = []
+
+        # Try adding new elements
+        for item in srcs:
+            Utils.add_if_not_in_list(target, item)
+        # Check element count changed.
+        self.assertEqual(len(target), len(srcs))
+
+        # Try adding duplicates
+        for item in srcs:
+            Utils.add_if_not_in_list(target, item)
+        # Check element count is unaltered.
+        self.assertEqual(count, len(target))
+
+    def test_add_if_not_in_list_with_list(self) -> None:
+        count = 10
+        srcs = self.get_random_string_list(count)
+        self.assertEqual(count, len(srcs))
+
+        target = []
+        Utils.add_if_not_in_list(target, srcs)
+        self.assertEqual(len(target), len(srcs))
+
+        # Try adding duplicates
+        Utils.add_if_not_in_list(target, srcs)
+        self.assertEqual(count, len(target))
+
+    def test_add_if_not_in_list_args_types(self) -> None:
+        # These are fine
+        Utils.add_if_not_in_list([], 'string')
+        Utils.add_if_not_in_list([], ['string'])
+
+        # These shall not pass
+        with self.assertRaises(TypeError):
+            Utils.add_if_not_in_list([], 123)
+        with self.assertRaises(TypeError):
+            Utils.add_if_not_in_list([], False)
+        with self.assertRaises(TypeError):
+            Utils.add_if_not_in_list([], {})
+
+    def test_add_if_not_in_dict(self) -> None:
+        count = 10
+        src = {}
+        target = {}
+
+        # Try adding new elements
+        for _ in range(count):
+            key = self.get_random_string('key_')
+            val = self.get_random_string()
+            Utils.add_if_not_in_dict(src, key, val)
+            Utils.add_if_not_in_dict(target, key, val)
+        self.assertEqual(count, len(src))
+
+        # Try adding duplicates
+        for key, value in src.items():
+            self.assertFalse(Utils.add_if_not_in_dict(target, key, value))
+        self.assertEqual(len(target), len(src))
+
+    def test_remove_quotes(self) -> None:
+        val = self.get_random_string()
+        src = [
+            f'"{val}',
+            f'"{val}"',
+            f'{val}"'
+        ]
+        for item in src:
+            self.assertEqual(val, Utils.remove_quotes(item))
+
+    def test_remove_quotes_too_short(self) -> None:
+        items = ['', ' ']
+        for item in items:
+            self.assertEqual(item, Utils.remove_quotes(item))
+
+    def test_upper_first(self) -> None:
+        # Get random string. Ensure first letter is lower-cased.
+        string = self.get_random_string(length = 1).lower() + self.get_random_string()
+        # Generate upper/lower map of current string.
+        case_map = [char.isupper() for idx, char in enumerate(string)]
+        # Ensure first character is lower-cased.
+        self.assertFalse(case_map[0])
+
+        upper_str = Utils.upper_first(string)
+
+        # We expect first character to be upper-cased now, other unaltered.
+        case_map[0] = True
+        for idx, char in enumerate(upper_str):
+            self.assertEqual(case_map[idx], char.isupper())
+
+    def test_upper_first_empty_string_or_none(self) -> None:
+        self.assertEqual('', Utils.upper_first(''))
+        self.assertEqual(None, Utils.upper_first(None))
+
+    def test_lower_first(self) -> None:
+        # Get random string. Ensure first letter is upper-cased.
+        string = self.get_random_string(length = 1).upper() + self.get_random_string()
+        # Generate upper/lower map of current string.
+        case_map = [char.isupper() for idx, char in enumerate(string)]
+        # Ensure first character is lower-upper.
+        self.assertTrue(case_map[0])
+
+        upper_str = Utils.lower_first(string)
+
+        # We expect first character to be lower-cased now, other unaltered.
+        case_map[0] = False
+        for idx, char in enumerate(upper_str):
+            self.assertEqual(case_map[idx], char.isupper())
+
+    def test_lower_first_empty_string_or_none(self) -> None:
+        self.assertEqual('', Utils.lower_first(''))
+        self.assertEqual(None, Utils.lower_first(None))

From 2106bbd89effce9cc30d7236c4cb0dca4d2377ab Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 25 Jul 2021 16:05:21 +0200
Subject: [PATCH 016/140] Added more Utils class tests

---
 proptool/config/config_reader.py |  8 -----
 proptool/utils.py                | 21 +++++++++++-
 tests/test_utils.py              | 55 ++++++++++++++++++++++++++++++--
 3 files changed, 73 insertions(+), 11 deletions(-)

diff --git a/proptool/config/config_reader.py b/proptool/config/config_reader.py
index 9c9d7474..9f98087f 100644
--- a/proptool/config/config_reader.py
+++ b/proptool/config/config_reader.py
@@ -108,11 +108,3 @@ def _merge_dict(self, old_dict: Dict, ini_parser: ConfigParser, section: str) ->
                 result[key] = value
 
         return result
-
-    # #################################################################################################
-
-    def _sanitize_dict(self, src_dict: Dict) -> Dict:
-        tmp = collections.OrderedDict()
-        for key, value in src_dict.items():
-            tmp[Utils.remove_quotes(key)] = Utils.remove_quotes(value)
-        return tmp
diff --git a/proptool/utils.py b/proptool/utils.py
index e3a833c1..f38ec279 100644
--- a/proptool/utils.py
+++ b/proptool/utils.py
@@ -60,7 +60,18 @@ def add_if_not_in_dict(dictionary: Dict, key: str, val) -> bool:
         return False
 
     @staticmethod
-    def remove_quotes(src_str: str) -> str:
+    def remove_quotes(src: Union[str, List, Dict]):
+        src_type = type(src)
+        if issubclass(src_type, str):
+            return Utils.remove_quotes_str(src)
+        elif issubclass(src_type, list):
+            return Utils.remove_quotes_from_list(src)
+        elif issubclass(src_type, dict):
+            return Utils.remove_quotes_from_dict(src)
+        raise TypeError(f'Argument must be of type "str", "list" or "dict", {src_type} given.')
+
+    @staticmethod
+    def remove_quotes_str(src_str: str) -> str:
         # FIXME: shall only removed if we have 2 quotes!
         if len(src_str) >= 2:
             if src_str[0] == '"':
@@ -71,6 +82,14 @@ def remove_quotes(src_str: str) -> str:
 
         return src_str
 
+    @staticmethod
+    def remove_quotes_from_dict(src_dict: Dict) -> Dict:
+        return {Utils.remove_quotes(key): Utils.remove_quotes(value) for key, value in src_dict.items()}
+
+    @staticmethod
+    def remove_quotes_from_list(src_list: List) -> List:
+        return [Utils.remove_quotes(item) for item in src_list]
+
     @staticmethod
     def upper_first(src_str: Union[str, None]) -> str:
         if src_str:
diff --git a/tests/test_utils.py b/tests/test_utils.py
index c76b8087..e795f18e 100644
--- a/tests/test_utils.py
+++ b/tests/test_utils.py
@@ -59,6 +59,8 @@ def test_add_if_not_in_list_args_types(self) -> None:
         with self.assertRaises(TypeError):
             Utils.add_if_not_in_list([], {})
 
+    # #################################################################################################
+
     def test_add_if_not_in_dict(self) -> None:
         count = 10
         src = {}
@@ -77,7 +79,9 @@ def test_add_if_not_in_dict(self) -> None:
             self.assertFalse(Utils.add_if_not_in_dict(target, key, value))
         self.assertEqual(len(target), len(src))
 
-    def test_remove_quotes(self) -> None:
+    # #################################################################################################
+
+    def test_remove_quotes_str(self) -> None:
         val = self.get_random_string()
         src = [
             f'"{val}',
@@ -85,13 +89,60 @@ def test_remove_quotes(self) -> None:
             f'{val}"'
         ]
         for item in src:
+            # It's expected to be handled by remove_quotes_str()
             self.assertEqual(val, Utils.remove_quotes(item))
 
-    def test_remove_quotes_too_short(self) -> None:
+    def test_remove_quotes_str_too_short(self) -> None:
         items = ['', ' ']
         for item in items:
+            # It's expected to be handled by remove_quotes_from_str()
             self.assertEqual(item, Utils.remove_quotes(item))
 
+    def test_remove_quotes_from_list(self) -> None:
+        val = self.get_random_string()
+        src = [
+            f'"{val}',
+            f'"{val}"',
+            f'{val}"'
+        ]
+        # It's expected to be handled by remove_quotes_from_list()
+        result = Utils.remove_quotes(src)
+        for item in result:
+            self.assertEqual(item, val)
+
+    def test_remove_quotes_from_dict(self) -> None:
+        key = self.get_random_string('key_')
+        val_1 = self.get_random_string()
+        val_2 = self.get_random_string()
+        val_3 = self.get_random_string()
+        src = {
+            f'"{key}_1':  f'"{val_1}',
+            f'"{key}_2"': f'"{val_2}"',
+            f'{key}_3"':  f'{val_3}"',
+        }
+
+        # It's expected to be handled by remove_quotes_from_dict()
+        result = Utils.remove_quotes(src)
+        self.assertEqual(len(src), len(result))
+
+        result_key = f'{key}_1'
+        self.assertIn(result_key, result)
+        self.assertEqual(result[result_key], val_1)
+
+        result_key = f'{key}_2'
+        self.assertIn(result_key, result)
+        self.assertEqual(result[result_key], val_2)
+
+        result_key = f'{key}_3'
+        self.assertIn(result_key, result)
+        self.assertEqual(result[result_key], val_3)
+
+    def test_remove_quotes_with_unsupported_arg(self) -> None:
+        with self.assertRaises(TypeError):
+            Utils.remove_quotes(123)
+
+    # #################################################################################################
+
     def test_upper_first(self) -> None:
         # Get random string. Ensure first letter is lower-cased.
         string = self.get_random_string(length = 1).lower() + self.get_random_string()

From 7af2b1cffd977dfdc252470416e246d5d1cd06d6 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 25 Jul 2021 16:30:08 +0200
Subject: [PATCH 017/140] Added more Utils class tests

---
 proptool/utils.py   |  9 +++++----
 tests/test_utils.py | 36 +++++++++++++++++++++++++++++++++++-
 2 files changed, 40 insertions(+), 5 deletions(-)

diff --git a/proptool/utils.py b/proptool/utils.py
index f38ec279..deca069c 100644
--- a/proptool/utils.py
+++ b/proptool/utils.py
@@ -18,10 +18,11 @@
 
 class Utils(object):
     @staticmethod
-    def abort(msg: Union[str, List[str]] = 'Aborted', rc: int = 10) -> None:
-        if isinstance(msg, str):
-            msg = [msg]
-        print(msg)
+    def abort(msgs: Union[str, List[str]] = 'Aborted', rc: int = 10) -> None:
+        if isinstance(msgs, str):
+            msgs = [msgs]
+        for single_msg in msgs:
+            print(single_msg)
         exit(rc)
 
     @staticmethod
diff --git a/tests/test_utils.py b/tests/test_utils.py
index e795f18e..4c0af3f6 100644
--- a/tests/test_utils.py
+++ b/tests/test_utils.py
@@ -6,14 +6,48 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+import random
+import unittest
+from unittest.mock import call, patch
 
 from proptool.utils import Utils
-
 from tests.test_case import TestCase
 
 
 class TestUtils(TestCase):
 
+    @patch('builtins.print')
+    # As we mock print(), to sys.stdout.write('...\n') needs to be used instead.
+    def test_abort_single_msg(self, mock_print) -> None:
+        expected_rc = random.randint(1, 255)
+        msg = self.get_random_string()
+        with self.assertRaises(SystemExit) as context_manager:
+            Utils.abort(msg, expected_rc)
+        # Ensure all messages are printed
+        exp_calls = [call(msg)]
+        mock_print.assert_has_calls(exp_calls)
+
+        # Check we got sys.exit called with our return code.
+        self.assertEqual(SystemExit, type(context_manager.exception))
+        self.assertEqual(expected_rc, context_manager.exception.code)
+
+    @patch('builtins.print')
+    # As we mock print(), to sys.stdout.write('...\n') needs to be used instead.
+    def test_abort_msg_list(self, mock_print) -> None:
+        expected_rc = random.randint(1, 255)
+        msgs_cnt = random.randint(1, 10)
+        msgs = self.get_random_string_list(msgs_cnt)
+        with self.assertRaises(SystemExit) as context_manager:
+            Utils.abort(msgs, expected_rc)
+
+        # Ensure our messages were printed in given order
+        exp_calls = [call(msg) for msg in msgs]
+        mock_print.assert_has_calls(exp_calls)
+
+        # Check we got sys.exit called with our return code.
+        self.assertEqual(SystemExit, type(context_manager.exception))
+        self.assertEqual(expected_rc, context_manager.exception.code)
+
     def test_add_if_not_in_list(self) -> None:
         count = 10
         srcs = self.get_random_string_list(count)

From 9d812290c915028c2e357bf7575b906b489b3a7e Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 25 Jul 2021 18:36:05 +0200
Subject: [PATCH 018/140] Removed *** prefix from Log.abort() default msg

---
 proptool/log.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/proptool/log.py b/proptool/log.py
index 0def684f..fc015786 100644
--- a/proptool/log.py
+++ b/proptool/log.py
@@ -237,7 +237,7 @@ def d(messages = None, condition: bool = True) -> None:
     @staticmethod
     def abort(messages = None) -> None:
         Log.e(messages)
-        Log.init('*** Aborted', Log.COLOR_ERROR, ignore_quiet = True)
+        Log.init('Aborted', Log.COLOR_ERROR, ignore_quiet = True)
 
         if not Log.debug:
             sys.exit(1)

From 3ad2358da596d65004e19bfc1d554fd57cf8b8d6 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 25 Jul 2021 18:54:59 +0200
Subject: [PATCH 019/140] Added default abort() return code const

---
 proptool/log.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/proptool/log.py b/proptool/log.py
index fc015786..63f542cf 100644
--- a/proptool/log.py
+++ b/proptool/log.py
@@ -89,6 +89,11 @@ class Log(object):
 
     # #################################################################################################
 
+    # Default return code passed to sys.exit() on abort() call
+    ABORT_RC = 10
+
+    # #################################################################################################
+
     @classmethod
     def configure(cls, config: Config) -> None:
         cls.buffer_enabled = True
@@ -240,7 +245,7 @@ def abort(messages = None) -> None:
         Log.init('Aborted', Log.COLOR_ERROR, ignore_quiet = True)
 
         if not Log.debug:
-            sys.exit(1)
+            sys.exit(Log.ABORT_RC)
 
         Log.d('Related stacktrace below')
         raise RuntimeError('*** NOT A CRASH! *** Exception raised because of --debug used to obtain stacktrace. Enjoy.')

From 0666d12e26c179ad251561fce5e66ce707fd43a9 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 25 Jul 2021 18:55:21 +0200
Subject: [PATCH 020/140] Added some ConfigBuilder() tests.

---
 tests/config/test_config_builder.py | 63 +++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 tests/config/test_config_builder.py

diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
new file mode 100644
index 00000000..01563639
--- /dev/null
+++ b/tests/config/test_config_builder.py
@@ -0,0 +1,63 @@
+"""
+# prop-tool
+# Java *.properties file sync checker and syncing tool.
+#
+# Copyright ©2021 Marcin Orlowski <mail [@] MarcinOrlowski.com>
+# https://github.com/MarcinOrlowski/prop-tool/
+#
+"""
+from pathlib import Path
+from unittest.mock import call, patch
+
+from proptool.config.config import Config
+from proptool.config.config_builder import ConfigBuilder
+from tests.test_case import TestCase
+
+
+class TestConfigBuilder(TestCase):
+
+    def get_config_for_validate(self) -> Config:
+        config = Config()
+
+        config.files = [Path('/tmp/')]
+        config.languages = ['pl']
+        config.separator = Config.ALLOWED_SEPARATORS[0]
+        config.comment_marker = Config.ALLOWED_COMMENT_MARKERS[0]
+
+        return config
+
+    def test_validate(self) -> None:
+        # This one should pass
+        ConfigBuilder._validate(self.get_config_for_validate())
+
+    @patch('proptool.log.Log.abort')
+    def test_validate_no_files(self, mock_log_abort) -> None:
+        config = self.get_config_for_validate()
+        config.files = []
+        ConfigBuilder._validate(config)
+        exp_calls = [call('No base file(s) specified.')]
+        mock_log_abort.assert_has_calls(exp_calls)
+
+    @patch('proptool.log.Log.abort')
+    def test_validate_no_languages(self, mock_print) -> None:
+        config = self.get_config_for_validate()
+        config.languages = []
+        ConfigBuilder._validate(config)
+        exp_calls = [call('No language(s) specified.')]
+        mock_print.assert_has_calls(exp_calls)
+
+    @patch('proptool.log.Log.abort')
+    def test_validate_invalid_separator(self, mock_print) -> None:
+        config = self.get_config_for_validate()
+        config.separator = ''
+        ConfigBuilder._validate(config)
+        exp_calls = [call('Invalid separator character.')]
+        mock_print.assert_has_calls(exp_calls)
+
+    @patch('proptool.log.Log.abort')
+    def test_validate_invalid_comment_marker(self, mock_print) -> None:
+        config = self.get_config_for_validate()
+        config.comment_marker = ''
+        ConfigBuilder._validate(config)
+        exp_prints = [call('Invalid comment marker.')]
+        mock_print.assert_has_calls(exp_prints)

From 71de07f3365330c47124ebf20271fb25d7542677 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 25 Jul 2021 19:04:56 +0200
Subject: [PATCH 021/140] Lint fixes

---
 .flake8                             |  6 ++++
 proptool/config/config_reader.py    |  2 +-
 tests/config/test_config_builder.py |  3 +-
 tests/test_utils.py                 | 46 +++++++++++++++--------------
 4 files changed, 33 insertions(+), 24 deletions(-)

diff --git a/.flake8 b/.flake8
index 22b5bb8a..fe8d6de0 100644
--- a/.flake8
+++ b/.flake8
@@ -20,6 +20,7 @@ exclude =
 
 # it's not a bug that we aren't using all of hacking
 ignore =
+
     D200, # D200 One-line docstring should fit on one line with quotes
     D205, # D205 1 blank line required between summary line and description
     D400, # D400 First line should end with a period
@@ -31,9 +32,11 @@ ignore =
     I004, # I004 isort found an unexpected blank line in imports
     RST213, # RST213 Inline emphasis start-string without end-string.
     W503, # W503 line break before binary operator
+    WPS114, # WPS114 Found underscored number name pattern: val_1
     WPS115, # WPS115 Found upper-case constant in a class
     WPS204, #WPS204 Found overused expression: config['opening']; used 5 > 4
     WPS211, # WPS211 Found too many arguments: 6 > 5
+    WPS214, # WPS214 Found too many methods: 9 > 7
     WPS237, # WPS237 Found a too complex `f` string
     WPS238, # WPS238 Found too many raises in a function: 5 > 3
     WPS300, # WPS300 Found local folder import
@@ -127,3 +130,6 @@ per-file-ignores =
     # WPS431 Found nested class: FakeArgs
     # WPS437 Found protected attribute usage: _set_on_off_option
     tests/report/test_config_builder.py: WPS431, WPS437,
+
+    # WPS437 Found protected attribute usage: _validate
+    tests/config/test_config_builder.py: WPS437,
diff --git a/proptool/config/config_reader.py b/proptool/config/config_reader.py
index 9f98087f..7f814841 100644
--- a/proptool/config/config_reader.py
+++ b/proptool/config/config_reader.py
@@ -6,7 +6,7 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
-import collections
+
 from configparser import ConfigParser
 from pathlib import Path
 from typing import Dict, List
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index 01563639..9de10610 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -19,7 +19,8 @@ class TestConfigBuilder(TestCase):
     def get_config_for_validate(self) -> Config:
         config = Config()
 
-        config.files = [Path('/tmp/')]
+        irrelevant_path = self.get_random_string()
+        config.files = [Path(irrelevant_path)]
         config.languages = ['pl']
         config.separator = Config.ALLOWED_SEPARATORS[0]
         config.comment_marker = Config.ALLOWED_COMMENT_MARKERS[0]
diff --git a/tests/test_utils.py b/tests/test_utils.py
index 4c0af3f6..5a214e36 100644
--- a/tests/test_utils.py
+++ b/tests/test_utils.py
@@ -6,8 +6,8 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+
 import random
-import unittest
 from unittest.mock import call, patch
 
 from proptool.utils import Utils
@@ -23,13 +23,14 @@ def test_abort_single_msg(self, mock_print) -> None:
         msg = self.get_random_string()
         with self.assertRaises(SystemExit) as context_manager:
             Utils.abort(msg, expected_rc)
-        # Ensure all messages are printed
-        exp_calls = [call(msg)]
-        mock_print.assert_has_calls(exp_calls)
 
-        # Check we got sys.exit called with our return code.
-        self.assertEqual(SystemExit, type(context_manager.exception))
-        self.assertEqual(expected_rc, context_manager.exception.code)
+            # Ensure all messages are printed
+            exp_calls = [call(msg)]
+            mock_print.assert_has_calls(exp_calls)
+
+            # Check we got sys.exit called with our return code.
+            self.assertEqual(SystemExit, type(context_manager.exception))
+            self.assertEqual(expected_rc, context_manager.exception.code)
 
     @patch('builtins.print')
     # As we mock print(), to sys.stdout.write('...\n') needs to be used instead.
@@ -40,13 +41,13 @@ def test_abort_msg_list(self, mock_print) -> None:
         with self.assertRaises(SystemExit) as context_manager:
             Utils.abort(msgs, expected_rc)
 
-        # Ensure our messages were printed in given order
-        exp_calls = [call(msg) for msg in msgs]
-        mock_print.assert_has_calls(exp_calls)
+            # Ensure our messages were printed in given order
+            exp_calls = [call(msg) for msg in msgs]
+            mock_print.assert_has_calls(exp_calls)
 
-        # Check we got sys.exit called with our return code.
-        self.assertEqual(SystemExit, type(context_manager.exception))
-        self.assertEqual(expected_rc, context_manager.exception.code)
+            # Check we got sys.exit called with our return code.
+            self.assertEqual(SystemExit, type(context_manager.exception))
+            self.assertEqual(expected_rc, context_manager.exception.code)
 
     def test_add_if_not_in_list(self) -> None:
         count = 10
@@ -56,14 +57,14 @@ def test_add_if_not_in_list(self) -> None:
         target = []
 
         # Try adding new elements
-        for item in srcs:
-            Utils.add_if_not_in_list(target, item)
+        for item_new in srcs:
+            Utils.add_if_not_in_list(target, item_new)
         # Check element count changed.
         self.assertEqual(len(target), len(srcs))
 
         # Try adding duplicates
-        for item in srcs:
-            Utils.add_if_not_in_list(target, item)
+        for item_dup in srcs:
+            Utils.add_if_not_in_list(target, item_dup)
         # Check element count is unaltered.
         self.assertEqual(count, len(target))
 
@@ -89,7 +90,8 @@ def test_add_if_not_in_list_args_types(self) -> None:
         with self.assertRaises(TypeError):
             Utils.add_if_not_in_list([], 123)
         with self.assertRaises(TypeError):
-            Utils.add_if_not_in_list([], False)
+            wrong_type = False
+            Utils.add_if_not_in_list([], wrong_type)
         with self.assertRaises(TypeError):
             Utils.add_if_not_in_list([], {})
 
@@ -109,8 +111,8 @@ def test_add_if_not_in_dict(self) -> None:
         self.assertEqual(count, len(src))
 
         # Try adding duplicates
-        for key, value in src.items():
-            self.assertFalse(Utils.add_if_not_in_dict(target, key, value))
+        for key_dup, value_dup in src.items():
+            self.assertFalse(Utils.add_if_not_in_dict(target, key_dup, value_dup))
         self.assertEqual(len(target), len(src))
 
     # #################################################################################################
@@ -120,7 +122,7 @@ def test_remove_quotes_str(self) -> None:
         src = [
             f'"{val}',
             f'"{val}"',
-            f'{val}"'
+            f'{val}"',
         ]
         for item in src:
             # It's expected to be handled by remove_quotes_str()
@@ -137,7 +139,7 @@ def test_remove_quotes_from_list(self) -> None:
         src = [
             f'"{val}',
             f'"{val}"',
-            f'{val}"'
+            f'{val}"',
         ]
         # It's expected to be handled by remove_quotes_from_list()
         result = Utils.remove_quotes(src)

From 132f2493ed5c82a97540fecd74992ecaa24d13b5 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 25 Jul 2021 19:42:44 +0200
Subject: [PATCH 022/140] Fixed import collision

---
 proptool/config/config_builder.py | 12 ++++--------
 proptool/config/config_reader.py  |  2 +-
 2 files changed, 5 insertions(+), 9 deletions(-)

diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 768f1250..a2fb4694 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -53,7 +53,7 @@ def build():
             config = ConfigReader().read(config, config_file)
 
         # override with command line arguments
-        config = ConfigBuilder._set_from_args(config, args)
+        ConfigBuilder._set_from_args(config, args)
 
         ConfigBuilder._validate(config)
 
@@ -71,7 +71,7 @@ def _validate(config: Config) -> None:
             Log.abort('Invalid comment marker.')
 
     @staticmethod
-    def _set_on_off_option(config: Config, args, option: str) -> Config:
+    def _set_on_off_option(config: Config, args, option: str) -> None:
         """
         Changes Config's entry if either --<option> or --<no-option> switch is set.
         If none is set, returns Config object unaltered.
@@ -86,14 +86,12 @@ def _set_on_off_option(config: Config, args, option: str) -> Config:
             val = False
         config.__setattr__(option, val)
 
-        return config
-
     @staticmethod
-    def _set_from_args(config: Config, args) -> Config:
+    def _set_from_args(config: Config, args) -> None:
         # At this point it is assumed that args are in valid state (i.e. no mutually exclusive options are both set etc).
 
         for option in ConfigBuilder._on_off_pairs:
-            config = ConfigBuilder._set_on_off_option(config, args, option)
+            ConfigBuilder._set_on_off_option(config, args, option)
 
         config.fix = args.fix
         config.languages = args.languages
@@ -115,8 +113,6 @@ def _set_from_args(config: Config, args) -> Config:
         if args.languages:
             Utils.add_if_not_in_list(config.languages, args.languages)
 
-        return config
-
     @staticmethod
     def _parse_args() -> argparse:
         parser = argparse.ArgumentParser(prog = Const.APP_NAME.lower(), formatter_class = argparse.RawTextHelpFormatter,
diff --git a/proptool/config/config_reader.py b/proptool/config/config_reader.py
index 7f814841..a14f0d22 100644
--- a/proptool/config/config_reader.py
+++ b/proptool/config/config_reader.py
@@ -18,7 +18,7 @@
 
 class ConfigReader(object):
     def __init__(self):
-        self.parser = configparser.ConfigParser()
+        self.parser = ConfigParser()
         # Prevent keys CaSe from being altered by default implementation.
         self.parser.optionxform = str
 

From c5feb27b797a7a4628e77561aa3cefb3bf845941 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 25 Jul 2021 22:47:07 +0200
Subject: [PATCH 023/140] Code cleanup and lint fixes

---
 proptool/checks/formatting_values.py          |  2 +-
 proptool/checks/quotation_marks.py            |  2 +-
 proptool/config/config_builder.py             |  5 +--
 proptool/config/config_reader.py              | 42 +++++++------------
 proptool/prop/file.py                         |  3 +-
 proptool/report/group.py                      |  2 +-
 tests/checks/test_base_check.py               |  1 +
 tests/checks/test_brackets.py                 |  3 +-
 tests/checks/test_empty_translations.py       |  3 ++
 .../test_typesetting_quotation_marks.py       |  3 +-
 tests/config/test_config_builder.py           | 21 ++++++++++
 tests/prop/test_items.py                      |  9 +++-
 tests/report/test_config_builder.py           | 32 --------------
 tests/test_utils.py                           |  4 ++
 14 files changed, 59 insertions(+), 73 deletions(-)
 delete mode 100644 tests/report/test_config_builder.py

diff --git a/proptool/checks/formatting_values.py b/proptool/checks/formatting_values.py
index f379ebe8..1b80b98c 100644
--- a/proptool/checks/formatting_values.py
+++ b/proptool/checks/formatting_values.py
@@ -31,7 +31,7 @@ class FormattingValues(Check):
     then translation uses it as well and in the same order.
     """
 
-    def _parse(self, item: str) -> List[str]:
+    def _parse(self, item: str) -> List[Formatter]:
         # https://docs.oracle.com/javase/7/docs/api/java/util/Formatter.html
         # %[argument_index$][flags][width][.precision]conversion
         result = []
diff --git a/proptool/checks/quotation_marks.py b/proptool/checks/quotation_marks.py
index d4efde42..9e629774 100644
--- a/proptool/checks/quotation_marks.py
+++ b/proptool/checks/quotation_marks.py
@@ -37,7 +37,7 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
 
         # NOTE: we do not support apostrophe, because i.e. in English it can be used in sentence: "Dogs' food"
         # Not sure how to deal with this (and I do not want to do dictionary match)
-        supported_marks: List[str] = {'"', '`'}
+        supported_marks: Set[str] = {'"', '`'}
 
         for line_idx, item in enumerate(translation_file.items):
             # Do not try to be clever and filter() data first, because line_number values will no longer be correct.
diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index a2fb4694..2be2da86 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -81,10 +81,9 @@ def _set_on_off_option(config: Config, args, option: str) -> None:
         :return:
         """
         if args.__getattribute__(option):
-            val = True
+            config.__setattr__(option, True)
         elif args.__getattribute__(f'no_{option}'):
-            val = False
-        config.__setattr__(option, val)
+            config.__setattr__(option, False)
 
     @staticmethod
     def _set_from_args(config: Config, args) -> None:
diff --git a/proptool/config/config_reader.py b/proptool/config/config_reader.py
index a14f0d22..efe12597 100644
--- a/proptool/config/config_reader.py
+++ b/proptool/config/config_reader.py
@@ -63,8 +63,8 @@ def read(self, config: Config, config_file_name: Path) -> Config:
             if self.parser.has_option(main_section, single_bool):
                 config.__setattr__(single_bool, self.parser.get(main_section, single_bool))
 
-        config.files = self._merge_if_exists(self.parser, config.files, main_section, 'files')
-        config.languages = self._merge_if_exists(self.parser, config.languages, main_section, 'languages')
+        self._merge_if_exists(self.parser, config.files, main_section, 'files')
+        self._merge_if_exists(self.parser, config.languages, main_section, 'languages')
 
         if config.debug:
             for attr_name in dir(config):
@@ -75,36 +75,22 @@ def read(self, config: Config, config_file_name: Path) -> Config:
 
     # #################################################################################################
 
-    def _merge_if_exists(self, config: ConfigParser, merge_into: List[str], config_section: str, config_option: str) -> List[str]:
-        if config.has_option(config_section, config_option):
-            return self._merge_list(merge_into, config_section, config_option)
-        return merge_into
+    def _merge_if_exists(self, parser: ConfigParser, target_list: List[str], config_section: str, config_option: str) -> None:
+        if parser.has_option(config_section, config_option):
+            self._merge_list(target_list, parser, config_section, config_option)
 
-    # #################################################################################################
+    def _merge_list(self, target_list, parser: ConfigParser, section: str, option: str) -> None:
+        if parser.has_option(section, option):
+            import json
+            new_list = json.loads(parser.get(section, option).replace('\n', ''))
+            Utils.add_if_not_in_list(target_list, Utils.remove_quotes(new_list))
 
-    def _merge_dict(self, old_dict: Dict, ini_parser: ConfigParser, section: str) -> Dict:
-        result = old_dict
+    # #################################################################################################
 
+    def _merge_dict(self, old_dict: Dict, ini_parser: ConfigParser, section: str):
         if ini_parser.has_section(section):
             new_dict = dict(ini_parser.items(section))
             if new_dict is None:
-                return result
-
+                return
             for key, value in new_dict.items():
-                value = Utils.remove_quotes(value)
-
-                # if key starts with "DEL " then value does not matter and such key is REMOVED from internal storage
-                if key[:4] == 'DEL ':
-                    key = key[4:]
-                    if key in result:
-                        if not section_name_shown:
-                            section_name_shown = True
-                        del result[key]
-                    continue
-
-                if key in old_dict and result[key] != value:
-                    if not section_name_shown:
-                        section_name_shown = True
-                result[key] = value
-
-        return result
+                old_dict[key] = Utils.remove_quotes(value)
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 0f555a23..abf5f719 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -70,7 +70,8 @@ def find_by_key(self, key: str) -> Union[Translation, None]:
         :param key: Translation key to look for.
         :return: Instance of PropTranslation or None.
         """
-        translations = list(filter(lambda entry: isinstance(entry, Translation), self.items))
+        # noinspection PyTypeChecker
+        translations: List[Translation] = list(filter(lambda entry: isinstance(entry, Translation), self.items))
         for item in translations:
             if item.key == key:
                 return item
diff --git a/proptool/report/group.py b/proptool/report/group.py
index 91f323d6..d71b7235 100644
--- a/proptool/report/group.py
+++ b/proptool/report/group.py
@@ -22,7 +22,7 @@ def __init__(self, label: str):
         self.warnings = 0
         self.errors = 0
 
-    def create(self, position: Union[str, None], msg: str, trans_key: Union[str, None] = None) -> None:
+    def create(self, position: Union[str, int, None], msg: str, trans_key: Union[str, None] = None) -> None:
         """
         Helper to create either Error() or Warn() items that share the message (to remove duplicated code and logic).
         If trans_key is None, it is assumed report message relates
diff --git a/tests/checks/test_base_check.py b/tests/checks/test_base_check.py
index 45e5adc0..b843310d 100644
--- a/tests/checks/test_base_check.py
+++ b/tests/checks/test_base_check.py
@@ -22,6 +22,7 @@ def test_constructor(self) -> None:
             # Check is abstract class, extending ABC meta, so ordinary
             # instantiation won't work.
             Check.__abstractmethods__ = frozenset()
+            # noinspection PyTypeChecker
             Check(False)
 
     def test_need_both_files_no_fault(self) -> None:
diff --git a/tests/checks/test_brackets.py b/tests/checks/test_brackets.py
index 88759c9d..e5cb0945 100644
--- a/tests/checks/test_brackets.py
+++ b/tests/checks/test_brackets.py
@@ -8,7 +8,6 @@
 """
 from typing import Union
 
-from proptool.checks.base.check import Check
 from proptool.checks.brackets import Brackets
 from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
@@ -19,7 +18,7 @@
 class ChecksBrackets(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Union[Config, None] = None) -> Check:
+    def get_checker(self, config: Union[Config, None] = None) -> Brackets:
         return Brackets(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_empty_translations.py b/tests/checks/test_empty_translations.py
index 498f53a4..21a1c7b7 100644
--- a/tests/checks/test_empty_translations.py
+++ b/tests/checks/test_empty_translations.py
@@ -51,12 +51,14 @@ def test_if_both_are_empty(self) -> None:
         while processed > 0:
             idx = random.randint(0, key_cnt - 1)
 
+            # noinspection PyTypeChecker
             ref: Translation = ref_file.items[idx]
             if ref.value != '':
                 max_spaces = 3
                 ref.value = ' ' * random.randint(0, max_spaces)
                 ref_file.items[idx] = ref
 
+                # noinspection PyTypeChecker
                 trans: Translation = trans_file.items[idx]
                 trans.value = ''
                 trans_file.items[idx] = trans
@@ -109,6 +111,7 @@ def test_translation_with_faults(self) -> None:
         processed = how_many
         while processed > 0:
             idx = random.randint(0, key_cnt - 1)
+            # noinspection PyTypeChecker
             trans: Translation = trans_file.items[idx]
             if trans.value != '':
                 trans.value = ''
diff --git a/tests/checks/test_typesetting_quotation_marks.py b/tests/checks/test_typesetting_quotation_marks.py
index e28e724c..2d352d75 100644
--- a/tests/checks/test_typesetting_quotation_marks.py
+++ b/tests/checks/test_typesetting_quotation_marks.py
@@ -8,7 +8,6 @@
 """
 from typing import Union
 
-from proptool.checks.base.check import Check
 from proptool.checks.typesetting_quotation_marks import TypesettingQuotationMarks
 from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
@@ -19,7 +18,7 @@
 class ChecksBrackets(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Union[Config, None] = None) -> Check:
+    def get_checker(self, config: Union[Config, None] = None) -> TypesettingQuotationMarks:
         return TypesettingQuotationMarks(config)
 
     # #################################################################################################
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index 9de10610..3e65c50c 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -62,3 +62,24 @@ def test_validate_invalid_comment_marker(self, mock_print) -> None:
         ConfigBuilder._validate(config)
         exp_prints = [call('Invalid comment marker.')]
         mock_print.assert_has_calls(exp_prints)
+
+    # #################################################################################################
+
+    def test_set_on_off_option(self) -> None:
+        class FakeArgs(Config):
+            def __init__(self):
+                super().__init__()
+                self.option = False
+                self.no_option = True
+
+        config = Config()
+        config.option = True
+        self.assertTrue(config.option)
+        args = FakeArgs()
+        ConfigBuilder._set_on_off_option(config, args, 'option')
+        self.assertFalse(config.option)
+
+        args.option = True
+        args.no_option = False
+        ConfigBuilder._set_on_off_option(config, args, 'option')
+        self.assertTrue(config.option)
diff --git a/tests/prop/test_items.py b/tests/prop/test_items.py
index d457025d..61f32496 100644
--- a/tests/prop/test_items.py
+++ b/tests/prop/test_items.py
@@ -38,8 +38,10 @@ def test_translation_invalid_key_type(self) -> None:
         """
         value = self.get_random_string()
         with self.assertRaises(ValueError):
+            # noinspection PyTypeChecker
             Translation(123, value)
         with self.assertRaises(ValueError):
+            # noinspection PyTypeChecker
             Translation(None, value)
 
     def test_translation_empty_key(self) -> None:
@@ -59,12 +61,14 @@ def test_translation_empty_key_after_strip(self) -> None:
             Translation('   ', value)
 
     def test_translation_invalid_value_type(self) -> None:
-        key = self.get_random_string()
-        value = self.get_random_string()
         with self.assertRaises(ValueError):
             key = self.get_random_string()
+            # noinspection PyTypeChecker
             Translation(key, 1234)
+
+        value = self.get_random_string()
         with self.assertRaises(ValueError):
+            # noinspection PyTypeChecker
             Translation(key, value, None)
 
     def test_translation_invalid_separator(self) -> None:
@@ -101,6 +105,7 @@ def test_comment_constructor(self) -> None:
     def test_comment_invalid_value(self) -> None:
         with self.assertRaises(ValueError):
             # Invalid value type
+            # noinspection PyTypeChecker
             Comment(1234)
 
         with self.assertRaises(ValueError):
diff --git a/tests/report/test_config_builder.py b/tests/report/test_config_builder.py
deleted file mode 100644
index 52b2e0e5..00000000
--- a/tests/report/test_config_builder.py
+++ /dev/null
@@ -1,32 +0,0 @@
-"""
-# prop-tool
-# Java *.properties file sync checker and syncing tool.
-#
-# Copyright ©2021 Marcin Orlowski <mail [@] MarcinOrlowski.com>
-# https://github.com/MarcinOrlowski/prop-tool/
-#
-"""
-from proptool.config.config_builder import ConfigBuilder
-from proptool.config.config import Config
-from tests.test_case import TestCase
-
-
-class TestConfigBuilder(TestCase):
-
-    def test_set_on_off_option(self) -> None:
-        class FakeArgs(Config):
-            def __init__(self):
-                self.option = False
-                self.no_option = True
-
-        config = Config()
-        config.option = True
-        self.assertTrue(config.option)
-        args = FakeArgs()
-        ConfigBuilder._set_on_off_option(config, args, 'option')
-        self.assertFalse(config.option)
-
-        args.option = True
-        args.no_option = False
-        ConfigBuilder._set_on_off_option(config, args, 'option')
-        self.assertTrue(config.option)
diff --git a/tests/test_utils.py b/tests/test_utils.py
index 5a214e36..899920b6 100644
--- a/tests/test_utils.py
+++ b/tests/test_utils.py
@@ -88,11 +88,14 @@ def test_add_if_not_in_list_args_types(self) -> None:
 
         # These shall not pass
         with self.assertRaises(TypeError):
+            # noinspection PyTypeChecker
             Utils.add_if_not_in_list([], 123)
         with self.assertRaises(TypeError):
             wrong_type = False
+            # noinspection PyTypeChecker
             Utils.add_if_not_in_list([], wrong_type)
         with self.assertRaises(TypeError):
+            # noinspection PyTypeChecker
             Utils.add_if_not_in_list([], {})
 
     # #################################################################################################
@@ -175,6 +178,7 @@ def test_remove_quotes_from_dict(self) -> None:
 
     def test_remove_quotes_with_unsupported_arg(self) -> None:
         with self.assertRaises(TypeError):
+            # noinspection PyTypeChecker
             Utils.remove_quotes(123)
 
     # #################################################################################################

From ea1fb585357ca781748a41bae377a780ec71550f Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 00:04:11 +0200
Subject: [PATCH 024/140] Added ConfigBuilder tests

---
 proptool/config/config_builder.py   | 66 ++++++++++++++++-----------
 tests/config/test_config_builder.py | 71 +++++++++++++++++++++++++++++
 tests/test_case.py                  | 17 ++++++-
 3 files changed, 127 insertions(+), 27 deletions(-)

diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 2be2da86..7177d49f 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -11,6 +11,7 @@
 import inspect
 from os import listdir
 from pathlib import Path
+from typing import List, Union
 
 import proptool.checks
 from proptool.checks.base.check import Check
@@ -71,47 +72,61 @@ def _validate(config: Config) -> None:
             Log.abort('Invalid comment marker.')
 
     @staticmethod
-    def _set_on_off_option(config: Config, args, option: str) -> None:
+    def _set_on_off_option(config: Config, args, option_name: str) -> None:
         """
         Changes Config's entry if either --<option> or --<no-option> switch is set.
         If none is set, returns Config object unaltered.
         :param config:
         :param args:
-        :param option:
+        :param option_name:
         :return:
         """
-        if args.__getattribute__(option):
-            config.__setattr__(option, True)
-        elif args.__getattribute__(f'no_{option}'):
-            config.__setattr__(option, False)
+        if args.__getattribute__(option_name):
+            config.__setattr__(option_name, True)
+        elif args.__getattribute__(f'no_{option_name}'):
+            config.__setattr__(option_name, False)
 
     @staticmethod
     def _set_from_args(config: Config, args) -> None:
-        # At this point it is assumed that args are in valid state (i.e. no mutually exclusive options are both set etc).
-
-        for option in ConfigBuilder._on_off_pairs:
-            ConfigBuilder._set_on_off_option(config, args, option)
+        # At this point it is assumed that args are in valid state, i.e. no mutually
+        # exclusive options are both set etc.
+        for option_name in ConfigBuilder._on_off_pairs:
+            ConfigBuilder._set_on_off_option(config, args, option_name)
 
+        # cmd fix
         config.fix = args.fix
-        config.languages = args.languages
 
-        config.separator = args.separator
-        config.comment_marker = args.comment
-        config.comment_template = args.comment_template
-
-        # base files
-        suffix = '.properties'
-        suffix_len = len(suffix)
-        if args.files:
-            for file in args.files:
-                if file[suffix_len * -1:] != suffix:
-                    file += suffix
-                Utils.add_if_not_in_list(config.files, str(Path(file)))
+        # Set optional args, if set by user.
+        optionals = [
+            'separator',
+            'comment_marker',
+            'comment_template',
+        ]
+        for option_name in optionals:
+            opt_val = args.__getattribute__(option_name)
+            if opt_val is not None:
+                config.__setattr__(option_name, opt_val)
 
         # languages
         if args.languages:
             Utils.add_if_not_in_list(config.languages, args.languages)
 
+        # base files
+        if args.files:
+            ConfigBuilder._add_file_suffix(args.files)
+            Utils.add_if_not_in_list(config.files, args.files)
+
+    @staticmethod
+    def _add_file_suffix(files: Union[List[Path], None]) -> None:
+        if files:
+            suffix = '.properties'
+            suffix_len = len(suffix)
+            for idx, file in enumerate(files):
+                # 'PosixPath' object is not subscriptable, so we cannot slice it.
+                path_str = str(file)
+                if path_str[suffix_len * -1:] != suffix:
+                    files[idx] = Path(f'{path_str}{suffix}')
+
     @staticmethod
     def _parse_args() -> argparse:
         parser = argparse.ArgumentParser(prog = Const.APP_NAME.lower(), formatter_class = argparse.RawTextHelpFormatter,
@@ -130,14 +145,13 @@ def _parse_args() -> argparse:
                            help = 'Updated translation files in-place. No backup!')
         # group.add_argument('--pe', '--punctuation-exception', dest = 'punctuation_exception_langs', nargs = '*', metavar = 'LANG',
         #                    help = 'List of languages for which punctuation mismatch should not be checked for, i.e. "jp"')
-        group.add_argument('--separator', action = 'store', dest = 'separator', metavar = 'CHAR', nargs = 1, default = '=',
+        group.add_argument('--separator', action = 'store', dest = 'separator', metavar = 'CHAR', nargs = 1,
                            help = 'If specified, only given CHAR is considered a valid key/value separator.'
                                   + f'Must be one of the following: {", ".join(Config.ALLOWED_SEPARATORS)}')
-        group.add_argument('--comment', action = 'store', dest = 'comment', metavar = 'CHAR', nargs = 1, default = '#',
+        group.add_argument('--comment', action = 'store', dest = 'comment', metavar = 'CHAR', nargs = 1,
                            help = 'If specified, only given CHAR is considered valid comment marker.'
                                   + f'Must be one of the following: {", ".join(Config.ALLOWED_COMMENT_MARKERS)}')
         group.add_argument('-t', '--template', action = 'store', dest = 'comment_template', metavar = 'TEMPLATE', nargs = 1,
-                           default = Config.DEFAULT_COMMENT_TEMPLATE,
                            help = f'Format of commented-out entries. Default: "{Config.DEFAULT_COMMENT_TEMPLATE}".')
 
         group = parser.add_argument_group('Checks controlling options')
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index 3e65c50c..349ff7fe 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -6,7 +6,10 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+import copy
+import random
 from pathlib import Path
+from typing import List, Union
 from unittest.mock import call, patch
 
 from proptool.config.config import Config
@@ -83,3 +86,71 @@ def __init__(self):
         args.no_option = False
         ConfigBuilder._set_on_off_option(config, args, 'option')
         self.assertTrue(config.option)
+
+    # #################################################################################################
+
+    def test_set_from_args(self) -> None:
+        class FakeArgs(object):
+            def __init__(self):
+                self.fix: bool = False
+
+                self.files: List[str] = []
+                self.languages: List[str] = []
+                self.separator: Union[str, None] = None
+                self.comment_marker: Union[str, None] = None
+                self.comment_template: Union[str, None] = None
+
+                # Initialize all on/off flags related attributes.
+                for option_name in ConfigBuilder._on_off_pairs:
+                    self.__setattr__(option_name, False)
+                    self.__setattr__(f'no_{option_name}', False)
+
+        args = FakeArgs()
+        args.fix = self.get_random_bool()
+
+        args.fatal, args.no_fatal = self.get_random_on_off_pair()
+        args.strict, args.no_strict = self.get_random_on_off_pair()
+        args.quiet, args.no_quiet = self.get_random_on_off_pair()
+        args.verbose, args.no_vebose = self.get_random_on_off_pair()
+        args.color, args.no_color = self.get_random_on_off_pair()
+
+        # Generate some names with .properties suffix
+        args.files = [Path(f'{self.get_random_string()}.properties') for _ in range(1, 10)]
+
+        config = Config()
+        ConfigBuilder._set_from_args(config, args)
+
+        # Ensure config reflects changes from command line
+        exp_fatal = True if args.fatal or args.no_fatal else config.fatal
+        self.assertEqual(exp_fatal, config.fatal)
+        exp_strict = True if args.strict or args.no_strict else config.strict
+        self.assertEqual(exp_strict, config.strict)
+        exp_quiet = True if args.quiet or args.no_quiet else config.quiet
+        self.assertEqual(exp_quiet, config.quiet)
+        exp_verbose = True if args.verbose or args.no_vebose else config.verbose
+        self.assertEqual(exp_verbose, config.verbose)
+        exp_color = True if args.color or args.no_color else config.color
+        self.assertEqual(exp_color, config.color)
+
+        # ensure all files are now with proper suffix
+        for idx, args_file in enumerate(args.files):
+            self.assertEqual(config.files[idx], args_file)
+
+    # #################################################################################################
+
+    def test_add_file_suffix_missing_suffix(self) -> None:
+        # Generate some names with NO ".properties" suffix
+        srcs = [Path(self.get_random_string()) for _ in range(1, 10)]
+        dests = copy.copy(srcs)
+        ConfigBuilder._add_file_suffix(dests)
+        # Ensure nothing we got suffix added
+        for idx, src in enumerate(srcs):
+            self.assertEqual(f'{str(src)}.properties', str(dests[idx]))
+
+    def test_add_file_suffix_with_suffix(self) -> None:
+        # Generate some names with ".properties" suffix
+        srcs = [Path(f'{self.get_random_string()}.properties') for _ in range(1, 10)]
+        dests = copy.copy(srcs)
+        ConfigBuilder._add_file_suffix(dests)
+        # Ensure nothing gets altered
+        self.assertEqual(srcs, dests)
diff --git a/tests/test_case.py b/tests/test_case.py
index 38a49489..e2e23513 100644
--- a/tests/test_case.py
+++ b/tests/test_case.py
@@ -9,7 +9,7 @@
 
 import random
 import unittest
-from typing import List
+from typing import List, Tuple
 
 
 class TestCase(unittest.TestCase):
@@ -24,3 +24,18 @@ def get_random_string(self, prefix: str = '', length: int = 16) -> str:
                 single_char = single_char.lower()
             prefix += single_char
         return prefix
+
+    def get_random_bool(self) -> bool:
+        return True if random.randint(0, 1) == 1 else False
+
+    def get_random_on_off_pair(self) -> Tuple[bool, bool]:
+        """
+        Generates pair of two bools, where only one can be True at the time,
+        but both can be False. This is basically handy to simulate argparse
+        `--foo`/`--no-foo` options.
+        :return: tuple of two bools.
+        """
+        switch_a = self.get_random_bool()
+        # Only one switch can be set True
+        switch_b = False if not switch_a else self.get_random_bool()
+        return switch_a, switch_b

From 9b5e23a058fdc8d8a1b7cce915cb0d9d9ce8d8be Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 00:08:16 +0200
Subject: [PATCH 025/140] Default file suffix is now part of Config

---
 proptool/config/config.py           |  3 +++
 proptool/config/config_builder.py   | 11 +++++------
 tests/config/test_config_builder.py | 12 ++++++++----
 3 files changed, 16 insertions(+), 10 deletions(-)

diff --git a/proptool/config/config.py b/proptool/config/config.py
index bb6c733d..05f20619 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -15,8 +15,11 @@ class Config(object):
     ALLOWED_SEPARATORS: List[str] = ['=', ':']
     ALLOWED_COMMENT_MARKERS: List[str] = ['#', '!']
     DEFAULT_COMMENT_TEMPLATE: str = 'COM ==> KEY SEP'
+    DEFAULT_FILE_SUFFIX: str = '.properties'
 
     def __init__(self):
+        self.file_suffix = Config.DEFAULT_FILE_SUFFIX
+
         self.fatal = False
         self.strict: bool = False
 
diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 7177d49f..c27ddea0 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -113,19 +113,18 @@ def _set_from_args(config: Config, args) -> None:
 
         # base files
         if args.files:
-            ConfigBuilder._add_file_suffix(args.files)
+            ConfigBuilder._add_file_suffix(config, args.files)
             Utils.add_if_not_in_list(config.files, args.files)
 
     @staticmethod
-    def _add_file_suffix(files: Union[List[Path], None]) -> None:
+    def _add_file_suffix(config: Config, files: Union[List[Path], None]) -> None:
         if files:
-            suffix = '.properties'
-            suffix_len = len(suffix)
+            suffix_len = len(config.file_suffix)
             for idx, file in enumerate(files):
                 # 'PosixPath' object is not subscriptable, so we cannot slice it.
                 path_str = str(file)
-                if path_str[suffix_len * -1:] != suffix:
-                    files[idx] = Path(f'{path_str}{suffix}')
+                if path_str[suffix_len * -1:] != config.file_suffix:
+                    files[idx] = Path(f'{path_str}{config.file_suffix}')
 
     @staticmethod
     def _parse_args() -> argparse:
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index 349ff7fe..b3bfc256 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -139,18 +139,22 @@ def __init__(self):
     # #################################################################################################
 
     def test_add_file_suffix_missing_suffix(self) -> None:
+        config = Config()
+
         # Generate some names with NO ".properties" suffix
         srcs = [Path(self.get_random_string()) for _ in range(1, 10)]
         dests = copy.copy(srcs)
-        ConfigBuilder._add_file_suffix(dests)
+        ConfigBuilder._add_file_suffix(config, dests)
         # Ensure nothing we got suffix added
         for idx, src in enumerate(srcs):
-            self.assertEqual(f'{str(src)}.properties', str(dests[idx]))
+            self.assertEqual(f'{str(src)}{config.file_suffix}', str(dests[idx]))
 
     def test_add_file_suffix_with_suffix(self) -> None:
+        config = Config()
+
         # Generate some names with ".properties" suffix
-        srcs = [Path(f'{self.get_random_string()}.properties') for _ in range(1, 10)]
+        srcs = [Path(f'{self.get_random_string()}{config.file_suffix}') for _ in range(1, 10)]
         dests = copy.copy(srcs)
-        ConfigBuilder._add_file_suffix(dests)
+        ConfigBuilder._add_file_suffix(config, dests)
         # Ensure nothing gets altered
         self.assertEqual(srcs, dests)

From f95540978df66f9dad53ffa4ea4cc1d26ffdc5a2 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 00:23:35 +0200
Subject: [PATCH 026/140] Lint fixes

---
 .flake8                             | 15 ++++++++++++---
 proptool/config/config_builder.py   |  5 +++--
 tests/config/test_config_builder.py |  2 +-
 tests/test_case.py                  |  4 ++--
 4 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/.flake8 b/.flake8
index fe8d6de0..aa293c15 100644
--- a/.flake8
+++ b/.flake8
@@ -60,7 +60,10 @@ ignore =
     E241, # E241 multiple spaces after ':'
     F821, # F821 undefined name 'PropFile'
     I005, # I005 isort found an unexpected missing import
+
+    WPS201, # WPS201 Found module with too many imports: 13 > 12
     WPS210, # WPS210 Found too many local variables: 14 > 5
+    WPS213, # WPS213 Found too many expressions: 10 > 9
     WPS221, # WPS221 Found line with high Jones Complexity: 17 > 14
     WPS231, # WPS231 Found function with too much cognitive complexity: 83 > 12
     WPS232, # WPS232 Found module cognitive complexity that is too high: 27.7 > 8
@@ -89,8 +92,10 @@ per-file-ignores =
     # WPS437 Found protected attribute usage
     # WPS529 Found implicit `.get()` dict usage
     # WPS609 Found direct magic attribute usage: __setattr__, __getattr__, ...
-    proptool/config/config_reader.py: WPS609, WPS421, WPS204, WPS529,
-    proptool/config/config_builder.py: WPS609, WPS301, WPS437, WPS213,
+    # WPS433 Found nested import
+    # WPS425 Found boolean non-keyword argument: True, False
+    proptool/config/config_reader.py: WPS609, WPS421, WPS204, WPS529, WPS433,
+    proptool/config/config_builder.py: WPS609, WPS301, WPS437, WPS213, WPS425,
 
     # WPS111 Found too short name
     # WPS214 Found too many methods
@@ -131,5 +136,9 @@ per-file-ignores =
     # WPS437 Found protected attribute usage: _set_on_off_option
     tests/report/test_config_builder.py: WPS431, WPS437,
 
+    # WPS230 Found too many public instance attributes: 8 > 6
+    # WPS414 Found incorrect unpacking target
+    # WPS425 Found boolean non-keyword argument: True, False
+    # WPS431 Found nested class: FakeArgs
     # WPS437 Found protected attribute usage: _validate
-    tests/config/test_config_builder.py: WPS437,
+    tests/config/test_config_builder.py: WPS437, WPS425, WPS431, WPS230, WPS414,
diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index c27ddea0..0da8c314 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -6,6 +6,7 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+
 import argparse
 import importlib
 import inspect
@@ -90,8 +91,8 @@ def _set_on_off_option(config: Config, args, option_name: str) -> None:
     def _set_from_args(config: Config, args) -> None:
         # At this point it is assumed that args are in valid state, i.e. no mutually
         # exclusive options are both set etc.
-        for option_name in ConfigBuilder._on_off_pairs:
-            ConfigBuilder._set_on_off_option(config, args, option_name)
+        for pair_option_name in ConfigBuilder._on_off_pairs:
+            ConfigBuilder._set_on_off_option(config, args, pair_option_name)
 
         # cmd fix
         config.fix = args.fix
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index b3bfc256..c15d8d36 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -6,8 +6,8 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+
 import copy
-import random
 from pathlib import Path
 from typing import List, Union
 from unittest.mock import call, patch
diff --git a/tests/test_case.py b/tests/test_case.py
index e2e23513..99450cd3 100644
--- a/tests/test_case.py
+++ b/tests/test_case.py
@@ -26,7 +26,7 @@ def get_random_string(self, prefix: str = '', length: int = 16) -> str:
         return prefix
 
     def get_random_bool(self) -> bool:
-        return True if random.randint(0, 1) == 1 else False
+        return random.randint(0, 1) == 1
 
     def get_random_on_off_pair(self) -> Tuple[bool, bool]:
         """
@@ -37,5 +37,5 @@ def get_random_on_off_pair(self) -> Tuple[bool, bool]:
         """
         switch_a = self.get_random_bool()
         # Only one switch can be set True
-        switch_b = False if not switch_a else self.get_random_bool()
+        switch_b = False if switch_a else self.get_random_bool()
         return switch_a, switch_b

From ac2a08d0d65cc5a2a2caaed06bd90c825b317bed Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 00:24:03 +0200
Subject: [PATCH 027/140] Lint fixes

---
 .flake8 | 18 ++++++++----------
 1 file changed, 8 insertions(+), 10 deletions(-)

diff --git a/.flake8 b/.flake8
index aa293c15..d37487a9 100644
--- a/.flake8
+++ b/.flake8
@@ -20,16 +20,23 @@ exclude =
 
 # it's not a bug that we aren't using all of hacking
 ignore =
-
+    D101, # D101 Missing docstring in public class
+    D102, # D102 Missing docstring in public method
+    D107, # D107 Missing docstring in __init__
     D200, # D200 One-line docstring should fit on one line with quotes
     D205, # D205 1 blank line required between summary line and description
     D400, # D400 First line should end with a period
     D401, # D401 First line should be in imperative mood
+    DAR101, # DAR101 Missing parameter(s) in Docstring
+    DAR201, # DAR201 Missing "Returns" in Docstring: - return
     DAR401, # DAR401 Missing exception(s) in Raises section: -r TypeError
+    E241, # E241 multiple spaces after ':'
     E251, # E251 unexpected spaces around keyword / parameter equals
+    F821, # F821 undefined name 'PropFile'
     I001, # I001 isort found an import in the wrong position
     I003, # I003 isort expected 1 blank line in imports, found
     I004, # I004 isort found an unexpected blank line in imports
+    I005, # I005 isort found an unexpected missing import
     RST213, # RST213 Inline emphasis start-string without end-string.
     W503, # W503 line break before binary operator
     WPS114, # WPS114 Found underscored number name pattern: val_1
@@ -52,15 +59,6 @@ ignore =
     WPS604, # WPS604 Found incorrect node inside `class` body
     WPS615, # WPS615 Found unpythonic getter or setter
 
-    D101, # D101 Missing docstring in public class
-    D102, # D102 Missing docstring in public method
-    D107, # D107 Missing docstring in __init__
-    DAR101, # DAR101 Missing parameter(s) in Docstring
-    DAR201, # DAR201 Missing "Returns" in Docstring: - return
-    E241, # E241 multiple spaces after ':'
-    F821, # F821 undefined name 'PropFile'
-    I005, # I005 isort found an unexpected missing import
-
     WPS201, # WPS201 Found module with too many imports: 13 > 12
     WPS210, # WPS210 Found too many local variables: 14 > 5
     WPS213, # WPS213 Found too many expressions: 10 > 9

From b10d779f39b987a113e973b08d4d260140ef903f Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 00:24:39 +0200
Subject: [PATCH 028/140] Flake8 config cleanup

---
 .flake8 | 29 +++++++++++++----------------
 1 file changed, 13 insertions(+), 16 deletions(-)

diff --git a/.flake8 b/.flake8
index d37487a9..29a5ff44 100644
--- a/.flake8
+++ b/.flake8
@@ -39,41 +39,38 @@ ignore =
     I005, # I005 isort found an unexpected missing import
     RST213, # RST213 Inline emphasis start-string without end-string.
     W503, # W503 line break before binary operator
+    WPS110, # WPS110 Found wrong variable name: item
     WPS114, # WPS114 Found underscored number name pattern: val_1
     WPS115, # WPS115 Found upper-case constant in a class
+    WPS201, # WPS201 Found module with too many imports: 13 > 12
     WPS204, #WPS204 Found overused expression: config['opening']; used 5 > 4
+    WPS210, # WPS210 Found too many local variables: 14 > 5
     WPS211, # WPS211 Found too many arguments: 6 > 5
+    WPS213, # WPS213 Found too many expressions: 10 > 9
     WPS214, # WPS214 Found too many methods: 9 > 7
+    WPS220, # WPS220 Found too deep nesting: 28 > 20
+    WPS221, # WPS221 Found line with high Jones Complexity: 17 > 14
+    WPS226, # WPS226 Found string constant over-use: " > 3
+    WPS231, # WPS231 Found function with too much cognitive complexity: 83 > 12
+    WPS232, # WPS232 Found module cognitive complexity that is too high: 27.7 > 8
     WPS237, # WPS237 Found a too complex `f` string
     WPS238, # WPS238 Found too many raises in a function: 5 > 3
     WPS300, # WPS300 Found local folder import
     WPS302, # WPS302 Found unicode string prefix
     WPS305, # WPS305 Found `f` string
     WPS317, # WPS317 Found incorrect multi-line parameters
+    WPS318, # WPS318 Found extra indentation
+    WPS319, # WPS319 Found bracket in wrong position
     WPS336, # WPS336 Found explicit string concatenation
+    WPS338, # WPS338 Found incorrect order of methods in a class
     WPS360, # WPS360 Found an unnecessary use of a raw string
     WPS420, # WPS420 Found wrong keyword: pass
     WPS442, # WPS442 Found outer scope names shadowing:
     WPS600, # I001 isort found an import in the wrong position
     WPS602, # WPS602 Found using `@staticmethod`
     WPS604, # WPS604 Found incorrect node inside `class` body
-    WPS615, # WPS615 Found unpythonic getter or setter
-
-    WPS201, # WPS201 Found module with too many imports: 13 > 12
-    WPS210, # WPS210 Found too many local variables: 14 > 5
-    WPS213, # WPS213 Found too many expressions: 10 > 9
-    WPS221, # WPS221 Found line with high Jones Complexity: 17 > 14
-    WPS231, # WPS231 Found function with too much cognitive complexity: 83 > 12
-    WPS232, # WPS232 Found module cognitive complexity that is too high: 27.7 > 8
-    WPS338, # WPS338 Found incorrect order of methods in a class
-
-    WPS110, # WPS110 Found wrong variable name: item
-    WPS220, # WPS220 Found too deep nesting: 28 > 20
-    WPS226, # WPS226 Found string constant over-use: " > 3
     WPS605, # WPS605 Found method without arguments
-
-    WPS318, # WPS318 Found extra indentation
-    WPS319, # WPS319 Found bracket in wrong position
+    WPS615, # WPS615 Found unpythonic getter or setter
 
 per-file-ignores =
     # WPS420 Found wrong keyword: pass

From 09298508880dc50c5c9c1f996bd9182c53fa9a54 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 00:34:35 +0200
Subject: [PATCH 029/140] Fixed test_set_from_args() test

---
 tests/config/test_config_builder.py | 19 ++++++++++++++-----
 tests/test_case.py                  |  3 ++-
 2 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index c15d8d36..ab699b14 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -89,6 +89,14 @@ def __init__(self):
 
     # #################################################################################################
 
+    def get_expectation(self, config_default: bool, switch_on: bool, switch_off: bool) -> bool:
+        result = config_default
+        if switch_on:
+            result = True
+        elif switch_off:
+            result = False
+        return result
+
     def test_set_from_args(self) -> None:
         class FakeArgs(object):
             def __init__(self):
@@ -117,19 +125,20 @@ def __init__(self):
         # Generate some names with .properties suffix
         args.files = [Path(f'{self.get_random_string()}.properties') for _ in range(1, 10)]
 
+        config_defaults = Config()
         config = Config()
         ConfigBuilder._set_from_args(config, args)
 
         # Ensure config reflects changes from command line
-        exp_fatal = True if args.fatal or args.no_fatal else config.fatal
+        exp_fatal = self.get_expectation(config_defaults.fatal, args.fatal, args.no_fatal)
         self.assertEqual(exp_fatal, config.fatal)
-        exp_strict = True if args.strict or args.no_strict else config.strict
+        exp_strict = self.get_expectation(config_defaults.strict, args.strict, args.no_strict)
         self.assertEqual(exp_strict, config.strict)
-        exp_quiet = True if args.quiet or args.no_quiet else config.quiet
+        exp_quiet = self.get_expectation(config_defaults.quiet, args.quiet, args.no_quiet)
         self.assertEqual(exp_quiet, config.quiet)
-        exp_verbose = True if args.verbose or args.no_vebose else config.verbose
+        exp_verbose = self.get_expectation(config_defaults.verbose, args.verbose, args.no_verbose)
         self.assertEqual(exp_verbose, config.verbose)
-        exp_color = True if args.color or args.no_color else config.color
+        exp_color = self.get_expectation(config_defaults.color, args.color, args.no_color)
         self.assertEqual(exp_color, config.color)
 
         # ensure all files are now with proper suffix
diff --git a/tests/test_case.py b/tests/test_case.py
index 99450cd3..ae37e2f6 100644
--- a/tests/test_case.py
+++ b/tests/test_case.py
@@ -36,6 +36,7 @@ def get_random_on_off_pair(self) -> Tuple[bool, bool]:
         :return: tuple of two bools.
         """
         switch_a = self.get_random_bool()
-        # Only one switch can be set True
         switch_b = False if switch_a else self.get_random_bool()
+        # Only one switch can be set True at the same time.
+        self.assertFalse(switch_a and switch_b)
         return switch_a, switch_b

From c1fef2d962c1c901e376d82ffb86b2b7bc7ed859 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 01:17:19 +0200
Subject: [PATCH 030/140] Simplified entry point

---
 proptool/main.py | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/proptool/main.py b/proptool/main.py
index e9617285..77c910c3 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -29,7 +29,8 @@
 
 class PropTool(object):
 
-    def main(self) -> int:
+    @staticmethod
+    def start() -> int:
         # Cannot rely on argparse here as we have required arguments there.
         if '--version' in sys.argv:
             Log.banner(Const.APP_DESCRIPTION)
@@ -90,8 +91,3 @@ def main(self) -> int:
             Log.pop()
 
         return 100 if errors else 0
-
-    @staticmethod
-    def start() -> int:
-        app = PropTool()
-        return app.main()

From 7437b10039e820e861ee7db22b7575729933680b Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 01:17:34 +0200
Subject: [PATCH 031/140] Corrected a typo

---
 tests/config/test_config_builder.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index ab699b14..dabfb609 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -119,7 +119,7 @@ def __init__(self):
         args.fatal, args.no_fatal = self.get_random_on_off_pair()
         args.strict, args.no_strict = self.get_random_on_off_pair()
         args.quiet, args.no_quiet = self.get_random_on_off_pair()
-        args.verbose, args.no_vebose = self.get_random_on_off_pair()
+        args.verbose, args.no_verbose = self.get_random_on_off_pair()
         args.color, args.no_color = self.get_random_on_off_pair()
 
         # Generate some names with .properties suffix

From 82b48065935e3a1398070d45f9bc602d201ed06d Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 01:23:57 +0200
Subject: [PATCH 032/140] Added missing __init__.py causing unittest to not
 discover ConfigBuilder tests.

---
 tests/config/__init__.py | 8 ++++++++
 1 file changed, 8 insertions(+)
 create mode 100644 tests/config/__init__.py

diff --git a/tests/config/__init__.py b/tests/config/__init__.py
new file mode 100644
index 00000000..fee132ff
--- /dev/null
+++ b/tests/config/__init__.py
@@ -0,0 +1,8 @@
+"""
+# prop-tool
+# Java *.properties file sync checker and syncing tool.
+#
+# Copyright ©2021 Marcin Orlowski <mail [@] MarcinOrlowski.com>
+# https://github.com/MarcinOrlowski/prop-tool/
+#
+"""

From f98f9f735b91fae11baea28f401eb4e65abb1058 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 01:24:05 +0200
Subject: [PATCH 033/140] Added class comments

---
 tests/checks/test_base_check.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/tests/checks/test_base_check.py b/tests/checks/test_base_check.py
index b843310d..556262d7 100644
--- a/tests/checks/test_base_check.py
+++ b/tests/checks/test_base_check.py
@@ -13,6 +13,9 @@
 
 
 class TestBaseCheck(TestCase):
+    """
+    Tests base class of all Checks.
+    """
 
     def test_constructor(self) -> None:
         """

From fdf36a1c2f1bf9f72df9f2f1ec05ad9acca6ab53 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 01:25:48 +0200
Subject: [PATCH 034/140] Renamed ConfigBuilder method

---
 proptool/config/config_builder.py   |  4 ++--
 tests/config/test_config_builder.py | 10 +++++-----
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 0da8c314..3fa67c5b 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -57,12 +57,12 @@ def build():
         # override with command line arguments
         ConfigBuilder._set_from_args(config, args)
 
-        ConfigBuilder._validate(config)
+        ConfigBuilder._validate_config(config)
 
         return config
 
     @staticmethod
-    def _validate(config: Config) -> None:
+    def _validate_config(config: Config) -> None:
         if not config.files:
             Log.abort('No base file(s) specified.')
         if not config.languages:
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index dabfb609..8f2468ca 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -32,13 +32,13 @@ def get_config_for_validate(self) -> Config:
 
     def test_validate(self) -> None:
         # This one should pass
-        ConfigBuilder._validate(self.get_config_for_validate())
+        ConfigBuilder._validate_config(self.get_config_for_validate())
 
     @patch('proptool.log.Log.abort')
     def test_validate_no_files(self, mock_log_abort) -> None:
         config = self.get_config_for_validate()
         config.files = []
-        ConfigBuilder._validate(config)
+        ConfigBuilder._validate_config(config)
         exp_calls = [call('No base file(s) specified.')]
         mock_log_abort.assert_has_calls(exp_calls)
 
@@ -46,7 +46,7 @@ def test_validate_no_files(self, mock_log_abort) -> None:
     def test_validate_no_languages(self, mock_print) -> None:
         config = self.get_config_for_validate()
         config.languages = []
-        ConfigBuilder._validate(config)
+        ConfigBuilder._validate_config(config)
         exp_calls = [call('No language(s) specified.')]
         mock_print.assert_has_calls(exp_calls)
 
@@ -54,7 +54,7 @@ def test_validate_no_languages(self, mock_print) -> None:
     def test_validate_invalid_separator(self, mock_print) -> None:
         config = self.get_config_for_validate()
         config.separator = ''
-        ConfigBuilder._validate(config)
+        ConfigBuilder._validate_config(config)
         exp_calls = [call('Invalid separator character.')]
         mock_print.assert_has_calls(exp_calls)
 
@@ -62,7 +62,7 @@ def test_validate_invalid_separator(self, mock_print) -> None:
     def test_validate_invalid_comment_marker(self, mock_print) -> None:
         config = self.get_config_for_validate()
         config.comment_marker = ''
-        ConfigBuilder._validate(config)
+        ConfigBuilder._validate_config(config)
         exp_prints = [call('Invalid comment marker.')]
         mock_print.assert_has_calls(exp_prints)
 

From 47ae39006898b7cdc18190f7b34f5a75c44f97b7 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 01:36:21 +0200
Subject: [PATCH 035/140] Moved FakeArgs class

---
 proptool/config/config_builder.py   |  8 +++--
 tests/config/test_config_builder.py | 46 ++++++++++++++++++-----------
 2 files changed, 35 insertions(+), 19 deletions(-)

diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 3fa67c5b..7b4ccd96 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -190,6 +190,12 @@ def _parse_args() -> argparse:
 
         args = parser.parse_args()
 
+        ConfigBuilder._validate_args(parser, args)
+
+        return args
+
+    @staticmethod
+    def _validate_args(parser, args):
         # Check use of mutually exclusive pairs
         for key in ConfigBuilder._on_off_pairs:
             if args.__getattribute__(key) and args.__getattribute__(f'no_{key}'):
@@ -209,5 +215,3 @@ def _parse_args() -> argparse:
         for placeholder in ('COM', 'SEP', 'KEY'):
             if args.comment_template.find(placeholder) == -1:
                 parser.error(f'Missing literal in comment template: "{placeholder}".')
-
-        return args
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index 8f2468ca..1cc05f67 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -6,7 +6,7 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
-
+import argparse
 import copy
 from pathlib import Path
 from typing import List, Union
@@ -19,6 +19,21 @@
 
 class TestConfigBuilder(TestCase):
 
+    class FakeArgs(object):
+        def __init__(self):
+            self.fix: bool = False
+
+            self.files: List[str] = []
+            self.languages: List[str] = []
+            self.separator: Union[str, None] = None
+            self.comment_marker: Union[str, None] = None
+            self.comment_template: Union[str, None] = None
+
+            # Initialize all on/off flags related attributes.
+            for option_name in ConfigBuilder._on_off_pairs:
+                self.__setattr__(option_name, False)
+                self.__setattr__(f'no_{option_name}', False)
+
     def get_config_for_validate(self) -> Config:
         config = Config()
 
@@ -69,23 +84,20 @@ def test_validate_invalid_comment_marker(self, mock_print) -> None:
     # #################################################################################################
 
     def test_set_on_off_option(self) -> None:
-        class FakeArgs(Config):
-            def __init__(self):
-                super().__init__()
-                self.option = False
-                self.no_option = True
-
         config = Config()
-        config.option = True
-        self.assertTrue(config.option)
-        args = FakeArgs()
-        ConfigBuilder._set_on_off_option(config, args, 'option')
-        self.assertFalse(config.option)
-
-        args.option = True
-        args.no_option = False
-        ConfigBuilder._set_on_off_option(config, args, 'option')
-        self.assertTrue(config.option)
+        config.verbose = True
+
+        self.assertTrue(config.verbose)
+        args = TestConfigBuilder.FakeArgs()
+        args.verbose = False
+        args.no_verbose = True
+        ConfigBuilder._set_on_off_option(config, args, 'verbose')
+        self.assertFalse(config.verbose)
+
+        args.verbose = True
+        args.no_verbose = False
+        ConfigBuilder._set_on_off_option(config, args, 'verbose')
+        self.assertTrue(config.verbose)
 
     # #################################################################################################
 

From eb57ea5a2f5b21a04d3bc965bdb9afee0e83fd8e Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 10:36:08 +0200
Subject: [PATCH 036/140] Added more tests

---
 proptool/config/config.py           |  1 +
 proptool/config/config_builder.py   | 27 +++++-----
 tests/config/test_config_builder.py | 80 ++++++++++++++++++++++++++++-
 3 files changed, 92 insertions(+), 16 deletions(-)

diff --git a/proptool/config/config.py b/proptool/config/config.py
index 05f20619..580280ad 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -14,6 +14,7 @@ class Config(object):
 
     ALLOWED_SEPARATORS: List[str] = ['=', ':']
     ALLOWED_COMMENT_MARKERS: List[str] = ['#', '!']
+    COMMENT_TEMPLATE_LITERALS: List[str] = ['COM', 'KEY', 'SEP']
     DEFAULT_COMMENT_TEMPLATE: str = 'COM ==> KEY SEP'
     DEFAULT_FILE_SUFFIX: str = '.properties'
 
diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 7b4ccd96..9d7286ce 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -190,28 +190,27 @@ def _parse_args() -> argparse:
 
         args = parser.parse_args()
 
-        ConfigBuilder._validate_args(parser, args)
+        ConfigBuilder._validate_args(args)
 
         return args
 
     @staticmethod
-    def _validate_args(parser, args):
+    def _validate_args(args):
         # Check use of mutually exclusive pairs
-        for key in ConfigBuilder._on_off_pairs:
-            if args.__getattribute__(key) and args.__getattribute__(f'no_{key}'):
-                parser.error(f'You cannot use "--{key}" and "--no-{key}" at the same time.')
+        for option_name in ConfigBuilder._on_off_pairs:
+            if args.__getattribute__(option_name) and args.__getattribute__(f'no_{option_name}'):
+                Log.abort(f'You cannot use "--{option_name}" and "--no-{option_name}" at the same time.')
 
         # Separator character.
-        separator = args.separator[0]
-        if separator not in Config.ALLOWED_SEPARATORS:
-            parser.error(f'Invalid separator. Must be one of the following: {", ".join(Config.ALLOWED_SEPARATORS)}')
+        if args.separator and args.separator not in Config.ALLOWED_SEPARATORS:
+            Log.abort(f'Invalid separator. Must be one of the following: {", ".join(Config.ALLOWED_SEPARATORS)}')
 
         # Comment marker character.
-        comment = args.comment[0]
-        if comment not in Config.ALLOWED_COMMENT_MARKERS:
-            parser.error(f'Invalid comment marker. Must be one of the following: {", ".join(Config.ALLOWED_COMMENT_MARKERS)}')
+        if args.comment_marker and args.comment_marker not in Config.ALLOWED_COMMENT_MARKERS:
+            Log.abort(f'Invalid comment marker. Must be one of the following: {", ".join(Config.ALLOWED_COMMENT_MARKERS)}')
 
         # Comment template.
-        for placeholder in ('COM', 'SEP', 'KEY'):
-            if args.comment_template.find(placeholder) == -1:
-                parser.error(f'Missing literal in comment template: "{placeholder}".')
+        if args.comment_template:
+            for placeholder in Config.COMMENT_TEMPLATE_LITERALS:
+                if args.comment_template.find(placeholder) == -1:
+                    Log.abort(f'Missing literal in comment template: "{placeholder}".')
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index 1cc05f67..2d7be4cb 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -6,19 +6,21 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
-import argparse
+
 import copy
+import random
 from pathlib import Path
 from typing import List, Union
 from unittest.mock import call, patch
 
+import pytest
+
 from proptool.config.config import Config
 from proptool.config.config_builder import ConfigBuilder
 from tests.test_case import TestCase
 
 
 class TestConfigBuilder(TestCase):
-
     class FakeArgs(object):
         def __init__(self):
             self.fix: bool = False
@@ -136,7 +138,12 @@ def __init__(self):
 
         # Generate some names with .properties suffix
         args.files = [Path(f'{self.get_random_string()}.properties') for _ in range(1, 10)]
+        languages = ['pl', 'de', 'pt']
+        args.languages = languages
+        args.separator = random.choice(Config.ALLOWED_SEPARATORS)
+        args.comment_marker = random.choice(Config.ALLOWED_COMMENT_MARKERS)
 
+        # Process args and update config
         config_defaults = Config()
         config = Config()
         ConfigBuilder._set_from_args(config, args)
@@ -156,6 +163,9 @@ def __init__(self):
         # ensure all files are now with proper suffix
         for idx, args_file in enumerate(args.files):
             self.assertEqual(config.files[idx], args_file)
+        self.assertEqual(languages, config.languages)
+        self.assertEqual(args.separator, config.separator)
+        self.assertEqual(args.comment_marker, config.comment_marker)
 
     # #################################################################################################
 
@@ -179,3 +189,69 @@ def test_add_file_suffix_with_suffix(self) -> None:
         ConfigBuilder._add_file_suffix(config, dests)
         # Ensure nothing gets altered
         self.assertEqual(srcs, dests)
+
+    # #################################################################################################
+
+    def test_validate_args_onoff_valid_setups(self) -> None:
+        for option_name in ConfigBuilder._on_off_pairs:
+            args = TestConfigBuilder.FakeArgs()
+            args.__setattr__(option_name, False)
+            args.__setattr__(f'no_{option_name}', False)
+            # We expect no problems.
+            ConfigBuilder._validate_args(args)
+
+            args.__setattr__(option_name, True)
+            args.__setattr__(f'no_{option_name}', False)
+            # We expect no problems.
+            ConfigBuilder._validate_args(args)
+
+            args.__setattr__(option_name, False)
+            args.__setattr__(f'no_{option_name}', True)
+            # We expect no problems.
+            ConfigBuilder._validate_args(args)
+
+    @patch('proptool.log.Log.abort')
+    def test_validate_args_onoff_on_on(self, mock_log_abort) -> None:
+        for option_name in ConfigBuilder._on_off_pairs:
+            args = TestConfigBuilder.FakeArgs()
+            args.__setattr__(option_name, True)
+            args.__setattr__(f'no_{option_name}', True)
+            # Problems should be reported.
+            ConfigBuilder._validate_args(args)
+            exp_calls = [call(f'You cannot use "--{option_name}" and "--no-{option_name}" at the same time.')]
+            mock_log_abort.assert_has_calls(exp_calls)
+
+
+    @patch('proptool.log.Log.abort')
+    def test_validate_args_invalid_separator(self, mock_log_abort) -> None:
+        args = TestConfigBuilder.FakeArgs()
+
+        separator = self.get_random_string(length = 1)
+        self.assertNotIn(separator, Config.ALLOWED_SEPARATORS)
+        args.separator = separator
+        ConfigBuilder._validate_args(args)
+        exp_calls = [call(f'Invalid separator. Must be one of the following: {", ".join(Config.ALLOWED_SEPARATORS)}')]
+        mock_log_abort.assert_has_calls(exp_calls)
+
+    @patch('proptool.log.Log.abort')
+    def test_validate_args_invalid_comment_marker(self, mock_log_abort) -> None:
+        args = TestConfigBuilder.FakeArgs()
+
+        marker = self.get_random_string(length = 1)
+        self.assertNotIn(marker, Config.ALLOWED_COMMENT_MARKERS)
+        args.comment_marker = marker
+        ConfigBuilder._validate_args(args)
+        exp_calls = [call(f'Invalid comment marker. Must be one of the following: {", ".join(Config.ALLOWED_COMMENT_MARKERS)}')]
+        mock_log_abort.assert_has_calls(exp_calls)
+
+    @patch('proptool.log.Log.abort')
+    def test_validate_args_missing_comment_template_literal(self, mock_log_abort) -> None:
+        args = TestConfigBuilder.FakeArgs()
+
+        for missing_literal in Config.COMMENT_TEMPLATE_LITERALS:
+            tmp = copy.copy(Config.COMMENT_TEMPLATE_LITERALS)
+            del tmp[tmp.index(missing_literal)]
+            args.comment_template = ' '.join(tmp)
+            ConfigBuilder._validate_args(args)
+            exp_calls = [call(f'Missing literal in comment template: "{missing_literal}".')]
+            mock_log_abort.assert_has_calls(exp_calls)

From 0cbfbbd7bf28076b3d8173e16640c2701af97bf2 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 10:40:05 +0200
Subject: [PATCH 037/140] Lint fixes

---
 .flake8                             |  5 ++-
 tests/config/test_config_builder.py | 60 +++++++++++------------------
 2 files changed, 26 insertions(+), 39 deletions(-)

diff --git a/.flake8 b/.flake8
index 29a5ff44..84d2d805 100644
--- a/.flake8
+++ b/.flake8
@@ -136,4 +136,7 @@ per-file-ignores =
     # WPS425 Found boolean non-keyword argument: True, False
     # WPS431 Found nested class: FakeArgs
     # WPS437 Found protected attribute usage: _validate
-    tests/config/test_config_builder.py: WPS437, WPS425, WPS431, WPS230, WPS414,
+    # WPS609 Found direct magic attribute usage: __setattr__
+    # S311 Standard pseudo-random generators are not suitable for security/cryptographic purposes.
+    tests/config/test_config_builder.py: WPS437, WPS425, WPS431, WPS230, WPS414, WPS609, S311,
+
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index 2d7be4cb..daeb6ee7 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -13,28 +13,28 @@
 from typing import List, Union
 from unittest.mock import call, patch
 
-import pytest
-
 from proptool.config.config import Config
 from proptool.config.config_builder import ConfigBuilder
 from tests.test_case import TestCase
 
 
-class TestConfigBuilder(TestCase):
-    class FakeArgs(object):
-        def __init__(self):
-            self.fix: bool = False
+class FakeArgs(object):
+    def __init__(self):
+        self.fix: bool = False
 
-            self.files: List[str] = []
-            self.languages: List[str] = []
-            self.separator: Union[str, None] = None
-            self.comment_marker: Union[str, None] = None
-            self.comment_template: Union[str, None] = None
+        self.files: List[str] = []
+        self.languages: List[str] = []
+        self.separator: Union[str, None] = None
+        self.comment_marker: Union[str, None] = None
+        self.comment_template: Union[str, None] = None
+
+        # Initialize all on/off flags related attributes.
+        for option_name in ConfigBuilder._on_off_pairs:
+            self.__setattr__(option_name, False)
+            self.__setattr__(f'no_{option_name}', False)
 
-            # Initialize all on/off flags related attributes.
-            for option_name in ConfigBuilder._on_off_pairs:
-                self.__setattr__(option_name, False)
-                self.__setattr__(f'no_{option_name}', False)
+
+class TestConfigBuilder(TestCase):
 
     def get_config_for_validate(self) -> Config:
         config = Config()
@@ -90,7 +90,7 @@ def test_set_on_off_option(self) -> None:
         config.verbose = True
 
         self.assertTrue(config.verbose)
-        args = TestConfigBuilder.FakeArgs()
+        args = FakeArgs()
         args.verbose = False
         args.no_verbose = True
         ConfigBuilder._set_on_off_option(config, args, 'verbose')
@@ -112,21 +112,6 @@ def get_expectation(self, config_default: bool, switch_on: bool, switch_off: boo
         return result
 
     def test_set_from_args(self) -> None:
-        class FakeArgs(object):
-            def __init__(self):
-                self.fix: bool = False
-
-                self.files: List[str] = []
-                self.languages: List[str] = []
-                self.separator: Union[str, None] = None
-                self.comment_marker: Union[str, None] = None
-                self.comment_template: Union[str, None] = None
-
-                # Initialize all on/off flags related attributes.
-                for option_name in ConfigBuilder._on_off_pairs:
-                    self.__setattr__(option_name, False)
-                    self.__setattr__(f'no_{option_name}', False)
-
         args = FakeArgs()
         args.fix = self.get_random_bool()
 
@@ -194,7 +179,7 @@ def test_add_file_suffix_with_suffix(self) -> None:
 
     def test_validate_args_onoff_valid_setups(self) -> None:
         for option_name in ConfigBuilder._on_off_pairs:
-            args = TestConfigBuilder.FakeArgs()
+            args = FakeArgs()
             args.__setattr__(option_name, False)
             args.__setattr__(f'no_{option_name}', False)
             # We expect no problems.
@@ -213,7 +198,7 @@ def test_validate_args_onoff_valid_setups(self) -> None:
     @patch('proptool.log.Log.abort')
     def test_validate_args_onoff_on_on(self, mock_log_abort) -> None:
         for option_name in ConfigBuilder._on_off_pairs:
-            args = TestConfigBuilder.FakeArgs()
+            args = FakeArgs()
             args.__setattr__(option_name, True)
             args.__setattr__(f'no_{option_name}', True)
             # Problems should be reported.
@@ -221,10 +206,9 @@ def test_validate_args_onoff_on_on(self, mock_log_abort) -> None:
             exp_calls = [call(f'You cannot use "--{option_name}" and "--no-{option_name}" at the same time.')]
             mock_log_abort.assert_has_calls(exp_calls)
 
-
     @patch('proptool.log.Log.abort')
     def test_validate_args_invalid_separator(self, mock_log_abort) -> None:
-        args = TestConfigBuilder.FakeArgs()
+        args = FakeArgs()
 
         separator = self.get_random_string(length = 1)
         self.assertNotIn(separator, Config.ALLOWED_SEPARATORS)
@@ -235,7 +219,7 @@ def test_validate_args_invalid_separator(self, mock_log_abort) -> None:
 
     @patch('proptool.log.Log.abort')
     def test_validate_args_invalid_comment_marker(self, mock_log_abort) -> None:
-        args = TestConfigBuilder.FakeArgs()
+        args = FakeArgs()
 
         marker = self.get_random_string(length = 1)
         self.assertNotIn(marker, Config.ALLOWED_COMMENT_MARKERS)
@@ -245,8 +229,8 @@ def test_validate_args_invalid_comment_marker(self, mock_log_abort) -> None:
         mock_log_abort.assert_has_calls(exp_calls)
 
     @patch('proptool.log.Log.abort')
-    def test_validate_args_missing_comment_template_literal(self, mock_log_abort) -> None:
-        args = TestConfigBuilder.FakeArgs()
+    def test_validate_args_missing_literal(self, mock_log_abort) -> None:
+        args = FakeArgs()
 
         for missing_literal in Config.COMMENT_TEMPLATE_LITERALS:
             tmp = copy.copy(Config.COMMENT_TEMPLATE_LITERALS)

From b67726b7413b439f79402252724fb384c1f37ed2 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 12:35:25 +0200
Subject: [PATCH 038/140] Reworked docs

---
 README.md                                  |  43 ++++--
 docs/README.md                             |  17 +++
 docs/checks.md                             | 153 +++++++++++++++++++++
 docs/checks/README.md                      |  43 ++++++
 docs/checks/brackets.md                    |  37 +++++
 docs/checks/dangling-keys.md               |  37 +++++
 docs/checks/empty-translations.md          |  36 +++++
 docs/checks/formatting-values.md           |  39 ++++++
 docs/checks/key-format.md                  |  37 +++++
 docs/checks/missing-translations.md        |  58 ++++++++
 docs/checks/punctuation.md                 |  35 +++++
 docs/checks/quotation-marks.md             |  56 ++++++++
 docs/checks/starts-with-the-same-case.md   |  39 ++++++
 docs/checks/syntax-check.md                |  36 +++++
 docs/checks/trailing-white-chars.md        |  36 +++++
 docs/checks/typesetting-quotation-marks.md |  42 ++++++
 docs/checks/white-chars-before-linefeed.md |  38 +++++
 17 files changed, 767 insertions(+), 15 deletions(-)
 create mode 100644 docs/README.md
 create mode 100644 docs/checks.md
 create mode 100644 docs/checks/README.md
 create mode 100644 docs/checks/brackets.md
 create mode 100644 docs/checks/dangling-keys.md
 create mode 100644 docs/checks/empty-translations.md
 create mode 100644 docs/checks/formatting-values.md
 create mode 100644 docs/checks/key-format.md
 create mode 100644 docs/checks/missing-translations.md
 create mode 100644 docs/checks/punctuation.md
 create mode 100644 docs/checks/quotation-marks.md
 create mode 100644 docs/checks/starts-with-the-same-case.md
 create mode 100644 docs/checks/syntax-check.md
 create mode 100644 docs/checks/trailing-white-chars.md
 create mode 100644 docs/checks/typesetting-quotation-marks.md
 create mode 100644 docs/checks/white-chars-before-linefeed.md

diff --git a/README.md b/README.md
index e26bd6e0..3a14f5d2 100644
--- a/README.md
+++ b/README.md
@@ -1,24 +1,40 @@
 ![prop-tool logo](artwork/prop-tool-logo.png)
 
-# prop-tool #
+# Java *.properties file checker and syncing tool #
 
-`prop-tool` - Java *.properties file checker and syncing tool.
-
-[master](https://github.com/MarcinOrlowski/prop-tool/tree/master):
+[master](https://github.com/MarcinOrlowski/prop-tool/tree/master) branch:
 [![Unit tests](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/unittests.yml/badge.svg?branch=master)](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/unittests.yml)
 [![codecov](https://codecov.io/gh/MarcinOrlowski/prop-tool/branch/master/graph/badge.svg?token=3THKJKSQ1G)](https://codecov.io/gh/MarcinOrlowski/prop-tool)
 [![Code lint](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/linter.yml/badge.svg?branch=master)](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/linter.yml)
 [![MD Lint](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/markdown.yml/badge.svg?branch=master)](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/markdown.yml)
 
-[dev](https://github.com/MarcinOrlowski/prop-tool/tree/dev):
+[development](https://github.com/MarcinOrlowski/prop-tool/tree/dev) branch:
 [![Unit tests](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/unittests.yml/badge.svg?branch=dev)](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/unittests.yml)
 [![codecov](https://codecov.io/gh/MarcinOrlowski/prop-tool/branch/dev/graph/badge.svg?token=3THKJKSQ1G)](https://codecov.io/gh/MarcinOrlowski/prop-tool)
 [![Code lint](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/linter.yml/badge.svg?branch=dev)](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/linter.yml)
 [![MD Lint](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/markdown.yml/badge.svg?branch=dev)](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/markdown.yml)
 
-This utility can be used to check your `*.properties` Java files to ensure correct syntax is used, all translation files are in sync
-with base file, there are no missing keys or invalid punctuation and more. It can also create translation files adding missing keys
-based on the content of base file.
+## Table of contents ##
+
+* [Introduction](#introduction)
+* [Extensive documentation](docs/README.md)
+  * [Available validators](docs/checks/README.md)
+  * [Usage examples](docs/examples.md)
+  * [Config file](docs/config.md)
+* [Features](#features)
+* [Extensive documentation](docs/README.md)
+* [License](#license)
+* [Changelog](docs/CHANGES.md)
+
+---
+
+## Introduction ##
+
+`prop-tool` is a small but powerful utility aimed at your (mainly Java) projects' `*.properties` files. Its main role is to ensure
+all files are syntactically correct and all the translation files are in sync with base (main language) file. It also comes with
+huge set of various linters and checkers to guard quality of the files' contents. It can check for missing or dangling keys,
+inproper punctuation, open brackets, quotation marks and more. It can also automatically sync translation files quickly providing
+fresh template for your translators to work on.
 
 ```bash
 $ prop-tool -b mark -l pl -v
@@ -46,9 +62,6 @@ Base: mark.properties
         W: Line 14:11: No closing mark for ".
 ```
 
-Based on `*.properties`
-[file format docs](https://docs.oracle.com/cd/E23095_01/Platform.93/ATGProgGuide/html/s0204propertiesfileformat01.html).
-
 ## Checks ##
 
 The main purpose of `prop-tool` is to ensure all property files are correct and that translation files are in sync with the
@@ -81,8 +94,8 @@ For translation files, the following checks are performed:
 * QuotationMarks: ensures all quotation marks are unpaired.
 * StartsWithTheSameCase: ensures translation starts with the same character case (upper/lower) as entry in base file.
 * TrailingWhiteChars: no trailing spaces nor tabs at the end of each line.
-* TypesettingQuotationMarks: ensures that typesetting quotation marks (where you have separate quote opening and closing
-  characters) are paired and properly nested.
+* TypesettingQuotationMarks: ensures that typesetting quotation marks (where you have separate quote opening and closing characters)
+  are paired and properly nested.
 * WhiteCharsBeforeLinefeed: ensures there's no space nor tab character placed before linefeed literals (`\n` and `\r`).
 
 NOTE: as this is quite common that translation file may not be updated instantly, `prop-tool` considers key presence condition
@@ -186,8 +199,8 @@ You can use `prop-tool` by providing all required parameters directly from comma
 configuration file and use `--config` option to make `prop-tool` load it and use. Almost all options can be set in configuration
 files, which helps, for example using `prop-tool` as part of CI/CD or GitHub Actions.
 
-Configuration file is plain text file, following [INI file format](https://en.wikipedia.org/wiki/INI_file) and can be created
-using any text editor. Please see commented [config.ini](config.ini) for example configuration file and all available options.
+Configuration file is plain text file, following [INI file format](https://en.wikipedia.org/wiki/INI_file) and can be created using
+any text editor. Please see commented [config.ini](config.ini) for example configuration file and all available options.
 
 > NOTE: when using configuration file and command line arguments, the order of precedence is this:
 >
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 00000000..f965060c
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,17 @@
+![prop-tool logo](../artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## Table of contents ##
+
+* [« Main README](../README.md)
+* [« Documentation table of contents](README.md)
+
+
+* **[Validators](checks/README.md)**
+
+---
+
+The `*.properties` syntax support is based on official [file format documentation](https://docs.oracle.com/cd/E23095_01/Platform.93/ATGProgGuide/html/s0204propertiesfileformat01.html).
+
+
diff --git a/docs/checks.md b/docs/checks.md
new file mode 100644
index 00000000..d979cd9e
--- /dev/null
+++ b/docs/checks.md
@@ -0,0 +1,153 @@
+![prop-tool logo](../artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## Table of contents ##
+
+* [« Main README](../README.md)
+* [« Documentation table of contents](README.md)
+
+
+* **[Validators](#validators)**
+    * [Checking base and translation files](#checking-base-and-translation-files)
+* [Available checks](#available-checks)
+    * [Syntax check](#syntax-check)
+    * [Brackets](#brackets)
+    * [DanglingKeys](#dangling-keys)
+    * [EmptyTranslations](#empty-translations)
+    * [FormattingValues](#formatting-values)
+    * [KeyFormat](#key-format)
+    * [MissingTranslation](#missing-translation)
+    * [Punctuation](#punctuation)
+    * [QuotationMarks](#quotation-marks)
+    * [StartsWithTheSameCase](#starts-with-the-same-case)
+    * [TrailingWhiteChars](#trailing-white-chars)
+    * [TypesettingQuotationMarks](#typesetting-quotation-marks)
+    * [WhiteCharsBeforeLinefeed](#white-chars-before-linefeed)
+
+---
+
+# Validators #
+
+The main purpose of `prop-tool` is to ensure all property files are correct and that translation files are in sync with the
+reference file. For that reason you need to have at least two `*.properties` files to use `prop-tool`. One is your base language
+(usually English texts) used as reference and all the others are your translations. `prop-tool` performs several checks on both
+base (reference) file and each translation.
+
+## Checking base and translation files ##
+
+Some validators can do their work having just single file to process. In such
+case you can use it to check both your base file and translation files. Those
+validators that needs base file reference (i.e. [DanglingKeys](#dangling-keys)
+can only be used to validate translations.
+
+# Available checks #
+
+## Syntax Check ##
+
+This validators ensures proper structire of the files, use of allowed comment markers, key - value separators etc.
+
+## Brackets ##
+
+Brackets validator ensures all brackets that are found opened in the string are also closed and there's no unpaired bracket left.
+
+## Dangling Keys ##
+
+DanglingKeys validator checks if keys found in translation file are also present in base file.
+
+## Empty Translations ##
+
+EmptyTranslations validator looks for translations that provide no content (empty string) for non-empty text in base file.
+
+## Formatting Values ##
+
+FormattingValues validators looks for commonly used `print()`-alike formatting values syntax, where placeholders like `%s` or `%d`
+are replaced with corresponding values at runtime. It assumes that the code expects the same placeholders to be available regardless
+of language version therefore it check if all placeholders used in original string are also present in translation string and if the
+order of said placeholders is preserved as this is also often crucial for the application to run properly.
+
+## Key Format ##
+
+KeyFormat ensures strings used as keys in you `*.properties` file matches specified pattern which helps keeping unified naming
+conventcion across your files.
+
+## Missing Translation ##
+
+MissingTranslation looks texts present in base file that are not provided in the translation.
+
+*NOTE:* as it's pretty often the case that translation files are not always update at the same time base files changes,
+`MissingTranslation` is smart enough to accept situation where translation file contains translation key commented (using specified
+string format) out but not the translation itself. This is sufficient for the translator to catch up and indicates that translation
+file was updated once base file changed. For example, given this `base.properties`:
+
+```ini
+someKey = Hello
+newlyAddedKey = I'm new here!
+```
+
+and following translation file: `base_xx.properties`
+
+```ini
+someKey = Hello
+# ==> newlyAddedKey =
+```
+
+the `newlyAddedKey` will be considered "present" in translation, despite being commented out. If you want to ensure there are all
+translated, you need to use `--strict` mode instead of default loose check mode.
+
+Default format can be changed using `--template` argument or `template` config entry.
+
+## Punctuation ##
+
+Punctuation check ensures translation ends with punctuation mark (`:`, `.`, `?`, `!`) if entry in base file ends that way.
+
+## Quotation Marks ##
+
+QuotationMarks ensures all quotation marks are unpaired.
+
+Matching quotation marks it tricky because in some languages there's single char that is used as opening and closing quotation
+mark (mainly `"`). This makes `QuotationMarks` unable to properly understand the context in case of use of subsequent marks of the
+same type, i.e. three `"` in a row: `"""` as it cannot say if 2nd one closes the quotation opened by first one, or maybe first is
+closed by third and the 2nd is just missing its closing mark and is misplaced. Therefore for the subsequent marks of the same type
+it's always assumed that that there's no quotation nesting. For example, for four `"` in a row `""""`
+it is assumed 1st is the opening marker, 2nd closes 1st, and 4th closes the 3rd.
+
+Things also more complicated if you want to mix the quotation marks and use apostrophes too. For example. `"'"'` (double quotes and
+apostrophes)
+will be marked as incorrect as you open `'` apostrophe marked quote before double quoted is closed. This may be problematic in some
+languages that use apostrophes as part of the sentence, i.e. `It's "me"`. This is currently sufficient to fool `QuotationMarks`
+as it will complain about not closed apostrophe marked quotation.
+
+Temporary workarounds:
+
+* Try to avoid using apostrophes as quotation marks (change `QuotationMarks` config to not handle it) if you need them in your
+  sentences.
+* Create `QuotationMarks` configuration per language so i.e. apostrophes are ignored in English, but checked in i.e. Polish which do
+  not use it as part of sentences.
+
+## Starts With The Same Case ##
+
+StartsWithTheSameCase ensures translation starts with the same character case (be it upper or lower cased) as string in base string.
+
+*NOTE:* This check makes no sense for languages like Asian (i.e. Chinese, Japanese etc) and you should configure language exception
+list for `StartsWithTheSameCase` to make is skip such translations from being checked.
+
+## Trailing White Chars ##
+
+TrailingWhiteChars simply looks at the end of your strings and comments and flags trailing spaces or tab charactes noticed.
+
+## Typesetting Quotation Marks ##
+
+TypesettingQuotationMarks is a mixture of `QuotationMarks` and `Brackets` check that understans quotation mark pairs
+(where you have separate quote opening and closing characters). It can look for them and ensure all is paired and properly nested.
+
+*NOTE:* This check usually needs some config tuning because it is not possible to create one universal set of quotation marks
+that fits all the languages. The reason is there are the cases where i.e. given character is considered closing quotation mark
+in one language and opening marker in another. As `QuotationMarks` does not understand the language it checks it cannot figure
+out how to handle such case automatically. The solution is to specify separate pairs for each language you want to support.
+
+## White Chars Before Linefeed ##
+
+`WhiteCharsBeforeLinefeed` ensures there's no space nor tab character placed before linefeed literals (`\n` and `\r`)
+as this usually serves no purpose.
+
diff --git a/docs/checks/README.md b/docs/checks/README.md
new file mode 100644
index 00000000..b74079b2
--- /dev/null
+++ b/docs/checks/README.md
@@ -0,0 +1,43 @@
+![prop-tool logo](../../artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## Table of contents ##
+
+* [« Main README](../../README.md)
+* [« Documentation table of contents](README.md)
+
+
+* **[Validators](#validators)**
+    * [Checking base and translation files](#checking-base-and-translation-files)
+* Available checks
+  * [Syntax check](syntax-check.md)
+  * [Brackets](brackets.md)
+  * [DanglingKeys](dangling-keys.md)
+  * [EmptyTranslations](empty-translations.md)
+  * [FormattingValues](formatting-values.md)
+  * [KeyFormat](key-format.md)
+  * [MissingTranslations](missing-translations.md)
+  * [Punctuation](punctuation.md)
+  * [QuotationMarks](quotation-marks.md)
+  * [StartsWithTheSameCase](starts-with-the-same-case.md)
+  * [TrailingWhiteChars](trailing-white-chars.md)
+  * [TypesettingQuotationMarks](typesetting-quotation-marks.md)
+  * [WhiteCharsBeforeLinefeed](white-chars-before-linefeed.md)
+
+
+---
+
+# Validators #
+
+The main purpose of `prop-tool` is to ensure all property files are correct and that translation files are in sync with the
+reference file. For that reason you need to have at least two `*.properties` files to use `prop-tool`. One is your base language
+(usually English texts) used as reference and all the others are your translations. `prop-tool` performs several checks on both
+base (reference) file and each translation.
+
+## Checking base and translation files ##
+
+Some validators can do their work having just single file to process. In such
+case you can use it to check both your base file and translation files. Those
+validators that needs base file reference (i.e. [DanglingKeys](#dangling-keys)
+can only be used to validate translations.
diff --git a/docs/checks/brackets.md b/docs/checks/brackets.md
new file mode 100644
index 00000000..21009aac
--- /dev/null
+++ b/docs/checks/brackets.md
@@ -0,0 +1,37 @@
+![prop-tool logo](../../artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## Brackets ##
+
+* [« Main README](../../README.md)
+* [« Documentation table of contents](../README.md)
+
+
+* [« Available checks](README.md)
+  * **Brackets**
+    * [Summary](#summary)
+    * [Description](#description)
+    * [Command line options](#command-line-options)  
+    * [Configuration file](#configuration-file)
+
+---
+
+## Summary ##
+
+* Check ID: `Brackets`
+* Checks base file: YES
+* Checks translations: YES
+
+## Description ##
+
+`Brackets` ensures all brackets that are found opened in the string are also closed and there's no unpaired bracket left.
+
+
+## Command line options ##
+
+No dedicated command line options for this validator.
+
+## Configuration file ##
+
+TODO
diff --git a/docs/checks/dangling-keys.md b/docs/checks/dangling-keys.md
new file mode 100644
index 00000000..de4df386
--- /dev/null
+++ b/docs/checks/dangling-keys.md
@@ -0,0 +1,37 @@
+![prop-tool logo](../../artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## Dangling Keys ##
+
+* [« Main README](../../README.md)
+* [« Documentation table of contents](../README.md)
+
+
+* [« Available checks](README.md)
+  * **Dangling Keys**
+    * [Summary](#summary)
+    * [Description](#description)
+    * [Command line options](#command-line-options)
+    * [Configuration file](#configuration-file)
+
+---
+
+## Summary ##
+
+* Check ID: `DanglingKeys`
+* Checks base file: NO
+* Checks translations: YES
+
+## Description ##
+
+Checks if keys found in translation file are also present in base file.
+
+
+## Command line options ##
+
+No dedicated command line options for this validator.
+
+## Configuration file ##
+
+No dedicated configuration.
diff --git a/docs/checks/empty-translations.md b/docs/checks/empty-translations.md
new file mode 100644
index 00000000..6ca1c67e
--- /dev/null
+++ b/docs/checks/empty-translations.md
@@ -0,0 +1,36 @@
+![prop-tool logo](../../artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## Empty Translations ##
+
+* [« Main README](../../README.md)
+* [« Documentation table of contents](../README.md)
+
+
+* [« Available checks](README.md)
+  * **Empty Translations**
+    * [Summary](#summary)
+    * [Description](#description)
+    * [Command line options](#command-line-options)
+    * [Configuration file](#configuration-file)
+
+---
+
+## Summary ##
+
+* Check ID: `EmptyTranslations`
+* Checks base file: NO
+* Checks translations: YES
+
+## Description ##
+
+This validator looks for translations that provide no content (empty string) for non-empty text in base file.
+
+## Command line options ##
+
+No dedicated command line options for this validator.
+
+## Configuration file ##
+
+No dedicated configuration.
diff --git a/docs/checks/formatting-values.md b/docs/checks/formatting-values.md
new file mode 100644
index 00000000..614278c2
--- /dev/null
+++ b/docs/checks/formatting-values.md
@@ -0,0 +1,39 @@
+![prop-tool logo](../../artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## Formatting Values ##
+
+* [« Main README](../../README.md)
+* [« Documentation table of contents](../README.md)
+
+
+* [« Available checks](README.md)
+  * **Formatting Values**
+    * [Summary](#summary)
+    * [Description](#description)
+    * [Command line options](#command-line-options)
+    * [Configuration file](#configuration-file)
+
+---
+
+## Summary ##
+
+* Check ID: `FormattingValues`
+* Checks base file: NO
+* Checks translations: YES
+
+## Description ##
+
+The `FormattingValues` validators looks for commonly used `print()`-alike formatting values syntax, where placeholders like `%s` or `%d`
+are replaced with corresponding values at runtime. It assumes that the code expects the same placeholders to be available regardless
+of language version therefore it check if all placeholders used in original string are also present in translation string and if the
+order of said placeholders is preserved as this is also often crucial for the application to run properly.
+
+## Command line options ##
+
+No dedicated command line options for this validator.
+
+## Configuration file ##
+
+TODO
diff --git a/docs/checks/key-format.md b/docs/checks/key-format.md
new file mode 100644
index 00000000..21551cc5
--- /dev/null
+++ b/docs/checks/key-format.md
@@ -0,0 +1,37 @@
+![prop-tool logo](../../artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## Key Format ##
+
+* [« Main README](../../README.md)
+* [« Documentation table of contents](../README.md)
+
+
+* [« Available checks](README.md)
+  * **Key Format**
+    * [Summary](#summary)
+    * [Description](#description)
+    * [Command line options](#command-line-options)
+    * [Configuration file](#configuration-file)
+
+---
+
+## Summary ##
+
+* Check ID: `KeyFormat`
+* Checks base file: YES
+* Checks translations: YES
+
+## Description ##
+
+This validator ensures strings used as keys in you `*.properties` file matches specified pattern which helps keeping unified naming
+conventcion across your files.
+
+## Command line options ##
+
+No dedicated command line options for this validator.
+
+## Configuration file ##
+
+TODO
diff --git a/docs/checks/missing-translations.md b/docs/checks/missing-translations.md
new file mode 100644
index 00000000..bf0243a5
--- /dev/null
+++ b/docs/checks/missing-translations.md
@@ -0,0 +1,58 @@
+![prop-tool logo](../../artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## Missing Translations ##
+
+* [« Main README](../../README.md)
+* [« Documentation table of contents](../README.md)
+
+
+* [« Available checks](README.md)
+  * **Missing Translations**
+    * [Summary](#summary)
+    * [Description](#description)
+    * [Command line options](#command-line-options)
+    * [Configuration file](#configuration-file)
+  
+---
+
+## Summary ##
+
+* Check ID: `MissingTranslations`
+* Checks base file: NO
+* Checks translations: YES
+
+## Description ##
+
+`MissingTranslations` looks texts present in base file that are not provided in the translation.
+
+*NOTE:* as it's pretty often the case that translation files are not always update at the same time base files changes,
+`MissingTranslations` is smart enough to accept situation where translation file contains translation key commented (using specified
+string format) out but not the translation itself. This is sufficient for the translator to catch up and indicates that translation
+file was updated once base file changed. For example, given this `base.properties`:
+
+```ini
+someKey = Hello
+newlyAddedKey = I'm new here!
+```
+
+and following translation file: `base_xx.properties`
+
+```ini
+someKey = Hello
+# ==> newlyAddedKey =
+```
+
+the `newlyAddedKey` will be considered "present" in translation, despite being commented out. If you want to ensure there are all
+translated, you need to use `--strict` mode instead of default loose check mode.
+
+Default format can be changed using `--template` argument or `template` config entry.
+
+## Command line options ##
+
+TODO
+
+## Configuration file ##
+
+TODO
diff --git a/docs/checks/punctuation.md b/docs/checks/punctuation.md
new file mode 100644
index 00000000..8499ba97
--- /dev/null
+++ b/docs/checks/punctuation.md
@@ -0,0 +1,35 @@
+![prop-tool logo](../../artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## Punctuation ##
+
+* [« Main README](../../README.md)
+* [« Documentation table of contents](../README.md)
+
+
+* [« Available checks](README.md)
+  * **Punctuation**
+    * [Summary](#summary)
+    * [Description](#description)
+    * [Command line options](#command-line-options)
+    * [Configuration file](#configuration-file)
+---
+
+## Summary ##
+
+* Check ID: `Punctuation`
+* Checks base file: NO
+* Checks translations: YES
+
+## Description ##
+
+Punctuation check ensures translation ends with punctuation mark (`:`, `.`, `?`, `!`) if entry in base file ends that way.
+
+## Command line options ##
+
+No dedicated command line options for this validator.
+
+## Configuration file ##
+
+TODO
diff --git a/docs/checks/quotation-marks.md b/docs/checks/quotation-marks.md
new file mode 100644
index 00000000..15d0b916
--- /dev/null
+++ b/docs/checks/quotation-marks.md
@@ -0,0 +1,56 @@
+![prop-tool logo](../../artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## Quotation Marks ##
+
+* [« Main README](../../README.md)
+* [« Documentation table of contents](../README.md)
+
+
+* [« Available checks](README.md)
+  * **Quotation Marks**
+    * [Summary](#summary)
+    * [Description](#description)
+    * [Command line options](#command-line-options)
+    * [Configuration file](#configuration-file)
+
+---
+
+## Summary ##
+
+* Check ID: `QuotationMarks`
+* Checks base file: YES
+* Checks translations: YES
+
+## Description ##
+
+QuotationMarks ensures all quotation marks are unpaired.
+
+Matching quotation marks it tricky because in some languages there's single char that is used as opening and closing quotation
+mark (mainly `"`). This makes `QuotationMarks` unable to properly understand the context in case of use of subsequent marks of the
+same type, i.e. three `"` in a row: `"""` as it cannot say if 2nd one closes the quotation opened by first one, or maybe first is
+closed by third and the 2nd is just missing its closing mark and is misplaced. Therefore for the subsequent marks of the same type
+it's always assumed that that there's no quotation nesting. For example, for four `"` in a row `""""`
+it is assumed 1st is the opening marker, 2nd closes 1st, and 4th closes the 3rd.
+
+Things also more complicated if you want to mix the quotation marks and use apostrophes too. For example. `"'"'` (double quotes and
+apostrophes)
+will be marked as incorrect as you open `'` apostrophe marked quote before double quoted is closed. This may be problematic in some
+languages that use apostrophes as part of the sentence, i.e. `It's "me"`. This is currently sufficient to fool `QuotationMarks`
+as it will complain about not closed apostrophe marked quotation.
+
+Temporary workarounds:
+
+* Try to avoid using apostrophes as quotation marks (change `QuotationMarks` config to not handle it) if you need them in your
+  sentences.
+* Create `QuotationMarks` configuration per language so i.e. apostrophes are ignored in English, but checked in i.e. Polish which do
+  not use it as part of sentences.
+
+## Command line options ##
+
+No dedicated command line options for this validator.
+
+## Configuration file ##
+
+TODO
diff --git a/docs/checks/starts-with-the-same-case.md b/docs/checks/starts-with-the-same-case.md
new file mode 100644
index 00000000..5b586c43
--- /dev/null
+++ b/docs/checks/starts-with-the-same-case.md
@@ -0,0 +1,39 @@
+![prop-tool logo](../../artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## Starts With The Same Case ##
+
+* [« Main README](../../README.md)
+* [« Documentation table of contents](../README.md)
+
+
+* [« Available checks](README.md)
+  * **Starts With The Same Case**
+    * [Summary](#summary)
+    * [Description](#description)
+    * [Command line options](#command-line-options)
+    * [Configuration file](#configuration-file)
+
+---
+
+## Summary ##
+
+* Check ID: `StartsWithTheSameCase`
+* Checks base file: NO
+* Checks translations: YES
+
+## Description ##
+
+StartsWithTheSameCase ensures translation starts with the same character case (be it upper or lower cased) as string in base string.
+
+*NOTE:* This check makes no sense for languages like Asian (i.e. Chinese, Japanese etc) and you should configure language exception
+list for `StartsWithTheSameCase` to make is skip such translations from being checked.
+
+## Command line options ##
+
+No dedicated command line options for this validator.
+
+## Configuration file ##
+
+TODO
diff --git a/docs/checks/syntax-check.md b/docs/checks/syntax-check.md
new file mode 100644
index 00000000..38c18e9c
--- /dev/null
+++ b/docs/checks/syntax-check.md
@@ -0,0 +1,36 @@
+![prop-tool logo](../../artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## Syntax Check ##
+
+* [« Main README](../../README.md)
+* [« Documentation table of contents](../README.md)
+
+
+* [« Available checks](README.md)
+  * **Syntax Check**
+    * [Summary](#summary)
+    * [Description](#description)
+    * [Command line options](#command-line-options)
+    * [Configuration file](#configuration-file)
+
+---
+
+## Summary ##
+
+* Check ID: None. This is built-in check which is always triggered on file load. It cannot be configured nor user controlled.
+* Checks base file: YES
+* Checks translations: YES
+
+## Description ##
+
+This validators ensures proper structire of the files, use of allowed comment markers, key - value separators etc.
+
+## Command line options ##
+
+No dedicated command line options for this validator.
+
+## Configuration file ##
+
+No dedicated configuration.
diff --git a/docs/checks/trailing-white-chars.md b/docs/checks/trailing-white-chars.md
new file mode 100644
index 00000000..31fdefdf
--- /dev/null
+++ b/docs/checks/trailing-white-chars.md
@@ -0,0 +1,36 @@
+![prop-tool logo](../../artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## Trailing White Chars ##
+
+* [« Main README](../../README.md)
+* [« Documentation table of contents](../README.md)
+
+
+* [« Available checks](README.md)
+  * **Trailing White Chars**
+    * [Summary](#summary)
+    * [Description](#description)
+    * [Command line options](#command-line-options)
+    * [Configuration file](#configuration-file)
+
+---
+
+## Summary ##
+
+* Check ID: `TrailingWhiteChars`
+* Checks base file: YES
+* Checks translations: YES
+
+## Description ##
+
+This validator looks at the end of your strings and comments and flags trailing spaces or tab charactes noticed.
+
+## Command line options ##
+
+No dedicated command line options for this validator.
+
+## Configuration file ##
+
+No dedicated configuration.
diff --git a/docs/checks/typesetting-quotation-marks.md b/docs/checks/typesetting-quotation-marks.md
new file mode 100644
index 00000000..3cfd7c0a
--- /dev/null
+++ b/docs/checks/typesetting-quotation-marks.md
@@ -0,0 +1,42 @@
+![prop-tool logo](../../artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## Typesetting Quotation Marks ##
+
+* [« Main README](../../README.md)
+* [« Documentation table of contents](../README.md)
+
+
+* [« Available checks](README.md)
+  * **Typesetting Quotation Marks**
+    * [Summary](#summary)
+    * [Description](#description)
+    * [Command line options](#command-line-options)
+    * [Configuration file](#configuration-file)
+
+---
+
+## Summary ##
+
+* Check ID: `TypesettingQuotationMarks`
+* Checks base file: YES
+* Checks translations: YES
+
+## Description ##
+
+TypesettingQuotationMarks is a mixture of `QuotationMarks` and `Brackets` check that understans quotation mark pairs
+(where you have separate quote opening and closing characters). It can look for them and ensure all is paired and properly nested.
+
+*NOTE:* This check usually needs some config tuning because it is not possible to create one universal set of quotation marks
+that fits all the languages. The reason is there are the cases where i.e. given character is considered closing quotation mark
+in one language and opening marker in another. As `QuotationMarks` does not understand the language it checks it cannot figure
+out how to handle such case automatically. The solution is to specify separate pairs for each language you want to support.
+
+## Command line options ##
+
+No dedicated command line options for this validator.
+
+## Configuration file ##
+
+TODO
diff --git a/docs/checks/white-chars-before-linefeed.md b/docs/checks/white-chars-before-linefeed.md
new file mode 100644
index 00000000..026f10cc
--- /dev/null
+++ b/docs/checks/white-chars-before-linefeed.md
@@ -0,0 +1,38 @@
+![prop-tool logo](../../artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## White Chars Before Linefeed ##
+
+* [« Main README](../../README.md)
+* [« Documentation table of contents](../README.md)
+
+
+* [« Available checks](README.md)
+  * **White Chars Before Linefeed**
+    * [Summary](#summary)
+    * [Description](#description)
+    * [Command line options](#command-line-options)
+    * [Configuration file](#configuration-file)
+
+---
+
+## Summary ##
+
+* Check ID: `WhiteCharsBeforeLinefeed`
+* Checks base file: YES
+* Checks translations: YES
+
+## Description ##
+
+This validator ensures there's no space nor tab character placed before linefeed literals (`\n` and `\r`)
+as this usually serves no purpose.
+
+
+## Command line options ##
+
+No dedicated command line options for this validator.
+
+## Configuration file ##
+
+No dedicated configuration.

From fa4beaf59a601a7e422b63db7d20c05f46b92144 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 12:35:46 +0200
Subject: [PATCH 039/140] Moved CHANGES.md to docs/

---
 CHANGES.md => docs/CHANGES.md | 3 +++
 1 file changed, 3 insertions(+)
 rename CHANGES.md => docs/CHANGES.md (96%)

diff --git a/CHANGES.md b/docs/CHANGES.md
similarity index 96%
rename from CHANGES.md
rename to docs/CHANGES.md
index cfa6014a..dd11b1dd 100644
--- a/CHANGES.md
+++ b/docs/CHANGES.md
@@ -1,5 +1,8 @@
 # Changelog #
 
+* dev
+  * Added support for config files
+
 * v1.3.0 (2021-07-22)
   * Added `TypesettingQuotationMarks` check.
   * Various checkers' code improvements.

From 114ff6038d168a64a3f8928c1013a537e5a2e9db Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 13:23:41 +0200
Subject: [PATCH 040/140] Tweaked MD linter config

---
 .markdownlint.yaml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.markdownlint.yaml b/.markdownlint.yaml
index 5568c96b..c0242d12 100644
--- a/.markdownlint.yaml
+++ b/.markdownlint.yaml
@@ -59,7 +59,8 @@ MD011: true
 # MD012/no-multiple-blanks - Multiple consecutive blank lines
 MD012:
   # Consecutive blank lines
-  maximum: 1
+  # maximum: 1
+  maximum: 2 # MOR (to separate checks/*md navigation elements)
 
 # MD013/line-length - Line length
 MD013:

From 28e24587b09f530bc9c5b8144eb679afde8da1f3 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 13:23:44 +0200
Subject: [PATCH 041/140] Added more docs

---
 README.md                        | 133 +--------------------------
 docs/README.md                   |  28 +++++-
 docs/checks.md                   | 153 -------------------------------
 docs/checks/README.md            |   3 +-
 docs/checks/formatting-values.md |   8 +-
 docs/checks/punctuation.md       |   1 +
 docs/developers.md               | 107 +++++++++++++++++++++
 docs/usage.md                    |  72 +++++++++++++++
 8 files changed, 211 insertions(+), 294 deletions(-)
 delete mode 100644 docs/checks.md
 create mode 100644 docs/developers.md
 create mode 100644 docs/usage.md

diff --git a/README.md b/README.md
index 3a14f5d2..d1fa9299 100644
--- a/README.md
+++ b/README.md
@@ -19,7 +19,7 @@
 * [Introduction](#introduction)
 * [Extensive documentation](docs/README.md)
   * [Available validators](docs/checks/README.md)
-  * [Usage examples](docs/examples.md)
+  * [Usage examples](docs/usage.md)
   * [Config file](docs/config.md)
 * [Features](#features)
 * [Extensive documentation](docs/README.md)
@@ -62,137 +62,6 @@ Base: mark.properties
         W: Line 14:11: No closing mark for ".
 ```
 
-## Checks ##
-
-The main purpose of `prop-tool` is to ensure all property files are correct and that translation files are in sync with the
-reference file. For that reason you need to have at least two `*.properties` files to use `prop-tool`. One is your base language
-(usually English texts) used as reference and all the others are your translations. `prop-tool` performs several checks on both
-base (reference) file and each translation.
-
-For base file it executes following validators:
-
-* Syntax: ensures use of allowed comment markers, key - value separators etc.
-* Brackets: ensures all brackets opened are closed and there's no unpaired bracket.
-* KeyFormat: ensures key string matches defined pattern.
-* QuotationMarks: ensures all quotation marks are unpaired.
-* TrailingWhiteChars: no trailing spaces nor tabs at the end of each line.
-* TypesettingQuotationMarks: ensures that typesetting quotation marks (where you have separate quote opening and closing characters)
-  are paired and properly nested.
-* WhiteCharsBeforeLinefeed: ensures there's no space nor tab character placed before linefeed literals (`\n` and `\r`).
-
-For translation files, the following checks are performed:
-
-* Syntax: ensures use of allowed comment markers, key - value separators etc.
-* Brackets: ensures all brackets opened are closed and there's no unpaired bracket.
-* DanglingKeys: keys found in translation file but not present in base file.
-* EmptyTranslations: empty translations for non-empty text in base file.
-* FormattingValues: ensures all formatting values (i.e. `%s`, `%d`) present in base file are also present in translation, and the
-  order is correct.
-* KeyFormat: ensures key string matches defined pattern.
-* MissingTranslation: keys found in base file, but missing in translation.
-* Punctuation: ensures translation ends with punctuation mark (`:`, `.`, `?`, `!`) if entry in base file ends that way.
-* QuotationMarks: ensures all quotation marks are unpaired.
-* StartsWithTheSameCase: ensures translation starts with the same character case (upper/lower) as entry in base file.
-* TrailingWhiteChars: no trailing spaces nor tabs at the end of each line.
-* TypesettingQuotationMarks: ensures that typesetting quotation marks (where you have separate quote opening and closing characters)
-  are paired and properly nested.
-* WhiteCharsBeforeLinefeed: ensures there's no space nor tab character placed before linefeed literals (`\n` and `\r`).
-
-NOTE: as this is quite common that translation file may not be updated instantly, `prop-tool` considers key presence condition
-fulfilled also when given key exists in `B` file but is commented out and follow expected comment format:
-
-```bash
-# ==> KEY =
-```
-
-Default format can changed using `--tpl` argument.
-
-If you want to ensure that all keys are in fact translated, use `--strict` mode while checking. When running with `--strict` option,
-keys in commented out form are ignored.
-
-## Installation ##
-
-You can install `prop-tool` from [PyPi](https://pypi.org/project/prop-tool/):
-
-```bash
-pip install prop-tool
-```
-
-Alternatively, you can download `*.whl` archive and install it manually by issuing:
-
-```bash
-pip install --upgrade <FILE>.whl
-```
-
-You may also want to setup [virtual environment](https://docs.python.org/3/library/venv.html) first.
-
-## Fixing files ##
-
-You can use `prop-tool` to update your translation files by using `--fix` option. In such case `prop-tool` will completely rewrite
-translation files, adding missing keys (in commented out form).
-
-While content of written file is strongly based on base file Some normalization will be made
-
-* There will be no more than one empty consequent empty line written,
-* There will be no more than one consequent empty comment line (just comment marker) written.
-
-NOTE: Be aware that `--fix` do NOT update existing translation file but builds it completely using base file as reference and
-existing translations (if present). No other content of translation files (for example additional comments etc) will be preserved.
-
-## Usage examples ##
-
-Check if `de` translation of `test.properties` exists and is in sync:
-
-```bash
-prop-tool --base test.properties --lang de
-```
-
-You can omit `.properties` suffix in command line argument. NOTE: that file name must contain `.properties`
-suffix, otherwise it will not be found:
-
-```bash
-prop-tool --base test --lang de
-```
-
-it will then look for `test_de.properties` file in the same folder `test.properties` resides and check it.
-
----
-
-Check if `de`, `pl` and `fr` translations of `test.properties` and `gui.properties` exist and are in sync:
-
-```bash
-prop-tool --base test gui --lang de pl fr
-```
-
-it will then look for and validate following files
-
-```bash
-test_de.properties
-test_pl.properties
-test_fr.properties
-gui_de.properties
-gui_pl.properties
-gui_fr.properties
-```
-
----
-
-Check if `es` translation of `gui.properties` is in sync and if there are any missing keys, rewrite translation file to contain all
-keys from base:
-
-```bash
-prop-tool --base gui --lang es --fix
-```
-
----
-
-Check if `pt` translation of `gui.properties` is in sync and if there are any missing keys, rewrite translation file to contain all
-keys from base using own comment format:
-
-```bash
-prop-tool --base gui --lang es --fix --tpl "COM >~=-> KEY SEP"
-```
-
 ## Config file and command line arguments ##
 
 You can use `prop-tool` by providing all required parameters directly from command line (see `--help`), or you can create
diff --git a/docs/README.md b/docs/README.md
index f965060c..fa62e509 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -7,11 +7,33 @@
 * [« Main README](../README.md)
 * [« Documentation table of contents](README.md)
 
-
-* **[Validators](checks/README.md)**
+* [Usage examples](usage.md)
+  * [Updating translations](usage.md#updating-translations)
+* [Available validators](checks/README.md)
+* [Installation](#installation)
+* [Developer corner](developers.md)
+* [Links](#additional-links)
 
 ---
 
-The `*.properties` syntax support is based on official [file format documentation](https://docs.oracle.com/cd/E23095_01/Platform.93/ATGProgGuide/html/s0204propertiesfileformat01.html).
+## Installation ##
+
+You can install `prop-tool` from [PyPi](https://pypi.org/project/prop-tool/):
+
+```bash
+pip install prop-tool
+```
+
+Alternatively, you can download `*.whl` archive and install it manually by issuing:
+
+```bash
+pip install --upgrade <FILE>.whl
+```
+
+You may also want to setup [virtual environment](https://docs.python.org/3/library/venv.html) first.
+
+---
 
+## Additional links ##
 
+* The `*.properties` syntax support is based on official [file format documentation](https://docs.oracle.com/cd/E23095_01/Platform.93/ATGProgGuide/html/s0204propertiesfileformat01.html).
diff --git a/docs/checks.md b/docs/checks.md
deleted file mode 100644
index d979cd9e..00000000
--- a/docs/checks.md
+++ /dev/null
@@ -1,153 +0,0 @@
-![prop-tool logo](../artwork/prop-tool-logo.png)
-
-# Java *.properties file checker and syncing tool #
-
-## Table of contents ##
-
-* [« Main README](../README.md)
-* [« Documentation table of contents](README.md)
-
-
-* **[Validators](#validators)**
-    * [Checking base and translation files](#checking-base-and-translation-files)
-* [Available checks](#available-checks)
-    * [Syntax check](#syntax-check)
-    * [Brackets](#brackets)
-    * [DanglingKeys](#dangling-keys)
-    * [EmptyTranslations](#empty-translations)
-    * [FormattingValues](#formatting-values)
-    * [KeyFormat](#key-format)
-    * [MissingTranslation](#missing-translation)
-    * [Punctuation](#punctuation)
-    * [QuotationMarks](#quotation-marks)
-    * [StartsWithTheSameCase](#starts-with-the-same-case)
-    * [TrailingWhiteChars](#trailing-white-chars)
-    * [TypesettingQuotationMarks](#typesetting-quotation-marks)
-    * [WhiteCharsBeforeLinefeed](#white-chars-before-linefeed)
-
----
-
-# Validators #
-
-The main purpose of `prop-tool` is to ensure all property files are correct and that translation files are in sync with the
-reference file. For that reason you need to have at least two `*.properties` files to use `prop-tool`. One is your base language
-(usually English texts) used as reference and all the others are your translations. `prop-tool` performs several checks on both
-base (reference) file and each translation.
-
-## Checking base and translation files ##
-
-Some validators can do their work having just single file to process. In such
-case you can use it to check both your base file and translation files. Those
-validators that needs base file reference (i.e. [DanglingKeys](#dangling-keys)
-can only be used to validate translations.
-
-# Available checks #
-
-## Syntax Check ##
-
-This validators ensures proper structire of the files, use of allowed comment markers, key - value separators etc.
-
-## Brackets ##
-
-Brackets validator ensures all brackets that are found opened in the string are also closed and there's no unpaired bracket left.
-
-## Dangling Keys ##
-
-DanglingKeys validator checks if keys found in translation file are also present in base file.
-
-## Empty Translations ##
-
-EmptyTranslations validator looks for translations that provide no content (empty string) for non-empty text in base file.
-
-## Formatting Values ##
-
-FormattingValues validators looks for commonly used `print()`-alike formatting values syntax, where placeholders like `%s` or `%d`
-are replaced with corresponding values at runtime. It assumes that the code expects the same placeholders to be available regardless
-of language version therefore it check if all placeholders used in original string are also present in translation string and if the
-order of said placeholders is preserved as this is also often crucial for the application to run properly.
-
-## Key Format ##
-
-KeyFormat ensures strings used as keys in you `*.properties` file matches specified pattern which helps keeping unified naming
-conventcion across your files.
-
-## Missing Translation ##
-
-MissingTranslation looks texts present in base file that are not provided in the translation.
-
-*NOTE:* as it's pretty often the case that translation files are not always update at the same time base files changes,
-`MissingTranslation` is smart enough to accept situation where translation file contains translation key commented (using specified
-string format) out but not the translation itself. This is sufficient for the translator to catch up and indicates that translation
-file was updated once base file changed. For example, given this `base.properties`:
-
-```ini
-someKey = Hello
-newlyAddedKey = I'm new here!
-```
-
-and following translation file: `base_xx.properties`
-
-```ini
-someKey = Hello
-# ==> newlyAddedKey =
-```
-
-the `newlyAddedKey` will be considered "present" in translation, despite being commented out. If you want to ensure there are all
-translated, you need to use `--strict` mode instead of default loose check mode.
-
-Default format can be changed using `--template` argument or `template` config entry.
-
-## Punctuation ##
-
-Punctuation check ensures translation ends with punctuation mark (`:`, `.`, `?`, `!`) if entry in base file ends that way.
-
-## Quotation Marks ##
-
-QuotationMarks ensures all quotation marks are unpaired.
-
-Matching quotation marks it tricky because in some languages there's single char that is used as opening and closing quotation
-mark (mainly `"`). This makes `QuotationMarks` unable to properly understand the context in case of use of subsequent marks of the
-same type, i.e. three `"` in a row: `"""` as it cannot say if 2nd one closes the quotation opened by first one, or maybe first is
-closed by third and the 2nd is just missing its closing mark and is misplaced. Therefore for the subsequent marks of the same type
-it's always assumed that that there's no quotation nesting. For example, for four `"` in a row `""""`
-it is assumed 1st is the opening marker, 2nd closes 1st, and 4th closes the 3rd.
-
-Things also more complicated if you want to mix the quotation marks and use apostrophes too. For example. `"'"'` (double quotes and
-apostrophes)
-will be marked as incorrect as you open `'` apostrophe marked quote before double quoted is closed. This may be problematic in some
-languages that use apostrophes as part of the sentence, i.e. `It's "me"`. This is currently sufficient to fool `QuotationMarks`
-as it will complain about not closed apostrophe marked quotation.
-
-Temporary workarounds:
-
-* Try to avoid using apostrophes as quotation marks (change `QuotationMarks` config to not handle it) if you need them in your
-  sentences.
-* Create `QuotationMarks` configuration per language so i.e. apostrophes are ignored in English, but checked in i.e. Polish which do
-  not use it as part of sentences.
-
-## Starts With The Same Case ##
-
-StartsWithTheSameCase ensures translation starts with the same character case (be it upper or lower cased) as string in base string.
-
-*NOTE:* This check makes no sense for languages like Asian (i.e. Chinese, Japanese etc) and you should configure language exception
-list for `StartsWithTheSameCase` to make is skip such translations from being checked.
-
-## Trailing White Chars ##
-
-TrailingWhiteChars simply looks at the end of your strings and comments and flags trailing spaces or tab charactes noticed.
-
-## Typesetting Quotation Marks ##
-
-TypesettingQuotationMarks is a mixture of `QuotationMarks` and `Brackets` check that understans quotation mark pairs
-(where you have separate quote opening and closing characters). It can look for them and ensure all is paired and properly nested.
-
-*NOTE:* This check usually needs some config tuning because it is not possible to create one universal set of quotation marks
-that fits all the languages. The reason is there are the cases where i.e. given character is considered closing quotation mark
-in one language and opening marker in another. As `QuotationMarks` does not understand the language it checks it cannot figure
-out how to handle such case automatically. The solution is to specify separate pairs for each language you want to support.
-
-## White Chars Before Linefeed ##
-
-`WhiteCharsBeforeLinefeed` ensures there's no space nor tab character placed before linefeed literals (`\n` and `\r`)
-as this usually serves no purpose.
-
diff --git a/docs/checks/README.md b/docs/checks/README.md
index b74079b2..65c5a094 100644
--- a/docs/checks/README.md
+++ b/docs/checks/README.md
@@ -9,7 +9,7 @@
 
 
 * **[Validators](#validators)**
-    * [Checking base and translation files](#checking-base-and-translation-files)
+  * [Checking base and translation files](#checking-base-and-translation-files)
 * Available checks
   * [Syntax check](syntax-check.md)
   * [Brackets](brackets.md)
@@ -25,7 +25,6 @@
   * [TypesettingQuotationMarks](typesetting-quotation-marks.md)
   * [WhiteCharsBeforeLinefeed](white-chars-before-linefeed.md)
 
-
 ---
 
 # Validators #
diff --git a/docs/checks/formatting-values.md b/docs/checks/formatting-values.md
index 614278c2..d15029fd 100644
--- a/docs/checks/formatting-values.md
+++ b/docs/checks/formatting-values.md
@@ -25,10 +25,10 @@
 
 ## Description ##
 
-The `FormattingValues` validators looks for commonly used `print()`-alike formatting values syntax, where placeholders like `%s` or `%d`
-are replaced with corresponding values at runtime. It assumes that the code expects the same placeholders to be available regardless
-of language version therefore it check if all placeholders used in original string are also present in translation string and if the
-order of said placeholders is preserved as this is also often crucial for the application to run properly.
+The `FormattingValues` validators looks for commonly used `print()`-alike formatting values syntax, where placeholders like `%s`
+or `%d` are replaced with corresponding values at runtime. It assumes that the code expects the same placeholders to be available
+regardless of language version therefore it check if all placeholders used in original string are also present in translation string
+and if the order of said placeholders is preserved as this is also often crucial for the application to run properly.
 
 ## Command line options ##
 
diff --git a/docs/checks/punctuation.md b/docs/checks/punctuation.md
index 8499ba97..466c75c9 100644
--- a/docs/checks/punctuation.md
+++ b/docs/checks/punctuation.md
@@ -14,6 +14,7 @@
     * [Description](#description)
     * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
+
 ---
 
 ## Summary ##
diff --git a/docs/developers.md b/docs/developers.md
new file mode 100644
index 00000000..62e16004
--- /dev/null
+++ b/docs/developers.md
@@ -0,0 +1,107 @@
+![prop-tool logo](artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+# Developer's corner #
+
+`prop-tool` is Python 3 application. It has no external runtime dependencies, however code quality is automatically checked using
+additional tools that require additional installation.  These tests are run automatically on the code repository against
+any new commited code and each pull-request created using Github Actions feature (see `.github/workflows` folder for
+configuration details).
+
+If you'd like to try them by hand locally here's how.
+
+## Virtual environment ##
+
+Fist, create virtual environment and activate it. **ALL Python related examples are assumed to be executed withing virtual
+environment and your working directory points to root folder of the project.**
+
+```bash
+$ python -m venv venv
+```
+
+Activate your environment in Bash compatible shell (if you are using different shell, i.e. Fish, check contents of `venv/bin/`
+folder for alternative scripts):
+
+```bash
+$ source venv/bin/activate
+```
+
+---
+
+## Unit tests ##
+
+Run unit tests using standard `unittest` feature (if you want more detailed output, add `-v` to the invocation):
+
+```bash
+$ python -m unittest discover
+...............................................................................................................
+----------------------------------------------------------------------
+Ran 111 tests in 0.047s
+
+OK
+```
+
+Unit tests can be run using [pytest](https://pytest.org/) package too (remove `--quiet` if you want to see
+tests details). Install `pytest` first:
+
+```bash
+$ pip install pytest
+```
+
+and then run:
+
+```bash
+$ pytest --quiet
+................................................................................. [ 72%]
+..............................                                                    [100%]
+111 passed in 0.24s
+```
+
+---
+
+## Python code QA ##
+
+I use `Flake8` and [wemake-python-styleguide](https://wemake-python-stylegui.de/en/latest/) and additional plugins to
+ensure code quality:
+
+```bash
+$ pip install wemake-python-styleguide
+```
+
+Lint the code (Default settings is very aggressive so `.flake8` config file tunes it to my requirements):
+
+```bash
+$ flake8 proptool/ tests/
+```
+
+No output meas no issues.
+
+
+---
+
+## Markdown lint ##
+
+Documentation is written using [markdown](https://en.wikipedia.org/wiki/Markdown) and is checked
+using [MarkdownLint](https://github.com/DavidAnson/markdownlint)
+with use of [markdown-cli](https://github.com/igorshubovych/markdownlint-cli) wrapper. This linter is unfortunately not a Python
+application, so virtual environment won't help us keep it isolated. It must be installed on your system using `npm` package manager.
+You may need to install `npm` first as it usually is not preinstalled:
+
+```bash
+sudo apt install npm
+```
+
+Next, install the linter (see [markdown-cli](https://github.com/igorshubovych/markdownlint-cli) page for more info):
+
+```bash
+npm install -g markdownlint-cli
+```
+
+and lint all `*.md` files (linter configuration lives in `.markdownlint.yaml` file):
+
+```bash
+markdownlint --ignore LICENSE.md **/*.md
+```
+
+Note, the `LICENSE.md` file is externally sourced, therefore I am not going to fix it.
diff --git a/docs/usage.md b/docs/usage.md
new file mode 100644
index 00000000..f7e1edf6
--- /dev/null
+++ b/docs/usage.md
@@ -0,0 +1,72 @@
+![prop-tool logo](artwork/prop-tool-logo.png)
+
+# Java *.properties file checker and syncing tool #
+
+## Usage examples ##
+
+Check if `de` translation of `test.properties` exists and is in sync:
+
+```bash
+prop-tool --base test.properties --lang de
+```
+
+You can omit `.properties` suffix in command line argument. NOTE: that file name must contain `.properties`
+suffix, otherwise it will not be found:
+
+```bash
+prop-tool --base test --lang de
+```
+
+it will then look for `test_de.properties` file in the same folder `test.properties` resides and check it.
+
+---
+
+Check if `de`, `pl` and `fr` translations of `test.properties` and `gui.properties` exist and are in sync:
+
+```bash
+prop-tool --base test gui --lang de pl fr
+```
+
+it will then look for and validate following files
+
+```bash
+test_de.properties
+test_pl.properties
+test_fr.properties
+gui_de.properties
+gui_pl.properties
+gui_fr.properties
+```
+
+---
+
+Check if `es` translation of `gui.properties` is in sync and if there are any missing keys, rewrite translation file to contain all
+keys from base:
+
+```bash
+prop-tool --base gui --lang es --fix
+```
+
+---
+
+Check if `pt` translation of `gui.properties` is in sync and if there are any missing keys, rewrite translation file to contain all
+keys from base using own comment format:
+
+```bash
+prop-tool --base gui --lang es --fix --tpl "COM >~=-> KEY SEP"
+```
+
+---
+
+## Updating translations ##
+
+You can use `prop-tool` to update your translation files by using `--fix` option. In such case `prop-tool` will completely rewrite
+translation files, adding missing keys (in commented out form).
+
+While content of written file is strongly based on base file Some normalization will be made
+
+* There will be no more than one empty consequent empty line written,
+* There will be no more than one consequent empty comment line (just comment marker) written.
+
+NOTE: Be aware that `--fix` do NOT update existing translation file but builds it completely using base file as reference and
+existing translations (if present). No other content of translation files (for example additional comments etc) will be preserved.

From 71f6096301824a5eca9de83682dd863631a0dc44 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 13:32:42 +0200
Subject: [PATCH 042/140] MD Lint config tweaks

---
 .markdownlint.yaml                         |  5 +++--
 README.md                                  | 25 ++++++++++++++++------
 docs/CHANGES.md                            |  6 ++++++
 docs/README.md                             |  4 +++-
 docs/checks/README.md                      |  4 +++-
 docs/checks/brackets.md                    |  4 +++-
 docs/checks/dangling-keys.md               |  4 +++-
 docs/checks/empty-translations.md          |  4 +++-
 docs/checks/formatting-values.md           |  4 +++-
 docs/checks/key-format.md                  |  4 +++-
 docs/checks/missing-translations.md        |  4 +++-
 docs/checks/punctuation.md                 |  4 +++-
 docs/checks/quotation-marks.md             |  4 +++-
 docs/checks/starts-with-the-same-case.md   |  4 +++-
 docs/checks/syntax-check.md                |  4 +++-
 docs/checks/trailing-white-chars.md        |  4 +++-
 docs/checks/typesetting-quotation-marks.md |  4 +++-
 docs/checks/white-chars-before-linefeed.md |  4 +++-
 docs/developers.md                         |  6 ++++--
 docs/usage.md                              |  2 +-
 proptool/const.py                          |  2 +-
 21 files changed, 79 insertions(+), 27 deletions(-)

diff --git a/.markdownlint.yaml b/.markdownlint.yaml
index c0242d12..06dd7ef6 100644
--- a/.markdownlint.yaml
+++ b/.markdownlint.yaml
@@ -11,9 +11,10 @@ extends: null
 MD001: true
 
 # MD002/first-heading-h1/first-header-h1 - First heading should be a top-level heading
-MD002:
+MD002: false # MOR (this is because we want the tool's description under the logo to be ### and this is first header).
   # Heading level
-  level: 1
+  # level: 1
+
 
 # MD003/heading-style/header-style - Heading style
 MD003:
diff --git a/README.md b/README.md
index d1fa9299..b1c70da8 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,8 @@
 ![prop-tool logo](artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 [master](https://github.com/MarcinOrlowski/prop-tool/tree/master) branch:
 [![Unit tests](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/unittests.yml/badge.svg?branch=master)](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/unittests.yml)
@@ -14,6 +16,8 @@
 [![Code lint](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/linter.yml/badge.svg?branch=dev)](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/linter.yml)
 [![MD Lint](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/markdown.yml/badge.svg?branch=dev)](https://github.com/MarcinOrlowski/prop-tool/actions/workflows/markdown.yml)
 
+---
+
 ## Table of contents ##
 
 * [Introduction](#introduction)
@@ -30,11 +34,20 @@
 
 ## Introduction ##
 
-`prop-tool` is a small but powerful utility aimed at your (mainly Java) projects' `*.properties` files. Its main role is to ensure
-all files are syntactically correct and all the translation files are in sync with base (main language) file. It also comes with
-huge set of various linters and checkers to guard quality of the files' contents. It can check for missing or dangling keys,
-inproper punctuation, open brackets, quotation marks and more. It can also automatically sync translation files quickly providing
-fresh template for your translators to work on.
+`prop-tool` is a small but powerful utility aimed at your projects' `*.properties` files. It looks like text based INI file, but it
+is even simpler and because to its simplicity, this file format is often used to keep the configurations or translations (i.e. in
+Java world). Example file:
+
+```ini
+programTitle = Prop-Tool v1.3
+okButton = "OK"
+```
+
+The main role of `prop-tool` is to help you keep your `*.properties` files in order, ensuring all files are
+syntactically correct and all the translation files are in sync with base (main language) file. It also comes with huge set of
+various linters and checkers to guard quality of the files' contents. It can check for missing or dangling keys, inproper
+punctuation, open brackets, quotation marks and more. It can also automatically sync translation files quickly providing fresh
+template for your translators to work on.
 
 ```bash
 $ prop-tool -b mark -l pl -v
diff --git a/docs/CHANGES.md b/docs/CHANGES.md
index dd11b1dd..30d4480b 100644
--- a/docs/CHANGES.md
+++ b/docs/CHANGES.md
@@ -1,3 +1,9 @@
+![prop-tool logo](../artwork/prop-tool-logo.png)
+
+### The *.properties file checker and syncing tool ###
+
+---
+
 # Changelog #
 
 * dev
diff --git a/docs/README.md b/docs/README.md
index fa62e509..12437c0d 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,6 +1,8 @@
 ![prop-tool logo](../artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 ## Table of contents ##
 
diff --git a/docs/checks/README.md b/docs/checks/README.md
index 65c5a094..42821014 100644
--- a/docs/checks/README.md
+++ b/docs/checks/README.md
@@ -1,6 +1,8 @@
 ![prop-tool logo](../../artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 ## Table of contents ##
 
diff --git a/docs/checks/brackets.md b/docs/checks/brackets.md
index 21009aac..52ce99f4 100644
--- a/docs/checks/brackets.md
+++ b/docs/checks/brackets.md
@@ -1,6 +1,8 @@
 ![prop-tool logo](../../artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 ## Brackets ##
 
diff --git a/docs/checks/dangling-keys.md b/docs/checks/dangling-keys.md
index de4df386..2224eab2 100644
--- a/docs/checks/dangling-keys.md
+++ b/docs/checks/dangling-keys.md
@@ -1,6 +1,8 @@
 ![prop-tool logo](../../artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 ## Dangling Keys ##
 
diff --git a/docs/checks/empty-translations.md b/docs/checks/empty-translations.md
index 6ca1c67e..5f1154f8 100644
--- a/docs/checks/empty-translations.md
+++ b/docs/checks/empty-translations.md
@@ -1,6 +1,8 @@
 ![prop-tool logo](../../artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 ## Empty Translations ##
 
diff --git a/docs/checks/formatting-values.md b/docs/checks/formatting-values.md
index d15029fd..a2859571 100644
--- a/docs/checks/formatting-values.md
+++ b/docs/checks/formatting-values.md
@@ -1,6 +1,8 @@
 ![prop-tool logo](../../artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 ## Formatting Values ##
 
diff --git a/docs/checks/key-format.md b/docs/checks/key-format.md
index 21551cc5..5704d7c5 100644
--- a/docs/checks/key-format.md
+++ b/docs/checks/key-format.md
@@ -1,6 +1,8 @@
 ![prop-tool logo](../../artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 ## Key Format ##
 
diff --git a/docs/checks/missing-translations.md b/docs/checks/missing-translations.md
index bf0243a5..c5ef6d82 100644
--- a/docs/checks/missing-translations.md
+++ b/docs/checks/missing-translations.md
@@ -1,6 +1,8 @@
 ![prop-tool logo](../../artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 ## Missing Translations ##
 
diff --git a/docs/checks/punctuation.md b/docs/checks/punctuation.md
index 466c75c9..df0ad907 100644
--- a/docs/checks/punctuation.md
+++ b/docs/checks/punctuation.md
@@ -1,6 +1,8 @@
 ![prop-tool logo](../../artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 ## Punctuation ##
 
diff --git a/docs/checks/quotation-marks.md b/docs/checks/quotation-marks.md
index 15d0b916..0ce734a0 100644
--- a/docs/checks/quotation-marks.md
+++ b/docs/checks/quotation-marks.md
@@ -1,6 +1,8 @@
 ![prop-tool logo](../../artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 ## Quotation Marks ##
 
diff --git a/docs/checks/starts-with-the-same-case.md b/docs/checks/starts-with-the-same-case.md
index 5b586c43..da23e7b7 100644
--- a/docs/checks/starts-with-the-same-case.md
+++ b/docs/checks/starts-with-the-same-case.md
@@ -1,6 +1,8 @@
 ![prop-tool logo](../../artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 ## Starts With The Same Case ##
 
diff --git a/docs/checks/syntax-check.md b/docs/checks/syntax-check.md
index 38c18e9c..57ccb0cb 100644
--- a/docs/checks/syntax-check.md
+++ b/docs/checks/syntax-check.md
@@ -1,6 +1,8 @@
 ![prop-tool logo](../../artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 ## Syntax Check ##
 
diff --git a/docs/checks/trailing-white-chars.md b/docs/checks/trailing-white-chars.md
index 31fdefdf..520f5798 100644
--- a/docs/checks/trailing-white-chars.md
+++ b/docs/checks/trailing-white-chars.md
@@ -1,6 +1,8 @@
 ![prop-tool logo](../../artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 ## Trailing White Chars ##
 
diff --git a/docs/checks/typesetting-quotation-marks.md b/docs/checks/typesetting-quotation-marks.md
index 3cfd7c0a..e4d2c49b 100644
--- a/docs/checks/typesetting-quotation-marks.md
+++ b/docs/checks/typesetting-quotation-marks.md
@@ -1,6 +1,8 @@
 ![prop-tool logo](../../artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 ## Typesetting Quotation Marks ##
 
diff --git a/docs/checks/white-chars-before-linefeed.md b/docs/checks/white-chars-before-linefeed.md
index 026f10cc..20f80e5b 100644
--- a/docs/checks/white-chars-before-linefeed.md
+++ b/docs/checks/white-chars-before-linefeed.md
@@ -1,6 +1,8 @@
 ![prop-tool logo](../../artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 ## White Chars Before Linefeed ##
 
diff --git a/docs/developers.md b/docs/developers.md
index 62e16004..c87ad98d 100644
--- a/docs/developers.md
+++ b/docs/developers.md
@@ -1,6 +1,8 @@
-![prop-tool logo](artwork/prop-tool-logo.png)
+![prop-tool logo](../artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
 
 # Developer's corner #
 
diff --git a/docs/usage.md b/docs/usage.md
index f7e1edf6..435c71d2 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -1,6 +1,6 @@
 ![prop-tool logo](artwork/prop-tool-logo.png)
 
-# Java *.properties file checker and syncing tool #
+# The *.properties file checker and syncing tool #
 
 ## Usage examples ##
 
diff --git a/proptool/const.py b/proptool/const.py
index 6146581d..b8985e16 100644
--- a/proptool/const.py
+++ b/proptool/const.py
@@ -17,6 +17,6 @@ class Const(object):
 
     APP_DESCRIPTION: List[str] = [
         f'{APP_NAME} v{APP_VERSION} * Copyright 2021 by Marcin Orlowski.',
-        'Java *.properties file checker and syncing tool.',
+        'The *.properties file checker and syncing tool.',
         f'{APP_URL}',
     ]

From 3ed807e8d314a8e6cbc35dd295e1e76cf01bd006 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 13:35:11 +0200
Subject: [PATCH 043/140] Docs cleanup

---
 README.md      | 28 ----------------------------
 docs/README.md |  8 ++++++++
 docs/usage.md  | 23 +++++++++++++++++++++++
 3 files changed, 31 insertions(+), 28 deletions(-)

diff --git a/README.md b/README.md
index b1c70da8..7dd2f65a 100644
--- a/README.md
+++ b/README.md
@@ -75,34 +75,6 @@ Base: mark.properties
         W: Line 14:11: No closing mark for ".
 ```
 
-## Config file and command line arguments ##
-
-You can use `prop-tool` by providing all required parameters directly from command line (see `--help`), or you can create
-configuration file and use `--config` option to make `prop-tool` load it and use. Almost all options can be set in configuration
-files, which helps, for example using `prop-tool` as part of CI/CD or GitHub Actions.
-
-Configuration file is plain text file, following [INI file format](https://en.wikipedia.org/wiki/INI_file) and can be created using
-any text editor. Please see commented [config.ini](config.ini) for example configuration file and all available options.
-
-> NOTE: when using configuration file and command line arguments, the order of precedence is this:
->
-> * default configuration goes first,
-> * if config file is given and can be loaded and parsed, then it overrides default configuration,
-> * if there's any command but line argument `--config` specified, then it overrides whatever is is set in config file.
->
-> For example:
->
-> * by default, `verbose` option is off,
-> * your config file sets `verbose = true`, enabling verbose output,
-> * but your invocation is `prop-tool --config config.ini --no-verbose`, therefore `verbose` mode is set `OFF`.
-
-## Limitations ##
-
-* As of now `prop-tool` do not handle multiline entries.
-* `FormattingValues` check will do not support positional placeholders, formats using space leading positive numbers.
-* `TypesettingQuotationMarks` is not covering all possible pairs yet due
-  to [limitations of current implementation](https://github.com/MarcinOrlowski/prop-tool/issues/19).
-
 ## License ##
 
 * Written and copyrighted &copy;2021 by Marcin Orlowski <mail (#) marcinorlowski (.) com>
diff --git a/docs/README.md b/docs/README.md
index 12437c0d..3bb41a7d 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -36,6 +36,14 @@ You may also want to setup [virtual environment](https://docs.python.org/3/libra
 
 ---
 
+## Limitations ##
+
+* As of now `prop-tool` do not handle multiline entries.
+* `FormattingValues` check will do not support positional placeholders, formats using space leading positive numbers.
+* `TypesettingQuotationMarks` is not covering all possible pairs yet due
+  to [limitations of current implementation](https://github.com/MarcinOrlowski/prop-tool/issues/19).
+
+
 ## Additional links ##
 
 * The `*.properties` syntax support is based on official [file format documentation](https://docs.oracle.com/cd/E23095_01/Platform.93/ATGProgGuide/html/s0204propertiesfileformat01.html).
diff --git a/docs/usage.md b/docs/usage.md
index 435c71d2..6999854c 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -2,6 +2,29 @@
 
 # The *.properties file checker and syncing tool #
 
+
+## Config file and command line arguments ##
+
+You can use `prop-tool` by providing all required parameters directly from command line (see `--help`), or you can create
+configuration file and use `--config` option to make `prop-tool` load it and use. Almost all options can be set in configuration
+files, which helps, for example using `prop-tool` as part of CI/CD or GitHub Actions.
+
+Configuration file is plain text file, following [INI file format](https://en.wikipedia.org/wiki/INI_file) and can be created using
+any text editor. Please see commented [config.ini](../config.ini) for example configuration file and all available options.
+
+> NOTE: when using configuration file and command line arguments, the order of precedence is this:
+>
+> * default configuration goes first,
+> * if config file is given and can be loaded and parsed, then it overrides default configuration,
+> * if there's any command but line argument `--config` specified, then it overrides whatever is is set in config file.
+>
+> For example:
+>
+> * by default, `verbose` option is off,
+> * your config file sets `verbose = true`, enabling verbose output,
+> * but your invocation is `prop-tool --config config.ini --no-verbose`, therefore `verbose` mode is set `OFF`.
+
+
 ## Usage examples ##
 
 Check if `de` translation of `test.properties` exists and is in sync:

From ef7f945f6703088a192ff4e58b96ca3a6736f4de Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 13:36:04 +0200
Subject: [PATCH 044/140] Removed duplicated anchor

---
 README.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 7dd2f65a..dc7766b4 100644
--- a/README.md
+++ b/README.md
@@ -26,9 +26,8 @@
   * [Usage examples](docs/usage.md)
   * [Config file](docs/config.md)
 * [Features](#features)
-* [Extensive documentation](docs/README.md)
-* [License](#license)
 * [Changelog](docs/CHANGES.md)
+* [License](#license)
 
 ---
 

From 7355d3406ab08043db3f34fd6714b6371cf21b77 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 13:36:38 +0200
Subject: [PATCH 045/140] Added comment to prop file example

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index dc7766b4..0c8a12a3 100644
--- a/README.md
+++ b/README.md
@@ -38,6 +38,7 @@ is even simpler and because to its simplicity, this file format is often used to
 Java world). Example file:
 
 ```ini
+# Example of *.properties file
 programTitle = Prop-Tool v1.3
 okButton = "OK"
 ```

From b6fa2f2836e9c4558951cbdd2cd4fa130809524c Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 14:22:31 +0200
Subject: [PATCH 046/140] Added config file related docs

---
 docs/config.md | 79 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 docs/config.md

diff --git a/docs/config.md b/docs/config.md
new file mode 100644
index 00000000..daea1b44
--- /dev/null
+++ b/docs/config.md
@@ -0,0 +1,79 @@
+![prop-tool logo](artwork/prop-tool-logo.png)
+
+# The *.properties file checker and syncing tool #
+
+# Config file #
+
+You can drive and control `prop-tool` with use of configuration file, which gives you most control over application behavior. Almost
+all options, including validators' settings can be configured in configuration files, which helps for example using `prop-tool` as
+part of CI/CD or GitHub Actions.
+
+Configuration file is plain text file, following [INI file format](https://en.wikipedia.org/wiki/INI_file) and can be created using
+any text editor. Please see commented [config.ini](../config.ini) for example configuration file reference.
+
+You should be using standard `UTF-8` encoding for your configuration file.
+
+## Syntax ##
+
+Configuration file is separated into sections. Each section starts with section header put in separate line between square brackets,
+followed by section related configuration items. Items are usally in `key = value` form. All keys are always lower-cased, and for
+keys containing multiple words, the single underscore character `_` is used as a separator (i.e. `quotation_marks`).
+
+```ini
+
+```ini
+[section]
+version = 1
+```
+
+Value can be a string, numeric value, boolean value (`true` or `false`) or list of elements:
+
+```ini
+[example]
+numericValue = 1
+
+# This is a comment
+stringValue1 = Quotes are not needed
+stringValue2 = "But can be used if required"
+
+thisIsTrue1 = true
+thisIsTrue2 = 1
+thisIsFalse1 = false
+thisIsFalse2 = 0
+
+# All elements can go into one line, comma separated
+thisIsList = ["foo", "bar"]
+
+# Each element can live in separate line to. (comma) separator is optional in that case
+thisIsListToo = [
+                "one"
+                two
+                "three"
+                ]
+```
+
+# Sections #
+
+Presence of main section `[prop-tool]` in config file is mandatory, however with the exception for `version` element, all items are
+optional with application defaults used for non-specified elements.
+
+If any of available validators can be configured, all its settings are placed in separate section, witch name of the section being
+Validator ID as specified in validator documentation.
+
+Example config file disables ANSI colors in program output and enables output verbose mode. It also
+configures [Brackets](checks/brackets.md)
+validator to only handle given set of brackets:
+
+```ini
+[prop-tool]
+# Version of configuration file format. Currently equals to 1
+version = 1
+
+color = false
+verbose = true
+
+# Validator section names are case sensitive!
+[Brackets]
+opening = ["(", "["]
+closing = [')', ']']
+```

From 1c66ce192481c4f7d89f4ce801a2e719e7c3451e Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 16:02:39 +0200
Subject: [PATCH 047/140] MD lint fixes

---
 docs/checks/brackets.md                    | 26 ++++++++++++++++---
 docs/checks/key-format.md                  | 30 +++++++++++++++++++++-
 docs/checks/punctuation.md                 | 23 +++++++++++++++--
 docs/checks/quotation-marks.md             | 28 ++++++++++++++++----
 docs/checks/typesetting-quotation-marks.md | 30 +++++++++++++++++-----
 docs/config.md                             |  9 ++++++-
 proptool/checks/quotation_marks.py         | 12 +++++----
 7 files changed, 135 insertions(+), 23 deletions(-)

diff --git a/docs/checks/brackets.md b/docs/checks/brackets.md
index 52ce99f4..5c3a7af5 100644
--- a/docs/checks/brackets.md
+++ b/docs/checks/brackets.md
@@ -14,8 +14,10 @@
   * **Brackets**
     * [Summary](#summary)
     * [Description](#description)
-    * [Command line options](#command-line-options)  
+    * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
+      * [Important notes](#notes)
+      * [Example](#example)
 
 ---
 
@@ -29,11 +31,29 @@
 
 `Brackets` ensures all brackets that are found opened in the string are also closed and there's no unpaired bracket left.
 
-
 ## Command line options ##
 
 No dedicated command line options for this validator.
 
 ## Configuration file ##
 
-TODO
+| Key       | Type      | Description | Example |
+|-----------|-----------|-------------|---------|
+| opening   | List of strings | List of opening brackets | `[ "[", "<" ]` |
+| closing   | List of strings | List of closing brackets | `[ "]", ">" ]` |
+
+### Notes ###
+
+**IMPORTANT:** Opening and closing brackets from the same pair MUST be on the same position (i,e. if first element of `opening` list
+is `{` then the `}` MUST be first element on `closing` list.
+
+### Example ###
+
+```ini
+[prop-tool]
+version = 1
+
+[Brackets]
+opening = [ "(", "<", "{", "[" ]
+closing = [ ")", ">", "}", "]" ]
+```
diff --git a/docs/checks/key-format.md b/docs/checks/key-format.md
index 5704d7c5..9e7a0efe 100644
--- a/docs/checks/key-format.md
+++ b/docs/checks/key-format.md
@@ -16,6 +16,8 @@
     * [Description](#description)
     * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
+      * [Important notes](#notes)
+      * [Example](#example)
 
 ---
 
@@ -36,4 +38,30 @@ No dedicated command line options for this validator.
 
 ## Configuration file ##
 
-TODO
+| Key       | Type      | Description | Example |
+|-----------|-----------|-------------|---------|
+| pattern   | Regular expression (string) | Pattern for that each key must match | `"^[a-z]+[a-zA-Z0-9_.]*[a-zA-Z0-9]+$"` |
+
+### Notes ###
+
+* You can use on-line services like [PyRegEx](http://www.pyregex.com/) to test your regular expression first.
+* New to regular expressions? See some tutorials first:
+  * [Regex tutorial — A quick cheatsheet by examples](https://medium.com/factory-mind/regex-tutorial-a-simple-cheatsheet-by-examples-649dc1c3f285)
+  * [Regular Expression HOWTO](https://docs.python.org/3/howto/regex.html)
+  * [Python Regular Expression (RegEx) Tutorial](https://pythonexamples.org/python-regular-expression-regex-tutorial/)
+  * [Python RegEx](https://www.programiz.com/python-programming/regex)
+  * [Python Regular Expressions](https://developers.google.com/edu/python/regular-expressions#repetition-examples)
+  * **[Find moar!](https://duckduckgo.com/?q=regular+expression+tutorials)**
+  
+Note, as regular expression are programming language independent, it's more than
+sufficient to follow any tutorial that you find understandable.
+
+### Example ###
+
+```ini
+[prop-tool]
+version = 1
+
+[KeyFormat]
+pattern = "^[a-z]+[a-zA-Z0-9_.]*[a-zA-Z0-9]+$"
+```
diff --git a/docs/checks/punctuation.md b/docs/checks/punctuation.md
index df0ad907..31a13487 100644
--- a/docs/checks/punctuation.md
+++ b/docs/checks/punctuation.md
@@ -16,7 +16,9 @@
     * [Description](#description)
     * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
-
+      * [Important notes](#notes)
+      * [Example](#example)
+  
 ---
 
 ## Summary ##
@@ -35,4 +37,21 @@ No dedicated command line options for this validator.
 
 ## Configuration file ##
 
-TODO
+| Key       | Type      | Description | Example |
+|-----------|-----------|-------------|---------|
+| chars   | List of strings | List of punctuation characters | `[ ".", "?", "!", ":" ]` |
+
+### Notes ###
+
+None.
+
+### Example ###
+
+```ini
+[prop-tool]
+version = 1
+
+[Punctuation]
+chars = [ ".", "?" ]
+```
+
diff --git a/docs/checks/quotation-marks.md b/docs/checks/quotation-marks.md
index 0ce734a0..a0ac3420 100644
--- a/docs/checks/quotation-marks.md
+++ b/docs/checks/quotation-marks.md
@@ -16,6 +16,8 @@
     * [Description](#description)
     * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
+      * [Important notes](#notes)
+      * [Example](#example)
 
 ---
 
@@ -37,10 +39,9 @@ it's always assumed that that there's no quotation nesting. For example, for fou
 it is assumed 1st is the opening marker, 2nd closes 1st, and 4th closes the 3rd.
 
 Things also more complicated if you want to mix the quotation marks and use apostrophes too. For example. `"'"'` (double quotes and
-apostrophes)
-will be marked as incorrect as you open `'` apostrophe marked quote before double quoted is closed. This may be problematic in some
-languages that use apostrophes as part of the sentence, i.e. `It's "me"`. This is currently sufficient to fool `QuotationMarks`
-as it will complain about not closed apostrophe marked quotation.
+apostrophes) will be marked as incorrect as you open `'` apostrophe marked quote before double quoted is closed. This may be
+problematic in some languages that use apostrophes as part of the sentence, i.e. `It's "me"`. This is currently sufficient to
+fool `QuotationMarks` as it will complain about not closed apostrophe marked quotation.
 
 Temporary workarounds:
 
@@ -55,4 +56,21 @@ No dedicated command line options for this validator.
 
 ## Configuration file ##
 
-TODO
+| Key       | Type      | Description | Example |
+|-----------|-----------|-------------|---------|
+| chars   | List of strings | List of quotation marks | `[ '"', "`" ]` |
+
+### Notes ###
+
+**IMPORTANT:** we do NOT support apostrophes, because some languages, i. e. in English it can be used in sentence: "Dogs' food".
+
+### Example ###
+
+```ini
+[prop-tool]
+version = 1
+
+[QuotationMarks]
+# Do NOT use apostrophe character for languages like English
+chars = [ "`", '"' ]
+```
diff --git a/docs/checks/typesetting-quotation-marks.md b/docs/checks/typesetting-quotation-marks.md
index e4d2c49b..e18276f9 100644
--- a/docs/checks/typesetting-quotation-marks.md
+++ b/docs/checks/typesetting-quotation-marks.md
@@ -16,6 +16,8 @@
     * [Description](#description)
     * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
+      * [Important notes](#notes)
+      * [Example](#example)
 
 ---
 
@@ -30,15 +32,31 @@
 TypesettingQuotationMarks is a mixture of `QuotationMarks` and `Brackets` check that understans quotation mark pairs
 (where you have separate quote opening and closing characters). It can look for them and ensure all is paired and properly nested.
 
-*NOTE:* This check usually needs some config tuning because it is not possible to create one universal set of quotation marks
-that fits all the languages. The reason is there are the cases where i.e. given character is considered closing quotation mark
-in one language and opening marker in another. As `QuotationMarks` does not understand the language it checks it cannot figure
-out how to handle such case automatically. The solution is to specify separate pairs for each language you want to support.
-
 ## Command line options ##
 
 No dedicated command line options for this validator.
 
 ## Configuration file ##
 
-TODO
+| Key       | Type      | Description | Example |
+|-----------|-----------|-------------|---------|
+| opening   | List of strings | List of opening brackets | `[ '‘', '«' ]` |
+| closing   | List of strings | List of closing brackets | `[ '’', '»' ]` |
+
+### Notes ###
+
+*IMPORTANT:* This check usually needs some config tuning because it is not possible to create one universal set of quotation marks
+that fits all the languages. The reason is there are the cases where i.e. given character is considered closing quotation mark
+in one language and opening marker in another. As `QuotationMarks` does not understand the language it checks it cannot figure
+out how to handle such case automatically. The solution is to specify separate pairs for each language you want to support.
+
+### Example ###
+
+```ini
+[prop-tool]
+version = 1
+
+[TypesettingQuotationMarks]
+opening = ['‘', '«', '„', '「', '《']
+closing = ['’', '»', '“', '」', '》']
+```
diff --git a/docs/config.md b/docs/config.md
index daea1b44..3a4d6e29 100644
--- a/docs/config.md
+++ b/docs/config.md
@@ -17,7 +17,11 @@ You should be using standard `UTF-8` encoding for your configuration file.
 
 Configuration file is separated into sections. Each section starts with section header put in separate line between square brackets,
 followed by section related configuration items. Items are usally in `key = value` form. All keys are always lower-cased, and for
-keys containing multiple words, the single underscore character `_` is used as a separator (i.e. `quotation_marks`).
+keys containing multiple words, the single underscore character `_` is used as a separator (i.e. `quotation_marks`). String values
+can be quoted using either double quotes `"` or apostrophe `'`. You can use both but types cannot be mixed
+(if you open using i.e. `"` you must close using `"` too). Quotes can also be omited, but quotation character is part of your value
+then it must be explicitely marked so by either being part of quoted string (i.e. `'` is part of the
+value: `key = 'value contains " character'`).
 
 ```ini
 
@@ -35,6 +39,9 @@ numericValue = 1
 # This is a comment
 stringValue1 = Quotes are not needed
 stringValue2 = "But can be used if required"
+stringValue3 = 'Single quotes are fine too'
+stringValue4 = 'You can "mix quotes" too'
+stringValue5 = "As last resort, you can \"escape\" quites"
 
 thisIsTrue1 = true
 thisIsTrue2 = 1
diff --git a/proptool/checks/quotation_marks.py b/proptool/checks/quotation_marks.py
index 9e629774..0fd16f91 100644
--- a/proptool/checks/quotation_marks.py
+++ b/proptool/checks/quotation_marks.py
@@ -35,10 +35,6 @@ class QuotationMarks(Check):
     def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None) -> ReportGroup:
         report = ReportGroup('Quotation marks')
 
-        # NOTE: we do not support apostrophe, because i.e. in English it can be used in sentence: "Dogs' food"
-        # Not sure how to deal with this (and I do not want to do dictionary match)
-        supported_marks: Set[str] = {'"', '`'}
-
         for line_idx, item in enumerate(translation_file.items):
             # Do not try to be clever and filter() data first, because line_number values will no longer be correct.
             if not isinstance(item, (Translation, Comment)):
@@ -46,7 +42,7 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
 
             stack: List[Mark] = []
             for pos, current_char in enumerate(item.value):
-                if current_char not in supported_marks:
+                if current_char not in self.config.checks['QuotationMarks']['chars']:
                     continue
 
                 if not stack:
@@ -70,3 +66,9 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
                 break
 
         return report
+
+    @overrides(Check)
+    def get_default_config(self) -> Dict:
+        return {
+            'chars': ['"', '`'],
+        }

From 80427f8889ad39c8d78a3128490afadaa54411c2 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 18:14:52 +0200
Subject: [PATCH 048/140] Added missing import

---
 proptool/checks/quotation_marks.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/proptool/checks/quotation_marks.py b/proptool/checks/quotation_marks.py
index 0fd16f91..3afe193c 100644
--- a/proptool/checks/quotation_marks.py
+++ b/proptool/checks/quotation_marks.py
@@ -7,7 +7,7 @@
 #
 """
 
-from typing import List
+from typing import Dict, List
 
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Comment, Translation

From 27ed36d45693a5f329a9a7e40d2162235052d79c Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 26 Jul 2021 22:38:17 +0200
Subject: [PATCH 049/140] --quiet and --verbose handling

---
 config.ini                          |   4 +-
 docs/config.md                      |  29 +++++-
 docs/developers.md                  |  24 ++++-
 proptool/config/config_builder.py   |  11 +--
 tests/config/test_config_builder.py | 141 +++++++++++++++++++++-------
 5 files changed, 163 insertions(+), 46 deletions(-)

diff --git a/config.ini b/config.ini
index 084a2d14..72ad3f2d 100644
--- a/config.ini
+++ b/config.ini
@@ -4,12 +4,12 @@ version = 1
 
 comment = '#'
 separator = "="
+# Supported log levels: 0 = quiet, 1 = normal, 2 = verbose
+log_level = 1
 debug = false
 fatal = false
 color = true
-quiet = false
 strict = false
-verbose = false
 
 [Brackets]
 # Keep matching elements at the same positions
diff --git a/docs/config.md b/docs/config.md
index 3a4d6e29..da676713 100644
--- a/docs/config.md
+++ b/docs/config.md
@@ -59,7 +59,7 @@ thisIsListToo = [
                 ]
 ```
 
-# Sections #
+# Structure #
 
 Presence of main section `[prop-tool]` in config file is mandatory, however with the exception for `version` element, all items are
 optional with application defaults used for non-specified elements.
@@ -84,3 +84,30 @@ verbose = true
 opening = ["(", "["]
 closing = [')', ']']
 ```
+
+# prop-tool section #
+
+The following elements are supported in `[prop-tool]` section
+
+| Key       | CLI switch    | Argument type | Default | Description |
+|-----------|---------------|---------------|---------|-------------|
+| comment   | `--comment`   | String        | `#`     | TODO |
+| separator | `--separator` | String        | `=`     | TODO |
+| log_level | `--log-level` | Integer       | `1`     | Sets log verbosity at specified level. |
+
+Switches. Each option how corresponding two command line switches, turning feature on (`--<OPTION>`)
+and turning it off (`--no-<OPTION>`). Only one command line argument can be used at the same time.
+
+| Key       | CLI switches |Argument type      | Default | Description |
+|-----------|-----------|-------------|---------|------------|
+| fatal   | `--fatal`, `--no-fatal` | Boolean | `false` | When used all validators' warnings are fatal as errors. |
+| color   | `--color`/`--no-color` | Boolean | `true` | When `true`, application output will be using ANSI colors.|
+
+## Supported Log verbosity levels ##
+
+| Level | Description |
+|-------|-------------|
+| `0`   | Quiet mode. All but fatal errors are muted. Equivalent of using `--quiet` switch. |
+| `1`   | Normal log level, warning and errors are shown plus some additional information if necessary. |
+| `2`   | Verbose mode, shows more information during runtime. Equivalent of using `--verbose` switch. |
+
diff --git a/docs/developers.md b/docs/developers.md
index c87ad98d..49f64a97 100644
--- a/docs/developers.md
+++ b/docs/developers.md
@@ -77,8 +77,29 @@ Lint the code (Default settings is very aggressive so `.flake8` config file tune
 $ flake8 proptool/ tests/
 ```
 
-No output meas no issues.
+No output means no issues.
 
+---
+
+## Packaging ##
+
+Install `wheel` first:
+
+```bash
+$ pip install wheel
+```
+
+and create Wheel package:
+
+```bash
+$ python3 setup.py sdist bdist_wheel
+```
+
+and install the package in your local virtual environment:
+
+```bash
+$ pip install --upgrade dist/prop_tool-<VERSION>-py3-none-any.whl
+```
 
 ---
 
@@ -107,3 +128,4 @@ markdownlint --ignore LICENSE.md **/*.md
 ```
 
 Note, the `LICENSE.md` file is externally sourced, therefore I am not going to fix it.
+
diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 9d7286ce..de729a26 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -28,8 +28,6 @@ class ConfigBuilder(object):
     _on_off_pairs = [
         'fatal',
         'strict',
-        'quiet',
-        'verbose',
         'color',
     ]
 
@@ -77,6 +75,7 @@ def _set_on_off_option(config: Config, args, option_name: str) -> None:
         """
         Changes Config's entry if either --<option> or --<no-option> switch is set.
         If none is set, returns Config object unaltered.
+
         :param config:
         :param args:
         :param option_name:
@@ -168,12 +167,8 @@ def _parse_args() -> argparse:
         group = parser.add_argument_group('Application controls')
         group.add_argument('-q', '--quiet', action = 'store_true', dest = 'quiet',
                            help = 'Enables quiet mode, mutting all output but fatal errors.')
-        group.add_argument('-nq', '--no-quiet', action = 'store_true', dest = 'no_quiet',
-                           help = 'Disables quiet mode, enabling all type of messages (default).')
         group.add_argument('-v', '--verbose', action = 'store_true', dest = 'verbose',
                            help = 'Produces more verbose reports.')
-        group.add_argument('-nv', '--no-verbose', action = 'store_true', dest = 'no_verbose',
-                           help = 'Disables verbose mode, so only crucial messages are shown (default).')
         group.add_argument('-d', '--debug', action = 'store_true', dest = 'debug',
                            help = 'Enables debug output.')
         group.add_argument('-nd', '--no-debug', action = 'store_true', dest = 'no_debug',
@@ -201,6 +196,10 @@ def _validate_args(args):
             if args.__getattribute__(option_name) and args.__getattribute__(f'no_{option_name}'):
                 Log.abort(f'You cannot use "--{option_name}" and "--no-{option_name}" at the same time.')
 
+        # --quiet vs --verbose
+        if args.__getattribute__('quiet') and args.__getattribute__('verbose'):
+            Log.abort('You cannot use "--quiet" and "--verbose" at the same time.')
+
         # Separator character.
         if args.separator and args.separator not in Config.ALLOWED_SEPARATORS:
             Log.abort(f'Invalid separator. Must be one of the following: {", ".join(Config.ALLOWED_SEPARATORS)}')
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index daeb6ee7..e29b1c22 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -21,6 +21,8 @@
 class FakeArgs(object):
     def __init__(self):
         self.fix: bool = False
+        self.quiet: bool = False
+        self.color: bool = False
 
         self.files: List[str] = []
         self.languages: List[str] = []
@@ -35,8 +37,13 @@ def __init__(self):
 
 
 class TestConfigBuilder(TestCase):
-
     def get_config_for_validate(self) -> Config:
+        """
+        Prepares instance of Config to be later manipulated and passed
+        to ConfigBuilder._validate_config() for tests.
+
+        :return: Initialized config object with valid default state.
+        """
         config = Config()
 
         irrelevant_path = self.get_random_string()
@@ -48,11 +55,18 @@ def get_config_for_validate(self) -> Config:
         return config
 
     def test_validate(self) -> None:
-        # This one should pass
+        """
+        Ensures valid Config instance passes all validation checks.
+        """
         ConfigBuilder._validate_config(self.get_config_for_validate())
 
     @patch('proptool.log.Log.abort')
     def test_validate_no_files(self, mock_log_abort) -> None:
+        """
+        Ensures empty list of files triggers expected error message and quits.
+
+        :param mock_log_abort: Log.abort() mock.
+        """
         config = self.get_config_for_validate()
         config.files = []
         ConfigBuilder._validate_config(config)
@@ -60,50 +74,75 @@ def test_validate_no_files(self, mock_log_abort) -> None:
         mock_log_abort.assert_has_calls(exp_calls)
 
     @patch('proptool.log.Log.abort')
-    def test_validate_no_languages(self, mock_print) -> None:
+    def test_validate_no_languages(self, mock_log_abort) -> None:
+        """
+        Ensures empty language list triggers expected error message and quits.
+
+        :param mock_log_abort: Log.abort() mock.
+        """
         config = self.get_config_for_validate()
         config.languages = []
         ConfigBuilder._validate_config(config)
         exp_calls = [call('No language(s) specified.')]
-        mock_print.assert_has_calls(exp_calls)
+        mock_log_abort.assert_has_calls(exp_calls)
 
     @patch('proptool.log.Log.abort')
-    def test_validate_invalid_separator(self, mock_print) -> None:
+    def test_validate_invalid_separator(self, mock_log_abort) -> None:
+        """
+        Ensures invalid separator char triggers expected error message and quits.
+
+        :param mock_log_abort: Log.abort() mock.
+        """
         config = self.get_config_for_validate()
-        config.separator = ''
+        config.separator = 'invalid'
         ConfigBuilder._validate_config(config)
         exp_calls = [call('Invalid separator character.')]
-        mock_print.assert_has_calls(exp_calls)
+        mock_log_abort.assert_has_calls(exp_calls)
 
     @patch('proptool.log.Log.abort')
-    def test_validate_invalid_comment_marker(self, mock_print) -> None:
+    def test_validate_invalid_comment_marker(self, mock_log_abort) -> None:
+        """
+        Ensures invalid comment marker triggers expected error message and quits.
+
+        :param mock_log_abort: Log.abort() mock.
+        """
         config = self.get_config_for_validate()
         config.comment_marker = ''
         ConfigBuilder._validate_config(config)
         exp_prints = [call('Invalid comment marker.')]
-        mock_print.assert_has_calls(exp_prints)
+        mock_log_abort.assert_has_calls(exp_prints)
 
     # #################################################################################################
 
     def test_set_on_off_option(self) -> None:
+        """Tests if _set_on_off_option() works as documented."""
         config = Config()
-        config.verbose = True
+        config.color = True
 
-        self.assertTrue(config.verbose)
+        self.assertTrue(config.color)
         args = FakeArgs()
-        args.verbose = False
-        args.no_verbose = True
-        ConfigBuilder._set_on_off_option(config, args, 'verbose')
-        self.assertFalse(config.verbose)
+        args.color = False
+        args.no_color = True
+        ConfigBuilder._set_on_off_option(config, args, 'color')
+        self.assertFalse(config.color)
 
-        args.verbose = True
-        args.no_verbose = False
-        ConfigBuilder._set_on_off_option(config, args, 'verbose')
-        self.assertTrue(config.verbose)
+        args.color = True
+        args.no_color = False
+        ConfigBuilder._set_on_off_option(config, args, 'color')
+        self.assertTrue(config.color)
 
     # #################################################################################################
 
     def get_expectation(self, config_default: bool, switch_on: bool, switch_off: bool) -> bool:
+        """
+        Computes expected final value based on on/off switches.
+
+        :param config_default: default option value read from default Config instance.
+        :param switch_on: state of --<OPTION> switch
+        :param switch_off: state of --no-<OPTION> switch
+
+        :return: Computer boolean value given configuration of on/off switches should produce.
+        """
         result = config_default
         if switch_on:
             result = True
@@ -112,24 +151,34 @@ def get_expectation(self, config_default: bool, switch_on: bool, switch_off: boo
         return result
 
     def test_set_from_args(self) -> None:
+        """
+        Tests _set_from_args()
+        """
         args = FakeArgs()
-        args.fix = self.get_random_bool()
 
+        # Lets set up args to some random state
+        args.fix = self.get_random_bool()
+        args.quiet = self.get_random_bool()
+        args.verbose = self.get_random_bool()
+        args.color = self.get_random_bool()
         args.fatal, args.no_fatal = self.get_random_on_off_pair()
         args.strict, args.no_strict = self.get_random_on_off_pair()
-        args.quiet, args.no_quiet = self.get_random_on_off_pair()
-        args.verbose, args.no_verbose = self.get_random_on_off_pair()
         args.color, args.no_color = self.get_random_on_off_pair()
+        args.separator = random.choice(Config.ALLOWED_SEPARATORS)
+        args.comment_marker = random.choice(Config.ALLOWED_COMMENT_MARKERS)
 
-        # Generate some names with .properties suffix
-        args.files = [Path(f'{self.get_random_string()}.properties') for _ in range(1, 10)]
+        # Generate fake file names with expected default suffix
+        args.files = [Path(f'{self.get_random_string()}{Config.DEFAULT_FILE_SUFFIX}') for _ in range(1, 10)]
+
+        # some languages
+        # FIXME: make list more random
         languages = ['pl', 'de', 'pt']
         args.languages = languages
-        args.separator = random.choice(Config.ALLOWED_SEPARATORS)
-        args.comment_marker = random.choice(Config.ALLOWED_COMMENT_MARKERS)
 
-        # Process args and update config
+        # This is going to be our reference default config instance.
         config_defaults = Config()
+
+        # Process args and update config
         config = Config()
         ConfigBuilder._set_from_args(config, args)
 
@@ -138,14 +187,14 @@ def test_set_from_args(self) -> None:
         self.assertEqual(exp_fatal, config.fatal)
         exp_strict = self.get_expectation(config_defaults.strict, args.strict, args.no_strict)
         self.assertEqual(exp_strict, config.strict)
-        exp_quiet = self.get_expectation(config_defaults.quiet, args.quiet, args.no_quiet)
-        self.assertEqual(exp_quiet, config.quiet)
-        exp_verbose = self.get_expectation(config_defaults.verbose, args.verbose, args.no_verbose)
-        self.assertEqual(exp_verbose, config.verbose)
         exp_color = self.get_expectation(config_defaults.color, args.color, args.no_color)
         self.assertEqual(exp_color, config.color)
 
-        # ensure all files are now with proper suffix
+        # log_level controlled by `quiet` and `verbose`.
+        self.assertEqual(args.quiet, config.quiet)
+        self.assertEqual(args.verbose, config.verbose)
+
+        # Ensure all files are there and still with proper suffix.
         for idx, args_file in enumerate(args.files):
             self.assertEqual(config.files[idx], args_file)
         self.assertEqual(languages, config.languages)
@@ -155,24 +204,29 @@ def test_set_from_args(self) -> None:
     # #################################################################################################
 
     def test_add_file_suffix_missing_suffix(self) -> None:
+        """
+        Tests ConfigBuilder._add_file_suffix() works as expected.
+        """
         config = Config()
 
-        # Generate some names with NO ".properties" suffix
+        # GIVEN list of file names WITHOUT expected suffix.
         srcs = [Path(self.get_random_string()) for _ in range(1, 10)]
         dests = copy.copy(srcs)
+        # WHEN we process it
         ConfigBuilder._add_file_suffix(config, dests)
-        # Ensure nothing we got suffix added
+        # THEN all file names should have file suffix appened.
         for idx, src in enumerate(srcs):
             self.assertEqual(f'{str(src)}{config.file_suffix}', str(dests[idx]))
 
     def test_add_file_suffix_with_suffix(self) -> None:
         config = Config()
 
-        # Generate some names with ".properties" suffix
+        # GIVEN list of file names with expected suffix suffix
         srcs = [Path(f'{self.get_random_string()}{config.file_suffix}') for _ in range(1, 10)]
         dests = copy.copy(srcs)
+        # WHEN we get it processed
         ConfigBuilder._add_file_suffix(config, dests)
-        # Ensure nothing gets altered
+        # THEN nothing should change.
         self.assertEqual(srcs, dests)
 
     # #################################################################################################
@@ -206,6 +260,21 @@ def test_validate_args_onoff_on_on(self, mock_log_abort) -> None:
             exp_calls = [call(f'You cannot use "--{option_name}" and "--no-{option_name}" at the same time.')]
             mock_log_abort.assert_has_calls(exp_calls)
 
+    @patch('proptool.log.Log.abort')
+    def test_validate_args_quiet_and_verbose(self, mock_log_abort) -> None:
+        """
+        Ensures use of mutually exclusive --quiet and --verbose is handled correctly.
+
+        :param mock_log_abort: Log.abort() mock.
+        """
+        args = FakeArgs()
+
+        args.quiet = True
+        args.verbose = True
+        ConfigBuilder._validate_args(args)
+        exp_calls = [call('You cannot use "--quiet" and "--verbose" at the same time.')]
+        mock_log_abort.assert_has_calls(exp_calls)
+
     @patch('proptool.log.Log.abort')
     def test_validate_args_invalid_separator(self, mock_log_abort) -> None:
         args = FakeArgs()

From ae960552833da52b74afc8c615996e5273ef4fb1 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 10:35:16 +0200
Subject: [PATCH 050/140] Reworked Log to use log_level

---
 proptool/config/config_builder.py   |  4 +++-
 proptool/log.py                     | 27 ++++++++++++++++++---------
 tests/config/test_config_builder.py |  2 +-
 3 files changed, 22 insertions(+), 11 deletions(-)

diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index de729a26..8ee17b15 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -101,6 +101,8 @@ def _set_from_args(config: Config, args) -> None:
             'separator',
             'comment_marker',
             'comment_template',
+            'quiet',
+            'verbose',
         ]
         for option_name in optionals:
             opt_val = args.__getattribute__(option_name)
@@ -198,7 +200,7 @@ def _validate_args(args):
 
         # --quiet vs --verbose
         if args.__getattribute__('quiet') and args.__getattribute__('verbose'):
-            Log.abort('You cannot use "--quiet" and "--verbose" at the same time.')
+            Log.abort('You cannot enable "quiet" and "verbose" options both at the same time.')
 
         # Separator character.
         if args.separator and args.separator not in Config.ALLOWED_SEPARATORS:
diff --git a/proptool/log.py b/proptool/log.py
index 63f542cf..e887348c 100644
--- a/proptool/log.py
+++ b/proptool/log.py
@@ -72,6 +72,10 @@ class Log(object):
     COLOR_DEBUG = Ansi.REVERSE
     COLOR_BANNER = (Ansi.WHITE + Ansi.REVERSE)
 
+    LEVEL_QUIET = 0
+    LEVEL_NORMAL = 1
+    LEVEL_VERBOSE = 2
+
     # #################################################################################################
 
     deferred_log_level: Union[int, None] = None
@@ -83,9 +87,9 @@ class Log(object):
     buffer_enabled: bool = True
     debug = False
     color: bool = False
-    quiet: bool = False
     skip_empty_lines: bool = False
-    verbose: bool = False
+
+    level = LEVEL_NORMAL
 
     # #################################################################################################
 
@@ -99,9 +103,14 @@ def configure(cls, config: Config) -> None:
         cls.buffer_enabled = True
         cls.debug = config.debug
         cls.color = config.color
-        cls.quiet = False
         cls.skip_empty_lines = False
-        cls.verbose = config.verbose
+
+        if config.verbose:
+            cls.level = Log.LEVEL_VERBOSE
+        elif config.quiet:
+            cls.level = Log.LEVEL_QUIET
+        else:
+            cls.level = Log.LEVEL_NORMAL
 
         if config.debug and os.getenv('PYTHONDONTWRITEBYTECODE') is None:
             Log.e([
@@ -133,7 +142,7 @@ def init(message: Union[str, None] = None, color: Union[str, None] = None, ignor
 
     @staticmethod
     def push(message: Union[str, None] = None, color: Union[str, None] = None, ignore_quiet = False, deferred = False) -> None:
-        if not Log.verbose and deferred:
+        if Log.level < Log.LEVEL_VERBOSE and deferred:
             Log._flush_deferred_entry()
 
             Log.deferred_log_level = Log.log_level
@@ -157,7 +166,7 @@ def push_ok(message: Union[str, None] = None, color: Union[str, None] = None, ig
 
     @staticmethod
     def push_v(message: Union[str, None] = None, color: Union[str, None] = None, ignore_quiet = False, deferred = False) -> None:
-        if Log.verbose:
+        if Log.level == Log.LEVEL_VERBOSE:
             Log.push(message, color, ignore_quiet, deferred)
 
     @staticmethod
@@ -175,7 +184,7 @@ def pop(messages = None, color: Union[str, None] = None, ignore_quiet = False) -
 
     @staticmethod
     def pop_v(messages = None, color: Union[str, None] = None, ignore_quiet: bool = False) -> None:
-        if Log.verbose:
+        if Log.level == Log.LEVEL_VERBOSE:
             Log.pop(messages, color, ignore_quiet)
 
     # #################################################################################################
@@ -209,7 +218,7 @@ def n(messages = None, color: str = COLOR_NOTICE, ignore_quiet: bool = False, ad
     # verbose
     @staticmethod
     def v(messages = None, condition: bool = True) -> None:
-        if Log.verbose and condition:
+        if Log.level == Log.LEVEL_VERBOSE and condition:
             Log._log(messages)
 
     # warning
@@ -370,7 +379,7 @@ def _log_raw(message = None, ignore_quiet: bool = False, add_to_history: bool =
             if Log.buffer_enabled and add_to_history:
                 Log.log_entries.append(message)
 
-            quiet = False if ignore_quiet else Log.quiet
+            quiet = False if ignore_quiet else Log.level == Log.LEVEL_QUIET
             if not quiet:
                 print(message.rstrip())
 
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index e29b1c22..82885b94 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -272,7 +272,7 @@ def test_validate_args_quiet_and_verbose(self, mock_log_abort) -> None:
         args.quiet = True
         args.verbose = True
         ConfigBuilder._validate_args(args)
-        exp_calls = [call('You cannot use "--quiet" and "--verbose" at the same time.')]
+        exp_calls = [call('You cannot enable "quiet" and "verbose" options both at the same time.')]
         mock_log_abort.assert_has_calls(exp_calls)
 
     @patch('proptool.log.Log.abort')

From d7724bcaea24dc88829b92fead201b6b533d3acd Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 11:00:58 +0200
Subject: [PATCH 051/140] Updated docs

---
 docs/developers.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/docs/developers.md b/docs/developers.md
index 49f64a97..3020f758 100644
--- a/docs/developers.md
+++ b/docs/developers.md
@@ -129,3 +129,33 @@ markdownlint --ignore LICENSE.md **/*.md
 
 Note, the `LICENSE.md` file is externally sourced, therefore I am not going to fix it.
 
+---
+
+# Combining all checks together #
+
+```bash
+#!/bin/bash
+
+set -uo pipefail
+
+# Activate venv if not active
+if [[ -z "${VIRTUAL_ENV:-}" ]]; then
+    echo "Activating virtual env..."
+    source venv/bin/activate
+fi
+
+if [[ -z "${VIRTUAL_ENV}" ]]; then
+    echo "*** Not in virtual env."
+    return 1
+fi
+
+echo "Unit tests..."
+python3 -m unittest discover --quiet
+if pip show pytest --quiet && pytest --quiet --no-header --no-summary;
+    pytest --quiet --no-header --no-summary
+fi
+echo "Code Lint"
+flake8 proptool/ tests/
+echo "MD Lint"
+markdownlint --ignore LICENSE.md **/*.md
+```

From 54797d5cfca5d2fa4e60605b8004d78a936a0a85 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 11:18:34 +0200
Subject: [PATCH 052/140] Polished docs

---
 .markdownlint.yaml                         |  3 +-
 docs/CHANGES.md                            |  4 ++-
 docs/README.md                             |  2 --
 docs/checks/README.md                      |  2 --
 docs/checks/brackets.md                    |  4 +--
 docs/checks/dangling-keys.md               |  5 +---
 docs/checks/empty-translations.md          |  4 +--
 docs/checks/formatting-values.md           |  6 ++--
 docs/checks/key-format.md                  |  4 +--
 docs/checks/missing-translations.md        |  8 ++---
 docs/checks/punctuation.md                 |  7 -----
 docs/checks/quotation-marks.md             |  2 --
 docs/checks/starts-with-the-same-case.md   |  4 +--
 docs/checks/syntax-check.md                |  2 --
 docs/checks/trailing-white-chars.md        |  2 --
 docs/checks/typesetting-quotation-marks.md |  2 --
 docs/checks/white-chars-before-linefeed.md |  2 --
 docs/config.md                             | 34 +++++++++++++---------
 docs/developers.md                         | 11 ++++++-
 docs/usage.md                              | 18 ++++++++++--
 20 files changed, 60 insertions(+), 66 deletions(-)

diff --git a/.markdownlint.yaml b/.markdownlint.yaml
index 06dd7ef6..214f4241 100644
--- a/.markdownlint.yaml
+++ b/.markdownlint.yaml
@@ -60,8 +60,7 @@ MD011: true
 # MD012/no-multiple-blanks - Multiple consecutive blank lines
 MD012:
   # Consecutive blank lines
-  # maximum: 1
-  maximum: 2 # MOR (to separate checks/*md navigation elements)
+  maximum: 1
 
 # MD013/line-length - Line length
 MD013:
diff --git a/docs/CHANGES.md b/docs/CHANGES.md
index 30d4480b..add35974 100644
--- a/docs/CHANGES.md
+++ b/docs/CHANGES.md
@@ -7,7 +7,9 @@
 # Changelog #
 
 * dev
-  * Added support for config files
+  * Added support for config files.
+  * Reworked documentation.
+  * Added more unit tests.
 
 * v1.3.0 (2021-07-22)
   * Added `TypesettingQuotationMarks` check.
diff --git a/docs/README.md b/docs/README.md
index 3bb41a7d..abfa5b39 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -8,7 +8,6 @@
 
 * [« Main README](../README.md)
 * [« Documentation table of contents](README.md)
-
 * [Usage examples](usage.md)
   * [Updating translations](usage.md#updating-translations)
 * [Available validators](checks/README.md)
@@ -43,7 +42,6 @@ You may also want to setup [virtual environment](https://docs.python.org/3/libra
 * `TypesettingQuotationMarks` is not covering all possible pairs yet due
   to [limitations of current implementation](https://github.com/MarcinOrlowski/prop-tool/issues/19).
 
-
 ## Additional links ##
 
 * The `*.properties` syntax support is based on official [file format documentation](https://docs.oracle.com/cd/E23095_01/Platform.93/ATGProgGuide/html/s0204propertiesfileformat01.html).
diff --git a/docs/checks/README.md b/docs/checks/README.md
index 42821014..409d1560 100644
--- a/docs/checks/README.md
+++ b/docs/checks/README.md
@@ -8,8 +8,6 @@
 
 * [« Main README](../../README.md)
 * [« Documentation table of contents](README.md)
-
-
 * **[Validators](#validators)**
   * [Checking base and translation files](#checking-base-and-translation-files)
 * Available checks
diff --git a/docs/checks/brackets.md b/docs/checks/brackets.md
index 5c3a7af5..db08aebd 100644
--- a/docs/checks/brackets.md
+++ b/docs/checks/brackets.md
@@ -4,12 +4,10 @@
 
 ---
 
-## Brackets ##
+# Brackets #
 
 * [« Main README](../../README.md)
 * [« Documentation table of contents](../README.md)
-
-
 * [« Available checks](README.md)
   * **Brackets**
     * [Summary](#summary)
diff --git a/docs/checks/dangling-keys.md b/docs/checks/dangling-keys.md
index 2224eab2..0b99466f 100644
--- a/docs/checks/dangling-keys.md
+++ b/docs/checks/dangling-keys.md
@@ -4,12 +4,10 @@
 
 ---
 
-## Dangling Keys ##
+# Dangling Keys #
 
 * [« Main README](../../README.md)
 * [« Documentation table of contents](../README.md)
-
-
 * [« Available checks](README.md)
   * **Dangling Keys**
     * [Summary](#summary)
@@ -29,7 +27,6 @@
 
 Checks if keys found in translation file are also present in base file.
 
-
 ## Command line options ##
 
 No dedicated command line options for this validator.
diff --git a/docs/checks/empty-translations.md b/docs/checks/empty-translations.md
index 5f1154f8..fe9e3ff7 100644
--- a/docs/checks/empty-translations.md
+++ b/docs/checks/empty-translations.md
@@ -4,12 +4,10 @@
 
 ---
 
-## Empty Translations ##
+# Empty Translations #
 
 * [« Main README](../../README.md)
 * [« Documentation table of contents](../README.md)
-
-
 * [« Available checks](README.md)
   * **Empty Translations**
     * [Summary](#summary)
diff --git a/docs/checks/formatting-values.md b/docs/checks/formatting-values.md
index a2859571..da1248a0 100644
--- a/docs/checks/formatting-values.md
+++ b/docs/checks/formatting-values.md
@@ -4,12 +4,10 @@
 
 ---
 
-## Formatting Values ##
+# Formatting Values #
 
 * [« Main README](../../README.md)
 * [« Documentation table of contents](../README.md)
-
-
 * [« Available checks](README.md)
   * **Formatting Values**
     * [Summary](#summary)
@@ -38,4 +36,4 @@ No dedicated command line options for this validator.
 
 ## Configuration file ##
 
-TODO
+No dedicated configuration.
diff --git a/docs/checks/key-format.md b/docs/checks/key-format.md
index 9e7a0efe..45083e16 100644
--- a/docs/checks/key-format.md
+++ b/docs/checks/key-format.md
@@ -4,12 +4,10 @@
 
 ---
 
-## Key Format ##
+# Key Format #
 
 * [« Main README](../../README.md)
 * [« Documentation table of contents](../README.md)
-
-
 * [« Available checks](README.md)
   * **Key Format**
     * [Summary](#summary)
diff --git a/docs/checks/missing-translations.md b/docs/checks/missing-translations.md
index c5ef6d82..fead256c 100644
--- a/docs/checks/missing-translations.md
+++ b/docs/checks/missing-translations.md
@@ -4,12 +4,10 @@
 
 ---
 
-## Missing Translations ##
+# Missing Translations #
 
 * [« Main README](../../README.md)
 * [« Documentation table of contents](../README.md)
-
-
 * [« Available checks](README.md)
   * **Missing Translations**
     * [Summary](#summary)
@@ -53,8 +51,8 @@ Default format can be changed using `--template` argument or `template` config e
 
 ## Command line options ##
 
-TODO
+No dedicated command line options for this validator.
 
 ## Configuration file ##
 
-TODO
+No dedicated configuration.
diff --git a/docs/checks/punctuation.md b/docs/checks/punctuation.md
index 31a13487..6897040a 100644
--- a/docs/checks/punctuation.md
+++ b/docs/checks/punctuation.md
@@ -8,15 +8,12 @@
 
 * [« Main README](../../README.md)
 * [« Documentation table of contents](../README.md)
-
-
 * [« Available checks](README.md)
   * **Punctuation**
     * [Summary](#summary)
     * [Description](#description)
     * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
-      * [Important notes](#notes)
       * [Example](#example)
   
 ---
@@ -41,10 +38,6 @@ No dedicated command line options for this validator.
 |-----------|-----------|-------------|---------|
 | chars   | List of strings | List of punctuation characters | `[ ".", "?", "!", ":" ]` |
 
-### Notes ###
-
-None.
-
 ### Example ###
 
 ```ini
diff --git a/docs/checks/quotation-marks.md b/docs/checks/quotation-marks.md
index a0ac3420..e7aa1049 100644
--- a/docs/checks/quotation-marks.md
+++ b/docs/checks/quotation-marks.md
@@ -8,8 +8,6 @@
 
 * [« Main README](../../README.md)
 * [« Documentation table of contents](../README.md)
-
-
 * [« Available checks](README.md)
   * **Quotation Marks**
     * [Summary](#summary)
diff --git a/docs/checks/starts-with-the-same-case.md b/docs/checks/starts-with-the-same-case.md
index da23e7b7..a0166d59 100644
--- a/docs/checks/starts-with-the-same-case.md
+++ b/docs/checks/starts-with-the-same-case.md
@@ -8,8 +8,6 @@
 
 * [« Main README](../../README.md)
 * [« Documentation table of contents](../README.md)
-
-
 * [« Available checks](README.md)
   * **Starts With The Same Case**
     * [Summary](#summary)
@@ -38,4 +36,4 @@ No dedicated command line options for this validator.
 
 ## Configuration file ##
 
-TODO
+No dedicated configuration.
diff --git a/docs/checks/syntax-check.md b/docs/checks/syntax-check.md
index 57ccb0cb..a38d77bf 100644
--- a/docs/checks/syntax-check.md
+++ b/docs/checks/syntax-check.md
@@ -8,8 +8,6 @@
 
 * [« Main README](../../README.md)
 * [« Documentation table of contents](../README.md)
-
-
 * [« Available checks](README.md)
   * **Syntax Check**
     * [Summary](#summary)
diff --git a/docs/checks/trailing-white-chars.md b/docs/checks/trailing-white-chars.md
index 520f5798..09818dba 100644
--- a/docs/checks/trailing-white-chars.md
+++ b/docs/checks/trailing-white-chars.md
@@ -8,8 +8,6 @@
 
 * [« Main README](../../README.md)
 * [« Documentation table of contents](../README.md)
-
-
 * [« Available checks](README.md)
   * **Trailing White Chars**
     * [Summary](#summary)
diff --git a/docs/checks/typesetting-quotation-marks.md b/docs/checks/typesetting-quotation-marks.md
index e18276f9..34156117 100644
--- a/docs/checks/typesetting-quotation-marks.md
+++ b/docs/checks/typesetting-quotation-marks.md
@@ -8,8 +8,6 @@
 
 * [« Main README](../../README.md)
 * [« Documentation table of contents](../README.md)
-
-
 * [« Available checks](README.md)
   * **Typesetting Quotation Marks**
     * [Summary](#summary)
diff --git a/docs/checks/white-chars-before-linefeed.md b/docs/checks/white-chars-before-linefeed.md
index 20f80e5b..f2fd6859 100644
--- a/docs/checks/white-chars-before-linefeed.md
+++ b/docs/checks/white-chars-before-linefeed.md
@@ -8,8 +8,6 @@
 
 * [« Main README](../../README.md)
 * [« Documentation table of contents](../README.md)
-
-
 * [« Available checks](README.md)
   * **White Chars Before Linefeed**
     * [Summary](#summary)
diff --git a/docs/config.md b/docs/config.md
index da676713..c10f4383 100644
--- a/docs/config.md
+++ b/docs/config.md
@@ -1,6 +1,20 @@
-![prop-tool logo](artwork/prop-tool-logo.png)
+![prop-tool logo](../artwork/prop-tool-logo.png)
 
-# The *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
+
+---
+
+## Configuration ##
+
+* [« Main README](../README.md)
+* [« Documentation table of contents](README.md)
+* **Configuration**
+  * [Config file](#config-file)
+  * [Syntax file](#syntax)
+  * [Structure](#structure)
+    * [The [prop-tool] section](#prop-tool-section)
+
+---
 
 # Config file #
 
@@ -93,21 +107,15 @@ The following elements are supported in `[prop-tool]` section
 |-----------|---------------|---------------|---------|-------------|
 | comment   | `--comment`   | String        | `#`     | TODO |
 | separator | `--separator` | String        | `=`     | TODO |
-| log_level | `--log-level` | Integer       | `1`     | Sets log verbosity at specified level. |
+| quiet     | `--quiet`     | Boolean       | `false` | Quiet mode. If enabled, all but fatal errors are muted. |
+| verbose   | `--verbose`   | Boolean       | `false` | Verbose mode. If enabled shows more information during runtime. |
 
-Switches. Each option how corresponding two command line switches, turning feature on (`--<OPTION>`)
+## Switches ##
+
+Each option how corresponding two command line switches, turning feature on (`--<OPTION>`)
 and turning it off (`--no-<OPTION>`). Only one command line argument can be used at the same time.
 
 | Key       | CLI switches |Argument type      | Default | Description |
 |-----------|-----------|-------------|---------|------------|
 | fatal   | `--fatal`, `--no-fatal` | Boolean | `false` | When used all validators' warnings are fatal as errors. |
 | color   | `--color`/`--no-color` | Boolean | `true` | When `true`, application output will be using ANSI colors.|
-
-## Supported Log verbosity levels ##
-
-| Level | Description |
-|-------|-------------|
-| `0`   | Quiet mode. All but fatal errors are muted. Equivalent of using `--quiet` switch. |
-| `1`   | Normal log level, warning and errors are shown plus some additional information if necessary. |
-| `2`   | Verbose mode, shows more information during runtime. Equivalent of using `--verbose` switch. |
-
diff --git a/docs/developers.md b/docs/developers.md
index 3020f758..6e033caa 100644
--- a/docs/developers.md
+++ b/docs/developers.md
@@ -4,7 +4,16 @@
 
 ---
 
-# Developer's corner #
+## Developers' corner ##
+
+* [« Main README](../README.md)
+* [« Documentation table of contents](README.md)
+* **Developers' corner**
+  * [Quality control](#quality-control)
+
+---
+
+# Quality control #
 
 `prop-tool` is Python 3 application. It has no external runtime dependencies, however code quality is automatically checked using
 additional tools that require additional installation.  These tests are run automatically on the code repository against
diff --git a/docs/usage.md b/docs/usage.md
index 6999854c..2cece4b0 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -1,9 +1,20 @@
-![prop-tool logo](artwork/prop-tool-logo.png)
+![prop-tool logo](../artwork/prop-tool-logo.png)
 
-# The *.properties file checker and syncing tool #
+### The *.properties file checker and syncing tool ###
 
+---
+
+# Usage #
+
+* [« Main README](../README.md)
+* [« Documentation table of contents](README.md)
+* **Usage**
+  * [Config file and command line arguments](#config-file-and-command-line)
+  * [Usage examples](#usage-examples)
 
-## Config file and command line arguments ##
+---
+
+## Config file and command line ##
 
 You can use `prop-tool` by providing all required parameters directly from command line (see `--help`), or you can create
 configuration file and use `--config` option to make `prop-tool` load it and use. Almost all options can be set in configuration
@@ -24,6 +35,7 @@ any text editor. Please see commented [config.ini](../config.ini) for example co
 > * your config file sets `verbose = true`, enabling verbose output,
 > * but your invocation is `prop-tool --config config.ini --no-verbose`, therefore `verbose` mode is set `OFF`.
 
+---
 
 ## Usage examples ##
 

From 8814983f3edbb06be50d6635e77cd1bbb51f3fdc Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 11:23:29 +0200
Subject: [PATCH 053/140] Removed CLI section from Validators docs as none has
 anything CLI driven

---
 docs/checks/brackets.md                    | 5 -----
 docs/checks/dangling-keys.md               | 5 -----
 docs/checks/empty-translations.md          | 5 -----
 docs/checks/formatting-values.md           | 5 -----
 docs/checks/key-format.md                  | 5 -----
 docs/checks/missing-translations.md        | 5 -----
 docs/checks/punctuation.md                 | 5 -----
 docs/checks/quotation-marks.md             | 5 -----
 docs/checks/starts-with-the-same-case.md   | 5 -----
 docs/checks/syntax-check.md                | 5 -----
 docs/checks/trailing-white-chars.md        | 5 -----
 docs/checks/typesetting-quotation-marks.md | 5 -----
 docs/checks/white-chars-before-linefeed.md | 6 ------
 13 files changed, 66 deletions(-)

diff --git a/docs/checks/brackets.md b/docs/checks/brackets.md
index db08aebd..8fe5fab4 100644
--- a/docs/checks/brackets.md
+++ b/docs/checks/brackets.md
@@ -12,7 +12,6 @@
   * **Brackets**
     * [Summary](#summary)
     * [Description](#description)
-    * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
       * [Important notes](#notes)
       * [Example](#example)
@@ -29,10 +28,6 @@
 
 `Brackets` ensures all brackets that are found opened in the string are also closed and there's no unpaired bracket left.
 
-## Command line options ##
-
-No dedicated command line options for this validator.
-
 ## Configuration file ##
 
 | Key       | Type      | Description | Example |
diff --git a/docs/checks/dangling-keys.md b/docs/checks/dangling-keys.md
index 0b99466f..4f36b8e3 100644
--- a/docs/checks/dangling-keys.md
+++ b/docs/checks/dangling-keys.md
@@ -12,7 +12,6 @@
   * **Dangling Keys**
     * [Summary](#summary)
     * [Description](#description)
-    * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
 
 ---
@@ -27,10 +26,6 @@
 
 Checks if keys found in translation file are also present in base file.
 
-## Command line options ##
-
-No dedicated command line options for this validator.
-
 ## Configuration file ##
 
 No dedicated configuration.
diff --git a/docs/checks/empty-translations.md b/docs/checks/empty-translations.md
index fe9e3ff7..4909913a 100644
--- a/docs/checks/empty-translations.md
+++ b/docs/checks/empty-translations.md
@@ -12,7 +12,6 @@
   * **Empty Translations**
     * [Summary](#summary)
     * [Description](#description)
-    * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
 
 ---
@@ -27,10 +26,6 @@
 
 This validator looks for translations that provide no content (empty string) for non-empty text in base file.
 
-## Command line options ##
-
-No dedicated command line options for this validator.
-
 ## Configuration file ##
 
 No dedicated configuration.
diff --git a/docs/checks/formatting-values.md b/docs/checks/formatting-values.md
index da1248a0..c488ac7f 100644
--- a/docs/checks/formatting-values.md
+++ b/docs/checks/formatting-values.md
@@ -12,7 +12,6 @@
   * **Formatting Values**
     * [Summary](#summary)
     * [Description](#description)
-    * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
 
 ---
@@ -30,10 +29,6 @@ or `%d` are replaced with corresponding values at runtime. It assumes that the c
 regardless of language version therefore it check if all placeholders used in original string are also present in translation string
 and if the order of said placeholders is preserved as this is also often crucial for the application to run properly.
 
-## Command line options ##
-
-No dedicated command line options for this validator.
-
 ## Configuration file ##
 
 No dedicated configuration.
diff --git a/docs/checks/key-format.md b/docs/checks/key-format.md
index 45083e16..3bd126b4 100644
--- a/docs/checks/key-format.md
+++ b/docs/checks/key-format.md
@@ -12,7 +12,6 @@
   * **Key Format**
     * [Summary](#summary)
     * [Description](#description)
-    * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
       * [Important notes](#notes)
       * [Example](#example)
@@ -30,10 +29,6 @@
 This validator ensures strings used as keys in you `*.properties` file matches specified pattern which helps keeping unified naming
 conventcion across your files.
 
-## Command line options ##
-
-No dedicated command line options for this validator.
-
 ## Configuration file ##
 
 | Key       | Type      | Description | Example |
diff --git a/docs/checks/missing-translations.md b/docs/checks/missing-translations.md
index fead256c..2f11e4b9 100644
--- a/docs/checks/missing-translations.md
+++ b/docs/checks/missing-translations.md
@@ -12,7 +12,6 @@
   * **Missing Translations**
     * [Summary](#summary)
     * [Description](#description)
-    * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
   
 ---
@@ -49,10 +48,6 @@ translated, you need to use `--strict` mode instead of default loose check mode.
 
 Default format can be changed using `--template` argument or `template` config entry.
 
-## Command line options ##
-
-No dedicated command line options for this validator.
-
 ## Configuration file ##
 
 No dedicated configuration.
diff --git a/docs/checks/punctuation.md b/docs/checks/punctuation.md
index 6897040a..5acb1d05 100644
--- a/docs/checks/punctuation.md
+++ b/docs/checks/punctuation.md
@@ -12,7 +12,6 @@
   * **Punctuation**
     * [Summary](#summary)
     * [Description](#description)
-    * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
       * [Example](#example)
   
@@ -28,10 +27,6 @@
 
 Punctuation check ensures translation ends with punctuation mark (`:`, `.`, `?`, `!`) if entry in base file ends that way.
 
-## Command line options ##
-
-No dedicated command line options for this validator.
-
 ## Configuration file ##
 
 | Key       | Type      | Description | Example |
diff --git a/docs/checks/quotation-marks.md b/docs/checks/quotation-marks.md
index e7aa1049..420250c3 100644
--- a/docs/checks/quotation-marks.md
+++ b/docs/checks/quotation-marks.md
@@ -12,7 +12,6 @@
   * **Quotation Marks**
     * [Summary](#summary)
     * [Description](#description)
-    * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
       * [Important notes](#notes)
       * [Example](#example)
@@ -48,10 +47,6 @@ Temporary workarounds:
 * Create `QuotationMarks` configuration per language so i.e. apostrophes are ignored in English, but checked in i.e. Polish which do
   not use it as part of sentences.
 
-## Command line options ##
-
-No dedicated command line options for this validator.
-
 ## Configuration file ##
 
 | Key       | Type      | Description | Example |
diff --git a/docs/checks/starts-with-the-same-case.md b/docs/checks/starts-with-the-same-case.md
index a0166d59..777864ea 100644
--- a/docs/checks/starts-with-the-same-case.md
+++ b/docs/checks/starts-with-the-same-case.md
@@ -12,7 +12,6 @@
   * **Starts With The Same Case**
     * [Summary](#summary)
     * [Description](#description)
-    * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
 
 ---
@@ -30,10 +29,6 @@ StartsWithTheSameCase ensures translation starts with the same character case (b
 *NOTE:* This check makes no sense for languages like Asian (i.e. Chinese, Japanese etc) and you should configure language exception
 list for `StartsWithTheSameCase` to make is skip such translations from being checked.
 
-## Command line options ##
-
-No dedicated command line options for this validator.
-
 ## Configuration file ##
 
 No dedicated configuration.
diff --git a/docs/checks/syntax-check.md b/docs/checks/syntax-check.md
index a38d77bf..0a4d9187 100644
--- a/docs/checks/syntax-check.md
+++ b/docs/checks/syntax-check.md
@@ -12,7 +12,6 @@
   * **Syntax Check**
     * [Summary](#summary)
     * [Description](#description)
-    * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
 
 ---
@@ -27,10 +26,6 @@
 
 This validators ensures proper structire of the files, use of allowed comment markers, key - value separators etc.
 
-## Command line options ##
-
-No dedicated command line options for this validator.
-
 ## Configuration file ##
 
 No dedicated configuration.
diff --git a/docs/checks/trailing-white-chars.md b/docs/checks/trailing-white-chars.md
index 09818dba..8afd6442 100644
--- a/docs/checks/trailing-white-chars.md
+++ b/docs/checks/trailing-white-chars.md
@@ -12,7 +12,6 @@
   * **Trailing White Chars**
     * [Summary](#summary)
     * [Description](#description)
-    * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
 
 ---
@@ -27,10 +26,6 @@
 
 This validator looks at the end of your strings and comments and flags trailing spaces or tab charactes noticed.
 
-## Command line options ##
-
-No dedicated command line options for this validator.
-
 ## Configuration file ##
 
 No dedicated configuration.
diff --git a/docs/checks/typesetting-quotation-marks.md b/docs/checks/typesetting-quotation-marks.md
index 34156117..e6327329 100644
--- a/docs/checks/typesetting-quotation-marks.md
+++ b/docs/checks/typesetting-quotation-marks.md
@@ -12,7 +12,6 @@
   * **Typesetting Quotation Marks**
     * [Summary](#summary)
     * [Description](#description)
-    * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
       * [Important notes](#notes)
       * [Example](#example)
@@ -30,10 +29,6 @@
 TypesettingQuotationMarks is a mixture of `QuotationMarks` and `Brackets` check that understans quotation mark pairs
 (where you have separate quote opening and closing characters). It can look for them and ensure all is paired and properly nested.
 
-## Command line options ##
-
-No dedicated command line options for this validator.
-
 ## Configuration file ##
 
 | Key       | Type      | Description | Example |
diff --git a/docs/checks/white-chars-before-linefeed.md b/docs/checks/white-chars-before-linefeed.md
index f2fd6859..d2dd1400 100644
--- a/docs/checks/white-chars-before-linefeed.md
+++ b/docs/checks/white-chars-before-linefeed.md
@@ -12,7 +12,6 @@
   * **White Chars Before Linefeed**
     * [Summary](#summary)
     * [Description](#description)
-    * [Command line options](#command-line-options)
     * [Configuration file](#configuration-file)
 
 ---
@@ -28,11 +27,6 @@
 This validator ensures there's no space nor tab character placed before linefeed literals (`\n` and `\r`)
 as this usually serves no purpose.
 
-
-## Command line options ##
-
-No dedicated command line options for this validator.
-
 ## Configuration file ##
 
 No dedicated configuration.

From 43f0e9afcd35bd7b3bbcacecf101f751caeb6588 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 11:24:13 +0200
Subject: [PATCH 054/140] Version bump

---
 docs/CHANGES.md   | 2 +-
 proptool/const.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/CHANGES.md b/docs/CHANGES.md
index add35974..162262db 100644
--- a/docs/CHANGES.md
+++ b/docs/CHANGES.md
@@ -6,7 +6,7 @@
 
 # Changelog #
 
-* dev
+* v2.0.0 (2021-07-27)
   * Added support for config files.
   * Reworked documentation.
   * Added more unit tests.
diff --git a/proptool/const.py b/proptool/const.py
index b8985e16..a6d445ba 100644
--- a/proptool/const.py
+++ b/proptool/const.py
@@ -12,7 +12,7 @@
 
 class Const(object):
     APP_NAME: str = 'prop-tool'
-    APP_VERSION: str = '1.3.0'
+    APP_VERSION: str = '2.0.0'
     APP_URL: str = 'https://github.com/MarcinOrlowski/prop-tool/'
 
     APP_DESCRIPTION: List[str] = [

From 69bf62dd2aaed2853482618e7a7d57baf05e8d9d Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 13:52:53 +0200
Subject: [PATCH 055/140] Updated dev docs

---
 docs/checks/punctuation.md |  1 -
 docs/developers.md         | 32 ++++++++++++++++----------------
 2 files changed, 16 insertions(+), 17 deletions(-)

diff --git a/docs/checks/punctuation.md b/docs/checks/punctuation.md
index 5acb1d05..66c3717d 100644
--- a/docs/checks/punctuation.md
+++ b/docs/checks/punctuation.md
@@ -42,4 +42,3 @@ version = 1
 [Punctuation]
 chars = [ ".", "?" ]
 ```
-
diff --git a/docs/developers.md b/docs/developers.md
index 6e033caa..1586fd9f 100644
--- a/docs/developers.md
+++ b/docs/developers.md
@@ -16,11 +16,10 @@
 # Quality control #
 
 `prop-tool` is Python 3 application. It has no external runtime dependencies, however code quality is automatically checked using
-additional tools that require additional installation.  These tests are run automatically on the code repository against
-any new commited code and each pull-request created using Github Actions feature (see `.github/workflows` folder for
-configuration details).
+additional tools that require additional installation. These tests are run automatically on the code repository against any new
+commited code and each pull-request created using Github Actions feature (see `.github/workflows` folder for configuration details).
 
-If you'd like to try them by hand locally here's how.
+If you'd like to run them locally by hand, here's how.
 
 ## Virtual environment ##
 
@@ -53,8 +52,8 @@ Ran 111 tests in 0.047s
 OK
 ```
 
-Unit tests can be run using [pytest](https://pytest.org/) package too (remove `--quiet` if you want to see
-tests details). Install `pytest` first:
+Unit tests can be run using [pytest](https://pytest.org/) package too (remove `--quiet` if you want to see tests details).
+Install `pytest` first:
 
 ```bash
 $ pip install pytest
@@ -73,8 +72,8 @@ $ pytest --quiet
 
 ## Python code QA ##
 
-I use `Flake8` and [wemake-python-styleguide](https://wemake-python-stylegui.de/en/latest/) and additional plugins to
-ensure code quality:
+I use `Flake8` and [wemake-python-styleguide](https://wemake-python-stylegui.de/en/latest/) and additional plugins to ensure code
+quality:
 
 ```bash
 $ pip install wemake-python-styleguide
@@ -115,10 +114,10 @@ $ pip install --upgrade dist/prop_tool-<VERSION>-py3-none-any.whl
 ## Markdown lint ##
 
 Documentation is written using [markdown](https://en.wikipedia.org/wiki/Markdown) and is checked
-using [MarkdownLint](https://github.com/DavidAnson/markdownlint)
-with use of [markdown-cli](https://github.com/igorshubovych/markdownlint-cli) wrapper. This linter is unfortunately not a Python
-application, so virtual environment won't help us keep it isolated. It must be installed on your system using `npm` package manager.
-You may need to install `npm` first as it usually is not preinstalled:
+using [MarkdownLint](https://github.com/DavidAnson/markdownlint) with use
+of [markdown-cli](https://github.com/igorshubovych/markdownlint-cli) wrapper. This linter is unfortunately not a Python
+application, so virtual environment won't help here much. You need to install `MarkdownLint` using `npm` package manager
+(you may also need to install `npm` first as it usually is not preinstalled):
 
 ```bash
 sudo apt install npm
@@ -130,13 +129,13 @@ Next, install the linter (see [markdown-cli](https://github.com/igorshubovych/ma
 npm install -g markdownlint-cli
 ```
 
-and lint all `*.md` files (linter configuration lives in `.markdownlint.yaml` file):
+Lint all `*.md` files (linter configuration lives in `.markdownlint.yaml` file):
 
 ```bash
-markdownlint --ignore LICENSE.md **/*.md
+markdownlint --config .markdownlint.yaml --ignore LICENSE.md **/*.md
 ```
 
-Note, the `LICENSE.md` file is externally sourced, therefore I am not going to fix it.
+Note, the `LICENSE.md` file is externally sourced, therefore I am not going to fix if it is faulty.
 
 ---
 
@@ -166,5 +165,6 @@ fi
 echo "Code Lint"
 flake8 proptool/ tests/
 echo "MD Lint"
-markdownlint --ignore LICENSE.md **/*.md
+# Quote file patters as we do not want it expanded too early.
+markdownlint --config .markdownlint.yaml --ignore LICENSE.md "**/*.md"
 ```

From f16fc4a21d655582874176de616a8a502ceb4e9f Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 13:53:26 +0200
Subject: [PATCH 056/140] Renamed MD linter's config file

---
 .github/workflows/markdown.yml          | 2 +-
 .markdownlint.yaml => .markdownlint.yml | 0
 2 files changed, 1 insertion(+), 1 deletion(-)
 rename .markdownlint.yaml => .markdownlint.yml (100%)

diff --git a/.github/workflows/markdown.yml b/.github/workflows/markdown.yml
index b1a7712d..f64d2ed1 100644
--- a/.github/workflows/markdown.yml
+++ b/.github/workflows/markdown.yml
@@ -42,5 +42,5 @@ jobs:
       with:
         # LICENSE is externally sourced and we're not going to fix it.
         exclude: "LICENSE.md"
-        config_file: .markdownlint.yaml
+        config_file: .markdownlint.yml
 
diff --git a/.markdownlint.yaml b/.markdownlint.yml
similarity index 100%
rename from .markdownlint.yaml
rename to .markdownlint.yml

From 4a49d23e54e59f9434690f87b18edec7e6e72b89 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 14:00:58 +0200
Subject: [PATCH 057/140] Added base Check class tests

---
 tests/checks/test_base_check.py | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/tests/checks/test_base_check.py b/tests/checks/test_base_check.py
index 556262d7..e313fd75 100644
--- a/tests/checks/test_base_check.py
+++ b/tests/checks/test_base_check.py
@@ -53,6 +53,35 @@ def test_check(self) -> None:
         with self.assertRaises(NotImplementedError):
             check.check(None, None)
 
+    def test_need_valid_config_valid_arg(self) -> None:
+        config = Config()
+        # Check is abstract class, extending ABC meta, so ordinary
+        # instantiation won't work.
+        Check.__abstractmethods__ = frozenset()
+        check = Check(config)
+        # We expect no problems.
+        check.need_valid_config()
+
+    def test_need_valid_config_no_config(self) -> None:
+        # Check is abstract class, extending ABC meta, so ordinary
+        # instantiation won't work.
+        Check.__abstractmethods__ = frozenset()
+        check = Check()
+        # Exception should be thrown
+        with self.assertRaises(ValueError):
+            check.need_valid_config()
+
+    def test_need_valid_config_invalid_config_type(self) -> None:
+        # Check is abstract class, extending ABC meta, so ordinary
+        # instantiation won't work.
+        Check.__abstractmethods__ = frozenset()
+        check = Check()
+        # Inject faulty 'config' to walk around constructor check.
+        check.config = 123
+        # Exception should be thrown
+        with self.assertRaises(ValueError):
+            check.need_valid_config()
+
     def test_need_both_files_missing_file(self) -> None:
         """
         Checks how need_both_files() is handling missing arguments.

From d65879fe078fa8fd0ad18f9c2f7e7e2e9a2dbab6 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 14:09:10 +0200
Subject: [PATCH 058/140] Corrected type of Error thrown by PropFile.append()

---
 proptool/prop/file.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index abf5f719..62ee35f5 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -81,7 +81,7 @@ def find_by_key(self, key: str) -> Union[Translation, None]:
 
     def append(self, item: PropItem):
         if not issubclass(type(item), PropItem):
-            raise ValueError('Item must subclass PropItem.')
+            raise TypeError('Item must subclass PropItem.')
 
         if isinstance(item, Translation):
             self.keys.append(item.key)

From 299bb455326a8ece867df212b026b005a6963eaa Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 14:09:53 +0200
Subject: [PATCH 059/140] Corrected test class name

---
 tests/prop/test_items.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/prop/test_items.py b/tests/prop/test_items.py
index 61f32496..64930e12 100644
--- a/tests/prop/test_items.py
+++ b/tests/prop/test_items.py
@@ -11,7 +11,7 @@
 from tests.test_case import TestCase
 
 
-class TestReportItem(TestCase):
+class TestPropItem(TestCase):
 
     def test_base_constructor_args_none(self) -> None:
         item = PropItem()

From 23ea17ffdc7173813341df79b5a3ee1fc717d1fd Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 14:10:09 +0200
Subject: [PATCH 060/140] Added PropFile tests

---
 tests/prop/test_file.py | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 tests/prop/test_file.py

diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
new file mode 100644
index 00000000..8f683f6b
--- /dev/null
+++ b/tests/prop/test_file.py
@@ -0,0 +1,26 @@
+"""
+# prop-tool
+# Java *.properties file sync checker and syncing tool.
+#
+# Copyright ©2021 Marcin Orlowski <mail [@] MarcinOrlowski.com>
+# https://github.com/MarcinOrlowski/prop-tool/
+#
+"""
+
+from proptool.config.config import Config
+from proptool.prop.file import PropFile
+from tests.test_case import TestCase
+
+
+class TestPropFile(TestCase):
+
+    def test_append_wrong_arg_type(self) -> None:
+        # GIVEN normal instance of PropFile
+        prop_file = PropFile(Config())
+
+        # WHEN we try to append object of unsupported type
+        obj = 'INVALID'
+
+        # THEN Exception should be thrown.
+        with self.assertRaises(TypeError):
+            prop_file.append(obj)

From ec4febad431ac6d9e4d1e4f394701998290e9f8a Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 15:23:53 +0200
Subject: [PATCH 061/140] PropFile's load() is now public method

---
 proptool/prop/file.py | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 62ee35f5..7caf540e 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -46,10 +46,11 @@ def __init__(self, config: Config, file: Union[Path, None] = None, language: Lis
         # All the keys in form `# ==> KEY =` that we found.
         self.commented_out_keys: List[str] = []
         self.separator: str = config.separator
-        self.loaded: bool = False
-        self.items: List[PropItem] = []
 
-        self.report = Report(config)
+        self.loaded: bool = None
+        self.items: List[PropItem] = None
+        self.report: Report = None
+        self.init_container()
 
         comment_pattern = re.escape(self.config.comment_template).replace(
             'COM', f'[{"".join(Config.ALLOWED_COMMENT_MARKERS)}]').replace(
@@ -59,7 +60,12 @@ def __init__(self, config: Config, file: Union[Path, None] = None, language: Lis
         self.comment_pattern = f'^{comment_pattern}'
 
         if file is not None:
-            self.loaded = self._load(file)
+            self.loaded = self.load(file)
+
+    def init_container(self) -> None:
+        self.loaded: bool = False
+        self.items: List[PropItem] = []
+        self.report: Report = Report(self.config)
 
     # #################################################################################################
 
@@ -155,13 +161,16 @@ def fix(self, reference: 'PropFile') -> None:
 
     # #################################################################################################
 
-    def _load(self, file: Path) -> bool:
+    def load(self, file: Path) -> bool:
         """
         Loads and parses *.properties file.
 
         :param file: File to load.
         :return:
         """
+
+        self.init_container(self.config)
+
         if not file.exists():
             return False
 

From c70e96878c58cedf1daeac968b8c8287eb902f96 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 16:00:23 +0200
Subject: [PATCH 062/140] Added PropFile.load()'s test

---
 proptool/prop/file.py   |  2 +-
 tests/prop/test_file.py | 95 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 96 insertions(+), 1 deletion(-)

diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 7caf540e..7107467f 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -169,7 +169,7 @@ def load(self, file: Path) -> bool:
         :return:
         """
 
-        self.init_container(self.config)
+        self.init_container()
 
         if not file.exists():
             return False
diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 8f683f6b..193cdf48 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -6,6 +6,10 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+from pathlib import Path
+from unittest.mock import Mock, mock_open, patch
+
+from proptool.prop.items import Blank, Comment, Translation
 
 from proptool.config.config import Config
 from proptool.prop.file import PropFile
@@ -24,3 +28,94 @@ def test_append_wrong_arg_type(self) -> None:
         # THEN Exception should be thrown.
         with self.assertRaises(TypeError):
             prop_file.append(obj)
+
+    # #################################################################################################
+
+    @patch('pathlib.Path.exists')
+    def test_load_non_existing_file(self, path_mock: Mock) -> None:
+        """
+        Tests if load() parses source file properly.
+        :return:
+        """
+        prop_file = PropFile(Config())
+
+        path_mock.return_value = False
+        prop_file.load(Path('foo'))
+
+    @patch('pathlib.Path.exists')
+    def test_load_valid_file(self, path_mock: Mock) -> None:
+        """
+        Tests if load() parses valid source *.properties file correctly.
+        """
+
+        comment1_marker = '#'
+        comment1_value = self.get_random_string('comment_')
+
+        key1 = self.get_random_string('key1_')
+        sep1 = '='
+        val1 = self.get_random_string('val1_')
+
+        comment2_marker = '!'
+        comment2_value = self.get_random_string('comment_')
+
+        key2 = self.get_random_string('key2_')
+        sep2 = '='
+        val2 = self.get_random_string('val2_')
+
+        # Contains 6 lines total (starts with blank line!)
+        fake_data = f"""
+{comment1_marker} {comment1_value}
+{key1} {sep1} {val1}
+
+{comment2_marker} {comment2_value}
+{key2} {sep2} {val2}
+"""
+
+        with patch('builtins.open', mock_open(read_data = fake_data)) as pm:
+            # Lie our file exists
+            path_mock.return_value = True
+            prop_file = PropFile(Config(), Path('foo'))
+            self.assertEqual(6, len(prop_file.items))
+
+            idx = 0
+
+            item = prop_file.items[idx]
+            self.assertBlank(item)
+            idx += 1
+
+            item = prop_file.items[idx]
+            self.assertComment(item, comment1_marker, comment1_value)
+            idx += 1
+
+            item = prop_file.items[idx]
+            self.assertTranslation(item, key1, sep1, val1)
+            idx += 1
+
+            item = prop_file.items[idx]
+            self.assertBlank(item)
+            idx += 1
+
+            item = prop_file.items[idx]
+            self.assertComment(item, comment2_marker, comment2_value)
+            self.assertIsNone(item.key)
+            idx += 1
+
+            item = prop_file.items[idx]
+            self.assertTranslation(item, key2, sep2, val2)
+            idx += 1
+
+    def assertTranslation(self, translation, exp_key, exp_separator, exp_value):
+        self.assertIsInstance(translation, Translation)
+        self.assertEqual(exp_key, translation.key)
+        self.assertEqual(exp_separator, translation.separator)
+        self.assertEqual(exp_value, translation.value)
+
+    def assertComment(self, comment, exp_marker, exp_value):
+        self.assertIsInstance(comment, Comment)
+        self.assertEqual(f'{exp_marker} {exp_value}', comment.value)
+        self.assertIsNone(comment.key)
+
+    def assertBlank(self, blank):
+        self.assertIsInstance(blank, Blank)
+        self.assertIsNone(blank.key)
+        self.assertIsNone(blank.value)

From 2f65f50ae6817f96cb045b93e86e95f1024ed8b8 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 19:53:04 +0200
Subject: [PATCH 063/140] Corrected LF/CRLF handling. CR alone is no longer
 stripped

---
 proptool/prop/file.py | 27 +++++++++------------------
 1 file changed, 9 insertions(+), 18 deletions(-)

diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 7107467f..cd40ce7f 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -29,7 +29,6 @@
 from proptool.prop.items import Blank, Comment, PropItem, Translation
 from proptool.report.group import ReportGroup
 from proptool.report.report import Report
-from proptool.utils import Utils
 
 
 # #################################################################################################
@@ -200,24 +199,16 @@ def load(self, file: Path) -> bool:
                     self.append(Comment(line))
                     continue
 
-                if not self.separator:
-                    # Let's look for used separator character
-                    for _, single_char in enumerate(line):
-                        if single_char in Config.ALLOWED_SEPARATORS:
-                            self.separator = single_char
-                            break
-
-                tmp: List[str] = line.split(self.separator)
-                if len(tmp) < 2:
-                    Utils.abort([
-                        f'Invalid syntax. Line {line_number}, file: {file}',
-                        f'Using "{self.separator}" as separator.',
-                    ])
-
-                key = tmp[0].strip()
-                val = ''.join(tmp[1:]).lstrip()
+                # Whatever left should be valid key[:=]val entry
+                tmp: List[str] = re.split(f'^(.+)([{"".join(Config.ALLOWED_SEPARATORS)}])(.+)$', line)
+                if len(tmp) != 5:
+                    Log.abort(f'Invalid syntax. Line {line_number}, file: {file}')
+
+                key = tmp[1].strip()
+                separator = tmp[2].strip()
+                val = tmp[3].lstrip()
                 if key not in self.keys:
-                    self.append(Translation(key, val, self.separator))
+                    self.append(Translation(key, val, separator))
                 else:
                     duplicated_keys.error(line_number, f'Duplicated key "{key}".')
 

From 12b4303fe010b58adcbe2d0c18591fbb16142c16 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 19:53:16 +0200
Subject: [PATCH 064/140] Improved PropFile.load() tests

---
 tests/prop/test_file.py | 59 ++++++++++++++++++++++++++++++++---------
 1 file changed, 47 insertions(+), 12 deletions(-)

diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 193cdf48..9b79579b 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -35,17 +35,51 @@ def test_append_wrong_arg_type(self) -> None:
     def test_load_non_existing_file(self, path_mock: Mock) -> None:
         """
         Tests if load() parses source file properly.
-        :return:
+
+        :param path_mock: Mocked Path
         """
         prop_file = PropFile(Config())
 
         path_mock.return_value = False
         prop_file.load(Path('foo'))
 
+    @patch('pathlib.Path.exists')
+    def test_load_strip_crlf(self, path_mock: Mock) -> None:
+        """
+        Ensures trailing LF and CRLFs are properly stripped from read lines.
+
+        :param path_mock: Mocked Path
+        """
+
+        com0 = self.get_random_string()
+        com1 = self.get_random_string()
+
+        for sep in Config.ALLOWED_COMMENT_MARKERS:
+            fake_data_src = [
+                f'{sep} {com0}\n',
+                f'{sep} {com1}\r\n',
+            ]
+
+            with patch('builtins.open', mock_open(read_data = ''.join(fake_data_src))) as pm:
+                # Lie our fake file exists
+                path_mock.return_value = True
+                prop_file = PropFile(Config(), Path('foo'))
+                self.assertEqual(len(fake_data_src), len(prop_file.items))
+
+                for comment in prop_file.items:
+                    self.assertIsInstance(comment, Comment)
+
+                item = prop_file.items[0]
+                self.assertEqual(f'{sep} {com0}', item.value)
+                item = prop_file.items[1]
+                self.assertEqual(f'{sep} {com1}', item.value)
+
     @patch('pathlib.Path.exists')
     def test_load_valid_file(self, path_mock: Mock) -> None:
         """
         Tests if load() parses valid source *.properties file correctly.
+
+        :param path_mock: Mocked Path
         """
 
         comment1_marker = '#'
@@ -63,19 +97,20 @@ def test_load_valid_file(self, path_mock: Mock) -> None:
         val2 = self.get_random_string('val2_')
 
         # Contains 6 lines total (starts with blank line!)
-        fake_data = f"""
-{comment1_marker} {comment1_value}
-{key1} {sep1} {val1}
-
-{comment2_marker} {comment2_value}
-{key2} {sep2} {val2}
-"""
-
-        with patch('builtins.open', mock_open(read_data = fake_data)) as pm:
-            # Lie our file exists
+        fake_data_src = [
+            '',
+            f'{comment1_marker} {comment1_value}',
+            f'{key1} {sep1} {val1}',
+            '',
+            f'{comment2_marker} {comment2_value}',
+            f'{key2} {sep2} {val2}',
+        ]
+
+        with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))) as pm:
+            # Lie our fake file exists
             path_mock.return_value = True
             prop_file = PropFile(Config(), Path('foo'))
-            self.assertEqual(6, len(prop_file.items))
+            self.assertEqual(len(fake_data_src), len(prop_file.items))
 
             idx = 0
 

From 3e9e71c374275572254abad187bff7a67dcc5971 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 19:53:53 +0200
Subject: [PATCH 065/140] Tests PropFile.load()'s handling of empty lines

---
 tests/prop/test_file.py | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 9b79579b..c8a80407 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -74,6 +74,28 @@ def test_load_strip_crlf(self, path_mock: Mock) -> None:
                 item = prop_file.items[1]
                 self.assertEqual(f'{sep} {com1}', item.value)
 
+    @patch('pathlib.Path.exists')
+    def test_load_empty_lines_whitespaces(self, path_mock: Mock) -> None:
+        """
+        Ensures lines with all whitespaces are correctly parsed as Blank()s
+
+        :param path_mock: Mocked Path
+        """
+        fake_data_src = [
+            '',
+            '     ',
+            '\t\t\t\t',
+            '\t\t\t   \t\t\t'
+        ]
+        with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))) as pm:
+            # Lie our fake file exists
+            path_mock.return_value = True
+            prop_file = PropFile(Config(), Path('foo'))
+            self.assertEqual(len(fake_data_src), len(prop_file.items))
+
+            for item in prop_file.items:
+                self.assertIsInstance(item, Blank)
+
     @patch('pathlib.Path.exists')
     def test_load_valid_file(self, path_mock: Mock) -> None:
         """
@@ -96,7 +118,6 @@ def test_load_valid_file(self, path_mock: Mock) -> None:
         sep2 = '='
         val2 = self.get_random_string('val2_')
 
-        # Contains 6 lines total (starts with blank line!)
         fake_data_src = [
             '',
             f'{comment1_marker} {comment1_value}',

From 2f4c3e7105d8f73da3e25ad8d1078654c57a5e52 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 20:29:08 +0200
Subject: [PATCH 066/140] Added another PropFile.file() test: invalid
 translation syntax

---
 proptool/prop/file.py   |   2 +-
 tests/prop/test_file.py | 100 +++++++++++++++++++++++++++++++---------
 2 files changed, 78 insertions(+), 24 deletions(-)

diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index cd40ce7f..17509898 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -202,7 +202,7 @@ def load(self, file: Path) -> bool:
                 # Whatever left should be valid key[:=]val entry
                 tmp: List[str] = re.split(f'^(.+)([{"".join(Config.ALLOWED_SEPARATORS)}])(.+)$', line)
                 if len(tmp) != 5:
-                    Log.abort(f'Invalid syntax. Line {line_number}, file: {file}')
+                    Log.abort(f'Invalid syntax at line {line_number} of "{file}".')
 
                 key = tmp[1].strip()
                 separator = tmp[2].strip()
diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index c8a80407..4c764881 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -6,8 +6,9 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+import random
 from pathlib import Path
-from unittest.mock import Mock, mock_open, patch
+from unittest.mock import Mock, call, mock_open, patch
 
 from proptool.prop.items import Blank, Comment, Translation
 
@@ -96,6 +97,59 @@ def test_load_empty_lines_whitespaces(self, path_mock: Mock) -> None:
             for item in prop_file.items:
                 self.assertIsInstance(item, Blank)
 
+    @patch('pathlib.Path.exists')
+    def test_load_empty_lines_whitespaces(self, path_mock: Mock) -> None:
+        """
+        Ensures lines with all whitespaces are correctly parsed as Blank()s
+
+        :param path_mock: Mocked Path
+        """
+        fake_data_src = [
+            '',
+            '     ',
+            '\t\t\t\t',
+            '\t\t\t   \t\t\t'
+        ]
+        with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))) as pm:
+            # Lie our fake file exists
+            path_mock.return_value = True
+            prop_file = PropFile(Config(), Path('foo'))
+            self.assertEqual(len(fake_data_src), len(prop_file.items))
+
+            for item in prop_file.items:
+                self.assertIsInstance(item, Blank)
+
+    @patch('pathlib.Path.exists')
+    @patch('builtins.print')  # Needed only to mute error message during unit tests.
+    def test_load_invalid_translation_syntax(self, path_mock: Mock, print_mock: Mock) -> None:
+        """
+        Ensures lines that are expected to be translation but do not match expected syntax
+        are caught correctly.
+
+        :param path_mock: Mocked Path
+        """
+
+        fake_file = '/tmp/foo'
+
+        # Generate some valid content
+        fake_data_src = []
+        # I could use list comprehension but cannot guarantee key uniqueness that way. I need unique prefix.
+        for idx in range(random.randint(10, 30)):
+            fake_data_src.append(f'key{idx}_{self.get_random_string()} {Config.ALLOWED_SEPARATORS[0]} {self.get_random_string()}')
+
+        # Insert incorrect syntax at random line
+        trap_position = random.randint(0, len(fake_data_src) - 1)
+        fake_data_src.insert(trap_position, 'WRONG SYNTAX')
+
+        with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))) as pm:
+            # Lie our fake file exists
+            path_mock.return_value = True
+            try:
+                prop_file = PropFile(Config(), Path(fake_file))
+                self.fail('We should not reach this line.')
+            except SystemExit:
+                pass
+
     @patch('pathlib.Path.exists')
     def test_load_valid_file(self, path_mock: Mock) -> None:
         """
@@ -104,6 +158,22 @@ def test_load_valid_file(self, path_mock: Mock) -> None:
         :param path_mock: Mocked Path
         """
 
+        def assertTranslation(translation, exp_key, exp_separator, exp_value):
+            self.assertIsInstance(translation, Translation)
+            self.assertEqual(exp_key, translation.key)
+            self.assertEqual(exp_separator, translation.separator)
+            self.assertEqual(exp_value, translation.value)
+
+        def assertComment(comment, exp_marker, exp_value):
+            self.assertIsInstance(comment, Comment)
+            self.assertEqual(f'{exp_marker} {exp_value}', comment.value)
+            self.assertIsNone(comment.key)
+
+        def assertBlank(blank):
+            self.assertIsInstance(blank, Blank)
+            self.assertIsNone(blank.key)
+            self.assertIsNone(blank.value)
+
         comment1_marker = '#'
         comment1_value = self.get_random_string('comment_')
 
@@ -136,42 +206,26 @@ def test_load_valid_file(self, path_mock: Mock) -> None:
             idx = 0
 
             item = prop_file.items[idx]
-            self.assertBlank(item)
+            assertBlank(item)
             idx += 1
 
             item = prop_file.items[idx]
-            self.assertComment(item, comment1_marker, comment1_value)
+            assertComment(item, comment1_marker, comment1_value)
             idx += 1
 
             item = prop_file.items[idx]
-            self.assertTranslation(item, key1, sep1, val1)
+            assertTranslation(item, key1, sep1, val1)
             idx += 1
 
             item = prop_file.items[idx]
-            self.assertBlank(item)
+            assertBlank(item)
             idx += 1
 
             item = prop_file.items[idx]
-            self.assertComment(item, comment2_marker, comment2_value)
+            assertComment(item, comment2_marker, comment2_value)
             self.assertIsNone(item.key)
             idx += 1
 
             item = prop_file.items[idx]
-            self.assertTranslation(item, key2, sep2, val2)
+            assertTranslation(item, key2, sep2, val2)
             idx += 1
-
-    def assertTranslation(self, translation, exp_key, exp_separator, exp_value):
-        self.assertIsInstance(translation, Translation)
-        self.assertEqual(exp_key, translation.key)
-        self.assertEqual(exp_separator, translation.separator)
-        self.assertEqual(exp_value, translation.value)
-
-    def assertComment(self, comment, exp_marker, exp_value):
-        self.assertIsInstance(comment, Comment)
-        self.assertEqual(f'{exp_marker} {exp_value}', comment.value)
-        self.assertIsNone(comment.key)
-
-    def assertBlank(self, blank):
-        self.assertIsInstance(blank, Blank)
-        self.assertIsNone(blank.key)
-        self.assertIsNone(blank.value)

From 25a8a0b35fa16be0ac8851d980338d359086ffab Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Tue, 27 Jul 2021 21:30:54 +0200
Subject: [PATCH 067/140] Improved PropFile's tests

---
 tests/prop/test_file.py | 112 ++++++++++++++++++++++------------------
 1 file changed, 62 insertions(+), 50 deletions(-)

diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 4c764881..15b151de 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -33,54 +33,80 @@ def test_append_wrong_arg_type(self) -> None:
     # #################################################################################################
 
     @patch('pathlib.Path.exists')
-    def test_load_non_existing_file(self, path_mock: Mock) -> None:
+    def test_load_non_existing_file(self, path_exists_mock: Mock) -> None:
         """
         Tests if load() parses source file properly.
 
-        :param path_mock: Mocked Path
+        :param path_exists_mock: Mocked Path
         """
         prop_file = PropFile(Config())
 
-        path_mock.return_value = False
+        path_exists_mock.return_value = False
         prop_file.load(Path('foo'))
 
     @patch('pathlib.Path.exists')
-    def test_load_strip_crlf(self, path_mock: Mock) -> None:
+    def test_load_strip_crlf(self, path_exists_mock: Mock) -> None:
         """
         Ensures trailing LF and CRLFs are properly stripped from read lines.
 
-        :param path_mock: Mocked Path
+        :param path_exists_mock: Mocked Path
         """
 
         com0 = self.get_random_string()
         com1 = self.get_random_string()
 
         for sep in Config.ALLOWED_COMMENT_MARKERS:
-            fake_data_src = [
-                f'{sep} {com0}\n',
-                f'{sep} {com1}\r\n',
-            ]
-
-            with patch('builtins.open', mock_open(read_data = ''.join(fake_data_src))) as pm:
-                # Lie our fake file exists
-                path_mock.return_value = True
-                prop_file = PropFile(Config(), Path('foo'))
-                self.assertEqual(len(fake_data_src), len(prop_file.items))
+            for key_val_sep in Config.ALLOWED_SEPARATORS:
+                key1 = self.get_random_string()
+                val1 = self.get_random_string()
+                val2 = self.get_random_string()
+                fake_data_src = [
+                    f'{sep} {com0}\n',
+                    f'{sep} {com1}\r\n',
+                    f'{key1} {key_val_sep} {val1}\n',
+                    # This one should overwrite previous row
+                    f'{key1} {key_val_sep} {val2}\r\n',
+                ]
+
+                with patch('builtins.open', mock_open(read_data = ''.join(fake_data_src))) as pm:
+                    # Lie our fake file exists
+                    path_exists_mock.return_value = True
+                    prop_file = PropFile(Config(), Path('foo'))
+
+                    # We should have one entry less, because once we strip CRLF from the last
+                    # row, it should overwrite entry set row before.
+                    self.assertEqual(len(fake_data_src) - 1, len(prop_file.items))
+
+                    # Let's inspect what we have.
+                    idx = 0
+
+                    # Line 0
+                    item = prop_file.items[idx]
+                    self.assertIsInstance(item, Comment)
+                    self.assertEqual(f'{sep} {com0}', item.value)
+                    idx += 1
+
+                    # Line 1
+                    item = prop_file.items[idx]
+                    self.assertIsInstance(item, Comment)
+                    self.assertEqual(f'{sep} {com1}', item.value)
+                    idx += 1
+
+                    # Line 2
+                    item = prop_file.items[idx]
+                    self.assertIsInstance(item, Translation)
+                    self.assertEqual(key1, item.key)
+                    # We have duplicated key. It's not overwritten row. Please see other code comments.
+                    self.assertEqual(val1, item.value)
+                    idx += 1
 
-                for comment in prop_file.items:
-                    self.assertIsInstance(comment, Comment)
-
-                item = prop_file.items[0]
-                self.assertEqual(f'{sep} {com0}', item.value)
-                item = prop_file.items[1]
-                self.assertEqual(f'{sep} {com1}', item.value)
 
     @patch('pathlib.Path.exists')
-    def test_load_empty_lines_whitespaces(self, path_mock: Mock) -> None:
+    def test_load_empty_lines_whitespaces(self, path_exists_mock: Mock) -> None:
         """
         Ensures lines with all whitespaces are correctly parsed as Blank()s
 
-        :param path_mock: Mocked Path
+        :param path_exists_mock: Mocked Path
         """
         fake_data_src = [
             '',
@@ -90,7 +116,7 @@ def test_load_empty_lines_whitespaces(self, path_mock: Mock) -> None:
         ]
         with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))) as pm:
             # Lie our fake file exists
-            path_mock.return_value = True
+            path_exists_mock.return_value = True
             prop_file = PropFile(Config(), Path('foo'))
             self.assertEqual(len(fake_data_src), len(prop_file.items))
 
@@ -98,30 +124,19 @@ def test_load_empty_lines_whitespaces(self, path_mock: Mock) -> None:
                 self.assertIsInstance(item, Blank)
 
     @patch('pathlib.Path.exists')
-    def test_load_empty_lines_whitespaces(self, path_mock: Mock) -> None:
+    def test_load_empty_file(self, path_exists_mock: Mock) -> None:
         """
-        Ensures lines with all whitespaces are correctly parsed as Blank()s
-
-        :param path_mock: Mocked Path
+        Checks if empty file is not too confusing.
         """
-        fake_data_src = [
-            '',
-            '     ',
-            '\t\t\t\t',
-            '\t\t\t   \t\t\t'
-        ]
-        with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))) as pm:
+        fake_file = f'/tmp/{self.get_random_string()}'
+        with patch('builtins.open', mock_open(read_data = '')):
             # Lie our fake file exists
-            path_mock.return_value = True
-            prop_file = PropFile(Config(), Path('foo'))
-            self.assertEqual(len(fake_data_src), len(prop_file.items))
+            path_exists_mock.return_value = True
+            prop_file = PropFile(Config(), Path(fake_file))
+            self.assertEqual(0, len(prop_file.items))
 
-            for item in prop_file.items:
-                self.assertIsInstance(item, Blank)
-
-    @patch('pathlib.Path.exists')
     @patch('builtins.print')  # Needed only to mute error message during unit tests.
-    def test_load_invalid_translation_syntax(self, path_mock: Mock, print_mock: Mock) -> None:
+    def test_load_invalid_translation_syntax(self, path_mock: Mock) -> None:
         """
         Ensures lines that are expected to be translation but do not match expected syntax
         are caught correctly.
@@ -129,7 +144,7 @@ def test_load_invalid_translation_syntax(self, path_mock: Mock, print_mock: Mock
         :param path_mock: Mocked Path
         """
 
-        fake_file = '/tmp/foo'
+        fake_file = f'/tmp/{self.get_random_string()}'
 
         # Generate some valid content
         fake_data_src = []
@@ -144,11 +159,8 @@ def test_load_invalid_translation_syntax(self, path_mock: Mock, print_mock: Mock
         with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))) as pm:
             # Lie our fake file exists
             path_mock.return_value = True
-            try:
-                prop_file = PropFile(Config(), Path(fake_file))
-                self.fail('We should not reach this line.')
-            except SystemExit:
-                pass
+            prop_file = PropFile(Config(), Path(fake_file))
+            self.assertEqual(0, len(prop_file.items))
 
     @patch('pathlib.Path.exists')
     def test_load_valid_file(self, path_mock: Mock) -> None:

From 4451d0d7db922996f4841e118ba51bd946ff9634 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 07:19:35 +0200
Subject: [PATCH 068/140] Added PropFile.load() invalid translation syntax
 handling test

---
 tests/prop/test_file.py | 36 +++++++++++++++++++++++-------------
 1 file changed, 23 insertions(+), 13 deletions(-)

diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 15b151de..48c6ab87 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -8,7 +8,9 @@
 """
 import random
 from pathlib import Path
-from unittest.mock import Mock, call, mock_open, patch
+from unittest.mock import DEFAULT, Mock, call, mock_open, patch
+
+from proptool.log import Log
 
 from proptool.prop.items import Blank, Comment, Translation
 
@@ -100,7 +102,6 @@ def test_load_strip_crlf(self, path_exists_mock: Mock) -> None:
                     self.assertEqual(val1, item.value)
                     idx += 1
 
-
     @patch('pathlib.Path.exists')
     def test_load_empty_lines_whitespaces(self, path_exists_mock: Mock) -> None:
         """
@@ -135,32 +136,41 @@ def test_load_empty_file(self, path_exists_mock: Mock) -> None:
             prop_file = PropFile(Config(), Path(fake_file))
             self.assertEqual(0, len(prop_file.items))
 
-    @patch('builtins.print')  # Needed only to mute error message during unit tests.
-    def test_load_invalid_translation_syntax(self, path_mock: Mock) -> None:
+    @patch('pathlib.Path.exists')
+    def test_load_invalid_translation_invalid_syntax(self, path_mock: Mock) -> None:
         """
         Ensures lines that are expected to be translation but do not match expected syntax
         are caught correctly.
 
         :param path_mock: Mocked Path
+        :param print_mock: Mocked print()
         """
 
-        fake_file = f'/tmp/{self.get_random_string()}'
+        fake_file_name = f'/tmp/{self.get_random_string()}'
 
-        # Generate some valid content
+        # Fake source file content
         fake_data_src = []
-        # I could use list comprehension but cannot guarantee key uniqueness that way. I need unique prefix.
+        # I could use list comprehension but cannot guarantee key uniqueness that way. I need unique prefix then.
         for idx in range(random.randint(10, 30)):
             fake_data_src.append(f'key{idx}_{self.get_random_string()} {Config.ALLOWED_SEPARATORS[0]} {self.get_random_string()}')
 
-        # Insert incorrect syntax at random line
+        # # Insert incorrect syntax at random line
         trap_position = random.randint(0, len(fake_data_src) - 1)
         fake_data_src.insert(trap_position, 'WRONG SYNTAX')
 
-        with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))) as pm:
-            # Lie our fake file exists
-            path_mock.return_value = True
-            prop_file = PropFile(Config(), Path(fake_file))
-            self.assertEqual(0, len(prop_file.items))
+        def log_abort_side_effect(messages):
+            """
+            Side effect to be called when Log.abort() is invoked to break the load() loop.
+            """
+            raise SystemExit
+
+        with patch('proptool.log.Log.abort', side_effect = log_abort_side_effect) as mocked_log_abort:
+            with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))) as mocked_open:
+                try:
+                    PropFile(Config(), Path(fake_file_name))
+                except SystemExit as ex:
+                    log_abort_call: call = mocked_log_abort.call_args_list[0]
+                    self.assertEqual(f'Invalid syntax at line {trap_position + 1} of "{fake_file_name}".', log_abort_call.args[0])
 
     @patch('pathlib.Path.exists')
     def test_load_valid_file(self, path_mock: Mock) -> None:

From c5cfb34a6c3eaecd20a3c84b90f62925c85378b2 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 07:28:05 +0200
Subject: [PATCH 069/140] Lint fixes

---
 .flake8                 |  5 +++++
 proptool/prop/file.py   |  3 +--
 tests/prop/test_file.py | 30 +++++++++++++-----------------
 3 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/.flake8 b/.flake8
index 84d2d805..f0fb4e39 100644
--- a/.flake8
+++ b/.flake8
@@ -131,6 +131,11 @@ per-file-ignores =
     # WPS437 Found protected attribute usage: _set_on_off_option
     tests/report/test_config_builder.py: WPS431, WPS437,
 
+    # WPS430 Found nested function: log_abort_side_effect
+    # S311 Standard pseudo-random generators are not suitable for security/cryptographic purposes.
+    # N802 function name 'assertTranslation' should be lowercase
+    tests/prop/test_file.py: WPS430, S311, N802
+
     # WPS230 Found too many public instance attributes: 8 > 6
     # WPS414 Found incorrect unpacking target
     # WPS425 Found boolean non-keyword argument: True, False
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 17509898..cbac910f 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -165,9 +165,8 @@ def load(self, file: Path) -> bool:
         Loads and parses *.properties file.
 
         :param file: File to load.
-        :return:
+        :return: True if file loaded correctly, False otherwise.
         """
-
         self.init_container()
 
         if not file.exists():
diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 48c6ab87..54d5386c 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -8,14 +8,11 @@
 """
 import random
 from pathlib import Path
-from unittest.mock import DEFAULT, Mock, call, mock_open, patch
-
-from proptool.log import Log
-
-from proptool.prop.items import Blank, Comment, Translation
+from unittest.mock import Mock, call, mock_open, patch
 
 from proptool.config.config import Config
 from proptool.prop.file import PropFile
+from proptool.prop.items import Blank, Comment, Translation
 from tests.test_case import TestCase
 
 
@@ -53,7 +50,6 @@ def test_load_strip_crlf(self, path_exists_mock: Mock) -> None:
 
         :param path_exists_mock: Mocked Path
         """
-
         com0 = self.get_random_string()
         com1 = self.get_random_string()
 
@@ -70,7 +66,7 @@ def test_load_strip_crlf(self, path_exists_mock: Mock) -> None:
                     f'{key1} {key_val_sep} {val2}\r\n',
                 ]
 
-                with patch('builtins.open', mock_open(read_data = ''.join(fake_data_src))) as pm:
+                with patch('builtins.open', mock_open(read_data = ''.join(fake_data_src))):
                     # Lie our fake file exists
                     path_exists_mock.return_value = True
                     prop_file = PropFile(Config(), Path('foo'))
@@ -113,9 +109,9 @@ def test_load_empty_lines_whitespaces(self, path_exists_mock: Mock) -> None:
             '',
             '     ',
             '\t\t\t\t',
-            '\t\t\t   \t\t\t'
+            '\t\t\t   \t\t\t',
         ]
-        with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))) as pm:
+        with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))):
             # Lie our fake file exists
             path_exists_mock.return_value = True
             prop_file = PropFile(Config(), Path('foo'))
@@ -129,11 +125,11 @@ def test_load_empty_file(self, path_exists_mock: Mock) -> None:
         """
         Checks if empty file is not too confusing.
         """
-        fake_file = f'/tmp/{self.get_random_string()}'
+        fake_file_name = f'/does/not/matter/{self.get_random_string()}'
         with patch('builtins.open', mock_open(read_data = '')):
             # Lie our fake file exists
             path_exists_mock.return_value = True
-            prop_file = PropFile(Config(), Path(fake_file))
+            prop_file = PropFile(Config(), Path(fake_file_name))
             self.assertEqual(0, len(prop_file.items))
 
     @patch('pathlib.Path.exists')
@@ -145,13 +141,13 @@ def test_load_invalid_translation_invalid_syntax(self, path_mock: Mock) -> None:
         :param path_mock: Mocked Path
         :param print_mock: Mocked print()
         """
-
-        fake_file_name = f'/tmp/{self.get_random_string()}'
+        fake_file_name = f'/does/not/matter/{self.get_random_string()}'
 
         # Fake source file content
         fake_data_src = []
         # I could use list comprehension but cannot guarantee key uniqueness that way. I need unique prefix then.
-        for idx in range(random.randint(10, 30)):
+        max_elements = 30
+        for idx in range(random.randint(10, max_elements)):
             fake_data_src.append(f'key{idx}_{self.get_random_string()} {Config.ALLOWED_SEPARATORS[0]} {self.get_random_string()}')
 
         # # Insert incorrect syntax at random line
@@ -165,10 +161,10 @@ def log_abort_side_effect(messages):
             raise SystemExit
 
         with patch('proptool.log.Log.abort', side_effect = log_abort_side_effect) as mocked_log_abort:
-            with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))) as mocked_open:
+            with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))):
                 try:
                     PropFile(Config(), Path(fake_file_name))
-                except SystemExit as ex:
+                except SystemExit:
                     log_abort_call: call = mocked_log_abort.call_args_list[0]
                     self.assertEqual(f'Invalid syntax at line {trap_position + 1} of "{fake_file_name}".', log_abort_call.args[0])
 
@@ -219,7 +215,7 @@ def assertBlank(blank):
             f'{key2} {sep2} {val2}',
         ]
 
-        with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))) as pm:
+        with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))):
             # Lie our fake file exists
             path_mock.return_value = True
             prop_file = PropFile(Config(), Path('foo'))

From 37bb25ce387fd19787526da80c2e250e7e2ddd15 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 07:35:57 +0200
Subject: [PATCH 070/140] MD lint fixes

---
 tests/prop/test_file.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 54d5386c..1512625e 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -133,13 +133,12 @@ def test_load_empty_file(self, path_exists_mock: Mock) -> None:
             self.assertEqual(0, len(prop_file.items))
 
     @patch('pathlib.Path.exists')
-    def test_load_invalid_translation_invalid_syntax(self, path_mock: Mock) -> None:
+    def test_load_invalid_translation_invalid_syntax(self, path_exists_mock: Mock) -> None:
         """
         Ensures lines that are expected to be translation but do not match expected syntax
         are caught correctly.
 
         :param path_mock: Mocked Path
-        :param print_mock: Mocked print()
         """
         fake_file_name = f'/does/not/matter/{self.get_random_string()}'
 
@@ -161,6 +160,9 @@ def log_abort_side_effect(messages):
             raise SystemExit
 
         with patch('proptool.log.Log.abort', side_effect = log_abort_side_effect) as mocked_log_abort:
+            # Lie our fake file exists
+            path_exists_mock.return_value = True
+
             with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))):
                 try:
                     PropFile(Config(), Path(fake_file_name))

From 8162f721026fde8bd0dd475ddf87d956415bbdcb Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 07:43:59 +0200
Subject: [PATCH 071/140] Cleaned load() test

---
 tests/prop/test_file.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 1512625e..a2bc8362 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -167,8 +167,9 @@ def log_abort_side_effect(messages):
                 try:
                     PropFile(Config(), Path(fake_file_name))
                 except SystemExit:
+                    mocked_log_abort.assert_called_once()
                     log_abort_call: call = mocked_log_abort.call_args_list[0]
-                    self.assertEqual(f'Invalid syntax at line {trap_position + 1} of "{fake_file_name}".', log_abort_call.args[0])
+                    self.assertEqual(log_abort_call.args[0], f'Invalid syntax at line {trap_position + 1} of "{fake_file_name}".')
 
     @patch('pathlib.Path.exists')
     def test_load_valid_file(self, path_mock: Mock) -> None:

From 2a736f5387800bbea7f29958065a82c5fbb2bf4c Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 08:06:02 +0200
Subject: [PATCH 072/140] Updated pip in coverage.yml

---
 .github/workflows/codecov.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/codecov.yml b/.github/workflows/codecov.yml
index 6a877933..f8e6a6bf 100644
--- a/.github/workflows/codecov.yml
+++ b/.github/workflows/codecov.yml
@@ -39,6 +39,7 @@ jobs:
 
       - name: "Generate coverage report"
         run: |
+          python -m pip install --upgrade pip
           pip install pytest
           pip install pytest-cov
           pytest --cov=./ --cov-report=xml

From 3a8c5b221c9a13f7a4e5e4fb8a0f1d7368d22bdc Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 12:00:53 +0200
Subject: [PATCH 073/140] Cleanup

---
 .github/workflows/codecov.yml | 1 +
 proptool/prop/file.py         | 9 ++++-----
 tests/prop/test_file.py       | 6 +++---
 3 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/codecov.yml b/.github/workflows/codecov.yml
index f8e6a6bf..34e34f58 100644
--- a/.github/workflows/codecov.yml
+++ b/.github/workflows/codecov.yml
@@ -42,6 +42,7 @@ jobs:
           python -m pip install --upgrade pip
           pip install pytest
           pip install pytest-cov
+          pytest --version
           pytest --cov=./ --cov-report=xml
 
       # https://github.com/marketplace/actions/codecov
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index cbac910f..d15ed7d2 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -46,11 +46,6 @@ def __init__(self, config: Config, file: Union[Path, None] = None, language: Lis
         self.commented_out_keys: List[str] = []
         self.separator: str = config.separator
 
-        self.loaded: bool = None
-        self.items: List[PropItem] = None
-        self.report: Report = None
-        self.init_container()
-
         comment_pattern = re.escape(self.config.comment_template).replace(
             'COM', f'[{"".join(Config.ALLOWED_COMMENT_MARKERS)}]').replace(
             'SEP', f'[{"".join(Config.ALLOWED_SEPARATORS)}]')
@@ -60,6 +55,10 @@ def __init__(self, config: Config, file: Union[Path, None] = None, language: Lis
 
         if file is not None:
             self.loaded = self.load(file)
+        else:
+            self.loaded: bool = False
+            self.items: List[PropItem] = []
+            self.report: Report = Report(config)
 
     def init_container(self) -> None:
         self.loaded: bool = False
diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index a2bc8362..4cd4d5f3 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -138,7 +138,7 @@ def test_load_invalid_translation_invalid_syntax(self, path_exists_mock: Mock) -
         Ensures lines that are expected to be translation but do not match expected syntax
         are caught correctly.
 
-        :param path_mock: Mocked Path
+        :param path_exists_mock: Mocked Path
         """
         fake_file_name = f'/does/not/matter/{self.get_random_string()}'
 
@@ -179,13 +179,13 @@ def test_load_valid_file(self, path_mock: Mock) -> None:
         :param path_mock: Mocked Path
         """
 
-        def assertTranslation(translation, exp_key, exp_separator, exp_value):
+        def assertTranslation(translation: Translation, exp_key, exp_separator, exp_value):
             self.assertIsInstance(translation, Translation)
             self.assertEqual(exp_key, translation.key)
             self.assertEqual(exp_separator, translation.separator)
             self.assertEqual(exp_value, translation.value)
 
-        def assertComment(comment, exp_marker, exp_value):
+        def assertComment(comment: Comment, exp_marker, exp_value):
             self.assertIsInstance(comment, Comment)
             self.assertEqual(f'{exp_marker} {exp_value}', comment.value)
             self.assertIsNone(comment.key)

From d6939c3a74f80097680e33c034c030fa4b3442f0 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 12:05:12 +0200
Subject: [PATCH 074/140] Fixed call()'s args access

---
 tests/prop/test_file.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 4cd4d5f3..8dbef74c 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -169,7 +169,9 @@ def log_abort_side_effect(messages):
                 except SystemExit:
                     mocked_log_abort.assert_called_once()
                     log_abort_call: call = mocked_log_abort.call_args_list[0]
-                    self.assertEqual(log_abort_call.args[0], f'Invalid syntax at line {trap_position + 1} of "{fake_file_name}".')
+                    self.assertEqual(len(log_abort_call.args), 1)
+                    arg = log_abort_call.args[0]
+                    self.assertEqual(arg, f'Invalid syntax at line {trap_position + 1} of "{fake_file_name}".')
 
     @patch('pathlib.Path.exists')
     def test_load_valid_file(self, path_mock: Mock) -> None:

From 2b7e3ce891b958e83439452184fe1ba79b6801a8 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 12:06:53 +0200
Subject: [PATCH 075/140] Fixed call()'s args access

---
 tests/prop/test_file.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 8dbef74c..7433addb 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -169,7 +169,6 @@ def log_abort_side_effect(messages):
                 except SystemExit:
                     mocked_log_abort.assert_called_once()
                     log_abort_call: call = mocked_log_abort.call_args_list[0]
-                    self.assertEqual(len(log_abort_call.args), 1)
                     arg = log_abort_call.args[0]
                     self.assertEqual(arg, f'Invalid syntax at line {trap_position + 1} of "{fake_file_name}".')
 

From 741e82751b3bfddc42b840ce2ad75581a758dce4 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 12:10:37 +0200
Subject: [PATCH 076/140] Switched ot use Python 3.8 for coverage

---
 .github/workflows/codecov.yml | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/codecov.yml b/.github/workflows/codecov.yml
index 34e34f58..64d4fd00 100644
--- a/.github/workflows/codecov.yml
+++ b/.github/workflows/codecov.yml
@@ -24,7 +24,7 @@ jobs:
 
     env:
       OS: ${{ matrix.os }}
-      PYTHON: '3.7'
+      PYTHON: '3.8'
 
     steps:
       # https://github.com/marketplace/actions/checkout
@@ -34,7 +34,7 @@ jobs:
       - name: "Setup Python"
         uses: actions/setup-python@master
         with:
-          python-version: 3.7
+          python-version: 3.8
 
 
       - name: "Generate coverage report"
@@ -42,7 +42,10 @@ jobs:
           python -m pip install --upgrade pip
           pip install pytest
           pip install pytest-cov
+          echo "****************************************"
+          python --version
           pytest --version
+          echo "****************************************"
           pytest --cov=./ --cov-report=xml
 
       # https://github.com/marketplace/actions/codecov

From 3ca5e6be3de7a91e922474b0d1f2d291154b798d Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 12:15:16 +0200
Subject: [PATCH 077/140] Updated UTests to run on various OSes and Python
 versions

---
 .github/workflows/codecov.yml   |  1 -
 .github/workflows/unittests.yml | 12 +++++++++++-
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/codecov.yml b/.github/workflows/codecov.yml
index 64d4fd00..183b6f57 100644
--- a/.github/workflows/codecov.yml
+++ b/.github/workflows/codecov.yml
@@ -36,7 +36,6 @@ jobs:
         with:
           python-version: 3.8
 
-
       - name: "Generate coverage report"
         run: |
           python -m pip install --upgrade pip
diff --git a/.github/workflows/unittests.yml b/.github/workflows/unittests.yml
index 33d70e5a..3fb44eda 100644
--- a/.github/workflows/unittests.yml
+++ b/.github/workflows/unittests.yml
@@ -17,7 +17,11 @@ on:
 jobs:
   unittests:
     name: "Testing"
-    runs-on: ubuntu-latest
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ ubuntu-latest, macos-latest, windows-latest ]
+        python: [3.6, 3.7, 3.8]
 
     steps:
       # https://github.com/marketplace/actions/checkout
@@ -33,6 +37,12 @@ jobs:
             srcs:
               - '**/*.py'
 
+      - name: "Setup Python"
+        if: steps.filter.outputs.srcs == 'true'
+        uses: actions/setup-python@master
+        with:
+          python-version: ${{ matrix.python }}
+
       - name: "Running unit tests..."
         if: steps.filter.outputs.srcs == 'true'
         run: python -m unittest discover tests

From 1e3cb3bfac41d9b916b171423665e1c14a0307ce Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 12:49:30 +0200
Subject: [PATCH 078/140] Added tests for PropFile's is_valid()

---
 proptool/prop/file.py   | 13 +++++++++----
 tests/prop/test_file.py | 40 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 49 insertions(+), 4 deletions(-)

diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index d15ed7d2..15abedc2 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -100,20 +100,25 @@ def append(self, item: PropItem):
     # #################################################################################################
 
     def validate_and_fix(self, reference: 'PropFile') -> None:
-        if not self.validate(reference) and self.config.fix:
+        if not self.is_valid(reference) and self.config.fix:
             self.fix(reference)
 
     # #################################################################################################
 
-    def validate(self, reference_file: 'PropFile') -> bool:
+    def is_valid(self, reference_file: 'PropFile') -> bool:
         """
         Validates given PropFile against provided reference file.
 
         :param reference_file:
-        :return:
+        :return True if file is valid, False if there were errors.
         """
         if not self.loaded:
-            Log.e(f'File does not exist: {self.file}')
+            rg = ReportGroup('Filesystem')
+            if self.file is None:
+                rg.error(None, 'No properties file set.')
+            else:
+                rg.error(None, f'File not found: {self.file}')
+            self.report.add(rg)
             return False
 
         checks = [
diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 7433addb..ab5da662 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -251,3 +251,43 @@ def assertBlank(blank):
             item = prop_file.items[idx]
             assertTranslation(item, key2, sep2, val2)
             idx += 1
+
+    # #################################################################################################
+
+    @patch('pathlib.Path.exists')
+    def test_is_valid_on_empty_files(self, path_exists_mock: Mock) -> None:
+
+        fake_file_name = f'/does/not/matter/{self.get_random_string()}'
+        with patch('builtins.open', mock_open(read_data = '')):
+            config = Config()
+
+            # Lie our fake file exists
+            path_exists_mock.return_value = True
+
+            ref_file = PropFile(config, Path(fake_file_name))
+            prop_file = PropFile(config, Path(fake_file_name))
+
+            # Expecting no problems reported
+            self.assertTrue(prop_file.is_valid(ref_file))
+
+    def test_is_valid_file_not_set(self) -> None:
+        config = Config()
+        ref_file = PropFile(config)
+        prop_file = PropFile(config)
+
+        # Expecting errors reported
+        self.assertFalse(prop_file.is_valid(ref_file))
+        # FIXME: we shall also check if reported error message
+
+    def test_is_valid_file_not_found(self) -> None:
+        config = Config()
+        fake_file_name = self.get_random_string()
+        ref_file = PropFile(config, Path(fake_file_name))
+        prop_file = PropFile(config, Path(fake_file_name))
+
+        # Expecting errors reported
+        self.assertFalse(prop_file.is_valid(ref_file))
+        # FIXME: we shall also check if reported error message
+
+
+

From bc7cd55b026d0d6401399fe56cb2f46bb5e7ef2c Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 12:54:58 +0200
Subject: [PATCH 079/140] Updated checks to not access config file if there's
 no item to validate (simplifies unit tests)

---
 proptool/checks/brackets.py   |  7 +++++--
 proptool/checks/key_format.py | 21 +++++++++++----------
 2 files changed, 16 insertions(+), 12 deletions(-)

diff --git a/proptool/checks/brackets.py b/proptool/checks/brackets.py
index 80b69bf5..f1a25b9b 100644
--- a/proptool/checks/brackets.py
+++ b/proptool/checks/brackets.py
@@ -37,11 +37,14 @@ class Brackets(Check):
     def check(self, translation: 'PropFile', reference: 'PropFile' = None) -> ReportGroup:
         self.need_valid_config()
 
+        report = ReportGroup(self.report_title)
+
+        if not translation.items:
+            return report
+
         opening = self.config.checks[self.__class__.__name__]['opening']
         closing = self.config.checks[self.__class__.__name__]['closing']
 
-        report = ReportGroup(self.report_title)
-
         for idx, item in enumerate(translation.items):
             # Do not try to be clever and filter() data first, because line_number values will no longer be correct.
             if not isinstance(item, (Translation, Comment)):
diff --git a/proptool/checks/key_format.py b/proptool/checks/key_format.py
index b981222e..3332e306 100644
--- a/proptool/checks/key_format.py
+++ b/proptool/checks/key_format.py
@@ -29,19 +29,20 @@ class KeyFormat(Check):
     def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None) -> ReportGroup:
         self.need_valid_config()
 
-        pattern = self.config.checks['KeyFormat']['pattern']
-        compiled_pattern = re.compile(pattern)
+        report = ReportGroup(f'Key naming pattern.')
 
-        report = ReportGroup(f'Key naming pattern: {pattern}')
+        if translation_file.items:
+            pattern = self.config.checks['KeyFormat']['pattern']
+            compiled_pattern = re.compile(pattern)
 
-        for line_number, item in enumerate(translation_file.items):
-            # We care translations only for now.
-            # Do not try to be clever and filter() data first, because line_number values will no longer be correct.
-            if not isinstance(item, Translation):
-                continue
+            for line_number, item in enumerate(translation_file.items):
+                # We care translations only for now.
+                # Do not try to be clever and filter() data first, because line_number values will no longer be correct.
+                if not isinstance(item, Translation):
+                    continue
 
-            if compiled_pattern.match(item.key) is None:
-                report.error(line_number + 1, 'Invalid key name format.', item.key)
+                if compiled_pattern.match(item.key) is None:
+                    report.error(line_number + 1, 'Invalid key name format.', item.key)
 
         return report
 

From b56c54688e81fc5652c3e43c74a87ac531091d10 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 14:54:08 +0200
Subject: [PATCH 080/140] Corrected UT to work on Python 3.6 too

---
 proptool/checks/base/check.py |  4 ----
 tests/prop/test_file.py       | 20 ++++++++++----------
 2 files changed, 10 insertions(+), 14 deletions(-)

diff --git a/proptool/checks/base/check.py b/proptool/checks/base/check.py
index e847dd75..e43731c2 100644
--- a/proptool/checks/base/check.py
+++ b/proptool/checks/base/check.py
@@ -41,7 +41,3 @@ def need_valid_config(self) -> None:
 
     def get_default_config(self) -> Dict:
         return Check.DEFAULT_CHECK_CONFIG
-
-    # @abstractmethod
-    # def parse_args(self, args: argparse) -> Dict:
-    #     raise NotImplementedError
diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index ab5da662..ac707994 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -12,7 +12,7 @@
 
 from proptool.config.config import Config
 from proptool.prop.file import PropFile
-from proptool.prop.items import Blank, Comment, Translation
+from proptool.prop.items import Blank, Comment, PropItem, Translation
 from tests.test_case import TestCase
 
 
@@ -27,6 +27,7 @@ def test_append_wrong_arg_type(self) -> None:
 
         # THEN Exception should be thrown.
         with self.assertRaises(TypeError):
+            # noinspection PyTypeChecker
             prop_file.append(obj)
 
     # #################################################################################################
@@ -153,6 +154,7 @@ def test_load_invalid_translation_invalid_syntax(self, path_exists_mock: Mock) -
         trap_position = random.randint(0, len(fake_data_src) - 1)
         fake_data_src.insert(trap_position, 'WRONG SYNTAX')
 
+        # noinspection PyUnusedLocal
         def log_abort_side_effect(messages):
             """
             Side effect to be called when Log.abort() is invoked to break the load() loop.
@@ -167,10 +169,8 @@ def log_abort_side_effect(messages):
                 try:
                     PropFile(Config(), Path(fake_file_name))
                 except SystemExit:
-                    mocked_log_abort.assert_called_once()
-                    log_abort_call: call = mocked_log_abort.call_args_list[0]
-                    arg = log_abort_call.args[0]
-                    self.assertEqual(arg, f'Invalid syntax at line {trap_position + 1} of "{fake_file_name}".')
+                    msg,  = mocked_log_abort.call_args_list[0][0]
+                    self.assertEqual(msg, f'Invalid syntax at line {trap_position + 1} of "{fake_file_name}".')
 
     @patch('pathlib.Path.exists')
     def test_load_valid_file(self, path_mock: Mock) -> None:
@@ -180,17 +180,20 @@ def test_load_valid_file(self, path_mock: Mock) -> None:
         :param path_mock: Mocked Path
         """
 
-        def assertTranslation(translation: Translation, exp_key, exp_separator, exp_value):
+        # noinspection PyPep8Naming
+        def assertTranslation(translation: PropItem, exp_key, exp_separator, exp_value):
             self.assertIsInstance(translation, Translation)
             self.assertEqual(exp_key, translation.key)
             self.assertEqual(exp_separator, translation.separator)
             self.assertEqual(exp_value, translation.value)
 
-        def assertComment(comment: Comment, exp_marker, exp_value):
+        # noinspection PyPep8Naming
+        def assertComment(comment: PropItem, exp_marker, exp_value):
             self.assertIsInstance(comment, Comment)
             self.assertEqual(f'{exp_marker} {exp_value}', comment.value)
             self.assertIsNone(comment.key)
 
+        # noinspection PyPep8Naming
         def assertBlank(blank):
             self.assertIsInstance(blank, Blank)
             self.assertIsNone(blank.key)
@@ -288,6 +291,3 @@ def test_is_valid_file_not_found(self) -> None:
         # Expecting errors reported
         self.assertFalse(prop_file.is_valid(ref_file))
         # FIXME: we shall also check if reported error message
-
-
-

From 086b62e18bafc23b0259687a4d661f1a7a78f67e Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 14:55:24 +0200
Subject: [PATCH 081/140] Updated .gitignore

---
 .gitignore | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/.gitignore b/.gitignore
index 674f46a8..5d661884 100644
--- a/.gitignore
+++ b/.gitignore
@@ -3,6 +3,7 @@
 
 # IDEA
 .idea/
+*.iml
 
 # Byte-compiled / optimized / DLL files
 __pycache__/
@@ -109,9 +110,11 @@ celerybeat.pid
 
 # Environments
 .env
-.venv
+/.venv
+/.venv*
 env/
-venv/
+/venv/
+/venv*/
 ENV/
 env.bak/
 venv.bak/

From 88cf8abfa5de6f3f4dd45bbe36b8a5bb0cdfe778 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 15:02:42 +0200
Subject: [PATCH 082/140] Lint fixes

---
 .flake8                       | 1 +
 proptool/checks/key_format.py | 2 +-
 proptool/prop/file.py         | 2 +-
 tests/prop/test_file.py       | 4 ++--
 4 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/.flake8 b/.flake8
index f0fb4e39..f8002ae4 100644
--- a/.flake8
+++ b/.flake8
@@ -24,6 +24,7 @@ ignore =
     D102, # D102 Missing docstring in public method
     D107, # D107 Missing docstring in __init__
     D200, # D200 One-line docstring should fit on one line with quotes
+    D202, # D202 No blank lines allowed after function docstring
     D205, # D205 1 blank line required between summary line and description
     D400, # D400 First line should end with a period
     D401, # D401 First line should be in imperative mood
diff --git a/proptool/checks/key_format.py b/proptool/checks/key_format.py
index 3332e306..6eb28c79 100644
--- a/proptool/checks/key_format.py
+++ b/proptool/checks/key_format.py
@@ -29,7 +29,7 @@ class KeyFormat(Check):
     def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None) -> ReportGroup:
         self.need_valid_config()
 
-        report = ReportGroup(f'Key naming pattern.')
+        report = ReportGroup('Key naming pattern.')
 
         if translation_file.items:
             pattern = self.config.checks['KeyFormat']['pattern']
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 15abedc2..cdb12dd0 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -110,7 +110,7 @@ def is_valid(self, reference_file: 'PropFile') -> bool:
         Validates given PropFile against provided reference file.
 
         :param reference_file:
-        :return True if file is valid, False if there were errors.
+        :return: True if file is valid, False if there were errors.
         """
         if not self.loaded:
             rg = ReportGroup('Filesystem')
diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index ac707994..1baa84e4 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -8,7 +8,7 @@
 """
 import random
 from pathlib import Path
-from unittest.mock import Mock, call, mock_open, patch
+from unittest.mock import Mock, mock_open, patch
 
 from proptool.config.config import Config
 from proptool.prop.file import PropFile
@@ -169,7 +169,7 @@ def log_abort_side_effect(messages):
                 try:
                     PropFile(Config(), Path(fake_file_name))
                 except SystemExit:
-                    msg,  = mocked_log_abort.call_args_list[0][0]
+                    msg = mocked_log_abort.call_args_list[0][0][0]
                     self.assertEqual(msg, f'Invalid syntax at line {trap_position + 1} of "{fake_file_name}".')
 
     @patch('pathlib.Path.exists')

From 471071a7f0fc5a96287ca1f61ed7b1b2fa5aeca2 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 15:07:39 +0200
Subject: [PATCH 083/140] Disabled Win/macOS UT runs

---
 .github/workflows/unittests.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/unittests.yml b/.github/workflows/unittests.yml
index 3fb44eda..ea2d7af4 100644
--- a/.github/workflows/unittests.yml
+++ b/.github/workflows/unittests.yml
@@ -20,7 +20,8 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        os: [ ubuntu-latest, macos-latest, windows-latest ]
+        # os: [ ubuntu-latest, macos-latest, windows-latest ]
+        os: [ ubuntu-latest ]
         python: [3.6, 3.7, 3.8]
 
     steps:

From 963c660fcb477546e58efee08aa7aef306929e4c Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 18:11:46 +0200
Subject: [PATCH 084/140] Updated project logo

---
 artwork/prop-tool-logo.png | Bin 70267 -> 71496 bytes
 artwork/prop-tool-logo.svg | 242 ++++++++++++-------------------------
 2 files changed, 79 insertions(+), 163 deletions(-)

diff --git a/artwork/prop-tool-logo.png b/artwork/prop-tool-logo.png
index 9b2fed0014dff386356bcf68f89fa5beb7f19c39..7f00b5644bbcf4df512ab04afe604c85479bdcb7 100644
GIT binary patch
literal 71496
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

literal 70267
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

diff --git a/artwork/prop-tool-logo.svg b/artwork/prop-tool-logo.svg
index 43942919..f7fd6e69 100644
--- a/artwork/prop-tool-logo.svg
+++ b/artwork/prop-tool-logo.svg
@@ -1,15 +1,15 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <svg
-   width="1420"
+   width="1400"
    height="340"
-   viewBox="0 0 375.70836 89.958328"
+   viewBox="0 0 370.41669 89.958328"
    version="1.1"
    id="svg8"
    inkscape:version="1.1 (ce6663b3b7, 2021-05-25)"
    sodipodi:docname="prop-tool-logo.svg"
    inkscape:export-filename="/home/carlos/dev/projects/prop-tool/artwork/prop-tool-logo.png"
-   inkscape:export-xdpi="69.980003"
-   inkscape:export-ydpi="69.980003"
+   inkscape:export-xdpi="71.839996"
+   inkscape:export-ydpi="71.839996"
    xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
    xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
    xmlns="http://www.w3.org/2000/svg"
@@ -36,8 +36,8 @@
      inkscape:pageopacity="0.0"
      inkscape:pageshadow="2"
      inkscape:zoom="0.97992958"
-     inkscape:cx="903.63636"
-     inkscape:cy="1.5307222"
+     inkscape:cx="907.71829"
+     inkscape:cy="286.24506"
      inkscape:document-units="mm"
      inkscape:current-layer="layer1"
      showgrid="false"
@@ -61,17 +61,6 @@
       </cc:Work>
     </rdf:RDF>
   </metadata>
-  <text
-     xml:space="preserve"
-     style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:17.6389px;line-height:1.25;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;letter-spacing:0px;word-spacing:0px;fill:#f13360;fill-opacity:1;stroke-width:1.05249"
-     x="107.9934"
-     y="79.072037"
-     id="text5759-4"><tspan
-       sodipodi:role="line"
-       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:17.6389px;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;fill:#f13360;fill-opacity:1;stroke-width:1.05249"
-       x="107.9934"
-       y="79.072037"
-       id="tspan139593-1">*.properties file checker and syncing tool</tspan></text>
   <g
      inkscape:groupmode="layer"
      id="layer5"
@@ -198,193 +187,120 @@
              d="m -577.38907,11.15266 c 0,0 -13.19843,7.67535 9.39287,10.27259 27.36873,3.12226 41.35657,2.6745 71.51709,-3.03384 0,0 7.92949,4.97199 19.00358,9.27837 -67.61193,28.97734 -153.01911,-1.67843 -99.91354,-16.51712"
              fill="#5382a1"
              id="path31729"
-             style="stroke-width:6.95406;fill:#edffae;fill-opacity:1" />
+             style="fill:#edffae;fill-opacity:1;stroke-width:6.95406" />
           <path
              d="m -585.65089,-26.66086 c 0,0 -14.80332,10.95773 7.80474,13.29617 29.23613,3.01615 52.32454,3.26284 92.27637,-4.4302 0,0 5.52587,5.60221 14.21498,8.66584 -81.74685,23.90388 -172.79814,1.88509 -114.29609,-17.53181"
              fill="#5382a1"
              id="path31731"
-             style="stroke-width:6.95406;fill:#edffae;fill-opacity:1" />
+             style="fill:#edffae;fill-opacity:1;stroke-width:6.95406" />
           <path
              d="m -516.0012,-90.80516 c 16.65955,19.18046 -4.37714,36.44044 -4.37714,36.44044 0,0 42.30144,-21.83726 22.8743,-49.18272 -18.14435,-25.50132 -32.05865,-38.17193 43.26772,-81.85856 0,0 -118.23755,29.5303 -61.76488,94.60084"
              fill="#e76f00"
              id="path31733"
-             style="stroke-width:6.95406;fill:#edffae;fill-opacity:1" />
+             style="fill:#edffae;fill-opacity:1;stroke-width:6.95406" />
           <path
              d="m -426.57901,39.12183 c 0,0 9.7671,8.04771 -10.75665,14.27363 -39.0265,11.82254 -162.43247,15.39258 -196.71412,0.47104 -12.32338,-5.36111 10.78644,-12.80094 18.05591,-14.36207 7.58132,-1.64399 11.91377,-1.33771 11.91377,-1.33771 -13.70484,-9.65446 -88.58251,18.95703 -38.03415,27.15089 137.85274,22.35578 251.29239,-10.06685 215.53524,-26.19578"
              fill="#5382a1"
              id="path31735"
-             style="stroke-width:6.95406;fill:#edffae;fill-opacity:1" />
+             style="fill:#edffae;fill-opacity:1;stroke-width:6.95406" />
           <path
              d="m -571.04213,-65.84004 c 0,0 -62.77213,14.90944 -22.22918,20.32361 17.11849,2.2919 51.24375,1.77338 83.03057,-0.88995 25.97795,-2.19136 52.06296,-6.85056 52.06296,-6.85056 0,0 -9.16015,3.92285 -15.78729,8.448 -63.744,16.76474 -186.88559,8.96559 -151.43471,-8.18269 29.98086,-14.49239 54.35765,-12.84841 54.35765,-12.84841"
              fill="#5382a1"
              id="path31737"
-             style="stroke-width:6.95406;fill:#edffae;fill-opacity:1" />
+             style="fill:#edffae;fill-opacity:1;stroke-width:6.95406" />
           <path
              d="m -458.43658,-2.89755 c 64.79872,-33.67191 34.83834,-66.03031 13.9264,-61.67086 -5.12558,1.06682 -7.41096,1.99121 -7.41096,1.99121 0,0 1.90277,-2.98077 5.53704,-4.27101 41.37053,-14.54452 73.18714,42.89722 -13.35482,65.64771 0,9.3e-4 1.00259,-0.89554 1.30234,-1.69705"
              fill="#5382a1"
              id="path31739"
-             style="stroke-width:6.95406;fill:#edffae;fill-opacity:1" />
+             style="fill:#edffae;fill-opacity:1;stroke-width:6.95406" />
           <path
              d="m -497.50404,-255.94843 c 0,0 35.88655,35.89865 -34.03683,91.10063 -56.07145,44.28148 -12.78603,69.5296 -0.0233,98.37661 -32.7298,-29.5303 -56.74912,-55.52594 -40.63508,-79.72026 23.65161,-35.51512 89.17457,-52.73414 74.69521,-109.75698"
              fill="#e76f00"
              id="path31741"
-             style="stroke-width:6.95406;fill:#edffae;fill-opacity:1" />
+             style="fill:#edffae;fill-opacity:1;stroke-width:6.95406" />
           <path
              d="m -564.67472,88.34551 c 5.32019,0.340558 10.88412,0.606695 16.61258,0.790232 61.24338,1.962205 141.29274,-5.516648 143.36136,-32.429972 0,0 -4.34828,11.15694 -51.40387,20.01734 -53.08788,9.99051 -118.5643,8.82408 -157.39904,2.42129 9.3e-4,-9.3e-4 7.94996,6.57967 48.82898,9.20111"
              fill="#5382a1"
              id="path31743"
-             style="stroke-width:6.95406;fill:#edffae;fill-opacity:1"
+             style="fill:#edffae;fill-opacity:1;stroke-width:6.95406"
              sodipodi:nodetypes="cscccc" />
         </g>
       </g>
       <g
-         id="g62051"
-         transform="translate(5.005357,-3.1750001)">
+         id="g14775"
+         transform="translate(0,-1.9973497)">
+        <text
+           xml:space="preserve"
+           style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:17.3028px;line-height:1.25;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;letter-spacing:0px;word-spacing:0px;fill:#f13360;fill-opacity:1;stroke-width:1.05249"
+           x="104.08276"
+           y="78.811234"
+           id="text5759-4"
+           transform="translate(-2.5945052,141.63911)"><tspan
+             sodipodi:role="line"
+             style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:17.3028px;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;fill:#f13360;fill-opacity:1;stroke-width:1.05249"
+             x="104.08276"
+             y="78.811234"
+             id="tspan139593-1">*.properties file checker and syncing tool</tspan></text>
         <g
-           id="g1083-0"
-           transform="matrix(0.17983676,0,0,0.22163989,138.59531,143.56834)"
-           style="fill:#f1a233;fill-opacity:1;stroke-width:2.5317">
-          <text
-             xml:space="preserve"
-             style="font-size:243.148px;line-height:1.25;font-family:'a dripping marker';-inkscape-font-specification:'a dripping marker';letter-spacing:0px;word-spacing:0px;fill:#f13360;fill-opacity:1;stroke-width:5.27174"
-             x="-210.33551"
-             y="255.73334"
-             id="text5759"
-             transform="scale(1.1101578,0.90077285)"><tspan
-               sodipodi:role="line"
-               style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, ';fill:#f13360;fill-opacity:1;stroke-width:5.27174"
-               x="-210.33551"
-               y="255.73334"
-               id="tspan139593">prop-tool</tspan></text>
-        </g>
-        <g
-           id="g62006"
-           transform="translate(-0.42992151,0.12436352)">
-          <text
-             xml:space="preserve"
-             style="font-size:10.7669px;line-height:1.25;font-family:'a dripping marker';-inkscape-font-specification:'a dripping marker';letter-spacing:0px;word-spacing:0px;fill:#f1a233;fill-opacity:1;stroke-width:1.05249"
-             x="289.14178"
-             y="46.336967"
-             id="text5759-7-4"
-             transform="translate(-2.5945052,141.63911)"><tspan
-               sodipodi:role="line"
-               style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, ';fill:#f13360;fill-opacity:1;stroke-width:1.05249"
-               x="289.14178"
-               y="46.336967"
-               id="tspan119569-6">by Marcin Orlowski</tspan></text>
+           id="g62051"
+           transform="translate(1.8405542,-3.1750001)">
           <g
-             id="g61977"
-             transform="translate(4.4533618)">
-            <g
-               id="g1083-0-0"
-               transform="matrix(0.06409891,0,0,0.07899872,257.89685,158.57104)"
-               style="stroke-width:7.10296">
-              <text
-                 xml:space="preserve"
-                 style="font-size:151.305px;line-height:1.25;font-family:'a dripping marker';-inkscape-font-specification:'a dripping marker';letter-spacing:0px;word-spacing:0px;fill:#f1333f;fill-opacity:1;stroke-width:14.7904"
-                 x="1020.9062"
-                 y="205.07805"
-                 id="text5759-7"
-                 transform="scale(1.1101578,0.90077284)"><tspan
-                   sodipodi:role="line"
-                   style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, ';fill:#f13360;fill-opacity:1;stroke-width:14.7904"
-                   x="1020.9062"
-                   y="205.07805"
-                   id="tspan119569">dev tool</tspan></text>
-            </g>
+             id="g1083-0"
+             transform="matrix(0.17983676,0,0,0.22163989,138.59531,143.56834)"
+             style="fill:#f1a233;fill-opacity:1;stroke-width:2.5317">
             <text
                xml:space="preserve"
-               style="font-size:10.7669px;line-height:1.25;font-family:'a dripping marker';-inkscape-font-specification:'a dripping marker';letter-spacing:0px;word-spacing:0px;fill:#f1333f;fill-opacity:1;stroke-width:1.05249"
-               x="279.39169"
-               y="31.525286"
-               id="text5759-7-7"
-               transform="translate(-2.5945052,141.63911)"><tspan
+               style="font-size:256.699px;line-height:1.25;font-family:'a dripping marker';-inkscape-font-specification:'a dripping marker';letter-spacing:0px;word-spacing:0px;fill:#f13360;fill-opacity:1;stroke-width:5.27174"
+               x="-214.49933"
+               y="265.17487"
+               id="text5759"
+               transform="scale(1.092369,0.91544159)"><tspan
                  sodipodi:role="line"
-                 style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, ';fill:#f13360;fill-opacity:1;stroke-width:1.05249"
-                 x="279.39169"
-                 y="31.525286"
-                 id="tspan119569-7">the</tspan></text>
+                 style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, ';fill:#f13360;fill-opacity:1;stroke-width:5.27174"
+                 x="-214.49933"
+                 y="265.17487"
+                 id="tspan139593">prop-tool</tspan></text>
+          </g>
+          <g
+             id="g62006"
+             transform="matrix(1.0446229,0,0,1.0744828,-12.952594,-9.8873609)"
+             style="stroke-width:0.943888">
             <g
-               id="g59430"
-               transform="translate(19.699781,54.181392)">
+               id="g61977"
+               transform="translate(-38.938309,1.7962658)"
+               style="stroke-width:0.943888">
               <g
-                 id="g59406"
-                 transform="matrix(0.34959436,0,0,0.34959436,167.45947,70.49503)"
-                 style="display:inline;stroke-width:2.86048">
-                <path
-                   class="st1"
-                   d="m 400.32104,122.61229 h -0.3947 v -0.22555 h 1.04314 v 0.22555 h -0.3947 v 1.09952 h -0.28193 z m 2.11446,0.0564 v 0 l -0.3947,1.04314 h -0.16915 l -0.3947,-1.04314 v 0 1.04314 h -0.25374 v -1.32507 h 0.36651 l 0.3665,0.93037 0.36651,-0.93037 h 0.36651 v 1.32507 h -0.25374 z"
-                   id="path54939"
-                   style="opacity:1;fill:#ea2d2e;stroke-width:0.806446" />
-                <path
-                   class="st1"
-                   d="m 365.67206,134.96074 c -1.21229,1.04314 -2.50916,1.63519 -3.66507,1.63519 -1.63518,0 -2.53735,-0.98675 -2.53735,-2.56555 0,-1.71976 0.95855,-2.96025 4.76459,-2.96025 h 1.40964 v 3.89061 z m 3.35495,3.77784 v -11.70002 c 0,-2.98844 -1.71977,-4.96194 -5.80773,-4.96194 -2.39639,0 -4.51085,0.59205 -6.23061,1.35326 l 0.47928,2.08627 c 1.35325,-0.50747 3.10121,-0.95856 4.79278,-0.95856 2.36819,0 3.38314,0.95856 3.38314,2.93205 v 1.49422 h -1.15591 c -5.75134,0 -8.34508,2.22724 -8.34508,5.58218 0,2.90386 1.71977,4.53905 4.93375,4.53905 2.05808,0 3.60868,-0.84579 5.07471,-2.11446 l 0.25373,1.77614 h 2.62194 z"
-                   id="path54941"
-                   style="opacity:1;fill:#ea2d2e;stroke-width:0.806446" />
-                <path
-                   id="XMLID_4_"
-                   class="st1"
-                   d="m 380.21956,138.73858 h -4.17254 l -5.04652,-16.38003 h 3.66507 l 3.1294,10.06484 0.70482,3.01663 c 1.5788,-4.36989 2.70652,-8.82435 3.24218,-13.08147 h 3.5523 c -0.98675,5.41302 -2.67832,11.33352 -5.07471,16.38003 z"
-                   style="opacity:1;fill:#ea2d2e;stroke-width:0.806446" />
-                <path
-                   class="st1"
-                   d="m 396.26127,134.96074 c -1.21229,1.04314 -2.50916,1.63519 -3.66506,1.63519 -1.63519,0 -2.53736,-0.98675 -2.53736,-2.56555 0,-1.71976 0.95856,-2.96025 4.76459,-2.96025 h 1.40964 z m 3.35495,3.77784 v -11.70002 c 0,-2.98844 -1.71976,-4.96194 -5.83591,-4.96194 -2.39639,0 -4.51086,0.59205 -6.23062,1.35326 l 0.47928,2.08627 c 1.35325,-0.50747 3.10121,-0.95856 4.79278,-0.95856 2.3682,0 3.38314,0.95856 3.38314,2.93205 v 1.49422 h -1.1841 c -5.75134,0 -8.34508,2.22724 -8.34508,5.58218 0,2.90386 1.71977,4.53905 4.93375,4.53905 2.08627,0 3.60868,-0.84579 5.07471,-2.11446 l 0.25373,1.77614 h 2.67832 z"
-                   id="path54944"
-                   style="opacity:1;fill:#ea2d2e;stroke-width:0.806446" />
-                <path
-                   id="XMLID_2_"
-                   class="st1"
-                   d="m 352.44963,141.52967 c -0.95856,1.40964 -2.50917,2.50916 -4.20074,3.1294 l -1.66337,-1.9453 c 1.29687,-0.64844 2.39639,-1.71976 2.90386,-2.70651 0.45108,-0.87398 0.62024,-2.02988 0.62024,-4.7364 v -18.69184 h 3.5523 v 18.43811 c 0.0282,3.60868 -0.25374,5.07471 -1.21229,6.51254 z"
-                   style="opacity:1;fill:#ea2d2e;stroke-width:0.806446" />
-              </g>
+                 id="g1083-0-0"
+                 transform="matrix(0.06409891,0,0,0.07899872,257.89685,158.57104)"
+                 style="stroke-width:6.7044" />
+              <text
+                 xml:space="preserve"
+                 style="font-size:10.7669px;line-height:1.25;font-family:'a dripping marker';-inkscape-font-specification:'a dripping marker';letter-spacing:0px;word-spacing:0px;fill:#f1333f;fill-opacity:1;stroke-width:0.993433"
+                 x="319.13046"
+                 y="173.1644"
+                 id="text5759-7-7"><tspan
+                   sodipodi:role="line"
+                   style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, ';fill:#f13360;fill-opacity:1;stroke-width:0.993433"
+                   x="319.13046"
+                   y="173.1644"
+                   id="tspan119569-7">a development tool</tspan><tspan
+                   sodipodi:role="line"
+                   style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, ';fill:#f13360;fill-opacity:1;stroke-width:0.993433"
+                   x="319.13046"
+                   y="186.71045"
+                   id="tspan13760">by Marcin Orlowski</tspan></text>
               <g
-                 id="g31745-8"
-                 transform="matrix(0.04649357,0,0,0.04649356,302.21383,113.19229)"
-                 style="display:inline;stroke-width:15.4616">
+                 id="g59430"
+                 transform="translate(19.699781,54.181392)"
+                 style="stroke-width:0.943888">
                 <g
-                   id="g36065-9"
-                   transform="translate(28.160981,111.53962)"
-                   style="stroke-width:15.4616">
-                  <path
-                     d="m -577.38907,11.15266 c 0,0 -13.19843,7.67535 9.39287,10.27259 27.36873,3.12226 41.35657,2.6745 71.51709,-3.03384 0,0 7.92949,4.97199 19.00358,9.27837 -67.61193,28.97734 -153.01911,-1.67843 -99.91354,-16.51712"
-                     fill="#5382a1"
-                     id="path31729-7"
-                     style="stroke-width:26.7568" />
-                  <path
-                     d="m -585.65089,-26.66086 c 0,0 -14.80332,10.95773 7.80474,13.29617 29.23613,3.01615 52.32454,3.26284 92.27637,-4.4302 0,0 5.52587,5.60221 14.21498,8.66584 -81.74685,23.90388 -172.79814,1.88509 -114.29609,-17.53181"
-                     fill="#5382a1"
-                     id="path31731-7"
-                     style="stroke-width:26.7568" />
-                  <path
-                     d="m -516.0012,-90.80516 c 16.65955,19.18046 -4.37714,36.44044 -4.37714,36.44044 0,0 42.30144,-21.83726 22.8743,-49.18272 -18.14435,-25.50132 -32.05865,-38.17193 43.26772,-81.85856 0,0 -118.23755,29.5303 -61.76488,94.60084"
-                     fill="#e76f00"
-                     id="path31733-6"
-                     style="stroke-width:26.7568" />
-                  <path
-                     d="m -426.57901,39.12183 c 0,0 9.7671,8.04771 -10.75665,14.27363 -39.0265,11.82254 -162.43247,15.39258 -196.71412,0.47104 -12.32338,-5.36111 10.78644,-12.80094 18.05591,-14.36207 7.58132,-1.64399 11.91377,-1.33771 11.91377,-1.33771 -13.70484,-9.65446 -88.58251,18.95703 -38.03415,27.15089 137.85274,22.35578 251.29239,-10.06685 215.53524,-26.19578"
-                     fill="#5382a1"
-                     id="path31735-4"
-                     style="stroke-width:26.7568" />
-                  <path
-                     d="m -571.04213,-65.84004 c 0,0 -62.77213,14.90944 -22.22918,20.32361 17.11849,2.2919 51.24375,1.77338 83.03057,-0.88995 25.97795,-2.19136 52.06296,-6.85056 52.06296,-6.85056 0,0 -9.16015,3.92285 -15.78729,8.448 -63.744,16.76474 -186.88559,8.96559 -151.43471,-8.18269 29.98086,-14.49239 54.35765,-12.84841 54.35765,-12.84841"
-                     fill="#5382a1"
-                     id="path31737-3"
-                     style="stroke-width:26.7568" />
-                  <path
-                     d="m -458.43658,-2.89755 c 64.79872,-33.67191 34.83834,-66.03031 13.9264,-61.67086 -5.12558,1.06682 -7.41096,1.99121 -7.41096,1.99121 0,0 1.90277,-2.98077 5.53704,-4.27101 41.37053,-14.54452 73.18714,42.89722 -13.35482,65.64771 0,9.3e-4 1.00259,-0.89554 1.30234,-1.69705"
-                     fill="#5382a1"
-                     id="path31739-0"
-                     style="stroke-width:26.7568" />
-                  <path
-                     d="m -497.50404,-255.94843 c 0,0 35.88655,35.89865 -34.03683,91.10063 -56.07145,44.28148 -12.78603,69.5296 -0.0233,98.37661 -32.7298,-29.5303 -56.74912,-55.52594 -40.63508,-79.72026 23.65161,-35.51512 89.17457,-52.73414 74.69521,-109.75698"
-                     fill="#e76f00"
-                     id="path31741-3"
-                     style="stroke-width:26.7568" />
-                  <path
-                     d="m -564.67472,88.34551 c 62.1987,3.98149 157.71183,-2.20905 159.97394,-31.63974 0,0 -4.34828,11.15694 -51.40387,20.01734 -53.08788,9.99051 -118.5643,8.82408 -157.39904,2.42129 9.3e-4,-9.3e-4 7.94996,6.57967 48.82898,9.20111"
-                     fill="#5382a1"
-                     id="path31743-0"
-                     style="stroke-width:26.7568" />
+                   id="g31745-8"
+                   transform="matrix(0.04649357,0,0,0.04649356,302.21383,113.19229)"
+                   style="display:inline;stroke-width:14.594">
+                  <g
+                     id="g36065-9"
+                     transform="translate(28.160981,111.53962)"
+                     style="stroke-width:14.594" />
                 </g>
               </g>
             </g>

From f98bd83d1ca4fb47128a6645757d11e9de3b7f9b Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 18:15:58 +0200
Subject: [PATCH 085/140] Updated project logo

---
 artwork/prop-tool-logo.png | Bin 71496 -> 61717 bytes
 artwork/prop-tool-logo.svg | 172 ++++++++++++++++++++++---------------
 2 files changed, 102 insertions(+), 70 deletions(-)

diff --git a/artwork/prop-tool-logo.png b/artwork/prop-tool-logo.png
index 7f00b5644bbcf4df512ab04afe604c85479bdcb7..49f1a5abc0ad4f5ac218125ff34243eeac92e3dd 100644
GIT binary patch
literal 61717
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

literal 71496
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

diff --git a/artwork/prop-tool-logo.svg b/artwork/prop-tool-logo.svg
index f7fd6e69..1cc0108b 100644
--- a/artwork/prop-tool-logo.svg
+++ b/artwork/prop-tool-logo.svg
@@ -36,10 +36,10 @@
      inkscape:pageopacity="0.0"
      inkscape:pageshadow="2"
      inkscape:zoom="0.97992958"
-     inkscape:cx="907.71829"
-     inkscape:cy="286.24506"
+     inkscape:cx="824.0388"
+     inkscape:cy="-54.59576"
      inkscape:document-units="mm"
-     inkscape:current-layer="layer1"
+     inkscape:current-layer="layer2"
      showgrid="false"
      width="5600mm"
      showguides="true"
@@ -64,7 +64,8 @@
   <g
      inkscape:groupmode="layer"
      id="layer5"
-     inkscape:label="icon">
+     inkscape:label="icon"
+     style="display:inline">
     <g
        inkscape:groupmode="layer"
        id="layer4"
@@ -173,7 +174,7 @@
        inkscape:groupmode="layer"
        id="layer3"
        inkscape:label="java"
-       style="display:inline"
+       style="display:none"
        transform="translate(2.5945052,-141.63911)">
       <g
          id="g31745"
@@ -226,87 +227,118 @@
              sodipodi:nodetypes="cscccc" />
         </g>
       </g>
+    </g>
+  </g>
+  <g
+     inkscape:groupmode="layer"
+     id="layer2"
+     inkscape:label="text"
+     style="display:inline">
+    <g
+       id="g14775"
+       transform="translate(2.5945045,-143.63646)"
+       style="display:inline">
       <g
-         id="g14775"
-         transform="translate(0,-1.9973497)">
-        <text
-           xml:space="preserve"
-           style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:17.3028px;line-height:1.25;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;letter-spacing:0px;word-spacing:0px;fill:#f13360;fill-opacity:1;stroke-width:1.05249"
-           x="104.08276"
-           y="78.811234"
-           id="text5759-4"
-           transform="translate(-2.5945052,141.63911)"><tspan
-             sodipodi:role="line"
-             style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:17.3028px;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;fill:#f13360;fill-opacity:1;stroke-width:1.05249"
-             x="104.08276"
-             y="78.811234"
-             id="tspan139593-1">*.properties file checker and syncing tool</tspan></text>
+         id="g62051"
+         transform="translate(1.8405542,-3.1750001)">
         <g
-           id="g62051"
-           transform="translate(1.8405542,-3.1750001)">
-          <g
-             id="g1083-0"
-             transform="matrix(0.17983676,0,0,0.22163989,138.59531,143.56834)"
-             style="fill:#f1a233;fill-opacity:1;stroke-width:2.5317">
-            <text
-               xml:space="preserve"
-               style="font-size:256.699px;line-height:1.25;font-family:'a dripping marker';-inkscape-font-specification:'a dripping marker';letter-spacing:0px;word-spacing:0px;fill:#f13360;fill-opacity:1;stroke-width:5.27174"
+           id="g1083-0"
+           transform="matrix(0.17983676,0,0,0.22163989,138.59531,143.56834)"
+           style="fill:#f1a233;fill-opacity:1;stroke-width:2.5317">
+          <text
+             xml:space="preserve"
+             style="font-size:256.699px;line-height:1.25;font-family:'a dripping marker';-inkscape-font-specification:'a dripping marker';letter-spacing:0px;word-spacing:0px;fill:#f13360;fill-opacity:1;stroke-width:5.27174"
+             x="-214.49933"
+             y="265.17487"
+             id="text5759"
+             transform="scale(1.092369,0.91544159)"><tspan
+               sodipodi:role="line"
+               style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, ';fill:#f13360;fill-opacity:1;stroke-width:5.27174"
                x="-214.49933"
                y="265.17487"
-               id="text5759"
-               transform="scale(1.092369,0.91544159)"><tspan
-                 sodipodi:role="line"
-                 style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, ';fill:#f13360;fill-opacity:1;stroke-width:5.27174"
-                 x="-214.49933"
-                 y="265.17487"
-                 id="tspan139593">prop-tool</tspan></text>
-          </g>
+               id="tspan139593">prop-tool</tspan></text>
+        </g>
+        <g
+           id="g62006"
+           transform="matrix(1.0446229,0,0,1.0744828,-12.952594,-9.8873609)"
+           style="stroke-width:0.943888">
           <g
-             id="g62006"
-             transform="matrix(1.0446229,0,0,1.0744828,-12.952594,-9.8873609)"
+             id="g61977"
+             transform="translate(-38.938309,1.7962658)"
              style="stroke-width:0.943888">
             <g
-               id="g61977"
-               transform="translate(-38.938309,1.7962658)"
-               style="stroke-width:0.943888">
-              <g
-                 id="g1083-0-0"
-                 transform="matrix(0.06409891,0,0,0.07899872,257.89685,158.57104)"
-                 style="stroke-width:6.7044" />
-              <text
-                 xml:space="preserve"
-                 style="font-size:10.7669px;line-height:1.25;font-family:'a dripping marker';-inkscape-font-specification:'a dripping marker';letter-spacing:0px;word-spacing:0px;fill:#f1333f;fill-opacity:1;stroke-width:0.993433"
+               id="g1083-0-0"
+               transform="matrix(0.06409891,0,0,0.07899872,257.89685,158.57104)"
+               style="stroke-width:6.7044" />
+            <text
+               xml:space="preserve"
+               style="font-size:10.7669px;line-height:1.25;font-family:'a dripping marker';-inkscape-font-specification:'a dripping marker';letter-spacing:0px;word-spacing:0px;fill:#f1333f;fill-opacity:1;stroke-width:0.993433"
+               x="319.13046"
+               y="173.1644"
+               id="text5759-7-7"><tspan
+                 sodipodi:role="line"
+                 style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, ';fill:#f13360;fill-opacity:1;stroke-width:0.993433"
                  x="319.13046"
                  y="173.1644"
-                 id="text5759-7-7"><tspan
-                   sodipodi:role="line"
-                   style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, ';fill:#f13360;fill-opacity:1;stroke-width:0.993433"
-                   x="319.13046"
-                   y="173.1644"
-                   id="tspan119569-7">a development tool</tspan><tspan
-                   sodipodi:role="line"
-                   style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, ';fill:#f13360;fill-opacity:1;stroke-width:0.993433"
-                   x="319.13046"
-                   y="186.71045"
-                   id="tspan13760">by Marcin Orlowski</tspan></text>
+                 id="tspan119569-7">a development tool</tspan><tspan
+                 sodipodi:role="line"
+                 style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, ';fill:#f13360;fill-opacity:1;stroke-width:0.993433"
+                 x="319.13046"
+                 y="186.71045"
+                 id="tspan13760">by Marcin Orlowski</tspan></text>
+            <g
+               id="g59430"
+               transform="translate(19.699781,54.181392)"
+               style="stroke-width:0.943888">
               <g
-                 id="g59430"
-                 transform="translate(19.699781,54.181392)"
-                 style="stroke-width:0.943888">
+                 id="g31745-8"
+                 transform="matrix(0.04649357,0,0,0.04649356,302.21383,113.19229)"
+                 style="display:inline;stroke-width:14.594">
                 <g
-                   id="g31745-8"
-                   transform="matrix(0.04649357,0,0,0.04649356,302.21383,113.19229)"
-                   style="display:inline;stroke-width:14.594">
-                  <g
-                     id="g36065-9"
-                     transform="translate(28.160981,111.53962)"
-                     style="stroke-width:14.594" />
-                </g>
+                   id="g36065-9"
+                   transform="translate(28.160981,111.53962)"
+                   style="stroke-width:14.594" />
               </g>
             </g>
           </g>
         </g>
       </g>
+      <text
+         xml:space="preserve"
+         style="font-size:30.8951px;line-height:1.25;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, Normal';letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
+         x="112.17001"
+         y="258.76547"
+         id="text4368"><tspan
+           sodipodi:role="line"
+           id="tspan4366"
+           style="stroke-width:0.264583"
+           x="112.17001"
+           y="258.76547" /></text>
+      <g
+         id="g14564">
+        <text
+           xml:space="preserve"
+           style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:17.3028px;line-height:1.25;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;letter-spacing:0px;word-spacing:0px;fill:#f13360;fill-opacity:1;stroke-width:1.05249"
+           x="108.36742"
+           y="220.45035"
+           id="text5759-4"><tspan
+             sodipodi:role="line"
+             style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:17.3028px;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;fill:#f13360;fill-opacity:1;stroke-width:1.05249"
+             x="108.36742"
+             y="220.45035"
+             id="tspan139593-1">.properties file checker and syncing tool</tspan></text>
+        <text
+           xml:space="preserve"
+           style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:17.3028px;line-height:1.25;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;letter-spacing:0px;word-spacing:0px;display:inline;fill:#f13360;fill-opacity:1;stroke-width:1.05249"
+           x="101.69014"
+           y="223.61536"
+           id="text5759-4-5"><tspan
+             sodipodi:role="line"
+             style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:17.3028px;font-family:'Ubuntu Condensed';-inkscape-font-specification:'Ubuntu Condensed, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;fill:#f13360;fill-opacity:1;stroke-width:1.05249"
+             x="101.69014"
+             y="223.61536"
+             id="tspan139593-1-9">*</tspan></text>
+      </g>
     </g>
   </g>
   <style

From a77548fe315d4e43c52e2611f15289b5bfa3049f Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Wed, 28 Jul 2021 18:39:15 +0200
Subject: [PATCH 086/140] Wrapped access to PropFile items with @property

---
 proptool/prop/file.py | 54 ++++++++++++++++++++++++-------------------
 1 file changed, 30 insertions(+), 24 deletions(-)

diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index cdb12dd0..6bcc3471 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -57,16 +57,22 @@ def __init__(self, config: Config, file: Union[Path, None] = None, language: Lis
             self.loaded = self.load(file)
         else:
             self.loaded: bool = False
-            self.items: List[PropItem] = []
+            self._items: List[PropItem] = []
             self.report: Report = Report(config)
 
     def init_container(self) -> None:
         self.loaded: bool = False
-        self.items: List[PropItem] = []
+        self._items: List[PropItem] = []
         self.report: Report = Report(self.config)
 
     # #################################################################################################
 
+    @property
+    def items(self) -> List[PropItem]:
+        return self._items
+
+    # #################################################################################################
+
     def find_by_key(self, key: str) -> Union[Translation, None]:
         """
         Returns translation entry referenced by given key or None.
@@ -95,7 +101,7 @@ def append(self, item: PropItem):
             if match:
                 self.commented_out_keys.append(match.group(1))
 
-        self.items.append(item)
+        self._items.append(item)
 
     # #################################################################################################
 
@@ -105,6 +111,27 @@ def validate_and_fix(self, reference: 'PropFile') -> None:
 
     # #################################################################################################
 
+    def fix(self, reference: 'PropFile') -> None:
+        synced: List[str] = []
+
+        comment_pattern = self.config.comment_template.replace('COM', self.config.comment_marker).replace('SEP', self.separator)
+        for item in reference.items:
+            if isinstance(item, Translation):
+                if item.key in self.keys:
+                    synced.append(self.find_by_key(item.key).to_string() + '\n')
+                else:
+                    synced.append(comment_pattern.replace('KEY', item.key) + '\n')
+            elif isinstance(item, (Blank, Comment)):
+                synced.append(item.to_string() + '\n')
+            else:
+                raise RuntimeError(f'Unknown entry type: {type(item)}')
+
+        Log.i(f'Re-writing translation file: {self.file}')
+        with open(self.file, 'w') as fh:
+            fh.writelines(synced)
+
+    # #################################################################################################
+
     def is_valid(self, reference_file: 'PropFile') -> bool:
         """
         Validates given PropFile against provided reference file.
@@ -143,27 +170,6 @@ def is_valid(self, reference_file: 'PropFile') -> bool:
 
     # #################################################################################################
 
-    def fix(self, reference: 'PropFile') -> None:
-        synced: List[str] = []
-
-        comment_pattern = self.config.comment_template.replace('COM', self.config.comment_marker).replace('SEP', self.separator)
-        for item in reference.items:
-            if isinstance(item, Translation):
-                if item.key in self.keys:
-                    synced.append(self.find_by_key(item.key).to_string() + '\n')
-                else:
-                    synced.append(comment_pattern.replace('KEY', item.key) + '\n')
-            elif isinstance(item, (Blank, Comment)):
-                synced.append(item.to_string() + '\n')
-            else:
-                raise RuntimeError(f'Unknown entry type: {type(item)}')
-
-        Log.i(f'Re-writing translation file: {self.file}')
-        with open(self.file, 'w') as fh:
-            fh.writelines(synced)
-
-    # #################################################################################################
-
     def load(self, file: Path) -> bool:
         """
         Loads and parses *.properties file.

From 246aa17305e2af569835373e6426f13263174ebb Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Thu, 29 Jul 2021 10:47:59 +0200
Subject: [PATCH 087/140] Updated tests

---
 .flake8                             |   1 +
 proptool/config/config_builder.py   |  23 +++--
 proptool/config/config_reader.py    |  12 ++-
 proptool/log.py                     |  14 +--
 proptool/main.py                    |   6 +-
 proptool/prop/file.py               |  47 +++++----
 proptool/utils.py                   |   9 +-
 tests/config/test_config_builder.py | 149 +++++++++++++++++++---------
 tests/prop/test_file.py             |  72 +++++++-------
 tests/test_utils.py                 |  29 +-----
 10 files changed, 195 insertions(+), 167 deletions(-)

diff --git a/.flake8 b/.flake8
index f8002ae4..9836b95d 100644
--- a/.flake8
+++ b/.flake8
@@ -52,6 +52,7 @@ ignore =
     WPS220, # WPS220 Found too deep nesting: 28 > 20
     WPS221, # WPS221 Found line with high Jones Complexity: 17 > 14
     WPS226, # WPS226 Found string constant over-use: " > 3
+    WPS229, # WPS229 Found too long ``try`` body length: 2 > 1
     WPS231, # WPS231 Found function with too much cognitive complexity: 83 > 12
     WPS232, # WPS232 Found module cognitive complexity that is too high: 27.7 > 8
     WPS237, # WPS237 Found a too complex `f` string
diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 8ee17b15..40314242 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -59,16 +59,21 @@ def build():
 
         return config
 
+    @staticmethod
+    def _abort(msg: str) -> None:
+        Log.e(msg)
+        Utils.abort()
+
     @staticmethod
     def _validate_config(config: Config) -> None:
         if not config.files:
-            Log.abort('No base file(s) specified.')
+            ConfigBuilder._abort('No base file(s) specified.')
         if not config.languages:
-            Log.abort('No language(s) specified.')
+            ConfigBuilder._abort('No language(s) specified.')
         if config.separator not in Config.ALLOWED_SEPARATORS:
-            Log.abort('Invalid separator character.')
+            ConfigBuilder._abort('Invalid separator character.')
         if config.comment_marker not in Config.ALLOWED_COMMENT_MARKERS:
-            Log.abort('Invalid comment marker.')
+            ConfigBuilder._abort('Invalid comment marker.')
 
     @staticmethod
     def _set_on_off_option(config: Config, args, option_name: str) -> None:
@@ -196,22 +201,22 @@ def _validate_args(args):
         # Check use of mutually exclusive pairs
         for option_name in ConfigBuilder._on_off_pairs:
             if args.__getattribute__(option_name) and args.__getattribute__(f'no_{option_name}'):
-                Log.abort(f'You cannot use "--{option_name}" and "--no-{option_name}" at the same time.')
+                ConfigBuilder._abort(f'You cannot use "--{option_name}" and "--no-{option_name}" at the same time.')
 
         # --quiet vs --verbose
         if args.__getattribute__('quiet') and args.__getattribute__('verbose'):
-            Log.abort('You cannot enable "quiet" and "verbose" options both at the same time.')
+            ConfigBuilder._abort('You cannot enable "quiet" and "verbose" options both at the same time.')
 
         # Separator character.
         if args.separator and args.separator not in Config.ALLOWED_SEPARATORS:
-            Log.abort(f'Invalid separator. Must be one of the following: {", ".join(Config.ALLOWED_SEPARATORS)}')
+            ConfigBuilder._abort(f'Invalid separator. Must be one of the following: {", ".join(Config.ALLOWED_SEPARATORS)}')
 
         # Comment marker character.
         if args.comment_marker and args.comment_marker not in Config.ALLOWED_COMMENT_MARKERS:
-            Log.abort(f'Invalid comment marker. Must be one of the following: {", ".join(Config.ALLOWED_COMMENT_MARKERS)}')
+            ConfigBuilder._abort(f'Invalid comment marker. Must be one of: {", ".join(Config.ALLOWED_COMMENT_MARKERS)}')
 
         # Comment template.
         if args.comment_template:
             for placeholder in Config.COMMENT_TEMPLATE_LITERALS:
                 if args.comment_template.find(placeholder) == -1:
-                    Log.abort(f'Missing literal in comment template: "{placeholder}".')
+                    ConfigBuilder._abort(f'Missing literal in comment template: "{placeholder}".')
diff --git a/proptool/config/config_reader.py b/proptool/config/config_reader.py
index efe12597..0cee6233 100644
--- a/proptool/config/config_reader.py
+++ b/proptool/config/config_reader.py
@@ -22,6 +22,10 @@ def __init__(self):
         # Prevent keys CaSe from being altered by default implementation.
         self.parser.optionxform = str
 
+    def abort(self, msg: str):
+        Log.e(msg)
+        Utils.abort()
+
     def read(self, config: Config, config_file_name: Path) -> Config:
         """
         Reads and **MERGES** configuration parameters read from given configuration INI file.
@@ -32,24 +36,24 @@ def read(self, config: Config, config_file_name: Path) -> Config:
         :return: Instance of Config with fields containing
         """
         if not config_file_name.exists():
-            Log.abort(f'Config file not found {config_file_name}')
+            self.abort(f'Config file not found: {config_file_name}')
 
         # noinspection PyBroadException
         try:
             self.parser.read(config_file_name)
         except Exception:
             # noinspection PyUnresolvedReferences
-            Log.abort(f'Failed parsing config INI file: {config_file_name}')
+            self.abort(f'Failed parsing config INI file: {config_file_name}')
 
         # Presence of "prop-tool" section is mandatory.
         main_section = 'prop-tool'
         if not self.parser.has_section(main_section):
-            Log.abort(f'Missing "{main_section}" section.')
+            self.abort(f'Missing "{main_section}" section.')
 
         # Ensure we know how to read this config file.
         config_version = self.parser.getint(main_section, 'version')
         if config_version < Config.VERSION:
-            Log.abort(f'Old version ({config_version}) of config INI file. Required {Config.VERSION}')
+            self.abort(f'Old version ({config_version}) of config INI file. Required {Config.VERSION}')
 
         bools = [
             'debug',
diff --git a/proptool/log.py b/proptool/log.py
index e887348c..acc1896e 100644
--- a/proptool/log.py
+++ b/proptool/log.py
@@ -177,7 +177,8 @@ def pop(messages = None, color: Union[str, None] = None, ignore_quiet = False) -
         had_anything_deferred = Log._flush_deferred_entry()
 
         if Log.log_level == 0:
-            Log.abort('pop() called too many times.')
+            Log.e('pop() called too many times.')
+            sys.exit(Log.ABORT_RC)
         Log.log_level -= 1
 
         return had_anything_deferred
@@ -248,17 +249,6 @@ def d(messages = None, condition: bool = True) -> None:
 
     # #################################################################################################
 
-    @staticmethod
-    def abort(messages = None) -> None:
-        Log.e(messages)
-        Log.init('Aborted', Log.COLOR_ERROR, ignore_quiet = True)
-
-        if not Log.debug:
-            sys.exit(Log.ABORT_RC)
-
-        Log.d('Related stacktrace below')
-        raise RuntimeError('*** NOT A CRASH! *** Exception raised because of --debug used to obtain stacktrace. Enjoy.')
-
     @staticmethod
     def _get_stacktrace_string() -> str:
         msg = ''
diff --git a/proptool/main.py b/proptool/main.py
index 77c910c3..2c876e10 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -45,14 +45,16 @@ def start() -> int:
 
             tmp = Path(reference_path).name.split('.')
             if len(tmp) != 2:
-                Utils.abort('Base filename format invalid. Must be "prefix.suffix".')
+                Log.e('Base filename format invalid. Must be "prefix.suffix".')
+                Utils.abort()
             name_prefix = tmp[0]
             name_suffix = tmp[1]
 
             Log.push(f'Base: {reference_path}')
             reference_propfile = PropFile(config, reference_path)
             if not reference_propfile.loaded:
-                Utils.abort(f'File not found: {reference_path}')
+                Log.e(f'File not found: {reference_path}')
+                Utils.abort()
 
             check_modules = [
                 TrailingWhiteChars,
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 6bcc3471..78666e7f 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -29,22 +29,33 @@
 from proptool.prop.items import Blank, Comment, PropItem, Translation
 from proptool.report.group import ReportGroup
 from proptool.report.report import Report
+from proptool.utils import Utils
 
 
 # #################################################################################################
 
 class PropFile(object):
-    def __init__(self, config: Config, file: Union[Path, None] = None, language: List[str] = None):
+    # def __init__(self, config: Config, language: List[str] = None):
+    def __init__(self, config: Config):
         super().__init__()
 
         self.config: Config = config
 
-        self.file: Path = file
+        self._items: List[PropItem] = []
+
+        self.file: Union[Path, None] = None
+        self.loaded: bool = False
+
         # All the keys of 'regular' translations
         self.keys: List[str] = []
         # All the keys in form `# ==> KEY =` that we found.
         self.commented_out_keys: List[str] = []
+
         self.separator: str = config.separator
+        self.report: Report = Report(config)
+
+        # This call is most likely redundant here.
+        self.init_container()
 
         comment_pattern = re.escape(self.config.comment_template).replace(
             'COM', f'[{"".join(Config.ALLOWED_COMMENT_MARKERS)}]').replace(
@@ -53,17 +64,12 @@ def __init__(self, config: Config, file: Union[Path, None] = None, language: Lis
         comment_pattern = comment_pattern.replace('KEY', '([a-zAz][a-zA-z0-9_.-]+)')
         self.comment_pattern = f'^{comment_pattern}'
 
-        if file is not None:
-            self.loaded = self.load(file)
-        else:
-            self.loaded: bool = False
-            self._items: List[PropItem] = []
-            self.report: Report = Report(config)
-
     def init_container(self) -> None:
-        self.loaded: bool = False
-        self._items: List[PropItem] = []
-        self.report: Report = Report(self.config)
+        self._items = []
+        self.keys = []
+        self.commented_out_keys = []
+        self.loaded = False
+        self.report = Report(self.config)
 
     # #################################################################################################
 
@@ -139,15 +145,6 @@ def is_valid(self, reference_file: 'PropFile') -> bool:
         :param reference_file:
         :return: True if file is valid, False if there were errors.
         """
-        if not self.loaded:
-            rg = ReportGroup('Filesystem')
-            if self.file is None:
-                rg.error(None, 'No properties file set.')
-            else:
-                rg.error(None, f'File not found: {self.file}')
-            self.report.add(rg)
-            return False
-
         checks = [
             MissingTranslation,
             DanglingKeys,
@@ -177,10 +174,11 @@ def load(self, file: Path) -> bool:
         :param file: File to load.
         :return: True if file loaded correctly, False otherwise.
         """
-        self.init_container()
 
         if not file.exists():
-            return False
+            raise FileNotFoundError(f'File not found: {file}')
+
+        self.init_container()
 
         with open(file, 'r') as fh:
             line_number: int = 0
@@ -211,7 +209,8 @@ def load(self, file: Path) -> bool:
                 # Whatever left should be valid key[:=]val entry
                 tmp: List[str] = re.split(f'^(.+)([{"".join(Config.ALLOWED_SEPARATORS)}])(.+)$', line)
                 if len(tmp) != 5:
-                    Log.abort(f'Invalid syntax at line {line_number} of "{file}".')
+                    Log.e(f'Invalid syntax at line {line_number} of "{file}".')
+                    Utils.abort()
 
                 key = tmp[1].strip()
                 separator = tmp[2].strip()
diff --git a/proptool/utils.py b/proptool/utils.py
index deca069c..4687164a 100644
--- a/proptool/utils.py
+++ b/proptool/utils.py
@@ -17,12 +17,11 @@
 # #################################################################################################
 
 class Utils(object):
+
+    ABORT_RETURN_CODE = 10
+
     @staticmethod
-    def abort(msgs: Union[str, List[str]] = 'Aborted', rc: int = 10) -> None:
-        if isinstance(msgs, str):
-            msgs = [msgs]
-        for single_msg in msgs:
-            print(single_msg)
+    def abort(rc: int = ABORT_RETURN_CODE) -> None:
         exit(rc)
 
     @staticmethod
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index 82885b94..9edac03d 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -11,10 +11,11 @@
 import random
 from pathlib import Path
 from typing import List, Union
-from unittest.mock import call, patch
+from unittest.mock import Mock, call, patch
 
 from proptool.config.config import Config
 from proptool.config.config_builder import ConfigBuilder
+from proptool.utils import Utils
 from tests.test_case import TestCase
 
 
@@ -60,8 +61,8 @@ def test_validate(self) -> None:
         """
         ConfigBuilder._validate_config(self.get_config_for_validate())
 
-    @patch('proptool.log.Log.abort')
-    def test_validate_no_files(self, mock_log_abort) -> None:
+    @patch('proptool.log.Log.e')
+    def test_validate_no_files(self, log_e_mock: Mock) -> None:
         """
         Ensures empty list of files triggers expected error message and quits.
 
@@ -69,12 +70,17 @@ def test_validate_no_files(self, mock_log_abort) -> None:
         """
         config = self.get_config_for_validate()
         config.files = []
-        ConfigBuilder._validate_config(config)
-        exp_calls = [call('No base file(s) specified.')]
-        mock_log_abort.assert_has_calls(exp_calls)
+        with self.assertRaises(SystemExit) as context_manager:
+            ConfigBuilder._validate_config(config)
+            exp_calls = [call('No base file(s) specified.')]
+            log_e_mock.assert_has_calls(exp_calls)
 
-    @patch('proptool.log.Log.abort')
-    def test_validate_no_languages(self, mock_log_abort) -> None:
+            # Check we got sys.exit called with non-zero return code
+            self.assertEqual(SystemExit, type(context_manager.exception))
+            self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
+
+    @patch('proptool.log.Log.e')
+    def test_validate_no_languages(self, log_e_mock: Mock) -> None:
         """
         Ensures empty language list triggers expected error message and quits.
 
@@ -82,12 +88,17 @@ def test_validate_no_languages(self, mock_log_abort) -> None:
         """
         config = self.get_config_for_validate()
         config.languages = []
-        ConfigBuilder._validate_config(config)
-        exp_calls = [call('No language(s) specified.')]
-        mock_log_abort.assert_has_calls(exp_calls)
+        with self.assertRaises(SystemExit) as context_manager:
+            ConfigBuilder._validate_config(config)
+            exp_calls = [call('No language(s) specified.')]
+            log_e_mock.assert_has_calls(exp_calls)
+
+            # Check we got sys.exit called with non-zero return code
+            self.assertEqual(SystemExit, type(context_manager.exception))
+            self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
 
-    @patch('proptool.log.Log.abort')
-    def test_validate_invalid_separator(self, mock_log_abort) -> None:
+    @patch('proptool.log.Log.e')
+    def test_validate_invalid_separator(self, log_e_mock: Mock) -> None:
         """
         Ensures invalid separator char triggers expected error message and quits.
 
@@ -95,12 +106,17 @@ def test_validate_invalid_separator(self, mock_log_abort) -> None:
         """
         config = self.get_config_for_validate()
         config.separator = 'invalid'
-        ConfigBuilder._validate_config(config)
-        exp_calls = [call('Invalid separator character.')]
-        mock_log_abort.assert_has_calls(exp_calls)
+        with self.assertRaises(SystemExit) as context_manager:
+            ConfigBuilder._validate_config(config)
+            exp_calls = [call('Invalid separator character.')]
+            log_e_mock.assert_has_calls(exp_calls)
+
+            # Check we got sys.exit called with non-zero return code
+            self.assertEqual(SystemExit, type(context_manager.exception))
+            self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
 
-    @patch('proptool.log.Log.abort')
-    def test_validate_invalid_comment_marker(self, mock_log_abort) -> None:
+    @patch('proptool.log.Log.e')
+    def test_validate_invalid_comment_marker(self, log_e_mock: Mock) -> None:
         """
         Ensures invalid comment marker triggers expected error message and quits.
 
@@ -108,9 +124,14 @@ def test_validate_invalid_comment_marker(self, mock_log_abort) -> None:
         """
         config = self.get_config_for_validate()
         config.comment_marker = ''
-        ConfigBuilder._validate_config(config)
-        exp_prints = [call('Invalid comment marker.')]
-        mock_log_abort.assert_has_calls(exp_prints)
+        with self.assertRaises(SystemExit) as context_manager:
+            ConfigBuilder._validate_config(config)
+            exp_prints = [call('Invalid comment marker.')]
+            log_e_mock.assert_has_calls(exp_prints)
+
+            # Check we got sys.exit called with non-zero return code
+            self.assertEqual(SystemExit, type(context_manager.exception))
+            self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
 
     # #################################################################################################
 
@@ -249,19 +270,25 @@ def test_validate_args_onoff_valid_setups(self) -> None:
             # We expect no problems.
             ConfigBuilder._validate_args(args)
 
-    @patch('proptool.log.Log.abort')
-    def test_validate_args_onoff_on_on(self, mock_log_abort) -> None:
+    @patch('proptool.log.Log.e')
+    def test_validate_args_onoff_on_on(self, log_e_mock: Mock) -> None:
         for option_name in ConfigBuilder._on_off_pairs:
             args = FakeArgs()
             args.__setattr__(option_name, True)
             args.__setattr__(f'no_{option_name}', True)
-            # Problems should be reported.
-            ConfigBuilder._validate_args(args)
-            exp_calls = [call(f'You cannot use "--{option_name}" and "--no-{option_name}" at the same time.')]
-            mock_log_abort.assert_has_calls(exp_calls)
 
-    @patch('proptool.log.Log.abort')
-    def test_validate_args_quiet_and_verbose(self, mock_log_abort) -> None:
+            with self.assertRaises(SystemExit) as context_manager:
+                ConfigBuilder._validate_args(args)
+                # Problems should be reported.
+                exp_calls = [call(f'You cannot use "--{option_name}" and "--no-{option_name}" at the same time.')]
+                log_e_mock.assert_has_calls(exp_calls)
+
+                # Check we got sys.exit called with non-zero return code
+                self.assertEqual(SystemExit, type(context_manager.exception))
+                self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
+
+    @patch('proptool.log.Log.e')
+    def test_validate_args_quiet_and_verbose(self, log_e_mock: Mock) -> None:
         """
         Ensures use of mutually exclusive --quiet and --verbose is handled correctly.
 
@@ -271,40 +298,68 @@ def test_validate_args_quiet_and_verbose(self, mock_log_abort) -> None:
 
         args.quiet = True
         args.verbose = True
-        ConfigBuilder._validate_args(args)
-        exp_calls = [call('You cannot enable "quiet" and "verbose" options both at the same time.')]
-        mock_log_abort.assert_has_calls(exp_calls)
+        with self.assertRaises(SystemExit) as context_manager:
+            ConfigBuilder._validate_args(args)
+            exp_calls = [call('You cannot enable "quiet" and "verbose" options both at the same time.')]
+            log_e_mock.assert_has_calls(exp_calls)
+
+            # Check we got sys.exit called with non-zero return code
+            self.assertEqual(SystemExit, type(context_manager.exception))
+            self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
+
+    @patch('proptool.log.Log.e')
+    def test_validate_args_invalid_separator(self, log_e_mock: Mock) -> None:
+        """
+        Checks if attempt to use invalid character as separator is correctly handled.
 
-    @patch('proptool.log.Log.abort')
-    def test_validate_args_invalid_separator(self, mock_log_abort) -> None:
+        :param mock_log_abort:
+        """
         args = FakeArgs()
 
         separator = self.get_random_string(length = 1)
         self.assertNotIn(separator, Config.ALLOWED_SEPARATORS)
         args.separator = separator
-        ConfigBuilder._validate_args(args)
-        exp_calls = [call(f'Invalid separator. Must be one of the following: {", ".join(Config.ALLOWED_SEPARATORS)}')]
-        mock_log_abort.assert_has_calls(exp_calls)
 
-    @patch('proptool.log.Log.abort')
-    def test_validate_args_invalid_comment_marker(self, mock_log_abort) -> None:
+        with self.assertRaises(SystemExit) as context_manager:
+            ConfigBuilder._validate_args(args)
+            exp_calls = [call(f'Invalid separator. Must be one of the following: {", ".join(Config.ALLOWED_SEPARATORS)}')]
+            log_e_mock.assert_has_calls(exp_calls)
+
+            # Check we got sys.exit called with non-zero return code
+            self.assertEqual(SystemExit, type(context_manager.exception))
+            self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
+
+    @patch('proptool.log.Log.e')
+    def test_validate_args_invalid_comment_marker(self, log_e_mock: Mock) -> None:
         args = FakeArgs()
 
         marker = self.get_random_string(length = 1)
         self.assertNotIn(marker, Config.ALLOWED_COMMENT_MARKERS)
         args.comment_marker = marker
-        ConfigBuilder._validate_args(args)
-        exp_calls = [call(f'Invalid comment marker. Must be one of the following: {", ".join(Config.ALLOWED_COMMENT_MARKERS)}')]
-        mock_log_abort.assert_has_calls(exp_calls)
 
-    @patch('proptool.log.Log.abort')
-    def test_validate_args_missing_literal(self, mock_log_abort) -> None:
+        with self.assertRaises(SystemExit) as context_manager:
+            ConfigBuilder._validate_args(args)
+            exp_calls = [call(f'Invalid comment marker. Must be one of the following: {", ".join(Config.ALLOWED_COMMENT_MARKERS)}')]
+            log_e_mock.assert_has_calls(exp_calls)
+
+            # Check we got sys.exit called with non-zero return code
+            self.assertEqual(SystemExit, type(context_manager.exception))
+            self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
+
+    @patch('proptool.log.Log.e')
+    def test_validate_args_missing_literal(self, log_e_mock: Mock) -> None:
         args = FakeArgs()
 
         for missing_literal in Config.COMMENT_TEMPLATE_LITERALS:
             tmp = copy.copy(Config.COMMENT_TEMPLATE_LITERALS)
             del tmp[tmp.index(missing_literal)]
             args.comment_template = ' '.join(tmp)
-            ConfigBuilder._validate_args(args)
-            exp_calls = [call(f'Missing literal in comment template: "{missing_literal}".')]
-            mock_log_abort.assert_has_calls(exp_calls)
+
+            with self.assertRaises(SystemExit) as context_manager:
+                ConfigBuilder._validate_args(args)
+                exp_calls = [call(f'Missing literal in comment template: "{missing_literal}".')]
+                log_e_mock.assert_has_calls(exp_calls)
+
+                # Check we got sys.exit called with non-zero return code
+                self.assertEqual(SystemExit, type(context_manager.exception))
+                self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 1baa84e4..96248d3c 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -8,11 +8,12 @@
 """
 import random
 from pathlib import Path
-from unittest.mock import Mock, mock_open, patch
+from unittest.mock import Mock, call, mock_open, patch
 
 from proptool.config.config import Config
 from proptool.prop.file import PropFile
 from proptool.prop.items import Blank, Comment, PropItem, Translation
+from proptool.utils import Utils
 from tests.test_case import TestCase
 
 
@@ -33,16 +34,24 @@ def test_append_wrong_arg_type(self) -> None:
     # #################################################################################################
 
     @patch('pathlib.Path.exists')
-    def test_load_non_existing_file(self, path_exists_mock: Mock) -> None:
+    @patch('proptool.log.Log.e')
+    def test_load_non_existing_file(self, path_exists_mock: Mock, log_e_mock: Mock) -> None:
         """
-        Tests if load() parses source file properly.
-
-        :param path_exists_mock: Mocked Path
+        Tests if load() fails on non-existing file correctly.
         """
+        path_exists_mock.return_value = False
+
         prop_file = PropFile(Config())
+        file_name = self.get_random_string()
 
-        path_exists_mock.return_value = False
-        prop_file.load(Path('foo'))
+        with self.assertRaises(FileNotFoundError) as context_manager:
+            prop_file.load(Path(file_name))
+            exp_calls = [call(f'File not found: {file_name}')]
+            log_e_mock.assert_has_calls(exp_calls)
+
+            # Check we got sys.exit called with non-zero return code
+            self.assertEqual(SystemExit, type(context_manager.exception))
+            self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
 
     @patch('pathlib.Path.exists')
     def test_load_strip_crlf(self, path_exists_mock: Mock) -> None:
@@ -70,7 +79,8 @@ def test_load_strip_crlf(self, path_exists_mock: Mock) -> None:
                 with patch('builtins.open', mock_open(read_data = ''.join(fake_data_src))):
                     # Lie our fake file exists
                     path_exists_mock.return_value = True
-                    prop_file = PropFile(Config(), Path('foo'))
+                    prop_file = PropFile(Config())
+                    prop_file.load(Path('foo'))
 
                     # We should have one entry less, because once we strip CRLF from the last
                     # row, it should overwrite entry set row before.
@@ -115,7 +125,8 @@ def test_load_empty_lines_whitespaces(self, path_exists_mock: Mock) -> None:
         with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))):
             # Lie our fake file exists
             path_exists_mock.return_value = True
-            prop_file = PropFile(Config(), Path('foo'))
+            prop_file = PropFile(Config())
+            prop_file.load(Path('foo'))
             self.assertEqual(len(fake_data_src), len(prop_file.items))
 
             for item in prop_file.items:
@@ -130,7 +141,8 @@ def test_load_empty_file(self, path_exists_mock: Mock) -> None:
         with patch('builtins.open', mock_open(read_data = '')):
             # Lie our fake file exists
             path_exists_mock.return_value = True
-            prop_file = PropFile(Config(), Path(fake_file_name))
+            prop_file = PropFile(Config())
+            prop_file.load(Path(fake_file_name))
             self.assertEqual(0, len(prop_file.items))
 
     @patch('pathlib.Path.exists')
@@ -161,13 +173,14 @@ def log_abort_side_effect(messages):
             """
             raise SystemExit
 
-        with patch('proptool.log.Log.abort', side_effect = log_abort_side_effect) as mocked_log_abort:
+        with patch('proptool.log.Log.e', side_effect = log_abort_side_effect) as mocked_log_abort:
             # Lie our fake file exists
             path_exists_mock.return_value = True
 
             with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))):
                 try:
-                    PropFile(Config(), Path(fake_file_name))
+                    prop_file = PropFile(Config())
+                    prop_file.load(Path(fake_file_name))
                 except SystemExit:
                     msg = mocked_log_abort.call_args_list[0][0][0]
                     self.assertEqual(msg, f'Invalid syntax at line {trap_position + 1} of "{fake_file_name}".')
@@ -225,7 +238,8 @@ def assertBlank(blank):
         with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))):
             # Lie our fake file exists
             path_mock.return_value = True
-            prop_file = PropFile(Config(), Path('foo'))
+            prop_file = PropFile(Config())
+            prop_file.load(Path('foo'))
             self.assertEqual(len(fake_data_src), len(prop_file.items))
 
             idx = 0
@@ -260,34 +274,18 @@ def assertBlank(blank):
     @patch('pathlib.Path.exists')
     def test_is_valid_on_empty_files(self, path_exists_mock: Mock) -> None:
 
-        fake_file_name = f'/does/not/matter/{self.get_random_string()}'
+        config = Config()
+        fake_file = Path(f'/does/not/matter/{self.get_random_string()}')
         with patch('builtins.open', mock_open(read_data = '')):
-            config = Config()
-
             # Lie our fake file exists
             path_exists_mock.return_value = True
 
-            ref_file = PropFile(config, Path(fake_file_name))
-            prop_file = PropFile(config, Path(fake_file_name))
+            ref_file = PropFile(config)
+            ref_file.load(fake_file)
+
+            prop_file = PropFile(config)
+            prop_file.load(fake_file)
 
             # Expecting no problems reported
+            prop_file.report.dump()
             self.assertTrue(prop_file.is_valid(ref_file))
-
-    def test_is_valid_file_not_set(self) -> None:
-        config = Config()
-        ref_file = PropFile(config)
-        prop_file = PropFile(config)
-
-        # Expecting errors reported
-        self.assertFalse(prop_file.is_valid(ref_file))
-        # FIXME: we shall also check if reported error message
-
-    def test_is_valid_file_not_found(self) -> None:
-        config = Config()
-        fake_file_name = self.get_random_string()
-        ref_file = PropFile(config, Path(fake_file_name))
-        prop_file = PropFile(config, Path(fake_file_name))
-
-        # Expecting errors reported
-        self.assertFalse(prop_file.is_valid(ref_file))
-        # FIXME: we shall also check if reported error message
diff --git a/tests/test_utils.py b/tests/test_utils.py
index 899920b6..ecccc5c1 100644
--- a/tests/test_utils.py
+++ b/tests/test_utils.py
@@ -8,7 +8,6 @@
 """
 
 import random
-from unittest.mock import call, patch
 
 from proptool.utils import Utils
 from tests.test_case import TestCase
@@ -16,34 +15,10 @@
 
 class TestUtils(TestCase):
 
-    @patch('builtins.print')
-    # As we mock print(), to sys.stdout.write('...\n') needs to be used instead.
-    def test_abort_single_msg(self, mock_print) -> None:
+    def test_abort(self) -> None:
         expected_rc = random.randint(1, 255)
-        msg = self.get_random_string()
         with self.assertRaises(SystemExit) as context_manager:
-            Utils.abort(msg, expected_rc)
-
-            # Ensure all messages are printed
-            exp_calls = [call(msg)]
-            mock_print.assert_has_calls(exp_calls)
-
-            # Check we got sys.exit called with our return code.
-            self.assertEqual(SystemExit, type(context_manager.exception))
-            self.assertEqual(expected_rc, context_manager.exception.code)
-
-    @patch('builtins.print')
-    # As we mock print(), to sys.stdout.write('...\n') needs to be used instead.
-    def test_abort_msg_list(self, mock_print) -> None:
-        expected_rc = random.randint(1, 255)
-        msgs_cnt = random.randint(1, 10)
-        msgs = self.get_random_string_list(msgs_cnt)
-        with self.assertRaises(SystemExit) as context_manager:
-            Utils.abort(msgs, expected_rc)
-
-            # Ensure our messages were printed in given order
-            exp_calls = [call(msg) for msg in msgs]
-            mock_print.assert_has_calls(exp_calls)
+            Utils.abort(expected_rc)
 
             # Check we got sys.exit called with our return code.
             self.assertEqual(SystemExit, type(context_manager.exception))

From 5f9866402193fe22f6ba8617fb6b62215e3e6d65 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Thu, 29 Jul 2021 10:58:32 +0200
Subject: [PATCH 088/140] load() accepts language now

---
 proptool/main.py      | 32 +++++++++++++++++++-------------
 proptool/prop/file.py | 12 ++++++------
 2 files changed, 25 insertions(+), 19 deletions(-)

diff --git a/proptool/main.py b/proptool/main.py
index 2c876e10..397ac067 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -51,8 +51,10 @@ def start() -> int:
             name_suffix = tmp[1]
 
             Log.push(f'Base: {reference_path}')
-            reference_propfile = PropFile(config, reference_path)
-            if not reference_propfile.loaded:
+            reference_propfile = PropFile(config)
+            try:
+                reference_propfile.load(reference_path)
+            except FileNotFoundError:
                 Log.e(f'File not found: {reference_path}')
                 Utils.abort()
 
@@ -80,16 +82,20 @@ def start() -> int:
             if not reference_propfile.report.is_fatal():
                 for lang in config.languages:
                     translation_path = Path(reference_path.parent / f'{name_prefix}_{lang}.{name_suffix}')
-                    translation_propfile = PropFile(config, translation_path, lang)
-
-                    trans_level_label = f'{lang.upper()}: {translation_path}'
-                    Log.push(trans_level_label, deferred = True)
-                    if not translation_propfile.validate_and_fix(reference_propfile):
-                        translation_propfile.report.dump()
-                        errors += 1
-                    if Log.pop():
-                        Log.i(f'%ok%{trans_level_label}: OK')
-
-            Log.pop()
+                    translation_propfile = PropFile(config, lang)
+
+                    try:
+                        translation_propfile.load(translation_path)
+                        trans_level_label = f'{lang.upper()}: {translation_path}'
+                        Log.push(trans_level_label, deferred = True)
+                        if not translation_propfile.validate_and_fix(reference_propfile):
+                            translation_propfile.report.dump()
+                            errors += 1
+                        if Log.pop():
+                            Log.i(f'%ok%{trans_level_label}: OK')
+                    except FileNotFoundError:
+                        Log.e(f'File not found: {translation_path}')
+
+        Log.pop()
 
         return 100 if errors else 0
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 78666e7f..3ee44086 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -35,8 +35,7 @@
 # #################################################################################################
 
 class PropFile(object):
-    # def __init__(self, config: Config, language: List[str] = None):
-    def __init__(self, config: Config):
+    def __init__(self, config: Config, language: str = None):
         super().__init__()
 
         self.config: Config = config
@@ -55,7 +54,7 @@ def __init__(self, config: Config):
         self.report: Report = Report(config)
 
         # This call is most likely redundant here.
-        self.init_container()
+        self.init_container(language)
 
         comment_pattern = re.escape(self.config.comment_template).replace(
             'COM', f'[{"".join(Config.ALLOWED_COMMENT_MARKERS)}]').replace(
@@ -64,12 +63,13 @@ def __init__(self, config: Config):
         comment_pattern = comment_pattern.replace('KEY', '([a-zAz][a-zA-z0-9_.-]+)')
         self.comment_pattern = f'^{comment_pattern}'
 
-    def init_container(self) -> None:
+    def init_container(self, language: str) -> None:
         self._items = []
         self.keys = []
         self.commented_out_keys = []
         self.loaded = False
         self.report = Report(self.config)
+        self.language = language
 
     # #################################################################################################
 
@@ -167,7 +167,7 @@ def is_valid(self, reference_file: 'PropFile') -> bool:
 
     # #################################################################################################
 
-    def load(self, file: Path) -> bool:
+    def load(self, file: Path, language: str = None) -> bool:
         """
         Loads and parses *.properties file.
 
@@ -178,7 +178,7 @@ def load(self, file: Path) -> bool:
         if not file.exists():
             raise FileNotFoundError(f'File not found: {file}')
 
-        self.init_container()
+        self.init_container(language)
 
         with open(file, 'r') as fh:
             line_number: int = 0

From 72aa342ac8d4fd74158ba19991f84c2d8b1dd33f Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Thu, 29 Jul 2021 11:07:03 +0200
Subject: [PATCH 089/140] Fixed test_append_wrong_arg_type()

---
 tests/prop/test_file.py | 19 ++++---------------
 1 file changed, 4 insertions(+), 15 deletions(-)

diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 96248d3c..52b16e7d 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -33,25 +33,14 @@ def test_append_wrong_arg_type(self) -> None:
 
     # #################################################################################################
 
-    @patch('pathlib.Path.exists')
-    @patch('proptool.log.Log.e')
-    def test_load_non_existing_file(self, path_exists_mock: Mock, log_e_mock: Mock) -> None:
+    def test_load_non_existing_file(self) -> None:
         """
         Tests if load() fails on non-existing file correctly.
         """
-        path_exists_mock.return_value = False
-
-        prop_file = PropFile(Config())
         file_name = self.get_random_string()
-
-        with self.assertRaises(FileNotFoundError) as context_manager:
-            prop_file.load(Path(file_name))
-            exp_calls = [call(f'File not found: {file_name}')]
-            log_e_mock.assert_has_calls(exp_calls)
-
-            # Check we got sys.exit called with non-zero return code
-            self.assertEqual(SystemExit, type(context_manager.exception))
-            self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
+        prop_file = PropFile(Config())
+        prop_file.load(Path(file_name))
+        self.assertRaises(FileNotFoundError)
 
     @patch('pathlib.Path.exists')
     def test_load_strip_crlf(self, path_exists_mock: Mock) -> None:

From 30c32652a21c8a165a3cc8fcdd6f2fc35a3f89e1 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Thu, 29 Jul 2021 11:23:01 +0200
Subject: [PATCH 090/140] Corrected tests

---
 tests/prop/test_file.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 52b16e7d..1495a840 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -39,8 +39,10 @@ def test_load_non_existing_file(self) -> None:
         """
         file_name = self.get_random_string()
         prop_file = PropFile(Config())
-        prop_file.load(Path(file_name))
-        self.assertRaises(FileNotFoundError)
+        with self.assertRaises(Exception) as cm:
+            prop_file.load(Path(file_name))
+            print('xx' + cm.exception.message)
+            self.assertEqual(FileNotFoundError, type(cm.exception))
 
     @patch('pathlib.Path.exists')
     def test_load_strip_crlf(self, path_exists_mock: Mock) -> None:

From 22cae07810f808f1a11af4fd264de93add3af19c Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Thu, 29 Jul 2021 11:24:08 +0200
Subject: [PATCH 091/140] Lint fixes

---
 tests/prop/test_file.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 1495a840..ca8f0263 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -8,12 +8,11 @@
 """
 import random
 from pathlib import Path
-from unittest.mock import Mock, call, mock_open, patch
+from unittest.mock import Mock, mock_open, patch
 
 from proptool.config.config import Config
 from proptool.prop.file import PropFile
 from proptool.prop.items import Blank, Comment, PropItem, Translation
-from proptool.utils import Utils
 from tests.test_case import TestCase
 
 
@@ -41,7 +40,6 @@ def test_load_non_existing_file(self) -> None:
         prop_file = PropFile(Config())
         with self.assertRaises(Exception) as cm:
             prop_file.load(Path(file_name))
-            print('xx' + cm.exception.message)
             self.assertEqual(FileNotFoundError, type(cm.exception))
 
     @patch('pathlib.Path.exists')

From e1ee89ad598969d4f53fcf37e3e7a35f7de0276b Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Thu, 29 Jul 2021 11:27:50 +0200
Subject: [PATCH 092/140] Disabled codecov patch coverage

---
 .codecov.yml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/.codecov.yml b/.codecov.yml
index 36b5965b..1bed99d5 100644
--- a/.codecov.yml
+++ b/.codecov.yml
@@ -6,3 +6,8 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 comment: false
+coverage:
+  status:
+    patch:
+      default:
+        enabled: no

From f8108cff075c8da25ea51787a5bc8168b31e5dfe Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Thu, 29 Jul 2021 11:31:17 +0200
Subject: [PATCH 093/140] Added Python 3.9 to UT action

---
 .github/workflows/unittests.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/unittests.yml b/.github/workflows/unittests.yml
index ea2d7af4..c2221561 100644
--- a/.github/workflows/unittests.yml
+++ b/.github/workflows/unittests.yml
@@ -22,7 +22,7 @@ jobs:
       matrix:
         # os: [ ubuntu-latest, macos-latest, windows-latest ]
         os: [ ubuntu-latest ]
-        python: [3.6, 3.7, 3.8]
+        python: [3.6, 3.7, 3.8, 3.9]
 
     steps:
       # https://github.com/marketplace/actions/checkout

From b13dbae9abe31a0a81312dd6ee2c812be99d4c0a Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Thu, 29 Jul 2021 11:36:38 +0200
Subject: [PATCH 094/140] Simplified test_load_invalid_translation_syntax()
 test

---
 tests/prop/test_file.py | 13 +++----------
 1 file changed, 3 insertions(+), 10 deletions(-)

diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index ca8f0263..30b43079 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -135,7 +135,7 @@ def test_load_empty_file(self, path_exists_mock: Mock) -> None:
             self.assertEqual(0, len(prop_file.items))
 
     @patch('pathlib.Path.exists')
-    def test_load_invalid_translation_invalid_syntax(self, path_exists_mock: Mock) -> None:
+    def test_load_invalid_translation_syntax(self, path_exists_mock: Mock) -> None:
         """
         Ensures lines that are expected to be translation but do not match expected syntax
         are caught correctly.
@@ -155,14 +155,7 @@ def test_load_invalid_translation_invalid_syntax(self, path_exists_mock: Mock) -
         trap_position = random.randint(0, len(fake_data_src) - 1)
         fake_data_src.insert(trap_position, 'WRONG SYNTAX')
 
-        # noinspection PyUnusedLocal
-        def log_abort_side_effect(messages):
-            """
-            Side effect to be called when Log.abort() is invoked to break the load() loop.
-            """
-            raise SystemExit
-
-        with patch('proptool.log.Log.e', side_effect = log_abort_side_effect) as mocked_log_abort:
+        with patch('proptool.log.Log.e') as log_e_mock:
             # Lie our fake file exists
             path_exists_mock.return_value = True
 
@@ -171,7 +164,7 @@ def log_abort_side_effect(messages):
                     prop_file = PropFile(Config())
                     prop_file.load(Path(fake_file_name))
                 except SystemExit:
-                    msg = mocked_log_abort.call_args_list[0][0][0]
+                    msg = log_e_mock.call_args_list[0][0][0]
                     self.assertEqual(msg, f'Invalid syntax at line {trap_position + 1} of "{fake_file_name}".')
 
     @patch('pathlib.Path.exists')

From 987a3f1a751ff56b078487a414156c7eb31201d5 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Thu, 29 Jul 2021 13:36:20 +0200
Subject: [PATCH 095/140] Added some code comments

---
 proptool/main.py        | 3 +++
 proptool/prop/file.py   | 1 +
 tests/prop/test_file.py | 1 +
 3 files changed, 5 insertions(+)

diff --git a/proptool/main.py b/proptool/main.py
index 397ac067..760e0770 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -50,7 +50,9 @@ def start() -> int:
             name_prefix = tmp[0]
             name_suffix = tmp[1]
 
+            # Main push
             Log.push(f'Base: {reference_path}')
+
             reference_propfile = PropFile(config)
             try:
                 reference_propfile.load(reference_path)
@@ -96,6 +98,7 @@ def start() -> int:
                     except FileNotFoundError:
                         Log.e(f'File not found: {translation_path}')
 
+        # Close main push.
         Log.pop()
 
         return 100 if errors else 0
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 3ee44086..814fcb79 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -172,6 +172,7 @@ def load(self, file: Path, language: str = None) -> bool:
         Loads and parses *.properties file.
 
         :param file: File to load.
+        :param language: Optional language code the loaded data if for.
         :return: True if file loaded correctly, False otherwise.
         """
 
diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 30b43079..30dcac81 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -164,6 +164,7 @@ def test_load_invalid_translation_syntax(self, path_exists_mock: Mock) -> None:
                     prop_file = PropFile(Config())
                     prop_file.load(Path(fake_file_name))
                 except SystemExit:
+                    # sys.exit() happened afrer Log.e() is called, so we can check the error message here.
                     msg = log_e_mock.call_args_list[0][0][0]
                     self.assertEqual(msg, f'Invalid syntax at line {trap_position + 1} of "{fake_file_name}".')
 

From 092955888b4e615accf081589c025bb49f081fc2 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Thu, 29 Jul 2021 21:32:26 +0200
Subject: [PATCH 096/140] Reworked file content sync to be in-place instead
 on-save

---
 proptool/config/config.py           |  2 +-
 proptool/config/config_builder.py   |  2 +-
 proptool/main.py                    | 14 +++++---
 proptool/prop/file.py               | 53 +++++++++++++++++++----------
 tests/config/test_config_builder.py | 16 ++++-----
 5 files changed, 55 insertions(+), 32 deletions(-)

diff --git a/proptool/config/config.py b/proptool/config/config.py
index 580280ad..fb30a27c 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -29,7 +29,7 @@ def __init__(self):
         self.quiet: bool = False
         self.verbose: bool = False
 
-        self.fix: bool = False
+        self.update: bool = False
 
         self.files: List[str] = []
         self.languages: List[str] = []
diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 40314242..3e8a1684 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -99,7 +99,7 @@ def _set_from_args(config: Config, args) -> None:
             ConfigBuilder._set_on_off_option(config, args, pair_option_name)
 
         # cmd fix
-        config.fix = args.fix
+        config.update = args.update
 
         # Set optional args, if set by user.
         optionals = [
diff --git a/proptool/main.py b/proptool/main.py
index 760e0770..6e537041 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -80,19 +80,25 @@ def start() -> int:
                 # There's something to fix, but not necessary critical.
                 reference_propfile.report.dump()
 
-            # No errors, no problem. Warnings are just fine.
+            # No reference files errors. Warnings are just fine, though.
             if not reference_propfile.report.is_fatal():
                 for lang in config.languages:
                     translation_path = Path(reference_path.parent / f'{name_prefix}_{lang}.{name_suffix}')
-                    translation_propfile = PropFile(config, lang)
+                    translation_propfile = PropFile(config)
 
                     try:
-                        translation_propfile.load(translation_path)
+                        translation_propfile.load(translation_path, lang)
                         trans_level_label = f'{lang.upper()}: {translation_path}'
                         Log.push(trans_level_label, deferred = True)
-                        if not translation_propfile.validate_and_fix(reference_propfile):
+
+                        if not translation_propfile.is_valid(reference_propfile):
                             translation_propfile.report.dump()
                             errors += 1
+                            if config.update:
+                                if translation_propfile.file:
+                                    translation_propfile.update(reference_propfile)
+                                    translation_propfile.save()
+
                         if Log.pop():
                             Log.i(f'%ok%{trans_level_label}: OK')
                     except FileNotFoundError:
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 814fcb79..69fe1e8c 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -111,30 +111,34 @@ def append(self, item: PropItem):
 
     # #################################################################################################
 
-    def validate_and_fix(self, reference: 'PropFile') -> None:
-        if not self.is_valid(reference) and self.config.fix:
-            self.fix(reference)
-
-    # #################################################################################################
+    def update(self, reference_propfile: 'PropFile') -> None:
+        """
+        Rewrites content of the file using reference file as foundation. It then adds all keys from reference files.
+        The update rules are as follow:
+        * If we have translation for it, we add it,
+        * if we do not have it, it will go as comment and recorded as commented-out key,
+        * all reference files comments are copied to,
+        * dangling keys and translation file comments are gone.
+
+        :param reference_propfile:
+        """
 
-    def fix(self, reference: 'PropFile') -> None:
-        synced: List[str] = []
+        tmp = PropFile(self.config)
 
-        comment_pattern = self.config.comment_template.replace('COM', self.config.comment_marker).replace('SEP', self.separator)
-        for item in reference.items:
-            if isinstance(item, Translation):
+        for idx, item in enumerate(reference_propfile.items):
+            if isinstance(item, (Comment, Blank)):
+                tmp.append(item)
+            elif isinstance(item, Translation):
                 if item.key in self.keys:
-                    synced.append(self.find_by_key(item.key).to_string() + '\n')
+                    tmp.append(self.find_by_key(item.key))
                 else:
-                    synced.append(comment_pattern.replace('KEY', item.key) + '\n')
-            elif isinstance(item, (Blank, Comment)):
-                synced.append(item.to_string() + '\n')
+                    tmp.append(Comment(self.config.comment_pattern.replace('KEY', item.key)))
             else:
-                raise RuntimeError(f'Unknown entry type: {type(item)}')
+                raise RuntimeError(f'Unknown entry type: {type(item)} at position {idx + 1}')
 
-        Log.i(f'Re-writing translation file: {self.file}')
-        with open(self.file, 'w') as fh:
-            fh.writelines(synced)
+        self._items = copy.deepcopy(tmp.items)
+        self.keys = copy.copy(tmp.keys)
+        self.commented_out_keys = copy.copy(tmp.commented_out_keys)
 
     # #################################################################################################
 
@@ -225,3 +229,16 @@ def load(self, file: Path, language: str = None) -> bool:
                 self.report.add(duplicated_keys)
 
         return True
+
+    # #################################################################################################
+
+    def save(self, target_file_name: Path) -> None:
+        """
+        Saves content of the propfile.
+        """
+
+        Log.i(f'Saving: {target_file_name}')
+        with open(target_file_name, 'w') as fh:
+            for item in self.items:
+                # FIXME: LF/CRLF should configurable
+                fh.write(f'{item.to_string()}\n')
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index 9edac03d..5750870e 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -21,7 +21,7 @@
 
 class FakeArgs(object):
     def __init__(self):
-        self.fix: bool = False
+        self.update: bool = False
         self.quiet: bool = False
         self.color: bool = False
 
@@ -66,7 +66,7 @@ def test_validate_no_files(self, log_e_mock: Mock) -> None:
         """
         Ensures empty list of files triggers expected error message and quits.
 
-        :param mock_log_abort: Log.abort() mock.
+        :param log_e_mock: Log.abort() mock.
         """
         config = self.get_config_for_validate()
         config.files = []
@@ -84,7 +84,7 @@ def test_validate_no_languages(self, log_e_mock: Mock) -> None:
         """
         Ensures empty language list triggers expected error message and quits.
 
-        :param mock_log_abort: Log.abort() mock.
+        :param log_e_mock: Log.abort() mock.
         """
         config = self.get_config_for_validate()
         config.languages = []
@@ -102,7 +102,7 @@ def test_validate_invalid_separator(self, log_e_mock: Mock) -> None:
         """
         Ensures invalid separator char triggers expected error message and quits.
 
-        :param mock_log_abort: Log.abort() mock.
+        :param log_e_mock: Log.abort() mock.
         """
         config = self.get_config_for_validate()
         config.separator = 'invalid'
@@ -120,7 +120,7 @@ def test_validate_invalid_comment_marker(self, log_e_mock: Mock) -> None:
         """
         Ensures invalid comment marker triggers expected error message and quits.
 
-        :param mock_log_abort: Log.abort() mock.
+        :param log_e_mock: Log.abort() mock.
         """
         config = self.get_config_for_validate()
         config.comment_marker = ''
@@ -178,7 +178,7 @@ def test_set_from_args(self) -> None:
         args = FakeArgs()
 
         # Lets set up args to some random state
-        args.fix = self.get_random_bool()
+        args.update = self.get_random_bool()
         args.quiet = self.get_random_bool()
         args.verbose = self.get_random_bool()
         args.color = self.get_random_bool()
@@ -292,7 +292,7 @@ def test_validate_args_quiet_and_verbose(self, log_e_mock: Mock) -> None:
         """
         Ensures use of mutually exclusive --quiet and --verbose is handled correctly.
 
-        :param mock_log_abort: Log.abort() mock.
+        :param log_e_mock: Log.abort() mock.
         """
         args = FakeArgs()
 
@@ -312,7 +312,7 @@ def test_validate_args_invalid_separator(self, log_e_mock: Mock) -> None:
         """
         Checks if attempt to use invalid character as separator is correctly handled.
 
-        :param mock_log_abort:
+        :param log_e_mock:
         """
         args = FakeArgs()
 

From b3e0912de6c04d309c7999daae60c9c54e6ba844 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Thu, 29 Jul 2021 21:40:52 +0200
Subject: [PATCH 097/140] Corrected args handling

---
 proptool/config/config_builder.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 3e8a1684..c3e0f602 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -147,14 +147,14 @@ def _parse_args() -> argparse:
                            help = 'List of languages to check (space separated if more than one, i.e. "de pl").')
 
         group = parser.add_argument_group('Additional options')
-        group.add_argument('--fix', action = 'store_true', dest = 'fix',
-                           help = 'Updated translation files in-place. No backup!')
+        group.add_argument('--update', action = 'store_true', dest = 'update',
+                           help = 'Updates translation files in-place using base file as reference. No backup!')
         # group.add_argument('--pe', '--punctuation-exception', dest = 'punctuation_exception_langs', nargs = '*', metavar = 'LANG',
         #                    help = 'List of languages for which punctuation mismatch should not be checked for, i.e. "jp"')
         group.add_argument('--separator', action = 'store', dest = 'separator', metavar = 'CHAR', nargs = 1,
                            help = 'If specified, only given CHAR is considered a valid key/value separator.'
                                   + f'Must be one of the following: {", ".join(Config.ALLOWED_SEPARATORS)}')
-        group.add_argument('--comment', action = 'store', dest = 'comment', metavar = 'CHAR', nargs = 1,
+        group.add_argument('--comment', action = 'store', dest = 'comment_marker', metavar = 'CHAR', nargs = 1,
                            help = 'If specified, only given CHAR is considered valid comment marker.'
                                   + f'Must be one of the following: {", ".join(Config.ALLOWED_COMMENT_MARKERS)}')
         group.add_argument('-t', '--template', action = 'store', dest = 'comment_template', metavar = 'TEMPLATE', nargs = 1,

From 60e4c071d37e6030abd0081b91706cecd519db77 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Fri, 30 Jul 2021 10:32:13 +0200
Subject: [PATCH 098/140] Added checker's related config methods

---
 proptool/config/config.py | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/proptool/config/config.py b/proptool/config/config.py
index fb30a27c..6969a066 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -19,6 +19,8 @@ class Config(object):
     DEFAULT_FILE_SUFFIX: str = '.properties'
 
     def __init__(self):
+        self.config_file = None
+
         self.file_suffix = Config.DEFAULT_FILE_SUFFIX
 
         self.fatal = False
@@ -43,5 +45,10 @@ def __init__(self):
             # empty set
         }
 
-    def add_checker_config(self, key: str, config: Dict) -> None:
-        self.checks[key] = config
+    def set_checker_config(self, checker_id: str, config: Dict) -> None:
+        self.checks[checker_id] = config
+
+    def get_checker_config(self, checker_id: str) -> Dict:
+        if checker_id not in self.checks:
+            raise KeyError(f'No config for {checker_id} found.')
+        return self.checks[checker_id]

From 0192a8b8edeff0c92724699fffde0cadde92c03d Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Fri, 30 Jul 2021 10:32:45 +0200
Subject: [PATCH 099/140] CLI args cleanup

---
 proptool/config/config_builder.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index c3e0f602..39b873a3 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -159,8 +159,13 @@ def _parse_args() -> argparse:
                                   + f'Must be one of the following: {", ".join(Config.ALLOWED_COMMENT_MARKERS)}')
         group.add_argument('-t', '--template', action = 'store', dest = 'comment_template', metavar = 'TEMPLATE', nargs = 1,
                            help = f'Format of commented-out entries. Default: "{Config.DEFAULT_COMMENT_TEMPLATE}".')
+        group.add_argument('--suffix', action = 'store', dest = 'file_suffix', metavar = 'STRING', nargs = 1,
+                           help = f'Default file name suffix. Default: "{Config.DEFAULT_FILE_SUFFIX}".')
 
         group = parser.add_argument_group('Checks controlling options')
+        group.add_argument('--checks', action = 'store', dest = 'checks', nargs = '+', metavar = 'CHECK_ID',
+                           help = 'List of checks ID to be executed. By default all available checks are run.')
+
         group.add_argument('-s', '--strict', action = 'store_true', dest = 'strict',
                            help = 'Enables strict validation mode for all checks involved.')
         group.add_argument('-ns', '--no-strict', action = 'store_true', dest = 'no_strict',
@@ -173,13 +178,11 @@ def _parse_args() -> argparse:
 
         group = parser.add_argument_group('Application controls')
         group.add_argument('-q', '--quiet', action = 'store_true', dest = 'quiet',
-                           help = 'Enables quiet mode, mutting all output but fatal errors.')
+                           help = 'Enables quiet mode, muting all output but fatal errors.')
         group.add_argument('-v', '--verbose', action = 'store_true', dest = 'verbose',
                            help = 'Produces more verbose reports.')
         group.add_argument('-d', '--debug', action = 'store_true', dest = 'debug',
                            help = 'Enables debug output.')
-        group.add_argument('-nd', '--no-debug', action = 'store_true', dest = 'no_debug',
-                           help = 'Disables additional debug output (default).')
 
         group.add_argument('-c', '--color', action = 'store_true', dest = 'color',
                            help = 'Enables use of ANSI colors (default).')

From 3a9dc1e989504a3e9d272d44f1d3a90680c9a27e Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Fri, 30 Jul 2021 10:33:56 +0200
Subject: [PATCH 100/140] Routed config access thru helpers

---
 proptool/main.py                    |  3 ++-
 tests/checks/checks_test_case.py    |  2 +-
 tests/checks/test_punctuation.py    |  6 ++---
 tests/config/test_config_builder.py | 41 +++++++++++++++++++++++++++++
 4 files changed, 47 insertions(+), 5 deletions(-)

diff --git a/proptool/main.py b/proptool/main.py
index 6e537041..d6fd27f6 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -74,7 +74,8 @@ def start() -> int:
                 # file. For them we pass our base file as translation which will do the trick.
                 #
                 # Each validator gets copy of the files, to prevent any potential destructive operation.
-                reference_propfile.report.add((validator(config)).check(copy.copy(reference_propfile)))
+                checker_config = config.get_checker_config(validator.__name__)
+                reference_propfile.report.add((validator(config)).check(checker_config, copy.copy(reference_propfile)))
 
             if not reference_propfile.report.empty():
                 # There's something to fix, but not necessary critical.
diff --git a/tests/checks/checks_test_case.py b/tests/checks/checks_test_case.py
index e5fc44fd..d7427cd1 100644
--- a/tests/checks/checks_test_case.py
+++ b/tests/checks/checks_test_case.py
@@ -25,7 +25,7 @@ def setUp(self) -> None:
         checker = self.get_checker(None)
         if not issubclass(type(checker), Check):
             raise ValueError('Checker must be subclass of Check')
-        self.config.add_checker_config(checker.__class__.__name__, self.get_checker().get_default_config())
+        self.config.set_checker_config(checker.__class__.__name__, self.get_checker().get_default_config())
         checker.config = self.config
         self.checker = checker
 
diff --git a/tests/checks/test_punctuation.py b/tests/checks/test_punctuation.py
index 9172b617..0524d7da 100644
--- a/tests/checks/test_punctuation.py
+++ b/tests/checks/test_punctuation.py
@@ -7,7 +7,7 @@
 #
 """
 import random
-from typing import Union
+from typing import Dict, Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.punctuation import Punctuation
@@ -32,7 +32,7 @@ def test_no_faults(self) -> None:
         cnt_max = 40
         keys = [self.get_random_string('key_') for _ in range(random.randint(cnt_min, cnt_max))]
 
-        marks = self.config.checks['Punctuation']['chars']
+        marks = (self.config.get_checker_config('Punctuation'))['chars']
         punct_idx = 0
 
         ref_file = PropFile(self.config)
@@ -51,7 +51,7 @@ def test_with_faults(self) -> None:
         cnt_max = 40
         keys = [self.get_random_string('key_') for _ in range(random.randint(cnt_min, cnt_max))]
 
-        marks = self.config.checks['Punctuation']['chars']
+        marks = (self.config.get_checker_config('Punctuation'))['chars']
         punct_idx = 0
 
         expected_faults = 0
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index 5750870e..b48ad7c7 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -9,6 +9,7 @@
 
 import copy
 import random
+import sys
 from pathlib import Path
 from typing import List, Union
 from unittest.mock import Mock, call, patch
@@ -363,3 +364,43 @@ def test_validate_args_missing_literal(self, log_e_mock: Mock) -> None:
                 # Check we got sys.exit called with non-zero return code
                 self.assertEqual(SystemExit, type(context_manager.exception))
                 self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
+
+    # #################################################################################################
+
+    def test_parse_args_returns_all_keys(self) -> None:
+        """
+        Checks if argparse returned dict contains all the keys we expect to be present while building
+        Config instance.
+        """
+        config = Config()
+
+        # Pass no args for parsing (this is legit as we have config file that can provide what's needed).
+        sys.argv[1:] = []
+        args = ConfigBuilder._parse_args()
+        for key in config.__dict__:
+            self.assertIn(key, args)
+
+    def test_parse_args_returns_no_more_keys(self) -> None:
+        """
+        Checks if argparse returned keys are all expected and handled by config (no dangling options
+        no-one supports).
+        """
+        config = Config()
+
+        # Pass no args for parsing (this is legit as we have config file that can provide what's needed).
+        sys.argv[1:] = []
+        args = vars(ConfigBuilder._parse_args())
+
+        # Eliminate --no-<KEY> related keys first as these are not mapped directly.
+        for pair_key in ConfigBuilder._on_off_pairs:
+            del args[f'no_{pair_key}']
+
+        # Remove `show_version` as this is also not mapped.
+        # FIXME: this should not be hardcoded here!
+        del args['show_version']
+
+        self.assertEqual(len(args), len(config.__dict__))
+
+        for key in args:
+            # Ensure key args returns is what is present in Config as well.
+            self.assertIn(key, config.__dict__)

From de2498922b10de178583a24e10ad83ee002de480 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Fri, 30 Jul 2021 10:45:47 +0200
Subject: [PATCH 101/140] Cleanup

---
 proptool/checks/brackets.py | 4 ++--
 proptool/main.py            | 3 +--
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/proptool/checks/brackets.py b/proptool/checks/brackets.py
index f1a25b9b..8de6d236 100644
--- a/proptool/checks/brackets.py
+++ b/proptool/checks/brackets.py
@@ -42,8 +42,8 @@ def check(self, translation: 'PropFile', reference: 'PropFile' = None) -> Report
         if not translation.items:
             return report
 
-        opening = self.config.checks[self.__class__.__name__]['opening']
-        closing = self.config.checks[self.__class__.__name__]['closing']
+        opening = (self.config.get_checker_config(self.__class__.__name__))['opening']
+        closing = (self.config.get_checker_config(self.__class__.__name__))['closing']
 
         for idx, item in enumerate(translation.items):
             # Do not try to be clever and filter() data first, because line_number values will no longer be correct.
diff --git a/proptool/main.py b/proptool/main.py
index d6fd27f6..6e537041 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -74,8 +74,7 @@ def start() -> int:
                 # file. For them we pass our base file as translation which will do the trick.
                 #
                 # Each validator gets copy of the files, to prevent any potential destructive operation.
-                checker_config = config.get_checker_config(validator.__name__)
-                reference_propfile.report.add((validator(config)).check(checker_config, copy.copy(reference_propfile)))
+                reference_propfile.report.add((validator(config)).check(copy.copy(reference_propfile)))
 
             if not reference_propfile.report.empty():
                 # There's something to fix, but not necessary critical.

From 51a7097e4db3b1099ae30cff503156fc77029c13 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Fri, 30 Jul 2021 11:30:50 +0200
Subject: [PATCH 102/140] Removed hardcoded list of validators

---
 proptool/checks/base/check.py                 |  2 ++
 proptool/checks/brackets.py                   |  3 ++
 proptool/checks/formatting_values.py          |  2 ++
 proptool/checks/key_format.py                 |  2 ++
 proptool/checks/quotation_marks.py            |  2 ++
 proptool/checks/trailing_white_chars.py       |  2 ++
 .../checks/typesetting_quotation_marks.py     |  2 ++
 .../checks/white_chars_before_linefeed.py     |  2 ++
 proptool/main.py                              | 23 ++++----------
 proptool/prop/file.py                         | 31 ++-----------------
 10 files changed, 26 insertions(+), 45 deletions(-)

diff --git a/proptool/checks/base/check.py b/proptool/checks/base/check.py
index e43731c2..877ccbf9 100644
--- a/proptool/checks/base/check.py
+++ b/proptool/checks/base/check.py
@@ -24,6 +24,8 @@ def __init__(self, config: Union[Config, None] = None):
                 raise ValueError(f'Configuration object must be instance of Config ("{type(config)}" given).')
         self.config = config
 
+        self.is_single_file_check = False
+
     @abstractmethod
     # Do NOT "fix" the PropFile reference and do not import it, or you step on circular dependency!
     def check(self, translation: 'PropFile', reference: Union['PropFile', None] = None) -> Report:
diff --git a/proptool/checks/brackets.py b/proptool/checks/brackets.py
index 8de6d236..b55e4180 100644
--- a/proptool/checks/brackets.py
+++ b/proptool/checks/brackets.py
@@ -30,6 +30,9 @@ class Brackets(Check):
     opened brackets are closed.
     """
 
+    _is_single_file_check = True
+
+
     report_title = 'Brackets'
 
     @overrides(Check)
diff --git a/proptool/checks/formatting_values.py b/proptool/checks/formatting_values.py
index 1b80b98c..43a8f92f 100644
--- a/proptool/checks/formatting_values.py
+++ b/proptool/checks/formatting_values.py
@@ -31,6 +31,8 @@ class FormattingValues(Check):
     then translation uses it as well and in the same order.
     """
 
+    _is_single_file_check = True
+
     def _parse(self, item: str) -> List[Formatter]:
         # https://docs.oracle.com/javase/7/docs/api/java/util/Formatter.html
         # %[argument_index$][flags][width][.precision]conversion
diff --git a/proptool/checks/key_format.py b/proptool/checks/key_format.py
index 6eb28c79..233e8129 100644
--- a/proptool/checks/key_format.py
+++ b/proptool/checks/key_format.py
@@ -24,6 +24,8 @@ class KeyFormat(Check):
     This check verifies that translation keys follow specified naming convention.
     """
 
+    _is_single_file_check = True
+
     @overrides(Check)
     # Do NOT "fix" the PropFile reference and do not import it, or you step on circular dependency!
     def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None) -> ReportGroup:
diff --git a/proptool/checks/quotation_marks.py b/proptool/checks/quotation_marks.py
index 3afe193c..91fece75 100644
--- a/proptool/checks/quotation_marks.py
+++ b/proptool/checks/quotation_marks.py
@@ -30,6 +30,8 @@ class QuotationMarks(Check):
     opened marks got their closing pair.
     """
 
+    _is_single_file_check = True
+
     @overrides(Check)
     # Do NOT "fix" the PropFile reference and do not import it, or you step on circular dependency!
     def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None) -> ReportGroup:
diff --git a/proptool/checks/trailing_white_chars.py b/proptool/checks/trailing_white_chars.py
index 4fe95766..a831828b 100644
--- a/proptool/checks/trailing_white_chars.py
+++ b/proptool/checks/trailing_white_chars.py
@@ -21,6 +21,8 @@ class TrailingWhiteChars(Check):
     Checks if file has trailing white characters at the end of each line.
     """
 
+    _is_single_file_check = True
+
     @overrides(Check)
     # Do NOT "fix" the PropFile reference and do not import it, or you step on circular dependency!
     def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None) -> ReportGroup:
diff --git a/proptool/checks/typesetting_quotation_marks.py b/proptool/checks/typesetting_quotation_marks.py
index 8d444d74..79e138e6 100644
--- a/proptool/checks/typesetting_quotation_marks.py
+++ b/proptool/checks/typesetting_quotation_marks.py
@@ -21,6 +21,8 @@ class TypesettingQuotationMarks(Brackets):
     ensures proper nesting and checks if all opened brackets are closed.
     """
 
+    _is_single_file_check = True
+
     report_title = ReportGroup('Print Quotation Marks')
 
     opening: List[str] = ['‘', '«', '„', '「', '《']
diff --git a/proptool/checks/white_chars_before_linefeed.py b/proptool/checks/white_chars_before_linefeed.py
index 667b3264..46a9c32d 100644
--- a/proptool/checks/white_chars_before_linefeed.py
+++ b/proptool/checks/white_chars_before_linefeed.py
@@ -20,6 +20,8 @@ class WhiteCharsBeforeLinefeed(Check):
     This check ensures there's no space before "\n", "\r" literals.
     """
 
+    is_single_file_check = True
+
     def _scan(self, report: ReportGroup, idx: int, item: Translation, literal: str) -> bool:
         literal_len = len(literal)
         # Let's crawl backward and see what's there...
diff --git a/proptool/main.py b/proptool/main.py
index 6e537041..ec6e3e80 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -11,12 +11,6 @@
 import sys
 from pathlib import Path
 
-from proptool.checks.brackets import Brackets
-from proptool.checks.key_format import KeyFormat
-from proptool.checks.quotation_marks import QuotationMarks
-from proptool.checks.trailing_white_chars import TrailingWhiteChars
-from proptool.checks.typesetting_quotation_marks import TypesettingQuotationMarks
-from proptool.checks.white_chars_before_linefeed import WhiteCharsBeforeLinefeed
 from proptool.config.config_builder import ConfigBuilder
 from proptool.prop.file import PropFile
 from .const import Const
@@ -60,21 +54,16 @@ def start() -> int:
                 Log.e(f'File not found: {reference_path}')
                 Utils.abort()
 
-            check_modules = [
-                TrailingWhiteChars,
-                WhiteCharsBeforeLinefeed,
-                KeyFormat,
-                Brackets,
-                QuotationMarks,
-                TypesettingQuotationMarks,
-            ]
-            for validator in check_modules:
+            for validator_cls, validator_config in config.checks:
                 # Almost any check validates translation against reference file, so we cannot use all checks here,
                 # but there are some that process single file independently so they in fact do not need any reference
                 # file. For them we pass our base file as translation which will do the trick.
                 #
-                # Each validator gets copy of the files, to prevent any potential destructive operation.
-                reference_propfile.report.add((validator(config)).check(copy.copy(reference_propfile)))
+                if validator_cls.is_single_file_check:
+                    # Each validator gets copy of the files, to prevent any potential destructive operation.
+                    propfile_copy = copy.copy(reference_propfile)
+                    validator = validator_cls(config)
+                    reference_propfile.report.add(validator.check(propfile_copy))
 
             if not reference_propfile.report.empty():
                 # There's something to fix, but not necessary critical.
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 69fe1e8c..9b4b6c1f 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -12,18 +12,6 @@
 from pathlib import Path
 from typing import List, Union
 
-from proptool.checks.brackets import Brackets
-from proptool.checks.dangling_keys import DanglingKeys
-from proptool.checks.empty_translations import EmptyTranslations
-from proptool.checks.formatting_values import FormattingValues
-from proptool.checks.key_format import KeyFormat
-from proptool.checks.missing_translation import MissingTranslation
-from proptool.checks.punctuation import Punctuation
-from proptool.checks.quotation_marks import QuotationMarks
-from proptool.checks.starts_with_the_same_case import StartsWithTheSameCase
-from proptool.checks.trailing_white_chars import TrailingWhiteChars
-from proptool.checks.typesetting_quotation_marks import TypesettingQuotationMarks
-from proptool.checks.white_chars_before_linefeed import WhiteCharsBeforeLinefeed
 from proptool.config.config import Config
 from proptool.log import Log
 from proptool.prop.items import Blank, Comment, PropItem, Translation
@@ -149,23 +137,10 @@ def is_valid(self, reference_file: 'PropFile') -> bool:
         :param reference_file:
         :return: True if file is valid, False if there were errors.
         """
-        checks = [
-            MissingTranslation,
-            DanglingKeys,
-            TrailingWhiteChars,
-            Punctuation,
-            StartsWithTheSameCase,
-            EmptyTranslations,
-            WhiteCharsBeforeLinefeed,
-            KeyFormat,
-            Brackets,
-            QuotationMarks,
-            TypesettingQuotationMarks,
-            FormattingValues,
-        ]
-        for validator in checks:
+        for validator_cls, validator_cfg in self.config.checks:
+            validator = validator_cls(self.config)
             # Each validator gets copy of the files, to prevent any potential destructive operation.
-            self.report.add((validator(self.config)).check(copy.copy(reference_file), copy.copy(self)))
+            self.report.add(validator.check(copy.copy(reference_file), copy.copy(self)))
 
         return self.report.empty()
 

From b56fd2dc48423126bd750311312d81db140c4619 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Fri, 30 Jul 2021 11:45:57 +0200
Subject: [PATCH 103/140] ConfigBuilder now expects default config to be
 provided.

---
 proptool/config/config_builder.py | 15 ++++++---------
 proptool/main.py                  |  4 +++-
 2 files changed, 9 insertions(+), 10 deletions(-)

diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 39b873a3..603150fc 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -32,10 +32,7 @@ class ConfigBuilder(object):
     ]
 
     @staticmethod
-    def build():
-        # get default config
-        config = Config()
-
+    def build(config_defaults: Config) -> Config:
         # Set default configuration options for each checker.
         check_dir = Path(proptool.checks.__file__).parent
         check_modules = [file for file in listdir(check_dir) if file[:2] != '__' and (check_dir / file).is_file()]
@@ -43,21 +40,21 @@ def build():
             module = importlib.import_module(f'.{check_file_name[:-3]}', proptool.checks.__name__)
             for _, obj in inspect.getmembers(module, inspect.isclass):
                 if issubclass(obj, Check) and obj.__name__ != Check.__name__:
-                    config.checks[obj.__name__] = obj.get_default_config(obj)
+                    config_defaults.checks[obj.__name__] = obj.get_default_config(obj)
 
         # Handler CLI args so we can see if there's config file to load
         args = ConfigBuilder._parse_args()
         if args.config_file:
             config_file = Path(args.config_file[0])
             # override with loaded user config file
-            config = ConfigReader().read(config, config_file)
+            config_defaults = ConfigReader().read(config_defaults, config_file)
 
         # override with command line arguments
-        ConfigBuilder._set_from_args(config, args)
+        ConfigBuilder._set_from_args(config_defaults, args)
 
-        ConfigBuilder._validate_config(config)
+        ConfigBuilder._validate_config(config_defaults)
 
-        return config
+        return config_defaults
 
     @staticmethod
     def _abort(msg: str) -> None:
diff --git a/proptool/main.py b/proptool/main.py
index ec6e3e80..a6d2063b 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -11,6 +11,7 @@
 import sys
 from pathlib import Path
 
+from proptool.config.config import Config
 from proptool.config.config_builder import ConfigBuilder
 from proptool.prop.file import PropFile
 from .const import Const
@@ -30,7 +31,8 @@ def start() -> int:
             Log.banner(Const.APP_DESCRIPTION)
             return 0
 
-        config = ConfigBuilder.build()
+        config_defaults = Config()
+        config = ConfigBuilder.build(config_defaults)
         Log.configure(config)
 
         errors = 0

From 9780893178b6d8e7b2f18e29c13dd2e255a115c4 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Fri, 30 Jul 2021 11:46:25 +0200
Subject: [PATCH 104/140] Lint fixes

---
 .flake8                             | 2 ++
 proptool/checks/brackets.py         | 1 -
 tests/checks/test_punctuation.py    | 2 +-
 tests/config/test_config_builder.py | 7 ++++---
 4 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/.flake8 b/.flake8
index 9836b95d..bad7f0f9 100644
--- a/.flake8
+++ b/.flake8
@@ -9,6 +9,8 @@
 # Refactoring hints:
 # https://flake8.codes/wemake-python-styleguide/0.15.3/index.html
 
+# https://pypi.org/project/flake8-noqa/
+noqa-require-code
 max-line-length = 132
 
 exclude =
diff --git a/proptool/checks/brackets.py b/proptool/checks/brackets.py
index b55e4180..5607f6ff 100644
--- a/proptool/checks/brackets.py
+++ b/proptool/checks/brackets.py
@@ -32,7 +32,6 @@ class Brackets(Check):
 
     _is_single_file_check = True
 
-
     report_title = 'Brackets'
 
     @overrides(Check)
diff --git a/tests/checks/test_punctuation.py b/tests/checks/test_punctuation.py
index 0524d7da..497e74a8 100644
--- a/tests/checks/test_punctuation.py
+++ b/tests/checks/test_punctuation.py
@@ -7,7 +7,7 @@
 #
 """
 import random
-from typing import Dict, Union
+from typing import Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.punctuation import Punctuation
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index b48ad7c7..107ac689 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -375,7 +375,8 @@ def test_parse_args_returns_all_keys(self) -> None:
         config = Config()
 
         # Pass no args for parsing (this is legit as we have config file that can provide what's needed).
-        sys.argv[1:] = []
+
+        sys.argv[1:] = []  # noqa: WPS362
         args = ConfigBuilder._parse_args()
         for key in config.__dict__:
             self.assertIn(key, args)
@@ -388,8 +389,8 @@ def test_parse_args_returns_no_more_keys(self) -> None:
         config = Config()
 
         # Pass no args for parsing (this is legit as we have config file that can provide what's needed).
-        sys.argv[1:] = []
-        args = vars(ConfigBuilder._parse_args())
+        sys.argv[1:] = []  # noqa: WPS362
+        args = vars(ConfigBuilder._parse_args())  # noqa: WPS421
 
         # Eliminate --no-<KEY> related keys first as these are not mapped directly.
         for pair_key in ConfigBuilder._on_off_pairs:

From 83985a76bd1e12dbefd4935b01d9e69635e882e2 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Fri, 30 Jul 2021 12:38:18 +0200
Subject: [PATCH 105/140] Removed global --strict mode and moved to chckers'
 settings

---
 config.ini                                | 21 ++++++++-------------
 proptool/checks/empty_translations.py     |  7 +++++++
 proptool/checks/missing_translation.py    | 11 ++++++++++-
 proptool/config/config.py                 |  1 -
 proptool/config/config_builder.py         |  6 ------
 tests/checks/test_missing_translations.py |  4 ++--
 tests/config/test_config_builder.py       |  2 --
 7 files changed, 27 insertions(+), 25 deletions(-)

diff --git a/config.ini b/config.ini
index 72ad3f2d..e60ae3ea 100644
--- a/config.ini
+++ b/config.ini
@@ -9,7 +9,6 @@ log_level = 1
 debug = false
 fatal = false
 color = true
-strict = false
 
 [Brackets]
 # Keep matching elements at the same positions
@@ -17,37 +16,33 @@ opening = ['(', '[', '<', '{']
 closing = [')', ']', '>', '}']
 
 [DanglingKeys]
-# strict = true
+# No config options.
 
 [EmptyTranslations]
-# strict = true
+strict = false
 
 [FormattingValues]
-# strict = true
+# No config options.
 
 [KeyFormat]
-# strict = true
 pattern = "^[a-z]+[a-zA-Z0-9_.]*[a-zA-Z0-9]+$"
 
 [MissingTranslation]
-# strict = true
+strict = false
 
 [Punctuation]
-# strict = true
 chars = ['.', '?', '!', ':', r'\n']
 
 [QuotationMarks]
-# strict = true
+# No config options.
 
 [StartsWithTheSameCase]
-# strict = true
+# No config options.
 
 [TrailingWhiteChars]
-# strict = true
+# No config options.
 
 [TypesettingQuotationMarks]
-# strict = true
-
 # Keep matching elements at the same positions
 # List based on:
 # * https://www.overleaf.com/learn/latex/Typesetting_quotations#Reference_guide
@@ -57,4 +52,4 @@ opening = ['‘', '«', '„', '「', '《']
 closing = ['’', '»', '“', '」', '》']
 
 [WhiteCharsBeforeLinefeed]
-# strict = true
+# No config options.
diff --git a/proptool/checks/empty_translations.py b/proptool/checks/empty_translations.py
index c7252098..22e692c6 100644
--- a/proptool/checks/empty_translations.py
+++ b/proptool/checks/empty_translations.py
@@ -7,6 +7,7 @@
 #
 """
 
+from typing import Dict
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Translation
 from proptool.report.group import ReportGroup
@@ -50,3 +51,9 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
             report.warn(idx + 1, 'Empty string.', item.key)
 
         return report
+
+    @overrides(Check)
+    def get_default_config(self) -> Dict:
+        return {
+            'strict': False,
+        }
diff --git a/proptool/checks/missing_translation.py b/proptool/checks/missing_translation.py
index d44036c2..9b7138ae 100644
--- a/proptool/checks/missing_translation.py
+++ b/proptool/checks/missing_translation.py
@@ -7,6 +7,7 @@
 #
 """
 
+from typing import Dict
 from proptool.decorators.overrides import overrides
 from proptool.report.group import ReportGroup
 from .base.check import Check
@@ -27,6 +28,8 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
 
         report = ReportGroup('Missing keys')
 
+        checker_config = self.config.get_checker_config(self.__class__.__name__)
+
         translation_keys = translation_file.keys.copy()
         missing_keys: List[str] = []
         for ref_key in reference_file.keys:
@@ -37,7 +40,7 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
 
         # Commented out keys are also considered present in the translation unless
         # we run in strict check mode.
-        if not self.config.strict:
+        if not checker_config['strict']:
             commented_out_keys = translation_file.commented_out_keys.copy()
             for comm_key in commented_out_keys:
                 if comm_key in missing_keys:
@@ -47,3 +50,9 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
             report.warn(None, missing_key)
 
         return report
+
+    @overrides(Check)
+    def get_default_config(self) -> Dict:
+        return {
+            'strict': False,
+        }
diff --git a/proptool/config/config.py b/proptool/config/config.py
index 6969a066..7c0ba6aa 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -24,7 +24,6 @@ def __init__(self):
         self.file_suffix = Config.DEFAULT_FILE_SUFFIX
 
         self.fatal = False
-        self.strict: bool = False
 
         self.debug = False
         self.color = True
diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 603150fc..0c7221e8 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -27,7 +27,6 @@ class ConfigBuilder(object):
     # List of options that can be either turned on or off.
     _on_off_pairs = [
         'fatal',
-        'strict',
         'color',
     ]
 
@@ -163,11 +162,6 @@ def _parse_args() -> argparse:
         group.add_argument('--checks', action = 'store', dest = 'checks', nargs = '+', metavar = 'CHECK_ID',
                            help = 'List of checks ID to be executed. By default all available checks are run.')
 
-        group.add_argument('-s', '--strict', action = 'store_true', dest = 'strict',
-                           help = 'Enables strict validation mode for all checks involved.')
-        group.add_argument('-ns', '--no-strict', action = 'store_true', dest = 'no_strict',
-                           help = 'Disables strict validation mode for all checks involved (default).')
-
         group.add_argument('-f', '--fatal', action = 'store_true', dest = 'fatal',
                            help = 'Enables strict mode. All warnings are treated as errors and are fatal.')
         group.add_argument('-nf', '--no-fatal', action = 'store_true', dest = 'no_fatal',
diff --git a/tests/checks/test_missing_translations.py b/tests/checks/test_missing_translations.py
index 563f1248..d10bbf7d 100644
--- a/tests/checks/test_missing_translations.py
+++ b/tests/checks/test_missing_translations.py
@@ -58,11 +58,11 @@ def test_translation_with_keys_in_comments(self) -> None:
             trans_file.append(Comment(comment))
 
         # We expect no issues in non-strict mode
-        trans_file.config.strict = False
+        trans_file.config.checks['MissingTranslation']['strict'] = False
         self.check(trans_file, ref_file)
 
         # We expect warnings in strict mode
-        trans_file.config.strict = True
+        trans_file.config.checks['MissingTranslation']['strict'] = True
         self.check(trans_file, ref_file, exp_warnings = len(remaining_keys))
 
     def test_translation_with_faults(self) -> None:
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index 107ac689..4d197918 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -207,8 +207,6 @@ def test_set_from_args(self) -> None:
         # Ensure config reflects changes from command line
         exp_fatal = self.get_expectation(config_defaults.fatal, args.fatal, args.no_fatal)
         self.assertEqual(exp_fatal, config.fatal)
-        exp_strict = self.get_expectation(config_defaults.strict, args.strict, args.no_strict)
-        self.assertEqual(exp_strict, config.strict)
         exp_color = self.get_expectation(config_defaults.color, args.color, args.no_color)
         self.assertEqual(exp_color, config.color)
 

From e65d81aad3856d305cb1f6e70dfd9411a8aa8032 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Fri, 30 Jul 2021 13:25:51 +0200
Subject: [PATCH 106/140] Isolated checker's config

---
 proptool/checks/base/check.py                    | 11 +++++------
 proptool/checks/brackets.py                      | 12 ++++++++++--
 proptool/checks/key_format.py                    |  2 +-
 proptool/checks/missing_translation.py           |  4 +---
 proptool/checks/punctuation.py                   |  2 +-
 proptool/checks/quotation_marks.py               |  2 +-
 proptool/main.py                                 |  3 +--
 proptool/prop/file.py                            |  6 +++---
 tests/checks/checks_test_case.py                 |  7 +++----
 tests/checks/test_base_check.py                  | 14 +++++---------
 tests/checks/test_brackets.py                    |  5 ++---
 tests/checks/test_dangling_keys.py               |  5 ++---
 tests/checks/test_empty_translations.py          |  5 ++---
 tests/checks/test_formatting_values.py           |  5 ++---
 tests/checks/test_key_format.py                  |  5 ++---
 tests/checks/test_missing_translations.py        |  9 ++++-----
 tests/checks/test_punctuation.py                 |  9 ++++-----
 tests/checks/test_quotation_marks.py             |  5 ++---
 tests/checks/test_starts_with_the_same_case.py   |  5 ++---
 tests/checks/test_trailing_white_chars.py        |  5 ++---
 tests/checks/test_typesetting_quotation_marks.py |  7 +++----
 21 files changed, 58 insertions(+), 70 deletions(-)

diff --git a/proptool/checks/base/check.py b/proptool/checks/base/check.py
index 877ccbf9..f0056b1b 100644
--- a/proptool/checks/base/check.py
+++ b/proptool/checks/base/check.py
@@ -10,7 +10,6 @@
 from abc import ABC, abstractmethod
 from typing import Dict, Union
 
-from proptool.config.config import Config
 from proptool.report.report import Report
 
 
@@ -18,10 +17,10 @@
 class Check(ABC):
     DEFAULT_CHECK_CONFIG = {}
 
-    def __init__(self, config: Union[Config, None] = None):
+    def __init__(self, config: Union[Dict, None] = None):
         if config is not None:
-            if not isinstance(config, Config):
-                raise ValueError(f'Configuration object must be instance of Config ("{type(config)}" given).')
+            if not isinstance(config, Dict):
+                raise ValueError(f'Configuration object must be instance of Dict ("{type(config)}" given).')
         self.config = config
 
         self.is_single_file_check = False
@@ -38,8 +37,8 @@ def need_both_files(self, translation: 'PropFile', reference: Union['PropFile',
             raise ValueError(f'Reference must be valid PropFile object ({type(reference)} given).')
 
     def need_valid_config(self) -> None:
-        if not isinstance(self.config, Config):
-            raise ValueError(f'Configuration object must be instance of Config ("{type(self.config)}" given).')
+        if not isinstance(self.config, Dict):
+            raise ValueError(f'Configuration object must be instance of Dict ("{type(self.config)}" given).')
 
     def get_default_config(self) -> Dict:
         return Check.DEFAULT_CHECK_CONFIG
diff --git a/proptool/checks/brackets.py b/proptool/checks/brackets.py
index 5607f6ff..d0deac70 100644
--- a/proptool/checks/brackets.py
+++ b/proptool/checks/brackets.py
@@ -44,8 +44,16 @@ def check(self, translation: 'PropFile', reference: 'PropFile' = None) -> Report
         if not translation.items:
             return report
 
-        opening = (self.config.get_checker_config(self.__class__.__name__))['opening']
-        closing = (self.config.get_checker_config(self.__class__.__name__))['closing']
+        opening = self.config['opening']
+        closing = self.config['closing']
+
+        opening_cnt = len(opening)
+        closing_cnt = len(closing)
+
+        if opening_cnt != closing_cnt:
+            report.error('CONFIG: Both "opening" and "closing" arrays must contain the same number of elements.')
+        if opening_cnt == 0:
+            report.warn('CONFIG: Empty "opening" and "closing" arrays.')
 
         for idx, item in enumerate(translation.items):
             # Do not try to be clever and filter() data first, because line_number values will no longer be correct.
diff --git a/proptool/checks/key_format.py b/proptool/checks/key_format.py
index 233e8129..b8208501 100644
--- a/proptool/checks/key_format.py
+++ b/proptool/checks/key_format.py
@@ -34,7 +34,7 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
         report = ReportGroup('Key naming pattern.')
 
         if translation_file.items:
-            pattern = self.config.checks['KeyFormat']['pattern']
+            pattern = self.config['pattern']
             compiled_pattern = re.compile(pattern)
 
             for line_number, item in enumerate(translation_file.items):
diff --git a/proptool/checks/missing_translation.py b/proptool/checks/missing_translation.py
index 9b7138ae..e1d88684 100644
--- a/proptool/checks/missing_translation.py
+++ b/proptool/checks/missing_translation.py
@@ -28,8 +28,6 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
 
         report = ReportGroup('Missing keys')
 
-        checker_config = self.config.get_checker_config(self.__class__.__name__)
-
         translation_keys = translation_file.keys.copy()
         missing_keys: List[str] = []
         for ref_key in reference_file.keys:
@@ -40,7 +38,7 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
 
         # Commented out keys are also considered present in the translation unless
         # we run in strict check mode.
-        if not checker_config['strict']:
+        if not self.config['strict']:
             commented_out_keys = translation_file.commented_out_keys.copy()
             for comm_key in commented_out_keys:
                 if comm_key in missing_keys:
diff --git a/proptool/checks/punctuation.py b/proptool/checks/punctuation.py
index d88062f0..1672303b 100644
--- a/proptool/checks/punctuation.py
+++ b/proptool/checks/punctuation.py
@@ -37,7 +37,7 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
             if not isinstance(item, Translation):
                 continue
 
-            for last_char in self.config.checks['Punctuation']['chars']:
+            for last_char in self.config['chars']:
                 last_char_len = len(last_char)
 
                 ref_last_char = item.value[(last_char_len * -1):]
diff --git a/proptool/checks/quotation_marks.py b/proptool/checks/quotation_marks.py
index 91fece75..bff5f867 100644
--- a/proptool/checks/quotation_marks.py
+++ b/proptool/checks/quotation_marks.py
@@ -44,7 +44,7 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
 
             stack: List[Mark] = []
             for pos, current_char in enumerate(item.value):
-                if current_char not in self.config.checks['QuotationMarks']['chars']:
+                if current_char not in self.config['chars']:
                     continue
 
                 if not stack:
diff --git a/proptool/main.py b/proptool/main.py
index a6d2063b..b02edb67 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -60,11 +60,10 @@ def start() -> int:
                 # Almost any check validates translation against reference file, so we cannot use all checks here,
                 # but there are some that process single file independently so they in fact do not need any reference
                 # file. For them we pass our base file as translation which will do the trick.
-                #
                 if validator_cls.is_single_file_check:
                     # Each validator gets copy of the files, to prevent any potential destructive operation.
                     propfile_copy = copy.copy(reference_propfile)
-                    validator = validator_cls(config)
+                    validator = validator_cls(validator_config)
                     reference_propfile.report.add(validator.check(propfile_copy))
 
             if not reference_propfile.report.empty():
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 9b4b6c1f..67b490b3 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -137,10 +137,10 @@ def is_valid(self, reference_file: 'PropFile') -> bool:
         :param reference_file:
         :return: True if file is valid, False if there were errors.
         """
-        for validator_cls, validator_cfg in self.config.checks:
-            validator = validator_cls(self.config)
+        for checker_cls, checker_config in self.config.checks:
+            checker = checker_cls(checker_config)
             # Each validator gets copy of the files, to prevent any potential destructive operation.
-            self.report.add(validator.check(copy.copy(reference_file), copy.copy(self)))
+            self.report.add(checker.check(copy.copy(self), copy.copy(reference_file)))
 
         return self.report.empty()
 
diff --git a/tests/checks/checks_test_case.py b/tests/checks/checks_test_case.py
index d7427cd1..9c3e6d3d 100644
--- a/tests/checks/checks_test_case.py
+++ b/tests/checks/checks_test_case.py
@@ -8,7 +8,7 @@
 """
 import random
 from abc import abstractmethod
-from typing import List, Union
+from typing import Dict, List, Union
 
 from proptool.checks.base.check import Check
 from proptool.config.config import Config
@@ -25,12 +25,11 @@ def setUp(self) -> None:
         checker = self.get_checker(None)
         if not issubclass(type(checker), Check):
             raise ValueError('Checker must be subclass of Check')
-        self.config.set_checker_config(checker.__class__.__name__, self.get_checker().get_default_config())
-        checker.config = self.config
+        checker.config = self.get_checker().get_default_config()
         self.checker = checker
 
     @abstractmethod
-    def get_checker(self, config: Union[Config, None] = None) -> Check:
+    def get_checker(self, config: Union[Dict, None] = None) -> Check:
         raise NotImplementedError
 
     def check_single_file(self, entry: PropItem, exp_errors: int = 0, exp_warnings: int = 0) -> None:
diff --git a/tests/checks/test_base_check.py b/tests/checks/test_base_check.py
index e313fd75..a40afd97 100644
--- a/tests/checks/test_base_check.py
+++ b/tests/checks/test_base_check.py
@@ -29,13 +29,12 @@ def test_constructor(self) -> None:
             Check(False)
 
     def test_need_both_files_no_fault(self) -> None:
-        config = Config()
-
         # Check is abstract class, extending ABC meta, so ordinary
         # instantiation won't work.
         Check.__abstractmethods__ = frozenset()
-        check = Check(config)
+        check = Check({})
 
+        config = Config()
         prop = PropFile(config)
         check.need_both_files(prop, prop)
 
@@ -43,22 +42,19 @@ def test_check(self) -> None:
         """
         Ensures there's no default implementation of check()
         """
-        config = Config()
-
         # Check is abstract class, extending ABC meta, so ordinary
         # instantiation won't work.
         Check.__abstractmethods__ = frozenset()
-        check = Check(config)
+        check = Check({})
 
         with self.assertRaises(NotImplementedError):
             check.check(None, None)
 
     def test_need_valid_config_valid_arg(self) -> None:
-        config = Config()
         # Check is abstract class, extending ABC meta, so ordinary
         # instantiation won't work.
         Check.__abstractmethods__ = frozenset()
-        check = Check(config)
+        check = Check({})
         # We expect no problems.
         check.need_valid_config()
 
@@ -87,8 +83,8 @@ def test_need_both_files_missing_file(self) -> None:
         Checks how need_both_files() is handling missing arguments.
         """
         config = Config()
-        check = Check(config)
         prop = PropFile(config)
+        check = Check({})
 
         with self.assertRaises(ValueError):
             check.need_both_files(None, None)
diff --git a/tests/checks/test_brackets.py b/tests/checks/test_brackets.py
index e5cb0945..3c42e8f4 100644
--- a/tests/checks/test_brackets.py
+++ b/tests/checks/test_brackets.py
@@ -6,10 +6,9 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
-from typing import Union
+from typing import Dict, Union
 
 from proptool.checks.brackets import Brackets
-from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Blank, Comment, Translation
 from tests.checks.checks_test_case import ChecksTestCase
@@ -18,7 +17,7 @@
 class ChecksBrackets(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Union[Config, None] = None) -> Brackets:
+    def get_checker(self, config: Union[Dict, None] = None) -> Brackets:
         return Brackets(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_dangling_keys.py b/tests/checks/test_dangling_keys.py
index 98a4bb01..0d47e731 100644
--- a/tests/checks/test_dangling_keys.py
+++ b/tests/checks/test_dangling_keys.py
@@ -7,11 +7,10 @@
 #
 """
 import random
-from typing import Union
+from typing import Dict, Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.dangling_keys import DanglingKeys
-from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from tests.checks.checks_test_case import ChecksTestCase
 
@@ -19,7 +18,7 @@
 class TestDanglingKeys(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Union[Config, None] = None) -> Check:
+    def get_checker(self, config: Union[Dict, None] = None) -> Check:
         return DanglingKeys(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_empty_translations.py b/tests/checks/test_empty_translations.py
index 21a1c7b7..1fc87737 100644
--- a/tests/checks/test_empty_translations.py
+++ b/tests/checks/test_empty_translations.py
@@ -7,11 +7,10 @@
 #
 """
 import random
-from typing import Union
+from typing import Dict, Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.empty_translations import EmptyTranslations
-from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Translation
 from tests.checks.checks_test_case import ChecksTestCase
@@ -20,7 +19,7 @@
 class TestEmptyTranslations(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Union[Config, None] = None) -> Check:
+    def get_checker(self, config: Union[Dict, None] = None) -> Check:
         return EmptyTranslations(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_formatting_values.py b/tests/checks/test_formatting_values.py
index b9449c1f..4970647e 100644
--- a/tests/checks/test_formatting_values.py
+++ b/tests/checks/test_formatting_values.py
@@ -6,11 +6,10 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
-from typing import Union
+from typing import Dict, Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.formatting_values import FormattingValues
-from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.file import PropFile
 from proptool.prop.items import Translation
@@ -20,7 +19,7 @@
 class TestFormattingValues(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Union[Config, None] = None) -> Check:
+    def get_checker(self, config: Union[Dict, None] = None) -> Check:
         return FormattingValues(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_key_format.py b/tests/checks/test_key_format.py
index ed4412a6..2a8ab8db 100644
--- a/tests/checks/test_key_format.py
+++ b/tests/checks/test_key_format.py
@@ -6,11 +6,10 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
-from typing import Union
+from typing import Dict, Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.key_format import KeyFormat
-from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Translation
 from tests.checks.checks_test_case import ChecksTestCase
@@ -19,7 +18,7 @@
 class TestKeyFormat(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Union[Config, None] = None) -> Check:
+    def get_checker(self, config: Union[Dict, None] = None) -> Check:
         return KeyFormat(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_missing_translations.py b/tests/checks/test_missing_translations.py
index d10bbf7d..7780987b 100644
--- a/tests/checks/test_missing_translations.py
+++ b/tests/checks/test_missing_translations.py
@@ -7,11 +7,10 @@
 #
 """
 import random
-from typing import Union
+from typing import Dict, Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.missing_translation import MissingTranslation
-from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Comment
 from tests.checks.checks_test_case import ChecksTestCase
@@ -20,7 +19,7 @@
 class TestMissingTranslations(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Union[Config, None] = None) -> Check:
+    def get_checker(self, config: Union[Dict, None] = None) -> Check:
         return MissingTranslation(config)
 
     # #################################################################################################
@@ -58,11 +57,11 @@ def test_translation_with_keys_in_comments(self) -> None:
             trans_file.append(Comment(comment))
 
         # We expect no issues in non-strict mode
-        trans_file.config.checks['MissingTranslation']['strict'] = False
+        self.checker.config['strict'] = False
         self.check(trans_file, ref_file)
 
         # We expect warnings in strict mode
-        trans_file.config.checks['MissingTranslation']['strict'] = True
+        self.checker.config['strict'] = True
         self.check(trans_file, ref_file, exp_warnings = len(remaining_keys))
 
     def test_translation_with_faults(self) -> None:
diff --git a/tests/checks/test_punctuation.py b/tests/checks/test_punctuation.py
index 497e74a8..60528263 100644
--- a/tests/checks/test_punctuation.py
+++ b/tests/checks/test_punctuation.py
@@ -7,11 +7,10 @@
 #
 """
 import random
-from typing import Union
+from typing import Dict, Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.punctuation import Punctuation
-from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.file import PropFile
 from proptool.prop.items import Translation
@@ -21,7 +20,7 @@
 class TestPunctuation(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Union[Config, None] = None) -> Check:
+    def get_checker(self, config: Union[Dict, None] = None) -> Check:
         return Punctuation(config)
 
     # #################################################################################################
@@ -32,7 +31,7 @@ def test_no_faults(self) -> None:
         cnt_max = 40
         keys = [self.get_random_string('key_') for _ in range(random.randint(cnt_min, cnt_max))]
 
-        marks = (self.config.get_checker_config('Punctuation'))['chars']
+        marks = self.checker.config['chars']
         punct_idx = 0
 
         ref_file = PropFile(self.config)
@@ -51,7 +50,7 @@ def test_with_faults(self) -> None:
         cnt_max = 40
         keys = [self.get_random_string('key_') for _ in range(random.randint(cnt_min, cnt_max))]
 
-        marks = (self.config.get_checker_config('Punctuation'))['chars']
+        marks = self.checker.config['chars']
         punct_idx = 0
 
         expected_faults = 0
diff --git a/tests/checks/test_quotation_marks.py b/tests/checks/test_quotation_marks.py
index 3255872d..c9cfbd22 100644
--- a/tests/checks/test_quotation_marks.py
+++ b/tests/checks/test_quotation_marks.py
@@ -6,11 +6,10 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
-from typing import Union
+from typing import Dict, Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.quotation_marks import QuotationMarks
-from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Blank, Comment, Translation
 from tests.checks.checks_test_case import ChecksTestCase
@@ -19,7 +18,7 @@
 class TestQuotationMarks(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Union[Config, None] = None) -> Check:
+    def get_checker(self, config: Union[Dict, None] = None) -> Check:
         return QuotationMarks(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_starts_with_the_same_case.py b/tests/checks/test_starts_with_the_same_case.py
index 5df1f027..7cee370e 100644
--- a/tests/checks/test_starts_with_the_same_case.py
+++ b/tests/checks/test_starts_with_the_same_case.py
@@ -7,11 +7,10 @@
 #
 """
 import random
-from typing import Union
+from typing import Dict, Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.starts_with_the_same_case import StartsWithTheSameCase
-from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.file import PropFile
 from proptool.prop.items import Translation
@@ -22,7 +21,7 @@
 class TestStartsWithTheSameCase(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Union[Config, None] = None) -> Check:
+    def get_checker(self, config: Union[Dict, None] = None) -> Check:
         return StartsWithTheSameCase(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_trailing_white_chars.py b/tests/checks/test_trailing_white_chars.py
index 9455c38f..13dfb283 100644
--- a/tests/checks/test_trailing_white_chars.py
+++ b/tests/checks/test_trailing_white_chars.py
@@ -6,11 +6,10 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
-from typing import Union
+from typing import Dict, Union
 
 from proptool.checks.base.check import Check
 from proptool.checks.trailing_white_chars import TrailingWhiteChars
-from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Comment, Translation
 from tests.checks.checks_test_case import ChecksTestCase
@@ -19,7 +18,7 @@
 class TestTrailingWhiteChars(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Union[Config, None] = None) -> Check:
+    def get_checker(self, config: Union[Dict, None] = None) -> Check:
         return TrailingWhiteChars(config)
 
     # #################################################################################################
diff --git a/tests/checks/test_typesetting_quotation_marks.py b/tests/checks/test_typesetting_quotation_marks.py
index 2d352d75..541636c0 100644
--- a/tests/checks/test_typesetting_quotation_marks.py
+++ b/tests/checks/test_typesetting_quotation_marks.py
@@ -6,10 +6,9 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
-from typing import Union
+from typing import Dict, Union
 
 from proptool.checks.typesetting_quotation_marks import TypesettingQuotationMarks
-from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Blank, Comment, Translation
 from tests.checks.checks_test_case import ChecksTestCase
@@ -18,7 +17,7 @@
 class ChecksBrackets(ChecksTestCase):
 
     @overrides(ChecksTestCase)
-    def get_checker(self, config: Union[Config, None] = None) -> TypesettingQuotationMarks:
+    def get_checker(self, config: Union[Dict, None] = None) -> TypesettingQuotationMarks:
         return TypesettingQuotationMarks(config)
 
     # #################################################################################################
@@ -54,7 +53,7 @@ def test_opening_and_closing_lists(self) -> None:
         """
         Checks if lists defining opening and closing markers are sane.
         """
-        checker: TypesettingQuotationMarks = self.get_checker(self.config)
+        checker: TypesettingQuotationMarks = self.get_checker()
 
         self.assertEqual(len(checker.opening), len(checker.closing))
         self.assertNotEqual([], checker.opening)

From bfa27984c12900e07c97ede09baebb90eb7bbb2d Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Fri, 30 Jul 2021 15:25:02 +0200
Subject: [PATCH 107/140] Simplified handling of checkers

---
 proptool/config/checker_info.py   | 16 +++++++++++
 proptool/config/config.py         |  6 +++--
 proptool/config/config_builder.py | 45 ++++++++++++++++++++++---------
 proptool/main.py                  |  8 +++---
 proptool/prop/file.py             |  6 +++--
 5 files changed, 60 insertions(+), 21 deletions(-)
 create mode 100644 proptool/config/checker_info.py

diff --git a/proptool/config/checker_info.py b/proptool/config/checker_info.py
new file mode 100644
index 00000000..7687e049
--- /dev/null
+++ b/proptool/config/checker_info.py
@@ -0,0 +1,16 @@
+"""
+# prop-tool
+# Java *.properties file sync checker and syncing tool.
+#
+# Copyright ©2021 Marcin Orlowski <mail [@] MarcinOrlowski.com>
+# https://github.com/MarcinOrlowski/prop-tool/
+#
+"""
+from typing import Callable, Dict, Union
+
+
+class CheckerInfo(object):
+    def __init__(self, id: str, cls: Callable, config: Union[Dict, None] = None):
+        self.id = id
+        self.cls = cls
+        self.config = config
diff --git a/proptool/config/config.py b/proptool/config/config.py
index 7c0ba6aa..670ae05b 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -8,6 +8,8 @@
 """
 from typing import Dict, List
 
+from proptool.config.checker_info import CheckerInfo
+
 
 class Config(object):
     VERSION = 1
@@ -40,8 +42,8 @@ def __init__(self):
         self.comment_marker: str = '#'
         self.comment_template: str = Config.DEFAULT_COMMENT_TEMPLATE
 
-        self.checks = {
-            # empty set
+        self.checks : List[CheckerInfo] = {
+            # empty set. Populated and manipulated by ConfigBuilder
         }
 
     def set_checker_config(self, checker_id: str, config: Dict) -> None:
diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 0c7221e8..200ffbf2 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -8,14 +8,22 @@
 """
 
 import argparse
-import importlib
-import inspect
-from os import listdir
 from pathlib import Path
 from typing import List, Union
 
-import proptool.checks
-from proptool.checks.base.check import Check
+from proptool.checks.brackets import Brackets
+from proptool.checks.dangling_keys import DanglingKeys
+from proptool.checks.empty_translations import EmptyTranslations
+from proptool.checks.formatting_values import FormattingValues
+from proptool.checks.key_format import KeyFormat
+from proptool.checks.missing_translation import MissingTranslation
+from proptool.checks.punctuation import Punctuation
+from proptool.checks.quotation_marks import QuotationMarks
+from proptool.checks.starts_with_the_same_case import StartsWithTheSameCase
+from proptool.checks.trailing_white_chars import TrailingWhiteChars
+from proptool.checks.typesetting_quotation_marks import TypesettingQuotationMarks
+from proptool.checks.white_chars_before_linefeed import WhiteCharsBeforeLinefeed
+from proptool.config.checker_info import CheckerInfo
 from proptool.config.config import Config
 from proptool.config.config_reader import ConfigReader
 from proptool.const import Const
@@ -32,14 +40,25 @@ class ConfigBuilder(object):
 
     @staticmethod
     def build(config_defaults: Config) -> Config:
-        # Set default configuration options for each checker.
-        check_dir = Path(proptool.checks.__file__).parent
-        check_modules = [file for file in listdir(check_dir) if file[:2] != '__' and (check_dir / file).is_file()]
-        for check_file_name in check_modules:
-            module = importlib.import_module(f'.{check_file_name[:-3]}', proptool.checks.__name__)
-            for _, obj in inspect.getmembers(module, inspect.isclass):
-                if issubclass(obj, Check) and obj.__name__ != Check.__name__:
-                    config_defaults.checks[obj.__name__] = obj.get_default_config(obj)
+
+        checkers = [
+            Brackets,
+            DanglingKeys,
+            EmptyTranslations,
+            FormattingValues,
+            KeyFormat,
+            MissingTranslation,
+            Punctuation,
+            QuotationMarks,
+            StartsWithTheSameCase,
+            TrailingWhiteChars,
+            TypesettingQuotationMarks,
+            WhiteCharsBeforeLinefeed,
+        ]
+
+        for checker in checkers:
+            id = checker.__name__
+            config_defaults.checks[id] = CheckerInfo(id, checker, (checker()).get_default_config())
 
         # Handler CLI args so we can see if there's config file to load
         args = ConfigBuilder._parse_args()
diff --git a/proptool/main.py b/proptool/main.py
index b02edb67..24e351fb 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -56,15 +56,15 @@ def start() -> int:
                 Log.e(f'File not found: {reference_path}')
                 Utils.abort()
 
-            for validator_cls, validator_config in config.checks:
+            for checker_id, checker_info in config.checks.items():
                 # Almost any check validates translation against reference file, so we cannot use all checks here,
                 # but there are some that process single file independently so they in fact do not need any reference
                 # file. For them we pass our base file as translation which will do the trick.
-                if validator_cls.is_single_file_check:
+                checker = checker_info.cls(checker_info.config)
+                if checker.is_single_file_check:
                     # Each validator gets copy of the files, to prevent any potential destructive operation.
                     propfile_copy = copy.copy(reference_propfile)
-                    validator = validator_cls(validator_config)
-                    reference_propfile.report.add(validator.check(propfile_copy))
+                    reference_propfile.report.add(checker.check(propfile_copy))
 
             if not reference_propfile.report.empty():
                 # There's something to fix, but not necessary critical.
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 67b490b3..dfe73db5 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -41,6 +41,8 @@ def __init__(self, config: Config, language: str = None):
         self.separator: str = config.separator
         self.report: Report = Report(config)
 
+        self.language = language
+
         # This call is most likely redundant here.
         self.init_container(language)
 
@@ -137,8 +139,8 @@ def is_valid(self, reference_file: 'PropFile') -> bool:
         :param reference_file:
         :return: True if file is valid, False if there were errors.
         """
-        for checker_cls, checker_config in self.config.checks:
-            checker = checker_cls(checker_config)
+        for checker_id, checker_info in self.config.checks.items():
+            checker = checker_info.cls(checker_info.config)
             # Each validator gets copy of the files, to prevent any potential destructive operation.
             self.report.add(checker.check(copy.copy(self), copy.copy(reference_file)))
 

From 4a6768432d13d755b2f5ecc746175df6ed0f6ac8 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Fri, 30 Jul 2021 17:33:04 +0200
Subject: [PATCH 108/140] Fixed handlong of 'color' config attr in Log

---
 proptool/log.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/proptool/log.py b/proptool/log.py
index acc1896e..fb5c7637 100644
--- a/proptool/log.py
+++ b/proptool/log.py
@@ -345,7 +345,7 @@ def _format_log_line(message = None, color: Union[str, None] = None, stacktrace_
             if stacktrace_postfix is not None:
                 message += stacktrace_postfix
 
-            if Log.color:
+            if not Log.color:
                 message = Ansi.strip(message)
 
         return message

From c08ab652aa9e092667c46fee470900a27349581b Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Fri, 30 Jul 2021 19:25:13 +0200
Subject: [PATCH 109/140] Added general main exception handler

---
 proptool/main.py                       | 155 ++++++++++++++-----------
 proptool/prop/file.py                  |  57 ++++++---
 proptool/prop/items.py                 |  15 ++-
 tests/checks/test_formatting_values.py |   2 +-
 4 files changed, 138 insertions(+), 91 deletions(-)

diff --git a/proptool/main.py b/proptool/main.py
index 24e351fb..d5dfca79 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -8,6 +8,7 @@
 """
 
 import copy
+import linecache
 import sys
 from pathlib import Path
 
@@ -26,75 +27,89 @@ class PropTool(object):
 
     @staticmethod
     def start() -> int:
-        # Cannot rely on argparse here as we have required arguments there.
-        if '--version' in sys.argv:
-            Log.banner(Const.APP_DESCRIPTION)
-            return 0
-
-        config_defaults = Config()
-        config = ConfigBuilder.build(config_defaults)
-        Log.configure(config)
-
-        errors = 0
-        for file_str in config.files:
-            reference_path = Path(file_str)
-
-            tmp = Path(reference_path).name.split('.')
-            if len(tmp) != 2:
-                Log.e('Base filename format invalid. Must be "prefix.suffix".')
-                Utils.abort()
-            name_prefix = tmp[0]
-            name_suffix = tmp[1]
-
-            # Main push
-            Log.push(f'Base: {reference_path}')
-
-            reference_propfile = PropFile(config)
-            try:
-                reference_propfile.load(reference_path)
-            except FileNotFoundError:
-                Log.e(f'File not found: {reference_path}')
-                Utils.abort()
-
-            for checker_id, checker_info in config.checks.items():
-                # Almost any check validates translation against reference file, so we cannot use all checks here,
-                # but there are some that process single file independently so they in fact do not need any reference
-                # file. For them we pass our base file as translation which will do the trick.
-                checker = checker_info.cls(checker_info.config)
-                if checker.is_single_file_check:
-                    # Each validator gets copy of the files, to prevent any potential destructive operation.
-                    propfile_copy = copy.copy(reference_propfile)
-                    reference_propfile.report.add(checker.check(propfile_copy))
-
-            if not reference_propfile.report.empty():
-                # There's something to fix, but not necessary critical.
-                reference_propfile.report.dump()
-
-            # No reference files errors. Warnings are just fine, though.
-            if not reference_propfile.report.is_fatal():
-                for lang in config.languages:
-                    translation_path = Path(reference_path.parent / f'{name_prefix}_{lang}.{name_suffix}')
-                    translation_propfile = PropFile(config)
-
-                    try:
-                        translation_propfile.load(translation_path, lang)
-                        trans_level_label = f'{lang.upper()}: {translation_path}'
-                        Log.push(trans_level_label, deferred = True)
-
-                        if not translation_propfile.is_valid(reference_propfile):
-                            translation_propfile.report.dump()
-                            errors += 1
-                            if config.update:
-                                if translation_propfile.file:
-                                    translation_propfile.update(reference_propfile)
-                                    translation_propfile.save()
-
-                        if Log.pop():
-                            Log.i(f'%ok%{trans_level_label}: OK')
-                    except FileNotFoundError:
-                        Log.e(f'File not found: {translation_path}')
 
-        # Close main push.
-        Log.pop()
+        try:
+            # Cannot rely on argparse here as we have required arguments there.
+            if '--version' in sys.argv:
+                Log.banner(Const.APP_DESCRIPTION)
+                return 0
+
+            config_defaults = Config()
+            config = ConfigBuilder.build(config_defaults)
+            Log.configure(config)
+
+            errors = 0
+            for file_str in config.files:
+                reference_path = Path(file_str)
+
+                tmp = Path(reference_path).name.split('.')
+                if len(tmp) != 2:
+                    Log.e('Base filename format invalid. Must be "prefix.suffix".')
+                    Utils.abort()
+                name_prefix = tmp[0]
+                name_suffix = tmp[1]
+
+                # Main push
+                Log.push(f'Base: {reference_path}')
+
+                reference_propfile = PropFile(config)
+                try:
+                    reference_propfile.load(reference_path)
+                except FileNotFoundError:
+                    Log.e(f'File not found: {reference_path}')
+                    Utils.abort()
+
+                for checker_id, checker_info in config.checks.items():
+                    # Almost any check validates translation against reference file, so we cannot use all checks here,
+                    # but there are some that process single file independently so they in fact do not need any reference
+                    # file. For them we pass our base file as translation which will do the trick.
+                    checker = checker_info.cls(checker_info.config)
+                    if checker.is_single_file_check:
+                        # Each validator gets copy of the files, to prevent any potential destructive operation.
+                        propfile_copy = copy.copy(reference_propfile)
+                        reference_propfile.report.add(checker.check(propfile_copy))
+
+                if not reference_propfile.report.empty():
+                    # There's something to fix, but not necessary critical.
+                    reference_propfile.report.dump()
+
+                # No reference files errors. Warnings are just fine, though.
+                if not reference_propfile.report.is_fatal():
+                    for lang in config.languages:
+                        translation_path = Path(reference_path.parent / f'{name_prefix}_{lang}.{name_suffix}')
+                        translation_propfile = PropFile(config)
+
+                        try:
+                            translation_propfile.load(translation_path, lang)
+                            trans_level_label = f'{lang.upper()}: {translation_path}'
+                            Log.push(trans_level_label, deferred = True)
+
+                            is_translation_valid = translation_propfile.is_valid(reference_propfile)
+
+                            if not is_translation_valid:
+                                translation_propfile.report.dump()
+                                errors += 1
 
-        return 100 if errors else 0
+                            if config.update:
+                                if is_translation_valid:
+                                    if translation_propfile.file:
+                                        translation_propfile.update(reference_propfile)
+                                        translation_propfile.save()
+                                else:
+                                    Log.w('Not updating translation due to found issues')
+
+                            if Log.pop():
+                                Log.i(f'%ok%{trans_level_label}: OK')
+                        except FileNotFoundError:
+                            Log.e(f'File not found: {translation_path}')
+
+            # Close main push.
+            Log.pop()
+
+            return 100 if errors else 0
+        except Exception as ex:
+            Log.e(str(ex))
+            exc_type, exc_obj, tb = sys.exc_info()
+            f = tb.tb_frame
+            Log.e(f'Exception in {f.f_code.co_filename}:{tb.tb_lineno}')
+            return 666
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index dfe73db5..2b56bc5f 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -85,19 +85,27 @@ def find_by_key(self, key: str) -> Union[Translation, None]:
 
     # #################################################################################################
 
-    def append(self, item: PropItem):
-        if not issubclass(type(item), PropItem):
-            raise TypeError('Item must subclass PropItem.')
-
-        if isinstance(item, Translation):
-            self.keys.append(item.key)
-        elif isinstance(item, Comment):
-            # Let's look for commented out keys.
-            match = re.compile(self.comment_pattern).match(item.value)
-            if match:
-                self.commented_out_keys.append(match.group(1))
+    def append(self, items: Union[List[PropItem], PropItem]) -> None:
+        """
+        Appends given PropItem(s) to internal buffer.
 
-        self._items.append(item)
+        :param items: PropItem(s) to be added.
+        """
+        if issubclass(type(items), PropItem):
+            items = [items]
+
+        if not issubclass(type(items), list):
+            raise TypeError('Item must be either subclass of PropItem or List[PropItems]')
+
+        for single_item in items:
+            if isinstance(items, Translation):
+                self.keys.append(items.key)
+            elif isinstance(items, Comment):
+                # Let's look for commented out keys.
+                match = re.compile(self.comment_pattern).match(items.value)
+                if match:
+                    self.commented_out_keys.append(match.group(1))
+            self._items.append(items)
 
     # #################################################################################################
 
@@ -114,19 +122,32 @@ def update(self, reference_propfile: 'PropFile') -> None:
         """
 
         tmp = PropFile(self.config)
-
+        tmp.append([
+            Comment(),
+            Comment(f'Base: {reference_propfile}'),
+        ])
+        if self.language is not None:
+            tmp.append(Comment(f'Lang: {self.language}'))
+        tmp.append(Comment())
+
+        # For all items in reference file...
         for idx, item in enumerate(reference_propfile.items):
+            # Copy comments and blank lines as-is
             if isinstance(item, (Comment, Blank)):
                 tmp.append(item)
             elif isinstance(item, Translation):
+                # If we do have the translation already
                 if item.key in self.keys:
+                    # Add original string as comment if that's requested
+                    tmp.append(Comment(f'BASE: {item.value}'))
+                    # Copy our translation.
                     tmp.append(self.find_by_key(item.key))
                 else:
                     tmp.append(Comment(self.config.comment_pattern.replace('KEY', item.key)))
             else:
                 raise RuntimeError(f'Unknown entry type: {type(item)} at position {idx + 1}')
 
-        self._items = copy.deepcopy(tmp.items)
+        self._items = copy.copy(tmp.items)
         self.keys = copy.copy(tmp.keys)
         self.commented_out_keys = copy.copy(tmp.commented_out_keys)
 
@@ -161,6 +182,7 @@ def load(self, file: Path, language: str = None) -> bool:
             raise FileNotFoundError(f'File not found: {file}')
 
         self.init_container(language)
+        self.file = file
 
         with open(file, 'r') as fh:
             line_number: int = 0
@@ -209,11 +231,16 @@ def load(self, file: Path, language: str = None) -> bool:
 
     # #################################################################################################
 
-    def save(self, target_file_name: Path) -> None:
+    def save(self, target_file_name: Union[Path, None] = None) -> None:
         """
         Saves content of the propfile.
         """
 
+        if not target_file_name:
+            if not self.file:
+                raise RuntimeError('No target file name given.')
+            target_file_name = self.file
+
         Log.i(f'Saving: {target_file_name}')
         with open(target_file_name, 'w') as fh:
             for item in self.items:
diff --git a/proptool/prop/items.py b/proptool/prop/items.py
index 492d3777..f29659d6 100644
--- a/proptool/prop/items.py
+++ b/proptool/prop/items.py
@@ -10,6 +10,7 @@
 from typing import Union
 
 from proptool.decorators.overrides import overrides
+from proptool.config.config import Config
 
 
 # #################################################################################################
@@ -62,14 +63,18 @@ class Comment(PropItem):
     Class representing a line comment.
     """
 
-    def __init__(self, value: str) -> None:
+    def __init__(self, value: str = '', marker: str = '#') -> None:
+        if marker not in Config.ALLOWED_COMMENT_MARKERS:
+            raise ValueError(f'Invalid comment marker: "{marker}".')
         if not isinstance(value, str):
             raise ValueError('Value must be a string.')
         if not value:
-            raise ValueError('Value cannot be empty.')
-        marker = value[0]
-        if marker not in {'!', '#'}:
-            raise ValueError(f'Invalid comment marker: "{marker}".')
+            value = f'{marker}'
+
+        value_marker = value[0]
+        if value_marker not in Config.ALLOWED_COMMENT_MARKERS:
+            value = f'{marker} {value}'
+
         super().__init__(value)
 
     @overrides(PropItem)
diff --git a/tests/checks/test_formatting_values.py b/tests/checks/test_formatting_values.py
index 4970647e..917c7200 100644
--- a/tests/checks/test_formatting_values.py
+++ b/tests/checks/test_formatting_values.py
@@ -60,7 +60,7 @@ def test_with_faults(self) -> None:
             ref_file.append(Translation(key, test_case[0]))
             trans_file.append(Translation(key, test_case[1]))
             # This checker always return one error (if there's any fault).
-            self.check(trans_file, ref_file, exp_errors = 1)
+            self.check(trans_file, ref_file, exp_errors = 1, dump=True)
 
     # #################################################################################################
 

From e00d77ce64fb91b33f8b6e2bd24ccc631788a5d3 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Fri, 30 Jul 2021 23:22:52 +0200
Subject: [PATCH 110/140] Checkers reworked

---
 proptool/config/checker_info.py           |  6 +++---
 proptool/config/config.py                 |  2 +-
 proptool/config/config_builder.py         |  4 ++--
 proptool/main.py                          | 15 +++++++--------
 proptool/prop/file.py                     | 15 +++++++++------
 tests/checks/checks_test_case.py          | 13 ++++++++++---
 tests/checks/test_formatting_values.py    | 16 +++++++++-------
 tests/checks/test_missing_translations.py |  6 +++---
 8 files changed, 44 insertions(+), 33 deletions(-)

diff --git a/proptool/config/checker_info.py b/proptool/config/checker_info.py
index 7687e049..879efadc 100644
--- a/proptool/config/checker_info.py
+++ b/proptool/config/checker_info.py
@@ -10,7 +10,7 @@
 
 
 class CheckerInfo(object):
-    def __init__(self, id: str, cls: Callable, config: Union[Dict, None] = None):
-        self.id = id
-        self.cls = cls
+    def __init__(self, checker_id: str, checker_callable: Callable, config: Union[Dict, None] = None):
+        self.id = checker_id
+        self.callable = checker_callable
         self.config = config
diff --git a/proptool/config/config.py b/proptool/config/config.py
index 670ae05b..ada4a6b8 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -42,7 +42,7 @@ def __init__(self):
         self.comment_marker: str = '#'
         self.comment_template: str = Config.DEFAULT_COMMENT_TEMPLATE
 
-        self.checks : List[CheckerInfo] = {
+        self.checks: List[CheckerInfo] = {
             # empty set. Populated and manipulated by ConfigBuilder
         }
 
diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 200ffbf2..31e1ff79 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -57,8 +57,8 @@ def build(config_defaults: Config) -> Config:
         ]
 
         for checker in checkers:
-            id = checker.__name__
-            config_defaults.checks[id] = CheckerInfo(id, checker, (checker()).get_default_config())
+            checker_id = checker.__name__
+            config_defaults.checks[checker_id] = CheckerInfo(checker_id, checker, (checker()).get_default_config())
 
         # Handler CLI args so we can see if there's config file to load
         args = ConfigBuilder._parse_args()
diff --git a/proptool/main.py b/proptool/main.py
index d5dfca79..5e0055bf 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -8,7 +8,6 @@
 """
 
 import copy
-import linecache
 import sys
 from pathlib import Path
 
@@ -53,17 +52,17 @@ def start() -> int:
                 Log.push(f'Base: {reference_path}')
 
                 reference_propfile = PropFile(config)
-                try:
+                try:  # noqa: WPS505
                     reference_propfile.load(reference_path)
                 except FileNotFoundError:
                     Log.e(f'File not found: {reference_path}')
                     Utils.abort()
 
-                for checker_id, checker_info in config.checks.items():
+                for _, checker_info in config.checks.items():
                     # Almost any check validates translation against reference file, so we cannot use all checks here,
                     # but there are some that process single file independently so they in fact do not need any reference
                     # file. For them we pass our base file as translation which will do the trick.
-                    checker = checker_info.cls(checker_info.config)
+                    checker = checker_info.callable(checker_info.config)
                     if checker.is_single_file_check:
                         # Each validator gets copy of the files, to prevent any potential destructive operation.
                         propfile_copy = copy.copy(reference_propfile)
@@ -79,7 +78,7 @@ def start() -> int:
                         translation_path = Path(reference_path.parent / f'{name_prefix}_{lang}.{name_suffix}')
                         translation_propfile = PropFile(config)
 
-                        try:
+                        try:  # noqa: WPS505
                             translation_propfile.load(translation_path, lang)
                             trans_level_label = f'{lang.upper()}: {translation_path}'
                             Log.push(trans_level_label, deferred = True)
@@ -110,6 +109,6 @@ def start() -> int:
         except Exception as ex:
             Log.e(str(ex))
             exc_type, exc_obj, tb = sys.exc_info()
-            f = tb.tb_frame
-            Log.e(f'Exception in {f.f_code.co_filename}:{tb.tb_lineno}')
-            return 666
+            frame = tb.tb_frame
+            Log.e(f'Exception in {frame.f_code.co_filename}:{tb.tb_lineno}')
+            return 666  # noqa: WPS432
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 2b56bc5f..0ff8f350 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -98,6 +98,9 @@ def append(self, items: Union[List[PropItem], PropItem]) -> None:
             raise TypeError('Item must be either subclass of PropItem or List[PropItems]')
 
         for single_item in items:
+            if not issubclass(type(single_item), PropItem):
+                raise TypeError(f'Item must be of PropItem, {type(single_item)} given.')
+
             if isinstance(items, Translation):
                 self.keys.append(items.key)
             elif isinstance(items, Comment):
@@ -105,7 +108,7 @@ def append(self, items: Union[List[PropItem], PropItem]) -> None:
                 match = re.compile(self.comment_pattern).match(items.value)
                 if match:
                     self.commented_out_keys.append(match.group(1))
-            self._items.append(items)
+            self._items.append(single_item)
 
     # #################################################################################################
 
@@ -147,9 +150,9 @@ def update(self, reference_propfile: 'PropFile') -> None:
             else:
                 raise RuntimeError(f'Unknown entry type: {type(item)} at position {idx + 1}')
 
-        self._items = copy.copy(tmp.items)
-        self.keys = copy.copy(tmp.keys)
-        self.commented_out_keys = copy.copy(tmp.commented_out_keys)
+        self._items = tmp.items
+        self.keys = tmp.keys
+        self.commented_out_keys = tmp.commented_out_keys
 
     # #################################################################################################
 
@@ -160,8 +163,8 @@ def is_valid(self, reference_file: 'PropFile') -> bool:
         :param reference_file:
         :return: True if file is valid, False if there were errors.
         """
-        for checker_id, checker_info in self.config.checks.items():
-            checker = checker_info.cls(checker_info.config)
+        for _, checker_info in self.config.checks.items():
+            checker = checker_info.callable(checker_info.config)
             # Each validator gets copy of the files, to prevent any potential destructive operation.
             self.report.add(checker.check(copy.copy(self), copy.copy(reference_file)))
 
diff --git a/tests/checks/checks_test_case.py b/tests/checks/checks_test_case.py
index 9c3e6d3d..df34a1d8 100644
--- a/tests/checks/checks_test_case.py
+++ b/tests/checks/checks_test_case.py
@@ -40,13 +40,20 @@ def check_single_file(self, entry: PropItem, exp_errors: int = 0, exp_warnings:
         self.check(prop_file, exp_errors = exp_errors, exp_warnings = exp_warnings)
 
     def check(self, translation: PropFile, reference: Union[PropFile, None] = None,
-              exp_errors: int = 0, exp_warnings: int = 0, dump = False) -> None:
+              exp_errors: int = 0, exp_warnings: int = 0, dump = False, msg = None) -> None:
         report = self.checker.check(translation, reference)
         if dump:
             report.dump()
 
-        self.assertEqual(exp_errors, report.errors)
-        self.assertEqual(exp_warnings, report.warnings)
+        err_msg = msg
+        warn_msg = msg
+        if exp_errors > 0:
+            err_msg = err_msg
+        if exp_warnings > 0:
+            warn_msg = err_msg
+
+        self.assertEqual(exp_errors, report.errors, err_msg)
+        self.assertEqual(exp_warnings, report.warnings, warn_msg)
 
     # #################################################################################################
 
diff --git a/tests/checks/test_formatting_values.py b/tests/checks/test_formatting_values.py
index 917c7200..6d6d82c9 100644
--- a/tests/checks/test_formatting_values.py
+++ b/tests/checks/test_formatting_values.py
@@ -40,13 +40,15 @@ def test_no_faults(self) -> None:
             self.check(trans_file, ref_file)
 
     def test_with_faults(self) -> None:
+        """
+        Tests various types of formatters count mismatch
+        """
         tests = [
-            # Tests various types of formatters count mismatch
-            ('This %s foo %s', 'This 123 %s %d llorem bar %s ipsum.'),
-            ('This %s', 'This 123 %s %d llorem bar %s ipsum.'),
-            ('%d foo', '123 %s %d llorem bar %s ipsum.'),
-            ('No formatters', 'But we have %s ome...'),
-            ('%s ome formatters', 'But we have none.'),
+            ('This %s foo %s line 1', 'This 123 %s %d llorem bar %s ipsum.'),
+            ('This %s line 2', 'This 123 %s %d llorem bar %s ipsum.'),
+            ('%d foo line 3', '123 %s %d llorem bar %s ipsum.'),
+            ('No formatters in line 4', 'But we have %s one...'),
+            ('%s one formatter in line 5', 'But we have none.'),
 
             # Count matches, but order is messed.
             ('Count matches: %s %d', 'But order differs: %d %s'),
@@ -60,7 +62,7 @@ def test_with_faults(self) -> None:
             ref_file.append(Translation(key, test_case[0]))
             trans_file.append(Translation(key, test_case[1]))
             # This checker always return one error (if there's any fault).
-            self.check(trans_file, ref_file, exp_errors = 1, dump=True)
+            self.check(trans_file, ref_file, exp_errors = 1, msg = f"'{test_case[0]}' vs. '{test_case[1]}'")
 
     # #################################################################################################
 
diff --git a/tests/checks/test_missing_translations.py b/tests/checks/test_missing_translations.py
index 7780987b..019abcc2 100644
--- a/tests/checks/test_missing_translations.py
+++ b/tests/checks/test_missing_translations.py
@@ -34,9 +34,9 @@ def test_no_faults(self) -> None:
         self.check(trans_file, ref_file)
 
     def test_translation_with_keys_in_comments(self) -> None:
-        # Checks if we have no issues reported when running
-        # in non-strict mode and having some keys in comments.
-
+        """
+        Checks if we have no issues reported when running in non-strict mode and having some keys in comments.
+        """
         # generate some keys for reference file
         cnt_min = 20
         cnt_max = 40

From 03ad0cdb27bddf1258eee5a29fc83354119e48b2 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sat, 31 Jul 2021 12:04:51 +0200
Subject: [PATCH 111/140] Corrected tests

---
 proptool/prop/file.py                     |  1 +
 proptool/prop/items.py                    |  4 +++-
 tests/checks/checks_test_case.py          | 11 ++---------
 tests/checks/test_missing_translations.py |  7 +++----
 tests/prop/test_items.py                  | 20 +++++++++++++-------
 5 files changed, 22 insertions(+), 21 deletions(-)

diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 0ff8f350..1b6a276c 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -224,6 +224,7 @@ def load(self, file: Path, language: str = None) -> bool:
                 val = tmp[3].lstrip()
                 if key not in self.keys:
                     self.append(Translation(key, val, separator))
+                    self.keys.append(key)
                 else:
                     duplicated_keys.error(line_number, f'Duplicated key "{key}".')
 
diff --git a/proptool/prop/items.py b/proptool/prop/items.py
index f29659d6..86d5880b 100644
--- a/proptool/prop/items.py
+++ b/proptool/prop/items.py
@@ -63,7 +63,9 @@ class Comment(PropItem):
     Class representing a line comment.
     """
 
-    def __init__(self, value: str = '', marker: str = '#') -> None:
+    def __init__(self, value: str = '', marker: str = None) -> None:
+        if not marker:
+            marker = Config.ALLOWED_COMMENT_MARKERS[0]
         if marker not in Config.ALLOWED_COMMENT_MARKERS:
             raise ValueError(f'Invalid comment marker: "{marker}".')
         if not isinstance(value, str):
diff --git a/tests/checks/checks_test_case.py b/tests/checks/checks_test_case.py
index df34a1d8..0048a89e 100644
--- a/tests/checks/checks_test_case.py
+++ b/tests/checks/checks_test_case.py
@@ -45,15 +45,8 @@ def check(self, translation: PropFile, reference: Union[PropFile, None] = None,
         if dump:
             report.dump()
 
-        err_msg = msg
-        warn_msg = msg
-        if exp_errors > 0:
-            err_msg = err_msg
-        if exp_warnings > 0:
-            warn_msg = err_msg
-
-        self.assertEqual(exp_errors, report.errors, err_msg)
-        self.assertEqual(exp_warnings, report.warnings, warn_msg)
+        self.assertEqual(exp_errors, report.errors, msg)
+        self.assertEqual(exp_warnings, report.warnings, msg)
 
     # #################################################################################################
 
diff --git a/tests/checks/test_missing_translations.py b/tests/checks/test_missing_translations.py
index 019abcc2..f588b0d6 100644
--- a/tests/checks/test_missing_translations.py
+++ b/tests/checks/test_missing_translations.py
@@ -12,7 +12,6 @@
 from proptool.checks.base.check import Check
 from proptool.checks.missing_translation import MissingTranslation
 from proptool.decorators.overrides import overrides
-from proptool.prop.items import Comment
 from tests.checks.checks_test_case import ChecksTestCase
 
 
@@ -52,9 +51,9 @@ def test_translation_with_keys_in_comments(self) -> None:
         # put remaining keys into comments
         remaining_keys = ref_keys[(how_many_less * -1):]
         for key in remaining_keys:
-            comment = self.config.DEFAULT_COMMENT_TEMPLATE
-            comment = comment.replace('SEP', trans_file.separator).replace('COM', self.config.comment_marker).replace('KEY', key)
-            trans_file.append(Comment(comment))
+            # We do not really care comments per-se as it sufficient to put these keys into separate
+            # list that loader uses to store parsed commented-out keys.
+            trans_file.commented_out_keys.append(key)
 
         # We expect no issues in non-strict mode
         self.checker.config['strict'] = False
diff --git a/tests/prop/test_items.py b/tests/prop/test_items.py
index 64930e12..1299ef10 100644
--- a/tests/prop/test_items.py
+++ b/tests/prop/test_items.py
@@ -108,13 +108,19 @@ def test_comment_invalid_value(self) -> None:
             # noinspection PyTypeChecker
             Comment(1234)
 
-        with self.assertRaises(ValueError):
-            # Empty value
-            Comment('')
-
-        with self.assertRaises(ValueError):
-            # No valid comment marker
-            Comment('No marker')
+    def test_comment_without_marker(self) -> None:
+        """
+        Checks if constructing Comment without valid marker in passed value
+        would automatically add such marker.
+        """
+        val = self.get_random_string('no_maker_')
+        # No valid comment marker
+        comment = Comment(val)
+        self.assertEqual(f'{Config.ALLOWED_COMMENT_MARKERS[0]} {val}', comment.to_string())
+
+    def test_comment_empty_value(self) -> None:
+        comment = Comment('')
+        self.assertEqual(Config.ALLOWED_COMMENT_MARKERS[0], comment.to_string())
 
     def test_comment_to_string(self) -> None:
         config = Config()

From dac4ff5f76f61520fcf32cfaac8fdbf4b117fab5 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sat, 31 Jul 2021 17:03:51 +0200
Subject: [PATCH 112/140] Fixed PropFile.update()

---
 proptool/prop/file.py                     | 8 ++++----
 proptool/prop/items.py                    | 2 +-
 tests/checks/test_missing_translations.py | 7 ++++---
 3 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 1b6a276c..235b58d6 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -101,11 +101,11 @@ def append(self, items: Union[List[PropItem], PropItem]) -> None:
             if not issubclass(type(single_item), PropItem):
                 raise TypeError(f'Item must be of PropItem, {type(single_item)} given.')
 
-            if isinstance(items, Translation):
-                self.keys.append(items.key)
-            elif isinstance(items, Comment):
+            if isinstance(single_item, Translation):
+                self.keys.append(single_item.key)
+            elif isinstance(single_item, Comment):
                 # Let's look for commented out keys.
-                match = re.compile(self.comment_pattern).match(items.value)
+                match = re.compile(self.comment_pattern).match(single_item.value)
                 if match:
                     self.commented_out_keys.append(match.group(1))
             self._items.append(single_item)
diff --git a/proptool/prop/items.py b/proptool/prop/items.py
index 86d5880b..4acd41e5 100644
--- a/proptool/prop/items.py
+++ b/proptool/prop/items.py
@@ -60,7 +60,7 @@ def to_string(self) -> str:
 
 class Comment(PropItem):
     """
-    Class representing a line comment.
+    Class representing a comment line.
     """
 
     def __init__(self, value: str = '', marker: str = None) -> None:
diff --git a/tests/checks/test_missing_translations.py b/tests/checks/test_missing_translations.py
index f588b0d6..6ac2f7cb 100644
--- a/tests/checks/test_missing_translations.py
+++ b/tests/checks/test_missing_translations.py
@@ -9,8 +9,10 @@
 import random
 from typing import Dict, Union
 
+from proptool.prop.items import Comment
 from proptool.checks.base.check import Check
 from proptool.checks.missing_translation import MissingTranslation
+from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
 from tests.checks.checks_test_case import ChecksTestCase
 
@@ -51,9 +53,8 @@ def test_translation_with_keys_in_comments(self) -> None:
         # put remaining keys into comments
         remaining_keys = ref_keys[(how_many_less * -1):]
         for key in remaining_keys:
-            # We do not really care comments per-se as it sufficient to put these keys into separate
-            # list that loader uses to store parsed commented-out keys.
-            trans_file.commented_out_keys.append(key)
+            commented_out_key = Config.DEFAULT_COMMENT_TEMPLATE.replace('KEY',key).replace('COM',Config.ALLOWED_COMMENT_MARKERS[0]).replace('SEP', Config.ALLOWED_SEPARATORS[0])
+            trans_file.append(Comment(commented_out_key))
 
         # We expect no issues in non-strict mode
         self.checker.config['strict'] = False

From 39125dec172901f0e847efe81d2db70b46c9f290 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sat, 31 Jul 2021 23:03:11 +0200
Subject: [PATCH 113/140] Added PropFile.update() tests

---
 proptool/config/config.py                 |  9 ++-
 proptool/prop/file.py                     | 21 +++---
 proptool/prop/items.py                    | 22 ++++++
 tests/checks/test_missing_translations.py |  6 +-
 tests/prop/test_file.py                   | 86 +++++++++++++++++++++++
 5 files changed, 132 insertions(+), 12 deletions(-)

diff --git a/proptool/config/config.py b/proptool/config/config.py
index ada4a6b8..4ca8ec18 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -17,9 +17,16 @@ class Config(object):
     ALLOWED_SEPARATORS: List[str] = ['=', ':']
     ALLOWED_COMMENT_MARKERS: List[str] = ['#', '!']
     COMMENT_TEMPLATE_LITERALS: List[str] = ['COM', 'KEY', 'SEP']
-    DEFAULT_COMMENT_TEMPLATE: str = 'COM ==> KEY SEP'
     DEFAULT_FILE_SUFFIX: str = '.properties'
 
+    DEFAULT_COMMENT_TEMPLATE: str = 'COM ==> KEY SEP VAL'
+    """
+    COM: comment marker
+    KEU: translation key
+    SEP: "key SEP value" separator
+    VAL: original string
+    """
+
     def __init__(self):
         self.config_file = None
 
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 235b58d6..30ee62ff 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -125,13 +125,16 @@ def update(self, reference_propfile: 'PropFile') -> None:
         """
 
         tmp = PropFile(self.config)
-        tmp.append([
-            Comment(),
-            Comment(f'Base: {reference_propfile}'),
-        ])
-        if self.language is not None:
-            tmp.append(Comment(f'Lang: {self.language}'))
-        tmp.append(Comment())
+        # tmp.append([
+        #     Comment(),
+        #     base_comment = f'Base: {reference_propfile}'
+        #     if reference_propfile.language:
+        #        base_comment = f'{base_comment} [{reference_propfile.language}]'
+        #     Comment(base_comment),
+        # ])
+        # if self.language is not None:
+        #     tmp.append(Comment(f'Lang: {self.language}'))
+        # tmp.append(Comment())
 
         # For all items in reference file...
         for idx, item in enumerate(reference_propfile.items):
@@ -142,11 +145,11 @@ def update(self, reference_propfile: 'PropFile') -> None:
                 # If we do have the translation already
                 if item.key in self.keys:
                     # Add original string as comment if that's requested
-                    tmp.append(Comment(f'BASE: {item.value}'))
+                    # tmp.append(Comment(f'BASE: {item.value}'))
                     # Copy our translation.
                     tmp.append(self.find_by_key(item.key))
                 else:
-                    tmp.append(Comment(self.config.comment_pattern.replace('KEY', item.key)))
+                    tmp.append(Comment.get_commented_out_key_comment(item.key, item.value, self.config))
             else:
                 raise RuntimeError(f'Unknown entry type: {type(item)} at position {idx + 1}')
 
diff --git a/proptool/prop/items.py b/proptool/prop/items.py
index 4acd41e5..0b5b7178 100644
--- a/proptool/prop/items.py
+++ b/proptool/prop/items.py
@@ -83,6 +83,28 @@ def __init__(self, value: str = '', marker: str = None) -> None:
     def to_string(self) -> str:
         return self.value
 
+    @staticmethod
+    def comment_out_key(key: str, value: Union[str, None], config: Config) -> str:
+        """
+        Helper method that returns translation key formatted as commented-out item.
+        :param key: translation key.
+        :param config: Application config.
+        :param value: Optional original string value
+        """
+
+        if value is None:
+            value = ''
+
+        return config.DEFAULT_COMMENT_TEMPLATE.replace(
+            'KEY', key).replace(
+            'COM', config.ALLOWED_COMMENT_MARKERS[0]).replace(
+            'SEP', config.ALLOWED_SEPARATORS[0]).replace(
+            'VAL', value).strip()
+
+    @staticmethod
+    def get_commented_out_key_comment(key: str, value: Union[str, None], config: Config) -> 'Comment':
+        return Comment(Comment.comment_out_key(key, value, config))
+
 
 # #################################################################################################
 
diff --git a/tests/checks/test_missing_translations.py b/tests/checks/test_missing_translations.py
index 6ac2f7cb..f11b840c 100644
--- a/tests/checks/test_missing_translations.py
+++ b/tests/checks/test_missing_translations.py
@@ -53,8 +53,10 @@ def test_translation_with_keys_in_comments(self) -> None:
         # put remaining keys into comments
         remaining_keys = ref_keys[(how_many_less * -1):]
         for key in remaining_keys:
-            commented_out_key = Config.DEFAULT_COMMENT_TEMPLATE.replace('KEY',key).replace('COM',Config.ALLOWED_COMMENT_MARKERS[0]).replace('SEP', Config.ALLOWED_SEPARATORS[0])
-            trans_file.append(Comment(commented_out_key))
+            key_comment = Config.DEFAULT_COMMENT_TEMPLATE.replace('KEY', key)
+            key_comment = key_comment.replace('COM', Config.ALLOWED_COMMENT_MARKERS[0])
+            key_comment = key_comment.replace('SEP', Config.ALLOWED_SEPARATORS[0])
+            trans_file.append(Comment(key_comment))
 
         # We expect no issues in non-strict mode
         self.checker.config['strict'] = False
diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 30dcac81..2a521819 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -6,6 +6,7 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+import copy
 import random
 from pathlib import Path
 from unittest.mock import Mock, mock_open, patch
@@ -272,3 +273,88 @@ def test_is_valid_on_empty_files(self, path_exists_mock: Mock) -> None:
             # Expecting no problems reported
             prop_file.report.dump()
             self.assertTrue(prop_file.is_valid(ref_file))
+
+    # #################################################################################################
+
+    def test_update(self) -> None:
+        config = Config()
+
+        # Generate reference file and its contents
+        reference = PropFile(config)
+
+        item_types = [Blank, Comment, Translation]
+        item_weights = [1, 5, 10]
+        for new_item_cls in random.choices(item_types, item_weights, k = 20):
+            if issubclass(new_item_cls, Translation):
+                key = self.get_random_string('key_')
+                val = self.get_random_string('ref_val_')
+                reference.append(Translation(key, val))
+            elif issubclass(new_item_cls, Comment):
+                reference.append(Comment(self.get_random_string('comment_')))
+            elif issubclass(new_item_cls, Blank):
+                reference.append(Blank())
+            else:
+                self.fail(f'Unknown new_item_cls: {type(new_item_cls)}')
+
+        # Generate translation file
+        translation = PropFile(config)
+
+        mut_none = 'none'
+        mut_com = 'comment-out'
+        mutation_items = [mut_none, mut_com]
+        mutation_weights = [10, 5]
+
+        mut_com_cnt = 0
+
+        for ref_idx, ref_item in enumerate(reference.items):
+            if isinstance(ref_item, Translation):
+                mutation = random.choices(mutation_items, mutation_weights, k = 1)[0]
+                if mutation == mut_none:
+                    translation.append(Translation(ref_item.key, self.get_random_string(f'translation_{ref_idx}')))
+                else:
+                    # or commented out key
+                    translation.append(Comment.get_commented_out_key_comment(ref_item.key, ref_item.value, config))
+                    mut_com_cnt += 1
+                continue
+            translation.append(ref_item)
+
+        self.assertNotEqual(0, mut_com_cnt)
+
+        # Keep the clone of
+        translation_clone = copy.deepcopy(translation)
+
+        # Then add some Blanks and Comments that will be gone after the sync.
+        max_items = 5
+        for _ in range(max_items):
+            translation.append([
+                Blank(),
+                Comment(self.get_random_string('comment_')),
+            ])
+
+        # THEN after update
+        translation.update(reference)
+
+        # we should have synced content
+        for ref_idx, ref_item in enumerate(reference.items):
+            trans_item = translation.items[ref_idx]
+
+            if isinstance(ref_item, Blank):
+                self.assertEqual(type(trans_item), Blank)
+                continue
+
+            if isinstance(ref_item, Comment):
+                self.assertEqual(type(trans_item), Comment)
+                continue
+
+            if isinstance(ref_item, Translation):
+                if isinstance(trans_item, Translation):
+                    # FIXME: we shall check the separator too.
+                    self.assertEqual(ref_item.key, trans_item.key)
+                    self.assertEqual(translation_clone.items[ref_idx].value, trans_item.value)
+                    continue
+                if isinstance(trans_item, Comment):
+                    expected = Comment.comment_out_key(ref_item.key, ref_item.value, config)
+                    self.assertEqual(expected, trans_item.to_string())
+                    continue
+
+            self.fail(f'Unknown item type: {type(trans_item)}')

From c099f0190370378608660eccdf56285884f0f1a8 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sat, 31 Jul 2021 23:18:02 +0200
Subject: [PATCH 114/140] Lint fixes

---
 docs/checks/README.md     |  2 +-
 proptool/config/config.py | 10 ++++------
 proptool/prop/file.py     | 16 +---------------
 tests/prop/test_file.py   |  5 +++--
 4 files changed, 9 insertions(+), 24 deletions(-)

diff --git a/docs/checks/README.md b/docs/checks/README.md
index 409d1560..2fe74cdf 100644
--- a/docs/checks/README.md
+++ b/docs/checks/README.md
@@ -38,5 +38,5 @@ base (reference) file and each translation.
 
 Some validators can do their work having just single file to process. In such
 case you can use it to check both your base file and translation files. Those
-validators that needs base file reference (i.e. [DanglingKeys](#dangling-keys)
+validators that needs base file reference (i.e. [DanglingKeys](dangling-keys.md)
 can only be used to validate translations.
diff --git a/proptool/config/config.py b/proptool/config/config.py
index 4ca8ec18..8b97f910 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -19,13 +19,11 @@ class Config(object):
     COMMENT_TEMPLATE_LITERALS: List[str] = ['COM', 'KEY', 'SEP']
     DEFAULT_FILE_SUFFIX: str = '.properties'
 
+    # COM: comment marker
+    # KEY: translation key
+    # SEP: "key SEP value" separator
+    # VAL: original string
     DEFAULT_COMMENT_TEMPLATE: str = 'COM ==> KEY SEP VAL'
-    """
-    COM: comment marker
-    KEU: translation key
-    SEP: "key SEP value" separator
-    VAL: original string
-    """
 
     def __init__(self):
         self.config_file = None
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 30ee62ff..851f2a2d 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -125,18 +125,7 @@ def update(self, reference_propfile: 'PropFile') -> None:
         """
 
         tmp = PropFile(self.config)
-        # tmp.append([
-        #     Comment(),
-        #     base_comment = f'Base: {reference_propfile}'
-        #     if reference_propfile.language:
-        #        base_comment = f'{base_comment} [{reference_propfile.language}]'
-        #     Comment(base_comment),
-        # ])
-        # if self.language is not None:
-        #     tmp.append(Comment(f'Lang: {self.language}'))
-        # tmp.append(Comment())
-
-        # For all items in reference file...
+
         for idx, item in enumerate(reference_propfile.items):
             # Copy comments and blank lines as-is
             if isinstance(item, (Comment, Blank)):
@@ -144,9 +133,6 @@ def update(self, reference_propfile: 'PropFile') -> None:
             elif isinstance(item, Translation):
                 # If we do have the translation already
                 if item.key in self.keys:
-                    # Add original string as comment if that's requested
-                    # tmp.append(Comment(f'BASE: {item.value}'))
-                    # Copy our translation.
                     tmp.append(self.find_by_key(item.key))
                 else:
                     tmp.append(Comment.get_commented_out_key_comment(item.key, item.value, self.config))
diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 2a521819..ab990413 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -284,7 +284,8 @@ def test_update(self) -> None:
 
         item_types = [Blank, Comment, Translation]
         item_weights = [1, 5, 10]
-        for new_item_cls in random.choices(item_types, item_weights, k = 20):
+        new_items = 20
+        for new_item_cls in random.choices(item_types, item_weights, k = new_items):
             if issubclass(new_item_cls, Translation):
                 key = self.get_random_string('key_')
                 val = self.get_random_string('ref_val_')
@@ -335,7 +336,7 @@ def test_update(self) -> None:
         translation.update(reference)
 
         # we should have synced content
-        for ref_idx, ref_item in enumerate(reference.items):
+        for ref_idx, ref_item in enumerate(reference.items):  # noqa: WPS440
             trans_item = translation.items[ref_idx]
 
             if isinstance(ref_item, Blank):

From b056736cf7f4b7c1b1070235a6d335b6400ef831 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 1 Aug 2021 11:30:05 +0200
Subject: [PATCH 115/140] Added propfile.save() tests

---
 proptool/prop/file.py   |  11 +++--
 tests/prop/test_file.py | 101 +++++++++++++++++++++++++++++++++-------
 2 files changed, 91 insertions(+), 21 deletions(-)

diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 851f2a2d..af8b76ee 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -231,11 +231,14 @@ def save(self, target_file_name: Union[Path, None] = None) -> None:
 
         if not target_file_name:
             if not self.file:
-                raise RuntimeError('No target file name given.')
+                raise ValueError('No target file name given.')
             target_file_name = self.file
 
+        content = []
+        for item in self.items:
+            content.append(item.to_string())
+
         Log.i(f'Saving: {target_file_name}')
         with open(target_file_name, 'w') as fh:
-            for item in self.items:
-                # FIXME: LF/CRLF should configurable
-                fh.write(f'{item.to_string()}\n')
+            # FIXME: LF/CRLF should configurable
+            fh.write('\n'.join(content))
diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index ab990413..77b3c272 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -19,6 +19,32 @@
 
 class TestPropFile(TestCase):
 
+    def _generate_propfile_with_content(self, config: Config) -> PropFile:
+        """
+        Creates instance of PropFile and fills it with randonly generated content.
+        :param config: Config to be used while constructing instance.
+        """
+        propfile = PropFile(config)
+
+        item_types = [Blank, Comment, Translation]
+        item_weights = [2, 5, 10]
+        new_items = 50
+        for new_item_cls in random.choices(item_types, item_weights, k = new_items):
+            if issubclass(new_item_cls, Translation):
+                key = self.get_random_string('key_')
+                val = self.get_random_string('ref_val_')
+                propfile.append(Translation(key, val))
+            elif issubclass(new_item_cls, Comment):
+                propfile.append(Comment(self.get_random_string('comment_')))
+            elif issubclass(new_item_cls, Blank):
+                propfile.append(Blank())
+            else:
+                self.fail(f'Unknown new_item_cls: {type(new_item_cls)}')
+
+        return propfile
+
+    # #################################################################################################
+
     def test_append_wrong_arg_type(self) -> None:
         # GIVEN normal instance of PropFile
         prop_file = PropFile(Config())
@@ -165,7 +191,7 @@ def test_load_invalid_translation_syntax(self, path_exists_mock: Mock) -> None:
                     prop_file = PropFile(Config())
                     prop_file.load(Path(fake_file_name))
                 except SystemExit:
-                    # sys.exit() happened afrer Log.e() is called, so we can check the error message here.
+                    # sys.exit() happened after Log.e() is called, so we can check the error message here.
                     msg = log_e_mock.call_args_list[0][0][0]
                     self.assertEqual(msg, f'Invalid syntax at line {trap_position + 1} of "{fake_file_name}".')
 
@@ -255,6 +281,62 @@ def assertBlank(blank):
 
     # #################################################################################################
 
+    def _check_written_content(self, propfile: PropFile, verify_file_name, save_file_name = None):
+        with patch('builtins.open', mock_open()) as manager:
+            with patch('proptool.log.Log.i') as log_i_mock:
+                if save_file_name:
+                    propfile.save(save_file_name)
+                else:
+                    propfile.save()
+                manager.assert_called_once_with(verify_file_name, 'w')
+
+                # Ensure call to Log.i() happened with expected message.
+                msg = log_i_mock.call_args_list[0][0][0]
+                self.assertEqual(msg, f'Saving: {verify_file_name}')
+
+                # Check file content is written as expected.
+                expected = []
+                for item in propfile.items:
+                    expected.append(item.to_string())
+
+                fh = manager()
+                # FIXME: LF/CRLF should configurable
+                fh.write.assert_called_once_with('\n'.join(expected))
+
+    def test_save(self) -> None:
+        """
+        Checks if save() writes proper contents to the file.
+        """
+        config = Config()
+        propfile = self._generate_propfile_with_content(config)
+
+        fake_file_name = Path(self.get_random_string())
+        self._check_written_content(propfile, fake_file_name, fake_file_name)
+
+    def test_save_use_property_file(self) -> None:
+        """
+        Checks save() will use property file as target file name if no
+        file name is specified as save() argument.
+        """
+        config = Config()
+        propfile = self._generate_propfile_with_content(config)
+        verify_file_name = Path(self.get_random_string())
+        propfile.file = verify_file_name
+        self._check_written_content(propfile, verify_file_name)
+
+    def test_save_no_target_file(self) -> None:
+        """
+        Checks if save() will fail if no target file name is given nor object's
+        `file` property is `None`.
+        :return:
+        """
+        config = Config()
+        propfile = PropFile(config)
+        with self.assertRaises(ValueError):
+            propfile.save()
+
+    # #################################################################################################
+
     @patch('pathlib.Path.exists')
     def test_is_valid_on_empty_files(self, path_exists_mock: Mock) -> None:
 
@@ -280,22 +362,7 @@ def test_update(self) -> None:
         config = Config()
 
         # Generate reference file and its contents
-        reference = PropFile(config)
-
-        item_types = [Blank, Comment, Translation]
-        item_weights = [1, 5, 10]
-        new_items = 20
-        for new_item_cls in random.choices(item_types, item_weights, k = new_items):
-            if issubclass(new_item_cls, Translation):
-                key = self.get_random_string('key_')
-                val = self.get_random_string('ref_val_')
-                reference.append(Translation(key, val))
-            elif issubclass(new_item_cls, Comment):
-                reference.append(Comment(self.get_random_string('comment_')))
-            elif issubclass(new_item_cls, Blank):
-                reference.append(Blank())
-            else:
-                self.fail(f'Unknown new_item_cls: {type(new_item_cls)}')
+        reference = self._generate_propfile_with_content(config)
 
         # Generate translation file
         translation = PropFile(config)

From ee9f19c98d18afdb160edf146b6df4a373467bbb Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 1 Aug 2021 12:55:32 +0200
Subject: [PATCH 116/140] Log is now configured twice, once with defaults then
 with user settings

---
 proptool/checks/brackets.py | 1 +
 proptool/main.py            | 3 +++
 2 files changed, 4 insertions(+)

diff --git a/proptool/checks/brackets.py b/proptool/checks/brackets.py
index d0deac70..195c32a0 100644
--- a/proptool/checks/brackets.py
+++ b/proptool/checks/brackets.py
@@ -54,6 +54,7 @@ def check(self, translation: 'PropFile', reference: 'PropFile' = None) -> Report
             report.error('CONFIG: Both "opening" and "closing" arrays must contain the same number of elements.')
         if opening_cnt == 0:
             report.warn('CONFIG: Empty "opening" and "closing" arrays.')
+            return report
 
         for idx, item in enumerate(translation.items):
             # Do not try to be clever and filter() data first, because line_number values will no longer be correct.
diff --git a/proptool/main.py b/proptool/main.py
index 5e0055bf..92f73e0d 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -34,7 +34,10 @@ def start() -> int:
                 return 0
 
             config_defaults = Config()
+            # Configure Log with defaults (i.e. colors etc)
+            Log.configure(config_defaults)
             config = ConfigBuilder.build(config_defaults)
+            # Reconfigure once we got user settings handled.
             Log.configure(config)
 
             errors = 0

From 19f21f7ce4ff65bfb037198475055e462bd48d48 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 1 Aug 2021 12:56:46 +0200
Subject: [PATCH 117/140] --update now works regardless of validation result

---
 proptool/main.py | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/proptool/main.py b/proptool/main.py
index 92f73e0d..454a7260 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -93,12 +93,9 @@ def start() -> int:
                                 errors += 1
 
                             if config.update:
-                                if is_translation_valid:
-                                    if translation_propfile.file:
-                                        translation_propfile.update(reference_propfile)
-                                        translation_propfile.save()
-                                else:
-                                    Log.w('Not updating translation due to found issues')
+                                if translation_propfile.file:
+                                    translation_propfile.update(reference_propfile)
+                                    translation_propfile.save()
 
                             if Log.pop():
                                 Log.i(f'%ok%{trans_level_label}: OK')

From 31b16959b8ac9212cd980f8dbc3e684304d23269 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 1 Aug 2021 13:57:01 +0200
Subject: [PATCH 118/140] Added ConfigParser.build() test

---
 proptool/config/config.py           |   2 +-
 proptool/config/config_builder.py   |   6 +-
 proptool/main.py                    |   3 +-
 tests/config/test_config_builder.py | 103 +++++++++++++++++-----------
 4 files changed, 70 insertions(+), 44 deletions(-)

diff --git a/proptool/config/config.py b/proptool/config/config.py
index 8b97f910..e35d89ae 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -47,7 +47,7 @@ def __init__(self):
         self.comment_marker: str = '#'
         self.comment_template: str = Config.DEFAULT_COMMENT_TEMPLATE
 
-        self.checks: List[CheckerInfo] = {
+        self.checks: Dict[str, CheckerInfo] = {
             # empty set. Populated and manipulated by ConfigBuilder
         }
 
diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 31e1ff79..92cb017d 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -8,6 +8,7 @@
 """
 
 import argparse
+import copy
 from pathlib import Path
 from typing import List, Union
 
@@ -40,7 +41,6 @@ class ConfigBuilder(object):
 
     @staticmethod
     def build(config_defaults: Config) -> Config:
-
         checkers = [
             Brackets,
             DanglingKeys,
@@ -83,8 +83,8 @@ def _abort(msg: str) -> None:
     def _validate_config(config: Config) -> None:
         if not config.files:
             ConfigBuilder._abort('No base file(s) specified.')
-        if not config.languages:
-            ConfigBuilder._abort('No language(s) specified.')
+        # if not config.languages:
+        #     ConfigBuilder._abort('No language(s) specified.')
         if config.separator not in Config.ALLOWED_SEPARATORS:
             ConfigBuilder._abort('Invalid separator character.')
         if config.comment_marker not in Config.ALLOWED_COMMENT_MARKERS:
diff --git a/proptool/main.py b/proptool/main.py
index 454a7260..04b59cb4 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -26,7 +26,6 @@ class PropTool(object):
 
     @staticmethod
     def start() -> int:
-
         try:
             # Cannot rely on argparse here as we have required arguments there.
             if '--version' in sys.argv:
@@ -61,6 +60,7 @@ def start() -> int:
                     Log.e(f'File not found: {reference_path}')
                     Utils.abort()
 
+                # Validate base file.
                 for _, checker_info in config.checks.items():
                     # Almost any check validates translation against reference file, so we cannot use all checks here,
                     # but there are some that process single file independently so they in fact do not need any reference
@@ -69,6 +69,7 @@ def start() -> int:
                     if checker.is_single_file_check:
                         # Each validator gets copy of the files, to prevent any potential destructive operation.
                         propfile_copy = copy.copy(reference_propfile)
+                        print(checker)
                         reference_propfile.report.add(checker.check(propfile_copy))
 
                 if not reference_propfile.report.empty():
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index 4d197918..e3a5052a 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -80,23 +80,23 @@ def test_validate_no_files(self, log_e_mock: Mock) -> None:
             self.assertEqual(SystemExit, type(context_manager.exception))
             self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
 
-    @patch('proptool.log.Log.e')
-    def test_validate_no_languages(self, log_e_mock: Mock) -> None:
-        """
-        Ensures empty language list triggers expected error message and quits.
-
-        :param log_e_mock: Log.abort() mock.
-        """
-        config = self.get_config_for_validate()
-        config.languages = []
-        with self.assertRaises(SystemExit) as context_manager:
-            ConfigBuilder._validate_config(config)
-            exp_calls = [call('No language(s) specified.')]
-            log_e_mock.assert_has_calls(exp_calls)
-
-            # Check we got sys.exit called with non-zero return code
-            self.assertEqual(SystemExit, type(context_manager.exception))
-            self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
+    # @patch('proptool.log.Log.e')
+    # def test_validate_no_languages(self, log_e_mock: Mock) -> None:
+    #     """
+    #     Ensures empty language list triggers expected error message and quits.
+    #
+    #     :param log_e_mock: Log.abort() mock.
+    #     """
+    #     config = self.get_config_for_validate()
+    #     config.languages = []
+    #     with self.assertRaises(SystemExit) as context_manager:
+    #         ConfigBuilder._validate_config(config)
+    #         exp_calls = [call('No language(s) specified.')]
+    #         log_e_mock.assert_has_calls(exp_calls)
+    #
+    #         # Check we got sys.exit called with non-zero return code
+    #         self.assertEqual(SystemExit, type(context_manager.exception))
+    #         self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
 
     @patch('proptool.log.Log.e')
     def test_validate_invalid_separator(self, log_e_mock: Mock) -> None:
@@ -155,7 +155,29 @@ def test_set_on_off_option(self) -> None:
 
     # #################################################################################################
 
-    def get_expectation(self, config_default: bool, switch_on: bool, switch_off: bool) -> bool:
+    def _generate_fake_args(self, languages: List[str]) -> FakeArgs:
+        args = FakeArgs()
+
+        # Lets set up args to some random state
+        args.update = self.get_random_bool()
+        args.quiet = self.get_random_bool()
+        args.verbose = self.get_random_bool()
+        args.color = self.get_random_bool()
+        args.fatal, args.no_fatal = self.get_random_on_off_pair()
+        args.strict, args.no_strict = self.get_random_on_off_pair()
+        args.color, args.no_color = self.get_random_on_off_pair()
+        args.separator = random.choice(Config.ALLOWED_SEPARATORS)
+        args.comment_marker = random.choice(Config.ALLOWED_COMMENT_MARKERS)
+
+        # Generate fake file names with expected default suffix
+        args.files = [Path(f'{self.get_random_string()}{Config.DEFAULT_FILE_SUFFIX}') for _ in range(1, 10)]
+
+        args.languages = languages
+
+        return args
+
+
+    def _get_expectation(self, config_default: bool, switch_on: bool, switch_off: bool) -> bool:
         """
         Computes expected final value based on on/off switches.
 
@@ -176,26 +198,9 @@ def test_set_from_args(self) -> None:
         """
         Tests _set_from_args()
         """
-        args = FakeArgs()
-
-        # Lets set up args to some random state
-        args.update = self.get_random_bool()
-        args.quiet = self.get_random_bool()
-        args.verbose = self.get_random_bool()
-        args.color = self.get_random_bool()
-        args.fatal, args.no_fatal = self.get_random_on_off_pair()
-        args.strict, args.no_strict = self.get_random_on_off_pair()
-        args.color, args.no_color = self.get_random_on_off_pair()
-        args.separator = random.choice(Config.ALLOWED_SEPARATORS)
-        args.comment_marker = random.choice(Config.ALLOWED_COMMENT_MARKERS)
-
-        # Generate fake file names with expected default suffix
-        args.files = [Path(f'{self.get_random_string()}{Config.DEFAULT_FILE_SUFFIX}') for _ in range(1, 10)]
-
-        # some languages
         # FIXME: make list more random
         languages = ['pl', 'de', 'pt']
-        args.languages = languages
+        args = self._generate_fake_args(languages)
 
         # This is going to be our reference default config instance.
         config_defaults = Config()
@@ -205,9 +210,9 @@ def test_set_from_args(self) -> None:
         ConfigBuilder._set_from_args(config, args)
 
         # Ensure config reflects changes from command line
-        exp_fatal = self.get_expectation(config_defaults.fatal, args.fatal, args.no_fatal)
+        exp_fatal = self._get_expectation(config_defaults.fatal, args.fatal, args.no_fatal)
         self.assertEqual(exp_fatal, config.fatal)
-        exp_color = self.get_expectation(config_defaults.color, args.color, args.no_color)
+        exp_color = self._get_expectation(config_defaults.color, args.color, args.no_color)
         self.assertEqual(exp_color, config.color)
 
         # log_level controlled by `quiet` and `verbose`.
@@ -373,7 +378,6 @@ def test_parse_args_returns_all_keys(self) -> None:
         config = Config()
 
         # Pass no args for parsing (this is legit as we have config file that can provide what's needed).
-
         sys.argv[1:] = []  # noqa: WPS362
         args = ConfigBuilder._parse_args()
         for key in config.__dict__:
@@ -403,3 +407,24 @@ def test_parse_args_returns_no_more_keys(self) -> None:
         for key in args:
             # Ensure key args returns is what is present in Config as well.
             self.assertIn(key, config.__dict__)
+
+    # #################################################################################################
+
+    def test_build(self) -> None:
+        # FIXME: make list more random
+        languages = ['pl', 'de', 'pt']
+        args = self._generate_fake_args(languages)
+
+        config_defaults = Config()
+        file = self.get_random_string('file_')
+        config_defaults.files.append(file)
+
+        # Pass no args for parsing (this is legit as we have config file that can provide what's needed).
+        sys.argv[1:] = []  # noqa: WPS362
+        with patch('proptool.config.config_builder.ConfigBuilder._set_from_args') as manager:
+            config = ConfigBuilder.build(config_defaults)
+
+            # TODO: make comparision more detailed; add test for langs as well
+            self.assertEqual(len(config_defaults.files), len(config.files))
+            for idx, def_file in enumerate(config_defaults.files):
+                self.assertEqual(def_file, config.files[idx])

From 8c60112185486f41d76d0e3fca164ec7cb7ebaf6 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 1 Aug 2021 14:03:07 +0200
Subject: [PATCH 119/140] Corrected build() test to use FakeArgs

---
 proptool/config/config_builder.py   |  3 ---
 proptool/main.py                    |  1 -
 tests/config/test_config_builder.py | 25 +++++--------------------
 3 files changed, 5 insertions(+), 24 deletions(-)

diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 92cb017d..ef1b4afc 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -8,7 +8,6 @@
 """
 
 import argparse
-import copy
 from pathlib import Path
 from typing import List, Union
 
@@ -83,8 +82,6 @@ def _abort(msg: str) -> None:
     def _validate_config(config: Config) -> None:
         if not config.files:
             ConfigBuilder._abort('No base file(s) specified.')
-        # if not config.languages:
-        #     ConfigBuilder._abort('No language(s) specified.')
         if config.separator not in Config.ALLOWED_SEPARATORS:
             ConfigBuilder._abort('Invalid separator character.')
         if config.comment_marker not in Config.ALLOWED_COMMENT_MARKERS:
diff --git a/proptool/main.py b/proptool/main.py
index 04b59cb4..beef6c0d 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -69,7 +69,6 @@ def start() -> int:
                     if checker.is_single_file_check:
                         # Each validator gets copy of the files, to prevent any potential destructive operation.
                         propfile_copy = copy.copy(reference_propfile)
-                        print(checker)
                         reference_propfile.report.add(checker.check(propfile_copy))
 
                 if not reference_propfile.report.empty():
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index e3a5052a..fa7fed65 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -32,6 +32,8 @@ def __init__(self):
         self.comment_marker: Union[str, None] = None
         self.comment_template: Union[str, None] = None
 
+        self.config_file = None
+
         # Initialize all on/off flags related attributes.
         for option_name in ConfigBuilder._on_off_pairs:
             self.__setattr__(option_name, False)
@@ -80,24 +82,6 @@ def test_validate_no_files(self, log_e_mock: Mock) -> None:
             self.assertEqual(SystemExit, type(context_manager.exception))
             self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
 
-    # @patch('proptool.log.Log.e')
-    # def test_validate_no_languages(self, log_e_mock: Mock) -> None:
-    #     """
-    #     Ensures empty language list triggers expected error message and quits.
-    #
-    #     :param log_e_mock: Log.abort() mock.
-    #     """
-    #     config = self.get_config_for_validate()
-    #     config.languages = []
-    #     with self.assertRaises(SystemExit) as context_manager:
-    #         ConfigBuilder._validate_config(config)
-    #         exp_calls = [call('No language(s) specified.')]
-    #         log_e_mock.assert_has_calls(exp_calls)
-    #
-    #         # Check we got sys.exit called with non-zero return code
-    #         self.assertEqual(SystemExit, type(context_manager.exception))
-    #         self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
-
     @patch('proptool.log.Log.e')
     def test_validate_invalid_separator(self, log_e_mock: Mock) -> None:
         """
@@ -176,7 +160,6 @@ def _generate_fake_args(self, languages: List[str]) -> FakeArgs:
 
         return args
 
-
     def _get_expectation(self, config_default: bool, switch_on: bool, switch_off: bool) -> bool:
         """
         Computes expected final value based on on/off switches.
@@ -421,7 +404,9 @@ def test_build(self) -> None:
 
         # Pass no args for parsing (this is legit as we have config file that can provide what's needed).
         sys.argv[1:] = []  # noqa: WPS362
-        with patch('proptool.config.config_builder.ConfigBuilder._set_from_args') as manager:
+        with patch('proptool.config.config_builder.ConfigBuilder._parse_args') as manager:
+            manager.return_value = args
+
             config = ConfigBuilder.build(config_defaults)
 
             # TODO: make comparision more detailed; add test for langs as well

From b00e91a6268fda3de40e4cc57ea49d32290dac85 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 1 Aug 2021 16:05:07 +0200
Subject: [PATCH 120/140] Fixed ReportItem handling of `line` being None

---
 proptool/checks/missing_translation.py    |  2 +-
 proptool/prop/file.py                     |  3 ++-
 proptool/prop/items.py                    | 16 ++++++++++++----
 proptool/report/group.py                  |  2 +-
 proptool/report/items.py                  |  5 +++--
 tests/checks/test_missing_translations.py | 13 +++++++------
 tests/prop/test_file.py                   |  4 ++--
 7 files changed, 28 insertions(+), 17 deletions(-)

diff --git a/proptool/checks/missing_translation.py b/proptool/checks/missing_translation.py
index e1d88684..437b0a49 100644
--- a/proptool/checks/missing_translation.py
+++ b/proptool/checks/missing_translation.py
@@ -45,7 +45,7 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
                     missing_keys.remove(comm_key)
 
         for missing_key in missing_keys:
-            report.warn(None, missing_key)
+            report.warn(None, f'Key "{missing_key}" not found.')
 
         return report
 
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index af8b76ee..5e29ef2c 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -51,6 +51,7 @@ def __init__(self, config: Config, language: str = None):
             'SEP', f'[{"".join(Config.ALLOWED_SEPARATORS)}]')
         # NOTE: key pattern must be in () brackets to form a group used later!
         comment_pattern = comment_pattern.replace('KEY', '([a-zAz][a-zA-z0-9_.-]+)')
+        comment_pattern = comment_pattern.replace('VAL', '(.*)')
         self.comment_pattern = f'^{comment_pattern}'
 
     def init_container(self, language: str) -> None:
@@ -135,7 +136,7 @@ def update(self, reference_propfile: 'PropFile') -> None:
                 if item.key in self.keys:
                     tmp.append(self.find_by_key(item.key))
                 else:
-                    tmp.append(Comment.get_commented_out_key_comment(item.key, item.value, self.config))
+                    tmp.append(Comment.get_commented_out_key_comment(self.config, item.key, item.value))
             else:
                 raise RuntimeError(f'Unknown entry type: {type(item)} at position {idx + 1}')
 
diff --git a/proptool/prop/items.py b/proptool/prop/items.py
index 0b5b7178..7c9f4abb 100644
--- a/proptool/prop/items.py
+++ b/proptool/prop/items.py
@@ -84,11 +84,11 @@ def to_string(self) -> str:
         return self.value
 
     @staticmethod
-    def comment_out_key(key: str, value: Union[str, None], config: Config) -> str:
+    def comment_out_key(config: Config, key: str, value: Union[str, None]) -> str:
         """
         Helper method that returns translation key formatted as commented-out item.
-        :param key: translation key.
         :param config: Application config.
+        :param key: translation key.
         :param value: Optional original string value
         """
 
@@ -102,8 +102,16 @@ def comment_out_key(key: str, value: Union[str, None], config: Config) -> str:
             'VAL', value).strip()
 
     @staticmethod
-    def get_commented_out_key_comment(key: str, value: Union[str, None], config: Config) -> 'Comment':
-        return Comment(Comment.comment_out_key(key, value, config))
+    def get_commented_out_key_comment(config: Config, key: str, value: Union[str, None] = None) -> 'Comment':
+        """
+        Returns instance of Comment with content being commented-out key
+        formatted according to current configuration
+        :param config: config to be
+        :param key: key to comment-out
+        :param value: optional value (or None)
+        :return:
+        """
+        return Comment(Comment.comment_out_key(config, key, value))
 
 
 # #################################################################################################
diff --git a/proptool/report/group.py b/proptool/report/group.py
index d71b7235..10eb6b96 100644
--- a/proptool/report/group.py
+++ b/proptool/report/group.py
@@ -43,7 +43,7 @@ def empty(self) -> bool:
         return (self.errors + self.warnings) == 0
 
     def warn(self, line: Union[str, int, None], msg: str, trans_key: Union[str, None] = None) -> None:
-        if not isinstance(line, str):
+        if line and not isinstance(line, str):
             line = str(line)
 
         self.append(Warn(line, msg, trans_key))
diff --git a/proptool/report/items.py b/proptool/report/items.py
index 4b5c70c9..5b54f292 100644
--- a/proptool/report/items.py
+++ b/proptool/report/items.py
@@ -13,8 +13,9 @@
 
 class ReportItem(object):
     def __init__(self, position: Union[str, int, None], msg: str, trans_key: Union[str, None] = None) -> None:
-        if isinstance(position, int):
-            position = str(position)
+        if position is not None:
+            if isinstance(position, int):
+                position = str(position)
 
         self.position = position
         self.msg = msg
diff --git a/tests/checks/test_missing_translations.py b/tests/checks/test_missing_translations.py
index f11b840c..b3c2abda 100644
--- a/tests/checks/test_missing_translations.py
+++ b/tests/checks/test_missing_translations.py
@@ -9,11 +9,10 @@
 import random
 from typing import Dict, Union
 
-from proptool.prop.items import Comment
 from proptool.checks.base.check import Check
 from proptool.checks.missing_translation import MissingTranslation
-from proptool.config.config import Config
 from proptool.decorators.overrides import overrides
+from proptool.prop.items import Comment
 from tests.checks.checks_test_case import ChecksTestCase
 
 
@@ -53,10 +52,12 @@ def test_translation_with_keys_in_comments(self) -> None:
         # put remaining keys into comments
         remaining_keys = ref_keys[(how_many_less * -1):]
         for key in remaining_keys:
-            key_comment = Config.DEFAULT_COMMENT_TEMPLATE.replace('KEY', key)
-            key_comment = key_comment.replace('COM', Config.ALLOWED_COMMENT_MARKERS[0])
-            key_comment = key_comment.replace('SEP', Config.ALLOWED_SEPARATORS[0])
-            trans_file.append(Comment(key_comment))
+            if random.randint(0, 1) == 0:
+                comment = Comment.get_commented_out_key_comment(self.config, key)
+            else:
+                val = self.get_random_string('translation_')
+                comment = Comment.get_commented_out_key_comment(self.config, key, val)
+            trans_file.append(comment)
 
         # We expect no issues in non-strict mode
         self.checker.config['strict'] = False
diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 77b3c272..36d71761 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -381,7 +381,7 @@ def test_update(self) -> None:
                     translation.append(Translation(ref_item.key, self.get_random_string(f'translation_{ref_idx}')))
                 else:
                     # or commented out key
-                    translation.append(Comment.get_commented_out_key_comment(ref_item.key, ref_item.value, config))
+                    translation.append(Comment.get_commented_out_key_comment(config, ref_item.key, ref_item.value))
                     mut_com_cnt += 1
                 continue
             translation.append(ref_item)
@@ -421,7 +421,7 @@ def test_update(self) -> None:
                     self.assertEqual(translation_clone.items[ref_idx].value, trans_item.value)
                     continue
                 if isinstance(trans_item, Comment):
-                    expected = Comment.comment_out_key(ref_item.key, ref_item.value, config)
+                    expected = Comment.comment_out_key(config, ref_item.key, ref_item.value)
                     self.assertEqual(expected, trans_item.to_string())
                     continue
 

From bf937e3847ea3207c65011b03f59792efb7acb7c Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Sun, 1 Aug 2021 23:39:15 +0200
Subject: [PATCH 121/140] Corrected tests

---
 docs/checks/missing-translations.md       |  2 --
 proptool/checks/missing_translation.py    |  3 ++-
 proptool/config/config.py                 | 15 ++++++++++++---
 proptool/config/config_builder.py         | 13 +------------
 proptool/prop/file.py                     | 10 +---------
 proptool/prop/items.py                    |  2 +-
 tests/checks/checks_test_case.py          |  6 ++----
 tests/checks/test_missing_translations.py | 12 +++++++-----
 tests/config/test_config_builder.py       | 23 +++--------------------
 9 files changed, 29 insertions(+), 57 deletions(-)

diff --git a/docs/checks/missing-translations.md b/docs/checks/missing-translations.md
index 2f11e4b9..3ddde493 100644
--- a/docs/checks/missing-translations.md
+++ b/docs/checks/missing-translations.md
@@ -46,8 +46,6 @@ someKey = Hello
 the `newlyAddedKey` will be considered "present" in translation, despite being commented out. If you want to ensure there are all
 translated, you need to use `--strict` mode instead of default loose check mode.
 
-Default format can be changed using `--template` argument or `template` config entry.
-
 ## Configuration file ##
 
 No dedicated configuration.
diff --git a/proptool/checks/missing_translation.py b/proptool/checks/missing_translation.py
index 437b0a49..28ba9f7d 100644
--- a/proptool/checks/missing_translation.py
+++ b/proptool/checks/missing_translation.py
@@ -29,6 +29,7 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
         report = ReportGroup('Missing keys')
 
         translation_keys = translation_file.keys.copy()
+
         missing_keys: List[str] = []
         for ref_key in reference_file.keys:
             if ref_key in translation_keys:
@@ -39,7 +40,7 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
         # Commented out keys are also considered present in the translation unless
         # we run in strict check mode.
         if not self.config['strict']:
-            commented_out_keys = translation_file.commented_out_keys.copy()
+            commented_out_keys = translation_file.commented_out_keys
             for comm_key in commented_out_keys:
                 if comm_key in missing_keys:
                     missing_keys.remove(comm_key)
diff --git a/proptool/config/config.py b/proptool/config/config.py
index e35d89ae..490b50b1 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -19,13 +19,24 @@ class Config(object):
     COMMENT_TEMPLATE_LITERALS: List[str] = ['COM', 'KEY', 'SEP']
     DEFAULT_FILE_SUFFIX: str = '.properties'
 
+    # DEFAULT_COMMENT_TEMPLATE: str = 'COM ==> KEY SEP VAL'
+
     # COM: comment marker
     # KEY: translation key
     # SEP: "key SEP value" separator
     # VAL: original string
-    DEFAULT_COMMENT_TEMPLATE: str = 'COM ==> KEY SEP VAL'
+    COMMENTED_TRANS_TPL: str = 'COM ==> KEY SEP VAL'
+    COMMENTED_TRANS_REGEXP = r'^[{com}]\s*==>\s*{key}\s*[{sep}].*'.format(
+        com = ''.join(ALLOWED_COMMENT_MARKERS),
+        # must be in () brackets to form a group used later!
+        key = r'([a-zAz][a-zA-z0-9_.-]+)',
+        sep = ''.join(ALLOWED_SEPARATORS))
 
     def __init__(self):
+        """
+        NOTE: Do NOT put any non-configurable elements as Config's instance attributes as by design
+        it is assumed that any attribute can be modified, while consts cannot.
+        """
         self.config_file = None
 
         self.file_suffix = Config.DEFAULT_FILE_SUFFIX
@@ -43,9 +54,7 @@ def __init__(self):
         self.languages: List[str] = []
 
         self.separator: str = '='
-
         self.comment_marker: str = '#'
-        self.comment_template: str = Config.DEFAULT_COMMENT_TEMPLATE
 
         self.checks: Dict[str, CheckerInfo] = {
             # empty set. Populated and manipulated by ConfigBuilder
diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index ef1b4afc..68fd5b19 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -117,7 +117,6 @@ def _set_from_args(config: Config, args) -> None:
         optionals = [
             'separator',
             'comment_marker',
-            'comment_template',
             'quiet',
             'verbose',
         ]
@@ -152,7 +151,7 @@ def _parse_args() -> argparse:
 
         group = parser.add_argument_group('Base options')
         group.add_argument('--config', action = 'store', dest = 'config_file', nargs = 1, metavar = 'FILE',
-                           help = 'Use specified config file. Note: command line arguments can override config!')
+                           help = 'Use specified config file. Command line arguments override config settings.')
         group.add_argument('-b', '--base', action = 'store', dest = 'files', nargs = '+', metavar = 'FILE',
                            help = 'List of base files to check.')
         group.add_argument('-l', '--lang', action = 'store', dest = 'languages', nargs = '+', metavar = 'LANG',
@@ -161,16 +160,12 @@ def _parse_args() -> argparse:
         group = parser.add_argument_group('Additional options')
         group.add_argument('--update', action = 'store_true', dest = 'update',
                            help = 'Updates translation files in-place using base file as reference. No backup!')
-        # group.add_argument('--pe', '--punctuation-exception', dest = 'punctuation_exception_langs', nargs = '*', metavar = 'LANG',
-        #                    help = 'List of languages for which punctuation mismatch should not be checked for, i.e. "jp"')
         group.add_argument('--separator', action = 'store', dest = 'separator', metavar = 'CHAR', nargs = 1,
                            help = 'If specified, only given CHAR is considered a valid key/value separator.'
                                   + f'Must be one of the following: {", ".join(Config.ALLOWED_SEPARATORS)}')
         group.add_argument('--comment', action = 'store', dest = 'comment_marker', metavar = 'CHAR', nargs = 1,
                            help = 'If specified, only given CHAR is considered valid comment marker.'
                                   + f'Must be one of the following: {", ".join(Config.ALLOWED_COMMENT_MARKERS)}')
-        group.add_argument('-t', '--template', action = 'store', dest = 'comment_template', metavar = 'TEMPLATE', nargs = 1,
-                           help = f'Format of commented-out entries. Default: "{Config.DEFAULT_COMMENT_TEMPLATE}".')
         group.add_argument('--suffix', action = 'store', dest = 'file_suffix', metavar = 'STRING', nargs = 1,
                            help = f'Default file name suffix. Default: "{Config.DEFAULT_FILE_SUFFIX}".')
 
@@ -224,9 +219,3 @@ def _validate_args(args):
         # Comment marker character.
         if args.comment_marker and args.comment_marker not in Config.ALLOWED_COMMENT_MARKERS:
             ConfigBuilder._abort(f'Invalid comment marker. Must be one of: {", ".join(Config.ALLOWED_COMMENT_MARKERS)}')
-
-        # Comment template.
-        if args.comment_template:
-            for placeholder in Config.COMMENT_TEMPLATE_LITERALS:
-                if args.comment_template.find(placeholder) == -1:
-                    ConfigBuilder._abort(f'Missing literal in comment template: "{placeholder}".')
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 5e29ef2c..c0a5119e 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -46,14 +46,6 @@ def __init__(self, config: Config, language: str = None):
         # This call is most likely redundant here.
         self.init_container(language)
 
-        comment_pattern = re.escape(self.config.comment_template).replace(
-            'COM', f'[{"".join(Config.ALLOWED_COMMENT_MARKERS)}]').replace(
-            'SEP', f'[{"".join(Config.ALLOWED_SEPARATORS)}]')
-        # NOTE: key pattern must be in () brackets to form a group used later!
-        comment_pattern = comment_pattern.replace('KEY', '([a-zAz][a-zA-z0-9_.-]+)')
-        comment_pattern = comment_pattern.replace('VAL', '(.*)')
-        self.comment_pattern = f'^{comment_pattern}'
-
     def init_container(self, language: str) -> None:
         self._items = []
         self.keys = []
@@ -106,7 +98,7 @@ def append(self, items: Union[List[PropItem], PropItem]) -> None:
                 self.keys.append(single_item.key)
             elif isinstance(single_item, Comment):
                 # Let's look for commented out keys.
-                match = re.compile(self.comment_pattern).match(single_item.value)
+                match = re.compile(Config.COMMENTED_TRANS_REGEXP).match(single_item.value)
                 if match:
                     self.commented_out_keys.append(match.group(1))
             self._items.append(single_item)
diff --git a/proptool/prop/items.py b/proptool/prop/items.py
index 7c9f4abb..86bea209 100644
--- a/proptool/prop/items.py
+++ b/proptool/prop/items.py
@@ -95,7 +95,7 @@ def comment_out_key(config: Config, key: str, value: Union[str, None]) -> str:
         if value is None:
             value = ''
 
-        return config.DEFAULT_COMMENT_TEMPLATE.replace(
+        return config.COMMENTED_TRANS_TPL.replace(
             'KEY', key).replace(
             'COM', config.ALLOWED_COMMENT_MARKERS[0]).replace(
             'SEP', config.ALLOWED_SEPARATORS[0]).replace(
diff --git a/tests/checks/checks_test_case.py b/tests/checks/checks_test_case.py
index 0048a89e..49a58271 100644
--- a/tests/checks/checks_test_case.py
+++ b/tests/checks/checks_test_case.py
@@ -56,13 +56,11 @@ def build_prepfile(self, contents: Union[List[str], List[PropItem]], lower: bool
 
         for item in contents:
             if isinstance(item, str):
-                prep_file.keys.append(item)
                 value = self.get_random_string()
                 if lower:
                     value = value.lower()
-                prep_file.items.append(Translation(item, value))
-                continue
-            elif isinstance(item, (Translation, Comment)):
+                prep_file.append(Translation(item, value))
+            elif isinstance(item, PropItem):
                 prep_file.append(item)
             else:
                 raise RuntimeError(f'Unsupported content type: {type(item)}')
diff --git a/tests/checks/test_missing_translations.py b/tests/checks/test_missing_translations.py
index b3c2abda..17a28f6e 100644
--- a/tests/checks/test_missing_translations.py
+++ b/tests/checks/test_missing_translations.py
@@ -35,11 +35,13 @@ def test_no_faults(self) -> None:
 
     def test_translation_with_keys_in_comments(self) -> None:
         """
-        Checks if we have no issues reported when running in non-strict mode and having some keys in comments.
+        Checks if we have no issues reported when running in non-strict mode and having some translation
+        keys in commented-out form, like:
+        # ==> KEY =
         """
-        # generate some keys for reference file
-        cnt_min = 20
-        cnt_max = 40
+        # Generate some keys for reference file.
+        cnt_min = 10
+        cnt_max = 15
         ref_keys = [self.get_random_string('key_') for _ in range(random.randint(cnt_min, cnt_max))]
 
         # have less keys for translation file
@@ -49,7 +51,7 @@ def test_translation_with_keys_in_comments(self) -> None:
         ref_file = self.build_prepfile(ref_keys)
         trans_file = self.build_prepfile(trans_keys)
 
-        # put remaining keys into comments
+        # Put remaining keys into comments.
         remaining_keys = ref_keys[(how_many_less * -1):]
         for key in remaining_keys:
             if random.randint(0, 1) == 0:
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index fa7fed65..2c34e997 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -30,7 +30,8 @@ def __init__(self):
         self.languages: List[str] = []
         self.separator: Union[str, None] = None
         self.comment_marker: Union[str, None] = None
-        self.comment_template: Union[str, None] = None
+        self.commented_translation_template: Union[str, None] = None
+        self.commented_translation_regexp: Union[str, None] = None
 
         self.config_file = None
 
@@ -333,24 +334,6 @@ def test_validate_args_invalid_comment_marker(self, log_e_mock: Mock) -> None:
             self.assertEqual(SystemExit, type(context_manager.exception))
             self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
 
-    @patch('proptool.log.Log.e')
-    def test_validate_args_missing_literal(self, log_e_mock: Mock) -> None:
-        args = FakeArgs()
-
-        for missing_literal in Config.COMMENT_TEMPLATE_LITERALS:
-            tmp = copy.copy(Config.COMMENT_TEMPLATE_LITERALS)
-            del tmp[tmp.index(missing_literal)]
-            args.comment_template = ' '.join(tmp)
-
-            with self.assertRaises(SystemExit) as context_manager:
-                ConfigBuilder._validate_args(args)
-                exp_calls = [call(f'Missing literal in comment template: "{missing_literal}".')]
-                log_e_mock.assert_has_calls(exp_calls)
-
-                # Check we got sys.exit called with non-zero return code
-                self.assertEqual(SystemExit, type(context_manager.exception))
-                self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
-
     # #################################################################################################
 
     def test_parse_args_returns_all_keys(self) -> None:
@@ -377,7 +360,7 @@ def test_parse_args_returns_no_more_keys(self) -> None:
         sys.argv[1:] = []  # noqa: WPS362
         args = vars(ConfigBuilder._parse_args())  # noqa: WPS421
 
-        # Eliminate --no-<KEY> related keys first as these are not mapped directly.
+        # Eliminate --no-<KEY> related keys first as these are not mapped to Config's attributes directly.
         for pair_key in ConfigBuilder._on_off_pairs:
             del args[f'no_{pair_key}']
 

From 93dd09128cb13e690acf9900f0c1a4b0dddf6eb9 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 00:10:43 +0200
Subject: [PATCH 122/140] Reworked base files check runs

---
 proptool/checks/brackets.py                    |  6 ++++--
 proptool/checks/formatting_values.py           |  2 --
 proptool/checks/key_format.py                  |  6 ++++--
 proptool/checks/quotation_marks.py             |  6 ++++--
 proptool/checks/trailing_white_chars.py        |  6 +++++-
 proptool/checks/typesetting_quotation_marks.py |  6 ++++--
 proptool/checks/white_chars_before_linefeed.py |  5 ++++-
 proptool/config/config.py                      |  2 --
 proptool/config/config_builder.py              |  4 +---
 proptool/main.py                               | 16 +++++++++++-----
 proptool/report/report.py                      |  6 ++++++
 tests/config/test_config_builder.py            | 10 +++++-----
 12 files changed, 48 insertions(+), 27 deletions(-)

diff --git a/proptool/checks/brackets.py b/proptool/checks/brackets.py
index 195c32a0..c942946c 100644
--- a/proptool/checks/brackets.py
+++ b/proptool/checks/brackets.py
@@ -7,7 +7,7 @@
 #
 """
 
-from typing import Dict, List
+from typing import Dict, List, Union
 
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Comment, Translation
@@ -30,7 +30,9 @@ class Brackets(Check):
     opened brackets are closed.
     """
 
-    _is_single_file_check = True
+    def __init__(self, config: Union[Dict, None] = None):
+        super().__init__(config)
+        self.is_single_file_check = True
 
     report_title = 'Brackets'
 
diff --git a/proptool/checks/formatting_values.py b/proptool/checks/formatting_values.py
index 43a8f92f..1b80b98c 100644
--- a/proptool/checks/formatting_values.py
+++ b/proptool/checks/formatting_values.py
@@ -31,8 +31,6 @@ class FormattingValues(Check):
     then translation uses it as well and in the same order.
     """
 
-    _is_single_file_check = True
-
     def _parse(self, item: str) -> List[Formatter]:
         # https://docs.oracle.com/javase/7/docs/api/java/util/Formatter.html
         # %[argument_index$][flags][width][.precision]conversion
diff --git a/proptool/checks/key_format.py b/proptool/checks/key_format.py
index b8208501..95995d80 100644
--- a/proptool/checks/key_format.py
+++ b/proptool/checks/key_format.py
@@ -8,7 +8,7 @@
 """
 
 import re
-from typing import Dict
+from typing import Dict, Union
 
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Translation
@@ -24,7 +24,9 @@ class KeyFormat(Check):
     This check verifies that translation keys follow specified naming convention.
     """
 
-    _is_single_file_check = True
+    def __init__(self, config: Union[Dict, None] = None):
+        super().__init__(config)
+        self.is_single_file_check = True
 
     @overrides(Check)
     # Do NOT "fix" the PropFile reference and do not import it, or you step on circular dependency!
diff --git a/proptool/checks/quotation_marks.py b/proptool/checks/quotation_marks.py
index bff5f867..e300f94f 100644
--- a/proptool/checks/quotation_marks.py
+++ b/proptool/checks/quotation_marks.py
@@ -7,7 +7,7 @@
 #
 """
 
-from typing import Dict, List
+from typing import Dict, List, Union
 
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Comment, Translation
@@ -30,7 +30,9 @@ class QuotationMarks(Check):
     opened marks got their closing pair.
     """
 
-    _is_single_file_check = True
+    def __init__(self, config: Union[Dict, None] = None):
+        super().__init__(config)
+        self.is_single_file_check = True
 
     @overrides(Check)
     # Do NOT "fix" the PropFile reference and do not import it, or you step on circular dependency!
diff --git a/proptool/checks/trailing_white_chars.py b/proptool/checks/trailing_white_chars.py
index a831828b..392cfae3 100644
--- a/proptool/checks/trailing_white_chars.py
+++ b/proptool/checks/trailing_white_chars.py
@@ -7,6 +7,8 @@
 #
 """
 
+from typing import Dict, Union
+
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Comment, Translation
 from proptool.report.group import ReportGroup
@@ -21,7 +23,9 @@ class TrailingWhiteChars(Check):
     Checks if file has trailing white characters at the end of each line.
     """
 
-    _is_single_file_check = True
+    def __init__(self, config: Union[Dict, None] = None):
+        super().__init__(config)
+        self.is_single_file_check = True
 
     @overrides(Check)
     # Do NOT "fix" the PropFile reference and do not import it, or you step on circular dependency!
diff --git a/proptool/checks/typesetting_quotation_marks.py b/proptool/checks/typesetting_quotation_marks.py
index 79e138e6..8028eaea 100644
--- a/proptool/checks/typesetting_quotation_marks.py
+++ b/proptool/checks/typesetting_quotation_marks.py
@@ -7,7 +7,7 @@
 #
 """
 
-from typing import Dict, List
+from typing import Dict, List, Union
 
 from proptool.decorators.overrides import overrides
 from proptool.report.group import ReportGroup
@@ -21,7 +21,9 @@ class TypesettingQuotationMarks(Brackets):
     ensures proper nesting and checks if all opened brackets are closed.
     """
 
-    _is_single_file_check = True
+    def __init__(self, config: Union[Dict, None] = None):
+        super().__init__(config)
+        self.is_single_file_check = True
 
     report_title = ReportGroup('Print Quotation Marks')
 
diff --git a/proptool/checks/white_chars_before_linefeed.py b/proptool/checks/white_chars_before_linefeed.py
index 46a9c32d..a557f3e2 100644
--- a/proptool/checks/white_chars_before_linefeed.py
+++ b/proptool/checks/white_chars_before_linefeed.py
@@ -6,6 +6,7 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+from typing import Dict, Union
 
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Translation
@@ -20,7 +21,9 @@ class WhiteCharsBeforeLinefeed(Check):
     This check ensures there's no space before "\n", "\r" literals.
     """
 
-    is_single_file_check = True
+    def __init__(self, config: Union[Dict, None] = None):
+        super().__init__(config)
+        self.is_single_file_check = True
 
     def _scan(self, report: ReportGroup, idx: int, item: Translation, literal: str) -> bool:
         literal_len = len(literal)
diff --git a/proptool/config/config.py b/proptool/config/config.py
index 490b50b1..a6a689a0 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -19,8 +19,6 @@ class Config(object):
     COMMENT_TEMPLATE_LITERALS: List[str] = ['COM', 'KEY', 'SEP']
     DEFAULT_FILE_SUFFIX: str = '.properties'
 
-    # DEFAULT_COMMENT_TEMPLATE: str = 'COM ==> KEY SEP VAL'
-
     # COM: comment marker
     # KEY: translation key
     # SEP: "key SEP value" separator
diff --git a/proptool/config/config_builder.py b/proptool/config/config_builder.py
index 68fd5b19..3b46439a 100644
--- a/proptool/config/config_builder.py
+++ b/proptool/config/config_builder.py
@@ -39,7 +39,7 @@ class ConfigBuilder(object):
     ]
 
     @staticmethod
-    def build(config_defaults: Config) -> Config:
+    def build(config_defaults: Config):
         checkers = [
             Brackets,
             DanglingKeys,
@@ -71,8 +71,6 @@ def build(config_defaults: Config) -> Config:
 
         ConfigBuilder._validate_config(config_defaults)
 
-        return config_defaults
-
     @staticmethod
     def _abort(msg: str) -> None:
         Log.e(msg)
diff --git a/proptool/main.py b/proptool/main.py
index beef6c0d..b0920853 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -32,10 +32,12 @@ def start() -> int:
                 Log.banner(Const.APP_DESCRIPTION)
                 return 0
 
-            config_defaults = Config()
+            # Config with built-in defaults
+            config = Config()
             # Configure Log with defaults (i.e. colors etc)
-            Log.configure(config_defaults)
-            config = ConfigBuilder.build(config_defaults)
+            Log.configure(config)
+            # Parse args and update the config if needed
+            ConfigBuilder.build(config)
             # Reconfigure once we got user settings handled.
             Log.configure(config)
 
@@ -61,6 +63,7 @@ def start() -> int:
                     Utils.abort()
 
                 # Validate base file.
+                checks_executed = 0
                 for _, checker_info in config.checks.items():
                     # Almost any check validates translation against reference file, so we cannot use all checks here,
                     # but there are some that process single file independently so they in fact do not need any reference
@@ -70,13 +73,16 @@ def start() -> int:
                         # Each validator gets copy of the files, to prevent any potential destructive operation.
                         propfile_copy = copy.copy(reference_propfile)
                         reference_propfile.report.add(checker.check(propfile_copy))
+                        checks_executed += 1
 
-                if not reference_propfile.report.empty():
+                if reference_propfile.report.not_empty():
                     # There's something to fix, but not necessary critical.
                     reference_propfile.report.dump()
+                else:
+                    Log.v(f'Checks passed: {checks_executed}.')
 
                 # No reference files errors. Warnings are just fine, though.
-                if not reference_propfile.report.is_fatal():
+                if reference_propfile.report.is_ok():
                     for lang in config.languages:
                         translation_path = Path(reference_path.parent / f'{name_prefix}_{lang}.{name_suffix}')
                         translation_propfile = PropFile(config)
diff --git a/proptool/report/report.py b/proptool/report/report.py
index 7692ab8f..7fae61b4 100644
--- a/proptool/report/report.py
+++ b/proptool/report/report.py
@@ -38,6 +38,9 @@ def warnings(self) -> int:
         """
         return sum(group.warnings for group in self._groups)
 
+    def is_ok(self) -> bool:
+        return not self.is_fatal()
+
     def is_fatal(self) -> bool:
         """
         Helper to determine if report contains fatal errors.
@@ -60,6 +63,9 @@ def add(self, report_group: ReportGroup, skip_empty: bool = True) -> None:
     def empty(self) -> bool:
         return not self._groups
 
+    def not_empty(self) -> bool:
+        return self._groups
+
     def dump(self):
         errors = self.errors
         warnings = self.warnings
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index 2c34e997..4397dc86 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -381,18 +381,18 @@ def test_build(self) -> None:
         languages = ['pl', 'de', 'pt']
         args = self._generate_fake_args(languages)
 
-        config_defaults = Config()
+        config = Config()
         file = self.get_random_string('file_')
-        config_defaults.files.append(file)
+        config.files.append(file)
 
         # Pass no args for parsing (this is legit as we have config file that can provide what's needed).
         sys.argv[1:] = []  # noqa: WPS362
         with patch('proptool.config.config_builder.ConfigBuilder._parse_args') as manager:
             manager.return_value = args
 
-            config = ConfigBuilder.build(config_defaults)
+            ConfigBuilder.build(config)
 
             # TODO: make comparision more detailed; add test for langs as well
-            self.assertEqual(len(config_defaults.files), len(config.files))
-            for idx, def_file in enumerate(config_defaults.files):
+            self.assertEqual(len(config.files), len(config.files))
+            for idx, def_file in enumerate(config.files):
                 self.assertEqual(def_file, config.files[idx])

From bef75e8f00ffcd5d324ec8d9ff5019cc6975b2c2 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 00:11:09 +0200
Subject: [PATCH 123/140] Removed unused const

---
 proptool/config/config.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/proptool/config/config.py b/proptool/config/config.py
index a6a689a0..598dfc49 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -16,7 +16,6 @@ class Config(object):
 
     ALLOWED_SEPARATORS: List[str] = ['=', ':']
     ALLOWED_COMMENT_MARKERS: List[str] = ['#', '!']
-    COMMENT_TEMPLATE_LITERALS: List[str] = ['COM', 'KEY', 'SEP']
     DEFAULT_FILE_SUFFIX: str = '.properties'
 
     # COM: comment marker
@@ -55,7 +54,7 @@ def __init__(self):
         self.comment_marker: str = '#'
 
         self.checks: Dict[str, CheckerInfo] = {
-            # empty set. Populated and manipulated by ConfigBuilder
+            # empty set. Populated and manipulated by ConfigBuilder.
         }
 
     def set_checker_config(self, checker_id: str, config: Dict) -> None:

From 37499c60b9f411d9e421e636fe21e0d4cbe1b67e Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 09:17:33 +0200
Subject: [PATCH 124/140] Renamed config_builder.py to builder.py

---
 .flake8                                           | 2 +-
 proptool/config/{config_builder.py => builder.py} | 0
 proptool/main.py                                  | 2 +-
 tests/config/test_config_builder.py               | 4 ++--
 4 files changed, 4 insertions(+), 4 deletions(-)
 rename proptool/config/{config_builder.py => builder.py} (100%)

diff --git a/.flake8 b/.flake8
index bad7f0f9..8ceb17cd 100644
--- a/.flake8
+++ b/.flake8
@@ -94,7 +94,7 @@ per-file-ignores =
     # WPS433 Found nested import
     # WPS425 Found boolean non-keyword argument: True, False
     proptool/config/config_reader.py: WPS609, WPS421, WPS204, WPS529, WPS433,
-    proptool/config/config_builder.py: WPS609, WPS301, WPS437, WPS213, WPS425,
+    proptool/config/builder.py: WPS609, WPS301, WPS437, WPS213, WPS425,
 
     # WPS111 Found too short name
     # WPS214 Found too many methods
diff --git a/proptool/config/config_builder.py b/proptool/config/builder.py
similarity index 100%
rename from proptool/config/config_builder.py
rename to proptool/config/builder.py
diff --git a/proptool/main.py b/proptool/main.py
index b0920853..62f53405 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -12,7 +12,7 @@
 from pathlib import Path
 
 from proptool.config.config import Config
-from proptool.config.config_builder import ConfigBuilder
+from proptool.config.builder import ConfigBuilder
 from proptool.prop.file import PropFile
 from .const import Const
 from .log import Log
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index 4397dc86..bc017159 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -15,7 +15,7 @@
 from unittest.mock import Mock, call, patch
 
 from proptool.config.config import Config
-from proptool.config.config_builder import ConfigBuilder
+from proptool.config.builder import ConfigBuilder
 from proptool.utils import Utils
 from tests.test_case import TestCase
 
@@ -387,7 +387,7 @@ def test_build(self) -> None:
 
         # Pass no args for parsing (this is legit as we have config file that can provide what's needed).
         sys.argv[1:] = []  # noqa: WPS362
-        with patch('proptool.config.config_builder.ConfigBuilder._parse_args') as manager:
+        with patch('proptool.config.builder.ConfigBuilder._parse_args') as manager:
             manager.return_value = args
 
             ConfigBuilder.build(config)

From 794f7d0e90b5144cc7187b6d8b0576222dda1466 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 09:18:19 +0200
Subject: [PATCH 125/140] Renamed config_reader.py to reader.py

---
 .flake8                                         | 2 +-
 proptool/config/builder.py                      | 2 +-
 proptool/config/{config_reader.py => reader.py} | 0
 3 files changed, 2 insertions(+), 2 deletions(-)
 rename proptool/config/{config_reader.py => reader.py} (100%)

diff --git a/.flake8 b/.flake8
index 8ceb17cd..e4ab5759 100644
--- a/.flake8
+++ b/.flake8
@@ -93,7 +93,7 @@ per-file-ignores =
     # WPS609 Found direct magic attribute usage: __setattr__, __getattr__, ...
     # WPS433 Found nested import
     # WPS425 Found boolean non-keyword argument: True, False
-    proptool/config/config_reader.py: WPS609, WPS421, WPS204, WPS529, WPS433,
+    proptool/config/reader.py: WPS609, WPS421, WPS204, WPS529, WPS433,
     proptool/config/builder.py: WPS609, WPS301, WPS437, WPS213, WPS425,
 
     # WPS111 Found too short name
diff --git a/proptool/config/builder.py b/proptool/config/builder.py
index 3b46439a..1f65dc95 100644
--- a/proptool/config/builder.py
+++ b/proptool/config/builder.py
@@ -25,7 +25,7 @@
 from proptool.checks.white_chars_before_linefeed import WhiteCharsBeforeLinefeed
 from proptool.config.checker_info import CheckerInfo
 from proptool.config.config import Config
-from proptool.config.config_reader import ConfigReader
+from proptool.config.reader import ConfigReader
 from proptool.const import Const
 from proptool.log import Log
 from proptool.utils import Utils
diff --git a/proptool/config/config_reader.py b/proptool/config/reader.py
similarity index 100%
rename from proptool/config/config_reader.py
rename to proptool/config/reader.py

From ad37eb23aaa0a4c8ab1fb99147c83a0f61709d9e Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 09:19:10 +0200
Subject: [PATCH 126/140] Renamed MissingTranslation to MissingTranslations

---
 .../{missing_translation.py => missing_translations.py}       | 2 +-
 proptool/config/builder.py                                    | 4 ++--
 tests/checks/test_missing_translations.py                     | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)
 rename proptool/checks/{missing_translation.py => missing_translations.py} (98%)

diff --git a/proptool/checks/missing_translation.py b/proptool/checks/missing_translations.py
similarity index 98%
rename from proptool/checks/missing_translation.py
rename to proptool/checks/missing_translations.py
index 28ba9f7d..5062a5f4 100644
--- a/proptool/checks/missing_translation.py
+++ b/proptool/checks/missing_translations.py
@@ -16,7 +16,7 @@
 # #################################################################################################
 
 # noinspection PyUnresolvedReferences
-class MissingTranslation(Check):
+class MissingTranslations(Check):
     """
     This check checks if given base key is also present in translation file.
     """
diff --git a/proptool/config/builder.py b/proptool/config/builder.py
index 1f65dc95..fe95dfed 100644
--- a/proptool/config/builder.py
+++ b/proptool/config/builder.py
@@ -16,7 +16,7 @@
 from proptool.checks.empty_translations import EmptyTranslations
 from proptool.checks.formatting_values import FormattingValues
 from proptool.checks.key_format import KeyFormat
-from proptool.checks.missing_translation import MissingTranslation
+from proptool.checks.missing_translations import MissingTranslations
 from proptool.checks.punctuation import Punctuation
 from proptool.checks.quotation_marks import QuotationMarks
 from proptool.checks.starts_with_the_same_case import StartsWithTheSameCase
@@ -46,7 +46,7 @@ def build(config_defaults: Config):
             EmptyTranslations,
             FormattingValues,
             KeyFormat,
-            MissingTranslation,
+            MissingTranslations,
             Punctuation,
             QuotationMarks,
             StartsWithTheSameCase,
diff --git a/tests/checks/test_missing_translations.py b/tests/checks/test_missing_translations.py
index 17a28f6e..1947f61d 100644
--- a/tests/checks/test_missing_translations.py
+++ b/tests/checks/test_missing_translations.py
@@ -10,7 +10,7 @@
 from typing import Dict, Union
 
 from proptool.checks.base.check import Check
-from proptool.checks.missing_translation import MissingTranslation
+from proptool.checks.missing_translations import MissingTranslations
 from proptool.decorators.overrides import overrides
 from proptool.prop.items import Comment
 from tests.checks.checks_test_case import ChecksTestCase
@@ -20,7 +20,7 @@ class TestMissingTranslations(ChecksTestCase):
 
     @overrides(ChecksTestCase)
     def get_checker(self, config: Union[Dict, None] = None) -> Check:
-        return MissingTranslation(config)
+        return MissingTranslations(config)
 
     # #################################################################################################
 

From 03c8ad8b3488496bda492c3dc2850dfa231f698b Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 09:26:57 +0200
Subject: [PATCH 127/140] Unified spelling of `propfile`

---
 proptool/main.py                 | 28 +++++++-------
 proptool/prop/file.py            |  6 +--
 tests/checks/checks_test_case.py |  8 ++--
 tests/prop/test_file.py          | 64 ++++++++++++++++----------------
 4 files changed, 53 insertions(+), 53 deletions(-)

diff --git a/proptool/main.py b/proptool/main.py
index 62f53405..d355e800 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -55,9 +55,9 @@ def start() -> int:
                 # Main push
                 Log.push(f'Base: {reference_path}')
 
-                reference_propfile = PropFile(config)
+                reference = PropFile(config)
                 try:  # noqa: WPS505
-                    reference_propfile.load(reference_path)
+                    reference.load(reference_path)
                 except FileNotFoundError:
                     Log.e(f'File not found: {reference_path}')
                     Utils.abort()
@@ -71,37 +71,37 @@ def start() -> int:
                     checker = checker_info.callable(checker_info.config)
                     if checker.is_single_file_check:
                         # Each validator gets copy of the files, to prevent any potential destructive operation.
-                        propfile_copy = copy.copy(reference_propfile)
-                        reference_propfile.report.add(checker.check(propfile_copy))
+                        reference_copy = copy.copy(reference)
+                        reference.report.add(checker.check(reference_copy))
                         checks_executed += 1
 
-                if reference_propfile.report.not_empty():
+                if reference.report.not_empty():
                     # There's something to fix, but not necessary critical.
-                    reference_propfile.report.dump()
+                    reference.report.dump()
                 else:
                     Log.v(f'Checks passed: {checks_executed}.')
 
                 # No reference files errors. Warnings are just fine, though.
-                if reference_propfile.report.is_ok():
+                if reference.report.is_ok():
                     for lang in config.languages:
                         translation_path = Path(reference_path.parent / f'{name_prefix}_{lang}.{name_suffix}')
-                        translation_propfile = PropFile(config)
+                        translation = PropFile(config)
 
                         try:  # noqa: WPS505
-                            translation_propfile.load(translation_path, lang)
+                            translation.load(translation_path, lang)
                             trans_level_label = f'{lang.upper()}: {translation_path}'
                             Log.push(trans_level_label, deferred = True)
 
-                            is_translation_valid = translation_propfile.is_valid(reference_propfile)
+                            is_translation_valid = translation.is_valid(reference)
 
                             if not is_translation_valid:
-                                translation_propfile.report.dump()
+                                translation.report.dump()
                                 errors += 1
 
                             if config.update:
-                                if translation_propfile.file:
-                                    translation_propfile.update(reference_propfile)
-                                    translation_propfile.save()
+                                if translation.file:
+                                    translation.update(reference)
+                                    translation.save()
 
                             if Log.pop():
                                 Log.i(f'%ok%{trans_level_label}: OK')
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index c0a5119e..b9cbdac9 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -105,7 +105,7 @@ def append(self, items: Union[List[PropItem], PropItem]) -> None:
 
     # #################################################################################################
 
-    def update(self, reference_propfile: 'PropFile') -> None:
+    def update(self, reference: 'PropFile') -> None:
         """
         Rewrites content of the file using reference file as foundation. It then adds all keys from reference files.
         The update rules are as follow:
@@ -114,12 +114,12 @@ def update(self, reference_propfile: 'PropFile') -> None:
         * all reference files comments are copied to,
         * dangling keys and translation file comments are gone.
 
-        :param reference_propfile:
+        :param reference:
         """
 
         tmp = PropFile(self.config)
 
-        for idx, item in enumerate(reference_propfile.items):
+        for idx, item in enumerate(reference.items):
             # Copy comments and blank lines as-is
             if isinstance(item, (Comment, Blank)):
                 tmp.append(item)
diff --git a/tests/checks/checks_test_case.py b/tests/checks/checks_test_case.py
index 49a58271..3d32a458 100644
--- a/tests/checks/checks_test_case.py
+++ b/tests/checks/checks_test_case.py
@@ -33,11 +33,11 @@ def get_checker(self, config: Union[Dict, None] = None) -> Check:
         raise NotImplementedError
 
     def check_single_file(self, entry: PropItem, exp_errors: int = 0, exp_warnings: int = 0) -> None:
-        prop_file = PropFile(self.config)
-        prop_file.loaded = True
-        prop_file.items.append(entry)
+        propfile = PropFile(self.config)
+        propfile.loaded = True
+        propfile.items.append(entry)
 
-        self.check(prop_file, exp_errors = exp_errors, exp_warnings = exp_warnings)
+        self.check(propfile, exp_errors = exp_errors, exp_warnings = exp_warnings)
 
     def check(self, translation: PropFile, reference: Union[PropFile, None] = None,
               exp_errors: int = 0, exp_warnings: int = 0, dump = False, msg = None) -> None:
diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 36d71761..90f45fa5 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -47,7 +47,7 @@ def _generate_propfile_with_content(self, config: Config) -> PropFile:
 
     def test_append_wrong_arg_type(self) -> None:
         # GIVEN normal instance of PropFile
-        prop_file = PropFile(Config())
+        propfile = PropFile(Config())
 
         # WHEN we try to append object of unsupported type
         obj = 'INVALID'
@@ -55,7 +55,7 @@ def test_append_wrong_arg_type(self) -> None:
         # THEN Exception should be thrown.
         with self.assertRaises(TypeError):
             # noinspection PyTypeChecker
-            prop_file.append(obj)
+            propfile.append(obj)
 
     # #################################################################################################
 
@@ -64,9 +64,9 @@ def test_load_non_existing_file(self) -> None:
         Tests if load() fails on non-existing file correctly.
         """
         file_name = self.get_random_string()
-        prop_file = PropFile(Config())
+        propfile = PropFile(Config())
         with self.assertRaises(Exception) as cm:
-            prop_file.load(Path(file_name))
+            propfile.load(Path(file_name))
             self.assertEqual(FileNotFoundError, type(cm.exception))
 
     @patch('pathlib.Path.exists')
@@ -95,30 +95,30 @@ def test_load_strip_crlf(self, path_exists_mock: Mock) -> None:
                 with patch('builtins.open', mock_open(read_data = ''.join(fake_data_src))):
                     # Lie our fake file exists
                     path_exists_mock.return_value = True
-                    prop_file = PropFile(Config())
-                    prop_file.load(Path('foo'))
+                    propfile = PropFile(Config())
+                    propfile.load(Path('foo'))
 
                     # We should have one entry less, because once we strip CRLF from the last
                     # row, it should overwrite entry set row before.
-                    self.assertEqual(len(fake_data_src) - 1, len(prop_file.items))
+                    self.assertEqual(len(fake_data_src) - 1, len(propfile.items))
 
                     # Let's inspect what we have.
                     idx = 0
 
                     # Line 0
-                    item = prop_file.items[idx]
+                    item = propfile.items[idx]
                     self.assertIsInstance(item, Comment)
                     self.assertEqual(f'{sep} {com0}', item.value)
                     idx += 1
 
                     # Line 1
-                    item = prop_file.items[idx]
+                    item = propfile.items[idx]
                     self.assertIsInstance(item, Comment)
                     self.assertEqual(f'{sep} {com1}', item.value)
                     idx += 1
 
                     # Line 2
-                    item = prop_file.items[idx]
+                    item = propfile.items[idx]
                     self.assertIsInstance(item, Translation)
                     self.assertEqual(key1, item.key)
                     # We have duplicated key. It's not overwritten row. Please see other code comments.
@@ -141,11 +141,11 @@ def test_load_empty_lines_whitespaces(self, path_exists_mock: Mock) -> None:
         with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))):
             # Lie our fake file exists
             path_exists_mock.return_value = True
-            prop_file = PropFile(Config())
-            prop_file.load(Path('foo'))
-            self.assertEqual(len(fake_data_src), len(prop_file.items))
+            propfile = PropFile(Config())
+            propfile.load(Path('foo'))
+            self.assertEqual(len(fake_data_src), len(propfile.items))
 
-            for item in prop_file.items:
+            for item in propfile.items:
                 self.assertIsInstance(item, Blank)
 
     @patch('pathlib.Path.exists')
@@ -157,9 +157,9 @@ def test_load_empty_file(self, path_exists_mock: Mock) -> None:
         with patch('builtins.open', mock_open(read_data = '')):
             # Lie our fake file exists
             path_exists_mock.return_value = True
-            prop_file = PropFile(Config())
-            prop_file.load(Path(fake_file_name))
-            self.assertEqual(0, len(prop_file.items))
+            propfile = PropFile(Config())
+            propfile.load(Path(fake_file_name))
+            self.assertEqual(0, len(propfile.items))
 
     @patch('pathlib.Path.exists')
     def test_load_invalid_translation_syntax(self, path_exists_mock: Mock) -> None:
@@ -188,8 +188,8 @@ def test_load_invalid_translation_syntax(self, path_exists_mock: Mock) -> None:
 
             with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))):
                 try:
-                    prop_file = PropFile(Config())
-                    prop_file.load(Path(fake_file_name))
+                    propfile = PropFile(Config())
+                    propfile.load(Path(fake_file_name))
                 except SystemExit:
                     # sys.exit() happened after Log.e() is called, so we can check the error message here.
                     msg = log_e_mock.call_args_list[0][0][0]
@@ -248,34 +248,34 @@ def assertBlank(blank):
         with patch('builtins.open', mock_open(read_data = '\n'.join(fake_data_src))):
             # Lie our fake file exists
             path_mock.return_value = True
-            prop_file = PropFile(Config())
-            prop_file.load(Path('foo'))
-            self.assertEqual(len(fake_data_src), len(prop_file.items))
+            propfile = PropFile(Config())
+            propfile.load(Path('foo'))
+            self.assertEqual(len(fake_data_src), len(propfile.items))
 
             idx = 0
 
-            item = prop_file.items[idx]
+            item = propfile.items[idx]
             assertBlank(item)
             idx += 1
 
-            item = prop_file.items[idx]
+            item = propfile.items[idx]
             assertComment(item, comment1_marker, comment1_value)
             idx += 1
 
-            item = prop_file.items[idx]
+            item = propfile.items[idx]
             assertTranslation(item, key1, sep1, val1)
             idx += 1
 
-            item = prop_file.items[idx]
+            item = propfile.items[idx]
             assertBlank(item)
             idx += 1
 
-            item = prop_file.items[idx]
+            item = propfile.items[idx]
             assertComment(item, comment2_marker, comment2_value)
             self.assertIsNone(item.key)
             idx += 1
 
-            item = prop_file.items[idx]
+            item = propfile.items[idx]
             assertTranslation(item, key2, sep2, val2)
             idx += 1
 
@@ -349,12 +349,12 @@ def test_is_valid_on_empty_files(self, path_exists_mock: Mock) -> None:
             ref_file = PropFile(config)
             ref_file.load(fake_file)
 
-            prop_file = PropFile(config)
-            prop_file.load(fake_file)
+            propfile = PropFile(config)
+            propfile.load(fake_file)
 
             # Expecting no problems reported
-            prop_file.report.dump()
-            self.assertTrue(prop_file.is_valid(ref_file))
+            propfile.report.dump()
+            self.assertTrue(propfile.is_valid(ref_file))
 
     # #################################################################################################
 

From 3dc0890581452569b4631f562b2858cff701927b Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 10:26:30 +0200
Subject: [PATCH 128/140] Added support for --create option

---
 docs/usage.md                       | 42 +++++++++++++++++------------
 proptool/config/builder.py          |  5 +++-
 proptool/config/config.py           |  1 +
 proptool/main.py                    | 23 ++++++++++------
 proptool/prop/file.py               |  2 +-
 tests/config/test_config_builder.py |  7 +++++
 tests/prop/test_file.py             |  2 +-
 7 files changed, 54 insertions(+), 28 deletions(-)

diff --git a/docs/usage.md b/docs/usage.md
index 2cece4b0..7f838162 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -11,6 +11,9 @@
 * **Usage**
   * [Config file and command line arguments](#config-file-and-command-line)
   * [Usage examples](#usage-examples)
+  * Handling translation files
+    * [Create new translation files](#create-new-translation-files)
+    * [Updating existing translations](#update-existing-translations)
 
 ---
 
@@ -75,33 +78,38 @@ gui_fr.properties
 
 ---
 
-Check if `es` translation of `gui.properties` is in sync and if there are any missing keys, rewrite translation file to contain all
-keys from base:
+### Update existing translations ###
 
-```bash
-prop-tool --base gui --lang es --fix
-```
+You can use `prop-tool` to update your translation files by using `--update` option. In such case `prop-tool` will completely
+rewrite translation files, adding missing keys (in commented out form).
 
----
+While content of written file is strongly based on a reference file. Some normalization will be made though:
+
+* There will be no more than one empty consequent empty line written,
+* There will be no more than one consequent empty comment line (just comment marker) written.
 
-Check if `pt` translation of `gui.properties` is in sync and if there are any missing keys, rewrite translation file to contain all
-keys from base using own comment format:
+Be aware that `--update` do NOT update existing translation file but builds it completely using base file as reference and existing
+translations (if present). No other content of translation files (for example additional comments etc.) will be preserved.
+
+This will check if `es` translation of `gui.properties` is in sync and if there are any issues, rewrite translation file to
+contain all keys from base:
 
 ```bash
-prop-tool --base gui --lang es --fix --tpl "COM >~=-> KEY SEP"
+prop-tool --base gui --lang es --update
 ```
 
 ---
 
-## Updating translations ##
+### Create new translation files ###
 
-You can use `prop-tool` to update your translation files by using `--fix` option. In such case `prop-tool` will completely rewrite
-translation files, adding missing keys (in commented out form).
+The `--update` only acts if target translation file exists and `prop-tool` will abort with error if you try to update non-existing
+file. However it's also often required to be able to create empty translation file (i.e. to hand it to the translator) and `prop-tool`
+can do that that too with use of `--create` switch.
 
-While content of written file is strongly based on base file Some normalization will be made
+This will check if `de` translation of `gui.properties` but if file does not exist, then it will create and empty "template" file:
 
-* There will be no more than one empty consequent empty line written,
-* There will be no more than one consequent empty comment line (just comment marker) written.
+```bash
+prop-tool --base gui --lang de --create
+```
 
-NOTE: Be aware that `--fix` do NOT update existing translation file but builds it completely using base file as reference and
-existing translations (if present). No other content of translation files (for example additional comments etc) will be preserved.
+**NOTE:** You can combine `--create` and `--update` in one invocation.
diff --git a/proptool/config/builder.py b/proptool/config/builder.py
index fe95dfed..29133351 100644
--- a/proptool/config/builder.py
+++ b/proptool/config/builder.py
@@ -110,6 +110,7 @@ def _set_from_args(config: Config, args) -> None:
 
         # cmd fix
         config.update = args.update
+        config.create = args.create
 
         # Set optional args, if set by user.
         optionals = [
@@ -157,7 +158,9 @@ def _parse_args() -> argparse:
 
         group = parser.add_argument_group('Additional options')
         group.add_argument('--update', action = 'store_true', dest = 'update',
-                           help = 'Updates translation files in-place using base file as reference. No backup!')
+                           help = 'Updates existing translation files in-place using base file as reference.')
+        group.add_argument('--create', action = 'store_true', dest = 'create',
+                           help = 'Creates new translation files using base file as reference if no file exists.')
         group.add_argument('--separator', action = 'store', dest = 'separator', metavar = 'CHAR', nargs = 1,
                            help = 'If specified, only given CHAR is considered a valid key/value separator.'
                                   + f'Must be one of the following: {", ".join(Config.ALLOWED_SEPARATORS)}')
diff --git a/proptool/config/config.py b/proptool/config/config.py
index 598dfc49..1031584e 100644
--- a/proptool/config/config.py
+++ b/proptool/config/config.py
@@ -46,6 +46,7 @@ def __init__(self):
         self.verbose: bool = False
 
         self.update: bool = False
+        self.create: bool = False
 
         self.files: List[str] = []
         self.languages: List[str] = []
diff --git a/proptool/main.py b/proptool/main.py
index d355e800..56425b40 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -87,10 +87,12 @@ def start() -> int:
                         translation_path = Path(reference_path.parent / f'{name_prefix}_{lang}.{name_suffix}')
                         translation = PropFile(config)
 
-                        try:  # noqa: WPS505
+                        trans_level_label = f'{lang.upper()}: {translation_path}'
+                        Log.push(trans_level_label, deferred = True)
+
+                        if translation_path.exists():
+                            # Load translation file.
                             translation.load(translation_path, lang)
-                            trans_level_label = f'{lang.upper()}: {translation_path}'
-                            Log.push(trans_level_label, deferred = True)
 
                             is_translation_valid = translation.is_valid(reference)
 
@@ -102,11 +104,16 @@ def start() -> int:
                                 if translation.file:
                                     translation.update(reference)
                                     translation.save()
-
-                            if Log.pop():
-                                Log.i(f'%ok%{trans_level_label}: OK')
-                        except FileNotFoundError:
-                            Log.e(f'File not found: {translation_path}')
+                        else:
+                            if config.create:
+                                translation.update(reference)
+                                Log.i(f'Creating new translation file: {translation_path}')
+                                translation.save(translation_path)
+                            else:
+                                Log.e(f'File not found: {translation_path}')
+
+                        if Log.pop():
+                            Log.i(f'%ok%{trans_level_label}: OK')
 
             # Close main push.
             Log.pop()
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index b9cbdac9..2baf6e8f 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -231,7 +231,7 @@ def save(self, target_file_name: Union[Path, None] = None) -> None:
         for item in self.items:
             content.append(item.to_string())
 
-        Log.i(f'Saving: {target_file_name}')
+        Log.i(f'Writing: {target_file_name}')
         with open(target_file_name, 'w') as fh:
             # FIXME: LF/CRLF should configurable
             fh.write('\n'.join(content))
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index bc017159..9397dbf0 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -23,6 +23,8 @@
 class FakeArgs(object):
     def __init__(self):
         self.update: bool = False
+        self.create: bool = False
+
         self.quiet: bool = False
         self.color: bool = False
 
@@ -145,6 +147,8 @@ def _generate_fake_args(self, languages: List[str]) -> FakeArgs:
 
         # Lets set up args to some random state
         args.update = self.get_random_bool()
+        args.create = self.get_random_bool()
+
         args.quiet = self.get_random_bool()
         args.verbose = self.get_random_bool()
         args.color = self.get_random_bool()
@@ -199,6 +203,9 @@ def test_set_from_args(self) -> None:
         exp_color = self._get_expectation(config_defaults.color, args.color, args.no_color)
         self.assertEqual(exp_color, config.color)
 
+        self.assertEqual(args.update, config.update)
+        self.assertEqual(args.create, config.create)
+
         # log_level controlled by `quiet` and `verbose`.
         self.assertEqual(args.quiet, config.quiet)
         self.assertEqual(args.verbose, config.verbose)
diff --git a/tests/prop/test_file.py b/tests/prop/test_file.py
index 90f45fa5..5da4b8c2 100644
--- a/tests/prop/test_file.py
+++ b/tests/prop/test_file.py
@@ -292,7 +292,7 @@ def _check_written_content(self, propfile: PropFile, verify_file_name, save_file
 
                 # Ensure call to Log.i() happened with expected message.
                 msg = log_i_mock.call_args_list[0][0][0]
-                self.assertEqual(msg, f'Saving: {verify_file_name}')
+                self.assertEqual(msg, f'Writing: {verify_file_name}')
 
                 # Check file content is written as expected.
                 expected = []

From 9fcf380f12f8659972a24f78cb71e7db2f288e73 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 10:28:04 +0200
Subject: [PATCH 129/140] Updated CHANGELOG

---
 docs/CHANGES.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/CHANGES.md b/docs/CHANGES.md
index 162262db..a738ef1d 100644
--- a/docs/CHANGES.md
+++ b/docs/CHANGES.md
@@ -6,8 +6,9 @@
 
 # Changelog #
 
-* v2.0.0 (2021-07-27)
+* dev ()
   * Added support for config files.
+  * Added option to `--create` template translation files.
   * Reworked documentation.
   * Added more unit tests.
 

From d9a61ad35d566dc15f242263c17b822c0e267640 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 10:53:33 +0200
Subject: [PATCH 130/140] Improved Brackets check coverage

---
 proptool/checks/brackets.py   | 14 +++++----
 tests/checks/test_brackets.py | 57 +++++++++++++++++++++++++++++++++++
 2 files changed, 65 insertions(+), 6 deletions(-)

diff --git a/proptool/checks/brackets.py b/proptool/checks/brackets.py
index c942946c..50694b14 100644
--- a/proptool/checks/brackets.py
+++ b/proptool/checks/brackets.py
@@ -43,19 +43,21 @@ def check(self, translation: 'PropFile', reference: 'PropFile' = None) -> Report
 
         report = ReportGroup(self.report_title)
 
-        if not translation.items:
-            return report
-
         opening = self.config['opening']
         closing = self.config['closing']
 
         opening_cnt = len(opening)
         closing_cnt = len(closing)
 
+        if opening_cnt == 0 or closing_cnt == 0:
+            report.warn(line = None, msg = 'CONFIG: Empty "opening" and "closing" arrays.')
+            return report
         if opening_cnt != closing_cnt:
-            report.error('CONFIG: Both "opening" and "closing" arrays must contain the same number of elements.')
-        if opening_cnt == 0:
-            report.warn('CONFIG: Empty "opening" and "closing" arrays.')
+            report.error(line = None, msg = 'CONFIG: Both "opening" and "closing" arrays must contain the same number of elements.')
+            return report
+
+        # We do that check at the end to ensure config is validated first.
+        if not translation.items:
             return report
 
         for idx, item in enumerate(translation.items):
diff --git a/tests/checks/test_brackets.py b/tests/checks/test_brackets.py
index 3c42e8f4..9c4b2e9d 100644
--- a/tests/checks/test_brackets.py
+++ b/tests/checks/test_brackets.py
@@ -6,10 +6,12 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+import random
 from typing import Dict, Union
 
 from proptool.checks.brackets import Brackets
 from proptool.decorators.overrides import overrides
+from proptool.prop.file import PropFile
 from proptool.prop.items import Blank, Comment, Translation
 from tests.checks.checks_test_case import ChecksTestCase
 
@@ -34,6 +36,10 @@ def test_translation_with_faults(self) -> None:
         # Text the case where we have matches, but not in order.
         self.check_single_file(Translation('key', '<(>)'), exp_errors = 1)
 
+    def test_empty_translation(self) -> None:
+        propfile = PropFile(self.config)
+        self.check(propfile)
+
     # #################################################################################################
 
     def test_comment_no_faults(self) -> None:
@@ -71,3 +77,54 @@ def test_opening_and_closing_lists(self) -> None:
             self.assertFalse(op_marker in config['closing'], f'Marker {op_marker} (position: {op_idx}) is present in closing too.')
         for cl_idx, cl_marker in enumerate(config['closing']):
             self.assertFalse(cl_marker in config['opening'], f'Marker {cl_marker} (position: {cl_idx}) is present in opening too.')
+
+    def test_uneven_opening_and_closing_lists(self) -> None:
+        """
+        Checks if error will be reported when opening and closing configuration
+        lists contain different number of elements.
+        """
+        opening_cnt = random.randint(10, 20)
+        opening = [self.get_random_string(length = 1) for item in range(opening_cnt)]
+
+        closing_cnt = random.randint(10, 20)
+        closing = [self.get_random_string(length = 1) for item in range(closing_cnt)]
+
+        if closing_cnt == opening_cnt:
+            if random.randint(0, 1) == 0:
+                del opening[random.randint(0, opening_cnt - 1)]
+            else:
+                del closing[random.randint(0, closing_cnt - 1)]
+
+        self.checker.config = {
+            'opening': opening,
+            'closing': closing,
+        }
+
+        prop_file = PropFile(self.config)
+        self.check(prop_file, exp_errors = 1)
+
+    def test_empty_opening_or_closing_lists(self) -> None:
+        non_empty_cnt = random.randint(10, 20)
+        non_empty = [self.get_random_string(length = 1) for item in range(non_empty_cnt)]
+        empty = []
+
+        self.checker.config = {
+            'opening': non_empty,
+            'closing': empty,
+        }
+        prop_file = PropFile(self.config)
+        self.check(prop_file, exp_warnings = 1)
+
+        self.checker.config = {
+            'opening': empty,
+            'closing': non_empty,
+        }
+        prop_file = PropFile(self.config)
+        self.check(prop_file, exp_warnings = 1)
+
+        self.checker.config = {
+            'opening': empty,
+            'closing': empty,
+        }
+        prop_file = PropFile(self.config)
+        self.check(prop_file, exp_warnings = 1)

From c55b593b9a3a8ff87c92fdf24910f5aaee2db273 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 11:09:05 +0200
Subject: [PATCH 131/140] Added lanuage code validation

---
 proptool/config/builder.py          |  9 +++++++++
 tests/config/test_config_builder.py | 31 +++++++++++++++++++++++++----
 2 files changed, 36 insertions(+), 4 deletions(-)

diff --git a/proptool/config/builder.py b/proptool/config/builder.py
index 29133351..35c2b734 100644
--- a/proptool/config/builder.py
+++ b/proptool/config/builder.py
@@ -8,6 +8,7 @@
 """
 
 import argparse
+import re
 from pathlib import Path
 from typing import List, Union
 
@@ -80,8 +81,16 @@ def _abort(msg: str) -> None:
     def _validate_config(config: Config) -> None:
         if not config.files:
             ConfigBuilder._abort('No base file(s) specified.')
+
+        if config.languages:
+            pattern = re.compile(r'^[a-z]{2,}$')
+            for lang in config.languages:
+                if not pattern.match(lang):
+                    ConfigBuilder._abort(f'Invalid language: "{lang}".')
+
         if config.separator not in Config.ALLOWED_SEPARATORS:
             ConfigBuilder._abort('Invalid separator character.')
+
         if config.comment_marker not in Config.ALLOWED_COMMENT_MARKERS:
             ConfigBuilder._abort('Invalid comment marker.')
 
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index 9397dbf0..3856a570 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -61,14 +61,14 @@ def get_config_for_validate(self) -> Config:
 
         return config
 
-    def test_validate(self) -> None:
+    def test_validate_config(self) -> None:
         """
         Ensures valid Config instance passes all validation checks.
         """
         ConfigBuilder._validate_config(self.get_config_for_validate())
 
     @patch('proptool.log.Log.e')
-    def test_validate_no_files(self, log_e_mock: Mock) -> None:
+    def test_validate_config_no_files(self, log_e_mock: Mock) -> None:
         """
         Ensures empty list of files triggers expected error message and quits.
 
@@ -86,7 +86,7 @@ def test_validate_no_files(self, log_e_mock: Mock) -> None:
             self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
 
     @patch('proptool.log.Log.e')
-    def test_validate_invalid_separator(self, log_e_mock: Mock) -> None:
+    def test_validate_config_invalid_separator(self, log_e_mock: Mock) -> None:
         """
         Ensures invalid separator char triggers expected error message and quits.
 
@@ -104,7 +104,7 @@ def test_validate_invalid_separator(self, log_e_mock: Mock) -> None:
             self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
 
     @patch('proptool.log.Log.e')
-    def test_validate_invalid_comment_marker(self, log_e_mock: Mock) -> None:
+    def test_validate_config_invalid_comment_marker(self, log_e_mock: Mock) -> None:
         """
         Ensures invalid comment marker triggers expected error message and quits.
 
@@ -121,6 +121,29 @@ def test_validate_invalid_comment_marker(self, log_e_mock: Mock) -> None:
             self.assertEqual(SystemExit, type(context_manager.exception))
             self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
 
+    @patch('proptool.log.Log.e')
+    def test_validate_config_invalid_languages(self, log_e_mock: Mock) -> None:
+        # valid language code is just lowercased [a-z]{2,}
+        faults = [
+            'ALLCAPS',  # all caps
+            'X',  # too short
+            'Pl',  # mixed case
+            'P9',  # digits
+        ]
+
+        for fault in faults:
+            config = self.get_config_for_validate()
+            config.languages = [fault]
+
+            with self.assertRaises(SystemExit) as context_manager:
+                ConfigBuilder._validate_config(config)
+                exp_calls = [call(f'Invalid language: "{fault}".')]
+                log_e_mock.assert_has_calls(exp_calls)
+
+                # Check we got sys.exit called with non-zero return code
+                self.assertEqual(SystemExit, type(context_manager.exception))
+                self.assertEquals(Utils.ABORT_RETURN_CODE, context_manager.exception.code)
+
     # #################################################################################################
 
     def test_set_on_off_option(self) -> None:

From 497528fb31c62033a495e38b09ee1f5b291d651c Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 11:31:49 +0200
Subject: [PATCH 132/140] Added support for comma separated language list

---
 docs/CHANGES.md                     |  1 +
 proptool/config/builder.py          | 18 +++++++++++++++
 tests/config/test_config_builder.py | 36 +++++++++++++++++++++++++++++
 3 files changed, 55 insertions(+)

diff --git a/docs/CHANGES.md b/docs/CHANGES.md
index a738ef1d..6fb5e756 100644
--- a/docs/CHANGES.md
+++ b/docs/CHANGES.md
@@ -9,6 +9,7 @@
 * dev ()
   * Added support for config files.
   * Added option to `--create` template translation files.
+  * The `--lang` now also supports comma separated arguments. 
   * Reworked documentation.
   * Added more unit tests.
 
diff --git a/proptool/config/builder.py b/proptool/config/builder.py
index 35c2b734..192414d1 100644
--- a/proptool/config/builder.py
+++ b/proptool/config/builder.py
@@ -207,10 +207,28 @@ def _parse_args() -> argparse:
 
         args = parser.parse_args()
 
+        # If user separated languages with comma instead of space, lets do some magic for it to work too.
+        args.languages = ConfigBuilder._process_comma_separated_langs(args.languages)
+
         ConfigBuilder._validate_args(args)
 
         return args
 
+    @staticmethod
+    def _process_comma_separated_langs(languages: Union[List[str], None]) -> Union[List[str], None]:
+        if languages is None:
+            return None
+
+        result = []
+        for lang in languages:
+            tmp = lang.split(',')
+            if len(tmp) > 1:
+                _ = [result.append(code) for code in tmp if code.strip() != '']  # noqa: WPS122
+            else:
+                result.append(lang)
+
+        return result
+
     @staticmethod
     def _validate_args(args):
         # Check use of mutually exclusive pairs
diff --git a/tests/config/test_config_builder.py b/tests/config/test_config_builder.py
index 3856a570..fe78c194 100644
--- a/tests/config/test_config_builder.py
+++ b/tests/config/test_config_builder.py
@@ -426,3 +426,39 @@ def test_build(self) -> None:
             self.assertEqual(len(config.files), len(config.files))
             for idx, def_file in enumerate(config.files):
                 self.assertEqual(def_file, config.files[idx])
+
+    # #################################################################################################
+
+    def test_comma_separated_langs_noop(self) -> None:
+        """
+        Checks if _process_comma_separated_langs() does nothing if there's no comma separated stuff.
+        """
+
+        max_cnt = random.randint(5, 20)  # noqa: WPS432
+        src_langs = [self.get_random_string(length = 5) for _ in range(max_cnt)]
+        result = ConfigBuilder._process_comma_separated_langs(src_langs)
+
+        self.assertEqual(len(src_langs), len(result))
+        self.assertEqual(src_langs, result)
+
+    def test_comma_separated_langs_split_and_filter(self) -> None:
+        """
+        Checks if _process_comma_separated_langs() properly splits comma separated languages
+        and filters out empty (i.e. ",,") entries.
+        """
+
+        max_cnt = random.randint(5, 20)  # noqa: WPS432
+        src_langs = [self.get_random_string(length = 5) for _ in range(max_cnt)]
+
+        comma_separated = [
+            'foo,bar',
+            'double,,comma',
+        ]
+        comma_splitted = [
+            'foo', 'bar', 'double', 'comma',
+        ]
+
+        result = ConfigBuilder._process_comma_separated_langs(src_langs + comma_separated)
+
+        self.assertEqual(len(src_langs) + len(comma_splitted), len(result))
+        self.assertEqual(src_langs + comma_splitted, result)

From 26047429e2aaa7e8d1c43f8719c4210aa6859be8 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 11:34:01 +0200
Subject: [PATCH 133/140] MD lint fixes

---
 docs/CHANGES.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/CHANGES.md b/docs/CHANGES.md
index 6fb5e756..c201992b 100644
--- a/docs/CHANGES.md
+++ b/docs/CHANGES.md
@@ -9,7 +9,7 @@
 * dev ()
   * Added support for config files.
   * Added option to `--create` template translation files.
-  * The `--lang` now also supports comma separated arguments. 
+  * The `--lang` now also supports comma separated arguments.
   * Reworked documentation.
   * Added more unit tests.
 

From aff0ecb221568731032ba8885c6f56b2dcc15e88 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 17:05:04 +0200
Subject: [PATCH 134/140] Improved translation line parser

---
 .flake8                  |  3 +-
 docs/README.md           |  1 +
 proptool/main.py         |  6 +++-
 proptool/prop/file.py    | 10 +++---
 proptool/prop/items.py   | 43 ++++++++++++++++++++--
 proptool/utils.py        |  2 --
 tests/prop/test_items.py | 78 ++++++++++++++++++++++++++++++++++++++++
 7 files changed, 132 insertions(+), 11 deletions(-)

diff --git a/.flake8 b/.flake8
index e4ab5759..4cc81b76 100644
--- a/.flake8
+++ b/.flake8
@@ -125,11 +125,12 @@ per-file-ignores =
     proptool/utils.py: WPS421, WPS100,
 
     # S311 Standard pseudo-random generators are not suitable for security/cryptographic purposes.
+    # WPS118 Found too long name
     # WPS214 Found too many methods
     # WPS323 Found `%` string formatting
     # WPS432 Found magic number
     # WPS609 Found direct magic attribute usage: __abstractmethods__
-    tests/*: S311, WPS323, WPS214, WPS432, WPS609,
+    tests/*: S311, WPS323, WPS214, WPS432, WPS609, WPS118,
 
     # WPS431 Found nested class: FakeArgs
     # WPS437 Found protected attribute usage: _set_on_off_option
diff --git a/docs/README.md b/docs/README.md
index abfa5b39..d655a625 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -45,3 +45,4 @@ You may also want to setup [virtual environment](https://docs.python.org/3/libra
 ## Additional links ##
 
 * The `*.properties` syntax support is based on official [file format documentation](https://docs.oracle.com/cd/E23095_01/Platform.93/ATGProgGuide/html/s0204propertiesfileformat01.html).
+* More technical details also in [JavaDocs for java.util.properties](https://docs.oracle.com/javase/7/docs/api/java/util/Properties.html).
diff --git a/proptool/main.py b/proptool/main.py
index 56425b40..6e23fcdb 100644
--- a/proptool/main.py
+++ b/proptool/main.py
@@ -107,8 +107,9 @@ def start() -> int:
                         else:
                             if config.create:
                                 translation.update(reference)
-                                Log.i(f'Creating new translation file: {translation_path}')
+                                Log.push('Creating new translation file')
                                 translation.save(translation_path)
+                                Log.pop()
                             else:
                                 Log.e(f'File not found: {translation_path}')
 
@@ -118,7 +119,10 @@ def start() -> int:
             # Close main push.
             Log.pop()
 
+            # Done.
             return 100 if errors else 0
+
+        # Last-resort exceptin catcher.
         except Exception as ex:
             Log.e(str(ex))
             exc_type, exc_obj, tb = sys.exc_info()
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 2baf6e8f..4e743133 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -196,14 +196,14 @@ def load(self, file: Path, language: str = None) -> bool:
                     continue
 
                 # Whatever left should be valid key[:=]val entry
-                tmp: List[str] = re.split(f'^(.+)([{"".join(Config.ALLOWED_SEPARATORS)}])(.+)$', line)
-                if len(tmp) != 5:
+                tmp = Translation.parse_translation_line(line)
+                if not tmp:
                     Log.e(f'Invalid syntax at line {line_number} of "{file}".')
                     Utils.abort()
 
-                key = tmp[1].strip()
-                separator = tmp[2].strip()
-                val = tmp[3].lstrip()
+                key = tmp[0].strip()
+                separator = tmp[1].strip()
+                val = tmp[2].lstrip()
                 if key not in self.keys:
                     self.append(Translation(key, val, separator))
                     self.keys.append(key)
diff --git a/proptool/prop/items.py b/proptool/prop/items.py
index 86bea209..2ef937e8 100644
--- a/proptool/prop/items.py
+++ b/proptool/prop/items.py
@@ -7,10 +7,10 @@
 #
 """
 
-from typing import Union
+from typing import Tuple, Union
 
-from proptool.decorators.overrides import overrides
 from proptool.config.config import Config
+from proptool.decorators.overrides import overrides
 
 
 # #################################################################################################
@@ -55,6 +55,45 @@ def __init__(self, key: str, value: Union[str, None] = None, separator: str = '=
     def to_string(self) -> str:
         return f'{self.key} {self.separator} {self.value}'
 
+    @staticmethod
+    def parse_translation_line(line: str) -> Union[Tuple[str, str, str], None]:
+        # Min two chars (one letter key and separator)
+        if len(line) < 2:
+            return None
+
+        # Find used separator first
+        separator = None
+        separator_pos = None
+        previous_char_backspace = False
+        for idx, char in enumerate(line):
+            if char == '\\':
+                if not previous_char_backspace:
+                    previous_char_backspace = True
+                continue
+            if char in Config.ALLOWED_SEPARATORS:
+                if previous_char_backspace:
+                    continue
+
+                separator = char
+                separator_pos = idx
+                break
+            else:
+                previous_char_backspace = False
+
+        # https://docs.oracle.com/javase/7/docs/api/java/util/Properties.html
+
+        if not separator:
+            return None
+
+        key = line[:separator_pos].strip()
+        sep = separator.strip()
+        val = line[separator_pos + 1:].lstrip()
+
+        if key == '' or sep == '':
+            return None
+
+        return key, sep, val
+
 
 # #################################################################################################
 
diff --git a/proptool/utils.py b/proptool/utils.py
index 4687164a..895cb1ba 100644
--- a/proptool/utils.py
+++ b/proptool/utils.py
@@ -14,10 +14,8 @@
 # DO NOT use Log class in Utils. That causes some dependency issues which are NOT
 # worth solving.
 
-# #################################################################################################
 
 class Utils(object):
-
     ABORT_RETURN_CODE = 10
 
     @staticmethod
diff --git a/tests/prop/test_items.py b/tests/prop/test_items.py
index 1299ef10..64ae04f4 100644
--- a/tests/prop/test_items.py
+++ b/tests/prop/test_items.py
@@ -6,6 +6,8 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
+import random
+
 from proptool.config.config import Config
 from proptool.prop.items import Blank, Comment, PropItem, Translation
 from tests.test_case import TestCase
@@ -94,6 +96,82 @@ def test_translation_to_string(self) -> None:
 
     # #################################################################################################
 
+    # Extending TestCase to get access to helper methods.
+    class SplitTest(TestCase):
+        """
+        Helper class to reduce bolderplate code in in
+        """
+
+        def __init__(self, fmt: str, mid_val_sep = True):
+            key = self.get_random_string('key_', length = 10)
+            sep = random.choice(Config.ALLOWED_SEPARATORS)
+            val_sep = random.choice(Config.ALLOWED_SEPARATORS) if mid_val_sep else ''
+            val = self.get_random_string(length = 10) + val_sep + self.get_random_string(length = 10)
+
+            self.key = key
+            self.sep = sep
+            self.val_sep = val_sep
+            self.val = val
+
+            if fmt.find('{key}') != -1:
+                fmt = fmt.replace('{key}', key)
+            if fmt.find('{sep}') != -1:
+                fmt = fmt.replace('{sep}', sep)
+            if fmt.find('{val}') != -1:
+                fmt = fmt.replace('{val}', val)
+
+            self.line = fmt
+
+    def test_translation_parse_translation_line_with_valid_entries(self) -> None:
+        lines = [
+            '{key}{sep}{val}',
+            '{key} {sep} {val}',
+            '      {key}     {sep} {val}',
+            '{key} {sep}{val}',
+            '{key}{sep} {val}',
+            '{key} {sep}      {val}',
+            '{key}      {sep}{val}',
+            '{key}{sep}    {val}',
+        ]
+        tests = [TestPropItem.SplitTest(fmt) for fmt in lines]
+
+        for test in tests:
+            res = Translation.parse_translation_line(test.line)
+            self.assertIsNotNone(res)
+            res_key, res_sep, res_val = res
+            self.assertEqual(test.key, res_key)
+            self.assertEqual(test.sep, res_sep)
+            self.assertEqual(test.val, res_val)
+
+    def test_translation_parse_translation_line_invalid_entries(self) -> None:
+        lines = [
+            '{sep}{val}',
+            '{key} {val}',
+            '         {sep}   ',
+            '{sep}{val}',
+            '{sep}{key}{sep} {val}',
+        ]
+        tests = [TestPropItem.SplitTest(fmt, mid_val_sep = False) for fmt in lines]
+
+        for test in tests:
+            res = Translation.parse_translation_line(test.line)
+            self.assertIsNone(res)
+
+    def test_translation_parse_translation_line_escaped_chars(self) -> None:
+        key = r'this\=is\:\key'
+        sep = random.choice(Config.ALLOWED_SEPARATORS)
+        val = self.get_random_string('value_')
+        line = f'{key}{sep}{val}'
+
+        res = Translation.parse_translation_line(line)
+        self.assertIsNotNone(res)
+        res_key, res_sep, res_val = res
+        self.assertEqual(key, res_key)
+        self.assertEqual(sep, res_sep)
+        self.assertEqual(val, res_val)
+
+    # #################################################################################################
+
     def test_comment_constructor(self) -> None:
         config = Config()
         for marker in config.ALLOWED_COMMENT_MARKERS:

From f3b4c8d70f58840eef44447d2ed167d1c1c6f8ef Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 17:14:03 +0200
Subject: [PATCH 135/140] Split test prop items tests into separate files

---
 tests/prop/test_blank.py                      |  23 +++
 tests/prop/test_comment.py                    |  50 ++++++
 .../prop/{test_items.py => test_prop_item.py} |   0
 tests/prop/test_translation.py                | 153 ++++++++++++++++++
 4 files changed, 226 insertions(+)
 create mode 100644 tests/prop/test_blank.py
 create mode 100644 tests/prop/test_comment.py
 rename tests/prop/{test_items.py => test_prop_item.py} (100%)
 create mode 100644 tests/prop/test_translation.py

diff --git a/tests/prop/test_blank.py b/tests/prop/test_blank.py
new file mode 100644
index 00000000..32b2084f
--- /dev/null
+++ b/tests/prop/test_blank.py
@@ -0,0 +1,23 @@
+"""
+# prop-tool
+# Java *.properties file sync checker and syncing tool.
+#
+# Copyright ©2021 Marcin Orlowski <mail [@] MarcinOrlowski.com>
+# https://github.com/MarcinOrlowski/prop-tool/
+#
+"""
+
+from proptool.prop.items import Blank
+from tests.test_case import TestCase
+
+
+class TestBlank(TestCase):
+
+    def test_blank_constructor(self) -> None:
+        item = Blank()
+        self.assertIsNone(item.key)
+        self.assertIsNone(item.value)
+
+    def test_blank_to_string(self) -> None:
+        item = Blank()
+        self.assertEqual('', item.to_string())
diff --git a/tests/prop/test_comment.py b/tests/prop/test_comment.py
new file mode 100644
index 00000000..53bd098e
--- /dev/null
+++ b/tests/prop/test_comment.py
@@ -0,0 +1,50 @@
+"""
+# prop-tool
+# Java *.properties file sync checker and syncing tool.
+#
+# Copyright ©2021 Marcin Orlowski <mail [@] MarcinOrlowski.com>
+# https://github.com/MarcinOrlowski/prop-tool/
+#
+"""
+
+from proptool.config.config import Config
+from proptool.prop.items import Comment
+from tests.test_case import TestCase
+
+
+class TestComment(TestCase):
+
+    def test_constructor(self) -> None:
+        config = Config()
+        for marker in config.ALLOWED_COMMENT_MARKERS:
+            value = f'{marker} {self.get_random_string()}'
+            item = Comment(value)
+            self.assertEqual(value, item.value)
+            self.assertIsNone(item.key)
+
+    def test_invalid_value(self) -> None:
+        with self.assertRaises(ValueError):
+            # Invalid value type
+            # noinspection PyTypeChecker
+            Comment(1234)
+
+    def test_without_marker(self) -> None:
+        """
+        Checks if constructing Comment without valid marker in passed value
+        would automatically add such marker.
+        """
+        val = self.get_random_string('no_maker_')
+        # No valid comment marker
+        comment = Comment(val)
+        self.assertEqual(f'{Config.ALLOWED_COMMENT_MARKERS[0]} {val}', comment.to_string())
+
+    def test_empty_value(self) -> None:
+        comment = Comment('')
+        self.assertEqual(Config.ALLOWED_COMMENT_MARKERS[0], comment.to_string())
+
+    def test_to_string(self) -> None:
+        config = Config()
+        for marker in config.ALLOWED_COMMENT_MARKERS:
+            value = f'{marker} {self.get_random_string()}'
+            comment = Comment(value)
+            self.assertEqual(value, comment.to_string())
diff --git a/tests/prop/test_items.py b/tests/prop/test_prop_item.py
similarity index 100%
rename from tests/prop/test_items.py
rename to tests/prop/test_prop_item.py
diff --git a/tests/prop/test_translation.py b/tests/prop/test_translation.py
new file mode 100644
index 00000000..4f81b04e
--- /dev/null
+++ b/tests/prop/test_translation.py
@@ -0,0 +1,153 @@
+"""
+# prop-tool
+# Java *.properties file sync checker and syncing tool.
+#
+# Copyright ©2021 Marcin Orlowski <mail [@] MarcinOrlowski.com>
+# https://github.com/MarcinOrlowski/prop-tool/
+#
+"""
+import random
+
+from proptool.config.config import Config
+from proptool.prop.items import Translation
+from tests.test_case import TestCase
+
+
+# Extending TestCase to get access to helper methods.
+class SplitTest(TestCase):
+    """
+    Helper class to reduce bolderplate code in in
+    """
+
+    def __init__(self, fmt: str, mid_val_sep = True):
+        key = self.get_random_string('key_', length = 10)
+        sep = random.choice(Config.ALLOWED_SEPARATORS)
+        val_sep = random.choice(Config.ALLOWED_SEPARATORS) if mid_val_sep else ''
+        val = self.get_random_string(length = 10) + val_sep + self.get_random_string(length = 10)
+
+        self.key = key
+        self.sep = sep
+        self.val_sep = val_sep
+        self.val = val
+
+        if fmt.find('{key}') != -1:
+            fmt = fmt.replace('{key}', key)
+        if fmt.find('{sep}') != -1:
+            fmt = fmt.replace('{sep}', sep)
+        if fmt.find('{val}') != -1:
+            fmt = fmt.replace('{val}', val)
+
+        self.line = fmt
+
+
+class TestTranslation(TestCase):
+
+    def test_invalid_key_type(self) -> None:
+        """
+        Tests handing of invalid key type.
+        """
+        value = self.get_random_string()
+        with self.assertRaises(ValueError):
+            # noinspection PyTypeChecker
+            Translation(123, value)
+        with self.assertRaises(ValueError):
+            # noinspection PyTypeChecker
+            Translation(None, value)
+
+    def test_empty_key(self) -> None:
+        """
+        Tests handling of empty key.
+        """
+        value = self.get_random_string()
+        with self.assertRaises(ValueError):
+            Translation('', value)
+
+    def test_empty_key_after_strip(self) -> None:
+        """
+        Tests handling of non-empty key that gets empty once strip()'ed.
+        """
+        value = self.get_random_string()
+        with self.assertRaises(ValueError):
+            Translation('   ', value)
+
+    def test_invalid_value_type(self) -> None:
+        with self.assertRaises(ValueError):
+            key = self.get_random_string()
+            # noinspection PyTypeChecker
+            Translation(key, 1234)
+
+        value = self.get_random_string()
+        with self.assertRaises(ValueError):
+            # noinspection PyTypeChecker
+            Translation(key, value, None)
+
+    def test_invalid_separator(self) -> None:
+        key = self.get_random_string()
+        value = self.get_random_string()
+        with self.assertRaises(ValueError):
+            Translation(key, value, '-')
+
+    def test_empty_separator(self) -> None:
+        key = self.get_random_string()
+        value = self.get_random_string()
+        with self.assertRaises(ValueError):
+            Translation(key, value, '')
+
+    def test_to_string(self) -> None:
+        config = Config()
+        for separator in config.ALLOWED_SEPARATORS:
+            key = self.get_random_string()
+            value = self.get_random_string()
+            trans = Translation(key, value, separator)
+            expected = f'{key} {separator} {value}'
+            self.assertEqual(expected, trans.to_string())
+
+    # #################################################################################################
+
+    def test_parse_translation_line_with_valid_entries(self) -> None:
+        lines = [
+            '{key}{sep}{val}',
+            '{key} {sep} {val}',
+            '      {key}     {sep} {val}',
+            '{key} {sep}{val}',
+            '{key}{sep} {val}',
+            '{key} {sep}      {val}',
+            '{key}      {sep}{val}',
+            '{key}{sep}    {val}',
+        ]
+        tests = [SplitTest(fmt) for fmt in lines]
+
+        for test in tests:
+            res = Translation.parse_translation_line(test.line)
+            self.assertIsNotNone(res)
+            res_key, res_sep, res_val = res
+            self.assertEqual(test.key, res_key)
+            self.assertEqual(test.sep, res_sep)
+            self.assertEqual(test.val, res_val)
+
+    def test_parse_translation_line_invalid_entries(self) -> None:
+        lines = [
+            '{sep}{val}',
+            '{key} {val}',
+            '         {sep}   ',
+            '{sep}{val}',
+            '{sep}{key}{sep} {val}',
+        ]
+        tests = [SplitTest(fmt, mid_val_sep = False) for fmt in lines]
+
+        for test in tests:
+            res = Translation.parse_translation_line(test.line)
+            self.assertIsNone(res)
+
+    def test_parse_translation_line_escaped_chars(self) -> None:
+        key = r'this\=is\:\key'
+        sep = random.choice(Config.ALLOWED_SEPARATORS)
+        val = self.get_random_string('value_')
+        line = f'{key}{sep}{val}'
+
+        res = Translation.parse_translation_line(line)
+        self.assertIsNotNone(res)
+        res_key, res_sep, res_val = res
+        self.assertEqual(key, res_key)
+        self.assertEqual(sep, res_sep)
+        self.assertEqual(val, res_val)

From 07300fe0fa28f2b7ede2f45784da4c3a69a87944 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 17:14:27 +0200
Subject: [PATCH 136/140] Removed redundant tests

---
 tests/prop/test_prop_item.py | 190 +----------------------------------
 1 file changed, 1 insertion(+), 189 deletions(-)

diff --git a/tests/prop/test_prop_item.py b/tests/prop/test_prop_item.py
index 64ae04f4..60b652b7 100644
--- a/tests/prop/test_prop_item.py
+++ b/tests/prop/test_prop_item.py
@@ -6,10 +6,8 @@
 # https://github.com/MarcinOrlowski/prop-tool/
 #
 """
-import random
 
-from proptool.config.config import Config
-from proptool.prop.items import Blank, Comment, PropItem, Translation
+from proptool.prop.items import PropItem
 from tests.test_case import TestCase
 
 
@@ -31,189 +29,3 @@ def test_base_to_string_not_implemented(self) -> None:
         item = PropItem()
         with self.assertRaises(NotImplementedError):
             item.to_string()
-
-    # #################################################################################################
-
-    def test_translation_invalid_key_type(self) -> None:
-        """
-        Tests handing of invalid key type.
-        """
-        value = self.get_random_string()
-        with self.assertRaises(ValueError):
-            # noinspection PyTypeChecker
-            Translation(123, value)
-        with self.assertRaises(ValueError):
-            # noinspection PyTypeChecker
-            Translation(None, value)
-
-    def test_translation_empty_key(self) -> None:
-        """
-        Tests handling of empty key.
-        """
-        value = self.get_random_string()
-        with self.assertRaises(ValueError):
-            Translation('', value)
-
-    def test_translation_empty_key_after_strip(self) -> None:
-        """
-        Tests handling of non-empty key that gets empty once strip()'ed.
-        """
-        value = self.get_random_string()
-        with self.assertRaises(ValueError):
-            Translation('   ', value)
-
-    def test_translation_invalid_value_type(self) -> None:
-        with self.assertRaises(ValueError):
-            key = self.get_random_string()
-            # noinspection PyTypeChecker
-            Translation(key, 1234)
-
-        value = self.get_random_string()
-        with self.assertRaises(ValueError):
-            # noinspection PyTypeChecker
-            Translation(key, value, None)
-
-    def test_translation_invalid_separator(self) -> None:
-        key = self.get_random_string()
-        value = self.get_random_string()
-        with self.assertRaises(ValueError):
-            Translation(key, value, '-')
-
-    def test_translation_empty_separator(self) -> None:
-        key = self.get_random_string()
-        value = self.get_random_string()
-        with self.assertRaises(ValueError):
-            Translation(key, value, '')
-
-    def test_translation_to_string(self) -> None:
-        config = Config()
-        for separator in config.ALLOWED_SEPARATORS:
-            key = self.get_random_string()
-            value = self.get_random_string()
-            trans = Translation(key, value, separator)
-            expected = f'{key} {separator} {value}'
-            self.assertEqual(expected, trans.to_string())
-
-    # #################################################################################################
-
-    # Extending TestCase to get access to helper methods.
-    class SplitTest(TestCase):
-        """
-        Helper class to reduce bolderplate code in in
-        """
-
-        def __init__(self, fmt: str, mid_val_sep = True):
-            key = self.get_random_string('key_', length = 10)
-            sep = random.choice(Config.ALLOWED_SEPARATORS)
-            val_sep = random.choice(Config.ALLOWED_SEPARATORS) if mid_val_sep else ''
-            val = self.get_random_string(length = 10) + val_sep + self.get_random_string(length = 10)
-
-            self.key = key
-            self.sep = sep
-            self.val_sep = val_sep
-            self.val = val
-
-            if fmt.find('{key}') != -1:
-                fmt = fmt.replace('{key}', key)
-            if fmt.find('{sep}') != -1:
-                fmt = fmt.replace('{sep}', sep)
-            if fmt.find('{val}') != -1:
-                fmt = fmt.replace('{val}', val)
-
-            self.line = fmt
-
-    def test_translation_parse_translation_line_with_valid_entries(self) -> None:
-        lines = [
-            '{key}{sep}{val}',
-            '{key} {sep} {val}',
-            '      {key}     {sep} {val}',
-            '{key} {sep}{val}',
-            '{key}{sep} {val}',
-            '{key} {sep}      {val}',
-            '{key}      {sep}{val}',
-            '{key}{sep}    {val}',
-        ]
-        tests = [TestPropItem.SplitTest(fmt) for fmt in lines]
-
-        for test in tests:
-            res = Translation.parse_translation_line(test.line)
-            self.assertIsNotNone(res)
-            res_key, res_sep, res_val = res
-            self.assertEqual(test.key, res_key)
-            self.assertEqual(test.sep, res_sep)
-            self.assertEqual(test.val, res_val)
-
-    def test_translation_parse_translation_line_invalid_entries(self) -> None:
-        lines = [
-            '{sep}{val}',
-            '{key} {val}',
-            '         {sep}   ',
-            '{sep}{val}',
-            '{sep}{key}{sep} {val}',
-        ]
-        tests = [TestPropItem.SplitTest(fmt, mid_val_sep = False) for fmt in lines]
-
-        for test in tests:
-            res = Translation.parse_translation_line(test.line)
-            self.assertIsNone(res)
-
-    def test_translation_parse_translation_line_escaped_chars(self) -> None:
-        key = r'this\=is\:\key'
-        sep = random.choice(Config.ALLOWED_SEPARATORS)
-        val = self.get_random_string('value_')
-        line = f'{key}{sep}{val}'
-
-        res = Translation.parse_translation_line(line)
-        self.assertIsNotNone(res)
-        res_key, res_sep, res_val = res
-        self.assertEqual(key, res_key)
-        self.assertEqual(sep, res_sep)
-        self.assertEqual(val, res_val)
-
-    # #################################################################################################
-
-    def test_comment_constructor(self) -> None:
-        config = Config()
-        for marker in config.ALLOWED_COMMENT_MARKERS:
-            value = f'{marker} {self.get_random_string()}'
-            item = Comment(value)
-            self.assertEqual(value, item.value)
-            self.assertIsNone(item.key)
-
-    def test_comment_invalid_value(self) -> None:
-        with self.assertRaises(ValueError):
-            # Invalid value type
-            # noinspection PyTypeChecker
-            Comment(1234)
-
-    def test_comment_without_marker(self) -> None:
-        """
-        Checks if constructing Comment without valid marker in passed value
-        would automatically add such marker.
-        """
-        val = self.get_random_string('no_maker_')
-        # No valid comment marker
-        comment = Comment(val)
-        self.assertEqual(f'{Config.ALLOWED_COMMENT_MARKERS[0]} {val}', comment.to_string())
-
-    def test_comment_empty_value(self) -> None:
-        comment = Comment('')
-        self.assertEqual(Config.ALLOWED_COMMENT_MARKERS[0], comment.to_string())
-
-    def test_comment_to_string(self) -> None:
-        config = Config()
-        for marker in config.ALLOWED_COMMENT_MARKERS:
-            value = f'{marker} {self.get_random_string()}'
-            comment = Comment(value)
-            self.assertEqual(value, comment.to_string())
-
-    # #################################################################################################
-
-    def test_blank_constructor(self) -> None:
-        item = Blank()
-        self.assertIsNone(item.key)
-        self.assertIsNone(item.value)
-
-    def test_blank_to_string(self) -> None:
-        item = Blank()
-        self.assertEqual('', item.to_string())

From 87bc3f0a1cbdf33364311e680bf810bb4333ba48 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 17:18:27 +0200
Subject: [PATCH 137/140] Updated CHANGELOG

---
 docs/CHANGES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/CHANGES.md b/docs/CHANGES.md
index c201992b..65a08bfa 100644
--- a/docs/CHANGES.md
+++ b/docs/CHANGES.md
@@ -11,6 +11,7 @@
   * Added option to `--create` template translation files.
   * The `--lang` now also supports comma separated arguments.
   * Reworked documentation.
+  * Improved `*.properties` file parsing to better handle extreme cases.
   * Added more unit tests.
 
 * v1.3.0 (2021-07-22)

From a1c1fa7e35ede923bd13672d3a65c969153e2df5 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 19:33:35 +0200
Subject: [PATCH 138/140] Changed default KeyFormat pattern

---
 docs/checks/key-format.md     | 2 +-
 proptool/checks/key_format.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/checks/key-format.md b/docs/checks/key-format.md
index 3bd126b4..cd2621de 100644
--- a/docs/checks/key-format.md
+++ b/docs/checks/key-format.md
@@ -33,7 +33,7 @@ conventcion across your files.
 
 | Key       | Type      | Description | Example |
 |-----------|-----------|-------------|---------|
-| pattern   | Regular expression (string) | Pattern for that each key must match | `"^[a-z]+[a-zA-Z0-9_.]*[a-zA-Z0-9]+$"` |
+| pattern   | Regular expression (string) | Pattern for that each key must match | `"^[a-zA-Z0-9_.]*[a-zA-Z0-9]+$"` |
 
 ### Notes ###
 
diff --git a/proptool/checks/key_format.py b/proptool/checks/key_format.py
index 95995d80..dc7f9cd3 100644
--- a/proptool/checks/key_format.py
+++ b/proptool/checks/key_format.py
@@ -53,5 +53,5 @@ def check(self, translation_file: 'PropFile', reference_file: 'PropFile' = None)
     @overrides(Check)
     def get_default_config(self) -> Dict:
         return {
-            'pattern': r'^[a-z]+[a-zA-Z0-9_.]*[a-zA-Z0-9]+$',
+            'pattern': r'^[a-zA-Z0-9_.]*[a-zA-Z0-9]+$',
         }

From d572356999910dfcf39d9083a809d1253235f5b4 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 19:43:14 +0200
Subject: [PATCH 139/140] Updated tests

---
 proptool/checks/brackets.py                    | 2 --
 proptool/checks/dangling_keys.py               | 2 --
 proptool/checks/empty_translations.py          | 2 --
 proptool/checks/formatting_values.py           | 2 --
 proptool/checks/key_format.py                  | 2 --
 proptool/checks/missing_translations.py        | 2 --
 proptool/checks/punctuation.py                 | 2 --
 proptool/checks/quotation_marks.py             | 2 --
 proptool/checks/starts_with_the_same_case.py   | 2 --
 proptool/checks/trailing_white_chars.py        | 2 --
 proptool/checks/white_chars_before_linefeed.py | 2 --
 proptool/prop/file.py                          | 2 --
 tests/checks/test_base_check.py                | 1 +
 tests/checks/test_key_format.py                | 9 +--------
 14 files changed, 2 insertions(+), 32 deletions(-)

diff --git a/proptool/checks/brackets.py b/proptool/checks/brackets.py
index 50694b14..e3a5ee4a 100644
--- a/proptool/checks/brackets.py
+++ b/proptool/checks/brackets.py
@@ -15,8 +15,6 @@
 from .base.check import Check
 
 
-# #################################################################################################
-
 class Bracket(object):
     def __init__(self, pos: int, bracket: str):
         self.pos = pos
diff --git a/proptool/checks/dangling_keys.py b/proptool/checks/dangling_keys.py
index 7812fe27..af6cac82 100644
--- a/proptool/checks/dangling_keys.py
+++ b/proptool/checks/dangling_keys.py
@@ -12,8 +12,6 @@
 from .base.check import Check
 
 
-# #################################################################################################
-
 class DanglingKeys(Check):
 
     # noinspection PyUnresolvedReferences
diff --git a/proptool/checks/empty_translations.py b/proptool/checks/empty_translations.py
index 22e692c6..fe86f400 100644
--- a/proptool/checks/empty_translations.py
+++ b/proptool/checks/empty_translations.py
@@ -14,8 +14,6 @@
 from .base.check import Check
 
 
-# #################################################################################################
-
 # noinspection PyUnresolvedReferences
 class EmptyTranslations(Check):
     """
diff --git a/proptool/checks/formatting_values.py b/proptool/checks/formatting_values.py
index 1b80b98c..e7662751 100644
--- a/proptool/checks/formatting_values.py
+++ b/proptool/checks/formatting_values.py
@@ -16,8 +16,6 @@
 from .base.check import Check
 
 
-# #################################################################################################
-
 class Formatter(object):
     def __init__(self, pos: int, formatter: str):
         self.pos = pos
diff --git a/proptool/checks/key_format.py b/proptool/checks/key_format.py
index dc7f9cd3..9c0a1462 100644
--- a/proptool/checks/key_format.py
+++ b/proptool/checks/key_format.py
@@ -16,8 +16,6 @@
 from .base.check import Check
 
 
-# #################################################################################################
-
 # noinspection PyUnresolvedReferences
 class KeyFormat(Check):
     """
diff --git a/proptool/checks/missing_translations.py b/proptool/checks/missing_translations.py
index 5062a5f4..ef444dd5 100644
--- a/proptool/checks/missing_translations.py
+++ b/proptool/checks/missing_translations.py
@@ -13,8 +13,6 @@
 from .base.check import Check
 
 
-# #################################################################################################
-
 # noinspection PyUnresolvedReferences
 class MissingTranslations(Check):
     """
diff --git a/proptool/checks/punctuation.py b/proptool/checks/punctuation.py
index 1672303b..171196c9 100644
--- a/proptool/checks/punctuation.py
+++ b/proptool/checks/punctuation.py
@@ -15,8 +15,6 @@
 from .base.check import Check
 
 
-# #################################################################################################
-
 # noinspection PyUnresolvedReferences
 class Punctuation(Check):
     r"""
diff --git a/proptool/checks/quotation_marks.py b/proptool/checks/quotation_marks.py
index e300f94f..566071d2 100644
--- a/proptool/checks/quotation_marks.py
+++ b/proptool/checks/quotation_marks.py
@@ -15,8 +15,6 @@
 from .base.check import Check
 
 
-# #################################################################################################
-
 class Mark(object):
     def __init__(self, pos: int, mark: str):
         self.pos = pos
diff --git a/proptool/checks/starts_with_the_same_case.py b/proptool/checks/starts_with_the_same_case.py
index 30f27365..61c94a75 100644
--- a/proptool/checks/starts_with_the_same_case.py
+++ b/proptool/checks/starts_with_the_same_case.py
@@ -13,8 +13,6 @@
 from .base.check import Check
 
 
-# #################################################################################################
-
 # noinspection PyUnresolvedReferences
 class StartsWithTheSameCase(Check):
     """
diff --git a/proptool/checks/trailing_white_chars.py b/proptool/checks/trailing_white_chars.py
index 392cfae3..41b82efb 100644
--- a/proptool/checks/trailing_white_chars.py
+++ b/proptool/checks/trailing_white_chars.py
@@ -15,8 +15,6 @@
 from .base.check import Check
 
 
-# #################################################################################################
-
 # noinspection PyUnresolvedReferences
 class TrailingWhiteChars(Check):
     """
diff --git a/proptool/checks/white_chars_before_linefeed.py b/proptool/checks/white_chars_before_linefeed.py
index a557f3e2..1e7e2efd 100644
--- a/proptool/checks/white_chars_before_linefeed.py
+++ b/proptool/checks/white_chars_before_linefeed.py
@@ -14,8 +14,6 @@
 from .base.check import Check
 
 
-# #################################################################################################
-
 class WhiteCharsBeforeLinefeed(Check):
     r"""
     This check ensures there's no space before "\n", "\r" literals.
diff --git a/proptool/prop/file.py b/proptool/prop/file.py
index 4e743133..49d4d764 100644
--- a/proptool/prop/file.py
+++ b/proptool/prop/file.py
@@ -20,8 +20,6 @@
 from proptool.utils import Utils
 
 
-# #################################################################################################
-
 class PropFile(object):
     def __init__(self, config: Config, language: str = None):
         super().__init__()
diff --git a/tests/checks/test_base_check.py b/tests/checks/test_base_check.py
index a40afd97..688e9040 100644
--- a/tests/checks/test_base_check.py
+++ b/tests/checks/test_base_check.py
@@ -1,4 +1,5 @@
 """
+
 # prop-tool
 # Java *.properties file sync checker and syncing tool.
 #
diff --git a/tests/checks/test_key_format.py b/tests/checks/test_key_format.py
index 2a8ab8db..3c646880 100644
--- a/tests/checks/test_key_format.py
+++ b/tests/checks/test_key_format.py
@@ -29,16 +29,9 @@ def test_translation_no_faults(self) -> None:
         self.check_single_file(Translation('validKey123', 'foo'))
         self.check_single_file(Translation('valid.Key', 'foo'))
         self.check_single_file(Translation('valid_Key', 'foo'))
+        self.check_single_file(Translation('k', 'foo'))
 
     def test_translation_with_faults(self) -> None:
-        # Too short key name
-        self.check_single_file(Translation('k', 'foo'), exp_errors = 1)
-        # starts capitalized
-        self.check_single_file(Translation('INVALIDkey', 'foo'), exp_errors = 1)
-        # has underscore at the end
-        self.check_single_file(Translation('invalidKey_', 'foo'), exp_errors = 1)
-        # has dot at the end
-        self.check_single_file(Translation('invalidKey.', 'foo'), exp_errors = 1)
         # starts with digits
         self.check_single_file(Translation('666keys.', 'foo'), exp_errors = 1)
 

From 286be467da7575c7de9d3a32cf1cb7f52e234ed0 Mon Sep 17 00:00:00 2001
From: Marcin Orlowski <MarcinOrlowski@users.noreply.github.com>
Date: Mon, 2 Aug 2021 19:46:59 +0200
Subject: [PATCH 140/140] Version bump

---
 docs/CHANGES.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/CHANGES.md b/docs/CHANGES.md
index 65a08bfa..b373d5c5 100644
--- a/docs/CHANGES.md
+++ b/docs/CHANGES.md
@@ -6,7 +6,7 @@
 
 # Changelog #
 
-* dev ()
+* v2.0.0 (2021-08-02)
   * Added support for config files.
   * Added option to `--create` template translation files.
   * The `--lang` now also supports comma separated arguments.