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

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

@@ -1,31 +1,32 @@
 Metadata-Version: 2.4
 Name: codeplain
-Version: 0.2.1
+Version: 0.2.2
 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
-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
+Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: python-liquid2==0.3.0
-Requires-Dist: pyyaml==6.0.2
+Requires-Dist: mistletoe==1.3.0
 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: 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
+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
 
 # Codeplain plain2code renderer
 

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

@@ -1,17 +1,15 @@
 codeplain_REST_api.py,sha256=qfzUw9v0-NKII4ibw3vqSBrCeU2WP4RcrrEti43F3zs,18400
 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
 hash_key.py,sha256=lMKgKpOhPeC4UpFf9e7eCNK20FEaDsXTCJ8j3eCWidE,837
-memory_management.py,sha256=ABrM6PhOsalP_PBq2hCazQvQX9C5rpPHhgT35l68RM4,4357
 module_renderer.py,sha256=LLjLb34phSJlF2YblwGDy5HKWVdi9mo57rr7s-Hj3RA,6261
-plain2code.py,sha256=b0VJBnYVtpVZPx1TQZHNsnXREbhdW8V_S8TC-wWQqWw,8970
-plain2code_arguments.py,sha256=DHbkWyB33zifROt2SQMlGUC1AZIDJXoJQHlK7Za9b7U,12024
+plain2code.py,sha256=cIxPkxfxZkPlen5RG5H_rvo22sSGYQ9PnqSlw3ECVkY,9841
+plain2code_arguments.py,sha256=PdQjd3orklrtlEyz7-Qdz_m2SvjZtZp6dmbkqXgglSU,11826
 plain2code_console.py,sha256=-QorOFimS1AWYK7dmFqI3uhjc51cPtEWsaK4DhFibIw,4139
 plain2code_events.py,sha256=5fPhpRzgJ02xWh0MXqrMv9A4curr2UOE68Y1uKlAcqQ,1347
-plain2code_exceptions.py,sha256=UTFovKObkYuIOfknZcEISL06_V5JavnAJsR4rcTubsI,717
+plain2code_exceptions.py,sha256=Y_2Jmv9rLE5xMqlzp_mDcAIIYsIfS0yR1U3scXUzUng,760
 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
@@ -22,10 +20,9 @@ plain_modules.py,sha256=iDqqamtix5KahMC_v-vfQ7yndugmqtBW1z6XxTB4x6w,4876
 plain_spec.py,sha256=zC-VOb_UJOs8OxtEiwQJuonw7Lkmbi7YHyFvvCvUZNo,13529
 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
@@ -59,14 +56,6 @@ 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=N3f59hpxOO5zULdBtmXZM6KO2PKADoOL5d3WxNTUYXg,11106
-tests/test_plainfileparser.py,sha256=9B9r2jEeUKDMhqb4TJEPK7aatYl1op1z92GDAD4fJ20,18685
-tests/test_plainspec.py,sha256=ouS899oejStu8u1D3399y5NAxcKlNbLcinNoxZUp59M,2437
-tests/test_requires.py,sha256=u8wY-UI7Ryat84htaI0yFXpl-PjX7G90EnMKM35S6No,1182
 tui/__init__.py,sha256=_fy7FowY0RkWdn4kC7XV2jgvQPCj-2gE8fNUb-Mny0A,60
 tui/components.py,sha256=l7f-jLk0sj9WM8z2IpaHksmSyytXe_bl2GBdHASoIg4,13901
 tui/models.py,sha256=KMjlWubmPD41GA-BjgiqkaV9v7tLJ0fuWKBDPmZj4JA,1493
@@ -74,8 +63,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.1.dist-info/METADATA,sha256=UmRjTWg_BVVg4NqJRvOi_Rb6ldLR4EwZDU4X0TpNI3w,4278
-codeplain-0.2.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-codeplain-0.2.1.dist-info/entry_points.txt,sha256=oDZkBqu9WhtZApb_K6ia8-fn9aojwmAsgnKELceX5T4,46
-codeplain-0.2.1.dist-info/licenses/LICENSE,sha256=wsFi5dpbJurnRNfBj8q2RCcF3ryrmdRIfxc3lPcmc4c,1069
-codeplain-0.2.1.dist-info/RECORD,,
+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.1.dist-info → codeplain-0.2.2.dist-info}/WHEEL

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

codeplain-0.2.2.dist-info/top_level.txt

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

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 PlainSyntaxError
+from plain2code_exceptions import MissingAPIKey, PlainSyntaxError
 from plain2code_logger import (
     CrashLogHandler,
     IndentedFormatter,
@@ -161,6 +161,17 @@ def render(args, run_state: RunState, codeplain_api, event_bus: EventBus):  # no
 
     console.info(f"Rendering {args.filename} to target code.")
 
+    # Compute render range from either --render-range or --render-from
+    render_range = None
+    if args.render_range or args.render_from:
+        # Parse the plain file to get the plain_source for FRID extraction
+        _, plain_source, _ = plain_file.plain_file_parser(args.filename, template_dirs)
+
+        if args.render_range:
+            render_range = get_render_range(args.render_range, plain_source)
+        elif args.render_from:
+            render_range = get_render_range_from(args.render_from, plain_source)
+
     codeplainAPI = codeplain_api.CodeplainAPI(args.api_key, console)
     codeplainAPI.verbose = args.verbose
     assert args.api is not None and args.api != "", "API URL is required"
@@ -169,7 +180,7 @@ def render(args, run_state: RunState, codeplain_api, event_bus: EventBus):  # no
     module_renderer = ModuleRenderer(
         codeplainAPI,
         args.filename,
-        args.render_range,
+        render_range,
         template_dirs,
         args,
         run_state,
@@ -208,6 +219,12 @@ def main():
     run_state = RunState(spec_filename=args.filename, replay_with=args.replay_with)
 
     try:
+        # Validate API key is present
+        if not args.api_key:
+            raise MissingAPIKey(
+                "API key is required. Please set the CODEPLAIN_API_KEY environment variable or provide it with the --api-key argument."
+            )
+
         render(args, run_state, codeplain_api, event_bus)
     except InvalidFridArgument as e:
         console.error(f"Error rendering plain code: {str(e)}.\n")
@@ -237,6 +254,8 @@ def main():
         console.error(f"Error rendering plain code: {str(e)}\n")
         console.debug(f"Render ID: {run_state.render_id}")
         dump_crash_logs(args)
+    except MissingAPIKey as e:
+        console.error(f"Missing API key: {str(e)}\n")
     except Exception as e:
         console.error(f"Error rendering plain code: {str(e)}\n")
         console.debug(f"Render ID: {run_state.render_id}")

plain2code_arguments.py

@@ -5,10 +5,6 @@ import re
 from plain2code_read_config import get_args_from_config
 
 CODEPLAIN_API_KEY = os.getenv("CODEPLAIN_API_KEY")
-if not CODEPLAIN_API_KEY:
-    CLAUDE_API_KEY = os.getenv("CLAUDE_API_KEY")
-    if not CLAUDE_API_KEY:
-        raise ValueError("CODEPLAIN_API_KEY or CLAUDE_API_KEY environment variable is not set")
 
 
 DEFAULT_BUILD_FOLDER = "plain_modules"

plain2code_exceptions.py

@@ -43,3 +43,7 @@ class MultipleRendersFound(Exception):
 
 class UnexpectedState(Exception):
     pass
+
+
+class MissingAPIKey(Exception):
+    pass

diff_utils.py

@@ -1,32 +0,0 @@
-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

@@ -1,20 +0,0 @@
-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

@@ -1,17 +0,0 @@
-#!/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()

memory_management.py

@@ -1,97 +0,0 @@
-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)

tests/__init__.py

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

tests/conftest.py

@@ -1,34 +0,0 @@
-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