e955c94ed3
Listing the "Blender Foundation" as copyright holder implied the Blender Foundation holds copyright to files which may include work from many developers. While keeping copyright on headers makes sense for isolated libraries, Blender's own code may be refactored or moved between files in a way that makes the per file copyright holders less meaningful. Copyright references to the "Blender Foundation" have been replaced with "Blender Authors", with the exception of `./extern/` since these this contains libraries which are more isolated, any changed to license headers there can be handled on a case-by-case basis. Some directories in `./intern/` have also been excluded: - `./intern/cycles/` it's own `AUTHORS` file is planned. - `./intern/opensubdiv/`. An "AUTHORS" file has been added, using the chromium projects authors file as a template. Design task: #110784 Ref !110783.
91 lines
2.3 KiB
Python
91 lines
2.3 KiB
Python
# SPDX-FileCopyrightText: 2018-2023 Blender Authors
|
|
#
|
|
# SPDX-License-Identifier: Apache-2.0
|
|
|
|
# Simple utility that prints all WITH_* options in a CMakeLists.txt
|
|
# Called by 'make help_features'
|
|
|
|
import re
|
|
import sys
|
|
|
|
from typing import Optional
|
|
|
|
cmakelists_file = sys.argv[-1]
|
|
|
|
|
|
def count_backslashes_before_pos(file_data: str, pos: int) -> int:
|
|
slash_count = 0
|
|
pos -= 1
|
|
while pos >= 0:
|
|
if file_data[pos] != '\\':
|
|
break
|
|
pos -= 1
|
|
slash_count += 1
|
|
return slash_count
|
|
|
|
|
|
def extract_cmake_string_at_pos(file_data: str, pos_beg: int) -> Optional[str]:
|
|
assert file_data[pos_beg - 1] == '"'
|
|
|
|
pos = pos_beg
|
|
# Dummy assignment.
|
|
pos_end = pos_beg
|
|
while True:
|
|
pos_next = file_data.find('"', pos)
|
|
if pos_next == -1:
|
|
raise Exception("Un-terminated string (parse error?)")
|
|
|
|
count_slashes = count_backslashes_before_pos(file_data, pos_next)
|
|
if (count_slashes % 2) == 0:
|
|
pos_end = pos_next
|
|
# Found the closing quote.
|
|
break
|
|
|
|
# The quote was back-slash escaped, step over it.
|
|
pos = pos_next + 1
|
|
file_data[pos_next]
|
|
|
|
assert file_data[pos_end] == '"'
|
|
|
|
if pos_beg == pos_end:
|
|
return None
|
|
|
|
# See: https://cmake.org/cmake/help/latest/manual/cmake-language.7.html#escape-sequences
|
|
text = file_data[pos_beg: pos_end].replace(
|
|
# Handle back-slash literals.
|
|
"\\\\", "\\",
|
|
).replace(
|
|
# Handle tabs.
|
|
"\\t", "\t",
|
|
).replace(
|
|
# Handle escaped quotes.
|
|
"\\\"", "\"",
|
|
).replace(
|
|
# Handle tabs.
|
|
"\\;", ";",
|
|
).replace(
|
|
# Handle trailing newlines.
|
|
"\\\n", "",
|
|
)
|
|
|
|
return text
|
|
|
|
|
|
def main() -> None:
|
|
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])
|
|
if option_descr is None:
|
|
# Possibly a parsing error, at least show something.
|
|
option_descr = "(UNDOCUMENTED)"
|
|
options.append("{:s}: {:s}".format(option_name, option_descr))
|
|
|
|
print('\n'.join(options))
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|