Skip to main content

A library for parsing and interpreting CEDARScript, a SQL-like language for code analysis and transformations

Project description

CEDARScript AST Parser

PyPI version Python Versions Code style: black AGPL v3

CEDARScript AST Parser is a Python library for parsing and interpreting CEDARScript, a SQL-like language designed for concise code analysis, manipulation, and refactoring 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

  • Parse CEDARScript Abstract Syntax Tree (AST) that was generated by Tree-Sitter into a list of commands
  • Support for various code manipulation and analysis commands (CREATE, UPDATE, RM, MV, SELECT)
  • Return results in XML format for easier parsing and processing by LLM systems

Installation

You can install CEDARScript Parser using pip:

pip install cedarscript-ast-parser

Usage

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

from cedarscript_ast_parser import CEDARScriptASTParser

parser = CEDARScriptASTParser()
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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cedarscript_ast_parser-0.5.4.tar.gz (26.8 kB view details)

Uploaded Source

Built Distribution

cedarscript_ast_parser-0.5.4-py3-none-any.whl (23.0 kB view details)

Uploaded Python 3

File details

Details for the file cedarscript_ast_parser-0.5.4.tar.gz.

File metadata

File hashes

Hashes for cedarscript_ast_parser-0.5.4.tar.gz
Algorithm Hash digest
SHA256 b359037c1ddf035326df1f8182c7ae7c7da8433e327c5488a0bc9282b8677112
MD5 fab67eb44bebdcf4bdaa89c63220b474
BLAKE2b-256 ebe471c499fbc43347a408a25faecb6fa5d5e21e66bdc611a3839a3a0965798b

See more details on using hashes here.

File details

Details for the file cedarscript_ast_parser-0.5.4-py3-none-any.whl.

File metadata

File hashes

Hashes for cedarscript_ast_parser-0.5.4-py3-none-any.whl
Algorithm Hash digest
SHA256 d5f05d60a3e5e90344d64cfc810544122b3a3f997a3f19cc6c3fe51210001c93
MD5 0c86bb148bb89dbfb3526a7a664d9cb6
BLAKE2b-256 9a97be5f07e127b1d3825fb1b8f7f2a2c91bbe901c29da61ae24c88301b442c9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page