#acupoftea - mail.ontime-ae.com

System	:	Linux server1.ontime-gulf.com 4.18.0-553.5.1.el8_10.x86_64 #1 SMP Wed Jun 5 09:12:13 EDT 2024 x86_64
Software	:	Apache
Server	:	162.0.230.206
Domains	:	40 Domain
Permission	:	[ drwxr-xr-x ]
	:	/ usr / libexec / dovecot /

216.73.216.105

Home

File settings-history.py

#!/usr/bin/python3.12

"""Generate history structs for renamed settings and changed default values."""

import argparse
import sys
from pathlib import Path

FILE_TEMPLATE = """\
static const struct setting_history_rename settings_history_core_renames[] = {
%s\
};
static const struct setting_history_default settings_history_core_defaults[] = {
%s\
};
"""

STRUCT_TEMPLATE = """\
  { "%s", "%s", "%s" },
"""

class SettingDefault:
    """Handle the logic behind a setting's changed default value."""

def __init__(self, key: str, old_value: str, version_text: str, version: [int]):
        """Initialize a setting's default value change object."""
        self.key = key
        self.old_value = old_value
        self.version_text = version_text
        self.version = version

def render(self) -> str:
        """Render this setting's default value update to text."""
        return STRUCT_TEMPLATE % (self.key, self.old_value, self.version_text)

class SettingRename:
    """Handle the logic behind a setting's changed name."""

def __init__(self, old_key: str, new_key: str, version_text: str, version: [int]):
        """Initialize a setting's default value change object."""
        self.old_key = old_key
        self.new_key = new_key
        self.version_text = version_text
        self.version = version

def render(self) -> str:
        """Render this setting's rename to text."""
        return STRUCT_TEMPLATE % (self.old_key, self.new_key, self.version_text)

def die(message: str):
    """Die with a message."""
    module_filename = Path(__file__).name
    print(f"{module_filename}: {message}", file=sys.stderr)
    sys.exit(1)

def parse_version(version: str) -> [int]:
    """Parse a string version into a list of integers."""
    values = version.split(".")
    parsed = []
    for value in values:
        try:
            parsed.append(int(value))
        except ValueError as e:
            raise ValueError("Invalid version {version}: {e}") from e
    return parsed

def render_version(version: [int]) -> str:
    """Produce a textual render of the a version."""
    return ".".join([str(v) for v in version])

def process_version(ce_version: str, pro_version: str, pro: bool) -> (str, [int]):
    """Parse and validate version information."""
    version_text = pro_version if pro else ce_version
    version = parse_version(version_text) if version_text not in ("", "-") else None
    return (version_text, version)

def check_version(prev_version: [int], cur_version: [int]):
    """Fail if version ordering is incorrect."""
    if prev_version is not None and cur_version > prev_version:
        cur_version_text = render_version(cur_version)
        prev_version_text = render_version(prev_version)
        raise ValueError(
            "Invalid version sort order "
            f"between {cur_version_text} and {prev_version_text}: "
            "Please fix the input file"
        )
    return cur_version

def process(input_file: str, contents: str, pro: bool) -> (str, str):
    """Produce the renames and defaults structs from the input data."""
    renames = ""
    defaults = ""
    renames_prev_version = None
    defaults_prev_version = None
    for line, data in enumerate(contents.splitlines()):
        line = line + 1
        values = data.split("\t")

if len(values) != 5:
            die(
                f"{input_file}:{line}: "
                f"Invalid contents `{data}`: "
                "Expecting 5 fields"
            )

try:
            (version_text, version) = process_version(
                ce_version=values[3], pro_version=values[4], pro=pro
            )
        except ValueError as e:
            die(f"{input_file}:{line}: {e}")

if version is None:
            continue

if values[0] == "rename":
            try:
                renames_prev_version = check_version(renames_prev_version, version)
            except ValueError as e:
                die(f"{input_file}:{line}: {e}")

rename = SettingRename(
                old_key=values[1],
                new_key=values[2],
                version_text=version_text,
                version=version,
            )
            renames += rename.render()
        elif values[0] == "default":
            try:
                defaults_prev_version = check_version(defaults_prev_version, version)
            except ValueError as e:
                die(f"{input_file}:{line}: {e}")

default = SettingDefault(
                key=values[1],
                old_value=values[2],
                version_text=version_text,
                version=version,
            )
            defaults += default.render()
        else:
            die(f"{input_file}:{line}: Unrecognized marker in `{data}`")
    return (renames, defaults)

def main():
    """Entry point."""
    parser = argparse.ArgumentParser(
        prog="settings-history.py",
        description="Generate header file for settings migration data",
    )
    parser.add_argument(
        "input-file",
        type=str,
        help="Input data file e.g. settings-history-core.txt",
    )
    parser.add_argument(
        "output-file",
        type=str,
        help="Output header file e.g. settings-history-core.h",
    )
    parser.add_argument(
        "--pro",
        type=int,
        choices=[0, 1],
        help="Whether to generate settings migration data for Pro",
    )
    parser.add_argument(
        "--plugin",
        type=str,
        default="core",
        help="Used to generate settings for the named plugin",
    )
    args = parser.parse_args()

input_file = getattr(args, "input-file")
    output_file = getattr(args, "output-file")
    plugin_name = args.plugin

with open(input_file, mode="r", encoding="utf-8") as f_in:
        contents = f_in.read()
        (renames, defaults) = process(input_file, contents, pro=bool(args.pro))

with open(output_file, mode="w", encoding="utf-8") as f_out:
            template = FILE_TEMPLATE.replace("core", plugin_name)
            f_out.write(template % (renames, defaults))

if __name__ == "__main__":
    main()

Name	Type	Size	Permission	Last Modified	Actions
.	DIR	-	drwxr-xr-x	2025-12-09 10:59:27
..	DIR	-	drwxr-xr-x	2025-12-09 10:59:01
anvil	application/x-sharedlib	78.77 KB	-rwxr-xr-x	2025-11-04 08:58:52
auth	application/x-sharedlib	538.88 KB	-rwxr-xr-x	2025-11-04 08:58:52
config	application/x-sharedlib	365.79 KB	-rwxr-xr-x	2025-11-04 08:58:52
decode2text.sh	text/x-shellscript	2.77 KB	-rwxr-xr-x	2025-11-04 08:54:27
deliver	application/x-sharedlib	35.92 KB	-rwxr-xr-x	2025-11-04 08:58:52
dict	application/x-sharedlib	157.98 KB	-rwxr-xr-x	2025-11-04 08:58:52
dict-expire	application/x-executable	121.76 KB	-rwxr-xr-x	2025-11-04 08:58:52
dns-client	application/x-sharedlib	23.02 KB	-rwxr-xr-x	2025-11-04 08:58:52
doveadm-server	application/x-sharedlib	958.91 KB	-rwxr-xr-x	2025-11-04 08:58:52
dovecot-lda	application/x-sharedlib	35.92 KB	-rwxr-xr-x	2025-11-04 08:58:52
gdbhelper	application/x-sharedlib	15.37 KB	-rwxr-xr-x	2025-11-04 08:58:52
health-check.sh	text/x-shellscript	1 KB	-rwxr-xr-x	2025-11-04 08:54:22
imap	application/x-sharedlib	492.15 KB	-rwxr-xr-x	2025-11-04 08:58:52
imap-hibernate	application/x-sharedlib	64.7 KB	-rwxr-xr-x	2025-11-04 08:58:52
imap-login	application/x-sharedlib	126.96 KB	-rwxr-xr-x	2025-11-04 08:58:52
imap-urlauth	application/x-sharedlib	41.97 KB	-rwxr-xr-x	2025-11-04 08:58:52
imap-urlauth-login	application/x-sharedlib	23.96 KB	-rwxr-xr-x	2025-11-04 08:58:52
imap-urlauth-worker	application/x-sharedlib	90 KB	-rwxr-xr-x	2025-11-04 08:58:52
indexer	application/x-sharedlib	50.1 KB	-rwxr-xr-x	2025-11-04 08:58:52
indexer-worker	application/x-sharedlib	38.8 KB	-rwxr-xr-x	2025-11-04 08:58:52
lmtp	application/x-sharedlib	102.76 KB	-rwxr-xr-x	2025-11-04 08:58:52
log	application/x-sharedlib	40.21 KB	-rwxr-xr-x	2025-11-04 08:58:52
managesieve	application/x-sharedlib	79.91 KB	-rwxr-xr-x	2025-11-04 08:58:52
managesieve-login	application/x-sharedlib	50.46 KB	-rwxr-xr-x	2025-11-04 08:58:52
mkcert.sh	text/x-shellscript	866 B	-rwxr-xr-x	2025-11-04 08:50:41
pop3	application/x-sharedlib	87.51 KB	-rwxr-xr-x	2025-11-04 08:58:52
pop3-login	application/x-sharedlib	50.54 KB	-rwxr-xr-x	2025-11-04 08:58:52
quota-status	application/x-sharedlib	31.95 KB	-rwxr-xr-x	2025-11-04 08:58:52
rawlog	application/x-sharedlib	27.47 KB	-rwxr-xr-x	2025-11-04 08:58:52
script	application/x-sharedlib	27.27 KB	-rwxr-xr-x	2025-11-04 08:58:52
script-login	application/x-sharedlib	21.52 KB	-rwxr-xr-x	2025-11-04 08:58:52
settings-history.py	text/x-python	6.01 KB	-rwxr-xr-x	2025-11-04 08:54:09
stats	application/x-sharedlib	133.96 KB	-rwxr-xr-x	2025-11-04 08:58:52
submission	application/x-executable	170.54 KB	-rwxr-xr-x	2025-11-04 08:58:52
submission-login	application/x-executable	54.65 KB	-rwxr-xr-x	2025-11-04 08:58:52
xml2text	application/x-sharedlib	17.23 KB	-rwxr-xr-x	2025-11-04 08:58:52

~ ACUPOFTEA - mail.ontime-ae.com