dsl 发行版 - Gitee.com

# DSL Core v1.0.0

> 首次稳定版本发布 🎉

DSL Core 是一个高性能的规则引擎 Go 库，采用 JavaScript/TypeScript 语法风格，支持中英文关键字。

## ✨ 核心特性

- **现代语法**: 箭头函数、Lambda 表达式、类型注解、可选链、空值合并
- **双语支持**: 中英文关键字，适应不同开发者
- **模块化**: 支持 import/export，实现代码复用
- **类型系统**: 基本类型、复合类型、可空类型、联合类型
- **内置函数**: 24 个内置函数（Math、String、Array、Object、Console）

## ⚡ 性能卓越

| 指标 | 目标 | 实际 | 超越 |
|------|------|------|------|
| 解析速度 | > 1,000 行/秒 | **~5,800 行/秒** | **5.8x** |
| 执行速度 | > 10,000 次/秒 | **~624,000 次/秒** | **62.4x** |
| 内存使用 | < 100 MB | **< 1 MB** | **极低** |

## 📦 安装使用

```bash
go get gitee.com/blizzard1413/dsl@v1.0.0
```

## 🚀 快速开始

```go
package main

import (
    "fmt"
    "gitee.com/blizzard1413/dsl/engine"
)

func main() {
    eng := engine.NewEngine()
    
    source := `
    export rule calculateDiscount = (price: number, vipLevel: number): number => {
        if (vipLevel >= 3) {
            return price * 0.7;
        } else if (vipLevel >= 2) {
            return price * 0.8;
        } else {
            return price * 0.9;
        }
    }
    `
    
    eng.LoadModuleFromSource("discount.dsl", source)
    result, _ := eng.Execute("calculateDiscount", map[string]interface{}{
        "price":    100.0,
        "vipLevel": 3,
    })
    
    fmt.Printf("折扣后价格: %.2f\n", result.GetValue().(float64))
    // 输出: 折扣后价格: 70.00
}
```

## 🧪 质量保证

- ✅ 测试覆盖率 > 80%
- ✅ 200+ 单元测试
- ✅ 12 个正确性属性测试
- ✅ 20+ 集成测试
- ✅ 15+ 性能基准测试

## 📚 文档

- [README](README.md) - 项目介绍
- [快速开始](docs/quick-start.md) - 5 分钟上手
- [API 文档](docs/api.md) - 完整 API 参考
- [语法文档](docs/grammar.md) - DSL 语法规范
- [性能报告](docs/performance-report.md) - 性能测试详情
- [示例代码](examples/) - 9 个示例项目

## 🎓 示例项目

- **01-hello-world** - Hello World 入门
- **02-variables** - 变量声明和使用
- **03-control-flow** - 控制流语句
- **04-arrays** - 数组操作
- **05-chinese-keywords** - 中文关键字
- **06-real-world** - 真实场景（电商订单）
- **advanced** - 高级功能（折扣计算、数据验证）
- **lambda** - Lambda 表达式和高阶函数

## 📊 项目统计

- **代码行数**: ~8,000+ 行
- **模块数量**: 8 个核心模块
- **任务完成**: 22/22 (100%)
- **开发周期**: 10 个完整阶段

## 🔧 技术栈

- Go 1.21+
- ANTLR4 (解析器生成)
- gopter (属性测试)

## 📝 更新日志

完整的更新日志请查看 [CHANGELOG.md](CHANGELOG.md)

详细的发布说明请查看 [RELEASE_NOTES_v1.0.0.md](RELEASE_NOTES_v1.0.0.md)

## 🙏 致谢

感谢以下开源项目：
- [ANTLR4](https://www.antlr.org/) - 强大的解析器生成器
- [gopter](https://github.com/leanovate/gopter) - Go 属性测试库

---

**Made with ❤️ by the DSL Core Team**

blizzard/dsl .gitee-modal { width: 500px !important; }

搜索帮助

blizzard/dsl