CEDARScript Editor (Python)

CEDARScript Editor (Python) is a CEDARScript runtime for interpreting CEDARScript scripts and performing code analysis and modification operations on a codebase.

CEDARScript enables offloading low-level code syntax and structure concerns, such as indentation and line counting, from the LLMs. The CEDARScript runtime bears the brunt of file editing by locating the exact line numbers and characters to change, which indentation levels to apply to each line and so on, allowing the CEDARScript commands to focus instead on higher levels of abstraction, like identifier names, line markers, relative indentations and positions (AFTER, BEFORE, INSIDE a function, its BODY, at the TOP or BOTTOM of it...).

It acts as an intermediary between the LLM and the codebase, handling the low-level details of code manipulation and allowing the AI to focus on higher-level tasks.

What is CEDARScript?

CEDARScript (Concise Examination, Development, And Refactoring Script) is a domain-specific language that aims to improve how AI coding assistants interact with codebases and communicate their code modification intentions.

It provides a standardized way to express complex code modification and analysis operations, making it easier for AI-assisted development tools to understand and execute these tasks.

Features

Given a CEDARScript script and a base directory, executes the script commands on files inside the base directory;
Return results in XML format for easier parsing and processing by LLM systems

Installation

You can install CEDARScript Editor using pip:

pip install cedarscript-editor

Usage

Here's a quick example of how to use CEDARScript Editor:

from cedarscript_editor import CEDARScriptEdior

parser = CEDARScriptEdior()
code = """
CREATE FILE "example.py"
UPDATE FILE "example.py"
    INSERT AT END OF FILE
        CONTENT
            print("Hello, World!")
        END CONTENT
END UPDATE
"""

commands, errors = parser.parse_script(code)

if errors:
    for error in errors:
        print(f"Error: {error}")
else:
    for command in commands:
        print(f"Parsed command: {command}")

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License.

Metadata

Release files for cedarscript-editor 1.3.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cedarscript-editor 1.3.5
File	Size	Uploaded
cedarscript_editor-1.3.5.tar.gz	206.5 kB	Dec 12, 2024	Details

Built distribution (wheel)

Table of built distributions (wheels) for cedarscript-editor 1.3.5
File	Interpreter	ABI	Platform	Reset
cedarscript_editor-1.3.5-py3-none-any.whl 33.8 kB Dec 12, 2024	Python 3	none	any	Details

Total release size: 240.3 kB

Release files / cedarscript_editor-1.3.5.tar.gz

Download URL	cedarscript_editor-1.3.5.tar.gz
Size	206.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`205abd2056b1aa3ec4b388bf79c4333f4ef66ce59bb2ac81e0f99127abd14a10`
BLAKE2b-256 checksum How to use checksums	`9f97b23f7ae4756b544770fe2b144b3af67a4004f6bd8861afb2cb6a17f63d66`
Upload date	Dec 12, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.0.1 CPython/3.12.7`

Release files / cedarscript_editor-1.3.5-py3-none-any.whl

Download URL	cedarscript_editor-1.3.5-py3-none-any.whl
Size	33.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`96e14d317fd761f14282ad4f91a2d5a9e132e1eef8a40ac1ba9d3eba88ce41c1`
BLAKE2b-256 checksum How to use checksums	`dc3a4ca85299068524dbc75b30205f3a509981e6887475a435462994c3e0d83e`
Upload date	Dec 12, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.0.1 CPython/3.12.7`