/Snowonder

🔮 Magical import declarations formatter for Xcode

Primary LanguageSwiftMIT LicenseMIT

Header

Snowonder is Xcode Extension that adds some convenient formatting operations for Import Declarations. This extension is created with latest stable Swift release and fully open source. Snowonder is based on official Apple's XcodeKit which supports only Xcode of versions 8 and higher. If you're looking for a Snowonder that is compatible with Xcode 7.3 version please check legacy branch.

Important! 🌟 If you've experienced some trouble using Snowonder, please submit an issue with a description. This is the simpliest way to make the project better.

Build Status

Features

  • Adding Import Declarations from anywhere in code
  • Import Declarations categorization
  • Alphabetical sorting of Import Declarations in scope of category
  • Duplicated Import Declarations filtering
  • Both Swift and Objective-C programming languages support
  • Load config from JSON. Implemented in config branch, but stopped working after Xcode 10 release. Check #27
  • Command Line Interface (CLI)

Installation

  1. Clone this repo and build Snowonder target via Xcode to get the app
  2. Close Xcode if it's currently running
  3. Put Snowonder.app into Applications folder and run it
  4. Click Enable Extension button
  5. Enable Snowonder in opened window. See screenshot below Enables
  6. Launch Xcode and check if Editor > Snowonder Extension is available

Usage

After installation you will be able to format import declarations on any file by selecting Editor > Snowonder Extension > Format Import Declarations or you can just simply setup shoutcut for this command.

Updating

To update Snowonder just replace the old Snowonder.app with updated verson.

Uninstallation

To uninstall just put Snowonder.app into Trash.

License

Released under the MIT License. See LICENSE.md.