Skip to content
Neuron Teckid edited this page Mar 8, 2016 · 1 revision

从 npm 安装

npm install -g flatscript

之后可以用 flsc 命令来使用 Flatscript 编译器.

构建

Flatscript 本身也是用 Flatscript 语言编写的, 所以必须要先安装一个 bootstrap 编译器.

在源代码目录下使用

make

便可以编译出一个 flsc.js 文件, 然后使用

node ./flsc.js

便等同于使用 flsc 命令.

如果要递归地编译 Flatscript, 可以使用

make recursive

NPM 相关

使用

make npm

生成 package.json 文件.

测试

需要安装 mocha 库. 然后执行

make runtest

或者如果要使用递归生成的 flsc.js 进行测试, 执行

make recursivetest

提需求或 Bug

请前往 https://github.com/neuront/flatscript/issues

提交补丁

请使用 Flatscript 编写, 文件后缀为 fls. git ignore 文件中已经屏蔽一切 js 文件.

开发指引

  • parse/ 词法语法分析模块, 任何只与词法语法相关, 或作为语法糖可以进行简单语法树转化实现的请提交至此
  • resolve/ 语义分析模块, 任何与名字查找, 编译时常量折叠, 异步语法树变换相关的请提交至此
  • backend/ 生成模块, 此模块直接生成 Javascript 代码
  • main.fls 编译器主程序, 包括命令行参数解析
  • compiler.fls 编译行为控制, 以及如何实现 include 文件
  • globals.fls 全局设定
  • errors.fls 编译错误类型定义, 任何新功能中涉及到的编译错误都应该在此定义, 然后为语法语义模块所引用; backend 模块不应该包括任何编译错误提示