codeplain 0.1.0__py3-none-any.whl

codeplain-0.1.0.dist-info/METADATA

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: codeplain
+Version: 0.1.0
+Summary: Transform plain language specifications into working code
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+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: mistletoe==1.3.0
+Requires-Dist: langchain==1.0.8
+Requires-Dist: langchain-core==1.2.3
+Requires-Dist: langchain-openai==1.0.3
+Requires-Dist: langchain-anthropic==1.1.0
+Requires-Dist: langchain-aws==1.0.0
+Requires-Dist: langchain-cerebras==0.8.0
+Requires-Dist: langchain-google-genai==4.1.2
+Requires-Dist: langchain-ollama==1.0.0
+Requires-Dist: requests==2.32.3
+Requires-Dist: langsmith==0.4.4
+Requires-Dist: rich==14.2.0
+Requires-Dist: tiktoken==0.12.0
+Requires-Dist: PyYAML==6.0.2
+Requires-Dist: gitpython==3.1.42
+Requires-Dist: lizard==1.18.0
+Requires-Dist: textual==1.0.0
+Requires-Dist: SQLAlchemy==2.0.36
+Requires-Dist: psycopg2==2.9.10
+Requires-Dist: python-dotenv==1.1.0
+Requires-Dist: transitions==0.9.3
+Requires-Dist: cryptography==46.0.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: flake8-bugbear==24.12.12; extra == "dev"
+Requires-Dist: flake8-unused-arguments==0.0.13; extra == "dev"
+Requires-Dist: flake8-eradicate==1.5.0; extra == "dev"
+Requires-Dist: pep8-naming==0.15.1; extra == "dev"
+Requires-Dist: mypy==1.11.2; extra == "dev"
+Dynamic: license-file
+
+# Codeplain plain2code renderer
+
+Render ***plain source to software code using the Codeplain API.
+
+## Codeplain.ai - Code Generation as a Service
+
+Codeplain is a platform that generates software code using large language models based on requirements you specify in ***plain specification language.
+
+Schematic overview of the Codeplain's code generation service
+
+<img src="resources/codeplain_overview.png">
+
+### Abstracting Away Code Generation Complexity with ***plain
+
+
+***plain is a novel specification language that helps abstracting away complexity of using large language models for code generation.
+
+An example application in ***plain
+
+<img src="resources/plain_example.png" width="70%" height="70%">
+
+
+## Getting started
+
+### Prerequisites
+
+
+#### System requirements
+
+To run the plain2code client, you need Python 3.11 or a later version.
+
+**Windows users:** Please install WSL (Windows Subsystem for Linux) as this is currently the supported environment for running plain code on Windows.
+
+#### Authorization - Codeplain API Key
+
+We are using Codeplain API Key to authorize requests to the Codeplain API. To get your Codeplain API Key, please contact Codeplain.ai support at support@codeplain.ai.
+
+In order to generate code, you need to export the following environment variable:
+
+```bash
+export CODEPLAIN_API_KEY="your_actual_api_key_here"
+```
+
+### Installation Steps
+
+1. Clone this repository
+2. Set your Codeplain API key as an environment variable:
+   ```
+   export CODEPLAIN_API_KEY=your_api_key_here
+   ```
+3. (Recommended) Create and activate a virtual environment:
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate
+   ```
+4. Install required libraries
+   ```
+   pip install -r requirements.txt
+   ```
+
+### Quick Start
+
+After completing the installation steps above, you can immediately test the system with a simple "Hello World" example:
+
+- Change to the example folder and run the example:
+   ```
+   cd examples/example_hello_world_python
+   python ../../plain2code.py hello_world_python.plain
+   ```
+
+   *Note: Rendering will take a few minutes to complete.*
+
+- The system will generate a Python application in the `build` directory. You can run it with:
+   ```
+   cd build
+   python hello_world.py
+   ```
+
+## Additional Resources
+
+### Examples and Sample Projects
+
+- See the [examples](examples) folder for sample projects in Golang, Python, and React.
+- For example application how to implement task manager in ***plain see [example-task-manager](https://github.com/Codeplain-ai/example-task-manager) repository.
+- For example application how to implement SaaS connectors in ***plain see [example-saas-connectors](https://github.com/Codeplain-ai/example-saas-connectors) repository.
+
+### Documentation
+
+- For more details on the ***plain format, see the [***plain language specification](docs/plain_language_specification.md).
+- For step-by-step instructions for creating your first ***plain project see the [Kickstart your ***plain project](docs/starting_a_plain_project_from_scratch.md).
+- For complete CLI documentation and usage examples, see [plain2code CLI documentation](docs/plain2code_cli.md).
+
+

codeplain-0.1.0.dist-info/RECORD

@@ -0,0 +1,51 @@
+codeplain_REST_api.py,sha256=C0PoV3xgXXH4GUBJYMq-dKnxtt3eKSykPgND31TNATo,14781
+file_utils.py,sha256=MaHDvn-a5fB2_D0kvAk1MGxqs5Povke2NIA-WLjdo_s,11387
+git_utils.py,sha256=vLDVRek9nhYdAR4IRp_M8WNn-pyYjVjrIxNfEXEij2E,10153
+hash_key.py,sha256=lMKgKpOhPeC4UpFf9e7eCNK20FEaDsXTCJ8j3eCWidE,837
+plain2code.py,sha256=rvP0-GDgr9F05dyAsYTelgn2kza3pLK9ODSWG9PE5kw,8098
+plain2code_arguments.py,sha256=wMIbDVjzXZnrkXnbhBWc9Vz7ddQCPIm_wg56Wp_aado,11040
+plain2code_console.py,sha256=08TWADO9bmwmN6oMfLsjDKF54EIPc3mPlipFGy3Gwsk,3778
+plain2code_exceptions.py,sha256=UTFovKObkYuIOfknZcEISL06_V5JavnAJsR4rcTubsI,717
+plain2code_nodes.py,sha256=Om624mfb5MB1Z09c0Zqtb9G1gGkUY9x-v2hzAf3A2gw,3818
+plain2code_read_config.py,sha256=QnpbW_Bi9LzDIOubM5x7fVXH1HgiFL3-5Oa_O1EUoE4,2449
+plain2code_state.py,sha256=K1U9EoaGHboWEf5SVhSx3sN-ZvCEcAztV0q9dpj-2Zw,2570
+plain2code_utils.py,sha256=gxH8i-XHK-K9s9reBNose0UKYrH7oLjSsaEKMpLS1g0,2471
+plain_spec.py,sha256=SwjhdYuMJzwtF70ti7r5tVXogGbzvutu4U42u0AuKdU,13457
+system_config.py,sha256=mgHLn-CRHLO9Y9vKyI_eFBreY_YhFad-ctZgBYp-rIg,1777
+codeplain-0.1.0.dist-info/licenses/LICENSE,sha256=wsFi5dpbJurnRNfBj8q2RCcF3ryrmdRIfxc3lPcmc4c,1069
+config/__init__.py,sha256=iHrUksORYKKYsPhE2D_zvZ5tV7mfFAp16c_Cp38hT7A,38
+config/system_config.yaml,sha256=bB5Th5jxgXFyaIvceUPID1ReebMMXsyMibV4gtu9sWQ,1148
+render_machine/code_renderer.py,sha256=kHS_8uZEgQhygGvw0GBoA-V2nW8lIpoF1GJgyRw8oNk,2072
+render_machine/conformance_test_helpers.py,sha256=6Ru7Dh24SLNIKWfz_sP5hE_EmWpvk6nfgN1T1yaCZus,2887
+render_machine/implementation_code_helpers.py,sha256=XhjbQRn2mhfIXs1QioqFlopRfzUrY3U9DsFq38IFvic,816
+render_machine/render_context.py,sha256=OTlSwIqgt7UzMytSjQqqpAZTwjUE0l-eyCXJRpjii8E,13944
+render_machine/render_types.py,sha256=Ke1LzVXAY5XvJwMcY97C7gZniuRAgJRSCv4Flcfn-ig,1156
+render_machine/render_utils.py,sha256=ImqoIcGy9s4y3IF6BuAFOWZ4_10UB2CKBE6zf_pLd2M,4302
+render_machine/state_machine_config.py,sha256=9aQOcWesI-fQ9_BpicpQ3flzSTln18QBVsr_ZHi_3T0,26109
+render_machine/states.py,sha256=GvjGMYKYURKzTS7W2B8HOeDGt43z2AoKPcUv3FDnK9Q,1973
+render_machine/triggers.py,sha256=GarwIYPY6ZZzVdRF7yXLB54tofr08NpFZfp5DH6AOuI,1331
+render_machine/actions/analyze_specification_ambiguity.py,sha256=UsDQeOZI4l58rwZ9yjPtgB5-erz55HJvcjMrjMObV2I,2608
+render_machine/actions/base_action.py,sha256=vVzMp-LanrZyq-jamHyWaQxpRl-pLqtTdtiEzUBhfyE,534
+render_machine/actions/commit_conformance_tests_changes.py,sha256=3W-AnUFoukbN5U70PqsRwiL_wIoFwqsz6lM2TDoSy6k,2265
+render_machine/actions/commit_implementation_code_changes.py,sha256=5A55hESZGs-XXEZSPk7KvTeUmJWTOyG9IOIiuDEsv4Y,791
+render_machine/actions/create_dist.py,sha256=1t-DIZhtbajaLdtF05vsv4-MEuZpOxhBMX0EJ-TeCe0,1019
+render_machine/actions/exit_with_error.py,sha256=R0J1HPQtgHrVr8U5_r5uckXYzcuBFmsras5Avjh1Ra4,854
+render_machine/actions/fix_conformance_test.py,sha256=X8HWjMp8b0J2thB1rWqAefZkDTsViBUJi5BA65uui5A,6158
+render_machine/actions/fix_unit_tests.py,sha256=muabQEaWwzCoONjfGCMbODKZt5-xPLhfAAMD3O2AIs8,2448
+render_machine/actions/prepare_repositories.py,sha256=kjc12Q6FArn3Wg_r-SYioW6sZSbN0LSbpI_b4pFMXQY,2109
+render_machine/actions/prepare_testing_environment.py,sha256=J6GMclP07k7LuHrp5P7LOb4UJ7M3PAT1EWWLgKnAtHQ,1236
+render_machine/actions/refactor_code.py,sha256=NoPv04RWedFL0gehiOnBSGD-cy6DFEz0smeRO23f_Ts,2116
+render_machine/actions/render_conformance_tests.py,sha256=AvzdM6yV79kSLAV6m3VB3JYrBnOS0OXsV3G9SXK8Uw4,8034
+render_machine/actions/render_functional_requirement.py,sha256=Yq4r_LLmHLT1_SSK5uCuNWQV9baHzHA_bxNQJqNe58w,3389
+render_machine/actions/run_conformance_tests.py,sha256=DslNg5i4utlEkd4bmtDmTNxDye11n3juWzf6E95afMI,1900
+render_machine/actions/run_unit_tests.py,sha256=7xMiMrjW1yOJavI97huA4dj5hpNroxDZh2ASx4rcIoI,1561
+render_machine/actions/summarize_conformance_tests.py,sha256=mFU-GhOBGqhwDIMYlQtPUi4aUr-GJYPNXHeiK9U561g,1611
+standard_template_library/__init__.py,sha256=LtsHl0c3VV46DUInIqyOw4KKVoxKEMOx8dAZpMXtAXc,43
+standard_template_library/golang-console-app-template.plain,sha256=aPg2uhoNUFryVXzs0a2QjY82-uzftOgtrXNjDBAM8WU,1396
+standard_template_library/python-console-app-template.plain,sha256=5kqK5kErQ-Pa46iT3LVIYyBw68B8__CS-S4MoXkBx7Q,1432
+standard_template_library/typescript-react-app-template.plain,sha256=6JXLqQja17M7NbDEmk6pRltaD2m00OoDo6pJxuiv1Do,465
+codeplain-0.1.0.dist-info/METADATA,sha256=rJvrDgTtVlE6PoSfj7fCkdr9oGcOxJQC8jYJ-Y6WOfw,4974
+codeplain-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+codeplain-0.1.0.dist-info/entry_points.txt,sha256=oDZkBqu9WhtZApb_K6ia8-fn9aojwmAsgnKELceX5T4,46
+codeplain-0.1.0.dist-info/top_level.txt,sha256=wNGviii6Ojj3wNiGASr-QbTS8Xkiyux_nMeQJGL_OTE,536
+codeplain-0.1.0.dist-info/RECORD,,

codeplain-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

codeplain-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+codeplain = plain2code:main

codeplain-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Codeplain.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

codeplain-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,36 @@
+code_complexity
+codeplain
+codeplain_REST_api
+codeplain_constants
+codeplain_local_api
+codeplain_models
+codeplain_types
+codeplain_utils
+config
+content_extractor
+event_bus
+file_utils
+git_utils
+hash_key
+llm
+llm_exceptions
+llm_handler
+llm_selector
+plain2code
+plain2code_arguments
+plain2code_console
+plain2code_events
+plain2code_exceptions
+plain2code_nodes
+plain2code_read_config
+plain2code_state
+plain2code_tui
+plain2code_utils
+plain_file
+plain_spec
+render_cache
+render_machine
+spinner
+standard_template_library
+system_config
+tui_components

codeplain_REST_api.py

@@ -0,0 +1,370 @@
+import time
+from typing import Optional
+
+import requests
+from requests.exceptions import ConnectionError, RequestException, Timeout
+
+import plain2code_exceptions
+from plain2code_state import RunState
+
+MAX_RETRIES = 4
+RETRY_DELAY = 3
+
+
+class CodeplainAPI:
+
+    def __init__(self, api_key, console):
+        self.api_key = api_key
+        self.console = console
+
+    @property
+    def api_url(self):
+        return self._api_url
+
+    @api_url.setter
+    def api_url(self, value):
+        self._api_url = value
+
+    def _extend_payload_with_run_state(self, payload: dict, run_state: RunState):
+        run_state.increment_call_count()
+        payload["render_state"] = run_state.to_dict()
+
+    def post_request(self, endpoint_url, headers, payload, run_state: Optional[RunState]):  # noqa: C901
+        if run_state is not None:
+            self._extend_payload_with_run_state(payload, run_state)
+
+        retry_delay = RETRY_DELAY
+        for attempt in range(MAX_RETRIES + 1):
+            try:
+                response = requests.post(endpoint_url, headers=headers, json=payload)
+
+                try:
+                    response_json = response.json()
+                except requests.exceptions.JSONDecodeError as e:
+                    print(f"Failed to decode JSON response: {e}. Response text: {response.text}")
+                    raise
+
+                if response.status_code == requests.codes.bad_request and "error_code" in response_json:
+                    if response_json["error_code"] == "FunctionalRequirementTooComplex":
+                        raise plain2code_exceptions.FunctionalRequirementTooComplex(
+                            response_json["message"], response_json.get("proposed_breakdown")
+                        )
+
+                    if response_json["error_code"] == "ConflictingRequirements":
+                        raise plain2code_exceptions.ConflictingRequirements(response_json["message"])
+
+                    if response_json["error_code"] == "CreditBalanceTooLow":
+                        raise plain2code_exceptions.CreditBalanceTooLow(response_json["message"])
+
+                    if response_json["error_code"] == "LLMInternalError":
+                        raise plain2code_exceptions.LLMInternalError(response_json["message"])
+
+                    if response_json["error_code"] == "MissingResource":
+                        raise plain2code_exceptions.MissingResource(response_json["message"])
+
+                    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"])
+
+                    if response_json["error_code"] == "MultipleRendersFound":
+                        raise plain2code_exceptions.MultipleRendersFound(response_json["message"])
+
+                response.raise_for_status()
+                return response_json
+
+            except (ConnectionError, Timeout, RequestException) as e:
+                if attempt < MAX_RETRIES:
+                    self.console.info(f"Connection error on attempt {attempt + 1}/{MAX_RETRIES + 1}: {e}")
+                    self.console.info(f"Retrying in {retry_delay} seconds...")
+                    time.sleep(retry_delay)
+                    # Exponential backoff
+                    retry_delay *= 2
+                else:
+                    self.console.error(f"Max retries ({MAX_RETRIES}) exceeded. Last error: {e}")
+                    raise RequestException(
+                        f"Connection error: Unable to reach the Codeplain API at {self.api_url}. Please try again or contact support."
+                    )
+
+    def get_plain_source_tree(self, plain_source, loaded_templates, run_state: RunState):
+        """
+        Builds plain source tree from the given plain text source in Markdown format.
+
+        Args:
+            plain_source (str): A string containing the plain text source to be parsed.
+            loaded_templates (dict): A dictionary containing the loaded templates.
+
+        Returns:
+            dict: A plain source tree.
+
+        Raises:
+            Exception: If parsing of plain_source fails.
+        """
+        endpoint_url = f"{self.api_url}/plain_source_tree"
+        headers = {"X-API-Key": self.api_key, "Content-Type": "application/json"}
+
+        payload = {"plain_source": plain_source, "loaded_templates": loaded_templates}
+
+        return self.post_request(endpoint_url, headers, payload, run_state)
+
+    def render_functional_requirement(
+        self,
+        frid,
+        plain_source_tree,
+        linked_resources,
+        existing_files_content,
+        run_state: RunState,
+    ):
+        """
+        Renders the content of a functional requirement based on the provided ID,
+        plain source tree, and existing files' content.
+
+        Args:
+            frid (str): The unique identifier for the functional requirement to be rendered.
+            plain_source_tree (dict): A dictionary containing the plain source tree.
+            linked_resources (dict): A dictionary where the keys represent resource names
+                                    and the values are the content of those resources.
+            existing_files_content (dict): A dictionary where the keys represent code base
+                                        filenames and the values are the content of those files.
+
+        Returns:
+            str: A string containing the rendered functional requirement, formatted
+                appropriately based on the inputs.
+
+        Raises:
+            ValueError: If the frid is invalid or the necessary plain source tree is not valid.
+        """
+        endpoint_url = f"{self.api_url}/render_functional_requirement"
+        headers = {"X-API-Key": self.api_key, "Content-Type": "application/json"}
+
+        payload = {
+            "frid": frid,
+            "plain_source_tree": plain_source_tree,
+            "linked_resources": linked_resources,
+            "existing_files_content": existing_files_content,
+        }
+
+        return self.post_request(endpoint_url, headers, payload, run_state)
+
+    def fix_unittests_issue(
+        self,
+        frid,
+        plain_source_tree,
+        linked_resources,
+        existing_files_content,
+        unittests_issue,
+        run_state: RunState,
+    ):
+        endpoint_url = f"{self.api_url}/fix_unittests_issue"
+        headers = {"X-API-Key": self.api_key, "Content-Type": "application/json"}
+
+        payload = {
+            "frid": frid,
+            "plain_source_tree": plain_source_tree,
+            "linked_resources": linked_resources,
+            "existing_files_content": existing_files_content,
+            "unittests_issue": unittests_issue,
+            "unittest_batch_id": run_state.unittest_batch_id,
+        }
+
+        return self.post_request(endpoint_url, headers, payload, run_state)
+
+    def refactor_source_files_if_needed(self, frid, files_to_check, existing_files_content, run_state: RunState):
+        endpoint_url = f"{self.api_url}/refactor_source_files_if_needed"
+        headers = {"X-API-Key": self.api_key, "Content-Type": "application/json"}
+
+        payload = {
+            "frid": frid,
+            "files_to_check": list(files_to_check),
+            "existing_files_content": existing_files_content,
+        }
+
+        return self.post_request(endpoint_url, headers, payload, run_state)
+
+    def render_conformance_tests(
+        self,
+        frid,
+        functional_requirement_id,
+        plain_source_tree,
+        linked_resources,
+        existing_files_content,
+        conformance_tests_folder_name,
+        conformance_tests_json,
+        all_acceptance_tests,
+        run_state: RunState,
+    ):
+        endpoint_url = f"{self.api_url}/render_conformance_tests"
+        headers = {"X-API-Key": self.api_key, "Content-Type": "application/json"}
+
+        payload = {
+            "frid": frid,
+            "functional_requirement_id": functional_requirement_id,
+            "plain_source_tree": plain_source_tree,
+            "linked_resources": linked_resources,
+            "existing_files_content": existing_files_content,
+            "conformance_tests_folder_name": conformance_tests_folder_name,
+            "conformance_tests_json": conformance_tests_json,
+            "all_acceptance_tests": all_acceptance_tests,
+        }
+
+        response = self.post_request(endpoint_url, headers, payload, run_state)
+        return response["patched_response_files"], response["conformance_tests_plan_summary_string"]
+
+    def generate_folder_name_from_functional_requirement(
+        self,
+        frid,
+        functional_requirement,
+        existing_folder_names,
+        run_state: RunState,
+    ):
+        endpoint_url = f"{self.api_url}/generate_folder_name_from_functional_requirement"
+        headers = {"X-API-Key": self.api_key, "Content-Type": "application/json"}
+
+        payload = {
+            "frid": frid,
+            "functional_requirement": functional_requirement,
+            "existing_folder_names": existing_folder_names,
+        }
+
+        return self.post_request(endpoint_url, headers, payload, run_state)
+
+    def fix_conformance_tests_issue(
+        self,
+        frid,
+        functional_requirement_id,
+        plain_source_tree,
+        linked_resources,
+        existing_files_content,
+        code_diff,
+        conformance_tests_files,
+        acceptance_tests,
+        conformance_tests_issue,
+        implementation_fix_count,
+        conformance_tests_folder_name,
+        current_testing_frid_high_level_implementation_plan: Optional[str],
+        run_state: RunState,
+    ):
+        endpoint_url = f"{self.api_url}/fix_conformance_tests_issue"
+        headers = {"X-API-Key": self.api_key, "Content-Type": "application/json"}
+
+        payload = {
+            "frid": frid,
+            "functional_requirement_id": functional_requirement_id,
+            "plain_source_tree": plain_source_tree,
+            "linked_resources": linked_resources,
+            "existing_files_content": existing_files_content,
+            "code_diff": code_diff,
+            "conformance_tests_files": conformance_tests_files,
+            "conformance_tests_issue": conformance_tests_issue,
+            "implementation_fix_count": implementation_fix_count,
+            "conformance_tests_folder_name": conformance_tests_folder_name,
+            "current_testing_frid_high_level_implementation_plan": current_testing_frid_high_level_implementation_plan,
+        }
+
+        if acceptance_tests is not None:
+            payload["acceptance_tests"] = acceptance_tests
+
+        return self.post_request(endpoint_url, headers, payload, run_state)
+
+    def render_acceptance_tests(
+        self,
+        frid,
+        plain_source_tree,
+        linked_resources,
+        existing_files_content,
+        conformance_tests_files,
+        acceptance_test,
+        run_state: RunState,
+    ):
+        """
+        Renders acceptance tests based on the provided parameters.
+
+        Args:
+            frid (str): The unique identifier for the functional requirement.
+            plain_source_tree (dict): A dictionary containing the plain source tree.
+            linked_resources (dict): A dictionary where the keys represent resource names
+                                    and the values are the content of those resources.
+            existing_files_content (dict): A dictionary where the keys represent code base
+                                        filenames and the values are the content of those files.
+            conformance_tests_files (dict): A dictionary containing conformance test files.
+            acceptance_test (dict): A dictionary containing acceptance test information.
+
+        Returns:
+            dict: The rendered acceptance tests.
+
+        Raises:
+            Exception: If the request fails or returns an error.
+        """
+        endpoint_url = f"{self.api_url}/render_acceptance_tests"
+        headers = {"X-API-Key": self.api_key, "Content-Type": "application/json"}
+
+        payload = {
+            "frid": frid,
+            "plain_source_tree": plain_source_tree,
+            "linked_resources": linked_resources,
+            "existing_files_content": existing_files_content,
+            "conformance_tests_files": conformance_tests_files,
+            "acceptance_test": acceptance_test,
+        }
+
+        return self.post_request(endpoint_url, headers, payload, run_state)
+
+    def analyze_rendering(
+        self,
+        frid,
+        plain_source_tree,
+        linked_resources,
+        existing_files_content,
+        implementation_code_diff,
+        fixed_implementation_code_diff,
+        run_state: RunState,
+    ):
+        endpoint_url = f"{self.api_url}/analyze_rendering"
+        headers = {"X-API-Key": self.api_key, "Content-Type": "application/json"}
+
+        payload = {
+            "frid": frid,
+            "plain_source_tree": plain_source_tree,
+            "linked_resources": linked_resources,
+            "existing_files_content": existing_files_content,
+            "implementation_code_diff": implementation_code_diff,
+            "fixed_implementation_code_diff": fixed_implementation_code_diff,
+        }
+
+        return self.post_request(endpoint_url, headers, payload, run_state)
+
+    def finish_functional_requirement(self, frid, run_state: RunState):
+        endpoint_url = f"{self.api_url}/finish_functional_requirement"
+        headers = {"X-API-Key": self.api_key, "Content-Type": "application/json"}
+
+        payload = {
+            "frid": frid,
+        }
+
+        return self.post_request(endpoint_url, headers, payload, run_state)
+
+    def summarize_finished_conformance_tests(
+        self,
+        frid,
+        plain_source_tree,
+        linked_resources,
+        conformance_test_files_content,
+        run_state: RunState,
+    ):
+        endpoint_url = f"{self.api_url}/summarize_finished_conformance_tests"
+        headers = {"X-API-Key": self.api_key, "Content-Type": "application/json"}
+        payload = {
+            "frid": frid,
+            "plain_source_tree": plain_source_tree,
+            "linked_resources": linked_resources,
+            "conformance_test_files_content": conformance_test_files_content,
+        }
+
+        return self.post_request(endpoint_url, headers, payload, run_state)

config/__init__.py

@@ -0,0 +1,2 @@
+# Configuration files for plain2code
+

config/system_config.yaml

@@ -0,0 +1,27 @@
+system_requirements:
+  timeout:
+    command: timeout
+    error_message: |
+      Error: Required system command 'timeout' is not available.
+      This command is needed to enforce time limits on test execution.
+
+      To install the timeout command:
+      - On Linux: Install coreutils package
+        - Debian/Ubuntu: sudo apt-get install coreutils
+        - CentOS/RHEL: sudo yum install coreutils
+        - Fedora: sudo dnf install coreutils
+      - On macOS:
+        - Using Homebrew: brew install coreutils
+        - Using MacPorts: port install coreutils
+      - On Windows: Use Windows Subsystem for Linux (WSL), Cygwin, or Git Bash
+
+error_messages:
+  template_not_found:
+    message: |
+      The required template could not be found. Templates are searched in the following order (highest to lowest precedence):
+
+        1. The directory containing your .plain file
+        2. The directory specified by --template-dir (if provided)
+        3. The built-in 'standard_template_library' directory
+
+      Please ensure that the missing template exists in one of these locations, or specify the correct --template-dir if using custom templates.