한남랭이란?
한남랭(hannam-lang)은 새 언어가 아니라 JavaScript를 한남 말투로 쓰는 방법입니다. .hn 파일에 if 대신 예?, console.log 대신 무슨 발언이세요?처럼 쓰면 컴파일러가 JavaScript로 바꿉니다. 바뀌는 것은 문장 맨 앞의 키워드뿐이고, 나머지 문법과 DOM, fetch, Node API, npm 패키지는 JS 그대로 씁니다. 출력은 ES 모듈이라 브라우저, Node, Bun에서 실행됩니다.
예시
티~원 불러오기() {
아! 줴줴이야~ [
{ 내용: "우유 사기", 완료: true },
{ 내용: "README 쓰기", 완료: false },
]
}
요이~ 할일 티~원! 불러오기() {
예? 할일.완료 {
아뇨
}
무슨 발언이세요? `□ ${할일.내용}`
}
async function 불러오기() {
return [
{ 내용: "우유 사기", 완료: true },
{ 내용: "README 쓰기", 완료: false },
]
}
for (const 할일 of await 불러오기()) {
if (할일.완료) {
continue
}
console.log(`□ ${할일.내용}`)
}
| 한남랭 | JavaScript |
|---|
엄 / 엄. / 엄.. / 엄... | var / let / const / // 주석 |
예? / 예?? / 예??? | if / else if / switch |
아뇨아뇨아뇨아뇨 | else, default |
요이~ / 요이이이~ | for...of·범위 반복 / while |
요히~ | for...in |
줴줴이야 / 아뇨 | break / continue |
아! 줴줴이야~ / 아... 줴줴이야... | return / throw |
티-원 / 티~원 / 티~원! | function / async function / await |
진~지? / 지~랄 | try / catch |
오호호호호~ / 오호호호홋~ | class / class extends |
무슨 발언이세요? 값 / 예? 무슨 발언이세요?(질문) | console.log / confirm |
빠른 시작
Node 20.16 이상이 필요합니다.
npm i -D hannam-lang
npx hannam todo.hn # 바로 실행
npx hnc todo.hn # todo.js로 컴파일
hannam은 .hn을 바로 실행하는 실행기이고, hnc(hannam compiler)는 .js 파일을 만드는 컴파일러입니다. pnpm, yarn, bun으로 설치하는 방법은 설치 문서에 있습니다.
패키지
동작 방식
- 렉서가 문자열, 템플릿 리터럴, 주석, 정규식을 구분해 JS 토큰의 경계를 나눕니다.
- 변환기가 괄호와 블록을 따라가며 문장이 시작하는 위치를 찾고, 그 자리의 한남랭 키워드만 JS로 바꿉니다.
- 구문 트리를 다시 출력하지 않고 원문에서 키워드 자리만 고칩니다. 그래서 줄 번호와 주석이 그대로 남고, 소스맵이
.hn 원본을 가리킵니다.
- 키워드가 없는 JS는 한 글자도 바뀌지 않습니다. 고정 버전 npm 패키지의 JS 파일 648개로 이 성질을 테스트합니다.
자세한 내용은 컴파일러 구조에 있습니다.
문서
개발
pnpm install
pnpm build
pnpm test
개발 환경, 커밋 규칙, 새 키워드를 제안하는 기준은 CONTRIBUTING.md에 있습니다.
릴리스
패키지에 영향을 주는 변경에는 changeset을 추가합니다.
pnpm changeset
main에 병합되면 버전 PR이 만들어지거나 갱신됩니다. 버전 PR을 병합하면 npm 패키지가 배포됩니다. 처음 한 번 필요한 저장소 설정은 RELEASING.md에 있습니다.
라이선스
MIT
