Merge pull request #66 from jpsim/jp-xcodebuild-log-file

Improve error reporting when compiler arguments can't be parsed.

CHANGELOG.md

@@ -1,3 +1,20 @@
+## Master
+
+##### Breaking
+
+None.
+
+##### Enhancements
+
+* Improve error reporting when compiler arguments can't be parsed and log
+  `xcodebuild` output to file instead of stderr.  
+  [JP Simard](https://github.com/jpsim)
+
+##### Bug Fixes
+
+None.
+
+
 ## 0.5.0
 
 ##### Breaking

Source/SourceKittenFramework/Module.swift

@@ -6,6 +6,8 @@
 //  Copyright (c) 2015 SourceKitten. All rights reserved.
 //
 
+import Foundation
+
 /// Represents source module to be documented.
 public struct Module {
     /// Module Name.
@@ -42,7 +44,10 @@ public struct Module {
         let xcodeBuildOutput = runXcodeBuild(xcodeBuildArguments, inPath: path) ?? ""
         guard let arguments = parseCompilerArguments(xcodeBuildOutput, language: .Swift, moduleName: name ?? moduleNameFromArguments(xcodeBuildArguments)) else {
             fputs("Could not parse compiler arguments from `xcodebuild` output.\n", stderr)
-            fputs("\(xcodeBuildOutput)\n", stderr)
+            fputs("Please confirm that `xcodebuild` is building a Swift module.\n", stderr)
+            let file = NSURL(fileURLWithPath: NSTemporaryDirectory()).URLByAppendingPathComponent("xcodebuild-\(NSUUID().UUIDString).log")
+            xcodeBuildOutput.dataUsingEncoding(NSUTF8StringEncoding)?.writeToURL(file, atomically: true)
+            fputs("Saved `xcodebuild` log file: \(file.path!)\n", stderr)
             return nil
         }
         guard let moduleName = moduleNameFromArguments(arguments) else {