A library for executing CEDARScript, a SQL-like language for code analysis and transformations
Project description
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file cedarscript_editor-1.2.1.tar.gz
.
File metadata
- Download URL: cedarscript_editor-1.2.1.tar.gz
- Upload date:
- Size: 200.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | f5edc768bcc35909527daa8853a65428462cc89c885c4fa83e9422133479865f |
|
MD5 | c068656ba9bbb1cedf8383b956a854de |
|
BLAKE2b-256 | fabaf060c9b607dd9012545386876184496caf5e93293810b0a75fef42d11ebe |
File details
Details for the file cedarscript_editor-1.2.1-py3-none-any.whl
.
File metadata
- Download URL: cedarscript_editor-1.2.1-py3-none-any.whl
- Upload date:
- Size: 31.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 203e68864a62f8c7f15f4b6fc0c4d29141b2ada609ca7dcd7ef5968025985079 |
|
MD5 | ee7b5ee20ec83fa873590104dc9a995a |
|
BLAKE2b-256 | 6489d2fda1ddded80d349aa04f95f97287f37528166937084bc9cc1614e1c04e |