Stata 命令 wmt 的更新——查询并安装个人写的 Stata 新命令

作者：王美庭
Email: wangmeiting92@gmail.com

一、引言

为了命令使用更方便，我们对该命令进行了如下更新：

修复了该命令不能描述和安装个人写的最新命令的 bug；
增加了wmt update功能，用以更新wmt命令本身（即等同于wmt install wmt, replace）。

同时我也更新了本文档（旧文档参见 Stata 新命令：wmt——查询并安装个人写的 Stata 新命令），详情如下：

创建微信公众号以来，个人已发布过 18 个 Stata 命令。这些命令都是为了解决自己某一方面问题而书写的，后面新命令的发布也会继续秉承这样的原则。也许大家会说在哪里发现了类似的命令，不过还请大家不要见怪，因为：

你发现了功能类似的命令，但是我刚好没有看到。
我也发现了，但由于有强迫症的我，对于现有命令的某些细节还是不满意，于是就自己写一个。（读者可以对比一下我写的fn命令和现有的fs命令）

通过与大家在微信公众号后台和邮件中的交流，发现这些命令对于大家来说还是有一定用处的。由于现有安装 github 中托管的 Stata 命令的语句有些长以及存在着一定的问题：

net install的语句太长，记不住
github install不能自动提示已经存在的命令

所以个人基于简洁语法的原则和 Stata 自带命令net的内核，创建了一个专门用于安装我个人所写命令的命令。该命令具有以下特点：

可以查询并安装所有我写过的命令。所有我写过的命令可以help wmt或在本文第六节进行查看。
语法简洁易记，与我们常用的ssc describe...和ssc install ...语法一致。
对于已经存在的命令都会进行提示。如果内容与远端的不一样，则必须加上replace或force选项才能进行安装。
使用wmt update能实现对命令wmt本身的更新。
使用命令后运行return list可以得到以下返回值：（1）用户所要查询或安装的命令；（2）用户所有查询或安装的命令的数量；（3）所有我个人已经写过的命令。

二、命令的安装

wmt及本人其他命令的代码都托管于 GitHub 上，读者可随时下载安装这些命令：

net install wmt, from("https://raw.githubusercontent.com/Meiting-Wang/wmt/main")

三、语法与选项

查询单个或多个个人所写的命令：

wmt describe commands

describe: 最短可以缩写为d

安装单个或多个个人所写的命令：

wmt install commands [, replace force]

install: 最短可以缩写为i

replace: 如果安装文件已存在且不一样，则替换之；如果一样，则不做任何操作

force: 如果安装文件已存在(无论是否一样)，都强制替换之

更新wmt命令本身：

wmt update

update: 最短可以缩写为u

四、实例

* 描述或安装单个命令
wmt describe mas //查询一下 mas 命令(含 title、description、authors、installation files)
wmt install mas //安装命令 mas。如果文件已存在且不一样，则会告诉你哪些文件不一样，但不做任何操作
wmt install mas, replace //安装命令 mas。如果安装文件已存在且不一样，则替换之；如果一样，则不做任何操作
wmt install mas, force //安装命令 mas。如果安装文件已存在(无论是否一样)，都强制替换之
return list //返回值

* 描述或安装多个命令
wmt describe fn mas
wmt install fn mas
wmt install fn mas, replace
wmt install fn mas, force
return list //返回值

* 更新命令 wmt 本身
wmt update

五、输出展示

wmt describe fn mas

------------------------------------------------------------------------------
package fn from https://raw.githubusercontent.com/Meiting-Wang/fn/main
------------------------------------------------------------------------------

TITLE
      fn. Return the name and path of the specified files

DESCRIPTION/AUTHOR(S)
      Meiting Wang
      Institute for Economic and Social Research, Jinan University
      Guangzhou, China
      wangmeiting92@gmail.com

INSTALLATION FILES                                   (type net install fn)
      fn.ado
      fn.sthlp
------------------------------------------------------------------------------


------------------------------------------------------------------------------
package mas from https://raw.githubusercontent.com/Meiting-Wang/mas/main
------------------------------------------------------------------------------

TITLE
      mas. Perform matching and substituting operations on text files

DESCRIPTION/AUTHOR(S)
      Meiting Wang
      Institute for Economic and Social Research, Jinan University
      Guangzhou, China
      wangmeiting92@gmail.com

INSTALLATION FILES                                  (type net install mas)
      mas.ado
      mas_main.ado
      mas_del.ado
      mas_coa.ado
      mas.sthlp
------------------------------------------------------------------------------

wmt install fn mas, force

------------------------------------------------------------------------------
checking fn consistency and verifying not already installed...

the following files will be replaced:
    D:\stata16/ado\plus\f\fn.ado
    D:\stata16/ado\plus\f\fn.sthlp

installing into D:\stata16/ado\plus\...
installation complete.
------------------------------------------------------------------------------
checking mas consistency and verifying not already installed...

the following files will be replaced:
    D:\stata16/ado\plus\m\mas.ado
    D:\stata16/ado\plus\m\mas_main.ado
    D:\stata16/ado\plus\m\mas_del.ado
    D:\stata16/ado\plus\m\mas_coa.ado
    D:\stata16/ado\plus\m\mas.sthlp

installing into D:\stata16/ado\plus\...
installation complete.
------------------------------------------------------------------------------

wmt update

-------------------------------------------------------------------------------
checking wmt consistency and verifying not already installed...
all files already exist and are up to date.
-------------------------------------------------------------------------------

六、目前我发布过的所有命令

点击【阅读原文】可进入该命令的 github 项目。

Meiting-Wang / wmt