Awesome

 __    __  _____            _
/ / /\ \ \/__   \___   ___ | |
\ \/  \/ /  / /\/ _ \ / _ \| |
 \  /\  /  / / | (_) | (_) | |
  \/  \/   \/   \___/ \___/|_|

介绍

开发、运维工具及相关配置(基于mac及linux)。

系统需求

Mac/Linux
git 1.7.4+
php4.0+（部分模块）

安装

curl -s "https://raw.githubusercontent.com/qdaxb/wtool/master/doc/get.sh" |bash -s

卸载

wtool uninstall

使用

系统命令

wtool

显示系统命令列表

wtool list

列出所有可用命令

wtool update

更新wtool

wtool addmodule group/project

添加自定义模块，group/project对应github中的组名/项目名.

wtool rmmodule group/project

删除自定义模块，group/project对应github中的组名/项目名.

通用命令

wtool mc ip1[:port1][,ip2[:port2]] [port] "command"

批量执行mc命令

wtool redis ip1[:port1][,ip2[:port2]] [port] "command"

批量执行redis命令(需要redis-cli)

wtool send filename [port]

使用nc发送文件（默认8888端口），接收方可以通过浏览器下载

wtool encode "string" [type]

编码字符串，可选的type为url(default) | utf8 | html | base64。需要安装php。

wtool decode "string" [type]

解码字符串，可选的type为url(default) | utf8 | html | base64。需要安装php。

wtool hex [0x]number[b]

计算数字的10进制、16进制及2进制文本，输入参数默认为10进制，可选16进制（0x）及二进制（b）。

sudo wtool swap [-s [-r]] [-g GREP_ARG]

查询当前服务器各个进程占用swap的情况。

-s 表示对swap占用量进行排序（升序） -r 表示对swap占用量进行排序（降序），使用-r的前提是-s参数开启。 -g grep命令的封装，用于查找特定类型的进程。比如我想查找带有java的进程，可以使用sudo wtool swap -g java

注意，使用该功能需要sudo权限

java命令

wtool housemd pid [java_home]

使用housemd对java程序进行运行时跟踪，支持的操作有：

查看加载类

跟踪方法

查看环境变量

查看对象属性值

详细信息请参考housemd说明文档

wtool jarconfict path

查找jar包间冲突的类

wtool jarfind classname path

在jar包中查找类名

wtool jargrep "text" <path or jarfile>

在jar包中查找文本，可查找常量字符串、类引用。

wtool findcycle [path]

查找当前工程中是否存在循环引用（目前仅支持maven工程，默认为当前路径）

wtool jvm pid

执行jvm debug工具，包含对java栈、堆、线程、gc等状态的查看，支持的功能有：
<pre> ========线程相关======= 1 : 查看占用cpu最高的线程情况 2 : 打印所有线程 3 : 打印线程数 4 : 按线程状态统计线程数 ========GC相关======= 5 : 垃圾收集统计（包含原因）可以指定间隔时间及执行次数，默认10秒 6 : 显示堆中各代的空间1000 5 7 : 垃圾收集统计。可以指定间隔时间及执行次数，默认10秒 8 : 打印perm区内存情况*会使程序暂停响应* 9 : 查看directbuffer情况 ========堆对象相关======= 10 : dump heap到文件*会使程序暂停响应*默认保存到`pwd`/dump.bin,可指定其它路径 11 : 触发full gc。*会使程序暂停响应* 12 : 打印jvm heap统计*会使程序暂停响应* 13 : 打印jvm heap中top20的对象。*会使程序暂停响应*参数：1:按实例数量排序,2:按内存占用排序，默认为1 14 : 触发full gc后打印jvm heap中top20的对象。*会使程序暂停响应*参数：1:按实例数量排序,2:按内存占用排序，默认为1 15 : 输出所有类装载器在perm里产生的对象。可以指定间隔时间及执行次数 ========其它======= 16 : 打印finalzer队列情况 17 : 显示classloader统计 18 : 显示jit编译统计 19 : 死锁检测 20 : 等待X秒，默认为1 q : exit </pre>
进入jvm工具后可以输入序号执行对应命令
可以一次执行多个命令，用分号";"分隔，如：1;3;4;5;6
每个命令可以带参数，用冒号":"分隔，同一命令的参数之间用逗号分隔，如：
Enter command queue:1;5:1000,100;10:/data1/output.bin
更多介绍请参考：https://github.com/qdaxb/wtool_java

参与开发

目录说明

.
├── common        
    └── tools    # 通用工具目录
└── custom       # 自定义模块目录

如何增加原生命令

在wtool根目录中创建文件夹，如：mygroup/tools
在tools文件夹中新建文件，文件名与命令名相同，如:mycommand，并对mycommand文件增加执行权限。
实现命令，每个命令是一个独立的shell脚本，如:

#!/bin/bash

this is desp

echo "hello world"


4. 测试命令是否可用

    ```
$ wtool list                                                                                                                                                  ~/dev/wtool/mygroup/tools
Available commands:
mygroup:
mycommand      : this is desp
$ wtool mycomomand
hello world

提交PR:)

如何开发自己的模块

在github上创建工程，如https://github.com/qdaxb/demo_module
在工程根目录中创建文件夹tools
在tools文件夹中新建文件，文件名与命令名相同，如:mycommand，并对mycommand文件增加执行权限。
实现命令，每个命令是一个独立的shell脚本，如:

#!/bin/bash

this is desp

echo "hello world"


4. 使用方通过addmodule获取模块

   ``` $ wtool addmodule qdaxb/demo_module```
   
5. enjoy

    ```
$ wtool list                                                                                                                                                  
Available commands:
qdaxb_demo_module:
mycommand      : this is desp
$ wtool mycomomand
hello world