Cleanup: declare __all__ for Python scripts

Declare all to make public public API's explicit and
help detect unused code.

build_files/build_environment/darwin/set_rpath.py

@@ -5,6 +5,10 @@
 
 # macOS utility to remove all `rpaths` and add a new one.
 
+__all__ = (
+    "main",
+)
+
 import os
 import pathlib
 import re

build_files/build_environment/install_linux_packages.py

@@ -3,6 +3,10 @@
 #
 # SPDX-License-Identifier: GPL-2.0-or-later
 
+__all__ = (
+    "main",
+)
+
 import logging
 import os
 import re

build_files/cmake/cmake_print_build_options.py

@@ -2,18 +2,20 @@
 #
 # SPDX-License-Identifier: Apache-2.0
 
-# Simple utility that prints all WITH_* options in a CMakeLists.txt
+# Simple utility that prints all `WITH_*` options in a `CMakeLists.txt`.
-# Called by 'make help_features'
+# Called by `make help_features`.
+
+__all__ = (
+    "main",
+)
 
 import re
 import sys
 
 from typing import (
-    Union,
+    Optional,
 )
 
-cmakelists_file = sys.argv[-1]
-
 
 def count_backslashes_before_pos(file_data: str, pos: int) -> int:
     slash_count = 0
@@ -26,7 +28,7 @@ def count_backslashes_before_pos(file_data: str, pos: int) -> int:
     return slash_count
 
 
-def extract_cmake_string_at_pos(file_data: str, pos_beg: int) -> Union[str, None]:
+def extract_cmake_string_at_pos(file_data: str, pos_beg: int) -> Optional[str]:
     assert file_data[pos_beg - 1] == '"'
 
     pos = pos_beg
@@ -73,10 +75,13 @@ def extract_cmake_string_at_pos(file_data: str, pos_beg: int) -> Union[str, None
     return text
 
 
-def main() -> None:
+def main() -> int:
+    cmakelists_file = sys.argv[-1]
+
     options = []
     with open(cmakelists_file, 'r', encoding="utf-8") as fh:
         file_data = fh.read()
+
     for m in re.finditer(r"^\s*option\s*\(\s*(WITH_[a-zA-Z0-9_]+)\s+(\")", file_data, re.MULTILINE):
         option_name = m.group(1)
         option_descr = extract_cmake_string_at_pos(file_data, m.span(2)[1])
@@ -86,6 +91,7 @@ def main() -> None:
         options.append("{:s}: {:s}".format(option_name, option_descr))
 
     print('\n'.join(options))
+    return 0
 
 
 if __name__ == "__main__":

build_files/package_spec/build_archive.py

@@ -3,6 +3,10 @@
 #
 # SPDX-License-Identifier: GPL-2.0-or-later
 
+__all__ = (
+    "main",
+)
+
 import os
 import shutil
 import subprocess

build_files/utils/make_bpy_wheel.py

@@ -27,6 +27,9 @@ NOTE:
 Some type annotations are quoted to avoid errors in Python 3.9.
 These can be unquoted eventually.
 """
+__all__ = (
+    "main",
+)
 
 import argparse
 import make_utils

build_files/utils/make_test.py

@@ -7,6 +7,10 @@
 "make test" for all platforms, running automated tests.
 """
 
+__all__ = (
+    "main",
+)
+
 import argparse
 import os
 import sys

doc/python_api/sphinx_changelog_gen.py

@@ -53,6 +53,9 @@ API dump format:
 ]
 
 """
+__all__ = (
+    "main",
+)
 
 import json
 import os

release/datafiles/ctodata.py

@@ -3,50 +3,60 @@
 #
 # SPDX-License-Identifier: GPL-2.0-or-later
 
+__all__ = (
+    "__all__",
+)
+
 import sys
 
-argv = sys.argv[:]
 
-strip_byte = False
+def main():
-if "--strip-byte" in argv:
+    argv = sys.argv[:]
+
+    strip_byte = False
+    if "--strip-byte" in argv:
         argv.remove("--strip-byte")
         strip_byte = True
 
-if len(argv) < 2:
+    if len(argv) < 2:
         sys.stdout.write("Usage: ctodata <c_file> [--strip-byte]\n")
         sys.exit(1)
 
-filename = argv[1]
+    filename = argv[1]
 
-try:
+    try:
         fpin = open(filename, "r")
-except:
+    except:
         sys.stdout.write("Unable to open input {:s}\n".format(argv[1]))
         sys.exit(1)
 
-data_as_str = fpin.read().rsplit("{")[-1].split("}")[0]
+    data_as_str = fpin.read().rsplit("{")[-1].split("}")[0]
-data_as_str = data_as_str.replace(",", " ")
+    data_as_str = data_as_str.replace(",", " ")
-data_as_list = [int(v) for v in data_as_str.split()]
+    data_as_list = [int(v) for v in data_as_str.split()]
-del data_as_str
+    del data_as_str
 
-if strip_byte:
+    if strip_byte:
         # String data gets trailing byte.
         last = data_as_list.pop()
         assert last == 0
 
-data = bytes(data_as_list)
+    data = bytes(data_as_list)
-del data_as_list
+    del data_as_list
 
-dname = filename + ".ctodata"
+    dname = filename + ".ctodata"
 
-sys.stdout.write("Making DATA file <{:s}>\n".format(dname))
+    sys.stdout.write("Making DATA file <{:s}>\n".format(dname))
 
-try:
+    try:
         fpout = open(dname, "wb")
-except:
+    except:
         sys.stdout.write("Unable to open output {:s}\n".format(dname))
         sys.exit(1)
 
-size = fpout.write(data)
+    size = fpout.write(data)
 
-sys.stdout.write("{:d}\n".format(size))
+    sys.stdout.write("{:d}\n".format(size))
+
+
+if __name__ == "__main__":
+    sys.exit(main())

release/lts/create_release_notes.py

@@ -3,34 +3,42 @@
 #
 # SPDX-License-Identifier: GPL-2.0-or-later
 
+"""
+This python script is used to generate the release notes and
+download URLs which we can copy-paste directly into the CMS of
+www.blender.org and stores.
+"""
+__all__ = (
+    "main",
+)
+
 import argparse
+import sys
 
 import lts_issue
 import lts_download
 
-DESCRIPTION = ("This python script is used to generate the release notes and "
-               "download URLs which we can copy-paste directly into the CMS of "
-               "www.blender.org and stores.")
 
-# Parse arguments
+def main() -> int:
-parser = argparse.ArgumentParser(description=DESCRIPTION)
+    # Parse arguments
-parser.add_argument(
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument(
         "--version",
         required=True,
         help="Version string in the form of {major}.{minor}.{patch} (e.g. 3.3.2)")
-parser.add_argument(
+    parser.add_argument(
         "--issue",
         help="Task that contains the release notes information (e.g. #77348)")
-parser.add_argument(
+    parser.add_argument(
         "--format",
         help="Format the result in `text`, `steam`, `markdown` or `html`",
         default="text")
-args = parser.parse_args()
+    args = parser.parse_args()
 
-# Determine issue number
+    # Determine issue number
-version = args.version
+    version = args.version
-issue = args.issue
+    issue = args.issue
-if not issue:
+    if not issue:
         if version.startswith("2.83."):
             issue = "#77348"
         elif version.startswith("2.93."):
@@ -44,9 +52,13 @@ if not issue:
         else:
             raise ValueError("Specify --issue or update script to include issue number for this version")
 
-# Print
+    # Print
-if args.format == "html":
+    if args.format == "html":
         lts_download.print_urls(version=version)
         print("")
 
-lts_issue.print_notes(version=version, format=args.format, issue=issue)
+    lts_issue.print_notes(version=version, format=args.format, issue=issue)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

release/lts/lts_download.py

@@ -2,6 +2,9 @@
 # SPDX-FileCopyrightText: 2020-2023 Blender Authors
 #
 # SPDX-License-Identifier: GPL-2.0-or-later
+__all__ = (
+    "print_urls",
+)
 
 import datetime
 

release/lts/lts_issue.py

@@ -2,6 +2,9 @@
 # SPDX-FileCopyrightText: 2023 Blender Authors
 #
 # SPDX-License-Identifier: GPL-2.0-or-later
+__all__ = (
+    "print_notes",
+)
 
 import requests
 

release/pypi/upload-release.py

@@ -3,6 +3,10 @@
 #
 # SPDX-License-Identifier: GPL-2.0-or-later
 
+__all__ = (
+    "main",
+)
+
 import argparse
 import glob
 import pathlib
@@ -12,28 +16,30 @@ import tempfile
 import urllib.request
 import zipfile
 
-parser = argparse.ArgumentParser(description="Check and upload bpy module to PyPI")
+
-parser.add_argument(
+def main():
+    parser = argparse.ArgumentParser(description="Check and upload bpy module to PyPI")
+    parser.add_argument(
         "--version",
         required=True,
         help="Version string in the form of {major}.{minor}.{patch} (e.g. 3.6.0)")
-parser.add_argument(
+    parser.add_argument(
         "--git-hash",
         required=True,
         help="Git hash matching the version")
-parser.add_argument(
+    parser.add_argument(
         "--check",
         action="store_true",
         help="Only check wheels for errors, don't upload")
-args = parser.parse_args()
+    args = parser.parse_args()
 
-platforms = [
+    platforms = [
         "darwin.x86_64",
         "darwin.arm64",
         "linux.x86_64",
         "windows.amd64"]
 
-with tempfile.TemporaryDirectory() as tmp_dir:
+    with tempfile.TemporaryDirectory() as tmp_dir:
         tmp_dir = pathlib.Path(tmp_dir)
 
         print("Download:")
@@ -68,3 +74,7 @@ with tempfile.TemporaryDirectory() as tmp_dir:
         subprocess.run(["twine", "check"] + wheels, check=True)
         if not args.check:
             subprocess.run(["twine", "upload", "--repository", "bpy", "--verbose"] + wheels, check=True)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

scripts/modules/animsys_refactor.py

@@ -8,6 +8,9 @@ rna values in fcurves and drivers.
 
 Currently unused, but might become useful later again.
 """
+__all__ = (
+    "update_data_paths",
+)
 
 import sys
 import bpy

scripts/modules/bl_keymap_utils/versioning.py

@@ -7,6 +7,11 @@
 # When the version is `(0, 0, 0)`, the key-map being loaded didn't contain any versioning information.
 # This will older than `(2, 92, 0)`.
 
+__all__ = (
+    "keyconfig_update",
+)
+
+
 def keyconfig_update(keyconfig_data, keyconfig_version):
     from bpy.app import version_file as blender_version
     if keyconfig_version >= blender_version:

tests/coverage/coverage.py

@@ -3,6 +3,10 @@
 #
 # SPDX-License-Identifier: GPL-2.0-or-later
 
+__all__ = (
+    "main",
+)
+
 import argparse
 import os
 import shutil

tests/python/bl_animation_drivers.py

@@ -2,16 +2,19 @@
 #
 # SPDX-License-Identifier: GPL-2.0-or-later
 
+"""
+blender -b --factory-startup --python tests/python/bl_animation_drivers.py -- --testdir /path/to/tests/data/animation
+"""
+__all__ = (
+    "main",
+)
+
 import unittest
 import bpy
 import pathlib
 import sys
 from rna_prop_ui import rna_idprop_quote_path
 
-"""
-blender -b --factory-startup --python tests/python/bl_animation_drivers.py -- --testdir /path/to/tests/data/animation
-"""
-
 
 class AbstractEmptyDriverTest:
     def setUp(self):

tests/python/bl_blendfile_liblink.py

@@ -2,7 +2,13 @@
 #
 # SPDX-License-Identifier: Apache-2.0
 
-# ./blender.bin --background --python tests/python/bl_blendfile_liblink.py
+"""
+./blender.bin --background --python tests/python/bl_blendfile_liblink.py
+"""
+__all__ = (
+    "main",
+)
+
 import bpy
 import os
 import sys

tests/python/bl_blendfile_versioning.py

@@ -9,6 +9,10 @@
 #
 # This needs to be investigated!
 
+__all__ = (
+    "main",
+)
+
 import os
 import platform
 import sys

tests/python/bl_imbuf_load.py

@@ -2,6 +2,10 @@
 #
 # SPDX-License-Identifier: GPL-2.0-or-later
 
+__all__ = (
+    "main",
+)
+
 import os
 import pathlib
 import sys

tests/python/bl_io_curve_svg_test.py

@@ -3,6 +3,10 @@
 #
 # SPDX-License-Identifier: Apache-2.0
 
+__all__ = (
+    "main",
+)
+
 import argparse
 import os
 import sys

tests/python/bl_load_addons.py

@@ -7,6 +7,9 @@
 """
 ./blender.bin --background --factory-startup --python tests/python/bl_load_addons.py
 """
+__all__ = (
+    "main",
+)
 
 import bpy
 import addon_utils

tests/python/bl_mesh_validate.py

@@ -5,6 +5,10 @@
 # Simple script to check mash validate code.
 # XXX Should be extended with many more "wrong cases"!
 
+__all__ = (
+    "main",
+)
+
 import bpy
 
 import random

tests/python/bl_pyapi_bpy_utils_units.py

@@ -3,6 +3,11 @@
 # SPDX-License-Identifier: Apache-2.0
 
 # ./blender.bin --background --python tests/python/bl_pyapi_bpy_utils_units.py -- --verbose
+
+__all__ = (
+    "main",
+)
+
 import unittest
 
 from bpy.utils import units
@@ -93,7 +98,11 @@ class UnitsTesting(unittest.TestCase):
             )
 
 
-if __name__ == '__main__':
+def main():
     import sys
     sys.argv = [__file__] + (sys.argv[sys.argv.index("--") + 1:] if "--" in sys.argv else [])
     unittest.main()
+
+
+if __name__ == '__main__':
+    main()

tests/python/modules/imbuf_test.py

@@ -2,6 +2,10 @@
 #
 # SPDX-License-Identifier: GPL-2.0-or-later
 
+__all__ = (
+    "AbstractImBufTest",
+)
+
 import os
 import pathlib
 import shutil

tests/utils/batch_load_blendfiles.py

@@ -2,6 +2,10 @@
 #
 # SPDX-License-Identifier: GPL-2.0-or-later
 
+__all__ = (
+    "main",
+)
+
 r"""
 Example usage:
 

tests/utils/bl_run_operators.py

@@ -7,6 +7,10 @@
 #
 # only error checked for here is a segfault.
 
+__all__ = (
+    "main",
+)
+
 import bpy
 import sys
 

tests/utils/bl_run_operators_event_simulate.py

@@ -82,7 +82,9 @@ or the context for executing the actions is not properly set (the case for timer
 
 This utility executes actions as if the user initiated them from a key shortcut.
 """
-
+__all__ = (
+    "main",
+)
 
 import os
 import sys

tests/utils/blender_headless.py

@@ -39,6 +39,10 @@ WAYLAND Environment Variables:
 
 Currently only WAYLAND is supported, other systems could be added.
 """
+__all__ = (
+    "main",
+)
+
 import subprocess
 import sys
 import signal

tools/git/git_sh1_to_svn_rev.py

@@ -5,6 +5,10 @@
 
 # generate svn rev-sha1 mapping
 
+__all__ = (
+    "main",
+)
+
 import os
 import sys
 

tools/svn_rev_map/rev_to_sha1.py

@@ -2,6 +2,10 @@
 #
 # SPDX-License-Identifier: GPL-2.0-or-later
 
+__all__ = (
+    "data",
+)
+
 data = {
 2: "12315f4d0e0ae993805f141f64cb8c73c5297311",
 16: "599dc60f6dc97d3ef8efdd294ca2e89fbf498f54",

tools/svn_rev_map/sha1_to_rev.py

@@ -2,6 +2,10 @@
 #
 # SPDX-License-Identifier: GPL-2.0-or-later
 
+__all__ = (
+    "data",
+)
+
 data = {
 "12315f4d0e0ae993805f141f64cb8c73c5297311": 2,
 "599dc60f6dc97d3ef8efdd294ca2e89fbf498f54": 16,