1. 简介

1. 简介
2. 目录
3. 使用
4. 结语

1. 简介

ola（哦啦），对，不是euler（欧拉） -_-

ola实际上是我为openEuler写的一个shell脚本框架。

ola可以让你体会到shell脚本的优雅，当然，你可以不相信，反正我着迷了……

ola采用了面向过程的编程思想，除了简单的原因，还因为我曾经是一个 C-Coder ……

2. 目录

一级目录	二级目录	说明
ola.sh		命令入口
src	apps	应用（命令）脚本
	plugins	插件（命令）脚本
	libs	库脚本，基于标准命令实现
	utils	通用脚本，框架的核心
test		测试脚本

备注：utils和libs中的脚本都是通用的，可以广泛的用在别的项目中。

3. 使用

3.1. 开发

如何开发一个功能？以helloworld.sh为例，如下：

method_def helloworld

usage_helloworld() {
    echo "helloworld (hello): Hello to the world"
}

alias_def helloworld hello
do_helloworld() {
    echo "hello world"
}

一个功能必须定义两个函数：do_helloworld，usage_helloworld

备注：
- do_xxx和usage_xxx后面的名字必须一致
- usage_xxx第一行是功能的简述，通过':'分割
一个功能通过method定义后才生效：method_def helloworld

备注：
- method定义的方法，最终在ola中以子命令的形式存在
一个功能别名通过alias定义：alias_def helloworld hello

备注：
- alias定义的别名，最终在ola中也以子命令的形式存在
- ailas可以定义多个别名，比如：alias_def helloworld hello hw

3.2. 执行

通过执行ola.sh脚本来执行不同的功能。

查看所有帮助信息

bash ola.sh [-h|--help]

查看命令帮助信息

bash ola.sh h helloworld
bash ola.sh h hello

执行命令

bash ola.sh helloworld
bash ola.sh hello

3.3. 环境

功能中会使用一些非系统内嵌的命令，这些命令可能需要单独进行安装，通过下面命令可以检测当前系统中是否存在用到的相关命令：

bash ola.sh checkenv
bash ola.sh ce

3.4. 配置

有些命令需要先配置信息，ola的配置模板文件在config/ola.conf中，通过变量CONFIG_FILE指定配置文件。

ola提供了两个命令用来管理配置文件：init，set

bash ola.sh init
bash ola.sh set

init：初始化配置文件

set：设置/编辑配置文件

3.5. 参数

复数

有的命令可能需要支持批量操作，一种是循环调用命令，另一种是支持复数参数（命令内部根据复数循环），参数一般使用空格进行分割，某个参数如果是复数也使用空格进行分割的话，将会和命令参数冲突，下面有两种方法解决冲突问题：

1）将复数参数用双引号括起来当成一个命令参数，然后双引号内用空格分割，如："a b c d"。

2）将文件名当成一个命令参数，然后文件中保存批量数据，数据可以一行一个，也可以用空格分割每个数据，如：file1，内容如下：
```
a b
c
d
```
方法1）可以用来临时性的批量操作，比较快速和方便；方法2）可以固化命令格式，只需要根据实际修改文件内容。

提示：目前批量数据必须是连续有效字符，不能中间出现空白字符，否则会被解析为多个数据。

3.6. 调试

正常shell程序的调试方法
```
bash -x ola.sh ...
```
通过设置调试变量SH_DEBUG

有一种更好的使用ola的方法是，在用户bin或系统bin目录下创建指向ola.sh的软连接ola，然后就可以在任意目录下像执行系统命令一样执行ola，如下所示：
```
ln -s /xx/yy../ola.sh ola
...
ola -h
```
如果执行ola命令，那么就无法通过bash来执行ola，为了方便调试增加了调试变量SH_DEBUG，像如下方式执行，也可以进行调试：
```
SH_DEBUG=1 ola ...
```

4. 结语

更多功能请自行解锁！

maminjie / ola
暂停

1. 简介

2. 目录

3. 使用

3.1. 开发

3.2. 执行

3.3. 环境

3.4. 配置

3.5. 参数

3.6. 调试

4. 结语

简介

发行版

贡献者

近期动态

maminjie / ola暂停 .gitee-modal { width: 500px !important; }

1. 简介

2. 目录

3. 使用

3.1. 开发

3.2. 执行

3.3. 环境

3.4. 配置

3.5. 参数

3.6. 调试

4. 结语

简介

发行版

贡献者

近期动态

搜索帮助

maminjie / ola
暂停