受到《Go 终极指南:编写一个 Go 工具》的启发,萌生了把 gomodifytags 封装成emacs-plugin的想法, 然后经过两周的努力,诞生了emacs-go-tag。 emacs-go-tag
实现了两个命令: go-tag-add
添加结构体字段tag, go-tag-remove
删除结构体字段tag。
安装依赖
emacs-go-tag
有两个依赖项, gomodifytags
和 go-mode.el,若使用emacs做Go开发 go-mode.el
应该已经在使用了。 gomodifytags安装如下:
go get -u github.com/fatih/gomodifytags
安装
目前emacs-go-tag已发布到了MELPA上,可使用如下命令安装:
M-x package-install [RET] go-tag [RET]
若是没发现go-tag,你需要使用如下命令来刷新,然后在使用上面的命令进行安装:
M-x package-refresh-contents [RET]
配置
目前 gomodifytags
支持三种转换如下:
- snakecase: BaseDomain -> base_domain
- camelcase: BaseDomain -> baseDomain
- lispcase: BaseDomain -> base-domain
默认使用 snakecase
, 若你准备使用 camelcase
, 可配置如下:
(setq go-tag-args (list "-transform" "camelcase"))
快捷键配置示例:
(with-eval-after-load 'go-mode
(define-key go-mode-map (kbd "C-c t") #'go-tag-add)
(define-key go-mode-map (kbd "C-c T") #'go-tag-remove))
使用说明
若是你有使用 vim-go 的 GoAddTags
和 GoRemoveTags
命令的经验, 那么你会很快上手 emacs-go-tag
, 因为两者的行为完全一致(若有不同,请反馈)。
go-tag-add
:[range] go-tag-add [key],[option] [key1],[option] …
为结构体字段添加tag。如果在一个结构中调用,会自动添加json字段tag。 若在结构体之外调用,或者文件格式不正确,则会给出错误消息。
如果给出 [range]
,则只有选定的字段将被改变。
默认的json可以通过提供一个或多个 [key]
参数来改变。 添加xml和db的例子是:
:go-tag-add xml db
若提供了 [option]
也提供了,会在添加tag时,一同添加 option
, 或者修改已存在的tag。 如下:
:go-tag-add json,omitempty
也可以定义一个常数值而不是默认的基于字段的值。 例如,以下命令将添加`valid:"1"`到所有字段。
:go-tag-add valid=1
go-tag-remove
:[range] go-tag-add [key],[option] [key1],[option] …
移除结构字段的字段标记。 如果在一个结构中调用,它会自动删除所有的字段tag。 如果在结构体定义之外调用,或者文件格式不正确,则会给出错误消息。
如果给出 [range]
,则只有选定的字段将被改变。
如果给出 [key]
,则只会删除这些key相关的tag。 如下只删除json相关的tag:
:go-tag-remove json
如果 [option]
和 [key]
一同传递,则只会删除 option
。 例如,下面命令只会从包含json的字段中删除omitempty选项:
:go-tag-remove json,omitempty
最后
感谢 GoCN每日新闻
的每日推送,让我得以读到 《Go 终极指南:编写一个 Go 工具》, 然后得以完成这个emacs-plugin
。 项目地址:https://github.com/brantou/emacs-go-tag, 欢迎大家来使用和来提问题,若是你觉得对你有帮助, 就给颗星
吧。