怎样使用Swift创建命令行脚本(2)

MarjorieBan 8年前

part 1译文

欢迎回来!在上一节中,我们已经讲述了使用Swift语言搭配 OptionKit 来创建一个简单的命令行脚本。在本节中(最后一节)。我们将整理所有的思路,然后在之前已经创建的基于Apple Foundation的类中的方法来实现我们的BTC(比特币)命令行价格查询器。

回顾第一部分,我们学会了如何:

  • 从命令行直接调用Swift脚本

  • 使用 Carthage 管理带有Swift脚本的库

  • 使用OptionKit框架来解析命令行参数

在这篇博客中,我们将学习到如何利用上述所有来创建一个Swift脚本查询BTC的价格。同时也将学到怎样使用一个URL从 BitStamp API 中请求数据,然后解析这些请求回来的JSON数据,最后为用户打印出他们需要的结果信息。当然我们也能够看到,怎么编译这些Swift脚本--为一个可执行的二进制以便节约执行时间。

完成后,我们就有了一个能够打印出最新BTC美元价格的脚本了,你还可以添加参数来指定计算价格的时间区间.这个区间参数,我们可以指定为最新(默认),每小时,以及“ vwap ”等类型。OptionKit生成的帮助信息也能够告诉我们关于如何调用这些脚本。不出意外,我们应该可以像下面这样运行:

$ ./btc.swift  335.45    $ ./btc.swift --interval hourly  338.27

命令行参数

首先,让我们先定义将如何接受用户输入。使用OptionKit,我们可以很容易的进行设置。基于之前演示的options.swift的修改版本,我将创建一个新的文件btc.swift,文件中包含如下代码:

正如我们所看到的,它与之前的option.swift脚本及其相似。最大的区别在于这我们是从一个方法的返回值中获取到—interval参数的。这样我们封装参数解析逻辑,所以我们就可以专注于实现其他功能。

于此同时,我们还需要花点时间来将从OptionKit得到的interval可选字符串,转换为Swift 枚举类型,便于后面方便使用。我们只需要写如下一些简单的代码就可以来实现:

URL载入

到目前为止,我们已经完成了参数解析,下一步工作就是根据用户选择的interval类型来加载URL。通过BitStamp,实际上是两个具有相同的JSON返回格式的URL。接下来,我们编写一个函数,确定正确的URL并使用Foundation框架中的NSURLSession类来发起一个网络请求。

在实现URL加载之前,我们需要实现调用函数,因此要考虑有哪些数据要传递。

在这里可以看到这些仍然建立在参数解析函数中,虽然开始调用实际的方法来检索和解析价格数据。我选择实现带有一个闭包作为参数的retrievePriceData函数。当网络请求完成之后(无论成功还是失败),闭包将会被调用。传递给闭包的参数是可选类型的,这可以让我们在网络成功或者失败情况下,分别对这两种情况进行处理。也有可能对实际响应返回的数据解析失败,所以parsePrice的返回值也是可选的。

这样带有if let block是一个很好的封装处理,如果一切顺利,将会打印出获取的价格。

接下来我们开始着手说说如何实现retrievePriceData方法。核心就是使用基于Foundation框架的NSURLSession类来完成实际的网络请求。如果网络请求成功,将可以通过所提供的闭包返回NSData类型的数据给调用者,否则就只需要返回nil值。

func bitstampURL(interval: IntervalType) -> NSURL {      if (interval == .LastIntervalType || interval == .VWAPIntervalType) {          return NSURL(string: "https://www.bitstamp.net/api/ticker/")!      } else {          return NSURL(string: "https://www.bitstamp.net/api/ticker_hour/")!      }  }    func retrievePriceData(interval: IntervalType, completion: NSData? -> Void) -> Void {      let          url = bitstampURL(interval),          request = NSURLRequest(URL: url),          session = NSURLSession.sharedSession(),          semaphore = dispatch_semaphore_create(0)                let task = session.dataTaskWithRequest(request) {           (data, response, error) -> Void in          if error == nil {              completion(data)          } else {              completion(nil)          }          dispatch_semaphore_signal(semaphore)      }      task.resume()            dispatch_semaphore_wait(semaphore, DISPATCH_TIME_FOREVER)  }

这里比较复杂的地方就是,命令行脚本的执行,会在最后一个函数返回后结束。然而,NSURLSession提供给我们的是一个异步的接口,在网络调用完成之前,这个方法就已经返回。所以为了解决这一点,我们需要使用 GCD 的信号灯( semaphore )来阻塞主线程,直到网络请求完成。

JSON解析

我们剩下的最后一个任务就是解析retriecePriceData返回的数据,我们将使用parsePrice函数对之进行解析。我们通过BitStamp API获取的数据是如下JSON格式:

{      high: "502.00",      last: "446.02",      timestamp: "1446693126",      bid: "446.03",      vwap: "445.3",      volume: "108095.47008023",      low: "368.11",      ask: "446.60",      open: 407.99  }

我们主要关注的是last和vwap属性,但是需要解析整个对象为字典类型数据,然后返回我们所关注的值即可。所以,我们接下来使用Foundation框架中带有一些有条件的费覆盖的NSJSONSerialization类,来进行处理:

func priceKey(interval: IntervalType) -> String {      if (interval == .LastIntervalType || interval == .HourlyIntervalType) {          return "last"      } else {          return "vwap"      }  }    func parsePrice(interval: IntervalType, data: NSData) -> Double? {      do {          let json = try NSJSONSerialization.JSONObjectWithData(data, options: [])          if let              priceData = json as? Dictionary,              priceString = priceData[priceKey(interval)] as? String {              // Using the failable initializer to convert to a Double?              return Double(priceString)          }      } catch {          // died parsing the JSON      }      return nil  }

运行和编译 我们已经完成准备工作了!全部的 entire script 源码都在我们的github上,可以给你提供一些参考。它实现了我们最初设想的所有需求,为了更清楚的看到效果,我们来运行看看:

$ ./btc.swift -i vwap  333.95    $ ./btc.swift --interval hourly  334.05

使用上面这些命令,我们已经可以把程序作为一个脚本来运行:Swift能够动态编译和执行它。如果我们想要直接编译btc.swift成可执行文件,然后运行它。

在我做过多次尝试之后发现,它不能使用swiftc动态链接到第三方库。虽然可以正常编译btc.swift脚本,但是在运行的时候,还是不能引用到OptionKit框架。我怀疑移除OptionKit依赖或许能够正常编译这个脚本。如果有人知道怎么能让这个正常工作,那就太感谢了。

你可以用下面的命令来编译执行,这样就能看到,在运行的时候报错了:

# Compile using swiftc  $ xcrun -sdk macosx swiftc -F Carthage/Build/Mac/ btc.swift -o btc    # Attempt to run  $ ./btc  dyld: Library not loaded: @rpath/OptionKit.framework/Versions/0/OptionKit

总结

除了把脚本编译成可执行文件外,我们已经完成了全部工作。我们已经解决了加载第三方库、解析命令行参数、加载远程的JSON数据以及将这些JSON数据解析成我们能够熟练操纵的Swift数据类型。到此,已经编写好了一个可运行的脚本来通过BitStamp监测比特币的价格。通过完成这个功能,我们也了解到了一些Swift语言的新特性。

所以,通过这样一个专题的讲解,我希望你们都认同专题中预期的结论,同时也能够学到更多的新知识。我个人希望这个专题作为Swift脚本语言开发的一个入门实例,当我们使用命令行脚本时,帮助解决我们所面临的一些比较常见的问题。感谢苹果公司为我们提供这样一种非常棒的编程语言,它不仅能够非常灵活简洁地让我们开发一个复杂的iOS应用,也支持像我们上面所写的例子中使用更加简单的脚本进行编程。我很期待Swift脚本能更多应用在其他的方面,希望Swift的开源发布,能够使Swift脚本进入到Linux系统一个新的起点。

来自: http://www.cocoachina.com/swift/20160122/15082.html