# xTextHandler

**Repository Path**: dssljt/xTextHandler

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2018-12-10
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 下载
<a href="https://itunes.apple.com/app/id1163761963">![](https://cdn.rawgit.com/cyanzhong/xTextHandler/master/mas.svg)</a>

# Let's Swift!
[![Language](https://img.shields.io/badge/language-Swift%203.0-orange.svg)](https://swift.org/)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/cyanzhong/xTextHandler/blob/master/LICENSE)

`xTextHandler` 已经完全使用 `Swift` 重写，你可以在这里找到 `Objective-C` 版本：https://github.com/cyanzhong/xTextHandler-objc

# xTextHandler
Xcode Source Editor 插件集

# 这是什么
基于 [Xcode Source Editor Extension](https://developer.apple.com/videos/play/wwdc2016/414/) 的插件集，提高 `Xcode 8` 的文本处理的体验，你可以通过简单的几行代码扩展它

# 特点
- [x] 支持文本多行选择
- [x] 支持多个类型的插件
- [x] 易扩展（示例：[Dotify](https://github.com/cyanzhong/Dotify)）
- [x] Swift 3.0
- [x] 支持剪贴板文本（当没有选择文本，处理剪贴板文本）
- [x] 提供基于正则表达式的匹配
- [ ] 错误处理
- [ ] App 配置面板
- [ ] JavaScript 组件

# 下载安装
0. 如果之前编译过 xTextHandler，清除 DrivedData
1. 在这里安装：https://itunes.apple.com/app/id1163761963
2. 打开 Xcode 并选择文本
3. 在 `Editor` 菜单中找到插件
4. 你可以给每个插件都设置一个独立的`快捷键`
5. 在安装之后你可能找不到菜单，应该是 XcodeKit 的一个 bug，你可以尝试编译安装

# 插件设置
![image](https://raw.githubusercontent.com/cyanzhong/xTextHandler/master/Screenshots/tips1.png)
![image](https://raw.githubusercontent.com/cyanzhong/xTextHandler/master/Screenshots/tips2.png)

# 编译安装
0. 安装 `Xcode 8`
1. 在 `macOS EI Capitan` 上面需要执行 `sudo /usr/libexec/xpccachectl`
2. 对每一个 target 进行签名，包括 app 和 extensions
3. 编译运行项目
4. 选择 `Xcode 8` 进行调试（或者重启 Xcode）
5. 选择文本
6. 在 `Editor` 菜单中找到插件
7. 你可以给每个插件都设置一个独立的`快捷键`

## xEncode
![image](https://raw.githubusercontent.com/cyanzhong/xTextHandler/master/GIFs/xEncode.gif)
- Base64 Encode
- Base64 Decode
- URL Encode
- URL Decode
- Upper Case
- Lower Case
- Escape
- MD5
- SHA1
- SHA256
- QR Code

## xRadix
![image](https://raw.githubusercontent.com/cyanzhong/xTextHandler/master/GIFs/xRadix.gif)
- Hex
- Bin
- Oct
- Dec

## xColor
![image](https://raw.githubusercontent.com/cyanzhong/xTextHandler/master/GIFs/xColor.gif)
- Hex
- RGB
- Preview

## xSearch
![image](https://raw.githubusercontent.com/cyanzhong/xTextHandler/master/GIFs/xSearch.gif)
- Google
- Translate
- Developer
- StackOverflow
- GitHub
- Dash
- Dictionary

## xFormat
![image](https://raw.githubusercontent.com/cyanzhong/xTextHandler/master/GIFs/xFormat.gif)
- JSON
- XML
- CSS
- SQL

感谢：[`vkBeautify`](https://github.com/vkiryukhin/vkBeautify)

# 如何实现一个新的 Extension
### 在 `Plist` 中添加定义：
```xml
<dict>
    <key>XCSourceEditorCommandClassName</key>
    <string>aClassName</string>
    <key>XCSourceEditorCommandIdentifier</key>
    <string>test.extension</string>
    <key>XCSourceEditorCommandName</key>
    <string>Test Extension</string>
</dict>
```
### 在实现类中映射你需要的处理函数：
```objc
// 在这个字典里面根据 `identifier` 映射 `block`，你可以实现一个字典单例
// [ "commandIdentifier": handler ]
override func handlers() -> Dictionary<String, xTextModifyHandler> {
    return [
        "test.extension": { (text: String) -> (String) in text }
    ]
}
```
### * 处理`正则表达式`
```objc
// 重写这个方法，使用 `select` 方法传递你需要的正则表达式
override func perform(with invocation: XCSourceEditorCommandInvocation, completionHandler: (NSError?) -> Void) {
    if let handler = self.handlers()[invocation.commandIdentifier] {
        xTextModifier.select(invocation: invocation, pattern: "regex", handler: handler)
    }
    completionHandler(nil)
}
```

# 联系方式
[![Weibo](https://img.shields.io/badge/weibo-%20@StackOverflowError%20-red.svg)](http://weibo.com/0x00eeee/)
[![Twitter](https://img.shields.io/badge/twitter-@cyanapps-green.svg)](https://twitter.com/cyanapps)
[![Email](https://img.shields.io/badge/email-log.e@qq.com-blue.svg)](mailto:log.e@qq.com)