Skip to content
ziiumPublic

About

한국어 문장 구조를 중심에 둔 메시지 지향 프로그래밍 언어 (Rust 구현)

Resources

Stars

40 stars

Watchers

2 watching

Forks

Latest commit

 

History

66 Commits

Folders and files

Repository files navigation

지음 (ziium)

한국어 문장 구조를 중심에 둔 프로그래밍 언어

한글 키워드 번역이 아니라, 한국어 화자가 읽고 쓰는 흐름에 가까운 코드를 만든다.

License: MIT Version Rust 2024

웹사이트 · Playground · 문법 명세 · 예제 모음


이름은 "철수"이다.
나이는 20이다.

나이 > 19이면
  "성인이다"를 출력한다.
아니면
  "미성년자이다"를 출력한다.

왜 만드는가

  • 한국어 화자가 코드를 읽을 때 겪는 언어적 이질감을 줄인다.
  • 자연스러운 한국어 문장 흐름을 일부 보존할 수 있는지 검증한다.
  • AI 에이전트와 사람이 같은 명세로 언어 구현을 함께 진행할 수 있게 한다.

핵심 방향

원칙 설명
한국어다운 문장 표면은 한국어 문장형, 내부 표현은 엄격
예측 가능한 문법 자연어 이해가 아니라 명시적 규칙
조사는 문법 요소 을/를, 에, 으로 등은 장식이 아니라 의미 구분자
통제된 기호 사용 표현식 내부에서 일부 기호 연산 허용

맛보기

인사만들기 함수는 이름을 받아
  "안녕, " + 이름 + "!"을 돌려준다.

문장은 "지음"으로 인사만들기이다.
문장을 출력한다.
그림판에 { 배경색: "#f6efe2" }으로 지우기.
그림판에 { x: 120, y: 80, 색: 빨강 }으로 점찍기.
그림판에 { 글: "지음", x: 160, y: 60, 색: "#3b2f2f", 크기: 24 }로 글자쓰기.
체력은 100이다.
체력이 50보다 크면
  "안전하다"를 출력한다.
체력을 30만큼 줄인다.

선택은 ["공격", "도망"]에서 고른 것이다.
선택을 출력한다.

19개 샘플 전체는 samples/README.md에 정리되어 있다. 인터랙티브 텍스트 어드벤처는 samples/13_story.zm.

현재 범위 (v0.3)

v0.1 코어 위에 v0.2에서 메시지 프레임 연구 원칙이 고정되었고, v0.3에서 코어 문법이 확장되었다.

범주 내용
바인딩 불변(이다 = const), 가변(넣는다 = let)
자료형 숫자, 문자열, 불리언, 목록, 레코드
제어 흐름 블록/단문 if-else, while, for-each
함수 정의, 호출, 적용 바인딩(X를 Y한 것이다)
연산 의 속성 접근, 인덱스 대입, 타입 변환
실험 프레임 X으로 Y, X 더하기 Y, 대상에 값 추가, 에서 고른 것이다 등
기반 인터프리터 실행 모델, 한국어 오류 메시지

버전별 변화는 HISTORY.md, 설계 결정 기록은 DECISIONS.md.

시작하기

# 파일 실행
cargo run -- samples/00_hello_everyone.zm

# 검사
cargo run -- check samples/00_hello_everyone.zm
cargo run -- check --json samples/00_hello_everyone.zm

# REPL (빈 줄로 블록 실행)
cargo run -- repl

# 테스트
cargo test
디버깅 도구
cargo run -- tokens path/to/program.zm   # 토큰 보기
cargo run -- ast path/to/program.zm      # AST 보기
cargo run -- hir path/to/program.zm      # HIR 보기
cargo run -- rules --agent               # 에이전트용 현재 규칙 보기
cargo run -- explain MSG301              # 진단 코드 설명 보기

브라우저 Playground

설치 없이 브라우저에서 바로 실행해 볼 수 있다 → https://ziium.github.io/

페이지 내용
Playground 코드를 고쳐 바로 실행 — 첫인사, 텍스트 하노이탑, 캔버스 하노이탑, XOR 신경망
숲속의 용사 비교, 상대적 변화, 선택 프레임을 사용한 텍스트 어드벤처
Rosetta Stone Python/Ruby 문법과 나란히 놓고 보는 비교표
Changelog 버전별 변경 사항
사이트를 로컬에서 띄우기

사이트 소스는 별도 저장소 ziium/ziium.github.io에 있고, 이 저장소는 WASM 인터프리터만 제공한다.

git clone https://github.com/ziium/ziium.github.io ../site
rustup target add wasm32-unknown-unknown
cargo install wasm-pack
wasm-pack build --release --target web --out-dir ../site/pkg
python3 -m http.server 8000 --directory ../site
# → http://localhost:8000

이 저장소에 push해도 사이트는 자동 재배포되지 않는다. 사이트 저장소의 Deploy Pages 워크플로가 실행될 때 ziium main을 새로 체크아웃해 WASM을 다시 빌드한다.

문서

문서 설명
LANGUAGE.md 언어 철학, 문법, 의미, 메시지 경계
GRAMMAR.ebnf 파서 구현용 형식 문법
IMPLEMENTATION.md 구현 구조, 테스트, 작업 순서
DECISIONS.md 주요 설계 결정 기록
HISTORY.md 버전별 변화 요약
samples/ 바로 실행할 수 있는 샘플 프로그램 모음

아키텍처

소스 (.zm)
  → Lexer → Parser → Normalizer → Resolver → HIR Lowering → Interpreter
                                                              ↓
                                                          CLI / REPL / WASM

다음 단계

  1. HIR SendSelector 일반화 범위 결정
  2. 메시지 집합 확장 범위 설정
  3. 정규화 규칙 고정
  4. LLVM 또는 Cranelift 백엔드 초안

MIT License · 기여 가이드

About

한국어 문장 구조를 중심에 둔 메시지 지향 프로그래밍 언어 (Rust 구현)

Resources

Stars

40 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages