scons-xo-exts-lib 1.0.0__py3-none-any.whl

scons_xo_exts_lib/Actions/Uv.py

@@ -0,0 +1,48 @@
+#!/usr/bin/env python
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+import os
+
+from SCons.Script import Environment
+
+from ..GenericExtensions import execute_command
+
+
+def uv_venv_action(target, source, env):
+    if os.path.exists(".venv"):
+        return
+    else:
+        env.Execute("${UV_EXE} venv")
+
+
+def uv_sync_action(target, source, env):
+    execute_command(env, "${UV_EXE} sync --all-packages")
+
+
+def uv_pip(env, cmd):
+    execute_command(env, "${UV_EXE} pip " + cmd)
+
+
+def uv_pip_freeze_action(target, source, env):
+    output_file = str(target[0])
+
+    uv_pip(env, f"freeze --exclude-editable > {output_file}")
+
+
+def uv_build_pkg_action(target, source, env):
+    if source:
+        flags = " ".join(str(s) for s in source)
+    else:
+        flags = "--all-packages"
+
+    execute_command(env, "${UV_EXE} build " + flags)
+
+
+def uv_pytest_action(target, source, env):
+    pytest_exec_flags = env.get("PYTEST_FLAGS", "--capture=no")
+
+    execute_command(env, f"${{UV_EXE}} run -- pytest {pytest_exec_flags}")

scons_xo_exts_lib/Actions/__init__.py

@@ -0,0 +1 @@
+#!/usr/bin/env python

scons_xo_exts_lib/BuildSupport/Make.py

@@ -0,0 +1,18 @@
+#!/usr/bin/env python
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+from typing import List
+
+from SCons.Script import Environment
+
+from .GenericExtensions import execute_command
+
+
+def execute_make(env: Environment, args: List[str]) -> None:
+    make_cmd = "make" + " ".join(args)
+
+    execute_command(env, make_cmd)

scons_xo_exts_lib/BuildSupport/NodeMangling.py

@@ -0,0 +1,33 @@
+#!/usr/bin/env python
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+import os
+import re
+
+
+def get_first_node(nodes):
+    if isinstance(nodes, list):
+        if len(nodes) != 1:
+            raise ValueError("Given nodes is not a one-element list")
+
+        return nodes[0]
+
+    return nodes
+
+
+def get_first_directory(nodes):
+    node = get_first_node(nodes=nodes)
+
+    return os.path.dirname(node.abspath)
+
+
+def regex_find_node(regex, nodes):
+    for node in nodes:
+        if re.match(pattern=regex, string=str(node.abspath)):
+            return node
+
+    raise RuntimeError("No file was matched using the specified regex")

scons_xo_exts_lib/BuildSupport/__init__.py

@@ -0,0 +1 @@
+#!/usr/bin/env python

scons_xo_exts_lib/Builders/__init__.py

@@ -0,0 +1 @@
+#!/usr/bin/env python

scons_xo_exts_lib/Builders/bazel.py

@@ -0,0 +1,37 @@
+#!/usr/bin/env python
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+import subprocess
+
+from SCons.Script import Builder
+
+
+def bazel_action(target, source, env):
+    bazel_pkgs = " ".join(str(s) for s in source)
+
+    bazel_exe = env.get("BAZEL_EXE", "bazelisk")
+    bazel_flags = env.get("BAZEL_FLAGS", "")
+
+    cmd = f"{bazel_exe} build {bazel_flags} {bazel_pkgs}"
+    result = subprocess.run(
+        args=cmd,
+        capture_output=False,
+        check=False,
+        shell=True,
+    )
+
+    return result.returncode
+
+
+def generate(env):
+    bazel_binary_builder = Builder(action=bazel_action)
+
+    env.Append(BUILDERS={"BazelBinary": bazel_binary_builder})
+
+
+def exists(env):
+    return env.Detect("bazel")

scons_xo_exts_lib/Builders/cmake.py

@@ -0,0 +1,37 @@
+#!/usr/bin/env python
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+import subprocess
+
+from SCons.Script import Builder
+
+
+def cmake_action(target, source, env):
+    cmake_targets = " ".join(str(t) for t in target)
+
+    cmake_exe = env.get("CMAKE_EXE", "cmake")
+    cmake_flags = env.get("CMAKE_FLAGS", "")
+
+    cmd = f"{cmake_exe} {cmake_flags} {cmake_targets}"
+    result = subprocess.run(
+        args=cmd,
+        capture_output=False,
+        check=False,
+        shell=True,
+    )
+
+    return result.returncode
+
+
+def generate(env):
+    cmake_binary_builder = Builder(action=cmake_action)
+
+    env.Append(BUILDERS={"CmakeBinary": cmake_binary_builder})
+
+
+def exists(env):
+    return env.Detect("cmake")

scons_xo_exts_lib/Builders/dotnet.py

@@ -0,0 +1,177 @@
+#!/usr/bin/env python
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+import os
+import subprocess
+
+from typing import List
+
+from SCons.Script import Builder
+from SCons.Script import Environment
+
+from scons_xo_exts_lib.BuildSupport import NodeMangling
+
+
+def _dotnet_get_dotnet_exe(env: Environment) -> str:
+    dotnet_exe = env.get("DOTNET_EXE")
+
+    if dotnet_exe:
+        return dotnet_exe
+
+    try:
+        return os.path.join(env["DOTNET_ROOT"], "dotnet")
+    except KeyError:
+        return "dotnet"
+
+
+def _dotnet_get_project(source) -> str:
+    regex = ".*\\.(cs|fs|vb|)proj$"
+
+    try:
+        node = NodeMangling.regex_find_node(regex=regex, nodes=source)
+
+        return str(node.abspath)
+    except Exception as exception:
+        raise RuntimeError("No dotnet project file found", exception)
+
+
+def _dotnet_command(env: Environment, source, args: List[str]) -> None:
+    project_file = _dotnet_get_project(source=source)
+    source_directory = os.path.dirname(project_file)
+
+    extra_variables = {
+        "DOTNET_CLI_TELEMETRY_OPTOUT": "1",
+        "DOTNET_NOLOGO": "1",
+        "DOTNET_SKIP_FIRST_TIME_EXPERIENCE": "1",
+        "MSBUILDTERMINALLOGGER": "off",
+    }
+
+    subprocess_env = env.Clone()["ENV"]
+    subprocess_env.update(extra_variables)
+
+    dotnet_exe = _dotnet_get_dotnet_exe(env=env)
+    subprocess_args = [dotnet_exe] + args
+
+    result = subprocess.run(
+        args=subprocess_args,
+        capture_output=False,
+        check=False,
+        cwd=source_directory,
+        env=subprocess_env,
+    )
+
+    if result.returncode == 0:
+        return
+
+    raise RuntimeError("Dotnet command failed")
+
+
+def _dotnet_get_configuration(env: Environment) -> str:
+    try:
+        return env["DOTNET_CONFIGURATION"]
+    except KeyError:
+        return "Release"
+
+
+def _dotnet_restore(env: Environment, source) -> None:
+    _dotnet_command(
+        env=env,
+        source=source,
+        args=[
+            "restore",
+            "--force-evaluate",
+            "--runtime=linux-x64",
+        ],
+    )
+
+
+def _dotnet_build(env: Environment, source) -> None:
+    _dotnet_command(
+        env=env,
+        source=source,
+        args=[
+            "build",
+            "--no-restore",
+            "--runtime=linux-x64",
+            "--configuration=" + _dotnet_get_configuration(env=env),
+        ],
+    )
+
+
+def _dotnet_compile(*args, **kwargs) -> None:
+    _dotnet_restore(*args, **kwargs)
+    _dotnet_build(*args, **kwargs)
+
+
+def _dotnet_pack(env: Environment, source, target) -> None:
+    target_directory = NodeMangling.get_first_directory(nodes=target)
+
+    _dotnet_command(
+        env=env,
+        source=source,
+        args=[
+            "pack",
+            "--no-restore",
+            "--runtime=linux-x64",
+            "--configuration=" + _dotnet_get_configuration(env=env),
+            "--output=" + target_directory,
+        ],
+    )
+
+
+def _dotnet_compile_binary(env: Environment, source, target) -> None:
+    target_directory = NodeMangling.get_first_directory(nodes=target)
+
+    _dotnet_command(
+        env=env,
+        source=source,
+        args=[
+            "publish",
+            "--no-restore",
+            "--self-contained",
+            "-p:PublishSingleFile=true",
+            "--runtime=linux-x64",
+            "--configuration=" + _dotnet_get_configuration(env=env),
+            "--output=" + target_directory,
+        ],
+    )
+
+
+def dotnet_package_build_action(target, source, env: Environment) -> int:
+    try:
+        _dotnet_compile(env=env, source=source)
+        _dotnet_pack(env=env, source=source, target=target)
+    except RuntimeError:
+        return 1
+
+    return 0
+
+
+def dotnet_binary_build_action(target, source, env) -> int:
+    try:
+        _dotnet_compile(env=env, source=source)
+        _dotnet_compile_binary(env=env, source=source, target=target)
+    except RuntimeError:
+        return 1
+
+    return 0
+
+
+def generate(env: Environment) -> None:
+    dotnet_binary_builder = Builder(action=dotnet_binary_build_action)
+    dotnet_package_builder = Builder(action=dotnet_package_build_action)
+
+    env.Append(
+        BUILDERS={
+            "DotnetBinary": dotnet_binary_builder,
+            "DotnetPackage": dotnet_package_builder,
+        }
+    )
+
+
+def exists(env: Environment):
+    return env.Detect("dotnet")

scons_xo_exts_lib/Builders/dune.py

@@ -0,0 +1,51 @@
+#!/usr/bin/env python
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+import os
+import subprocess
+
+from SCons.Script import Builder
+from SCons.Script import Environment
+
+
+def _get_dune_project(sources: list):
+    for source in sources:
+        source_str = str(source)
+
+        if "dune-project" in source_str:
+            return source_str
+
+    raise RuntimeError("No dune-project in specified sources")
+
+
+def dune_build_action(target, source, env) -> int:
+    dune_project = _get_dune_project(sources=source)
+    dune_base_dir = os.path.dirname(dune_project)
+
+    dune_exe = env.get("DUNE_EXE", "dune")
+    dune_flags = env.get("DUNE_FLAGS", "--display=short")
+
+    cmd = f"{dune_exe} build {dune_flags} @install"
+    result = subprocess.run(
+        args=cmd,
+        capture_output=False,
+        check=False,
+        cwd=dune_base_dir,
+        shell=True,
+    )
+
+    return result.returncode
+
+
+def generate(env: Environment) -> None:
+    dune_binary_builder = Builder(action=dune_build_action)
+
+    env.Append(BUILDERS={"DuneBinary": dune_binary_builder})
+
+
+def exists(env: Environment):
+    return env.Detect("dune")

scons_xo_exts_lib/Builders/elisp.py

@@ -0,0 +1,111 @@
+#!/usr/bin/env python
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+import os
+import subprocess
+
+from SCons.Script import Builder
+from SCons.Script import Environment
+
+from scons_xo_exts_lib.BuildSupport import NodeMangling
+
+
+def _elisp_construct_load_path(sources: list) -> str:
+    load_path_flags: set[str] = set()
+
+    for source in sources:
+        dir_name = os.path.dirname(str(source))
+        load_flag = f"-L {dir_name}"
+
+        load_path_flags.add(load_flag)
+
+    return " ".join(load_path_flags)
+
+
+def _elisp_get_emacs_exe(env: Environment) -> str:
+    emacs_exe = env.get("EMACS_EXE")
+    emacs_version = env.get("EMACS_VERSION")
+
+    if not emacs_exe:
+        if emacs_version:
+            return f"emacs-{emacs_version}"
+
+        return "emacs"
+
+    return emacs_exe
+
+
+def _elisp_get_base_command(env: Environment) -> str:
+    exe: str = _elisp_get_emacs_exe(env)
+
+    exec_flags = env.get("EMACS_EXEC_FLAGS", "-batch -q --no-site-file")
+    extra_flags = env.get("EMACS_EXTRA_FLAGS", "")
+
+    return f"{exe} {exec_flags} {extra_flags}"
+
+
+def elisp_autoloads_action(target, source, env) -> int:
+    directory = NodeMangling.get_first_directory(source[0])
+    out = NodeMangling.get_first_node(target).abspath
+
+    base_args = _elisp_get_base_command(env)
+
+    func = f'loaddefs-generate \\"{directory}\\" \\"{out}\\"'
+    flags = f'--eval "({func})"'
+
+    cmd = f"{base_args} {flags}"
+    result = subprocess.run(
+        args=cmd,
+        capture_output=False,
+        check=False,
+        cwd=directory,
+        shell=True,
+    )
+
+    return result.returncode
+
+
+def elisp_binary_action(target, source, env) -> int:
+    srcs: str = " ".join(str(s) for s in source)
+    load_path: str = _elisp_construct_load_path(sources=source)
+
+    base_args = _elisp_get_base_command(env)
+    comp_flags = env.get("EMACS_COMP_FLAGS", "-L .")
+
+    func = "batch-byte-compile"
+    flags = f"{comp_flags} {load_path} -f {func}"
+
+    cmd = f"{base_args} {flags} {srcs}"
+    result = subprocess.run(
+        args=cmd,
+        capture_output=False,
+        check=False,
+        shell=True,
+    )
+
+    return result.returncode
+
+
+def generate(env: Environment) -> None:
+    autoloads_builder = Builder(action=elisp_autoloads_action)
+
+    binary_builder = Builder(
+        action=elisp_binary_action,
+        src_suffix=".el",
+        suffix=".elc",
+    )
+
+    env.Append(
+        BUILDERS={
+            "ElispAutoloadsFile": autoloads_builder,
+            "ElispBinary": binary_builder,
+        }
+    )
+
+
+def exists(env: Environment):
+    return env.Detect(progs="elisp")

scons_xo_exts_lib/Builders/make.py

@@ -0,0 +1,37 @@
+#!/usr/bin/env python
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+import subprocess
+
+from SCons.Script import Builder
+
+
+def make_action(target, source, env):
+    make_targets = " ".join(str(t) for t in target)
+
+    make_exe = env.get("MAKE_EXE", "make")
+    make_flags = env.get("MAKE_FLAGS", "")
+
+    cmd = f"{make_exe} {make_flags} {make_targets}"
+    result = subprocess.run(
+        args=cmd,
+        capture_output=False,
+        check=False,
+        shell=True,
+    )
+
+    return result.returncode
+
+
+def generate(env):
+    make_binary_builder = Builder(action=make_action)
+
+    env.Append(BUILDERS={"MakeBinary": make_binary_builder})
+
+
+def exists(env):
+    return env.Detect("make")

scons_xo_exts_lib/Builders/ninja.py

@@ -0,0 +1,37 @@
+#!/usr/bin/env python
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+import subprocess
+
+from SCons.Script import Builder
+
+
+def ninja_action(target, source, env):
+    ninja_targets = " ".join(str(t) for t in target)
+
+    ninja_exe = env.get("NINJA_EXE", "ninja")
+    ninja_flags = env.get("NINJA_FLAGS", "")
+
+    cmd = f"{ninja_exe} {ninja_flags} {ninja_targets}"
+    result = subprocess.run(
+        args=cmd,
+        capture_output=False,
+        check=False,
+        shell=True,
+    )
+
+    return result.returncode
+
+
+def generate(env):
+    ninja_binary_builder = Builder(action=ninja_action)
+
+    env.Append(BUILDERS={"NinjaBinary": ninja_binary_builder})
+
+
+def exists(env):
+    return env.Detect("ninja")

scons_xo_exts_lib/Builders/orgmode.py

@@ -0,0 +1,50 @@
+#!/usr/bin/env python
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+import os
+import subprocess
+
+from SCons.Script import Builder
+
+from scons_xo_exts_lib.BuildSupport import NodeMangling
+
+
+def orgmode_action(target, source, env):
+    emacs_exe = env.get("EMACS_EXE", "emacs")
+    emacs_exec_flags = env.get("EMACS_EXEC_FLAGS", "-batch -q --no-site-file")
+
+    cwd = NodeMangling.get_first_directory(source)
+
+    inp = NodeMangling.get_first_node(source).abspath
+    out = NodeMangling.get_first_node(target).abspath
+
+    ext = os.path.splitext(out)[1][1:]
+    fun = f'(org-export-to-file \'{ext} \\"{out}\\")'
+
+    load_flags = "-l org -l ox-latex"
+    flags = f'{emacs_exec_flags} {load_flags} {inp} --eval "{fun}"'
+
+    cmd = f"{emacs_exe} {flags}"
+    result = subprocess.run(
+        args=cmd,
+        capture_output=False,
+        check=False,
+        shell=True,
+        cwd=cwd,
+    )
+
+    return result.returncode
+
+
+def generate(env):
+    orgmode_file_builder = Builder(action=orgmode_action)
+
+    env.Append(BUILDERS={"OrgmodeFile": orgmode_file_builder})
+
+
+def exists(env):
+    return env.Detect("orgmode")

scons_xo_exts_lib/Builders/pandoc.py

@@ -0,0 +1,40 @@
+#!/usr/bin/env python
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+import subprocess
+
+from SCons.Script import Builder
+
+from scons_xo_exts_lib.BuildSupport import NodeMangling
+
+
+def pandoc_action(target, source, env):
+    pandoc_exe = env.get("PANDOC_EXE", "pandoc")
+    pandoc_flags = env.get("PANDOC_FLAGS", "")
+
+    inp = NodeMangling.get_first_node(source).abspath
+    out = NodeMangling.get_first_node(target).abspath
+
+    cmd = f"{pandoc_exe} {pandoc_flags} -o {inp} {out}"
+    result = subprocess.run(
+        args=cmd,
+        capture_output=False,
+        check=False,
+        shell=True,
+    )
+
+    return result.returncode
+
+
+def generate(env):
+    pandoc_binary_builder = Builder(action=pandoc_action)
+
+    env.Append(BUILDERS={"PandocFile": pandoc_binary_builder})
+
+
+def exists(env):
+    return env.Detect("pandoc")

scons_xo_exts_lib/Builders/racket.py

@@ -0,0 +1,122 @@
+#!/usr/bin/env python
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+import os
+import subprocess
+
+from SCons.Script import Builder
+from SCons.Script import Environment
+
+from scons_xo_exts_lib.BuildSupport import NodeMangling
+
+
+def _racket_get_plt_user_home(env: Environment) -> str:
+    try:
+        return env["PLTUSERHOME"]
+    except Exception:
+        raise RuntimeError("PLTUSERHOME is unset, please set it in SCons")
+
+
+def _racket_get_raco_exe(env: Environment) -> str:
+    racket_exe: str = env.get(key="RACKET_EXE", default="racket")
+    raco_exe: str = f"{racket_exe} -l raco --"
+
+    return raco_exe
+
+
+def _racket_raco(env: Environment, source_node, args: str) -> None:
+    plt_user_home: str = _racket_get_plt_user_home(env=env)
+    raco: str = _racket_get_raco_exe(env=env)
+
+    extra_variables = {
+        "PLTUSERHOME": plt_user_home,
+    }
+
+    subprocess_env = env.Clone()["ENV"]
+    subprocess_env.update(extra_variables)
+
+    directory: str = NodeMangling.get_first_directory(source_node)
+    cmd = f"{raco} {args}"
+
+    result = subprocess.run(
+        args=cmd,
+        capture_output=False,
+        check=False,
+        cwd=directory,
+        shell=True,
+    )
+
+    if result.returncode == 0:
+        return
+
+    raise RuntimeError(f"Raco command failed, ran: {cmd}")
+
+
+def _racket_install_package(env: Environment, source: list) -> None:
+    for source_node in source:
+        _racket_raco(
+            env=env,
+            source_node=source_node,
+            args="pkg install --auto --skip-installed --no-docs",
+        )
+
+
+def _racket_setup_package(env: Environment, source: list) -> None:
+    for source_node in source:
+        _racket_raco(
+            env=env,
+            source_node=source_node,
+            args="setup --tidy --avoid-main --no-docs",
+        )
+
+
+def _racket_create_exe(env: Environment, target, source) -> None:
+    for target_node, source_node in zip(target, source):
+        out: str = target_node.abspath
+        inp: str = source_node.abspath
+
+        _racket_raco(
+            env=env,
+            source_node=source_node,
+            args=f"exe -v --orig-exe -o {out} {inp}",
+        )
+
+
+def racket_library_action(target, source, env) -> int:
+    try:
+        _racket_install_package(env=env, source=source)
+    except RuntimeError:
+        return 1
+
+    return 0
+
+
+def racket_binary_action(target, source, env) -> int:
+    try:
+        _racket_install_package(env=env, source=source)
+        _racket_setup_package(env=env, source=source)
+        _racket_create_exe(env=env, target=target, source=source)
+    except RuntimeError:
+        return 1
+
+    return 0
+
+
+def generate(env: Environment) -> None:
+    racket_binary_builder = Builder(action=racket_binary_action)
+    racket_library_builder = Builder(action=racket_library_action)
+
+    env.Append(
+        BUILDERS={
+            "RacketBinary": racket_binary_builder,
+            "RacketLibrary": racket_library_builder,
+        }
+    )
+
+
+def exists(env: Environment):
+    return env.Detect(progs="racket")

scons_xo_exts_lib/Find.py

@@ -0,0 +1,32 @@
+#!/usr/bin/env python
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+import os
+
+from typing import List
+
+
+def find_files(path: str) -> List[str]:
+    if not os.path.exists(path):
+        return []
+
+    abs_path = os.path.abspath(path)
+    files = os.listdir(abs_path)
+
+    return list(map(lambda f: os.path.join(abs_path, f), files))
+
+
+def find_last_directory(path: str) -> str:
+    files = find_files(path)
+
+    dirs = (d for d in files if os.path.isdir(d))
+    dirs = sorted(dirs, reverse=True)
+
+    if not dirs:
+        raise RuntimeError("No files found and so also no latest directory")
+
+    return dirs[0]

scons_xo_exts_lib/GenericExtensions.py

@@ -0,0 +1,38 @@
+#!/usr/bin/env python
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+import os
+
+from shutil import rmtree
+
+from SCons.Script import Environment
+
+
+def execute_command(env: Environment, command: str) -> None:
+    result = env.Execute(command)
+
+    if result:
+        raise RuntimeError(f"Command failed, given: {command}")
+
+
+def remove(path: str, *args, **kwargs):
+    pwd = os.getcwd()
+
+    rmtree(os.path.join(pwd, path), *args, **kwargs)
+
+
+def find_remove(env: Environment, file_name: str):
+    find_exe = env.get("FIND_EXE", "find")
+
+    rm_exe = env.get("RM_EXE", "rm")
+    rm_flags = env.get("RM_FLAGS", "-f -r")
+    rm_cmd = f"{rm_exe} {rm_flags}"
+
+    execute_command(
+        env,
+        f"{find_exe} . -name '{file_name}' -exec {rm_cmd} {{}} +",
+    )

scons_xo_exts_lib/Read.py

@@ -0,0 +1,53 @@
+#!/usr/bin/env python
+
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+
+import os
+
+from typing import List
+
+
+def read_lines(file_path: str) -> List[str]:
+    """
+    Return all file lines.
+    """
+
+    lines = []
+
+    with open(file_path) as file:
+        lines = file.readlines()
+
+    return lines
+
+
+def read_line(file_path: str) -> str:
+    """
+    Return 1st file line.
+    """
+
+    lines = read_lines(file_path)
+
+    return lines[0]
+
+
+def read_version(base_path: str) -> str:
+    """
+    Return content of a "VERSION" file found at the "base_path".
+    """
+
+    version_file = os.path.join(base_path, "VERSION")
+
+    return read_line(version_file)
+
+
+def read_python_version(base_path: str) -> str:
+    """
+    Return content of a ".python-version" file found at the "base_path".
+    """
+
+    version_file = os.path.join(base_path, ".python-version")
+
+    return read_line(version_file)

scons_xo_exts_lib/__init__.py

@@ -0,0 +1,8 @@
+#!/usr/bin/env python
+
+"""
+Scons extensions library by XGQT.
+"""
+
+__version__ = "1.0.0"
+__description__ = "Scons extensions library by XGQT"

scons_xo_exts_lib-1.0.0.dist-info/METADATA

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: scons-xo-exts-lib
+Version: 1.0.0
+Summary: Scons extensions library by XGQT.
+Requires-Python: >=3.12
+Requires-Dist: scons>=4.8.1

scons_xo_exts_lib-1.0.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+scons_xo_exts_lib/Find.py,sha256=J5VcXfBjg9kW_o4v8S3ugnv-JKAV6wzD6xrIw1jMerA,767
+scons_xo_exts_lib/GenericExtensions.py,sha256=c56PZZuDHdche-x1ERC6gIcIENAP8ZD20EQkxvTXAz4,916
+scons_xo_exts_lib/Read.py,sha256=sXnCuW1-gMX-MeIpCvx45N8Sqnr8Fb4UsJfGdB8reeA,1042
+scons_xo_exts_lib/__init__.py,sha256=Eza5CXe9vm2-z7K6-duPg2qiceQBWKD0uy6Dend33lY,141
+scons_xo_exts_lib/Actions/Uv.py,sha256=kdocY_tAvzA4awBs4f6djy4Hku4alXh_L7Vy7llNprY,1172
+scons_xo_exts_lib/Actions/__init__.py,sha256=-JIt3g1eBf4bVQNNQd4JBeQNA7o0LK0W9tYKKX_r5s8,22
+scons_xo_exts_lib/BuildSupport/Make.py,sha256=JG7Wi_G9vQeU9UyKTnN8D8akzmrhFYhsQH2zDmO1-u8,472
+scons_xo_exts_lib/BuildSupport/NodeMangling.py,sha256=ynoh1GqQo1BHrNmlzugKsXHjlJkh9QuByGQAl8-UCdY,780
+scons_xo_exts_lib/BuildSupport/__init__.py,sha256=-JIt3g1eBf4bVQNNQd4JBeQNA7o0LK0W9tYKKX_r5s8,22
+scons_xo_exts_lib/Builders/__init__.py,sha256=-JIt3g1eBf4bVQNNQd4JBeQNA7o0LK0W9tYKKX_r5s8,22
+scons_xo_exts_lib/Builders/bazel.py,sha256=eFJZysWV4v63RapZI2Xg0S1FgDJfLbpYtGElx6qENj8,866
+scons_xo_exts_lib/Builders/cmake.py,sha256=FoWPK-GUv56aswFdrE6JWqtTIKE2oymPKi_C2ZmNHGo,863
+scons_xo_exts_lib/Builders/dotnet.py,sha256=AD-OGbQuvCd1LuJSDtfdCE1OOKB8NQ4_hujaEvfZMbk,4426
+scons_xo_exts_lib/Builders/dune.py,sha256=tO_gMTnEDanr4C9MDWG2CcggByWaaXCjYHyhDiH1pFY,1277
+scons_xo_exts_lib/Builders/elisp.py,sha256=T7j4z6mvCXz1gd9oPoOLqOiVE3YLoY3q6y5wwhZAw8U,2723
+scons_xo_exts_lib/Builders/make.py,sha256=fa_cZjR-lTVqFGLjm5EyDBwVxcaaZCL-2h_QKb6RCzU,848
+scons_xo_exts_lib/Builders/ninja.py,sha256=FEOMGfTbMWOE2cSlOu9FPXJjYw-uOCY2tfSM-5XFao4,863
+scons_xo_exts_lib/Builders/orgmode.py,sha256=iyu4O0xWWVZqx_LNhBb5i1Dt30iuE8VpwmmDNQSMJ4U,1273
+scons_xo_exts_lib/Builders/pandoc.py,sha256=CAPyV9K1gdL_XWFodXpw8bEiFhu2_CvV8qNHWdKbifA,985
+scons_xo_exts_lib/Builders/racket.py,sha256=yDj_YYtVk15SqrXrjLb8efbYjR8j6VGpLU2pYAVID5I,3171
+scons_xo_exts_lib-1.0.0.dist-info/WHEEL,sha256=_2ozNFCLWc93bK4WKHCO-eDUENDlo-dgc9cU3qokYO4,82
+scons_xo_exts_lib-1.0.0.dist-info/METADATA,sha256=DbEXjnGDrH6ta2z9kKJJF6Dy4_wARbg55-QV5AXbxL4,156
+scons_xo_exts_lib-1.0.0.dist-info/RECORD,,

scons_xo_exts_lib-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: flit 3.11.0
+Root-Is-Purelib: true
+Tag: py3-none-any