# BipActuator

**Repository Path**: byusi/BipActuator

## Basic Information

- **Project Name**: BipActuator
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-23
- **Last Updated**: 2025-03-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Bip Script Actuator 文档

## 概述
Bip Script Actuator 是一款轻量级的自定义脚本语言执行器，支持基础编程结构和富文本输出。专为快速原型开发和教学场景设计。

Gitee 仓库: [gitee.com/byusi/BipActuator](https://gitee.com/byusi/BipActuator)

## 功能特性
✅ **核心功能**
- 支持跨平台执行 `.bip` 脚本文件
- 集成 Rich 库实现彩色终端输出
- 命令行参数支持调试模式和输出重定向

📜 **脚本语法**
```bip
# 示例脚本
var name = "Bip User"
print $name
loop 3
if $name == Bip User
```

### 命令集说明
| 命令    | 语法示例                 | 说明                      |
|---------|--------------------------|---------------------------|
| print   | `print Hello World`      | 支持变量插值 ($var)       |
| var     | `var count = 5`          | 变量声明与赋值            |
| if      | `if $var == value`       | 支持等于判断              |
| loop    | `loop 3`                 | 基础计数循环              |
| func    | `func myFunction`        | 函数定义（开发中）        |
| call    | `call myFunction`        | 函数调用（开发中）        |

## 快速开始

### 安装依赖
```bash
pip install rich argparse
```

### 基本使用
```bash
# 执行脚本
./app.py demo.bip

# 带调试模式
./app.py demo.bip -d

# 输出到文件
./app.py demo.bip -o output.log
```

### 示例脚本
```bip
# demo.bip
var message = "Welcome to Bip!"
print $message
loop 3
if $message == Welcome to Bip!
```

## 开发指南

### 架构设计
```
BipActuator
├── 脚本解析器
├── 命令执行器
├── 变量管理系统
└── 调试模块
```

### 扩展建议
1. 在 `parse_line()` 方法中添加新命令处理
2. 通过继承 `BipScriptExecutor` 实现自定义逻辑
3. 使用 `@register_command` 装饰器添加新指令

## 贡献说明

### 分支策略
```mermaid
graph LR
  main --> feature/*
  main --> hotfix/*
  feature/* --> main
```

### 代码规范
- 函数命名使用 snake_case
- 类命名使用 PascalCase
- 关键函数必须包含 docstring
- 提交信息遵循 Conventional Commits

## 路线图
- [ ] v0.2 函数功能实现
- [ ] v0.3 数组数据结构支持
- [ ] v0.4 网络请求模块
- [ ] v1.0 正式发布

## 许可证
[MIT License](LICENSE)

---

📧 联系团队: admin@520world.top  
🐛 问题追踪: [gitee.com/byusi/BipActuator/issues](https://gitee.com/byusi/BipActuator/issues)

> Made with ❤️ by ByUsi - 让脚本执行更有温度！