https://github.com/wangshengjia/VWInstantRun

An Xcode plugin let you build & run your selected lines of code in Xcode without running the whole project, you'll have the output instantly in your Xcode console.
https://github.com/wangshengjia/VWInstantRun

Last synced: 3 months ago
JSON representation

An Xcode plugin let you build & run your selected lines of code in Xcode without running the whole project, you'll have the output instantly in your Xcode console.

• Host: GitHub
• URL: https://github.com/wangshengjia/VWInstantRun
• Owner: wangshengjia
• License: mit
• Created: 2015-12-25T21:41:48.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2017-05-13T21:54:07.000Z (over 7 years ago)
• Last Synced: 2024-06-19T06:05:36.001Z (5 months ago)
• Language: Swift
• Homepage:
• Size: 831 KB
• Stars: 1,028
• Watchers: 24
• Forks: 52
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## ⚠️⚠️

#### This plugin do not support Xcode 8+.

## VWInstantRun

Have you ever wanted to test out a small snippet of code in Xcode without executing the whole project ?

Now with VWInstantRun, you won't run into this situation any more. An Xcode plugin let you build & run your selected lines of code in Xcode without running the whole project, you'll have the output instantly in your Xcode console.

### Objective C

![](run_objc_code_1.gif)

### Swift

![](run_swift_code_1.gif)

![](run_swift_code_2.gif)

### Installation

Installation: You can clone or just download the project, then open project with Xcode, 

build and run project, and finally restart Xcode to active plugin.

### Alcatraz

Another way more easier option: This plugin can also be installed using [Alcatraz](https://github.com/alcatraz/alcatraz-packages). 

Just search for `VWInstantRun` in [Alcatraz](https://github.com/alcatraz/alcatraz-packages).

### Usage

Generally you just select your code in Xcode, then either use hotkey `⌘⌥⇧ + R` or go to `Product -> Instant Run` to 

build and run the lines of code selected. 

### Limitations

The purpose of this plugin is to run your code snippet instantly without building the whole project, so obviously it do have some limitations.

- The code selected should be isolated completely from other contexts (such as instance property, self, or there function, etc…), otherwise you will only have some compiler errors when you run that code snippet.

- Usually you need to add some stub values as input and add `print()` phrase to actually view your output in console view.

- For now, it only support Foundation module.

**This plugin certainly can not and should not replace your unit tests, at all. The suitable case is to test and prove some tiny doubts as I mentioned in blog.**

### Todo List

This plugin is still in a very early stage, here is a TODO list to show you a simple roadmap.

- [x] Swift code support.

- [x] Objective-C code support.

### More information

- You can checkout more implementation details in this [blog post](https://medium.com/@victor_wang/run-your-code-snippet-from-xcode-without-building-the-whole-project-1821cf85b2f2#.rkcfjqcl5).

- If you have __anything__ want to talk, feel free to raise an issue or say hello on Twitter to [@wangshengjia](https://twitter.com/wangshengjia), on Weibo to [@ShengjiaWang](http://www.weibo.com/1739447693/profile?topnav=1&wvr=6&is_all=1)

Enjoy :tada::tada: