codeplain 0.3.13.dev46__tar.gz → 0.3.13.dev48__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/PKG-INFO +2 -2
- codeplain-0.3.13.dev48/concept_utils.py +3 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/file_utils.py +6 -106
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/plain2code.py +39 -6
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/plain2code_arguments.py +30 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/plain2code_exceptions.py +12 -42
- codeplain-0.3.13.dev48/plain2code_nodes.py +3 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/plain2code_state.py +6 -2
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/plain2code_utils.py +1 -16
- codeplain-0.3.13.dev48/plain_file.py +3 -0
- codeplain-0.3.13.dev48/plain_spec.py +37 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/pyproject.toml +6 -3
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/requirements.txt +5 -2
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_arg_provenance.py +20 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_file_utils.py +1 -70
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_plain2code_state.py +5 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_render_finished_report.py +1 -0
- codeplain-0.3.13.dev48/tests/test_render_range.py +42 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_terminal_attachment.py +1 -0
- codeplain-0.3.13.dev48/tests/test_user_error_message.py +36 -0
- codeplain-0.3.13.dev46/concept_utils.py +0 -221
- codeplain-0.3.13.dev46/plain2code_nodes.py +0 -119
- codeplain-0.3.13.dev46/plain_file.py +0 -871
- codeplain-0.3.13.dev46/plain_spec.py +0 -441
- codeplain-0.3.13.dev46/tests/data/imports/circular_imports_1.plain +0 -8
- codeplain-0.3.13.dev46/tests/data/imports/circular_imports_2.plain +0 -8
- codeplain-0.3.13.dev46/tests/data/imports/circular_imports_main.plain +0 -12
- codeplain-0.3.13.dev46/tests/data/imports/diamond_import_1.plain +0 -16
- codeplain-0.3.13.dev46/tests/data/imports/diamond_import_2.plain +0 -16
- codeplain-0.3.13.dev46/tests/data/imports/diamond_import_common.plain +0 -11
- codeplain-0.3.13.dev46/tests/data/imports/diamond_imports_main.plain +0 -13
- codeplain-0.3.13.dev46/tests/data/imports/import_with_functionalities.plain +0 -7
- codeplain-0.3.13.dev46/tests/data/imports/imports_module_with_functionalities.plain +0 -12
- codeplain-0.3.13.dev46/tests/data/imports/non_existent_import.plain +0 -12
- codeplain-0.3.13.dev46/tests/data/plainfile/add_new_task_modal_specification.yaml +0 -1
- codeplain-0.3.13.dev46/tests/data/plainfile/duplicate_specification_heading.plain +0 -7
- codeplain-0.3.13.dev46/tests/data/plainfile/empty_functional_specs_section.plain +0 -4
- codeplain-0.3.13.dev46/tests/data/plainfile/invalid_specification_order.plain +0 -7
- codeplain-0.3.13.dev46/tests/data/plainfile/missing_non_functional_requirements.plain +0 -5
- codeplain-0.3.13.dev46/tests/data/plainfile/no_functional_specs_section.plain +0 -5
- codeplain-0.3.13.dev46/tests/data/plainfile/plain_source_with_absolute_link.plain +0 -9
- codeplain-0.3.13.dev46/tests/data/plainfile/plain_source_with_missing_link.plain +0 -9
- codeplain-0.3.13.dev46/tests/data/plainfile/plain_source_with_url_link.plain +0 -9
- codeplain-0.3.13.dev46/tests/data/plainfile/task_list_ui_specification.yaml +0 -1
- codeplain-0.3.13.dev46/tests/data/plainfile/task_manager_with_reference_links.plain +0 -40
- codeplain-0.3.13.dev46/tests/data/plainfile/without_non_functional_requirement.plain +0 -5
- codeplain-0.3.13.dev46/tests/data/plainfileparser/concept_validation_acceptance_tests.plain +0 -20
- codeplain-0.3.13.dev46/tests/data/plainfileparser/concept_validation_acceptance_tests_nondefined.plain +0 -20
- codeplain-0.3.13.dev46/tests/data/plainfileparser/concept_validation_defined_nondefined.plain +0 -18
- codeplain-0.3.13.dev46/tests/data/plainfileparser/concept_validation_defined_nondefined_2.plain +0 -18
- codeplain-0.3.13.dev46/tests/data/plainfileparser/concept_validation_definition.plain +0 -16
- codeplain-0.3.13.dev46/tests/data/plainfileparser/concept_validation_noconcepts.plain +0 -18
- codeplain-0.3.13.dev46/tests/data/plainfileparser/concept_validation_nonconcept.plain +0 -15
- codeplain-0.3.13.dev46/tests/data/plainfileparser/concept_validation_nondefined.plain +0 -18
- codeplain-0.3.13.dev46/tests/data/plainfileparser/concept_validation_redefinition.plain +0 -19
- codeplain-0.3.13.dev46/tests/data/plainfileparser/concept_validation_several_concepts.plain +0 -13
- codeplain-0.3.13.dev46/tests/data/plainfileparser/concept_validation_valid.plain +0 -16
- codeplain-0.3.13.dev46/tests/data/plainfileparser/cyclic_definitions.plain +0 -9
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts.plain +0 -13
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_base.plain +0 -2
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_defaults_exported.plain +0 -13
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_example.plain +0 -13
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_imported_exported.plain +0 -12
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_inherited_reexported.plain +0 -15
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_malformed.plain +0 -13
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_missing_definition.plain +0 -14
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_missing_definition_example.plain +0 -13
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_multiple_per_bullet.plain +0 -14
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_multiple_per_bullet_undefined.plain +0 -13
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_nested.plain +0 -15
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_nested_example.plain +0 -13
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_no_definitions.plain +0 -10
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_not_declared.plain +0 -8
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_not_declared_example.plain +0 -13
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_transitive_example.plain +0 -13
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_transitive_l1.plain +0 -13
- codeplain-0.3.13.dev46/tests/data/plainfileparser/exported_concepts_transitive_l2.plain +0 -13
- codeplain-0.3.13.dev46/tests/data/plainfileparser/plain_file_parser_with_comments.plain +0 -8
- codeplain-0.3.13.dev46/tests/data/plainfileparser/plain_file_with_comments_indented.plain +0 -10
- codeplain-0.3.13.dev46/tests/data/plainfileparser/regular_plain_source.plain +0 -11
- codeplain-0.3.13.dev46/tests/data/plainfileparser/required_concepts.plain +0 -7
- codeplain-0.3.13.dev46/tests/data/plainfileparser/required_concepts_defs.plain +0 -2
- codeplain-0.3.13.dev46/tests/data/plainfileparser/required_concepts_example.plain +0 -13
- codeplain-0.3.13.dev46/tests/data/plainfileparser/required_concepts_l1.plain +0 -7
- codeplain-0.3.13.dev46/tests/data/plainfileparser/required_concepts_l2.plain +0 -5
- codeplain-0.3.13.dev46/tests/data/plainfileparser/required_concepts_missing.plain +0 -10
- codeplain-0.3.13.dev46/tests/data/plainfileparser/required_concepts_module.plain +0 -11
- codeplain-0.3.13.dev46/tests/data/plainfileparser/required_concepts_partial.plain +0 -13
- codeplain-0.3.13.dev46/tests/data/plainfileparser/required_concepts_partial_duplicate.plain +0 -14
- codeplain-0.3.13.dev46/tests/data/plainfileparser/requires_without_definitions_example.plain +0 -10
- codeplain-0.3.13.dev46/tests/data/plainfileparser/topological_sort.plain +0 -14
- codeplain-0.3.13.dev46/tests/data/plainfileparser/topological_sort_not_referenced.plain +0 -22
- codeplain-0.3.13.dev46/tests/data/requires/circular_requires_main.plain +0 -18
- codeplain-0.3.13.dev46/tests/data/requires/circular_requires_sub.plain +0 -12
- codeplain-0.3.13.dev46/tests/data/requires/diamond_requires_1.plain +0 -12
- codeplain-0.3.13.dev46/tests/data/requires/diamond_requires_2.plain +0 -12
- codeplain-0.3.13.dev46/tests/data/requires/diamond_requires_common.plain +0 -7
- codeplain-0.3.13.dev46/tests/data/requires/diamond_requires_main.plain +0 -19
- codeplain-0.3.13.dev46/tests/data/requires/independent_requires_1.plain +0 -7
- codeplain-0.3.13.dev46/tests/data/requires/independent_requires_2.plain +0 -7
- codeplain-0.3.13.dev46/tests/data/requires/independent_requires_main.plain +0 -19
- codeplain-0.3.13.dev46/tests/data/requires/non_existent_require.plain +0 -18
- codeplain-0.3.13.dev46/tests/data/requires/normal_requires_1.plain +0 -12
- codeplain-0.3.13.dev46/tests/data/requires/normal_requires_2.plain +0 -12
- codeplain-0.3.13.dev46/tests/data/requires/normal_requires_common.plain +0 -7
- codeplain-0.3.13.dev46/tests/data/requires/normal_requires_main.plain +0 -19
- codeplain-0.3.13.dev46/tests/data/sample_base64_image.txt +0 -1
- codeplain-0.3.13.dev46/tests/data/simple.plain +0 -7
- codeplain-0.3.13.dev46/tests/data/templates/block_level_include.plain +0 -12
- codeplain-0.3.13.dev46/tests/data/templates/code_variables.plain +0 -10
- codeplain-0.3.13.dev46/tests/data/templates/header.plain +0 -7
- codeplain-0.3.13.dev46/tests/data/templates/implement.plain +0 -3
- codeplain-0.3.13.dev46/tests/data/templates/implement_2.plain +0 -3
- codeplain-0.3.13.dev46/tests/data/templates/template_include.plain +0 -4
- codeplain-0.3.13.dev46/tests/data/templates/test_hardest_problem.plain +0 -2
- codeplain-0.3.13.dev46/tests/test_imports.py +0 -53
- codeplain-0.3.13.dev46/tests/test_plainfile.py +0 -271
- codeplain-0.3.13.dev46/tests/test_plainfileparser.py +0 -775
- codeplain-0.3.13.dev46/tests/test_plainspec.py +0 -103
- codeplain-0.3.13.dev46/tests/test_requires.py +0 -28
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/.claude/settings.json +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/.flake8 +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/.github/dependabot.yml +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/.github/workflows/e2e.yml +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/.github/workflows/lint-and-test.yml +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/.github/workflows/lint-powershell.yml +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/.github/workflows/notify-slack-on-main-merge.yml +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/.github/workflows/publish-dev-to-pypi.yml +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/.github/workflows/publish-install-script.yml +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/.github/workflows/publish-to-pypi.yml +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/.gitignore +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/.vscode/launch.json +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/.vscode/settings.json +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/CLAUDE.md +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/CONTRIBUTING.md +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/LICENSE +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/README.md +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/change_detection.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/cli_output/__init__.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/cli_output/dry_run.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/cli_output/render_summary.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/cli_output/status.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/codeplain_REST_api.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/config/__init__.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/config/system_config.yaml +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/conformance_fix_journal.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/diff_utils.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/docs/generate_cli.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/docs/plain2code_cli.md +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/docs/starting_a_plain_project_from_scratch.md +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/event_bus.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/example_hello_world_golang/config.yaml +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/example_hello_world_golang/harness_tests/hello_world_test.go +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/example_hello_world_golang/hello_world_golang.plain +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/example_hello_world_golang/run.sh +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/example_hello_world_python/config.yaml +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/example_hello_world_python/harness_tests/hello_world_display/test_hello_world.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/example_hello_world_python/hello_world_python.plain +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/example_hello_world_python/run.sh +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/example_hello_world_react/config.yaml +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/example_hello_world_react/harness_tests/hello_world_display/cypress/e2e/hello_world.cy.ts +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/example_hello_world_react/harness_tests/hello_world_display/cypress/support/e2e.ts +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/example_hello_world_react/harness_tests/hello_world_display/cypress.config.ts +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/example_hello_world_react/harness_tests/hello_world_display/package.json +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/example_hello_world_react/harness_tests/hello_world_display/tsconfig.json +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/example_hello_world_react/hello_world_react.plain +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/example_hello_world_react/run.sh +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/examples/run.sh +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/git_preflight.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/git_utils.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/install/bash/examples.sh +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/install/bash/install.sh +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/install/bash/walkthrough.sh +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/install/powershell/examples.ps1 +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/install/powershell/install.ps1 +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/install/powershell/walkthrough.ps1 +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/memory_management.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/metadata_utils.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/module_renderer.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/partial_rendering.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/path_resolution.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/plain2code_cli.md +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/plain2code_console.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/plain2code_events.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/plain2code_logger.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/plain2code_read_config.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/plain2code_telemetry.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/plain_modules.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/pytest.ini +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/__init__.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/analyze_specification_ambiguity.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/base_action.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/commit_conformance_tests_changes.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/commit_implementation_code_changes.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/create_dist.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/distill_conformance_test_memory.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/exit_with_error.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/finish_functional_requirement.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/fix_conformance_test.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/fix_unit_tests.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/prepare_repositories.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/prepare_testing_environment.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/refactor_code.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/render_conformance_tests.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/render_functional_requirement.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/run_conformance_tests.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/run_unit_tests.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/actions/summarize_conformance_tests.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/agent_tools.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/code_renderer.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/conformance_tests.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/implementation_code_helpers.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/render_context.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/render_types.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/render_utils.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/state_machine_config.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/states.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/render_machine/triggers.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/resources/codeplain_overview.png +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/resources/plain_example.png +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/standard_template_library/golang-console-app-template.plain +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/standard_template_library/python-console-app-template.plain +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/standard_template_library/typescript-react-app-boilerplate.plain +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/standard_template_library/typescript-react-app-template.plain +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/system_config.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/test_scripts/run_conformance_tests_cypress.ps1 +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/test_scripts/run_conformance_tests_cypress.sh +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/test_scripts/run_conformance_tests_golang.ps1 +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/test_scripts/run_conformance_tests_golang.sh +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/test_scripts/run_conformance_tests_python.ps1 +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/test_scripts/run_conformance_tests_python.sh +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/test_scripts/run_unittests_flutter.ps1 +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/test_scripts/run_unittests_flutter.sh +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/test_scripts/run_unittests_golang.ps1 +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/test_scripts/run_unittests_golang.sh +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/test_scripts/run_unittests_python.ps1 +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/test_scripts/run_unittests_python.sh +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/test_scripts/run_unittests_react.ps1 +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/test_scripts/run_unittests_react.sh +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/__init__.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/conftest.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/data/acceptance_tests_warning/main_requiring_acceptance_tests.plain +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/data/acceptance_tests_warning/required_with_acceptance_tests.plain +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/data/partial_rendering/pr_code_var.plain +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/data/partial_rendering/pr_implement.plain +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/data/partial_rendering/pr_leaf.plain +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/data/partial_rendering/pr_middle.plain +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/data/partial_rendering/pr_root.plain +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/data/partial_rendering/pr_solo.plain +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/e2e/Dockerfile +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/e2e/conftest.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/e2e/test_hello_world_python.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/e2e/test_hello_world_python_windows.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_agent_tools.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_change_detection.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_cli_output.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_conformance_fix_journal.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_console_log_styles.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_distill_conformance_test_memory.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_dry_run_link_validation.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_fix_unit_tests_action.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_fix_unit_tests_conformance_context.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_folder_path_resolution.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_git_preflight.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_git_utils.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_headless_logging.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_log_file_name_resolution.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_logging_config_path_resolution.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_partial_rendering.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_path_resolution.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_plain2code.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_plain2code_utils.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_plain_modules.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_prepare_repositories_layout.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_render_stop_reason.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_resolve_config_file.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_script_path_resolution.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_system_config.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_telemetry.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_tui_components.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_tui_usage.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tests/test_usage_summary.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tui/__init__.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tui/components.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tui/models.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tui/plain2code_tui.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tui/plain_module_render_choice_tui.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tui/spinner.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tui/state_handlers.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tui/styles.css +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/tui/widget_helpers.py +0 -0
- {codeplain-0.3.13.dev46 → codeplain-0.3.13.dev48}/usage_summary.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: codeplain
|
|
3
|
-
Version: 0.3.13.
|
|
3
|
+
Version: 0.3.13.dev48
|
|
4
4
|
Summary: Transform plain language specifications into working code
|
|
5
5
|
License-File: LICENSE
|
|
6
6
|
Classifier: Environment :: Console
|
|
@@ -10,7 +10,7 @@ Classifier: Topic :: Software Development :: Code Generators
|
|
|
10
10
|
Requires-Python: ==3.11.*
|
|
11
11
|
Requires-Dist: gitpython==3.2.1
|
|
12
12
|
Requires-Dist: mistletoe==1.6.0
|
|
13
|
-
Requires-Dist:
|
|
13
|
+
Requires-Dist: plain-parser==0.1.4
|
|
14
14
|
Requires-Dist: python-frontmatter==1.3.0
|
|
15
15
|
Requires-Dist: python-liquid2==0.4.0
|
|
16
16
|
Requires-Dist: pyyaml==6.0.3
|
|
@@ -3,14 +3,14 @@ import shutil
|
|
|
3
3
|
import stat
|
|
4
4
|
from pathlib import Path
|
|
5
5
|
|
|
6
|
-
from
|
|
7
|
-
|
|
6
|
+
from plain_parser.loaders import ( # noqa: F401
|
|
7
|
+
TrackingFileSystemLoader,
|
|
8
|
+
get_loaded_templates,
|
|
9
|
+
load_linked_resources,
|
|
10
|
+
open_from,
|
|
11
|
+
)
|
|
8
12
|
|
|
9
|
-
import plain_spec
|
|
10
13
|
from plain2code_console import console
|
|
11
|
-
from plain2code_exceptions import UnsupportedBase64Content, UnsupportedResourceType
|
|
12
|
-
from plain2code_nodes import Plain2CodeIncludeTag, Plain2CodeLoaderMixin
|
|
13
|
-
from plain2code_utils import find_large_base64_blob
|
|
14
14
|
from plain_modules import CODEPLAIN_MEMORY_SUBFOLDER, CODEPLAIN_METADATA_FOLDER
|
|
15
15
|
|
|
16
16
|
BINARY_FILE_EXTENSIONS = [".pyc"]
|
|
@@ -183,106 +183,6 @@ def store_response_files(target_folder, response_files, existing_files):
|
|
|
183
183
|
return existing_files
|
|
184
184
|
|
|
185
185
|
|
|
186
|
-
def open_from(dirs, file_name):
|
|
187
|
-
for dir in dirs:
|
|
188
|
-
full_file_name = os.path.join(dir, file_name)
|
|
189
|
-
if not os.path.isfile(full_file_name):
|
|
190
|
-
continue
|
|
191
|
-
|
|
192
|
-
with open(full_file_name, "rb") as f:
|
|
193
|
-
content = f.read()
|
|
194
|
-
return content.decode("utf-8")
|
|
195
|
-
|
|
196
|
-
return None
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
def resolve_linked_resource(dirs, file_name):
|
|
200
|
-
"""Return the first existing path for file_name across dirs, or None if not found.
|
|
201
|
-
|
|
202
|
-
Mirrors the search order used by open_from so that validating a linked resource and
|
|
203
|
-
loading it can never disagree.
|
|
204
|
-
"""
|
|
205
|
-
for dir in dirs:
|
|
206
|
-
full_file_name = os.path.join(dir, file_name)
|
|
207
|
-
if os.path.exists(full_file_name):
|
|
208
|
-
return full_file_name
|
|
209
|
-
|
|
210
|
-
return None
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
def load_linked_resources(template_dirs: list[str], resources_list, module_name: str):
|
|
214
|
-
linked_resources = {}
|
|
215
|
-
|
|
216
|
-
for resource in resources_list:
|
|
217
|
-
file_name = resource["target"]
|
|
218
|
-
if file_name in linked_resources:
|
|
219
|
-
continue
|
|
220
|
-
|
|
221
|
-
try:
|
|
222
|
-
content = open_from(template_dirs, file_name)
|
|
223
|
-
except UnicodeDecodeError:
|
|
224
|
-
raise UnsupportedResourceType(
|
|
225
|
-
f"Referenced resource '{file_name}' in module '{module_name}' is a binary file. "
|
|
226
|
-
f"Only text files (e.g. .md, .txt, .json, .yaml) can be referenced from a .plain file."
|
|
227
|
-
)
|
|
228
|
-
|
|
229
|
-
if content is None:
|
|
230
|
-
raise FileNotFoundError(f"""
|
|
231
|
-
Resource file {file_name} not found. Resource files are searched in the following order (highest to lowest precedence):
|
|
232
|
-
|
|
233
|
-
1. The directory containing your .plain file
|
|
234
|
-
2. The directory specified by --template-dir (if provided)
|
|
235
|
-
3. The built-in 'standard_template_library' directory
|
|
236
|
-
|
|
237
|
-
Please ensure that the resource exists in one of these locations, or specify the correct --template-dir if using custom templates.
|
|
238
|
-
""")
|
|
239
|
-
|
|
240
|
-
blob = find_large_base64_blob(content)
|
|
241
|
-
if blob is not None:
|
|
242
|
-
raise UnsupportedBase64Content(
|
|
243
|
-
f"Referenced resource '{file_name}' in module '{module_name}' contains a large "
|
|
244
|
-
f"base64-encoded blob ({len(blob)} characters), such as an embedded image. Inline "
|
|
245
|
-
"base64 data is not supported. Remove the data from the resource. "
|
|
246
|
-
"If the data should be used by the end software, "
|
|
247
|
-
"save the data to a separate file and include the file path in the specification without it being a reference file."
|
|
248
|
-
)
|
|
249
|
-
|
|
250
|
-
linked_resources[file_name] = content
|
|
251
|
-
|
|
252
|
-
return linked_resources
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
class TrackingFileSystemLoader(Plain2CodeLoaderMixin, FileSystemLoader):
|
|
256
|
-
def __init__(self, *args, **kwargs):
|
|
257
|
-
super().__init__(*args, **kwargs)
|
|
258
|
-
self.loaded_templates = {}
|
|
259
|
-
|
|
260
|
-
def get_source(self, environment, template_name, **kwargs):
|
|
261
|
-
source = super().get_source(environment, template_name, **kwargs)
|
|
262
|
-
self.loaded_templates[template_name] = source.source
|
|
263
|
-
return source
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
def get_loaded_templates(source_path, plain_source):
|
|
267
|
-
# Render the plain source with Liquid templating engine
|
|
268
|
-
# to identify the templates that are being loaded
|
|
269
|
-
|
|
270
|
-
liquid_loader = TrackingFileSystemLoader(source_path)
|
|
271
|
-
liquid_env = Environment(loader=liquid_loader, undefined=StrictUndefined)
|
|
272
|
-
liquid_env.tags["include"] = Plain2CodeIncludeTag(liquid_env)
|
|
273
|
-
|
|
274
|
-
liquid_env.filters["code_variable"] = plain_spec.code_variable_liquid_filter
|
|
275
|
-
liquid_env.filters["prohibited_chars"] = plain_spec.prohibited_chars_liquid_filter
|
|
276
|
-
|
|
277
|
-
plain_source_template = liquid_env.from_string(plain_source)
|
|
278
|
-
try:
|
|
279
|
-
plain_source = plain_source_template.render()
|
|
280
|
-
except UndefinedError as e:
|
|
281
|
-
raise Exception(f"Undefined liquid variable: {str(e)}")
|
|
282
|
-
|
|
283
|
-
return plain_source, liquid_loader.loaded_templates
|
|
284
|
-
|
|
285
|
-
|
|
286
186
|
def update_build_folder_with_rendered_files(build_folder, existing_files, response_files):
|
|
287
187
|
changed_files = set()
|
|
288
188
|
changed_files.update(response_files.keys())
|
|
@@ -59,6 +59,39 @@ from tui.plain2code_tui import Plain2CodeTUI
|
|
|
59
59
|
from tui.plain_module_render_choice_tui import PlainModuleRenderChoiceTUI
|
|
60
60
|
|
|
61
61
|
DEFAULT_TEMPLATE_DIRS = "standard_template_library"
|
|
62
|
+
|
|
63
|
+
# Search-order guidance appended to lookup failures raised by the parser, which only
|
|
64
|
+
# reports the missing file. The wording is the CLI's: it knows what the template
|
|
65
|
+
# directories are and how the user changes them.
|
|
66
|
+
TEMPLATE_NOT_FOUND_HINT = f"""
|
|
67
|
+
The required template could not be found. Templates are searched in the following order (highest to lowest precedence):
|
|
68
|
+
|
|
69
|
+
1. The directory containing your .plain file
|
|
70
|
+
2. The directory specified by --template-dir (if provided)
|
|
71
|
+
3. The built-in '{DEFAULT_TEMPLATE_DIRS}' directory
|
|
72
|
+
|
|
73
|
+
Please ensure that the missing template exists in one of these locations, or specify the correct --template-dir if using custom templates.
|
|
74
|
+
"""
|
|
75
|
+
|
|
76
|
+
RESOURCE_NOT_FOUND_HINT = f""" Resource files are searched in the following order (highest to lowest precedence):
|
|
77
|
+
|
|
78
|
+
1. The directory containing your .plain file
|
|
79
|
+
2. The directory specified by --template-dir (if provided)
|
|
80
|
+
3. The built-in '{DEFAULT_TEMPLATE_DIRS}' directory
|
|
81
|
+
|
|
82
|
+
Please ensure that the resource exists in one of these locations, or specify the correct --template-dir if using custom templates."""
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
def user_error_message(e: BaseException) -> str:
|
|
86
|
+
"""Format an exception for the user, appending search-order guidance to lookup failures."""
|
|
87
|
+
message = str(e) if str(e) else repr(e)
|
|
88
|
+
if isinstance(e, TemplateNotFoundError):
|
|
89
|
+
return message + TEMPLATE_NOT_FOUND_HINT
|
|
90
|
+
if isinstance(e, FileNotFoundError):
|
|
91
|
+
return message + RESOURCE_NOT_FOUND_HINT
|
|
92
|
+
return message
|
|
93
|
+
|
|
94
|
+
|
|
62
95
|
RENDER_THREAD_SHUTDOWN_TIMEOUT = 0.7
|
|
63
96
|
|
|
64
97
|
# The terminal states a render can reach, as the API names them.
|
|
@@ -371,7 +404,7 @@ def render( # noqa: C901
|
|
|
371
404
|
except Exception as e:
|
|
372
405
|
run_state.set_render_succeeded(False)
|
|
373
406
|
render_error.append(e)
|
|
374
|
-
event_bus.publish(RenderFailed(error_message=
|
|
407
|
+
event_bus.publish(RenderFailed(error_message=user_error_message(e)))
|
|
375
408
|
|
|
376
409
|
if args.headless:
|
|
377
410
|
console.info(f"Render started. Render ID: {run_state.render_id}")
|
|
@@ -446,7 +479,7 @@ def main(): # noqa: C901
|
|
|
446
479
|
console.info("Full plain text:\n")
|
|
447
480
|
console.info(full_plain_source)
|
|
448
481
|
except Exception as e:
|
|
449
|
-
console.error(f"Error: {
|
|
482
|
+
console.error(f"Error: {user_error_message(e)}")
|
|
450
483
|
return
|
|
451
484
|
|
|
452
485
|
# Parse the plain file (and its required modules) once; reused by dry-run and rendering.
|
|
@@ -457,14 +490,14 @@ def main(): # noqa: C901
|
|
|
457
490
|
template_dirs,
|
|
458
491
|
)
|
|
459
492
|
except Exception as e:
|
|
460
|
-
console.error(f"Error: {
|
|
493
|
+
console.error(f"Error: {user_error_message(e)}")
|
|
461
494
|
return
|
|
462
495
|
|
|
463
496
|
if args.dry_run:
|
|
464
497
|
try:
|
|
465
498
|
validate_linked_resources(plain_module)
|
|
466
499
|
except Exception as e:
|
|
467
|
-
console.error(f"Error: {
|
|
500
|
+
console.error(f"Error: {user_error_message(e)}")
|
|
468
501
|
return
|
|
469
502
|
|
|
470
503
|
console.info("Printing dry run output...\n")
|
|
@@ -482,7 +515,7 @@ def main(): # noqa: C901
|
|
|
482
515
|
codeplainAPI = codeplain_api.CodeplainAPI(args.api_key, console)
|
|
483
516
|
codeplainAPI.api_url = args.api
|
|
484
517
|
|
|
485
|
-
run_state = RunState(spec_filename=args.filename, replay_with=args.replay_with)
|
|
518
|
+
run_state = RunState(spec_filename=args.filename, replay_with=args.replay_with, job_tag=args.job_tag)
|
|
486
519
|
|
|
487
520
|
# Without a terminal nobody can watch or drive the TUI, so render as --headless does:
|
|
488
521
|
# progress on stdout, and a non-zero exit status when the render stops.
|
|
@@ -517,7 +550,7 @@ def main(): # noqa: C901
|
|
|
517
550
|
error_message = "Keyboard interrupt"
|
|
518
551
|
interrupted = True
|
|
519
552
|
else:
|
|
520
|
-
error_message =
|
|
553
|
+
error_message = user_error_message(e)
|
|
521
554
|
|
|
522
555
|
if not isinstance(e, EXPECTED_EXCEPTIONS):
|
|
523
556
|
exc_info = sys.exc_info()
|
|
@@ -19,6 +19,7 @@ CODEPLAIN_API_KEY = os.getenv("CODEPLAIN_API_KEY")
|
|
|
19
19
|
DEFAULT_BUILD_FOLDER = "plain_modules"
|
|
20
20
|
DEFAULT_BUILD_DEST = "dist"
|
|
21
21
|
DEFAULT_CONFORMANCE_TESTS_DEST = "dist_conformance_tests"
|
|
22
|
+
MAX_JOB_TAG_LENGTH = 300
|
|
22
23
|
|
|
23
24
|
UNIT_TESTS_SCRIPT_NAME = "unittests_script"
|
|
24
25
|
CONFORMANCE_TESTS_SCRIPT_NAME = "conformance_tests_script"
|
|
@@ -76,6 +77,15 @@ def non_empty_string(s):
|
|
|
76
77
|
return s
|
|
77
78
|
|
|
78
79
|
|
|
80
|
+
def job_tag_string(s):
|
|
81
|
+
s = str(s)
|
|
82
|
+
if not s:
|
|
83
|
+
raise argparse.ArgumentTypeError("The job tag cannot be empty.")
|
|
84
|
+
if len(s) > MAX_JOB_TAG_LENGTH:
|
|
85
|
+
raise argparse.ArgumentTypeError(f"The job tag cannot be longer than {MAX_JOB_TAG_LENGTH} characters.")
|
|
86
|
+
return s
|
|
87
|
+
|
|
88
|
+
|
|
79
89
|
def frid_string(s):
|
|
80
90
|
"""Validate that the FRID is an integer."""
|
|
81
91
|
if not s:
|
|
@@ -363,6 +373,15 @@ def create_parser():
|
|
|
363
373
|
help="",
|
|
364
374
|
)
|
|
365
375
|
|
|
376
|
+
_add_arg(
|
|
377
|
+
parser,
|
|
378
|
+
"--job-tag",
|
|
379
|
+
type=job_tag_string,
|
|
380
|
+
default=None,
|
|
381
|
+
help=f"Tag sent to the server with every request and attached to the render's LangSmith traces "
|
|
382
|
+
f"(max {MAX_JOB_TAG_LENGTH} characters).",
|
|
383
|
+
)
|
|
384
|
+
|
|
366
385
|
_add_arg(
|
|
367
386
|
parser,
|
|
368
387
|
"--template-dir",
|
|
@@ -450,6 +469,15 @@ def create_parser():
|
|
|
450
469
|
return parser
|
|
451
470
|
|
|
452
471
|
|
|
472
|
+
def _validate_job_tag(args, parser):
|
|
473
|
+
# Values from config.yaml bypass argparse's type conversion, so validate them here.
|
|
474
|
+
if args.job_tag is not None:
|
|
475
|
+
try:
|
|
476
|
+
args.job_tag = job_tag_string(args.job_tag)
|
|
477
|
+
except argparse.ArgumentTypeError as e:
|
|
478
|
+
parser.error(f"--job-tag: {e}")
|
|
479
|
+
|
|
480
|
+
|
|
453
481
|
def parse_arguments(command_line: Optional[Sequence[str]] = None):
|
|
454
482
|
parser = create_parser()
|
|
455
483
|
|
|
@@ -496,6 +524,8 @@ def parse_arguments(command_line: Optional[Sequence[str]] = None):
|
|
|
496
524
|
if not args.log_to_file and args.argument_sources.get("log_file_name") != "default":
|
|
497
525
|
parser.error("--log-file-name cannot be used when --log-to-file is False.")
|
|
498
526
|
|
|
527
|
+
_validate_job_tag(args, parser)
|
|
528
|
+
|
|
499
529
|
if args.full_plain and args.dry_run:
|
|
500
530
|
parser.error("--full-plain and --dry-run are mutually exclusive")
|
|
501
531
|
|
|
@@ -1,3 +1,15 @@
|
|
|
1
|
+
from plain_parser.exceptions import ( # noqa: F401
|
|
2
|
+
ImportedModuleWithFunctionalitiesError,
|
|
3
|
+
InvalidFridArgument,
|
|
4
|
+
InvalidLiquidVariableName,
|
|
5
|
+
MissingFunctionalitiesError,
|
|
6
|
+
ModuleDoesNotExistError,
|
|
7
|
+
PlainSyntaxError,
|
|
8
|
+
UnsupportedBase64Content,
|
|
9
|
+
UnsupportedResourceType,
|
|
10
|
+
)
|
|
11
|
+
|
|
12
|
+
|
|
1
13
|
class FunctionalRequirementTooComplex(Exception):
|
|
2
14
|
def __init__(self, message, proposed_breakdown=None):
|
|
3
15
|
self.message = message
|
|
@@ -21,19 +33,6 @@ class MissingResource(Exception):
|
|
|
21
33
|
pass
|
|
22
34
|
|
|
23
35
|
|
|
24
|
-
class UnsupportedResourceType(Exception):
|
|
25
|
-
pass
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
class PlainSyntaxError(Exception):
|
|
29
|
-
pass
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
class UnsupportedBase64Content(Exception):
|
|
33
|
-
|
|
34
|
-
pass
|
|
35
|
-
|
|
36
|
-
|
|
37
36
|
class InternalClientError(Exception):
|
|
38
37
|
pass
|
|
39
38
|
|
|
@@ -50,24 +49,12 @@ class OutdatedClientVersion(Exception):
|
|
|
50
49
|
pass
|
|
51
50
|
|
|
52
51
|
|
|
53
|
-
class InvalidFridArgument(Exception):
|
|
54
|
-
pass
|
|
55
|
-
|
|
56
|
-
|
|
57
52
|
class InvalidGitRepositoryError(Exception):
|
|
58
53
|
"""Raised when the git repository is in an invalid state."""
|
|
59
54
|
|
|
60
55
|
pass
|
|
61
56
|
|
|
62
57
|
|
|
63
|
-
class InvalidLiquidVariableName(Exception):
|
|
64
|
-
pass
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
class ModuleDoesNotExistError(Exception):
|
|
68
|
-
pass
|
|
69
|
-
|
|
70
|
-
|
|
71
58
|
class InternalServerError(Exception):
|
|
72
59
|
pass
|
|
73
60
|
|
|
@@ -78,23 +65,6 @@ class MissingPreviousFunctionalitiesError(Exception):
|
|
|
78
65
|
pass
|
|
79
66
|
|
|
80
67
|
|
|
81
|
-
class MissingFunctionalitiesError(Exception):
|
|
82
|
-
"""Raised when a module to be rendered has no functionalities specified at all."""
|
|
83
|
-
|
|
84
|
-
pass
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
class ImportedModuleWithFunctionalitiesError(Exception):
|
|
88
|
-
"""Raised when a module brought in via ``import`` contains functional specs.
|
|
89
|
-
|
|
90
|
-
This is a usage error, not a syntax error: the module is syntactically valid
|
|
91
|
-
and would be fine as a render target, but functionalities are not allowed in
|
|
92
|
-
the import role.
|
|
93
|
-
"""
|
|
94
|
-
|
|
95
|
-
pass
|
|
96
|
-
|
|
97
|
-
|
|
98
68
|
class NetworkConnectionError(Exception):
|
|
99
69
|
"""Raised when there is a network connectivity issue with the API server."""
|
|
100
70
|
|
|
@@ -8,7 +8,7 @@ from typing import Optional
|
|
|
8
8
|
class RunState:
|
|
9
9
|
"""Contains information about the identifiable state of the rendering process."""
|
|
10
10
|
|
|
11
|
-
def __init__(self, spec_filename: str, replay_with: Optional[str] = None):
|
|
11
|
+
def __init__(self, spec_filename: str, replay_with: Optional[str] = None, job_tag: Optional[str] = None):
|
|
12
12
|
self.replay: bool = replay_with is not None
|
|
13
13
|
self.render_succeeded: bool = False
|
|
14
14
|
self.render_cancelled: bool = False
|
|
@@ -19,6 +19,7 @@ class RunState:
|
|
|
19
19
|
else:
|
|
20
20
|
self.render_id: str = str(uuid.uuid4())
|
|
21
21
|
self.spec_filename: str = spec_filename
|
|
22
|
+
self.job_tag: Optional[str] = job_tag
|
|
22
23
|
self.call_count: int = 0
|
|
23
24
|
self.unittest_batch_id: int = 0
|
|
24
25
|
self.render_time_accumulated: int = 0
|
|
@@ -70,9 +71,12 @@ class RunState:
|
|
|
70
71
|
self.last_render_start_timestamp = time.monotonic()
|
|
71
72
|
|
|
72
73
|
def to_dict(self):
|
|
73
|
-
|
|
74
|
+
state = {
|
|
74
75
|
"render_id": self.render_id,
|
|
75
76
|
"call_count": self.call_count,
|
|
76
77
|
"replay": self.replay,
|
|
77
78
|
"spec_filename": self.spec_filename,
|
|
78
79
|
}
|
|
80
|
+
if self.job_tag is not None:
|
|
81
|
+
state["job_tag"] = self.job_tag
|
|
82
|
+
return state
|
|
@@ -1,19 +1,4 @@
|
|
|
1
|
-
import
|
|
2
|
-
from typing import Optional
|
|
3
|
-
|
|
4
|
-
#
|
|
5
|
-
MAX_BASE64_BLOB_LENGTH = 8192
|
|
6
|
-
|
|
7
|
-
# Matches a long contiguous base64 / base64url run, optionally preceded by a data: URI header.
|
|
8
|
-
_BASE64_BLOB_PATTERN = re.compile(
|
|
9
|
-
r"(?:data:[\w.+-]+/[\w.+-]+;base64,)?[A-Za-z0-9+/_-]{%d,}={0,2}" % MAX_BASE64_BLOB_LENGTH
|
|
10
|
-
)
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
def find_large_base64_blob(text: str) -> Optional[str]:
|
|
14
|
-
"""Return the first contiguous base64 blob at or above the threshold, or None."""
|
|
15
|
-
match = _BASE64_BLOB_PATTERN.search(text)
|
|
16
|
-
return match.group(0) if match else None
|
|
1
|
+
from plain_parser.loaders import MAX_BASE64_BLOB_LENGTH, find_large_base64_blob # noqa: F401
|
|
17
2
|
|
|
18
3
|
|
|
19
4
|
def format_duration_hms(total_seconds: float) -> str:
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
"""Compatibility shim: the parser now lives in the ``plain-parser`` package.
|
|
2
|
+
|
|
3
|
+
The render-range helpers below stay here because they read codeplain's CLI
|
|
4
|
+
arguments (``--render-range`` / ``--render-from``); the FRID slicing they wrap
|
|
5
|
+
is ``plain_parser.plain_spec.get_frids_range``.
|
|
6
|
+
"""
|
|
7
|
+
|
|
8
|
+
from plain_parser.plain_spec import * # noqa: F401,F403
|
|
9
|
+
from plain_parser.plain_spec import get_frids_range
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
def get_render_range(render_range, plain_source):
|
|
13
|
+
render_range = render_range.split(",")
|
|
14
|
+
range_end = render_range[1] if len(render_range) == 2 else render_range[0]
|
|
15
|
+
|
|
16
|
+
return get_frids_range(plain_source, render_range[0], range_end)
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
def get_render_range_from(start, plain_source):
|
|
20
|
+
return get_frids_range(plain_source, start)
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
def compute_render_range(args, plain_source_tree):
|
|
24
|
+
"""Compute render range from --render-range or --render-from arguments.
|
|
25
|
+
|
|
26
|
+
Args:
|
|
27
|
+
args: Parsed command line arguments
|
|
28
|
+
plain_source_tree: Parsed plain source tree
|
|
29
|
+
|
|
30
|
+
Returns:
|
|
31
|
+
List of FRIDs to render, or None to render all
|
|
32
|
+
"""
|
|
33
|
+
if args.render_range:
|
|
34
|
+
return get_render_range(args.render_range, plain_source_tree)
|
|
35
|
+
elif args.render_from:
|
|
36
|
+
return get_render_range_from(args.render_from, plain_source_tree)
|
|
37
|
+
return None
|
|
@@ -15,8 +15,13 @@ classifiers = [
|
|
|
15
15
|
"Topic :: Software Development :: Code Generators",
|
|
16
16
|
]
|
|
17
17
|
dependencies = [
|
|
18
|
-
"
|
|
18
|
+
"plain-parser==0.1.4",
|
|
19
|
+
|
|
20
|
+
# Both transitive via plain-parser; pinned so an automatic mistletoe upgrade doesn't change spec hashes.
|
|
19
21
|
"mistletoe==1.6.0",
|
|
22
|
+
"python-frontmatter==1.3.0",
|
|
23
|
+
|
|
24
|
+
"python-liquid2==0.4.0",
|
|
20
25
|
"requests==2.34.2",
|
|
21
26
|
"tiktoken==0.14.0",
|
|
22
27
|
"PyYAML==6.0.3",
|
|
@@ -24,8 +29,6 @@ dependencies = [
|
|
|
24
29
|
"transitions==0.9.3",
|
|
25
30
|
"textual>=7.5.0",
|
|
26
31
|
"rich==15.0.0",
|
|
27
|
-
"python-frontmatter==1.3.0",
|
|
28
|
-
"networkx==3.6.1",
|
|
29
32
|
"sentry-sdk==2.73.0",
|
|
30
33
|
]
|
|
31
34
|
|
|
@@ -1,6 +1,10 @@
|
|
|
1
|
-
|
|
1
|
+
plain-parser==0.1.4
|
|
2
|
+
|
|
3
|
+
# Both transitive via plain-parser; pinned so an automatic mistletoe upgrade doesn't change spec hashes.
|
|
2
4
|
mistletoe==1.6.0
|
|
3
5
|
python-frontmatter==1.3.0
|
|
6
|
+
|
|
7
|
+
python-liquid2==0.4.0
|
|
4
8
|
requests==2.34.2
|
|
5
9
|
rich==15.0.0
|
|
6
10
|
tiktoken==0.14.0
|
|
@@ -8,7 +12,6 @@ PyYAML==6.0.3
|
|
|
8
12
|
gitpython==3.2.1
|
|
9
13
|
pytest==9.1.1
|
|
10
14
|
textual>=7.5.0
|
|
11
|
-
networkx==3.6.1
|
|
12
15
|
transitions==0.9.3
|
|
13
16
|
sentry-sdk==2.73.0
|
|
14
17
|
|
|
@@ -87,3 +87,23 @@ def test_mixed_sources(project):
|
|
|
87
87
|
assert srcs["conformance_tests_dest"] == "cli"
|
|
88
88
|
assert srcs["build_folder"] == "config"
|
|
89
89
|
assert srcs["build_dest"] == "default"
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
def test_job_tag_from_cli_and_config(project):
|
|
93
|
+
plain_file = os.path.join(project, "module.plain")
|
|
94
|
+
assert parse_arguments([plain_file]).job_tag is None
|
|
95
|
+
assert parse_arguments([plain_file, "--job-tag", "nightly"]).job_tag == "nightly"
|
|
96
|
+
|
|
97
|
+
(Path(project) / "config.yaml").write_text("job-tag: 123\n")
|
|
98
|
+
assert parse_arguments([plain_file]).job_tag == "123"
|
|
99
|
+
assert parse_arguments([plain_file, "--job-tag", "from_cli"]).job_tag == "from_cli"
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
def test_job_tag_too_long_is_rejected(project):
|
|
103
|
+
plain_file = os.path.join(project, "module.plain")
|
|
104
|
+
with pytest.raises(SystemExit):
|
|
105
|
+
parse_arguments([plain_file, "--job-tag", "x" * 301])
|
|
106
|
+
|
|
107
|
+
(Path(project) / "config.yaml").write_text(f"job-tag: {'x' * 301}\n")
|
|
108
|
+
with pytest.raises(SystemExit):
|
|
109
|
+
parse_arguments([plain_file])
|
|
@@ -5,9 +5,7 @@ import pytest
|
|
|
5
5
|
|
|
6
6
|
import file_utils
|
|
7
7
|
from diff_utils import get_code_diff
|
|
8
|
-
from file_utils import get_existing_files_content,
|
|
9
|
-
from plain2code_exceptions import UnsupportedBase64Content, UnsupportedResourceType
|
|
10
|
-
from plain2code_utils import MAX_BASE64_BLOB_LENGTH
|
|
8
|
+
from file_utils import get_existing_files_content, store_response_files
|
|
11
9
|
|
|
12
10
|
|
|
13
11
|
@pytest.fixture
|
|
@@ -16,73 +14,6 @@ def template_dir():
|
|
|
16
14
|
yield d
|
|
17
15
|
|
|
18
16
|
|
|
19
|
-
def test_load_linked_resources_text_file(template_dir):
|
|
20
|
-
file_path = os.path.join(template_dir, "notes.md")
|
|
21
|
-
with open(file_path, "w") as f:
|
|
22
|
-
f.write("# hello")
|
|
23
|
-
|
|
24
|
-
result = load_linked_resources([template_dir], [{"text": "Notes", "target": "notes.md"}], "my_thing")
|
|
25
|
-
|
|
26
|
-
assert result == {"notes.md": "# hello"}
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
def test_load_linked_resources_binary_file_raises_unsupported_resource_type(template_dir):
|
|
30
|
-
file_path = os.path.join(template_dir, "icon.png")
|
|
31
|
-
with open(file_path, "wb") as f:
|
|
32
|
-
f.write(b"\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\xff\xfe\xfd")
|
|
33
|
-
|
|
34
|
-
with pytest.raises(UnsupportedResourceType) as exc_info:
|
|
35
|
-
load_linked_resources([template_dir], [{"text": "Icon", "target": "icon.png"}], "my_thing")
|
|
36
|
-
|
|
37
|
-
assert "icon.png" in str(exc_info.value)
|
|
38
|
-
assert "binary file" in str(exc_info.value)
|
|
39
|
-
assert "my_thing" in str(exc_info.value)
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
def test_load_linked_resources_missing_file_raises_file_not_found(template_dir):
|
|
43
|
-
with pytest.raises(FileNotFoundError):
|
|
44
|
-
load_linked_resources([template_dir], [{"text": "Missing", "target": "missing.md"}], "my_thing")
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
def test_load_linked_resources_base64_blob_raises(template_dir):
|
|
48
|
-
file_path = os.path.join(template_dir, "request.txt")
|
|
49
|
-
with open(file_path, "w") as f:
|
|
50
|
-
f.write("curl -d 'selfie_image=" + "A" * (MAX_BASE64_BLOB_LENGTH + 100) + "'")
|
|
51
|
-
|
|
52
|
-
with pytest.raises(UnsupportedBase64Content) as exc_info:
|
|
53
|
-
load_linked_resources([template_dir], [{"text": "Request", "target": "request.txt"}], "my_thing")
|
|
54
|
-
|
|
55
|
-
assert "request.txt" in str(exc_info.value)
|
|
56
|
-
assert "my_thing" in str(exc_info.value)
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
def test_load_linked_resources_small_base64_allowed(template_dir):
|
|
60
|
-
file_path = os.path.join(template_dir, "token.txt")
|
|
61
|
-
with open(file_path, "w") as f:
|
|
62
|
-
f.write("token=" + "A" * (MAX_BASE64_BLOB_LENGTH - 100))
|
|
63
|
-
|
|
64
|
-
result = load_linked_resources([template_dir], [{"text": "Token", "target": "token.txt"}], "my_thing")
|
|
65
|
-
|
|
66
|
-
assert "token.txt" in result
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
def test_load_linked_resources_real_base64_image_raises(template_dir):
|
|
70
|
-
# Real base64-encoded JPEG that made Gemini 3 fail, inlined into a curl example resource.
|
|
71
|
-
sample_path = os.path.join(os.path.dirname(__file__), "data", "sample_base64_image.txt")
|
|
72
|
-
with open(sample_path) as f:
|
|
73
|
-
blob = f.read()
|
|
74
|
-
|
|
75
|
-
file_path = os.path.join(template_dir, "face_match_request.txt")
|
|
76
|
-
with open(file_path, "w") as f:
|
|
77
|
-
f.write(f"curl -d 'selfie_image={blob}' https://example.com/face-match")
|
|
78
|
-
|
|
79
|
-
with pytest.raises(UnsupportedBase64Content) as exc_info:
|
|
80
|
-
load_linked_resources([template_dir], [{"text": "Request", "target": "face_match_request.txt"}], "face_match")
|
|
81
|
-
|
|
82
|
-
assert "face_match_request.txt" in str(exc_info.value)
|
|
83
|
-
assert str(len(blob)) in str(exc_info.value)
|
|
84
|
-
|
|
85
|
-
|
|
86
17
|
def test_store_response_files_writes_unicode_as_utf8(template_dir):
|
|
87
18
|
"""A non-cp1252 character (📍 U+1F4CD) is written as UTF-8, whatever the platform's default encoding."""
|
|
88
19
|
content = "Location 📍 marker\n"
|
|
@@ -34,3 +34,8 @@ def test_add_to_render_time_is_cumulative_across_segments():
|
|
|
34
34
|
run_state.add_to_render_time()
|
|
35
35
|
|
|
36
36
|
assert run_state.render_time_accumulated == 7
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
def test_to_dict_includes_job_tag_only_when_set():
|
|
40
|
+
assert "job_tag" not in RunState(spec_filename="x.plain").to_dict()
|
|
41
|
+
assert RunState(spec_filename="x.plain", job_tag="nightly").to_dict()["job_tag"] == "nightly"
|