aminaura/xTextHandler

Xcode Source Editor Extension Tools (Xcode 8 Plugins)

Let's Swift!

xTextHandler has been rewritten in Swift. The Objective-C version can be found in: https://github.com/cyanzhong/xTextHandler-objc

🇨🇳中文介绍

xTextHandler

Xcode Source Editor Extension Tools (Xcode 8 Plugins)

What is it

Xcode Source Editor Extension based tools to improve the text editing experience of Xcode 8 and provide extensions with simple code.

Features

• Multiline Selections
• Multiple Extensions
• Extendable (Example: Dotify)
• Swift 3.0
• Clipboard Text Handling (if no selection is made)
• Regular Expression Matching
• Error handling
• Preferences panel
• JavaScript for text handling

xEncode

• Base64 Encode
• Base64 Decode
• URL Encode
• URL Decode
• Upper Case
• Lower Case
• Escape
• MD5
• SHA1
• SHA256
• QR Code

xRadix

• Hex
• Bin
• Oct
• Dec

xColor

• Hex
• RGB
• Preview

xSearch

• Google
• Translate
• Developer
• StackOverflow
• GitHub
• Dash
• Dictionary

xFormat

• JSON
• XML
• CSS
• SQL

Thanks to: vkBeautify

Usage

0. Install Xcode 8
1. sudo /usr/libexec/xpccachectl in macOS EI Capitan
2. Sign every targets (app & extensions) using your developer certificate
3. Build & Run
4. Choose Xcode 8 to debug (Or restart Xcode)
5. Select text
6. Open Editor menu to find extensions
7. You can set a shortcut (Key-Binding) for each extension

How to write a new Extension

Add definition in Plist:

<dict>
    <key>XCSourceEditorCommandClassName</key>
    <string>aClassName</string>
    <key>XCSourceEditorCommandIdentifier</key>
    <string>test.extension</string>
    <key>XCSourceEditorCommandName</key>
    <string>Test Extension</string>
</dict>

Map handler via commandIdentifier in class:

// Implement your modify strategy using block (you can implement as singleton dict)
// [ "commandIdentifier": handler ]
override func handlers() -> Dictionary<String, xTextModifyHandler> {
    return [
        "test.extension": { text: String -> String in text }
    ]
}

* Handle with regex:

// Override performCommandWithInvocation like that
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)
}

Contacts