codeplain 0.2.2__py3-none-any.whl → 0.2.4__py3-none-any.whl

{codeplain-0.2.2.dist-info → codeplain-0.2.4.dist-info}/METADATA

@@ -1,32 +1,31 @@
 Metadata-Version: 2.4
 Name: codeplain
-Version: 0.2.2
+Version: 0.2.4
 Summary: Transform plain language specifications into working code
+License-File: LICENSE
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Software Development :: Code Generators
 Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: python-liquid2==0.3.0
+Requires-Dist: gitpython==3.1.42
 Requires-Dist: mistletoe==1.3.0
+Requires-Dist: networkx==3.6.1
+Requires-Dist: python-frontmatter==1.1.0
+Requires-Dist: python-liquid2==0.3.0
+Requires-Dist: pyyaml==6.0.2
 Requires-Dist: requests==2.32.3
+Requires-Dist: rich==14.2.0
+Requires-Dist: textual==1.0.0
 Requires-Dist: tiktoken==0.12.0
-Requires-Dist: PyYAML==6.0.2
-Requires-Dist: gitpython==3.1.42
 Requires-Dist: transitions==0.9.3
-Requires-Dist: textual==1.0.0
-Requires-Dist: rich==14.2.0
-Requires-Dist: python-frontmatter==1.1.0
-Requires-Dist: networkx==3.6.1
 Provides-Extra: dev
-Requires-Dist: pytest==8.3.5; extra == "dev"
-Requires-Dist: flake8==7.0.0; extra == "dev"
-Requires-Dist: black==24.2.0; extra == "dev"
-Requires-Dist: isort==5.13.2; extra == "dev"
-Requires-Dist: mypy==1.11.2; extra == "dev"
-Dynamic: license-file
+Requires-Dist: black==24.2.0; extra == 'dev'
+Requires-Dist: flake8==7.0.0; extra == 'dev'
+Requires-Dist: isort==5.13.2; extra == 'dev'
+Requires-Dist: mypy==1.11.2; extra == 'dev'
+Requires-Dist: pytest==8.3.5; extra == 'dev'
+Description-Content-Type: text/markdown
 
 # Codeplain plain2code renderer
 

{codeplain-0.2.2.dist-info → codeplain-0.2.4.dist-info}/RECORD

@@ -1,28 +1,31 @@
-codeplain_REST_api.py,sha256=qfzUw9v0-NKII4ibw3vqSBrCeU2WP4RcrrEti43F3zs,18400
+codeplain_REST_api.py,sha256=NJVOwlsnDFhEySeEds4q2GUKdexTfYGp7FIW0yJqL-A,18026
 concept_utils.py,sha256=vwSY4-FmxyqaDBxhntYzqG8t9pXvAWwiULP0DYQI32o,7905
+diff_utils.py,sha256=AjiQlqo5pRos_8hVXZo5yBurl5BzSrTMGrQv4dCtRCg,1198
 event_bus.py,sha256=sduIR3bgIbxAbLhwKd8Gx9YN9gzaeqy9-mNupS04aKw,1759
 file_utils.py,sha256=4BIxzsteZQOaK-efkvQcoaIfYydsQNFR6elpsxJgXLQ,11591
-git_utils.py,sha256=gTRps6RIzJJkyy9amaDxP38FPoxYulZViBWr9V0IPQg,12414
+git_utils.py,sha256=7JFHQRzxsO7GoVzP1BO7px2cgrlqyFequbOozHDV8ig,12353
 hash_key.py,sha256=lMKgKpOhPeC4UpFf9e7eCNK20FEaDsXTCJ8j3eCWidE,837
+memory_management.py,sha256=ABrM6PhOsalP_PBq2hCazQvQX9C5rpPHhgT35l68RM4,4357
 module_renderer.py,sha256=LLjLb34phSJlF2YblwGDy5HKWVdi9mo57rr7s-Hj3RA,6261
-plain2code.py,sha256=cIxPkxfxZkPlen5RG5H_rvo22sSGYQ9PnqSlw3ECVkY,9841
+plain2code.py,sha256=vErZtqioqiIN3U3I9U2jUeL7ti_Z38RPcGT0Wuz0xeE,9632
 plain2code_arguments.py,sha256=PdQjd3orklrtlEyz7-Qdz_m2SvjZtZp6dmbkqXgglSU,11826
 plain2code_console.py,sha256=-QorOFimS1AWYK7dmFqI3uhjc51cPtEWsaK4DhFibIw,4139
 plain2code_events.py,sha256=5fPhpRzgJ02xWh0MXqrMv9A4curr2UOE68Y1uKlAcqQ,1347
-plain2code_exceptions.py,sha256=Y_2Jmv9rLE5xMqlzp_mDcAIIYsIfS0yR1U3scXUzUng,760
+plain2code_exceptions.py,sha256=eFvJvFeClFR1MY68zHwPKbNy89ya4iaYSaFRE2GWkTE,929
 plain2code_logger.py,sha256=xSDGN8QAWpA4J6YKyj-kfNWSO-jBl0sfUCFRs7Tflf0,4067
 plain2code_nodes.py,sha256=Om624mfb5MB1Z09c0Zqtb9G1gGkUY9x-v2hzAf3A2gw,3818
 plain2code_read_config.py,sha256=QnpbW_Bi9LzDIOubM5x7fVXH1HgiFL3-5Oa_O1EUoE4,2449
 plain2code_state.py,sha256=InLXdytMXnm9YC4o8MSTbtB1TmqYYUs6rASGBlyA_YY,1274
 plain2code_utils.py,sha256=3xPXWci5yVdpdK_WrNcbinSV94XSeMQDW5UzDuBMaUM,1767
-plain_file.py,sha256=OXbWvErVTVhaeRFUu9f0bzi16P01DShW_jLhNI-tmeA,28931
-plain_modules.py,sha256=iDqqamtix5KahMC_v-vfQ7yndugmqtBW1z6XxTB4x6w,4876
-plain_spec.py,sha256=zC-VOb_UJOs8OxtEiwQJuonw7Lkmbi7YHyFvvCvUZNo,13529
+plain_file.py,sha256=lF0ZwK_Hycc4rdaHPxJSfe7mfkRYo5QgMngv50AsF74,28430
+plain_modules.py,sha256=6gteJeiK-WvUZDrIt_kJK0MFiptq63rEVpYvV5yYFXc,4881
+plain_spec.py,sha256=jU4dMVoWumkTK-IBdgXsH4-EnAdyRWxR9dI-lHreEyM,13535
 spinner.py,sha256=Ro6Gd9Przf-whuHqPRY6HwI0T57yJjyNPbhDbigZKZE,2471
 system_config.py,sha256=mgHLn-CRHLO9Y9vKyI_eFBreY_YhFad-ctZgBYp-rIg,1777
-codeplain-0.2.2.dist-info/licenses/LICENSE,sha256=wsFi5dpbJurnRNfBj8q2RCcF3ryrmdRIfxc3lPcmc4c,1069
 config/__init__.py,sha256=beYSsJWmBNHDP5rYmVDouqgEeP3t1lkkepbXJ-oq0F8,37
 config/system_config.yaml,sha256=bB5Th5jxgXFyaIvceUPID1ReebMMXsyMibV4gtu9sWQ,1148
+docs/generate_cli.py,sha256=xJmiihtdgqEDBYt_wBsRbniZvIfq7Q6tjAsi3SjoMJg,531
+examples/example_hello_world_python/harness_tests/hello_world_display/test_hello_world.py,sha256=dwTowrHiVKKbrDv21v8xJC30Q57AXZkQasdGOO5JsBE,470
 render_machine/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 render_machine/code_renderer.py,sha256=jOoYivkZzCuGG947YlNPlvD1Dpd2xTWVK8pwfF_OqDU,2957
 render_machine/conformance_test_helpers.py,sha256=6Ru7Dh24SLNIKWfz_sP5hE_EmWpvk6nfgN1T1yaCZus,2887
@@ -56,6 +59,14 @@ standard_template_library/golang-console-app-template.plain,sha256=M3gE1wZ6o_F-H
 standard_template_library/python-console-app-template.plain,sha256=ofIJIkNXScGFTx2w8mY3lP4KmRml2GQv2EiEoXlbqqs,1005
 standard_template_library/typescript-react-app-boilerplate.plain,sha256=6LFxhEOzWnDHdVpFj-XBTq6s4_2dy7LKV3lVkCzv8i4,114
 standard_template_library/typescript-react-app-template.plain,sha256=SG1cBMVt1ncMRK4cOGOyVVj0MmsQTmF4MI67IBn1lFg,380
+tests/__init__.py,sha256=Wk73Io62J15BtlLVIzxmASDWaaJkQLevS4BLK5LDAQg,16
+tests/conftest.py,sha256=QZcp08htUlJGgmHDlRWFgsWXZ8o8IBWTD5QqJaUMlU8,790
+tests/test_git_utils.py,sha256=Knc4R2ZkHYVj9iPFKhb0_ewaad_mxPrakOn6gpziHMc,13138
+tests/test_imports.py,sha256=cdw7u93xNFD064sjwwEWy4oLHhJNlt1-DRDYhHjymFw,2078
+tests/test_plainfile.py,sha256=gUw58XP3PUCDrZxXkrIUNPszlnqY4yW2io3xg6F3ySQ,11086
+tests/test_plainfileparser.py,sha256=9B9r2jEeUKDMhqb4TJEPK7aatYl1op1z92GDAD4fJ20,18685
+tests/test_plainspec.py,sha256=ouS899oejStu8u1D3399y5NAxcKlNbLcinNoxZUp59M,2437
+tests/test_requires.py,sha256=BwlZeLXIs4m-FGnjLjO4vHkxfEX_QgjYoomb3oIu7Vs,1236
 tui/__init__.py,sha256=_fy7FowY0RkWdn4kC7XV2jgvQPCj-2gE8fNUb-Mny0A,60
 tui/components.py,sha256=l7f-jLk0sj9WM8z2IpaHksmSyytXe_bl2GBdHASoIg4,13901
 tui/models.py,sha256=KMjlWubmPD41GA-BjgiqkaV9v7tLJ0fuWKBDPmZj4JA,1493
@@ -63,8 +74,8 @@ tui/plain2code_tui.py,sha256=7agVU0NnaCuF1LuOSEmjx-XfEOQ6HHr1HlWe_b1Tses,11695
 tui/state_handlers.py,sha256=HbjgaV-9xGhp3E-3X114zOqPkeNcCjT-R1PbVRxVdso,12674
 tui/styles.css,sha256=Umm2TLePmywizZGV4Nd8UezZRiK5pFyibYRbpRvGqbs,3056
 tui/widget_helpers.py,sha256=VJorEM2PjRBzN-jIDmKJPolFgo2d8-2NmTumgC5xeNo,5229
-codeplain-0.2.2.dist-info/METADATA,sha256=GdVqb-nYcVTRFWOtusYkzXrEaRJ1XCLoSAv0ErxKSEQ,4300
-codeplain-0.2.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-codeplain-0.2.2.dist-info/entry_points.txt,sha256=oDZkBqu9WhtZApb_K6ia8-fn9aojwmAsgnKELceX5T4,46
-codeplain-0.2.2.dist-info/top_level.txt,sha256=mj1YZAk6MowQ7wZZkVOAcdUJrJKeWQ7IRZnUHHjaFTM,602
-codeplain-0.2.2.dist-info/RECORD,,
+codeplain-0.2.4.dist-info/METADATA,sha256=HTXpXKt_9V_qDoBoOuuGi-bDsWQ-nGQeItUOOWCaSxQ,4278
+codeplain-0.2.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+codeplain-0.2.4.dist-info/entry_points.txt,sha256=oDZkBqu9WhtZApb_K6ia8-fn9aojwmAsgnKELceX5T4,46
+codeplain-0.2.4.dist-info/licenses/LICENSE,sha256=wsFi5dpbJurnRNfBj8q2RCcF3ryrmdRIfxc3lPcmc4c,1069
+codeplain-0.2.4.dist-info/RECORD,,

{codeplain-0.2.2.dist-info → codeplain-0.2.4.dist-info}/WHEEL

@@ -1,5 +1,4 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.10.2)
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any
-

codeplain_REST_api.py

@@ -65,12 +65,6 @@ class CodeplainAPI:
                     if response_json["error_code"] == "PlainSyntaxError":
                         raise plain2code_exceptions.PlainSyntaxError(response_json["message"])
 
-                    if response_json["error_code"] == "OnlyRelativeLinksAllowed":
-                        raise plain2code_exceptions.OnlyRelativeLinksAllowed(response_json["message"])
-
-                    if response_json["error_code"] == "LinkMustHaveTextSpecified":
-                        raise plain2code_exceptions.LinkMustHaveTextSpecified(response_json["message"])
-
                     if response_json["error_code"] == "NoRenderFound":
                         raise plain2code_exceptions.NoRenderFound(response_json["message"])
 

diff_utils.py

@@ -0,0 +1,32 @@
+from difflib import unified_diff
+
+
+def get_unified_diff(filename: str, existing_file_content: str, response_file_content: str) -> str:
+    diff = unified_diff(
+        existing_file_content.splitlines(keepends=True),
+        response_file_content.splitlines(keepends=True),
+        fromfile=filename,
+        tofile=filename,
+    )
+
+    return "".join(diff)
+
+
+def get_code_diff(response_files: dict[str, str], existing_files_content: dict[str, str]) -> dict[str, str]:
+    code_diff: dict[str, str] = {}
+    for file_name in response_files:
+        if file_name in existing_files_content and existing_files_content[file_name]:
+            if response_files[file_name]:
+                unified_diff_result = get_unified_diff(
+                    file_name,
+                    existing_files_content[file_name],
+                    response_files[file_name],
+                )
+                if unified_diff_result and unified_diff_result.strip():
+                    code_diff[file_name] = unified_diff_result
+            else:
+                code_diff[file_name] = f"File {file_name} was deleted."
+        else:
+            code_diff[file_name] = response_files[file_name]
+
+    return code_diff

docs/generate_cli.py

@@ -0,0 +1,20 @@
+import os
+import sys
+
+from plain2code_arguments import create_parser
+
+# Add the parent directory to the path so we can import plain2code_arguments
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+
+# Get the parser and generate help text
+parser = create_parser()
+help_text = parser.format_help()
+
+# Create markdown
+md = "# Plain2Code CLI Reference\n\n```text\n" + help_text + "\n```"
+
+# Run generate_cli.py in the docs folder
+
+with open("plain2code_cli.md", "w", encoding="utf-8") as f:
+    f.write(md)

examples/example_hello_world_python/harness_tests/hello_world_display/test_hello_world.py

@@ -0,0 +1,17 @@
+#!/usr/bin/env python3
+
+import subprocess
+import unittest
+
+
+class TestHelloWorld(unittest.TestCase):
+    def test_hello_world_output(self):
+        # Run the hello_world.py script and capture its output
+        result = subprocess.run(["python3", "hello_world.py"], capture_output=True, text=True)
+
+        # Check if the output matches the expected string
+        self.assertEqual(result.stdout.strip(), "hello, world")
+
+
+if __name__ == "__main__":
+    unittest.main()

git_utils.py

@@ -4,6 +4,7 @@ from typing import Optional, Union
 from git import Repo
 
 import file_utils
+from plain2code_exceptions import InvalidGitRepositoryError
 
 FUNCTIONAL_REQUIREMENT_IMPLEMENTED_COMMIT_MESSAGE = (
     "[Codeplain] Implemented code and unit tests for functional requirement {}"
@@ -25,12 +26,6 @@ MODULE_NAME_MESSAGE = "Module name: {}"
 RENDER_ID_MESSAGE = "Render ID: {}"
 
 
-class InvalidGitRepositoryError(Exception):
-    """Raised when the git repository is in an invalid state."""
-
-    pass
-
-
 def _get_full_commit_message(message, module_name, frid, render_id) -> str:
     full_message = message
 

memory_management.py

@@ -0,0 +1,97 @@
+import os
+
+import file_utils
+from plain2code_console import console
+from plain_modules import CODEPLAIN_MEMORY_SUBFOLDER
+from render_machine.implementation_code_helpers import ImplementationCodeHelpers
+from render_machine.render_context import RenderContext
+
+CONFORMANCE_TESTS_SUCCESS_EXIT_CODE = 0
+CONFORMANCE_TEST_MEMORY_SUBFOLDER = "conformance_test_memory"
+
+
+class MemoryManager:
+
+    @staticmethod
+    def fetch_memory_files(memory_folder: str):
+        """Fetch memory files from memory_folder/conformance_test_memory."""
+        memory_path = os.path.join(memory_folder, CONFORMANCE_TEST_MEMORY_SUBFOLDER)
+        if not os.path.exists(memory_path):
+            return {}, {}
+        memory_files = file_utils.list_all_text_files(memory_path)
+        memory_files_content = file_utils.get_existing_files_content(memory_path, memory_files)
+        return memory_files, memory_files_content
+
+    def __init__(self, codeplain_api, module_build_folder: str):
+        self.codeplain_api = codeplain_api
+        self.memory_folder = os.path.join(module_build_folder, CODEPLAIN_MEMORY_SUBFOLDER)
+
+    def create_conformance_tests_memory(
+        self, render_context: RenderContext, exit_code: int, conformance_tests_issue: str
+    ):
+
+        current_conformance_tests_issue_frid = render_context.conformance_tests_running_context.current_testing_frid
+        old_conformance_tests_issue_frid = (
+            render_context.conformance_tests_running_context.previous_conformance_tests_issue_frid
+        )
+
+        old_conformance_tests_issue = (
+            render_context.conformance_tests_running_context.previous_conformance_tests_issue_old
+        )
+
+        is_first_time_running_conformance_tests = (
+            old_conformance_tests_issue_frid is None or old_conformance_tests_issue_frid == ""
+        )
+        is_same_frid_as_previous_failing_test = current_conformance_tests_issue_frid == old_conformance_tests_issue_frid
+        is_conformance_test_failed = exit_code != CONFORMANCE_TESTS_SUCCESS_EXIT_CODE
+
+        should_create_memory = not is_first_time_running_conformance_tests and (
+            is_same_frid_as_previous_failing_test or is_conformance_test_failed
+        )
+        code_diff_files = render_context.conformance_tests_running_context.code_diff_files
+
+        if not should_create_memory or code_diff_files is None:
+            console.info(
+                "Skipping creation of conformance test memory because the conditions for creating memories are not met."
+            )
+            return
+
+        existing_files, existing_files_content = ImplementationCodeHelpers.fetch_existing_files(
+            render_context.build_folder
+        )
+        _, memory_files_content = MemoryManager.fetch_memory_files(self.memory_folder)
+
+        conformance_tests_folder_name = (
+            render_context.conformance_tests_running_context.get_current_conformance_test_folder_name()
+        )
+
+        (
+            _,
+            existing_conformance_test_files_content,
+        ) = render_context.conformance_tests.fetch_existing_conformance_test_files(
+            render_context.module_name,
+            render_context.required_modules,
+            render_context.conformance_tests_running_context.current_testing_module_name,
+            conformance_tests_folder_name,
+        )
+        acceptance_tests = render_context.conformance_tests_running_context.get_current_acceptance_tests()
+
+        response_files = render_context.codeplain_api.create_conformance_test_memory(
+            render_context.frid_context.frid,
+            render_context.plain_source_tree,
+            render_context.frid_context.linked_resources,
+            existing_files_content,
+            memory_files_content,
+            render_context.module_name,
+            render_context.get_required_modules_functionalities(),
+            code_diff_files,
+            existing_conformance_test_files_content,
+            acceptance_tests,
+            conformance_tests_issue,
+            conformance_tests_folder_name,
+            old_conformance_tests_issue,
+            run_state=render_context.run_state,
+        )
+        if len(response_files) > 0:
+            memory_folder_path = os.path.join(self.memory_folder, CONFORMANCE_TEST_MEMORY_SUBFOLDER)
+            file_utils.store_response_files(memory_folder_path, response_files, existing_files)

plain2code.py

@@ -17,7 +17,7 @@ from event_bus import EventBus
 from module_renderer import ModuleRenderer
 from plain2code_arguments import parse_arguments
 from plain2code_console import console
-from plain2code_exceptions import MissingAPIKey, PlainSyntaxError
+from plain2code_exceptions import InvalidFridArgument, MissingAPIKey, PlainSyntaxError
 from plain2code_logger import (
     CrashLogHandler,
     IndentedFormatter,
@@ -46,10 +46,6 @@ UNRECOVERABLE_ERROR_EXIT_CODES = [69]
 TIMEOUT_ERROR_EXIT_CODE = 124
 
 
-class InvalidFridArgument(Exception):
-    pass
-
-
 def get_render_range(render_range, plain_source):
     render_range = render_range.split(",")
     range_end = render_range[1] if len(render_range) == 2 else render_range[0]
@@ -227,23 +223,20 @@ def main():
 
         render(args, run_state, codeplain_api, event_bus)
     except InvalidFridArgument as e:
-        console.error(f"Error rendering plain code: {str(e)}.\n")
+        console.error(f"Invalid FRID argument: {str(e)}.\n")
         # No need to print render ID since this error is going to be thrown at the very start so user will be able to
         # see the render ID that's printed at the very start of the rendering process.
         dump_crash_logs(args)
     except FileNotFoundError as e:
-        console.error(f"Error rendering plain code: {str(e)}\n")
+        console.error(f"File not found: {str(e)}\n")
         console.debug(f"Render ID: {run_state.render_id}")
         dump_crash_logs(args)
-    except plain_file.InvalidPlainFileExtension as e:
-        console.error(f"Error rendering plain code: {str(e)}\n")
-        dump_crash_logs(args)
     except TemplateNotFoundError as e:
-        console.error(f"Error: Template not found: {str(e)}\n")
+        console.error(f"Template not found: {str(e)}\n")
         console.error(system_config.get_error_message("template_not_found"))
         dump_crash_logs(args)
     except PlainSyntaxError as e:
-        console.error(f"Error rendering plain code: {str(e)}\n")
+        console.error(f"Plain syntax error: {str(e)}\n")
         dump_crash_logs(args)
     except KeyboardInterrupt:
         console.error("Keyboard interrupt")

plain2code_exceptions.py

@@ -25,25 +25,35 @@ class PlainSyntaxError(Exception):
     pass
 
 
-class OnlyRelativeLinksAllowed(Exception):
+class NoRenderFound(Exception):
     pass
 
 
-class LinkMustHaveTextSpecified(Exception):
+class MultipleRendersFound(Exception):
     pass
 
 
-class NoRenderFound(Exception):
+class UnexpectedState(Exception):
     pass
 
 
-class MultipleRendersFound(Exception):
+class MissingAPIKey(Exception):
     pass
 
 
-class UnexpectedState(Exception):
+class InvalidFridArgument(Exception):
     pass
 
 
-class MissingAPIKey(Exception):
+class InvalidGitRepositoryError(Exception):
+    """Raised when the git repository is in an invalid state."""
+
+    pass
+
+
+class InvalidLiquidVariableName(Exception):
+    pass
+
+
+class ModuleDoesNotExistError(Exception):
     pass

plain_file.py

@@ -44,22 +44,6 @@ class PlainFileParseResult:
     required_concepts: list[str]
 
 
-class OnlyRelativeLinksAllowed(Exception):
-    pass
-
-
-class LinkMustHaveTextSpecified(Exception):
-    pass
-
-
-class InvalidPlainFileExtension(Exception):
-    pass
-
-
-class PlainModuleNotFound(Exception):
-    pass
-
-
 class PlainRenderer(MarkdownRenderer):
     def render_link(self, token: Link) -> Iterable[Fragment]:
         yield from self.embed_span(
@@ -95,12 +79,12 @@ def check_section_for_linked_resources(section):
     for link in traverse(section, klass=Link):
         parsed_url = urlparse(link.node.target)
         if parsed_url.scheme != "" or os.path.isabs(link.node.target):
-            raise OnlyRelativeLinksAllowed(
+            raise PlainSyntaxError(
                 f"Only relative links are allowed (text: {link.node.children[0].content}, target: {link.node.target})."
             )
 
         if len(link.node.children) != 1:
-            raise LinkMustHaveTextSpecified(f"Link must have text specified (link: {link.node.target}).")
+            raise PlainSyntaxError(f"Link must have text specified (link: {link.node.target}).")
 
         linked_resources.append({"text": link.node.children[0].content, "target": link.node.target})
 
@@ -529,7 +513,7 @@ def parse_plain_source(  # noqa: C901
 def read_module_plain_source(module_name: str, template_dirs: list[str]) -> str:
     plain_source_text = file_utils.open_from(template_dirs, module_name + PLAIN_SOURCE_FILE_EXTENSION)
     if plain_source_text is None:
-        raise PlainModuleNotFound(f"Module does not exist ({module_name}).")
+        raise PlainSyntaxError(f"Module does not exist ({module_name}).")
     return plain_source_text
 
 
@@ -566,12 +550,9 @@ def process_required_modules(
         if len(all_required_modules) > 0 and module_name == all_required_modules[-1]:
             continue
 
-        try:
-            plain_file_parse_result = parse_plain_file(
-                module_name, code_variables, template_dirs, imported_modules=[], modules_trace=[]
-            )
-        except PlainModuleNotFound:
-            raise PlainSyntaxError(f"Required module not found ({module_name}).")
+        plain_file_parse_result = parse_plain_file(
+            module_name, code_variables, template_dirs, imported_modules=[], modules_trace=[]
+        )
 
         if len(plain_file_parse_result.required_modules) == 0:
             if len(all_required_modules) > 0:
@@ -644,7 +625,7 @@ def plain_file_parser(  # noqa: C901
     # and we need to pass them to the marshalled_plain_source_tree after it's rendered
     plain_source_file_path = Path(plain_source_file_name)
     if plain_source_file_path.suffix != PLAIN_SOURCE_FILE_EXTENSION:
-        raise InvalidPlainFileExtension(
+        raise PlainSyntaxError(
             f"Invalid plain file extension: {plain_source_file_path.suffix}. Expected: {PLAIN_SOURCE_FILE_EXTENSION}."
         )
 
@@ -652,16 +633,13 @@ def plain_file_parser(  # noqa: C901
 
     code_variables = {}
 
-    try:
-        plain_file_parse_result = parse_plain_file(
-            module_name,
-            code_variables,
-            template_dirs,
-            imported_modules=[],
-            modules_trace=[],
-        )
-    except PlainModuleNotFound as e:
-        raise PlainSyntaxError(e.message)
+    plain_file_parse_result = parse_plain_file(
+        module_name,
+        code_variables,
+        template_dirs,
+        imported_modules=[],
+        modules_trace=[],
+    )
 
     if len(plain_file_parse_result.required_concepts) > 0:
         missing_required_concepts_msg = "Missing required concepts: "

plain_modules.py

@@ -7,6 +7,7 @@ from git.exc import NoSuchPathError
 
 import git_utils
 import plain_spec
+from plain2code_exceptions import ModuleDoesNotExistError
 from render_machine.implementation_code_helpers import ImplementationCodeHelpers
 
 CODEPLAIN_MEMORY_SUBFOLDER = ".memory"
@@ -16,10 +17,6 @@ MODULE_FUNCTIONALITIES = "functionalities"
 REQUIRED_MODULES_FUNCTIONALITIES = "required_modules_functionalities"
 
 
-class ModuleDoesNotExistError(Exception):
-    pass
-
-
 class PlainModule:
     def __init__(self, name: str, build_folder: str):
         self.name = name

plain_spec.py

@@ -5,6 +5,8 @@ from typing import Optional
 
 from liquid2.filter import with_context
 
+from plain2code_exceptions import InvalidLiquidVariableName
+
 DEFINITIONS = "definitions"
 NON_FUNCTIONAL_REQUIREMENTS = "technical specs"
 TEST_REQUIREMENTS = "test specs"
@@ -23,10 +25,6 @@ ALLOWED_SPECIFICATION_HEADINGS = [
 ALLOWED_IMPORT_SPECIFICATION_HEADINGS = [DEFINITIONS, NON_FUNCTIONAL_REQUIREMENTS, TEST_REQUIREMENTS]
 
 
-class InvalidLiquidVariableName(Exception):
-    pass
-
-
 def collect_specification_linked_resources(specification, specification_heading, linked_resources_list):
     linked_resources = []
     if "linked_resources" in specification:

tests/__init__.py

@@ -0,0 +1 @@
+# Tests package

tests/conftest.py

@@ -0,0 +1,34 @@
+import os
+
+import pytest
+
+os.environ["MASTER_KEY"] = "test-master-key"
+os.environ["GOOGLE_API_KEY"] = "test-google-api-key"
+
+
+@pytest.fixture
+def test_data_path():
+    """Returns the path to the test data directory."""
+    return os.path.dirname(__file__)
+
+
+@pytest.fixture
+def load_test_data(test_data_path):
+    """Returns a function to load test data files."""
+
+    def _load(file_name):
+        file_path = os.path.join(test_data_path, file_name)
+        with open(file_path, "r") as file:
+            return file.read()
+
+    return _load
+
+
+@pytest.fixture
+def get_test_data_path(test_data_path):
+    """Returns a function to get the path to a test data subfolder."""
+
+    def _get_path(subfolder_name):
+        return os.path.join(test_data_path, subfolder_name)
+
+    return _get_path