dscl.py

#
#      █████                  ████ 
#     ░░███                  ░░███ 
#   ███████   █████   ██████  ░███ 
#  ███░░███  ███░░   ███░░███ ░███ 
# ░███ ░███ ░░█████ ░███ ░░░  ░███ 
# ░███ ░███  ░░░░███░███  ███ ░███ 
# ░░████████ ██████ ░░██████  █████
#  ░░░░░░░░ ░░░░░░   ░░░░░░  ░░░░░ 
# 
#      Dead Simple Config Lang
#
#
# Example usage:
#
#   from dscl import dscl
#   config = dscl.parse(path_to_config_file)
#
# Example config-file syntax:
#
#   [plugins]
# 
#   syntax_highlighter      true                  -- enable or disable syntax highlighting plugin
#   git_integration         true                  -- enable or disable git integration
#   auto_complete           true                  -- enable or disable auto completion
#
#   [themes]
# 
#   current_theme           "monokai"
#   theme_path              "~/.config/themes"
# 
#   [logs]
# 
#   log_level               "info"                -- set the log level (debug, info, warn, error)
#   log_file                "/var/log/editor.log" -- location to store logs
#
#   @module                                       -- import module
#

# MIT License
# 
# Copyright 2024-2025 @asyncze (Michael Sjöberg)
# 
# 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.

import os


def merge_imports(path, suffix) -> list:
    with open(path, "r", encoding="utf-8") as file:
        lines = file.readlines()

    merged_lines = list()
    dir_path = os.path.dirname(path)

    for line in lines:
        if line.startswith("@"):
            module_name = line[1:].strip() # skip @
            import_path = os.path.join(dir_path, f"{ module_name }.{ suffix }")            
            try:
                with open(import_path, "r", encoding="utf-8") as import_file:
                    merged_lines.extend(import_file.readlines())
            except:
                pass
        else:
            merged_lines.append(line)

    return merged_lines


def parse(path, suffix) -> dict:
    suffix = suffix.lstrip(".")
    content = merge_imports(path, suffix)
    
    config = {}
    header = None
    config_key = None
    config_value = None

    for line in content:
        
        # skip empty lines
        if line.strip() == "":
            continue
        
        # skip line comment
        if line.strip().startswith("--"):
            continue
        
        values = line.split(" ", 1)

        # only headers are length 1
        # if len(values) == 1 or (len(values) == 2 and values[1].startswith("--")):
        #     if values[0].strip().startswith("[") and values[0].strip().endswith("]"):
        #         header = values[0].strip().replace("[", "").replace("]", "")
        #         config[str(header)] = {}

        # header
        if values[0].strip().startswith("[") and values[0].strip().endswith("]"):
            header = values[0].strip().replace("[", "").replace("]", "")
            config[str(header)] = {}
        
        # key, value row
        else:
            config_key = values[0].strip()
            config_value = values[1].strip() if len(values) > 1 else ""
            
            # strip comments
            # if "--" in config_value and not config_value.startswith("--"):
            if "--" in config_value:
                if config_value.startswith("--"):
                    config_value = ""
                else:
                    config_value = config_value.split("--", 1)[0].strip()

            # tuple: ("a", "b") or ("a",)
            if config_value.startswith("(") and config_value.endswith(")"):
                nested_values = config_value[1:-1].split(",", 1)
                nested_values = [v.strip().replace("\"", "") for v in nested_values]

                if len(nested_values) == 2:
                    config_value = (nested_values[0], nested_values[1])
                else:
                    config_value = (nested_values[0], None)

            # comma-separated list
            elif "," in config_value:
                parts = [v.strip() for v in config_value.split(",")]
                config_value = [v.replace("\"", "") for v in parts if v]

            # quoted string: "hello world"
            elif config_value.startswith("\"") and config_value.endswith("\""):
                config_value = config_value[1:-1]

            # booleans
            elif config_value in ("true", "false", "True", "False"):
                config_value = config_value == "true" or config_value == "True"

            # int
            elif config_value.isdigit():
                config_value = int(config_value)

            # fallback
            else:
                config_value = config_value.strip()

            # final sanity check
            if config_key is not None:
                config[header][str(config_key)] = config_value

    return config