feat: 🎉 init project

.env

@@ -0,0 +1,2 @@
+PYTHONPATH=src
+GEVENT_SUPPORT=True

.gitattributes

@@ -0,0 +1 @@
+src/family_register/_version.py export-subst

.gitignore

@@ -0,0 +1,11 @@
+.env*/
+.venv*/
+__pycache__/
+build/
+dist/
+*.egg-info/
+.ropeproject/
+
+*.py[cod]
+*$py.class
+*.log

.vscode/launch.json

@@ -0,0 +1,23 @@
+{
+    // Verwendet IntelliSense zum Ermitteln möglicher Attribute.
+    // Zeigen Sie auf vorhandene Attribute, um die zugehörigen Beschreibungen anzuzeigen.
+    // Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Python: Family Register",
+            "type": "python",
+            "request": "launch",
+            "module": "family_register",
+            "envFile": "${workspaceFolder}/.env"
+        },
+        {
+            "name": "Python: Aktuelle Datei",
+            "type": "python",
+            "request": "launch",
+            "program": "${file}",
+            "console": "integratedTerminal",
+            "envFile": "${workspaceFolder}/.env"
+        }
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,22 @@
+{
+    "editor.rulers": [
+        80
+    ],
+    "python.formatting.provider": "yapf",
+    "python.sortImports.args": [
+        "--project=family_register"
+    ],
+    "python.linting.pylintEnabled": true,
+    "python.linting.pylintArgs": [
+        "--extension-pkg-whitelist=wx,numpy,lxml.etree,win32security",
+        "--generated-members=git",
+        "--disable=C0114,C0115,C0116,W0614,W0401,C0103"
+    ],
+    "editor.formatOnSave": true,
+    "[python]": {
+        "editor.codeActionsOnSave": {
+            "source.organizeImports": true
+        }
+    },
+    "python.pythonPath": ".venv\\Scripts\\python.exe"
+}

.vscode/tasks.json

@@ -0,0 +1,66 @@
+{
+    // See https://go.microsoft.com/fwlink/?LinkId=733558
+    // for the documentation about the tasks.json format
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "make",
+            "type": "shell",
+            "windows": {
+                // "command": "${config:python.pythonPath}",
+                "command": "${command:python.interpreterPath}",
+                "args": [
+                    "${workspaceFolder}\\tools\\pycompile.py",
+                    "${workspaceFolder}"
+                ]
+            },
+            "linux": {
+                // "command": "${config:python.pythonPath}",
+                "command": "${command:python.interpreterPath}",
+                "args": [
+                    "${workspaceFolder}/tools/pycompile.py",
+                    "${workspaceFolder}"
+                ]
+            },
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            },
+            "presentation": {
+                "reveal": "silent",
+                "focus": false,
+                "clear": true
+            },
+            "problemMatcher": []
+        },
+        {
+            "label": "gen i18n",
+            "type": "shell",
+            "windows": {
+                "command": "py",
+                "args": [
+                    "${workspaceFolder}\\tools\\geni18n.py"
+                ]
+            },
+            "linux": {
+                "command": "${command:python.interpreterPath}",
+                "args": [
+                    "${workspaceFolder}/tools/geni18n.py"
+                ]
+            },
+            "group": "none",
+            "presentation": {
+                "reveal": "silent",
+                "focus": false,
+                "clear": true
+            },
+            "problemMatcher": [],
+            "options": {
+                "cwd": "${workspaceFolder}/src/family_register",
+                "env": {
+                    "PYTHONPATH": "${workspaceFolder}/src"
+                }
+            }
+        },
+    ]
+}

LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) <year> <copyright holders>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

MANIFEST.in

@@ -0,0 +1,2 @@
+include versioneer.py
+include src/tsi_manager/_version.py

README.md

@@ -0,0 +1,2 @@
+# family-regsiter
+

build.bat

@@ -0,0 +1,10 @@
+@echo off
+setlocal
+setlocal enabledelayedexpansion
+
+For /D %%G IN (*env*3*9*) do set VENV=%%G
+
+echo python virtualenv: %~dp0%VENV%
+%VENV%\Scripts\python %~dp0tools\pycompile.py %~dp0
+
+pause

build.spec

@@ -0,0 +1,96 @@
+# -*- mode: python ; coding: utf-8 -*-
+
+from packaging.version import parse
+from PyInstaller.building.api import EXE, PYZ
+from PyInstaller.building.build_main import Analysis
+from PyInstaller.utils.win32.versioninfo import (FixedFileInfo, StringFileInfo,
+                                                 StringStruct, StringTable,
+                                                 VarFileInfo, VarStruct,
+                                                 VSVersionInfo)
+
+import versioneer
+
+# Update Version Hook
+# exec(open('updateVersion.py').read())
+
+block_cipher = None
+added_files = [
+    ('src/family_register/locale', 'locale'),
+]
+
+print(versioneer.get_versions()['dirty'])
+release = parse(versioneer.get_version())
+release_tuple = (release.major, release.minor, release.micro, 0)
+
+version = VSVersionInfo(
+    ffi=FixedFileInfo(
+        # filevers and prodvers should be always a Tuple with four items: (1, 2, 3, 4)
+        # Set not needed items to zero 0.
+        filevers=release_tuple,
+        prodvers=release_tuple,
+        # Contains a bitmask that specifies the valid bits 'flags'r
+        mask=0x3f,
+        # Contains a bitmask that specifies the Boolean attributes of the file.
+        flags=0x0,
+        # The operating system for which this file was designed.
+        # 0x4 - NT and there is no need to change it.
+        OS=0x4,
+        # The general type of file.
+        # 0x1 - the file is an application.
+        fileType=0x1,
+        # The function of the file.
+        # 0x0 - the function is not defined for this fileType
+        subtype=0x0,
+        # Creation date and time stamp.
+        date=(0, 0)),
+    kids=[
+        StringFileInfo([
+            StringTable('040904B0', [
+                StringStruct('CompanyName', ''),
+                StringStruct('FileDescription', 'Family Register'),
+                StringStruct('FileVersion', f'{release}'),
+                StringStruct('InternalName', 'family_register'),
+                StringStruct('LegalCopyright', 'Copyright (c) Philipp Rauch'),
+                StringStruct('OriginalFilename', 'Family-Register.exe'),
+                StringStruct('ProductName', 'Family Register'),
+                StringStruct('ProductVersion', f'{release}')
+            ])
+        ]),
+        VarFileInfo([
+            VarStruct('Translation', [1031, 1252]),
+            VarStruct('Translation', [1033, 1252])
+        ])
+    ])
+
+a = Analysis(['pyinstaller\\run_family_register.py'],
+             pathex=['build\\lib'],
+             binaries=[],
+             datas=added_files,
+             hiddenimports=["pkg_resources.py2_warn"],
+             hookspath=[],
+             runtime_hooks=[],
+             excludes=[],
+             win_no_prefer_redirects=False,
+             win_private_assemblies=False,
+             cipher=block_cipher,
+             noarchive=False)
+
+pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)
+exe = EXE(
+    pyz,
+    a.scripts,
+    a.binaries,
+    a.zipfiles,
+    a.datas,
+    [],
+    name=f'Family-Register {release}',
+    debug=False,
+    bootloader_ignore_signals=False,
+    strip=False,
+    upx=True,
+    upx_exclude=[],
+    runtime_tmpdir=None,
+    console=False,
+    # icon='[logo].ico',
+    version=version,
+)

dev-requirements.in

@@ -0,0 +1,12 @@
+-c requirements.txt
+
+inquirerpy
+isort
+packaging
+pip-licenses
+pip-tools
+pipreqs
+pyinstaller
+pylint
+yapf
+rope

dev-requirements.txt

@@ -0,0 +1,88 @@
+#
+# This file is autogenerated by pip-compile with python 3.9
+# To update, run:
+#
+#    pip-compile --output-file=dev-requirements.txt dev-requirements.in
+#
+altgraph==0.17.2
+    # via pyinstaller
+astroid==2.8.2
+    # via pylint
+certifi==2021.5.30
+    # via requests
+charset-normalizer==2.0.6
+    # via requests
+click==8.0.3
+    # via pip-tools
+docopt==0.6.2
+    # via pipreqs
+idna==3.2
+    # via requests
+inquirerpy==0.3.0
+    # via -r dev-requirements.in
+isort==5.9.3
+    # via
+    #   -r dev-requirements.in
+    #   pylint
+lazy-object-proxy==1.6.0
+    # via astroid
+mccabe==0.6.1
+    # via pylint
+packaging==21.3
+    # via
+    #   -c requirements.txt
+    #   -r dev-requirements.in
+pep517==0.11.0
+    # via pip-tools
+pfzy==0.3.3
+    # via inquirerpy
+pip-licenses==3.5.3
+    # via -r dev-requirements.in
+pip-tools==6.4.0
+    # via -r dev-requirements.in
+pipreqs==0.4.10
+    # via -r dev-requirements.in
+platformdirs==2.4.0
+    # via pylint
+prompt-toolkit==3.0.20
+    # via inquirerpy
+ptable==0.9.2
+    # via pip-licenses
+pyinstaller==4.5.1
+    # via -r dev-requirements.in
+pyinstaller-hooks-contrib==2021.3
+    # via pyinstaller
+pylint==2.11.1
+    # via -r dev-requirements.in
+pyparsing==2.4.7
+    # via
+    #   -c requirements.txt
+    #   packaging
+requests==2.26.0
+    # via yarg
+rope==0.20.1
+    # via -r dev-requirements.in
+toml==0.10.2
+    # via pylint
+tomli==1.2.1
+    # via pep517
+typing-extensions==3.10.0.2
+    # via
+    #   astroid
+    #   pylint
+urllib3==1.26.6
+    # via requests
+wcwidth==0.2.5
+    # via prompt-toolkit
+wheel==0.37.0
+    # via pip-tools
+wrapt==1.12.1
+    # via astroid
+yapf==0.31.0
+    # via -r dev-requirements.in
+yarg==0.1.9
+    # via pipreqs
+
+# The following packages are considered to be unsafe in a requirements file:
+# pip
+# setuptools

pyinstaller/run_family_register.py

@@ -0,0 +1,7 @@
+#! python3 -m flashtool
+# -*- coding: utf-8 -*-
+
+import family_register.app
+
+if __name__ == '__main__':
+    family_register.app.run()

requirements.txt

@@ -0,0 +1,18 @@
+#
+# This file is autogenerated by pip-compile with python 3.9
+# To update, run:
+#
+#    pip-compile
+#
+numpy==1.21.2
+    # via wxpython
+packaging==21.3
+    # via TSI-Manager (setup.py)
+pillow==8.3.2
+    # via wxpython
+pyparsing==2.4.7
+    # via packaging
+six==1.16.0
+    # via wxpython
+wxpython==4.1.1
+    # via TSI-Manager (setup.py)

run.bat

@@ -0,0 +1,13 @@
+@echo off
+setlocal
+setlocal enabledelayedexpansion
+
+For /D %%G IN (*env*3*9*) do set VENV=%%G
+
+echo python virtualenv: %~dp0%VENV%
+set PYTHONPATH=src
+
+call %VENV%\Scripts\activate.bat
+python -m family_register
+call %VENV%\Scripts\deactivate.bat
+endlocal

setup.cfg

@@ -0,0 +1,63 @@
+
+[metadata]
+name = Family Register
+# version = attr: tsi_manager.__version__
+author = Philipp Rauch
+author_email = smokephil@gmail.com
+description = Family address and relationship management program
+long_description = file: README.md
+license = MIT License
+classifiers =
+    Development Status :: 4 - Beta
+    Environment :: Win32 (MS Windows)
+    Intended Audience :: Developers
+    Intended Audience :: Manufacturing
+    License :: OSI Approved :: MIT License
+    Natural Language :: English
+    Natural Language :: German
+    Operating System :: Microsoft :: Windows :: Windows 10
+    Programming Language :: Python
+    Programming Language :: Python :: 3
+    Programming Language :: Python :: 3 :: Only
+    Programming Language :: Python :: 3.9
+
+[options]
+python_requires = >=3.9
+setup_requires =
+    setuptools >=38.3.0
+install_requires =
+    wxPython >=4.1.1
+    packaging >=21.3.0
+
+
+
+package_dir=
+    =src
+packages = find:
+include_package_data = true
+zip_safe = false
+
+
+[options.packages.find]
+where=src
+
+# [flake8]
+# exclude = build,dist,.git,.tox,.env38,.vscode
+# ignore = W504,W601
+# max-line-length = 119
+
+# [isort]
+# combine_as_imports = true
+# default_section = THIRDPARTY
+# include_trailing_comma = true
+# known_first_party = family_register
+# line_length = 79
+# multi_line_output = 5
+
+[versioneer]
+VCS = git
+style = pep440
+versionfile_source = src/family_register/_version.py
+versionfile_build = family_register/_version.py
+tag_prefix =
+parentdir_prefix =

setup.py

@@ -0,0 +1,8 @@
+from setuptools import setup
+
+import versioneer
+
+setup(
+    version=versioneer.get_version(),
+    cmdclass=versioneer.get_cmdclass(),
+)

src/family_register/__init__.py

@@ -0,0 +1,31 @@
+# -*- coding: utf-8 -*-
+
+import re
+import sys
+
+from packaging.version import parse
+
+from ._version import get_versions
+
+__frozen__ = bool(hasattr(sys, 'frozen') and hasattr(sys, '_MEIPASS'))
+__tool_name__ = 'Family Register'
+__version__ = get_versions()['version']
+__base_version__ = parse(__version__).base_version
+
+# # https://gitlab.com/alelec/python-certifi-win32/-/issues/11#note_603320530
+# if getattr(sys, 'frozen', False) and sys.platform == 'win32':
+#     import certifi
+#     import certifi_win32.wincerts
+
+#     certifi_win32.wincerts.CERTIFI_PEM = certifi.where()
+
+#     certifi.where = certifi_win32.wincerts.where
+
+#     from certifi_win32.wincerts import generate_pem, verify_combined_pem
+#     if not verify_combined_pem():
+#         generate_pem()
+
+del re
+del sys
+del parse
+del get_versions

src/family_register/__main__.py

@@ -0,0 +1,7 @@
+#! python3 -m tsi_manager
+# -*- coding: utf-8 -*-
+
+from family_register import app
+
+if __name__ == '__main__':
+    app.run()

src/family_register/_version.py

@@ -0,0 +1,623 @@
+
+# This file helps to compute a version number in source trees obtained from
+# git-archive tarball (such as those provided by githubs download-from-tag
+# feature). Distribution tarballs (built by setup.py sdist) and build
+# directories (produced by setup.py build) will contain a much shorter file
+# that just contains the computed version number.
+
+# This file is released into the public domain. Generated by
+# versioneer-0.20 (https://github.com/python-versioneer/python-versioneer)
+
+"""Git implementation of _version.py."""
+
+import errno
+import os
+import re
+import subprocess
+import sys
+
+
+def get_keywords():
+    """Get the keywords needed to look up the version information."""
+    # these strings will be replaced by git during git-archive.
+    # setup.py/versioneer.py will grep for the variable names, so they must
+    # each be defined on a line of their own. _version.py will just call
+    # get_keywords().
+    git_refnames = "$Format:%d$"
+    git_full = "$Format:%H$"
+    git_date = "$Format:%ci$"
+    keywords = {"refnames": git_refnames, "full": git_full, "date": git_date}
+    return keywords
+
+
+class VersioneerConfig:  # pylint: disable=too-few-public-methods
+    """Container for Versioneer configuration parameters."""
+
+
+def get_config():
+    """Create, populate and return the VersioneerConfig() object."""
+    # these strings are filled in when 'setup.py versioneer' creates
+    # _version.py
+    cfg = VersioneerConfig()
+    cfg.VCS = "git"
+    cfg.style = "pep440"
+    cfg.tag_prefix = ""
+    cfg.parentdir_prefix = ""
+    cfg.versionfile_source = "src/tsi_manager/_version.py"
+    cfg.verbose = False
+    return cfg
+
+
+class NotThisMethod(Exception):
+    """Exception raised if a method is not valid for the current scenario."""
+
+
+LONG_VERSION_PY = {}
+HANDLERS = {}
+
+
+def register_vcs_handler(vcs, method):  # decorator
+    """Create decorator to mark a method as the handler of a VCS."""
+    def decorate(f):
+        """Store f in HANDLERS[vcs][method]."""
+        if vcs not in HANDLERS:
+            HANDLERS[vcs] = {}
+        HANDLERS[vcs][method] = f
+        return f
+    return decorate
+
+
+# pylint:disable=too-many-arguments,consider-using-with # noqa
+def run_command(commands, args, cwd=None, verbose=False, hide_stderr=False,
+                env=None):
+    """Call the given command(s)."""
+    assert isinstance(commands, list)
+    process = None
+    for command in commands:
+        try:
+            dispcmd = str([command] + args)
+            # remember shell=False, so use git.cmd on windows, not just git
+            process = subprocess.Popen([command] + args, cwd=cwd, env=env,
+                                       stdout=subprocess.PIPE,
+                                       stderr=(subprocess.PIPE if hide_stderr
+                                               else None))
+            break
+        except EnvironmentError:
+            e = sys.exc_info()[1]
+            if e.errno == errno.ENOENT:
+                continue
+            if verbose:
+                print("unable to run %s" % dispcmd)
+                print(e)
+            return None, None
+    else:
+        if verbose:
+            print("unable to find command, tried %s" % (commands,))
+        return None, None
+    stdout = process.communicate()[0].strip().decode()
+    if process.returncode != 0:
+        if verbose:
+            print("unable to run %s (error)" % dispcmd)
+            print("stdout was %s" % stdout)
+        return None, process.returncode
+    return stdout, process.returncode
+
+
+def versions_from_parentdir(parentdir_prefix, root, verbose):
+    """Try to determine the version from the parent directory name.
+
+    Source tarballs conventionally unpack into a directory that includes both
+    the project name and a version string. We will also support searching up
+    two directory levels for an appropriately named parent directory
+    """
+    rootdirs = []
+
+    for _ in range(3):
+        dirname = os.path.basename(root)
+        if dirname.startswith(parentdir_prefix):
+            return {"version": dirname[len(parentdir_prefix):],
+                    "full-revisionid": None,
+                    "dirty": False, "error": None, "date": None}
+        rootdirs.append(root)
+        root = os.path.dirname(root)  # up a level
+
+    if verbose:
+        print("Tried directories %s but none started with prefix %s" %
+              (str(rootdirs), parentdir_prefix))
+    raise NotThisMethod("rootdir doesn't start with parentdir_prefix")
+
+
+@register_vcs_handler("git", "get_keywords")
+def git_get_keywords(versionfile_abs):
+    """Extract version information from the given file."""
+    # the code embedded in _version.py can just fetch the value of these
+    # keywords. When used from setup.py, we don't want to import _version.py,
+    # so we do it with a regexp instead. This function is not used from
+    # _version.py.
+    keywords = {}
+    try:
+        with open(versionfile_abs, "r") as fobj:
+            for line in fobj:
+                if line.strip().startswith("git_refnames ="):
+                    mo = re.search(r'=\s*"(.*)"', line)
+                    if mo:
+                        keywords["refnames"] = mo.group(1)
+                if line.strip().startswith("git_full ="):
+                    mo = re.search(r'=\s*"(.*)"', line)
+                    if mo:
+                        keywords["full"] = mo.group(1)
+                if line.strip().startswith("git_date ="):
+                    mo = re.search(r'=\s*"(.*)"', line)
+                    if mo:
+                        keywords["date"] = mo.group(1)
+    except EnvironmentError:
+        pass
+    return keywords
+
+
+@register_vcs_handler("git", "keywords")
+def git_versions_from_keywords(keywords, tag_prefix, verbose):
+    """Get version information from git keywords."""
+    if "refnames" not in keywords:
+        raise NotThisMethod("Short version file found")
+    date = keywords.get("date")
+    if date is not None:
+        # Use only the last line.  Previous lines may contain GPG signature
+        # information.
+        date = date.splitlines()[-1]
+
+        # git-2.2.0 added "%cI", which expands to an ISO-8601 -compliant
+        # datestamp. However we prefer "%ci" (which expands to an "ISO-8601
+        # -like" string, which we must then edit to make compliant), because
+        # it's been around since git-1.5.3, and it's too difficult to
+        # discover which version we're using, or to work around using an
+        # older one.
+        date = date.strip().replace(" ", "T", 1).replace(" ", "", 1)
+    refnames = keywords["refnames"].strip()
+    if refnames.startswith("$Format"):
+        if verbose:
+            print("keywords are unexpanded, not using")
+        raise NotThisMethod("unexpanded keywords, not a git-archive tarball")
+    refs = {r.strip() for r in refnames.strip("()").split(",")}
+    # starting in git-1.8.3, tags are listed as "tag: foo-1.0" instead of
+    # just "foo-1.0". If we see a "tag: " prefix, prefer those.
+    TAG = "tag: "
+    tags = {r[len(TAG):] for r in refs if r.startswith(TAG)}
+    if not tags:
+        # Either we're using git < 1.8.3, or there really are no tags. We use
+        # a heuristic: assume all version tags have a digit. The old git %d
+        # expansion behaves like git log --decorate=short and strips out the
+        # refs/heads/ and refs/tags/ prefixes that would let us distinguish
+        # between branches and tags. By ignoring refnames without digits, we
+        # filter out many common branch names like "release" and
+        # "stabilization", as well as "HEAD" and "master".
+        tags = {r for r in refs if re.search(r'\d', r)}
+        if verbose:
+            print("discarding '%s', no digits" % ",".join(refs - tags))
+    if verbose:
+        print("likely tags: %s" % ",".join(sorted(tags)))
+    for ref in sorted(tags):
+        # sorting will prefer e.g. "2.0" over "2.0rc1"
+        if ref.startswith(tag_prefix):
+            r = ref[len(tag_prefix):]
+            # Filter out refs that exactly match prefix or that don't start
+            # with a number once the prefix is stripped (mostly a concern
+            # when prefix is '')
+            if not re.match(r'\d', r):
+                continue
+            if verbose:
+                print("picking %s" % r)
+            return {"version": r,
+                    "full-revisionid": keywords["full"].strip(),
+                    "dirty": False, "error": None,
+                    "date": date}
+    # no suitable tags, so version is "0+unknown", but full hex is still there
+    if verbose:
+        print("no suitable tags, using unknown + full revision id")
+    return {"version": "0+unknown",
+            "full-revisionid": keywords["full"].strip(),
+            "dirty": False, "error": "no suitable tags", "date": None}
+
+
+@register_vcs_handler("git", "pieces_from_vcs")
+def git_pieces_from_vcs(tag_prefix, root, verbose, runner=run_command):
+    """Get version from 'git describe' in the root of the source tree.
+
+    This only gets called if the git-archive 'subst' keywords were *not*
+    expanded, and _version.py hasn't already been rewritten with a short
+    version string, meaning we're inside a checked out source tree.
+    """
+    GITS = ["git"]
+    if sys.platform == "win32":
+        GITS = ["git.cmd", "git.exe"]
+
+    _, rc = runner(GITS, ["rev-parse", "--git-dir"], cwd=root,
+                   hide_stderr=True)
+    if rc != 0:
+        if verbose:
+            print("Directory %s not under git control" % root)
+        raise NotThisMethod("'git rev-parse --git-dir' returned error")
+
+    # if there is a tag matching tag_prefix, this yields TAG-NUM-gHEX[-dirty]
+    # if there isn't one, this yields HEX[-dirty] (no NUM)
+    describe_out, rc = runner(GITS, ["describe", "--tags", "--dirty",
+                                     "--always", "--long",
+                                     "--match", "%s*" % tag_prefix],
+                              cwd=root)
+    # --long was added in git-1.5.5
+    if describe_out is None:
+        raise NotThisMethod("'git describe' failed")
+    describe_out = describe_out.strip()
+    full_out, rc = runner(GITS, ["rev-parse", "HEAD"], cwd=root)
+    if full_out is None:
+        raise NotThisMethod("'git rev-parse' failed")
+    full_out = full_out.strip()
+
+    pieces = {}
+    pieces["long"] = full_out
+    pieces["short"] = full_out[:7]  # maybe improved later
+    pieces["error"] = None
+
+    branch_name, rc = runner(GITS, ["rev-parse", "--abbrev-ref", "HEAD"],
+                             cwd=root)
+    # --abbrev-ref was added in git-1.6.3
+    if rc != 0 or branch_name is None:
+        raise NotThisMethod("'git rev-parse --abbrev-ref' returned error")
+    branch_name = branch_name.strip()
+
+    if branch_name == "HEAD":
+        # If we aren't exactly on a branch, pick a branch which represents
+        # the current commit. If all else fails, we are on a branchless
+        # commit.
+        branches, rc = runner(GITS, ["branch", "--contains"], cwd=root)
+        # --contains was added in git-1.5.4
+        if rc != 0 or branches is None:
+            raise NotThisMethod("'git branch --contains' returned error")
+        branches = branches.split("\n")
+
+        # Remove the first line if we're running detached
+        if "(" in branches[0]:
+            branches.pop(0)
+
+        # Strip off the leading "* " from the list of branches.
+        branches = [branch[2:] for branch in branches]
+        if "master" in branches:
+            branch_name = "master"
+        elif not branches:
+            branch_name = None
+        else:
+            # Pick the first branch that is returned. Good or bad.
+            branch_name = branches[0]
+
+    pieces["branch"] = branch_name
+
+    # parse describe_out. It will be like TAG-NUM-gHEX[-dirty] or HEX[-dirty]
+    # TAG might have hyphens.
+    git_describe = describe_out
+
+    # look for -dirty suffix
+    dirty = git_describe.endswith("-dirty")
+    pieces["dirty"] = dirty
+    if dirty:
+        git_describe = git_describe[:git_describe.rindex("-dirty")]
+
+    # now we have TAG-NUM-gHEX or HEX
+
+    if "-" in git_describe:
+        # TAG-NUM-gHEX
+        mo = re.search(r'^(.+)-(\d+)-g([0-9a-f]+)$', git_describe)
+        if not mo:
+            # unparseable. Maybe git-describe is misbehaving?
+            pieces["error"] = ("unable to parse git-describe output: '%s'"
+                               % describe_out)
+            return pieces
+
+        # tag
+        full_tag = mo.group(1)
+        if not full_tag.startswith(tag_prefix):
+            if verbose:
+                fmt = "tag '%s' doesn't start with prefix '%s'"
+                print(fmt % (full_tag, tag_prefix))
+            pieces["error"] = ("tag '%s' doesn't start with prefix '%s'"
+                               % (full_tag, tag_prefix))
+            return pieces
+        pieces["closest-tag"] = full_tag[len(tag_prefix):]
+
+        # distance: number of commits since tag
+        pieces["distance"] = int(mo.group(2))
+
+        # commit: short hex revision ID
+        pieces["short"] = mo.group(3)
+
+    else:
+        # HEX: no tags
+        pieces["closest-tag"] = None
+        count_out, rc = runner(GITS, ["rev-list", "HEAD", "--count"], cwd=root)
+        pieces["distance"] = int(count_out)  # total number of commits
+
+    # commit date: see ISO-8601 comment in git_versions_from_keywords()
+    date = runner(GITS, ["show", "-s", "--format=%ci", "HEAD"], cwd=root)[0].strip()
+    # Use only the last line.  Previous lines may contain GPG signature
+    # information.
+    date = date.splitlines()[-1]
+    pieces["date"] = date.strip().replace(" ", "T", 1).replace(" ", "", 1)
+
+    return pieces
+
+
+def plus_or_dot(pieces):
+    """Return a + if we don't already have one, else return a ."""
+    if "+" in pieces.get("closest-tag", ""):
+        return "."
+    return "+"
+
+
+def render_pep440(pieces):
+    """Build up version string, with post-release "local version identifier".
+
+    Our goal: TAG[+DISTANCE.gHEX[.dirty]] . Note that if you
+    get a tagged build and then dirty it, you'll get TAG+0.gHEX.dirty
+
+    Exceptions:
+    1: no tags. git_describe was just HEX. 0+untagged.DISTANCE.gHEX[.dirty]
+    """
+    if pieces["closest-tag"]:
+        rendered = pieces["closest-tag"]
+        if pieces["distance"] or pieces["dirty"]:
+            rendered += plus_or_dot(pieces)
+            rendered += "%d.g%s" % (pieces["distance"], pieces["short"])
+            if pieces["dirty"]:
+                rendered += ".dirty"
+    else:
+        # exception #1
+        rendered = "0+untagged.%d.g%s" % (pieces["distance"],
+                                          pieces["short"])
+        if pieces["dirty"]:
+            rendered += ".dirty"
+    return rendered
+
+
+def render_pep440_branch(pieces):
+    """TAG[[.dev0]+DISTANCE.gHEX[.dirty]] .
+
+    The ".dev0" means not master branch. Note that .dev0 sorts backwards
+    (a feature branch will appear "older" than the master branch).
+
+    Exceptions:
+    1: no tags. 0[.dev0]+untagged.DISTANCE.gHEX[.dirty]
+    """
+    if pieces["closest-tag"]:
+        rendered = pieces["closest-tag"]
+        if pieces["distance"] or pieces["dirty"]:
+            if pieces["branch"] != "master":
+                rendered += ".dev0"
+            rendered += plus_or_dot(pieces)
+            rendered += "%d.g%s" % (pieces["distance"], pieces["short"])
+            if pieces["dirty"]:
+                rendered += ".dirty"
+    else:
+        # exception #1
+        rendered = "0"
+        if pieces["branch"] != "master":
+            rendered += ".dev0"
+        rendered += "+untagged.%d.g%s" % (pieces["distance"],
+                                          pieces["short"])
+        if pieces["dirty"]:
+            rendered += ".dirty"
+    return rendered
+
+
+def render_pep440_pre(pieces):
+    """TAG[.post0.devDISTANCE] -- No -dirty.
+
+    Exceptions:
+    1: no tags. 0.post0.devDISTANCE
+    """
+    if pieces["closest-tag"]:
+        rendered = pieces["closest-tag"]
+        if pieces["distance"]:
+            rendered += ".post0.dev%d" % pieces["distance"]
+    else:
+        # exception #1
+        rendered = "0.post0.dev%d" % pieces["distance"]
+    return rendered
+
+
+def render_pep440_post(pieces):
+    """TAG[.postDISTANCE[.dev0]+gHEX] .
+
+    The ".dev0" means dirty. Note that .dev0 sorts backwards
+    (a dirty tree will appear "older" than the corresponding clean one),
+    but you shouldn't be releasing software with -dirty anyways.
+
+    Exceptions:
+    1: no tags. 0.postDISTANCE[.dev0]
+    """
+    if pieces["closest-tag"]:
+        rendered = pieces["closest-tag"]
+        if pieces["distance"] or pieces["dirty"]:
+            rendered += ".post%d" % pieces["distance"]
+            if pieces["dirty"]:
+                rendered += ".dev0"
+            rendered += plus_or_dot(pieces)
+            rendered += "g%s" % pieces["short"]
+    else:
+        # exception #1
+        rendered = "0.post%d" % pieces["distance"]
+        if pieces["dirty"]:
+            rendered += ".dev0"
+        rendered += "+g%s" % pieces["short"]
+    return rendered
+
+
+def render_pep440_post_branch(pieces):
+    """TAG[.postDISTANCE[.dev0]+gHEX[.dirty]] .
+
+    The ".dev0" means not master branch.
+
+    Exceptions:
+    1: no tags. 0.postDISTANCE[.dev0]+gHEX[.dirty]
+    """
+    if pieces["closest-tag"]:
+        rendered = pieces["closest-tag"]
+        if pieces["distance"] or pieces["dirty"]:
+            rendered += ".post%d" % pieces["distance"]
+            if pieces["branch"] != "master":
+                rendered += ".dev0"
+            rendered += plus_or_dot(pieces)
+            rendered += "g%s" % pieces["short"]
+            if pieces["dirty"]:
+                rendered += ".dirty"
+    else:
+        # exception #1
+        rendered = "0.post%d" % pieces["distance"]
+        if pieces["branch"] != "master":
+            rendered += ".dev0"
+        rendered += "+g%s" % pieces["short"]
+        if pieces["dirty"]:
+            rendered += ".dirty"
+    return rendered
+
+
+def render_pep440_old(pieces):
+    """TAG[.postDISTANCE[.dev0]] .
+
+    The ".dev0" means dirty.
+
+    Exceptions:
+    1: no tags. 0.postDISTANCE[.dev0]
+    """
+    if pieces["closest-tag"]:
+        rendered = pieces["closest-tag"]
+        if pieces["distance"] or pieces["dirty"]:
+            rendered += ".post%d" % pieces["distance"]
+            if pieces["dirty"]:
+                rendered += ".dev0"
+    else:
+        # exception #1
+        rendered = "0.post%d" % pieces["distance"]
+        if pieces["dirty"]:
+            rendered += ".dev0"
+    return rendered
+
+
+def render_git_describe(pieces):
+    """TAG[-DISTANCE-gHEX][-dirty].
+
+    Like 'git describe --tags --dirty --always'.
+
+    Exceptions:
+    1: no tags. HEX[-dirty]  (note: no 'g' prefix)
+    """
+    if pieces["closest-tag"]:
+        rendered = pieces["closest-tag"]
+        if pieces["distance"]:
+            rendered += "-%d-g%s" % (pieces["distance"], pieces["short"])
+    else:
+        # exception #1
+        rendered = pieces["short"]
+    if pieces["dirty"]:
+        rendered += "-dirty"
+    return rendered
+
+
+def render_git_describe_long(pieces):
+    """TAG-DISTANCE-gHEX[-dirty].
+
+    Like 'git describe --tags --dirty --always -long'.
+    The distance/hash is unconditional.
+
+    Exceptions:
+    1: no tags. HEX[-dirty]  (note: no 'g' prefix)
+    """
+    if pieces["closest-tag"]:
+        rendered = pieces["closest-tag"]
+        rendered += "-%d-g%s" % (pieces["distance"], pieces["short"])
+    else:
+        # exception #1
+        rendered = pieces["short"]
+    if pieces["dirty"]:
+        rendered += "-dirty"
+    return rendered
+
+
+def render(pieces, style):
+    """Render the given version pieces into the requested style."""
+    if pieces["error"]:
+        return {"version": "unknown",
+                "full-revisionid": pieces.get("long"),
+                "dirty": None,
+                "error": pieces["error"],
+                "date": None}
+
+    if not style or style == "default":
+        style = "pep440"  # the default
+
+    if style == "pep440":
+        rendered = render_pep440(pieces)
+    elif style == "pep440-branch":
+        rendered = render_pep440_branch(pieces)
+    elif style == "pep440-pre":
+        rendered = render_pep440_pre(pieces)
+    elif style == "pep440-post":
+        rendered = render_pep440_post(pieces)
+    elif style == "pep440-post-branch":
+        rendered = render_pep440_post_branch(pieces)
+    elif style == "pep440-old":
+        rendered = render_pep440_old(pieces)
+    elif style == "git-describe":
+        rendered = render_git_describe(pieces)
+    elif style == "git-describe-long":
+        rendered = render_git_describe_long(pieces)
+    else:
+        raise ValueError("unknown style '%s'" % style)
+
+    return {"version": rendered, "full-revisionid": pieces["long"],
+            "dirty": pieces["dirty"], "error": None,
+            "date": pieces.get("date")}
+
+
+def get_versions():
+    """Get version information or return default if unable to do so."""
+    # I am in _version.py, which lives at ROOT/VERSIONFILE_SOURCE. If we have
+    # __file__, we can work backwards from there to the root. Some
+    # py2exe/bbfreeze/non-CPython implementations don't do __file__, in which
+    # case we can only use expanded keywords.
+
+    cfg = get_config()
+    verbose = cfg.verbose
+
+    try:
+        return git_versions_from_keywords(get_keywords(), cfg.tag_prefix,
+                                          verbose)
+    except NotThisMethod:
+        pass
+
+    try:
+        root = os.path.realpath(__file__)
+        # versionfile_source is the relative path from the top of the source
+        # tree (where the .git directory might live) to this file. Invert
+        # this to find the root from __file__.
+        for _ in cfg.versionfile_source.split('/'):
+            root = os.path.dirname(root)
+    except NameError:
+        return {"version": "0+unknown", "full-revisionid": None,
+                "dirty": None,
+                "error": "unable to find root of source tree",
+                "date": None}
+
+    try:
+        pieces = git_pieces_from_vcs(cfg.tag_prefix, root, verbose)
+        return render(pieces, cfg.style)
+    except NotThisMethod:
+        pass
+
+    try:
+        if cfg.parentdir_prefix:
+            return versions_from_parentdir(cfg.parentdir_prefix, root, verbose)
+    except NotThisMethod:
+        pass
+
+    return {"version": "0+unknown", "full-revisionid": None,
+            "dirty": None,
+            "error": "unable to compute version", "date": None}

src/family_register/app.py

@@ -0,0 +1,52 @@
+#! python3 -m tsi-manager
+# -*- coding: utf-8 -*-
+import gettext
+import locale
+import os
+import sys
+
+import wx
+
+import family_register.app_constants
+import family_register.config
+import family_register.controller
+import family_register.gui
+import family_register.utils.log
+from family_register import __tool_name__, __version__
+
+_conf_ = family_register.config.get_conf()
+
+sys.displayhook = lambda obj: print(repr(obj)) if obj is not None else None
+
+# setup language
+gettext.bindtextdomain(family_register.app_constants.LANG_DOMAIN,
+                       family_register.app_constants.LOCALE_PATH)
+gettext.textdomain(family_register.app_constants.LANG_DOMAIN)
+
+try:
+    _lang_id_ = _conf_.get(family_register.config.GLOBAL, 'language')
+    language = family_register.app_constants.LANG[_lang_id_]
+except ValueError:
+    language = family_register.app_constants.LANG.en
+os.environ['LANG'] = language.name
+
+# setup logging
+file_log = _conf_.getboolean(family_register.config.GLOBAL, 'logging')
+family_register.utils.log.init_logging(file=file_log, shell=True)
+
+
+def run() -> None:
+    app = wx.App()
+
+    # reset locale to fix heap corruption [https://bugs.python.org/issue36792]
+    locale.setlocale(locale.LC_ALL, '')
+
+    title = f'{__tool_name__} - {__version__}'
+    frm = family_register.controller.MainFrame(title)
+    frm.locale = wx.Locale(language.locale)
+    frm.Show()
+    app.MainLoop()
+
+
+if __name__ == '__main__':
+    run()

src/family_register/app_constants.py

@@ -0,0 +1,51 @@
+import enum
+import os
+import sys
+import tempfile
+from pathlib import Path
+from typing import Final
+
+import wx
+
+from family_register import __tool_name__
+
+# language domain
+LANG_DOMAIN = "I18N_famreg"
+BUNDLE_DIR = getattr(sys, '_MEIPASS',
+                     os.path.abspath(os.path.dirname(__file__)))
+LOCALE_PATH = os.path.join(BUNDLE_DIR, 'locale')
+
+
+class LANG(enum.Enum):
+    def __new__(cls, text, locale=None):
+        obj = object.__new__(cls)
+        obj._value_ = text
+        obj.locale = locale
+        return obj
+
+    de = ('Deutsch', wx.LANGUAGE_GERMAN)
+    en = ('English', wx.LANGUAGE_ENGLISH)
+
+
+# base folders and paths
+if sys.platform == 'win32':
+    APPDATA: Final[str] = os.getenv('APPDATA')
+else:
+    APPDATA: Final[str] = os.path.join(Path.home(), '.config')
+TEMP: Final[str] = tempfile.gettempdir()
+TOOL_FOLDER: Final[str] = f'{__tool_name__}'
+
+STORAGE_PATH: Final[str] = os.path.join(APPDATA, TOOL_FOLDER)
+TEMP_PATH: Final[str] = os.path.join(TEMP, TOOL_FOLDER)
+
+# filenames
+FILE_CONFIG: Final[str] = 'settings.ini'
+FILE_LOG: Final[str] = f'{__tool_name__}.log'
+
+# filepaths
+FILEPATH_CONFIG: Final[str] = os.path.join(STORAGE_PATH, FILE_CONFIG)
+FILEPATH_LOG: Final[str] = os.path.join(TEMP_PATH, FILE_LOG)
+
+# init path
+os.makedirs(STORAGE_PATH, exist_ok=True)
+os.makedirs(TEMP_PATH, exist_ok=True)

src/family_register/config/__init__.py

@@ -0,0 +1,3 @@
+from .handler import GLOBAL, get_conf
+
+__all__ = ['GLOBAL', 'get_conf']

src/family_register/config/handler.py

@@ -0,0 +1,118 @@
+# -*- conding=utf-8 -*-
+from __future__ import annotations
+
+import os
+import re
+from configparser import _UNSET, ConfigParser, ExtendedInterpolation
+from uuid import uuid4
+
+from family_register.app_constants import FILEPATH_CONFIG
+from family_register.utils.decorater import singleton
+
+ENCODING = 'UTF-8'
+DEFAULT_CONFIG = {
+    (GLOBAL := 'Global'): {
+        'language': 'de',
+        'logging': True,
+        'loglevel': 'DEBUG',
+        'note': '',
+    }
+}
+
+
+@singleton
+class Config(ConfigParser):
+    def __init__(self, converters=_UNSET) -> None:
+        """initialize Config object
+        """
+        self.filename = ''
+        self.read_lock = False
+        super().__init__(converters=converters,
+                         interpolation=ExtendedInterpolation())
+        self.read_dict(DEFAULT_CONFIG)
+
+    def _convert_to_list(self, value: str, delimiter=',') -> list:
+        if value.strip() != '':
+            data = re.split(rf'\s*{delimiter}\s*|\s*,\s*|\s*;\s*', value)
+            return [i.strip() for i in data]
+
+        return []
+
+    def setfromdefault(self, section: str, option: str):
+        self.set(section, option, DEFAULT_CONFIG[section][option])
+
+    def setlist(self,
+                section: str,
+                option: str,
+                value: list,
+                *,
+                delimiter: str = ',') -> None:
+        self.set(section, option, delimiter.join(value))
+
+    def appendlist(self,
+                   section: str,
+                   option: str,
+                   value: str,
+                   *,
+                   delimiter: str = ',',
+                   in_order: bool = False,
+                   position: int = None) -> None:
+        value_list = self.getlist(section, option)
+        if position is None:
+            position = len(value_list)
+        value_list.insert(position, value)
+        if in_order:
+            value_list.sort()
+        self.setlist(section, option, value_list, delimiter=delimiter)
+
+    def getlist(self, section: str, option: str, *, fallback=_UNSET) -> list:
+        fallback = [] if fallback is _UNSET else fallback
+        value_list = self._get_conv(section,
+                                    option,
+                                    self._convert_to_list,
+                                    fallback=fallback)
+        return [] if value_list == [''] else value_list
+
+    def set_config_file(self, filename: str) -> None:
+        """set configurationfile
+
+        Arguments:
+            filename {str} -- path to tool configuration file
+        """
+        self.filename = filename
+        if not os.path.isfile(self.filename):
+            self.write2file()
+        self.read(self.filename, encoding=ENCODING)
+
+    def _read(self, fp, fpname) -> None:
+        """overwrite _read methode for locking this function
+
+        Arguments:
+            fp {io} --
+            fpname {[type]} -- [description]
+        """
+        if self.read_lock:
+            return None
+        self.read_lock = True
+        return super()._read(fp, fpname)
+
+    def write2file(self) -> None:
+        """write config to file
+        """
+        os.makedirs(os.path.dirname(self.filename), exist_ok=True)
+        with open(self.filename, 'w', encoding=ENCODING) as cfg:
+            self.write(cfg)
+
+
+def migrate_conf(conf: Config):
+    pass
+
+
+def get_conf(filename: str = FILEPATH_CONFIG, force: bool = False) -> Config:
+    if force is True and Config in singleton.instances:
+        del singleton.instances[Config]
+    conf = Config()
+    if filename != conf.filename:
+        conf.set_config_file(filename)
+        migrate_conf(conf)
+    return conf

src/family_register/controller/MainFrameController.py

@@ -0,0 +1,9 @@
+# -*- coding: utf-8 -*-
+import family_register.config
+import family_register.gui
+
+
+class MainFrame(family_register.gui.MainFrame):
+    def __init__(self, title: str):
+        super().__init__(None, title=title)
+        self.conf = family_register.config.get_conf()

src/family_register/controller/__init__.py

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+from .MainFrameController import MainFrame
+
+__all__ = ['MainFrame']

src/family_register/gui/__events__.py

@@ -0,0 +1,2 @@
+# -*- coding: utf-8 -*-
+import wx.lib.newevent

src/family_register/gui/__init__.py

@@ -0,0 +1,14 @@
+# -*- coding: utf-8 -*-
+import wx
+import wx.lib.art.img2pyartprov
+
+from . import __events__ as events
+from . import _imgCatalog
+from .frame_main import MainFrame
+
+wx.ArtProvider.Push(
+    wx.lib.art.img2pyartprov.Img2PyArtProvider(_imgCatalog,
+                                               artIdPrefix='myART_'))
+del _imgCatalog
+
+__all__ = ['events', 'MainFrame']

src/family_register/gui/__template__.py

@@ -0,0 +1,206 @@
+# -*- coding: utf-8 -*-
+
+###########################################################################
+## Python code generated with wxFormBuilder (version 3.9.0 Aug  5 2021)
+## http://www.wxformbuilder.org/
+##
+## PLEASE DO *NOT* EDIT THIS FILE!
+###########################################################################
+
+import wx
+import wx.xrc
+import wx.dataview
+
+import gettext
+_ = gettext.gettext
+
+###########################################################################
+## Class MainFrame
+###########################################################################
+
+class MainFrame ( wx.Frame ):
+
+	def __init__( self, parent ):
+		wx.Frame.__init__ ( self, parent, id = wx.ID_ANY, title = _(u"Family Register"), pos = wx.DefaultPosition, size = wx.Size( 938,526 ), style = wx.DEFAULT_FRAME_STYLE|wx.TAB_TRAVERSAL )
+
+		self.SetSizeHints( wx.DefaultSize, wx.DefaultSize )
+
+		mainSizer = wx.BoxSizer( wx.VERTICAL )
+
+		buttonSizer = wx.BoxSizer( wx.HORIZONTAL )
+
+		self.m_button1 = wx.Button( self, wx.ID_ANY, _(u"MyButton"), wx.DefaultPosition, wx.DefaultSize, 0 )
+		buttonSizer.Add( self.m_button1, 1, wx.ALL|wx.EXPAND, 5 )
+
+		self.m_button2 = wx.Button( self, wx.ID_ANY, _(u"MyButton"), wx.DefaultPosition, wx.DefaultSize, 0 )
+		buttonSizer.Add( self.m_button2, 1, wx.ALL|wx.EXPAND, 5 )
+
+		self.m_button3 = wx.Button( self, wx.ID_ANY, _(u"MyButton"), wx.DefaultPosition, wx.DefaultSize, 0 )
+		buttonSizer.Add( self.m_button3, 1, wx.ALL|wx.EXPAND, 5 )
+
+		self.m_button4 = wx.Button( self, wx.ID_ANY, _(u"MyButton"), wx.DefaultPosition, wx.DefaultSize, 0 )
+		buttonSizer.Add( self.m_button4, 1, wx.ALL|wx.EXPAND, 5 )
+
+
+		mainSizer.Add( buttonSizer, 0, wx.EXPAND, 5 )
+
+		self.search_box = wx.SearchCtrl( self, wx.ID_ANY, wx.EmptyString, wx.DefaultPosition, wx.Size( -1,25 ), 0 )
+		self.search_box.ShowSearchButton( True )
+		self.search_box.ShowCancelButton( True )
+		mainSizer.Add( self.search_box, 0, wx.ALL|wx.EXPAND, 5 )
+
+		self.register_dataViewCtrl = wx.dataview.DataViewCtrl( self, wx.ID_ANY, wx.DefaultPosition, wx.DefaultSize, wx.dataview.DV_HORIZ_RULES|wx.dataview.DV_ROW_LINES|wx.dataview.DV_VERT_RULES )
+		self.name_dataViewColumn = self.register_dataViewCtrl.AppendTextColumn( _(u"Name"), 0, wx.dataview.DATAVIEW_CELL_INERT, -1, wx.ALIGN_LEFT, wx.dataview.DATAVIEW_COL_RESIZABLE )
+		self.adress_dataViewColumn = self.register_dataViewCtrl.AppendTextColumn( _(u"Address"), 0, wx.dataview.DATAVIEW_CELL_INERT, -1, wx.ALIGN_LEFT, wx.dataview.DATAVIEW_COL_RESIZABLE )
+		self.zip_dataViewColumn = self.register_dataViewCtrl.AppendTextColumn( _(u"Zip code"), 0, wx.dataview.DATAVIEW_CELL_INERT, -1, wx.ALIGN_LEFT, wx.dataview.DATAVIEW_COL_RESIZABLE )
+		self.city_dataViewColumn = self.register_dataViewCtrl.AppendTextColumn( _(u"City"), 0, wx.dataview.DATAVIEW_CELL_INERT, -1, wx.ALIGN_LEFT, wx.dataview.DATAVIEW_COL_RESIZABLE )
+		self.phone_dataViewColumn = self.register_dataViewCtrl.AppendTextColumn( _(u"Phone"), 0, wx.dataview.DATAVIEW_CELL_INERT, -1, wx.ALIGN_LEFT, wx.dataview.DATAVIEW_COL_RESIZABLE )
+		self.mobile_dataViewColumn = self.register_dataViewCtrl.AppendTextColumn( _(u"Mobile"), 0, wx.dataview.DATAVIEW_CELL_INERT, -1, wx.ALIGN_LEFT, wx.dataview.DATAVIEW_COL_RESIZABLE )
+		self.mail_dataViewColumn = self.register_dataViewCtrl.AppendTextColumn( _(u"E-mail"), 0, wx.dataview.DATAVIEW_CELL_INERT, -1, wx.ALIGN_LEFT, wx.dataview.DATAVIEW_COL_RESIZABLE )
+		self.empty_dataViewColumn = self.register_dataViewCtrl.AppendTextColumn( wx.EmptyString, 0, wx.dataview.DATAVIEW_CELL_INERT, -1, wx.ALIGN_LEFT, wx.dataview.DATAVIEW_COL_RESIZABLE )
+		mainSizer.Add( self.register_dataViewCtrl, 1, wx.ALL|wx.EXPAND, 5 )
+
+
+		self.SetSizer( mainSizer )
+		self.Layout()
+
+		self.Centre( wx.BOTH )
+
+	def __del__( self ):
+		pass
+
+
+###########################################################################
+## Class PersonDialog
+###########################################################################
+
+class PersonDialog ( wx.Dialog ):
+
+	def __init__( self, parent ):
+		wx.Dialog.__init__ ( self, parent, id = wx.ID_ANY, title = _(u"Person"), pos = wx.DefaultPosition, size = wx.Size( 825,502 ), style = wx.DEFAULT_DIALOG_STYLE )
+
+		self.SetSizeHints( wx.DefaultSize, wx.DefaultSize )
+
+		mainSizer = wx.BoxSizer( wx.VERTICAL )
+
+		contentSizer = wx.BoxSizer( wx.HORIZONTAL )
+
+		self.icon_bitmap = wx.StaticBitmap( self, wx.ID_ANY, wx.ArtProvider.GetBitmap( wx.ART_NEW, wx.ART_CMN_DIALOG ), wx.DefaultPosition, wx.Size( -1,-1 ), 0 )
+		contentSizer.Add( self.icon_bitmap, 1, wx.ALIGN_CENTER|wx.ALL, 5 )
+
+		addressSizer = wx.GridBagSizer( 0, 0 )
+		addressSizer.SetFlexibleDirection( wx.BOTH )
+		addressSizer.SetNonFlexibleGrowMode( wx.FLEX_GROWMODE_SPECIFIED )
+
+		self.firstname_staticText = wx.StaticText( self, wx.ID_ANY, _(u"First name"), wx.DefaultPosition, wx.DefaultSize, 0 )
+		self.firstname_staticText.Wrap( -1 )
+
+		addressSizer.Add( self.firstname_staticText, wx.GBPosition( 0, 0 ), wx.GBSpan( 1, 2 ), wx.LEFT|wx.TOP, 5 )
+
+		self.lastname_staticText = wx.StaticText( self, wx.ID_ANY, _(u"Last name"), wx.DefaultPosition, wx.DefaultSize, 0 )
+		self.lastname_staticText.Wrap( -1 )
+
+		addressSizer.Add( self.lastname_staticText, wx.GBPosition( 0, 2 ), wx.GBSpan( 1, 2 ), wx.LEFT|wx.TOP, 5 )
+
+		self.firstname_textCtrl = wx.TextCtrl( self, wx.ID_ANY, wx.EmptyString, wx.DefaultPosition, wx.Size( 150,-1 ), 0 )
+		addressSizer.Add( self.firstname_textCtrl, wx.GBPosition( 1, 0 ), wx.GBSpan( 1, 2 ), wx.BOTTOM|wx.EXPAND|wx.LEFT|wx.RIGHT, 5 )
+
+		self.lastname_textCtrl = wx.TextCtrl( self, wx.ID_ANY, wx.EmptyString, wx.DefaultPosition, wx.Size( 150,-1 ), 0 )
+		addressSizer.Add( self.lastname_textCtrl, wx.GBPosition( 1, 2 ), wx.GBSpan( 1, 2 ), wx.BOTTOM|wx.EXPAND|wx.LEFT|wx.RIGHT, 5 )
+
+		self.street_staticText = wx.StaticText( self, wx.ID_ANY, _(u"Street"), wx.DefaultPosition, wx.DefaultSize, 0 )
+		self.street_staticText.Wrap( -1 )
+
+		addressSizer.Add( self.street_staticText, wx.GBPosition( 2, 0 ), wx.GBSpan( 1, 3 ), wx.LEFT|wx.TOP, 5 )
+
+		self.housenumber_staticText = wx.StaticText( self, wx.ID_ANY, _(u"Nr."), wx.DefaultPosition, wx.DefaultSize, 0 )
+		self.housenumber_staticText.Wrap( -1 )
+
+		addressSizer.Add( self.housenumber_staticText, wx.GBPosition( 2, 3 ), wx.GBSpan( 1, 1 ), wx.LEFT|wx.TOP, 5 )
+
+		self.street_textCtrl = wx.TextCtrl( self, wx.ID_ANY, wx.EmptyString, wx.DefaultPosition, wx.DefaultSize, 0 )
+		addressSizer.Add( self.street_textCtrl, wx.GBPosition( 3, 0 ), wx.GBSpan( 1, 3 ), wx.BOTTOM|wx.EXPAND|wx.LEFT|wx.RIGHT, 5 )
+
+		self.housenumber_textCtrl = wx.TextCtrl( self, wx.ID_ANY, wx.EmptyString, wx.DefaultPosition, wx.Size( 75,-1 ), 0 )
+		addressSizer.Add( self.housenumber_textCtrl, wx.GBPosition( 3, 3 ), wx.GBSpan( 1, 1 ), wx.BOTTOM|wx.LEFT|wx.RIGHT, 5 )
+
+		self.zip_staticText = wx.StaticText( self, wx.ID_ANY, _(u"Zip code"), wx.DefaultPosition, wx.DefaultSize, 0 )
+		self.zip_staticText.Wrap( -1 )
+
+		addressSizer.Add( self.zip_staticText, wx.GBPosition( 4, 0 ), wx.GBSpan( 1, 1 ), wx.LEFT|wx.TOP, 5 )
+
+		self.city_staticText = wx.StaticText( self, wx.ID_ANY, _(u"City"), wx.DefaultPosition, wx.DefaultSize, 0 )
+		self.city_staticText.Wrap( -1 )
+
+		addressSizer.Add( self.city_staticText, wx.GBPosition( 4, 1 ), wx.GBSpan( 1, 3 ), wx.LEFT|wx.TOP, 5 )
+
+		self.zip_textCtrl = wx.TextCtrl( self, wx.ID_ANY, wx.EmptyString, wx.DefaultPosition, wx.Size( 80,-1 ), 0 )
+		addressSizer.Add( self.zip_textCtrl, wx.GBPosition( 5, 0 ), wx.GBSpan( 1, 1 ), wx.BOTTOM|wx.LEFT|wx.RIGHT, 5 )
+
+		self.city_textCtrl = wx.TextCtrl( self, wx.ID_ANY, wx.EmptyString, wx.DefaultPosition, wx.DefaultSize, 0 )
+		addressSizer.Add( self.city_textCtrl, wx.GBPosition( 5, 1 ), wx.GBSpan( 1, 3 ), wx.BOTTOM|wx.EXPAND|wx.LEFT|wx.RIGHT, 5 )
+
+		self.country_staticText = wx.StaticText( self, wx.ID_ANY, _(u"Country"), wx.DefaultPosition, wx.DefaultSize, 0 )
+		self.country_staticText.Wrap( -1 )
+
+		addressSizer.Add( self.country_staticText, wx.GBPosition( 6, 0 ), wx.GBSpan( 1, 4 ), wx.LEFT|wx.TOP, 5 )
+
+		country_comboBoxChoices = []
+		self.country_comboBox = wx.ComboBox( self, wx.ID_ANY, wx.EmptyString, wx.DefaultPosition, wx.DefaultSize, country_comboBoxChoices, wx.CB_DROPDOWN|wx.CB_READONLY )
+		addressSizer.Add( self.country_comboBox, wx.GBPosition( 7, 0 ), wx.GBSpan( 1, 4 ), wx.BOTTOM|wx.EXPAND|wx.LEFT|wx.RIGHT, 5 )
+
+		self.m_staticline1 = wx.StaticLine( self, wx.ID_ANY, wx.DefaultPosition, wx.DefaultSize, wx.LI_HORIZONTAL )
+		addressSizer.Add( self.m_staticline1, wx.GBPosition( 8, 0 ), wx.GBSpan( 1, 4 ), wx.ALL|wx.EXPAND, 5 )
+
+		self.phone_staticText = wx.StaticText( self, wx.ID_ANY, _(u"Phone"), wx.DefaultPosition, wx.DefaultSize, 0 )
+		self.phone_staticText.Wrap( -1 )
+
+		addressSizer.Add( self.phone_staticText, wx.GBPosition( 9, 0 ), wx.GBSpan( 1, 4 ), wx.LEFT|wx.TOP, 5 )
+
+		self.phone_textCtrl = wx.TextCtrl( self, wx.ID_ANY, wx.EmptyString, wx.DefaultPosition, wx.DefaultSize, 0 )
+		addressSizer.Add( self.phone_textCtrl, wx.GBPosition( 10, 0 ), wx.GBSpan( 1, 4 ), wx.BOTTOM|wx.EXPAND|wx.LEFT|wx.RIGHT, 5 )
+
+		self.mobile_staticText = wx.StaticText( self, wx.ID_ANY, _(u"Mobile"), wx.DefaultPosition, wx.DefaultSize, 0 )
+		self.mobile_staticText.Wrap( -1 )
+
+		addressSizer.Add( self.mobile_staticText, wx.GBPosition( 11, 0 ), wx.GBSpan( 1, 4 ), wx.EXPAND|wx.LEFT|wx.TOP, 5 )
+
+		self.mobile_textCtrl = wx.TextCtrl( self, wx.ID_ANY, wx.EmptyString, wx.DefaultPosition, wx.DefaultSize, 0 )
+		addressSizer.Add( self.mobile_textCtrl, wx.GBPosition( 12, 0 ), wx.GBSpan( 1, 4 ), wx.BOTTOM|wx.EXPAND|wx.LEFT|wx.RIGHT, 5 )
+
+		self.mail_staticText = wx.StaticText( self, wx.ID_ANY, _(u"E-mail"), wx.DefaultPosition, wx.DefaultSize, 0 )
+		self.mail_staticText.Wrap( -1 )
+
+		addressSizer.Add( self.mail_staticText, wx.GBPosition( 13, 0 ), wx.GBSpan( 1, 4 ), wx.LEFT|wx.TOP, 5 )
+
+		self.mail_textCtrl = wx.TextCtrl( self, wx.ID_ANY, wx.EmptyString, wx.DefaultPosition, wx.DefaultSize, 0 )
+		addressSizer.Add( self.mail_textCtrl, wx.GBPosition( 14, 0 ), wx.GBSpan( 1, 4 ), wx.BOTTOM|wx.EXPAND|wx.LEFT|wx.RIGHT, 5 )
+
+
+		addressSizer.AddGrowableCol( 1 )
+		addressSizer.AddGrowableCol( 2 )
+
+		contentSizer.Add( addressSizer, 2, wx.EXPAND, 5 )
+
+
+		mainSizer.Add( contentSizer, 1, wx.EXPAND, 5 )
+
+		m_sdbSizer1 = wx.StdDialogButtonSizer()
+		self.m_sdbSizer1OK = wx.Button( self, wx.ID_OK )
+		m_sdbSizer1.AddButton( self.m_sdbSizer1OK )
+		self.m_sdbSizer1Cancel = wx.Button( self, wx.ID_CANCEL )
+		m_sdbSizer1.AddButton( self.m_sdbSizer1Cancel )
+		m_sdbSizer1.Realize();
+
+		mainSizer.Add( m_sdbSizer1, 0, wx.ALL|wx.EXPAND, 5 )
+
+
+		self.SetSizer( mainSizer )
+		self.Layout()
+
+		self.Centre( wx.BOTH )
+
+	def __del__( self ):
+		pass
+
+

src/family_register/gui/_imgCatalog.py

@@ -0,0 +1,27 @@
+from wx.lib.embeddedimage import PyEmbeddedImage
+
+# ***************** Catalog starts here *******************
+
+catalog = {}
+index = []
+
+#----------------------------------------------------------------------
+TESTGUIDE = PyEmbeddedImage(
+    b'iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAADGklEQVR4nO2XP48bVRTFf/fN'
+    b'2I5jG5SQrVLQU4FElyBFpOATmI+wDUqF2HTMDDRIQIFEyRfA7ugoAishdxRpkg9AQQOWstn4'
+    b'/7x3KOxhbe/aOyN2hZC4zTTvnXPeu+fde8coEUpwZGj4DXfrOd8J3s8DMWBry3yrTnQ6ZXDw'
+    b'mPsSZoYuw3ZlBPAcMxAzvuq0+WARcFvkCCwIzLgDUIa8tADr41egb48nhG3yzcXkZTArCShC'
+    b'kNsle0x7xP1TAVXBr1zAdcSVC1BJ8xURV1lshpfwiCDOEQWMgIiuTUAQr9+8QeQckVtzg4AQ'
+    b'iJotGM/4CUA9Ivtw+Xr2CpAw+rh9i5XgLCMIfpjNeWc0J7BKnwMhiCPyFyf8MhvxhcDSZ6jb'
+    b'7Ub9fn+fiCs3deWwP7/mbt34XPDuwuMkrHCmwHcaxC9nPDk44pESYlJ8mm4qT1NEih2DO4aQ'
+    b'Zejw8LAZrPaZM3uYB19bAS73GXKYExrGBL7vdLg3mkCttqnOB6jXwc2ZAKQQsqXLNwyYZYVe'
+    b'QpIkMWS5Vy1td9ofT8ZjavEWcHF6M+LIuDd8iccuyIfwtQWRYFThVsPqc382nfrc+4B04csw'
+    b'M8VeyOzipyPQqvRWrxeGByJbMu3c7+yanKiSZfs/U4orldcKoRjw2p2GoCV1pfJ6tldBEJDO'
+    b'4ZuZzCyKW3WisON8QbhGC17NGQA8AJf97fL9YUarVqs5Sc5sk18SjUaD0Wg8iF/NGTi4HSAU'
+    b'/b7oaPWIxckLnrzxGomEpSnh54T4AYQUSC8gPuZ4KdJssMgXTe/zXOsNypBzUZhOp786zT8t'
+    b'c5hrDbtselWPiGeIDP2e0Gx3eGyO9xZ+1cjOIrQbuNMZTw+OeJQkuCzbna5utxv1er1Q6q0W'
+    b'rXX4Jd/evsVHk1FRYdbYBTfqMDzltztHvFkGF0rOA0Wrlng4GZGPZ4jzTziEgHPGSVny0gLO'
+    b'lOARMUbYno617C1OFSei/6fif30qrvZndAm4IFhFX1W7Ae0GF3CziRM8BVC3nBlLCVgrOH+s'
+    b'Bojtm1DdkZ+O+NGmfCIw3iqXir8AcetQsM6kEZgAAAAASUVORK5CYII=')
+index.append('TESTGUIDE')
+catalog['TESTGUIDE'] = TESTGUIDE

src/family_register/gui/frame_main.py

@@ -0,0 +1,9 @@
+# -*- coding: utf-8 -*-
+
+from .__template__ import MainFrame as skelet
+
+
+class MainFrame(skelet):
+    def __init__(self, parent, title: str):
+        super().__init__(parent)
+        self.SetTitle(title)

src/family_register/locale/I18N_famreg.pot

@@ -0,0 +1,105 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR ORGANIZATION
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"POT-Creation-Date: 2021-11-28 10:57+0100\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: pygettext.py 1.5\n"
+
+
+#:
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:24
+msgid "Family Register"
+msgstr ""
+
+#:
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:32
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:35
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:38
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:41
+msgid "MyButton"
+msgstr ""
+
+#:
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:53
+msgid "Name"
+msgstr ""
+
+#:
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:54
+msgid "Address"
+msgstr ""
+
+#:
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:55
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:127
+msgid "Zip code"
+msgstr ""
+
+#:
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:56
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:132
+msgid "City"
+msgstr ""
+
+#:
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:57
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:155
+msgid "Phone"
+msgstr ""
+
+#:
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:58
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:163
+msgid "Mobile"
+msgstr ""
+
+#:
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:59
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:171
+msgid "E-mail"
+msgstr ""
+
+#:
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:80
+msgid "Person"
+msgstr ""
+
+#:
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:95
+msgid "First name"
+msgstr ""
+
+#:
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:100
+msgid "Last name"
+msgstr ""
+
+#:
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:111
+msgid "Street"
+msgstr ""
+
+#:
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:116
+msgid "Nr."
+msgstr ""
+
+#:
+#: /home/smokephil/Projekte/Familienregister/src/family_register/gui/__template__.py:143
+msgid "Country"
+msgstr ""
+
+#:
+#: /home/smokephil/Projekte/Familienregister/src/family_register/utils/log.py:37
+msgid "open logfile"
+msgstr ""
+

src/family_register/utils/decorater.py

@@ -0,0 +1,29 @@
+# -*- coding-utf-8 -*-
+import sys
+from functools import wraps
+from typing import Callable, Type, TypeVar
+
+T = TypeVar('T')
+
+
+def singleton(cls: Type[T]) -> Type[T]:
+    singleton.instances = {}
+
+    def getinstance():
+        if cls not in singleton.instances:
+            singleton.instances[cls] = cls()
+        return singleton.instances[cls]
+
+    return getinstance
+
+
+def use_exceptionLogging(func: Callable):
+    """ Redirect any unexpected tracebacks """
+    @wraps(func)
+    def run(*args, **kwargs):
+        try:
+            return func(*args, **kwargs)
+        except:  #pylint: disable=bare-except
+            sys.excepthook(*sys.exc_info())
+
+    return run

src/family_register/utils/log.py

@@ -0,0 +1,132 @@
+#! python3
+# -*- coding: utf-8 -*-
+import logging
+import os
+import platform
+import socket
+import sys
+import textwrap
+import traceback
+from datetime import datetime
+from gettext import gettext as _
+
+import wx
+
+import family_register.config
+import family_register.gui
+from family_register import __tool_name__, __version__
+from family_register._version import get_versions
+from family_register.app_constants import FILEPATH_LOG
+
+
+# disabel logger from modules
+def handle_exception(exc_type, exc_value, exc_traceback):
+    if issubclass(exc_type, KeyboardInterrupt):
+        sys.__excepthook__(exc_type, exc_value, exc_traceback)
+        return
+
+    exception = ''.join(traceback.format_exception_only(exc_type, exc_value))
+    exc_info = (exc_type, exc_value, exc_traceback)
+    logging.critical(exception, exc_info=exc_info)
+
+    dlg = wx.RichMessageDialog(None,
+                               exception,
+                               caption=exc_type.__name__,
+                               style=wx.ICON_ERROR | wx.OK | wx.CENTRE)
+    dlg.ShowDetailedText(''.join(traceback.format_exception(*exc_info)))
+    dlg.ShowCheckBox(_('open logfile'))
+    dlg.ShowModal()
+
+    if dlg.IsCheckBoxChecked():
+        os.startfile(FILEPATH_LOG)
+
+
+sys.excepthook = handle_exception
+
+
+def init_logging(file: bool = True, shell: bool = False) -> None:
+    conf = family_register.config.get_conf()
+
+    loglevel = conf.get('General', 'loglevel', fallback='NOTSET')
+    if loglevel not in ('CRITICAL', 'ERROR', 'WARNING', 'INFO', 'DEBUG',
+                        'NOTSET'):
+        loglevel = logging.NOTSET
+
+    ## create logger
+    logger = logging.getLogger()
+    logger.setLevel(loglevel)
+    while logger.hasHandlers():
+        logger.handlers[0].close()
+        logger.removeHandler(logger.handlers[0])
+
+    # logging.Formatter attributes:
+    # https://docs.python.org/3/library/logging.html#logrecord-attributes
+
+    if shell:
+        _shell_ = logging.StreamHandler(sys.stdout)
+        _shell_.setLevel(loglevel)
+        outformat = logging.Formatter(
+            '%(threadName)10s:%(levelname)-8s | :%(name)s: %(message)s')
+        _shell_.setFormatter(outformat)
+        logger.addHandler(_shell_)
+
+    if file:
+        write_sysinfo(FILEPATH_LOG)
+        write_startup(FILEPATH_LOG)
+        _file_ = logging.FileHandler(FILEPATH_LOG,
+                                     mode='a',
+                                     encoding='latin-1')
+        _file_.setLevel(loglevel)
+        logformat = logging.Formatter(
+            '%(asctime)s | %(levelname)-8s - '
+            '[%(threadName)-10s] [%(name)s] %(message)s')
+        _file_.setFormatter(logformat)
+        logger.addHandler(_file_)
+
+    #logger.info('loglevel: %s', loglevel)
+
+
+def write_sysinfo(filename: str = FILEPATH_LOG) -> None:
+    sysinfo = f"""
+      LOG: {FILEPATH_LOG}
+      ----------------------------------------------------------------
+      Systeminfo:
+      Hostname:         {socket.gethostname()}
+      CPU:              {platform.processor()}
+      Operating system: {platform.platform()}
+      ----------------------------------------------------------------
+    """
+    if not os.path.exists(filename) or os.stat(filename).st_size == 0:
+        with open(filename, 'w', encoding='latin-1') as handler:
+            handler.write(textwrap.dedent(sysinfo).strip() + '\n\n')
+
+
+def write_startup(filename: str = FILEPATH_LOG) -> None:
+    timestamp = datetime.now().strftime('%d.%m.%Y %H:%M:%S')
+    head = f'= {timestamp} === {__tool_name__} {__version__} ===\n'
+    head += f'Build Date: {get_versions()["date"]}\n'
+    head += f'Revisionid: {get_versions()["full-revisionid"]}\n'
+
+    print(head)
+    with open(filename, 'a', encoding='latin-1') as handler:
+        handler.write('\n\n' + head + '\n')
+
+
+def set_loglevel(loglevel: str = None) -> None:
+    if loglevel not in ('CRITICAL', 'ERROR', 'WARNING', 'INFO', 'DEBUG',
+                        'NOTSET'):
+        loglevel = logging.NOTSET
+
+    for logger in logging.Logger.manager.loggerDict.values():
+        if isinstance(logger, logging.Logger):
+            logger.setLevel(loglevel)
+
+    # diable external logger
+    logging.getLogger('parse').setLevel(logging.ERROR)
+    logging.getLogger('PIL').setLevel(logging.ERROR)
+    logging.getLogger('icoextract').setLevel(logging.ERROR)
+
+
+set_loglevel()
+
+__all__ = ['init_logging', 'set_loglevel']

tools/geni18n.py

@@ -0,0 +1,64 @@
+# -*- coding: utf-8 -*-
+"""
+This will generate the .pot and .mo files for the application domain and
+languages defined below.
+
+The .po and .mo files are placed as per convention in
+
+"appfolder/locale/lang/LC_MESSAGES"
+
+The .pot file is placed in the locale folder.
+
+This script or something similar should be added to your build process.
+
+The actual translation work is normally done using a tool like poEdit or
+similar, it allows you to generate a particular language catalog from the .pot
+file or to use the .pot to merge new translations into an existing language
+catalog.
+
+"""
+
+import os
+import subprocess
+import sys
+
+import family_register
+import family_register.app_constants
+
+# we remove English as source code strings are in English
+supportedLang = []
+for l in family_register.app_constants.LANG:
+    if l != family_register.app_constants.LANG.en:
+        supportedLang.append(l.name)
+
+appFolder = os.path.dirname(os.path.abspath(family_register.__file__))
+
+# setup some stuff to get at Python I18N tools/utilities
+
+pyExe = sys.executable
+pyFolder = '/usr/lib/python3.9'  # os.path.split(pyExe)[0]
+pyToolsFolder = os.path.join(pyFolder, 'Tools')
+pyI18nFolder = os.path.join(pyToolsFolder, 'i18n')
+pyGettext = os.path.join(pyI18nFolder, 'pygettext.py')
+pyMsgfmt = os.path.join(pyI18nFolder, 'msgfmt.py')
+outFolder = os.path.join(appFolder, 'locale')
+
+langDomain = family_register.app_constants.LANG_DOMAIN
+
+# build command for pygettext
+tCmd = f'{pyExe} -Xutf8 {pyGettext} -a -d {langDomain} -o {langDomain}.pot -p {outFolder} {appFolder}'
+print("Generating the .pot file")
+print(f"cmd: {tCmd}")
+rCode = subprocess.call(tCmd, shell=True)
+print(f"return code: {rCode}\n\n")
+
+for tLang in supportedLang:
+    # build command for msgfmt
+    langDir = os.path.join(appFolder, rf'locale\{tLang}\LC_MESSAGES')
+    poFile = os.path.join(langDir, f'{langDomain}.po')
+    tCmd = f'{pyExe} {pyMsgfmt} {poFile}'
+
+    print("Generating the .mo file")
+    print(f"cmd: {tCmd}")
+    rCode = subprocess.call(tCmd, shell=True)
+    print(f"return code: {rCode}\n\n")

tools/pycompile.py

@@ -0,0 +1,45 @@
+#!/usr/bin/env python3
+
+import os
+import subprocess
+import sys
+
+import PyInstaller.__main__
+
+# ARGS
+workspaceFolder = sys.argv[1]
+
+pyExe = sys.executable
+pyFolder = os.path.split(pyExe)[0]
+
+# TRANSFORMATION
+for file in os.listdir(workspaceFolder):
+    if file.endswith(".spec"):
+        specFile = os.path.join(workspaceFolder, file)
+        print(f"## SPEC-FILE: {specFile}")
+        break
+else:
+    exit(1)
+
+
+# COMMAND GENERATOR
+def cmd_setup():
+    cmd = []
+    cmd.append(pyExe)
+    cmd.append("setup.py")
+    cmd.append("build")
+    return cmd
+
+
+def cmd_pyinstaller():
+    cmd = []
+    cmd.append("--clean")
+    cmd.append(specFile)
+    return cmd
+
+
+if __name__ == "__main__":
+    print("\n## RUN SETUP BUILD")
+    subprocess.check_call(cmd_setup(), cwd=workspaceFolder)
+    print("\n## RUN PYINSTALLER BUILD")
+    PyInstaller.__main__.run(cmd_pyinstaller())