<!------------------------------------------------------------------------------ 이 파일은 컴파일러 프런트엔드 기반 기술인 "Lady Deirdre"의 일부입니다. 본 작업물은 소스 코드가 공개된 독점 소프트웨어(proprietary software)입니다. 본 작업을 복사, 사용, 배포 또는 기여하려면 다음 일반 라이선스 계약(General License Agreement)의 조건에 동의해야 합니다: https://github.com/Eliah-Lakhin/lady-deirdre/blob/master/EULA.md 본 계약은 기본 상업 라이선스(Basic Commercial License)를 부여하여, 총 매출액 한도 내에서 비상업적 및 제한적 상업 제품에 본 작업을 사용할 수 있도록 합니다. 귀하의 제품 중 하나에 대한 이 상업적 제한을 제거하려면 전체 상업 라이선스(Full Commercial License)를 획득해야 합니다. 소스 코드, 문서 또는 관련 자료에 기여하는 경우, 저에게 해당 기여물에 대한 독점 라이선스를 부여해야 합니다. 기여물은 일반 라이선스 계약의 "기여물(Contributions)" 섹션에 의해 규율됩니다. 일반 라이선스 계약에서 허용하는 경우를 제외하고는 본 작업을 부분적으로 복사하는 것은 엄격히 금지됩니다. 본 계약의 조건에 동의하지 않거나 동의할 수 없다면, 이 작업을 사용하지 마십시오. 본 작업물은 법적으로 무효화되는 경우를 제외하고는 어떠한 보증(warranty), 명시적 또는 묵시적 보증 없이 "있는 그대로(as is)" 제공됩니다. Copyright (c) 2024 Ilya Lakhin (Илья Александрович Лахин). 모든 권리 보유. ------------------------------------------------------------------------------->

Lady Deirdre

Crate

API Docs

User Guide

Examples

<img align="right" height="220" style="float: right; margin-left: 10px; width: 220px" alt="Lady Deirdre Logo" src="https://raw.githubusercontent.com/Eliah-Lakhin/lady-deirdre/master/work/logo.png" />

Lady Deirdre는 증분 프로그래밍 언어 컴파일러, 인터프리터 및 소스 코드 분석기(source code analyzers)를 위한 프레임워크입니다.

이 프레임워크는 언어 컴파일러 또는 인터프리터 역할을 하고, 코드 에디터의 언어 확장(language extension)을 위한 언어 서버(language server) 역할도 하는 하이브리드 프로그램을 개발하는 데 도움을 줍니다. 이 프레임워크는 소스 코드, 해당 어휘 및 구문(lexis and syntax), 그리고 전체 코드베이스의 의미론적 모델(semantic model)을 포함하여 언어 파일의 메모리 내 표현(in-memory representation)을 생성하는 데 필요한 구성 요소들을 제공합니다. 이러한 구성 요소들은 코드베이스가 실시간으로 지속적으로 진화함에 따라, 메모리 내 표현이 파일 변경 사항과 동기화되도록 특별히 설계되었습니다.

Lady Deirdre는 새로운 프로그래밍 언어 프로젝트를 시작하고 싶을 때 완벽한 도구입니다.

주요 기능 (Key Features)

• 매크로를 사용한 파서 생성기 (Parser Generator Using Macros).
  언어의 어휘 및 구문 문법(Lexical and syntax grammar)은 derive 매크로를 사용하여 열거형(enum) 타입에 지정하며, 여기서 열거형 변형(variants)들은 개별 토큰과 파싱 규칙을 가진 노드를 나타냅니다.

• 수동 작성 파서 (Hand-Written Parsers).
  이 API는 무한한 전방 탐색(unlimited lookahead) 기능을 갖춘 수동 재귀 하강 파서(hand-written recursive-descent parsers)를 개발하고, 이를 매크로 생성 파서와 원활하게 통합할 수 있도록 지원합니다.

• 오류 복원성 (Error Resilience).
  결과 파서는 오류에 강하며 불완전한 소스 코드로부터 구문 트리(syntax tree)를 구축할 수 있습니다.

• 의미론 분석 프레임워크 (Semantics Analysis Framework).
  Lady Deirdre는 참조 속성(referential attributes) 측면에서 구문 트리에 대한 임의의 온디맨드 계산을 관리하는 내장 의미론 분석기(built-in semantic analyzer)를 포함합니다.

• 증분 컴파일 (Incremental Compilation).
  이러한 구성 요소들은 최종 사용자의 파일 텍스트 증분 편집(incremental edits)에 반응하여 코드베이스 구조의 메모리 내 표현을 지속적으로 패치합니다. 변경 사항 처리는 일반적으로 대규모 코드베이스에서도 빠릅니다.

• 병렬 계산 (Parallel Computations).
  이 API는 사용자의 재량에 따라 멀티스레드(multi-threaded) 및 싱글스레드(single-threaded) 프로그램 모두를 위해 특별히 설계되었습니다.

• Web-Assembly 호환성 (Web-Assembly Compatibility).
  이 크레이트(crate)는 wasm-targets와 특히 브라우저 환경과 호환됩니다.

• 소스 코드 포맷터 (Source Code Formatters).

Lady Deirdre는 코드 주석(code comments)과 빈 줄(blank lines)을 고려하는 코드 포맷터 프로그램(code formatter programs)을 개발할 수 있는 도구를 포함합니다.

• 주석이 달린 스니펫 (Annotated Snippets).
  이 프레임워크는 구문 강조(syntax highlighting)와 주석(annotations)이 포함된 소스 코드 스니펫을 터미널에 출력하기 위한 구성 가능한 API를 제공하며, 이는 코드베이스 내의 구문 및 의미적 오류(syntax and semantic errors)를 표시하는 데 사용됩니다.

• 독립적인 API (Self-Sufficient API).
  이 크레이트(crate)는 프로그래밍 언어 컴파일러와 코드 에디터 언어 확장(code editor language extensions)의 프런트엔드 부분을 개발하기 위한 독립적이고, 확장 가능하며, 고도로 구성 가능한 API를 제공합니다. 기반 기술로서 Lady Deirdre는 Rust 표준 라이브러리(Rust standard library)와 macros 크레이트를 제외하고는 외부 종속성(third-party dependencies)을 갖지 않습니다.

성능 (Performance)

Lady Deirdre는 프로덕션 사용에 적합한 허용 가능한 계산 성능을 가진 개발 인프라를 제공하는 것을 목표로 합니다.

이 크레이트의 API는 프레임워크의 개별 기능을 Rust 생태계(Rust ecosystem)의 전문 솔루션과 비교하여 견고한 벤치마크 테스트 결과(benchmark test results)를 보여줍니다.

자세한 정보는 Benchmarks 페이지를 참조하십시오.

링크 (Links)

• 소스 코드 (Source Code)
• 메인 크레이트 (Main Crate)
• API 문서화 (API Documentation)
• 사용자 가이드 (User Guide)
• 예제 (Examples)
• 라이선스 계약 (License Agreement)

저작권 (Copyright)

본 작업은 소스 코드가 공개된(source-available) 독점 소프트웨어입니다.

이 작업의 복사, 사용, 배포 또는 기여를 하려면 일반 라이선스 계약 (General License Agreement)의 약관에 동의해야 합니다.

라이선싱 조건에 대한 설명은 F.A.Q.를 참조하십시오.

© Copyright (c) 2024 Ilya Lakhin (Илья Александрович Лахин). 모든 권리 보유.