玄语言是一个基于Python实现的中文编程语言，旨在降低中文使用者的编程学习门槛，同时保留现代编程语言的强大功能和灵活性。
玄语言是一个使用中文关键字和函数名的编程语言，它基于Python的语法结构，但使用中文关键字和标识符，使中文使用者能够更直观地理解和编写代码。玄语言支持现代编程范式，包括面向对象编程、函数式编程和异步编程等。
- 中文关键字和函数名：使用中文作为语言的关键字和内置函数名，降低中文使用者的学习门槛
- 兼容Python语法：基于Python的语法结构，保留了Python的强大功能和灵活性
- 支持现代编程范式：支持面向对象编程、函数式编程、异步编程等现代编程范式
- 丰富的内置功能：提供丰富的内置函数和标准库，涵盖常见的编程需求
- 完善的错误处理：提供详细的错误信息和异常处理机制
- Python 3.6 或更高版本
- 支持 Windows、macOS 和 Linux 系统
- 克隆项目仓库：
git clone https://github.com/Metastem/xuan.git
cd xuan- 安装依赖：
pip install -r requirements.txt- 安装玄语言：
pip install -e .pip install xuan安装完成后，可以通过以下命令验证安装是否成功：
xuan --version玄语言的语法基于Python，但使用中文关键字和标识符。以下是玄语言的主要语法特性：
变量名 = 值
例如：
年龄 = 25
姓名 = "张三"
# 这是单行注释
"""
这是多行注释
可以跨越多行
"""
玄语言支持以下基本数据类型：
- 整数：如
1,100,-10 - 浮点数：如
3.14,-0.01 - 字符串：如
"你好",'世界' - 布尔值：
真和假 - 空值：
空
- 列表：如
[1, 2, 3] - 字典：如
{"姓名": "张三", "年龄": 25} - 集合：如
{1, 2, 3} - 元组：如
(1, 2, 3)
如果 条件:
# 代码块
否则如果 条件:
# 代码块
否则:
# 代码块
例如：
如果 年龄 >= 18:
输出("成年人")
否则:
输出("未成年人")
对于 变量 在 可迭代对象:
# 代码块
例如：
对于 i 在 范围(1, 5):
输出(i)
当 条件:
# 代码块
例如：
i = 0
当 i < 5:
输出(i)
i += 1
- 跳过：跳过当前循环迭代
- 终止：终止整个循环
- 返回：从函数返回值
定义 函数名(参数1, 参数2, ...):
# 函数体
返回 结果
例如：
定义 计算平方(数字):
返回 数字 * 数字
定义 问候(姓名="世界"):
返回 "你好，" + 姓名
定义 求和(*数字):
总和 = 0
对于 数 在 数字:
总和 += 数
返回 总和
定义 创建用户(**属性):
用户 = {}
对于 键, 值 在 属性.项目():
用户[键] = 值
返回 用户
类 类名:
定义 初始化(自身, 参数1, 参数2, ...):
自身.属性1 = 参数1
自身.属性2 = 参数2
定义 方法名(自身, 参数1, 参数2, ...):
# 方法体
返回 结果
例如：
类 人:
定义 初始化(自身, 姓名, 年龄):
自身.姓名 = 姓名
自身.年龄 = 年龄
定义 介绍(自身):
返回 f"我叫{自身.姓名}，今年{自身.年龄}岁。"
类 子类(父类):
定义 初始化(自身, 参数1, 参数2, ...):
父类.初始化(自身, 参数1, ...)
自身.属性 = 值
例如：
类 学生(人):
定义 初始化(自身, 姓名, 年龄, 学号):
人.初始化(自身, 姓名, 年龄)
自身.学号 = 学号
定义 介绍(自身):
返回 f"我叫{自身.姓名}，今年{自身.年龄}岁，学号是{自身.学号}。"
尝试:
# 可能引发异常的代码
捕获 异常类型 作为 异常变量:
# 处理异常的代码
最后:
# 无论是否发生异常都会执行的代码
例如：
尝试:
数字 = 整数(输入("请输入一个数字："))
结果 = 10 / 数字
输出(f"10 除以 {数字} 等于 {结果}")
捕获 值错误:
输出("输入的不是有效的数字！")
捕获 零除错误:
输出("不能除以零！")
最后:
输出("计算结束。")
导入 模块名
从 模块名 导入 函数名1, 函数名2, ...
从 模块名 导入 *
例如：
导入 数学
从 随机 导入 随机数, 随机整数
使用 打开文件("文件名", "模式") 作为 文件:
内容 = 文件.读取()
# 处理文件内容
例如：
尝试:
使用 打开文件("data.txt", "r") 作为 文件:
内容 = 文件.读取()
输出(内容)
捕获 文件未找到错误:
输出("文件不存在！")
[表达式 对于 变量 在 可迭代对象 如果 条件]
例如：
平方列表 = [x * x 对于 x 在 范围(1, 6)] # [1, 4, 9, 16, 25]
偶数平方 = [x * x 对于 x 在 范围(1, 11) 如果 x % 2 == 0] # [4, 16, 36, 64, 100]
{键表达式: 值表达式 对于 变量 在 可迭代对象 如果 条件}
例如：
平方字典 = {x: x * x 对于 x 在 范围(1, 6)} # {1: 1, 2: 4, 3: 9, 4: 16, 5: 25}
定义 生成器函数():
对于 i 在 范围(10):
产出 i
例如：
定义 斐波那契(n):
a, b = 0, 1
对于 _ 在 范围(n):
产出 a
a, b = b, a + b
定义 装饰器(函数):
定义 包装(*参数, **关键字参数):
# 前置处理
结果 = 函数(*参数, **关键字参数)
# 后置处理
返回 结果
返回 包装
@装饰器
定义 被装饰函数():
# 函数体
例如：
定义 计时器(函数):
定义 包装(*参数, **关键字参数):
开始时间 = 当前时间()
结果 = 函数(*参数, **关键字参数)
结束时间 = 当前时间()
输出(f"函数 {函数.__名称__} 执行时间: {结束时间 - 开始时间} 秒")
返回 结果
返回 包装
@计时器
定义 耗时函数():
睡眠(1)
返回 "完成"
异步 定义 异步函数():
# 异步操作
等待 异步操作()
返回 结果
例如：
异步 定义 获取数据(url):
等待 睡眠(1) # 模拟网络请求
返回 f"来自 {url} 的数据"
异步 定义 主函数():
结果 = 等待 获取数据("https://example.com")
输出(结果)
玄语言提供了丰富的内置函数，这些函数使用中文命名，便于中文使用者理解和使用。以下是主要的内置函数分类：
- 输出(值)：打印值到标准输出
- 输入(提示=None)：从标准输入读取一行
- 打印(值)：与输出相同，打印值到标准输出
- 整数(值)：将值转换为整数
- 浮点数(值)：将值转换为浮点数
- 字符串(值)：将值转换为字符串
- 布尔(值)：将值转换为布尔值
- 列表(值)：将值转换为列表
- 字典(值)：将值转换为字典
- 集合(值)：将值转换为集合
- 元组(值)：将值转换为元组
- 绝对值(数字)：返回数字的绝对值
- 最大值(*值)：返回最大值
- 最小值(*值)：返回最小值
- 总和(可迭代对象)：返回可迭代对象中所有元素的和
- 幂(底数, 指数)：返回底数的指数次方
- 四舍五入(数字, 小数位=0)：对数字进行四舍五入
- 向上取整(数字)：返回大于或等于数字的最小整数
- 向下取整(数字)：返回小于或等于数字的最大整数
- 平方根(数字)：返回数字的平方根
- 对数(数字, 底数=10)：返回以指定底数的对数
- 正弦(角度)：返回角度的正弦值（角度以弧度为单位）
- 余弦(角度)：返回角度的余弦值（角度以弧度为单位）
- 正切(角度)：返回角度的正切值（角度以弧度为单位）
- 阶乘(数字)：返回数字的阶乘
- 随机数()：返回0到1之间的随机浮点数
- 随机整数(最小值, 最大值)：返回指定范围内的随机整数
- 随机选择(序列)：从序列中随机选择一个元素
- 随机打乱(序列)：随机打乱序列中的元素
- 随机样本(序列, 数量)：从序列中随机选择指定数量的元素
- 范围(开始, 结束=None, 步长=1)：创建一个数字序列
- 长度(序列)：返回序列的长度
- 排序(序列, 反向=False)：对序列进行排序
- 反转(序列)：反转序列中的元素顺序
- 枚举(序列)：返回序列中的索引和值对
- 过滤(函数, 序列)：使用函数过滤序列中的元素
- 映射(函数, 序列)：对序列中的每个元素应用函数
- 压缩(*序列)：将多个序列打包成元组对的列表
- 链接(*序列)：将多个序列连接成一个序列
- 分割(字符串, 分隔符=None)：将字符串按分隔符分割
- 连接(序列, 分隔符="")：使用分隔符将序列中的字符串连接
- 替换(字符串, 旧值, 新值, 次数=-1)：替换字符串中的子串
- 去除空白(字符串)：去除字符串两端的空白字符
- 左对齐(字符串, 宽度)：左对齐字符串
- 右对齐(字符串, 宽度)：右对齐字符串
- 居中对齐(字符串, 宽度)：居中对齐字符串
- 是数字(字符串)：检查字符串是否只包含数字
- 是字母(字符串)：检查字符串是否只包含字母
- 是字母数字(字符串)：检查字符串是否只包含字母和数字
- 大写(字符串)：将字符串转换为大写
- 小写(字符串)：将字符串转换为小写
- 首字母大写(字符串)：将字符串的首字母转换为大写
- 打开文件(文件名, 模式="r")：打开文件并返回文件对象
- 读取文件(文件名)：读取整个文件内容
- 写入文件(文件名, 内容)：将内容写入文件
- 追加文件(文件名, 内容)：将内容追加到文件末尾
- 文件存在(路径)：检查文件是否存在
- 删除文件(路径)：删除指定文件
- 创建目录(路径)：创建目录
- 删除目录(路径)：删除目录
- 列出目录(路径)：列出目录中的文件和子目录
- 当前时间()：返回当前时间戳
- 睡眠(秒数)：暂停执行指定的秒数
- 系统命令(命令)：执行系统命令
- 环境变量(名称)：获取环境变量的值
- 设置环境变量(名称, 值)：设置环境变量的值
- 退出(状态码=0)：退出程序
- 获取平台()：获取当前操作系统平台
- 获取Python版本()：获取Python解释器版本
# hello_world.xuan
输出("你好，世界！")# fibonacci.xuan
定义 斐波那契(n):
如果 n <= 0:
返回 []
否则如果 n == 1:
返回 [0]
否则如果 n == 2:
返回 [0, 1]
结果 = [0, 1]
对于 i 在 范围(2, n):
结果.添加(结果[i-1] + 结果[i-2])
返回 结果
# 生成前10个斐波那契数
数列 = 斐波那契(10)
输出(f"斐波那契数列: {数列}")# todo_manager.xuan
类 待办事项:
定义 初始化(自身):
自身.任务列表 = []
定义 添加任务(自身, 任务):
自身.任务列表.添加({"任务": 任务, "完成": 假})
输出(f"已添加任务：{任务}")
定义 完成任务(自身, 索引):
如果 0 <= 索引 < 长度(自身.任务列表):
自身.任务列表[索引]["完成"] = 真
输出(f"已完成任务：{自身.任务列表[索引]['任务']}")
否则:
输出("无效的任务索引！")
定义 显示任务(自身):
如果 长度(自身.任务列表) == 0:
输出("没有待办任务。")
返回
输出("\n待办事项列表：")
对于 i, 任务 在 枚举(自身.任务列表):
状态 = "✓" 如果 任务["完成"] 否则 " "
输出(f"{i+1}. [{状态}] {任务['任务']}")
# 使用示例
管理器 = 待办事项()
管理器.添加任务("学习玄语言")
管理器.添加任务("完成项目文档")
管理器.添加任务("准备演示")
管理器.显示任务()
管理器.完成任务(0)
管理器.显示任务()xuan/
├── xuan/ # 核心源代码
│ ├── __init__.py # 包初始化文件
│ ├── lexer.py # 词法分析器
│ ├── parser.py # 语法分析器
│ ├── ast.py # 抽象语法树
│ ├── interpreter.py # 解释器
│ ├── builtins.py # 内置函数
│ ├── exceptions.py # 异常定义
│ └── cli.py # 命令行接口
├── requirements.txt # 依赖要求
├── README.md # 项目说明
└── LICENSE # 许可证
- lexer.py: 词法分析器，将源代码转换为标记流
- parser.py: 语法分析器，将标记流转换为抽象语法树
- ast.py: 定义抽象语法树的节点类型
- interpreter.py: 解释器，执行抽象语法树
- builtins.py: 实现内置函数和类型
- exceptions.py: 定义自定义异常类型
- cli.py: 实现命令行接口
- 克隆仓库并安装依赖：
git clone https://github.com/Metastem/xuan.git
cd xuan
pip install -r requirements.txt
pip install -e .- 运行测试：
python -m pytest tests/- Fork 项目仓库
- 创建功能分支
- 提交更改
- 推送到分支
- 创建 Pull Request
- 遵循 PEP 8 编码规范
- 使用有意义的变量名和函数名
- 添加适当的注释和文档字符串
- 确保所有测试通过
<类型>: <描述>
[可选的正文]
[可选的脚注]
类型可以是：
- feat: 新功能
- fix: 错误修复
- docs: 文档更改
- style: 代码风格更改
- refactor: 代码重构
- test: 测试相关
- chore: 构建过程或辅助工具的变动
- 初始版本发布
- 实现基本语言特性
- 添加内置函数库
- 提供示例程序
- 添加更多内置函数
- 优化解释器性能
- 添加更多语言特性
- 改进错误处理和调试功能
- 开发IDE插件
- 完善文档和教程