Update generate_template function and add UI for incomplete file

web/management/commands/generate_missing_templates.py

@@ -0,0 +1,28 @@
+from django.core.management.base import BaseCommand
+
+from web.models import Language, MetaInfo
+
+import os
+
+
+class Command(BaseCommand):
+    help = 'Generate missing language thesaurus files to be filled out'
+
+    def handle(self, *args, **options):
+        meta_info = MetaInfo()
+        languages = meta_info.languages
+        structures = meta_info.structures
+
+        for language in languages:
+            versions = Language(language, languages[language]).versions()
+            for version in versions:
+                for structure in structures:
+                    file_path = os.path.join(
+                        'web',
+                        'thesauruses',
+                        language,
+                        version,
+                        structure + '.json'
+                    )
+                    if not os.path.exists(file_path):
+                        os.system(f'python manage.py generate_template "{language}" "{structure}" --language-version="{version}"')

web/management/commands/generate_template.py

@@ -1,3 +1,4 @@
+import unicodedata
 from django.core.management.base import BaseCommand
 
 from web.thesaurus_template_generators import generate_language_template
@@ -31,15 +32,16 @@ def generate_file(self, language, structure, language_version):
             template = generate_language_template(
                 language,
                 structure,
-                language_version
+                language_version,
             )
         except ValueError:
             self.stdout.write(
                     f'The structure "{structure}" is not implemented yet. You can visit https://docs.codethesaur.us/thesaurus/ to learn how to add one.'
             )
 
         version = parse_version(language_version)
-        major_version = version.major
+        major_version = getattr(version, 'major', version.base_version)
+
         language_dir_path = os.path.join(
             'web',
             'thesauruses',
@@ -80,4 +82,4 @@ def generate_file(self, language, structure, language_version):
                  'Created template file '\
                 f'"{self.style.SUCCESS(template_file_path)}" which you can '\
                  'now edit.'
-            )
+            )

web/models.py

@@ -204,6 +204,29 @@ def concept_comment(self, concept_key):
         """
         return self.concept(concept_key).get("comment", "")
 
+    def is_incomplete(self, version, structure_key):
+        """
+        Returns a Boolean if the version is incomplete
+
+        :param version: the version of the language
+        :param structure_key: the ID for the structure to load
+        :return: Boolean if the version is incomplete
+        """
+        file_name = f"{structure_key}.json"
+        file_path = os.path.join(self.language_dir, version, file_name)
+
+        with open(file_path, 'r', encoding='UTF-8') as file:
+            file_json = json.load(file)
+            for concept in file_json["concepts"].values():
+                code = concept.get("code")
+                if isinstance(code, list):
+                    code = "".join(code)
+                if isinstance(code, str) and code.strip() == "":
+                    return True
+
+        return False
+
+
 
 class MetaInfo:
     """Holds info about structures and languages"""

web/templates/compare.html

@@ -29,11 +29,23 @@ <h3 class="text-center">Concept</h3>
                 <div class="card">
                     <div class="card-body">
                         <h3 class="text-center">{{ lang1_friendlyname|linebreaksbr }}'s Implementation</h3>
+{% if is_lang1_incomplete %}
+                        <div class="alert alert-warning" role="alert">
+                            <strong>Warning!</strong> This thesaurus is incomplete.
+                            <a href="https://github.com/codethesaurus/codethesaur.us/edit/main/web/thesauruses/{{ lang1 }}/{{ version1 }}/{{ concept }}.json" class="alert-link">Help us improve!</a>
+                        </div>
+{% endif %}
                     </div>
                 </div>
                 <div class="card">
                     <div class="card-body">
                         <h3 class="text-center">{{ lang2_friendlyname|linebreaksbr }}'s Implementation</h3>
+{% if is_lang2_incomplete %}
+                        <div class="alert alert-warning" role="alert">
+                            <strong>Warning!</strong> This thesaurus is incomplete.
+                            <a href="https://github.com/codethesaurus/codethesaur.us/edit/main/web/thesauruses/{{ lang2 }}/{{ version2 }}/{{ concept }}.json" class="alert-link">Help us improve!</a>
+                        </div>
+{% endif %}
                     </div>
                 </div>
             </div>

web/templates/reference.html

@@ -27,6 +27,12 @@ <h3 class="text-center">Concept</h3>
                 <div class="card">
                     <div class="card-body">
                         <h3 class="text-center">{{ lang_friendlyname|linebreaksbr }}'s Implementation</h3>
+{% if is_incomplete %}
+                        <div class="alert alert-warning" role="alert">
+                            <strong>Warning!</strong> This thesaurus is incomplete.
+                            <a href="https://github.com/codethesaurus/codethesaur.us/edit/main/web/thesauruses/{{ lang }}/{{ version }}/{{ concept }}.json" class="alert-link">Help us improve!</a>
+                        </div>
+{% endif %}
                     </div>
                 </div>
             </div>

web/thesaurus_template_generators.py

@@ -3,7 +3,7 @@
 from web.models import MetaInfo
 
 
-def generate_language_template(language_id, structure_id, version=None):
+def generate_language_template(language_id, structure_id, version=None, draft=False):
     """Generate a template for the given language and structure"""
     meta_info = MetaInfo()
     if structure_id not in meta_info.structures:
@@ -20,6 +20,9 @@ def generate_language_template(language_id, structure_id, version=None):
 
     if version:
         meta['language_version'] = version
+
+    if draft:
+        meta['draft'] = True
 
     concepts = {
         id: {

web/views.py

@@ -230,6 +230,9 @@ def compare(request):
             "concepts": concepts
         })
 
+    is_lang1_incomplete = lang1.is_incomplete(version1, meta_structure.key)
+    is_lang2_incomplete = lang2.is_incomplete(version2, meta_structure.key)
+
     response = {
         "title": f"Comparing {lang1.friendly_name} and {lang2.friendly_name}",
         "concept": meta_structure.key,
@@ -240,6 +243,8 @@ def compare(request):
         "version2": version2,
         "lang1_friendlyname": lang1.friendly_name,
         "lang2_friendlyname": lang2.friendly_name,
+        "is_lang1_incomplete": is_lang1_incomplete,
+        "is_lang2_incomplete": is_lang2_incomplete,
         "categories": both_categories,
         "description": f"Code Thesaurus: Comparing {lang1.friendly_name} \
                 and {lang2.friendly_name}",
@@ -325,6 +330,8 @@ def reference(request):
             "concepts": concepts
         })
 
+    is_incomplete = lang.is_incomplete(version, meta_structure.key)
+
     response = {
         "title": f"Reference for {lang.key}",
         "concept": meta_structure.key,
@@ -333,6 +340,7 @@ def reference(request):
         "version": version,
         "lang_friendlyname": lang.friendly_name,
         "categories": categories,
+        "is_incomplete": is_incomplete,
         "description": f"Code Thesaurus: Reference for {lang.key}"
     }