"""Functions used to generate scu build source files during build time

"""

import glob, os

import math

from pathlib import Path

from os.path import normpath, basename

base_folder_path = str(Path(__file__).parent) "/"

base_folder_only = os.path.basename(os.path.normpath(base_folder_path))

_verbose = True # Set manually for debug prints

_scu_folders = set()

_max_includes_per_scu = 1024

def clear_out_existing_files(output_folder, extension):

os.remove(file)

def folder_not_found(folder):

abs_folder = base_folder_path folder "/"

return not os.path.isdir(abs_folder)

def find_files_in_folder(folder, sub_folder, include_list, extension, sought_exceptions, found_exceptions):

return include_list, found_exceptions

def write_output_file(file_count, include_list, start_line, end_line, output_folder, output_filename_prefix, extension):

output_path.write_text(file_text, encoding="utf8")

def write_exception_output_file(file_count, exception_string, output_folder, output_filename_prefix, extension):

output_path.write_text(file_text, encoding="utf8")

def find_section_name(sub_folder):

return section_name

# "folders" is a list of folders to add all the files from to add to the SCU

# "section (like a module)". The name of the scu file will be derived from the first folder

# (thus e.g. scene/3d becomes scu_scene_3d.gen.cpp)

# "includes_per_scu" limits the number of includes in a single scu file.

# This allows the module to be built in several translation units instead of just 1.

# This will usually be slower to compile but will use less memory per compiler instance, which

# is most relevant in release builds.

# "sought_exceptions" are a list of files (without extension) that contain

# e.g. naming conflicts, and are therefore not suitable for the scu build.

# These will automatically be placed in their own separate scu file,

# which is slow like a normal build, but prevents the naming conflicts.

# Ideally in these situations, the source code should be changed to prevent naming conflicts.

# "extension" will usually be cpp, but can also be set to c (for e.g. third party libraries that use c)

def process_folder(folders, sought_exceptions=[], includes_per_scu=0, extension="cpp"):

)

def generate_scu_files(max_includes_per_scu):

return _scu_folders