JGZSunShineMod1.0.3
11 KiB
11 KiB
Oraset 编程语言
Oraset是一种简单的跨平台编程语言，使用Python实现，支持Windows和Linux系统。
特性
- 跨平台运行（Windows和Linux）
- 简洁易懂的语法
- 支持变量定义和赋值
- 支持表达式计算（算术、比较、逻辑）
- 支持条件语句（if、else if、else）
- 支持循环语句（while）
- 支持函数定义和调用
- 支持类定义
- 支持输出功能
- 支持注释
快速开始
运行环境
- Python 3.6+
运行方式
# 运行.oas或.oraset文件
python oraset.py <filename.oas|.oraset>
# 将.oas或.oraset文件打包成.osp文件
python oraset.py pack <filename.oas|.oraset>
# 运行.osp文件
python oraset.py -osp <filename.osp>
示例
创建一个名为hello.oas的文件，内容如下：
!! 输出Hello, Oraset!
show(`Hello, Oraset!`);
!! 变量定义和计算
x = 10;
y = 20;
sum = x + y;
show(`10 + 20 = `, sum);
!! 条件语句
if (sum > 25) {
show(`Sum is greater than 25`);
} else {
show(`Sum is less than or equal to 25`);
}
!! 循环语句
i = 0;
while (i < 5) {
show(`i = `, i);
i = i + 1;
}
!! 函数定义
def add(a, b) {
return a + b;
}
!! 函数调用
result = add(5, 6);
show(`5 + 6 = `, result);
!! 类定义
class Calculator {
def multiply(a, b) {
return a * b;
}
}
运行：
python oraset.py hello.oas
语法指南
注释
使用!!开始单行注释：
!! 这是一个注释
使用!*和*!包围多行注释：
!* 这是一个
多行注释 *!
内置库函数
Oraset提供了以下内置库函数：
数学函数
| 函数名 | 描述 | 示例 |
|---|---|---|
abs(x) |
返回x的绝对值 | abs(-10) → 10 |
max(x, y) |
返回x和y中的最大值 | max(10, 20) → 20 |
min(x, y) |
返回x和y中的最小值 | min(10, 20) → 10 |
pow(x, y) |
返回x的y次方 | pow(2, 3) → 8 |
sqrt(x) |
返回x的平方根（取整数部分） | sqrt(16) → 4 |
字符串函数
| 函数名 | 描述 | 示例 |
|---|---|---|
len(s) |
返回字符串s的长度 | len("Hello") → 5 |
upper(s) |
将字符串s转换为大写 | upper("Hello") → HELLO |
lower(s) |
将字符串s转换为小写 | lower("HELLO") → hello |
substring(s, start, end) |
返回字符串s从start到end的子串 | substring("Hello", 0, 3) → Hel |
startsWith(s, prefix) |
检查字符串s是否以prefix开头 | startsWith("Hello", "He") → 1 |
endsWith(s, suffix) |
检查字符串s是否以suffix结尾 | endsWith("Hello", "lo") → 1 |
replace(s, old, new) |
替换字符串s中的old为new | replace("Hello", "He", "Hi") → Hiello |
split(s, sep) |
以sep为分隔符分割字符串s | split("a,b,c", ",") → ["a", "b", "c"] |
trim(s) |
去除字符串s首尾的空白 | trim(" Hello ") → Hello |
数组函数
| 函数名 | 描述 | 示例 |
|---|---|---|
array(...items) |
创建一个包含指定元素的数组 | array("a", "b", "c") → ["a", "b", "c"] |
push(arr, item) |
向数组arr添加一个元素 | push(["a", "b"], "c") → ["a", "b", "c"] |
pop(arr) |
从数组arr中移除最后一个元素 | pop(["a", "b", "c"]) → ["a", "b"] |
indexOf(arr, item) |
返回元素item在数组arr中的索引，若不存在则返回-1 | indexOf(["a", "b", "c"], "b") → 1 |
类型检查函数
| 函数名 | 描述 | 示例 |
|---|---|---|
is_number(x) |
检查x是否为数字 | is_number("123") → 1 |
is_string(x) |
检查x是否为字符串 | is_string("Hello") → 1 |
其他函数
| 函数名 | 描述 | 示例 |
|---|---|---|
input(prompt) |
从用户输入获取值 | input("请输入: ") |
int(s) |
将字符串s转换为整数 | int("123") → 123 |
str(x) |
将x转换为字符串 | str(123) → "123" |
文件操作函数
| 函数名 | 描述 | 示例 |
|---|---|---|
file_read(filename) |
读取文件内容 | file_read("test.txt") |
file_write(filename, content) |
写入内容到文件 | file_write("test.txt", "Hello") |
file_exists(filename) |
检查文件是否存在 | file_exists("test.txt") → 1 (存在) 或 0 (不存在) |
时间函数
| 函数名 | 描述 | 示例 |
|---|---|---|
time_now() |
获取当前时间戳 | time_now() |
time_sleep(seconds) |
暂停指定秒数 | time_sleep(2) |
随机数函数
| 函数名 | 描述 | 示例 |
|---|---|---|
random_int(min, max) |
生成指定范围内的随机整数 | random_int(1, 100) |
random_float() |
生成0-1之间的随机浮点数 | random_float() |
系统函数
| 函数名 | 描述 | 示例 |
|---|---|---|
system(command) |
执行系统命令 | system("dir") |
get_env(var_name) |
获取环境变量 | get_env("PATH") |
数学模块
注意：使用数学函数需要先导入math模块
import math
| 函数名 | 描述 | 示例 |
|---|---|---|
abs(x) |
返回x的绝对值 | abs(-10) → 10.0 |
max(x, y) |
返回x和y中的最大值 | max(10, 20) → 20.0 |
min(x, y) |
返回x和y中的最小值 | min(10, 20) → 10.0 |
pow(x, y) |
返回x的y次方 | pow(2, 3) → 8.0 |
sqrt(x) |
返回x的平方根 | sqrt(16) → 4.0 |
sin(x) |
返回x（度）的正弦值 | sin(90) → 1.0 |
cos(x) |
返回x（度）的余弦值 | cos(0) → 1.0 |
tan(x) |
返回x（度）的正切值 | tan(45) → 1.0 |
asin(x) |
返回x的反正弦值（度） | asin(1) → 90.0 |
acos(x) |
返回x的反余弦值（度） | acos(1) → 0.0 |
atan(x) |
返回x的反正切值（度） | atan(1) → 45.0 |
pi() |
返回圆周率π的值 | pi() → 3.141592653589793 |
e() |
返回自然常数e的值 | e() → 2.718281828459045 |
网络请求函数
注意：使用网络请求函数需要先导入http模块
import http
| 函数名 | 描述 | 示例 |
|---|---|---|
http_get(url) |
发送HTTP GET请求并返回响应内容 | http_get("http://example.com") |
http_post(url, data) |
发送HTTP POST请求并返回响应内容 | http_post("http://httpbin.org/post", "{\"name\": \"Oraset\", \"version\": \"1.0\"}") |
插件系统
Oraset支持用户自定义插件，您可以将自己的扩展功能放在includes文件夹中。
创建插件
- 在
includes文件夹中创建一个以.oraset为后缀的文件 - 在文件中定义函数、类等
- 使用
import 插件名指令加载插件
示例
创建includes/math_utils.oraset文件：
!! 数学工具插件
def add(a, b) {
return a + b;
}
def subtract(a, b) {
return a - b;
}
在您的代码中使用：
import math_utils
result = add(10, 20);
show(`10 + 20 = `, result);
变量
变量定义和赋值：
x = 10; // 整数
message = `Hello`; // 字符串
数据类型
- 整数：
10,20,30 - 字符串：
`Hello`,`World`
字符串支持以下转义符：
| 转义符 | 描述 |
|---|---|
\n |
换行符 |
\t |
制表符 |
\r |
回车符 |
\\ |
反斜杠 |
\` |
反引号 |
示例：
// 输出多行文本
show(`Line 1\nLine 2`);
// 输出带制表符的文本
show(`Column 1\tColumn 2`);
// 输出包含反斜杠的文本
show(`Path: C:\\Users\\Name`);
运算符
算术运算符
+：加法-：减法*：乘法/：除法（整数除法）
比较运算符
==：等于!=：不等于<：小于<=：小于等于>：大于>=：大于等于
逻辑运算符
&&：逻辑与||：逻辑或
赋值运算符
=：赋值+=：加赋值-=：减赋值*=：乘赋值/=：除赋值
条件语句
if (condition) {
// 代码块
} else if (condition) {
// 代码块
} else {
// 代码块
}
循环语句
while (condition) {
// 代码块
}
函数定义
def function_name(parameter1, parameter2, ...) {
// 代码块
return value;
}
函数调用
result = function_name(arg1, arg2, ...);
类定义
class ClassName {
def method_name(parameter1, parameter2, ...) {
// 代码块
return value;
}
}
输出
使用show函数输出内容：
show(`Hello`);
show(`The value is `, x);
示例代码
基础示例
// 变量和表达式
x = 10;
y = 20;
sum = x + y;
show(`Sum: `, sum);
// 条件语句
if (sum > 25) {
show(`Sum is greater than 25`);
} else if (sum == 25) {
show(`Sum is exactly 25`);
} else {
show(`Sum is less than 25`);
}
// 循环语句
i = 0;
while (i < 5) {
show(`i = `, i);
i += 1;
}
函数示例
// 函数定义
def add(a, b) {
return a + b;
}
def multiply(a, b) {
return a * b;
}
// 函数调用
result1 = add(10, 20);
result2 = multiply(5, 6);
show(`10 + 20 = `, result1);
show(`5 * 6 = `, result2);
// 递归函数
def factorial(n) {
if (n == 0 || n == 1) {
return 1;
}
return n * factorial(n - 1);
}
result = factorial(5);
show(`Factorial of 5 is `, result);
类示例
// 类定义
class Calculator {
def add(a, b) {
return a + b;
}
def subtract(a, b) {
return a - b;
}
def multiply(a, b) {
return a * b;
}
def divide(a, b) {
return a / b;
}
}
// 注意：类方法的调用需要通过函数实现
// 目前版本中，类定义会被存储但不会直接实例化
项目结构
Oraset/
├── oraset.py # 核心解释器
├── examples/ # 示例代码
│ ├── hello.oas # 基础示例
│ ├── hello.osp # 打包后的基础示例
│ ├── functions.oas # 函数示例
│ └── classes.oas # 类示例
├── README.md # 本教程（中文）
└── README.en_us.md # 本教程（英文）
.osp文件说明
.osp文件是Oraset的打包文件格式，它是通过对.oas文件进行压缩和编码生成的，具有以下特点：
- 加密性：.osp文件使用base64编码和zlib压缩，使得源代码不易被直接查看
- 跨平台：.osp文件可以在Windows和Linux系统上直接运行
- 便捷性：.osp文件是一个独立的文件，可以方便地分发和使用
打包.oas文件
使用pack命令将.oas文件打包成.osp文件：
python oraset.py pack <filename.oas>
这将生成一个与.oas文件同名但扩展名为.osp的文件。
运行.osp文件
使用-osp参数运行.osp文件：
python oraset.py -osp <filename.osp>
这将自动解压和执行.osp文件中的代码。
开发说明
Oraset使用Python实现，主要包含以下组件：
- Lexer：词法分析器，负责将源代码转换为词法单元
- Parser：语法分析器，负责构建抽象语法树（AST）
- Interpreter：解释器，负责执行AST并生成结果
未来计划
- 支持更多数据类型（浮点数、布尔值等）
- 完善类的实例化和方法调用
- 支持模块导入
- 添加标准库
- 优化性能
许可证
GNU General Public License v3.0