SCons: Dump construction environment to a file

A new `methods.dump(env)` is added to dump the construction environment
used by SCons to build Godot to a `.scons_env.json`. The file can be used
for debugging purposes and any external tool.

(cherry picked from commit 42bee75e86)
This commit is contained in:
Andrii Doroshenko (Xrayez) 2020-03-20 22:49:38 +02:00 committed by Rémi Verschelde
parent bc21cd8592
commit 23ef1e0f70
3 changed files with 18 additions and 1 deletions

3
.gitignore vendored
View file

@ -339,6 +339,9 @@ platform/windows/godot_res.res
# Visual Studio Code workspace file # Visual Studio Code workspace file
*.code-workspace *.code-workspace
# Scons construction environment dump
.scons_env.json
# Scons progress indicator # Scons progress indicator
.scons_node_count .scons_node_count

View file

@ -641,6 +641,9 @@ elif selected_platform != "":
else: else:
sys.exit(255) sys.exit(255)
# The following only makes sense when the env is defined, and assumes it is # The following only makes sense when the 'env' is defined, and assumes it is.
if "env" in locals(): if "env" in locals():
methods.show_progress(env) methods.show_progress(env)
# TODO: replace this with `env.Dump(format="json")`
# once we start requiring SCons 4.0 as min version.
methods.dump(env)

View file

@ -837,3 +837,14 @@ def show_progress(env):
progress_finish_command = Command("progress_finish", [], progress_finish) progress_finish_command = Command("progress_finish", [], progress_finish)
AlwaysBuild(progress_finish_command) AlwaysBuild(progress_finish_command)
def dump(env):
# Dumps latest build information for debugging purposes and external tools.
from json import dump
def non_serializable(obj):
return "<<non-serializable: %s>>" % (type(obj).__qualname__)
with open(".scons_env.json", "w") as f:
dump(env.Dictionary(), f, indent=4, default=non_serializable)