怎样使用Swift创建命令行脚本(2)
-
作者: Ben Snider
( 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/special/translation/
-
本文仅用于学习和交流目的,转载请注明文章译者、出处和本文链接。
-
感谢 博文视点 对本期活动的支持