Nixyri/godot
1
0
Fork 0
mirror of https://github.com/godotengine/godot.git synced 2024-11-11 06:33:10 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Merge pull request #56606 from Calinou/update-doc-status-script

Browse Source 
Update doc_status script to support constructors and operators docs
This commit is contained in:
Rémi Verschelde 2022-01-08 11:00:23 +01:00 committed by GitHub
commit c4ac35485e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 22 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
doc/tools/doc_status.py
View File

@ -66,10 +66,23 @@ table_columns = [
"methods",
"constants",
"members",
"signals",
"theme_items",
"signals",
"operators",
"constructors",
]
table_column_names = [
"Name",
"Brief Desc.",
"Desc.",
"Methods",
"Constants",
"Members",
"Theme Items",
"Signals",
"Operators",
"Constructors",
]
table_column_names = ["Name", "Brief Desc.", "Desc.", "Methods", "Constants", "Members", "Signals", "Theme Items"]
colors = {
"name": [36], # cyan
"part_big_problem": [4, 31], # underline, red
@ -82,7 +95,7 @@ colors = {
"state_on": [1, 35], # bold, magenta/plum
"bold": [1], # bold
}
overall_progress_description_weigth = 10
overall_progress_description_weight = 10
################################################################################
@ -180,6 +193,8 @@ class ClassStatus:
"members": ClassStatusProgress(),
"theme_items": ClassStatusProgress(),
"signals": ClassStatusProgress(),
"operators": ClassStatusProgress(),
"constructors": ClassStatusProgress(),
}
def __add__(self, other):
@ -218,12 +233,12 @@ class ClassStatus:
output["description"] = ok_string if self.has_description else missing_string
description_progress = ClassStatusProgress(
(self.has_brief_description + self.has_description) * overall_progress_description_weigth,
2 * overall_progress_description_weigth,
(self.has_brief_description + self.has_description) * overall_progress_description_weight,
2 * overall_progress_description_weight,
)
items_progress = ClassStatusProgress()
for k in ["methods", "constants", "members", "signals", "theme_items"]:
for k in ["methods", "constants", "members", "theme_items", "signals", "constructors", "operators"]:
items_progress += self.progresses[k]
output[k] = self.progresses[k].to_configured_colored_string()
@ -260,7 +275,7 @@ class ClassStatus:
elif tag.tag == "description":
status.has_description = len(tag.text.strip()) > 0
elif tag.tag in ["methods", "signals"]:
elif tag.tag in ["methods", "signals", "operators", "constructors"]:
for sub_tag in list(tag):
descr = sub_tag.find("description")
status.progresses[tag.tag].increment(len(descr.text.strip()) > 0)
@ -272,9 +287,6 @@ class ClassStatus:
elif tag.tag in ["tutorials"]:
pass # Ignore those tags for now
elif tag.tag in ["theme_items"]:
pass # Ignore those tags, since they seem to lack description at all
else:
print(tag.tag, tag.attrib)