SignalSpec.swift 52 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264
  1. //
  2. // SignalSpec.swift
  3. // ReactiveCocoa
  4. //
  5. // Created by Justin Spahr-Summers on 2015-01-23.
  6. // Copyright (c) 2015 GitHub. All rights reserved.
  7. //
  8. import Result
  9. import Nimble
  10. import Quick
  11. import ReactiveCocoa
  12. class SignalSpec: QuickSpec {
  13. override func spec() {
  14. describe("init") {
  15. var testScheduler: TestScheduler!
  16. beforeEach {
  17. testScheduler = TestScheduler()
  18. }
  19. it("should run the generator immediately") {
  20. var didRunGenerator = false
  21. _ = Signal<AnyObject, NoError> { observer in
  22. didRunGenerator = true
  23. return nil
  24. }
  25. expect(didRunGenerator) == true
  26. }
  27. it("should forward events to observers") {
  28. let numbers = [ 1, 2, 5 ]
  29. let signal: Signal<Int, NoError> = Signal { observer in
  30. testScheduler.schedule {
  31. for number in numbers {
  32. observer.sendNext(number)
  33. }
  34. observer.sendCompleted()
  35. }
  36. return nil
  37. }
  38. var fromSignal: [Int] = []
  39. var completed = false
  40. signal.observe { event in
  41. switch event {
  42. case let .Next(number):
  43. fromSignal.append(number)
  44. case .Completed:
  45. completed = true
  46. default:
  47. break
  48. }
  49. }
  50. expect(completed) == false
  51. expect(fromSignal).to(beEmpty())
  52. testScheduler.run()
  53. expect(completed) == true
  54. expect(fromSignal) == numbers
  55. }
  56. it("should dispose of returned disposable upon error") {
  57. let disposable = SimpleDisposable()
  58. let signal: Signal<AnyObject, TestError> = Signal { observer in
  59. testScheduler.schedule {
  60. observer.sendFailed(TestError.Default)
  61. }
  62. return disposable
  63. }
  64. var errored = false
  65. signal.observeFailed { _ in errored = true }
  66. expect(errored) == false
  67. expect(disposable.disposed) == false
  68. testScheduler.run()
  69. expect(errored) == true
  70. expect(disposable.disposed) == true
  71. }
  72. it("should dispose of returned disposable upon completion") {
  73. let disposable = SimpleDisposable()
  74. let signal: Signal<AnyObject, NoError> = Signal { observer in
  75. testScheduler.schedule {
  76. observer.sendCompleted()
  77. }
  78. return disposable
  79. }
  80. var completed = false
  81. signal.observeCompleted { completed = true }
  82. expect(completed) == false
  83. expect(disposable.disposed) == false
  84. testScheduler.run()
  85. expect(completed) == true
  86. expect(disposable.disposed) == true
  87. }
  88. it("should dispose of returned disposable upon interrupted") {
  89. let disposable = SimpleDisposable()
  90. let signal: Signal<AnyObject, NoError> = Signal { observer in
  91. testScheduler.schedule {
  92. observer.sendInterrupted()
  93. }
  94. return disposable
  95. }
  96. var interrupted = false
  97. signal.observeInterrupted {
  98. interrupted = true
  99. }
  100. expect(interrupted) == false
  101. expect(disposable.disposed) == false
  102. testScheduler.run()
  103. expect(interrupted) == true
  104. expect(disposable.disposed) == true
  105. }
  106. }
  107. describe("Signal.empty") {
  108. it("should interrupt its observers without emitting any value") {
  109. let signal = Signal<(), NoError>.empty
  110. var hasUnexpectedEventsEmitted = false
  111. var signalInterrupted = false
  112. signal.observe { event in
  113. switch event {
  114. case .Next, .Failed, .Completed:
  115. hasUnexpectedEventsEmitted = true
  116. case .Interrupted:
  117. signalInterrupted = true
  118. }
  119. }
  120. expect(hasUnexpectedEventsEmitted) == false
  121. expect(signalInterrupted) == true
  122. }
  123. }
  124. describe("Signal.pipe") {
  125. it("should forward events to observers") {
  126. let (signal, observer) = Signal<Int, NoError>.pipe()
  127. var fromSignal: [Int] = []
  128. var completed = false
  129. signal.observe { event in
  130. switch event {
  131. case let .Next(number):
  132. fromSignal.append(number)
  133. case .Completed:
  134. completed = true
  135. default:
  136. break
  137. }
  138. }
  139. expect(fromSignal).to(beEmpty())
  140. expect(completed) == false
  141. observer.sendNext(1)
  142. expect(fromSignal) == [ 1 ]
  143. observer.sendNext(2)
  144. expect(fromSignal) == [ 1, 2 ]
  145. expect(completed) == false
  146. observer.sendCompleted()
  147. expect(completed) == true
  148. }
  149. context("memory") {
  150. it("should not crash allocating memory with a few observers") {
  151. let (signal, _) = Signal<Int, NoError>.pipe()
  152. for _ in 0..<50 {
  153. autoreleasepool {
  154. let disposable = signal.observe { _ in }
  155. disposable!.dispose()
  156. }
  157. }
  158. }
  159. }
  160. }
  161. describe("observe") {
  162. var testScheduler: TestScheduler!
  163. beforeEach {
  164. testScheduler = TestScheduler()
  165. }
  166. it("should stop forwarding events when disposed") {
  167. let disposable = SimpleDisposable()
  168. let signal: Signal<Int, NoError> = Signal { observer in
  169. testScheduler.schedule {
  170. for number in [ 1, 2 ] {
  171. observer.sendNext(number)
  172. }
  173. observer.sendCompleted()
  174. observer.sendNext(4)
  175. }
  176. return disposable
  177. }
  178. var fromSignal: [Int] = []
  179. signal.observeNext { number in
  180. fromSignal.append(number)
  181. }
  182. expect(disposable.disposed) == false
  183. expect(fromSignal).to(beEmpty())
  184. testScheduler.run()
  185. expect(disposable.disposed) == true
  186. expect(fromSignal) == [ 1, 2 ]
  187. }
  188. it("should not trigger side effects") {
  189. var runCount = 0
  190. let signal: Signal<(), NoError> = Signal { observer in
  191. runCount += 1
  192. return nil
  193. }
  194. expect(runCount) == 1
  195. signal.observe(Observer<(), NoError>())
  196. expect(runCount) == 1
  197. }
  198. it("should release observer after termination") {
  199. weak var testStr: NSMutableString?
  200. let (signal, observer) = Signal<Int, NoError>.pipe()
  201. let test = {
  202. let innerStr: NSMutableString = NSMutableString()
  203. signal.observeNext { value in
  204. innerStr.appendString("\(value)")
  205. }
  206. testStr = innerStr
  207. }
  208. test()
  209. observer.sendNext(1)
  210. expect(testStr) == "1"
  211. observer.sendNext(2)
  212. expect(testStr) == "12"
  213. observer.sendCompleted()
  214. expect(testStr).to(beNil())
  215. }
  216. it("should release observer after interruption") {
  217. weak var testStr: NSMutableString?
  218. let (signal, observer) = Signal<Int, NoError>.pipe()
  219. let test = {
  220. let innerStr: NSMutableString = NSMutableString()
  221. signal.observeNext { value in
  222. innerStr.appendString("\(value)")
  223. }
  224. testStr = innerStr
  225. }
  226. test()
  227. observer.sendNext(1)
  228. expect(testStr) == "1"
  229. observer.sendNext(2)
  230. expect(testStr) == "12"
  231. observer.sendInterrupted()
  232. expect(testStr).to(beNil())
  233. }
  234. }
  235. describe("trailing closure") {
  236. it("receives next values") {
  237. var values = [Int]()
  238. let (signal, observer) = Signal<Int, NoError>.pipe()
  239. signal.observeNext { next in
  240. values.append(next)
  241. }
  242. observer.sendNext(1)
  243. expect(values) == [1]
  244. }
  245. // TODO: remove when the method is marked unavailable
  246. it("receives next values with erroring signal") {
  247. var values = [Int]()
  248. let (signal, observer) = Signal<Int, TestError>.pipe()
  249. signal.observeNext { next in
  250. values.append(next)
  251. }
  252. observer.sendNext(1)
  253. expect(values) == [1]
  254. }
  255. it("receives results") {
  256. let (signal, observer) = Signal<Int, TestError>.pipe()
  257. var results: [Result<Int, TestError>] = []
  258. signal.observeResult { results.append($0) }
  259. observer.sendNext(1)
  260. observer.sendNext(2)
  261. observer.sendNext(3)
  262. observer.sendFailed(.Default)
  263. observer.sendCompleted()
  264. expect(results).to(haveCount(4))
  265. expect(results[0].value) == 1
  266. expect(results[1].value) == 2
  267. expect(results[2].value) == 3
  268. expect(results[3].error) == .Default
  269. }
  270. }
  271. describe("map") {
  272. it("should transform the values of the signal") {
  273. let (signal, observer) = Signal<Int, NoError>.pipe()
  274. let mappedSignal = signal.map { String($0 + 1) }
  275. var lastValue: String?
  276. mappedSignal.observeNext {
  277. lastValue = $0
  278. return
  279. }
  280. expect(lastValue).to(beNil())
  281. observer.sendNext(0)
  282. expect(lastValue) == "1"
  283. observer.sendNext(1)
  284. expect(lastValue) == "2"
  285. }
  286. }
  287. describe("mapError") {
  288. it("should transform the errors of the signal") {
  289. let (signal, observer) = Signal<Int, TestError>.pipe()
  290. let producerError = NSError(domain: "com.reactivecocoa.errordomain", code: 100, userInfo: nil)
  291. var error: NSError?
  292. signal
  293. .mapError { _ in producerError }
  294. .observeFailed { err in error = err }
  295. expect(error).to(beNil())
  296. observer.sendFailed(TestError.Default)
  297. expect(error) == producerError
  298. }
  299. }
  300. describe("filter") {
  301. it("should omit values from the signal") {
  302. let (signal, observer) = Signal<Int, NoError>.pipe()
  303. let mappedSignal = signal.filter { $0 % 2 == 0 }
  304. var lastValue: Int?
  305. mappedSignal.observeNext { lastValue = $0 }
  306. expect(lastValue).to(beNil())
  307. observer.sendNext(0)
  308. expect(lastValue) == 0
  309. observer.sendNext(1)
  310. expect(lastValue) == 0
  311. observer.sendNext(2)
  312. expect(lastValue) == 2
  313. }
  314. }
  315. describe("ignoreNil") {
  316. it("should forward only non-nil values") {
  317. let (signal, observer) = Signal<Int?, NoError>.pipe()
  318. let mappedSignal = signal.ignoreNil()
  319. var lastValue: Int?
  320. mappedSignal.observeNext { lastValue = $0 }
  321. expect(lastValue).to(beNil())
  322. observer.sendNext(nil)
  323. expect(lastValue).to(beNil())
  324. observer.sendNext(1)
  325. expect(lastValue) == 1
  326. observer.sendNext(nil)
  327. expect(lastValue) == 1
  328. observer.sendNext(2)
  329. expect(lastValue) == 2
  330. }
  331. }
  332. describe("scan") {
  333. it("should incrementally accumulate a value") {
  334. let (baseSignal, observer) = Signal<String, NoError>.pipe()
  335. let signal = baseSignal.scan("", +)
  336. var lastValue: String?
  337. signal.observeNext { lastValue = $0 }
  338. expect(lastValue).to(beNil())
  339. observer.sendNext("a")
  340. expect(lastValue) == "a"
  341. observer.sendNext("bb")
  342. expect(lastValue) == "abb"
  343. }
  344. }
  345. describe("reduce") {
  346. it("should accumulate one value") {
  347. let (baseSignal, observer) = Signal<Int, NoError>.pipe()
  348. let signal = baseSignal.reduce(1, +)
  349. var lastValue: Int?
  350. var completed = false
  351. signal.observe { event in
  352. switch event {
  353. case let .Next(value):
  354. lastValue = value
  355. case .Completed:
  356. completed = true
  357. default:
  358. break
  359. }
  360. }
  361. expect(lastValue).to(beNil())
  362. observer.sendNext(1)
  363. expect(lastValue).to(beNil())
  364. observer.sendNext(2)
  365. expect(lastValue).to(beNil())
  366. expect(completed) == false
  367. observer.sendCompleted()
  368. expect(completed) == true
  369. expect(lastValue) == 4
  370. }
  371. it("should send the initial value if none are received") {
  372. let (baseSignal, observer) = Signal<Int, NoError>.pipe()
  373. let signal = baseSignal.reduce(1, +)
  374. var lastValue: Int?
  375. var completed = false
  376. signal.observe { event in
  377. switch event {
  378. case let .Next(value):
  379. lastValue = value
  380. case .Completed:
  381. completed = true
  382. default:
  383. break
  384. }
  385. }
  386. expect(lastValue).to(beNil())
  387. expect(completed) == false
  388. observer.sendCompleted()
  389. expect(lastValue) == 1
  390. expect(completed) == true
  391. }
  392. }
  393. describe("skip") {
  394. it("should skip initial values") {
  395. let (baseSignal, observer) = Signal<Int, NoError>.pipe()
  396. let signal = baseSignal.skip(1)
  397. var lastValue: Int?
  398. signal.observeNext { lastValue = $0 }
  399. expect(lastValue).to(beNil())
  400. observer.sendNext(1)
  401. expect(lastValue).to(beNil())
  402. observer.sendNext(2)
  403. expect(lastValue) == 2
  404. }
  405. it("should not skip any values when 0") {
  406. let (baseSignal, observer) = Signal<Int, NoError>.pipe()
  407. let signal = baseSignal.skip(0)
  408. var lastValue: Int?
  409. signal.observeNext { lastValue = $0 }
  410. expect(lastValue).to(beNil())
  411. observer.sendNext(1)
  412. expect(lastValue) == 1
  413. observer.sendNext(2)
  414. expect(lastValue) == 2
  415. }
  416. }
  417. describe("skipRepeats") {
  418. it("should skip duplicate Equatable values") {
  419. let (baseSignal, observer) = Signal<Bool, NoError>.pipe()
  420. let signal = baseSignal.skipRepeats()
  421. var values: [Bool] = []
  422. signal.observeNext { values.append($0) }
  423. expect(values) == []
  424. observer.sendNext(true)
  425. expect(values) == [ true ]
  426. observer.sendNext(true)
  427. expect(values) == [ true ]
  428. observer.sendNext(false)
  429. expect(values) == [ true, false ]
  430. observer.sendNext(true)
  431. expect(values) == [ true, false, true ]
  432. }
  433. it("should skip values according to a predicate") {
  434. let (baseSignal, observer) = Signal<String, NoError>.pipe()
  435. let signal = baseSignal.skipRepeats { $0.characters.count == $1.characters.count }
  436. var values: [String] = []
  437. signal.observeNext { values.append($0) }
  438. expect(values) == []
  439. observer.sendNext("a")
  440. expect(values) == [ "a" ]
  441. observer.sendNext("b")
  442. expect(values) == [ "a" ]
  443. observer.sendNext("cc")
  444. expect(values) == [ "a", "cc" ]
  445. observer.sendNext("d")
  446. expect(values) == [ "a", "cc", "d" ]
  447. }
  448. it("should not store strong reference to previously passed items") {
  449. var disposedItems: [Bool] = []
  450. struct Item {
  451. let payload: Bool
  452. let disposable: ScopedDisposable
  453. }
  454. func item(payload: Bool) -> Item {
  455. return Item(
  456. payload: payload,
  457. disposable: ScopedDisposable(ActionDisposable { disposedItems.append(payload) })
  458. )
  459. }
  460. let (baseSignal, observer) = Signal<Item, NoError>.pipe()
  461. baseSignal.skipRepeats { $0.payload == $1.payload }.observeNext { _ in }
  462. observer.sendNext(item(true))
  463. expect(disposedItems) == []
  464. observer.sendNext(item(false))
  465. expect(disposedItems) == [ true ]
  466. observer.sendNext(item(false))
  467. expect(disposedItems) == [ true, false ]
  468. observer.sendNext(item(true))
  469. expect(disposedItems) == [ true, false, false ]
  470. observer.sendCompleted()
  471. expect(disposedItems) == [ true, false, false, true ]
  472. }
  473. }
  474. describe("uniqueValues") {
  475. it("should skip values that have been already seen") {
  476. let (baseSignal, observer) = Signal<String, NoError>.pipe()
  477. let signal = baseSignal.uniqueValues()
  478. var values: [String] = []
  479. signal.observeNext { values.append($0) }
  480. expect(values) == []
  481. observer.sendNext("a")
  482. expect(values) == [ "a" ]
  483. observer.sendNext("b")
  484. expect(values) == [ "a", "b" ]
  485. observer.sendNext("a")
  486. expect(values) == [ "a", "b" ]
  487. observer.sendNext("b")
  488. expect(values) == [ "a", "b" ]
  489. observer.sendNext("c")
  490. expect(values) == [ "a", "b", "c" ]
  491. observer.sendCompleted()
  492. expect(values) == [ "a", "b", "c" ]
  493. }
  494. }
  495. describe("skipWhile") {
  496. var signal: Signal<Int, NoError>!
  497. var observer: Signal<Int, NoError>.Observer!
  498. var lastValue: Int?
  499. beforeEach {
  500. let (baseSignal, incomingObserver) = Signal<Int, NoError>.pipe()
  501. signal = baseSignal.skipWhile { $0 < 2 }
  502. observer = incomingObserver
  503. lastValue = nil
  504. signal.observeNext { lastValue = $0 }
  505. }
  506. it("should skip while the predicate is true") {
  507. expect(lastValue).to(beNil())
  508. observer.sendNext(1)
  509. expect(lastValue).to(beNil())
  510. observer.sendNext(2)
  511. expect(lastValue) == 2
  512. observer.sendNext(0)
  513. expect(lastValue) == 0
  514. }
  515. it("should not skip any values when the predicate starts false") {
  516. expect(lastValue).to(beNil())
  517. observer.sendNext(3)
  518. expect(lastValue) == 3
  519. observer.sendNext(1)
  520. expect(lastValue) == 1
  521. }
  522. }
  523. describe("skipUntil") {
  524. var signal: Signal<Int, NoError>!
  525. var observer: Signal<Int, NoError>.Observer!
  526. var triggerObserver: Signal<(), NoError>.Observer!
  527. var lastValue: Int? = nil
  528. beforeEach {
  529. let (baseSignal, incomingObserver) = Signal<Int, NoError>.pipe()
  530. let (triggerSignal, incomingTriggerObserver) = Signal<(), NoError>.pipe()
  531. signal = baseSignal.skipUntil(triggerSignal)
  532. observer = incomingObserver
  533. triggerObserver = incomingTriggerObserver
  534. lastValue = nil
  535. signal.observe { event in
  536. switch event {
  537. case let .Next(value):
  538. lastValue = value
  539. default:
  540. break
  541. }
  542. }
  543. }
  544. it("should skip values until the trigger fires") {
  545. expect(lastValue).to(beNil())
  546. observer.sendNext(1)
  547. expect(lastValue).to(beNil())
  548. observer.sendNext(2)
  549. expect(lastValue).to(beNil())
  550. triggerObserver.sendNext(())
  551. observer.sendNext(0)
  552. expect(lastValue) == 0
  553. }
  554. it("should skip values until the trigger completes") {
  555. expect(lastValue).to(beNil())
  556. observer.sendNext(1)
  557. expect(lastValue).to(beNil())
  558. observer.sendNext(2)
  559. expect(lastValue).to(beNil())
  560. triggerObserver.sendCompleted()
  561. observer.sendNext(0)
  562. expect(lastValue) == 0
  563. }
  564. }
  565. describe("take") {
  566. it("should take initial values") {
  567. let (baseSignal, observer) = Signal<Int, NoError>.pipe()
  568. let signal = baseSignal.take(2)
  569. var lastValue: Int?
  570. var completed = false
  571. signal.observe { event in
  572. switch event {
  573. case let .Next(value):
  574. lastValue = value
  575. case .Completed:
  576. completed = true
  577. default:
  578. break
  579. }
  580. }
  581. expect(lastValue).to(beNil())
  582. expect(completed) == false
  583. observer.sendNext(1)
  584. expect(lastValue) == 1
  585. expect(completed) == false
  586. observer.sendNext(2)
  587. expect(lastValue) == 2
  588. expect(completed) == true
  589. }
  590. it("should complete immediately after taking given number of values") {
  591. let numbers = [ 1, 2, 4, 4, 5 ]
  592. let testScheduler = TestScheduler()
  593. var signal: Signal<Int, NoError> = Signal { observer in
  594. testScheduler.schedule {
  595. for number in numbers {
  596. observer.sendNext(number)
  597. }
  598. }
  599. return nil
  600. }
  601. var completed = false
  602. signal = signal.take(numbers.count)
  603. signal.observeCompleted { completed = true }
  604. expect(completed) == false
  605. testScheduler.run()
  606. expect(completed) == true
  607. }
  608. it("should interrupt when 0") {
  609. let numbers = [ 1, 2, 4, 4, 5 ]
  610. let testScheduler = TestScheduler()
  611. let signal: Signal<Int, NoError> = Signal { observer in
  612. testScheduler.schedule {
  613. for number in numbers {
  614. observer.sendNext(number)
  615. }
  616. }
  617. return nil
  618. }
  619. var result: [Int] = []
  620. var interrupted = false
  621. signal
  622. .take(0)
  623. .observe { event in
  624. switch event {
  625. case let .Next(number):
  626. result.append(number)
  627. case .Interrupted:
  628. interrupted = true
  629. default:
  630. break
  631. }
  632. }
  633. expect(interrupted) == true
  634. testScheduler.run()
  635. expect(result).to(beEmpty())
  636. }
  637. }
  638. describe("collect") {
  639. it("should collect all values") {
  640. let (original, observer) = Signal<Int, NoError>.pipe()
  641. let signal = original.collect()
  642. let expectedResult = [ 1, 2, 3 ]
  643. var result: [Int]?
  644. signal.observeNext { value in
  645. expect(result).to(beNil())
  646. result = value
  647. }
  648. for number in expectedResult {
  649. observer.sendNext(number)
  650. }
  651. expect(result).to(beNil())
  652. observer.sendCompleted()
  653. expect(result) == expectedResult
  654. }
  655. it("should complete with an empty array if there are no values") {
  656. let (original, observer) = Signal<Int, NoError>.pipe()
  657. let signal = original.collect()
  658. var result: [Int]?
  659. signal.observeNext { result = $0 }
  660. expect(result).to(beNil())
  661. observer.sendCompleted()
  662. expect(result) == []
  663. }
  664. it("should forward errors") {
  665. let (original, observer) = Signal<Int, TestError>.pipe()
  666. let signal = original.collect()
  667. var error: TestError?
  668. signal.observeFailed { error = $0 }
  669. expect(error).to(beNil())
  670. observer.sendFailed(.Default)
  671. expect(error) == TestError.Default
  672. }
  673. it("should collect an exact count of values") {
  674. let (original, observer) = Signal<Int, NoError>.pipe()
  675. let signal = original.collect(count: 3)
  676. var observedValues: [[Int]] = []
  677. signal.observeNext { value in
  678. observedValues.append(value)
  679. }
  680. var expectation: [[Int]] = []
  681. for i in 1...7 {
  682. observer.sendNext(i)
  683. if i % 3 == 0 {
  684. expectation.append([Int]((i - 2)...i))
  685. expect(observedValues) == expectation
  686. } else {
  687. expect(observedValues) == expectation
  688. }
  689. }
  690. observer.sendCompleted()
  691. expectation.append([7])
  692. expect(observedValues) == expectation
  693. }
  694. it("should collect values until it matches a certain value") {
  695. let (original, observer) = Signal<Int, NoError>.pipe()
  696. let signal = original.collect { _, next in next != 5 }
  697. var expectedValues = [
  698. [5, 5],
  699. [42, 5]
  700. ]
  701. signal.observeNext { value in
  702. expect(value) == expectedValues.removeFirst()
  703. }
  704. signal.observeCompleted {
  705. expect(expectedValues) == []
  706. }
  707. expectedValues
  708. .flatMap { $0 }
  709. .forEach(observer.sendNext)
  710. observer.sendCompleted()
  711. }
  712. it("should collect values until it matches a certain condition on values") {
  713. let (original, observer) = Signal<Int, NoError>.pipe()
  714. let signal = original.collect { values in values.reduce(0, combine: +) == 10 }
  715. var expectedValues = [
  716. [1, 2, 3, 4],
  717. [5, 6, 7, 8, 9]
  718. ]
  719. signal.observeNext { value in
  720. expect(value) == expectedValues.removeFirst()
  721. }
  722. signal.observeCompleted {
  723. expect(expectedValues) == []
  724. }
  725. expectedValues
  726. .flatMap { $0 }
  727. .forEach(observer.sendNext)
  728. observer.sendCompleted()
  729. }
  730. }
  731. describe("takeUntil") {
  732. var signal: Signal<Int, NoError>!
  733. var observer: Signal<Int, NoError>.Observer!
  734. var triggerObserver: Signal<(), NoError>.Observer!
  735. var lastValue: Int? = nil
  736. var completed: Bool = false
  737. beforeEach {
  738. let (baseSignal, incomingObserver) = Signal<Int, NoError>.pipe()
  739. let (triggerSignal, incomingTriggerObserver) = Signal<(), NoError>.pipe()
  740. signal = baseSignal.takeUntil(triggerSignal)
  741. observer = incomingObserver
  742. triggerObserver = incomingTriggerObserver
  743. lastValue = nil
  744. completed = false
  745. signal.observe { event in
  746. switch event {
  747. case let .Next(value):
  748. lastValue = value
  749. case .Completed:
  750. completed = true
  751. default:
  752. break
  753. }
  754. }
  755. }
  756. it("should take values until the trigger fires") {
  757. expect(lastValue).to(beNil())
  758. observer.sendNext(1)
  759. expect(lastValue) == 1
  760. observer.sendNext(2)
  761. expect(lastValue) == 2
  762. expect(completed) == false
  763. triggerObserver.sendNext(())
  764. expect(completed) == true
  765. }
  766. it("should take values until the trigger completes") {
  767. expect(lastValue).to(beNil())
  768. observer.sendNext(1)
  769. expect(lastValue) == 1
  770. observer.sendNext(2)
  771. expect(lastValue) == 2
  772. expect(completed) == false
  773. triggerObserver.sendCompleted()
  774. expect(completed) == true
  775. }
  776. it("should complete if the trigger fires immediately") {
  777. expect(lastValue).to(beNil())
  778. expect(completed) == false
  779. triggerObserver.sendNext(())
  780. expect(completed) == true
  781. expect(lastValue).to(beNil())
  782. }
  783. }
  784. describe("takeUntilReplacement") {
  785. var signal: Signal<Int, NoError>!
  786. var observer: Signal<Int, NoError>.Observer!
  787. var replacementObserver: Signal<Int, NoError>.Observer!
  788. var lastValue: Int? = nil
  789. var completed: Bool = false
  790. beforeEach {
  791. let (baseSignal, incomingObserver) = Signal<Int, NoError>.pipe()
  792. let (replacementSignal, incomingReplacementObserver) = Signal<Int, NoError>.pipe()
  793. signal = baseSignal.takeUntilReplacement(replacementSignal)
  794. observer = incomingObserver
  795. replacementObserver = incomingReplacementObserver
  796. lastValue = nil
  797. completed = false
  798. signal.observe { event in
  799. switch event {
  800. case let .Next(value):
  801. lastValue = value
  802. case .Completed:
  803. completed = true
  804. default:
  805. break
  806. }
  807. }
  808. }
  809. it("should take values from the original then the replacement") {
  810. expect(lastValue).to(beNil())
  811. expect(completed) == false
  812. observer.sendNext(1)
  813. expect(lastValue) == 1
  814. observer.sendNext(2)
  815. expect(lastValue) == 2
  816. replacementObserver.sendNext(3)
  817. expect(lastValue) == 3
  818. expect(completed) == false
  819. observer.sendNext(4)
  820. expect(lastValue) == 3
  821. expect(completed) == false
  822. replacementObserver.sendNext(5)
  823. expect(lastValue) == 5
  824. expect(completed) == false
  825. replacementObserver.sendCompleted()
  826. expect(completed) == true
  827. }
  828. }
  829. describe("takeWhile") {
  830. var signal: Signal<Int, NoError>!
  831. var observer: Signal<Int, NoError>.Observer!
  832. beforeEach {
  833. let (baseSignal, incomingObserver) = Signal<Int, NoError>.pipe()
  834. signal = baseSignal.takeWhile { $0 <= 4 }
  835. observer = incomingObserver
  836. }
  837. it("should take while the predicate is true") {
  838. var latestValue: Int!
  839. var completed = false
  840. signal.observe { event in
  841. switch event {
  842. case let .Next(value):
  843. latestValue = value
  844. case .Completed:
  845. completed = true
  846. default:
  847. break
  848. }
  849. }
  850. for value in -1...4 {
  851. observer.sendNext(value)
  852. expect(latestValue) == value
  853. expect(completed) == false
  854. }
  855. observer.sendNext(5)
  856. expect(latestValue) == 4
  857. expect(completed) == true
  858. }
  859. it("should complete if the predicate starts false") {
  860. var latestValue: Int?
  861. var completed = false
  862. signal.observe { event in
  863. switch event {
  864. case let .Next(value):
  865. latestValue = value
  866. case .Completed:
  867. completed = true
  868. default:
  869. break
  870. }
  871. }
  872. observer.sendNext(5)
  873. expect(latestValue).to(beNil())
  874. expect(completed) == true
  875. }
  876. }
  877. describe("observeOn") {
  878. it("should send events on the given scheduler") {
  879. let testScheduler = TestScheduler()
  880. let (signal, observer) = Signal<Int, NoError>.pipe()
  881. var result: [Int] = []
  882. signal
  883. .observeOn(testScheduler)
  884. .observeNext { result.append($0) }
  885. observer.sendNext(1)
  886. observer.sendNext(2)
  887. expect(result).to(beEmpty())
  888. testScheduler.run()
  889. expect(result) == [ 1, 2 ]
  890. }
  891. }
  892. describe("delay") {
  893. it("should send events on the given scheduler after the interval") {
  894. let testScheduler = TestScheduler()
  895. let signal: Signal<Int, NoError> = Signal { observer in
  896. testScheduler.schedule {
  897. observer.sendNext(1)
  898. }
  899. testScheduler.scheduleAfter(5, action: {
  900. observer.sendNext(2)
  901. observer.sendCompleted()
  902. })
  903. return nil
  904. }
  905. var result: [Int] = []
  906. var completed = false
  907. signal
  908. .delay(10, onScheduler: testScheduler)
  909. .observe { event in
  910. switch event {
  911. case let .Next(number):
  912. result.append(number)
  913. case .Completed:
  914. completed = true
  915. default:
  916. break
  917. }
  918. }
  919. testScheduler.advanceByInterval(4) // send initial value
  920. expect(result).to(beEmpty())
  921. testScheduler.advanceByInterval(10) // send second value and receive first
  922. expect(result) == [ 1 ]
  923. expect(completed) == false
  924. testScheduler.advanceByInterval(10) // send second value and receive first
  925. expect(result) == [ 1, 2 ]
  926. expect(completed) == true
  927. }
  928. it("should schedule errors immediately") {
  929. let testScheduler = TestScheduler()
  930. let signal: Signal<Int, TestError> = Signal { observer in
  931. testScheduler.schedule {
  932. observer.sendFailed(TestError.Default)
  933. }
  934. return nil
  935. }
  936. var errored = false
  937. signal
  938. .delay(10, onScheduler: testScheduler)
  939. .observeFailed { _ in errored = true }
  940. testScheduler.advance()
  941. expect(errored) == true
  942. }
  943. }
  944. describe("throttle") {
  945. var scheduler: TestScheduler!
  946. var observer: Signal<Int, NoError>.Observer!
  947. var signal: Signal<Int, NoError>!
  948. beforeEach {
  949. scheduler = TestScheduler()
  950. let (baseSignal, baseObserver) = Signal<Int, NoError>.pipe()
  951. observer = baseObserver
  952. signal = baseSignal.throttle(1, onScheduler: scheduler)
  953. expect(signal).notTo(beNil())
  954. }
  955. it("should send values on the given scheduler at no less than the interval") {
  956. var values: [Int] = []
  957. signal.observeNext { value in
  958. values.append(value)
  959. }
  960. expect(values) == []
  961. observer.sendNext(0)
  962. expect(values) == []
  963. scheduler.advance()
  964. expect(values) == [ 0 ]
  965. observer.sendNext(1)
  966. observer.sendNext(2)
  967. expect(values) == [ 0 ]
  968. scheduler.advanceByInterval(1.5)
  969. expect(values) == [ 0, 2 ]
  970. scheduler.advanceByInterval(3)
  971. expect(values) == [ 0, 2 ]
  972. observer.sendNext(3)
  973. expect(values) == [ 0, 2 ]
  974. scheduler.advance()
  975. expect(values) == [ 0, 2, 3 ]
  976. observer.sendNext(4)
  977. observer.sendNext(5)
  978. scheduler.advance()
  979. expect(values) == [ 0, 2, 3 ]
  980. scheduler.run()
  981. expect(values) == [ 0, 2, 3, 5 ]
  982. }
  983. it("should schedule completion immediately") {
  984. var values: [Int] = []
  985. var completed = false
  986. signal.observe { event in
  987. switch event {
  988. case let .Next(value):
  989. values.append(value)
  990. case .Completed:
  991. completed = true
  992. default:
  993. break
  994. }
  995. }
  996. observer.sendNext(0)
  997. scheduler.advance()
  998. expect(values) == [ 0 ]
  999. observer.sendNext(1)
  1000. observer.sendCompleted()
  1001. expect(completed) == false
  1002. scheduler.advance()
  1003. expect(values) == [ 0 ]
  1004. expect(completed) == true
  1005. scheduler.run()
  1006. expect(values) == [ 0 ]
  1007. expect(completed) == true
  1008. }
  1009. }
  1010. describe("debounce") {
  1011. var scheduler: TestScheduler!
  1012. var observer: Signal<Int, NoError>.Observer!
  1013. var signal: Signal<Int, NoError>!
  1014. beforeEach {
  1015. scheduler = TestScheduler()
  1016. let (baseSignal, baseObserver) = Signal<Int, NoError>.pipe()
  1017. observer = baseObserver
  1018. signal = baseSignal.debounce(1, onScheduler: scheduler)
  1019. expect(signal).notTo(beNil())
  1020. }
  1021. it("should send values on the given scheduler once the interval has passed since the last value was sent") {
  1022. var values: [Int] = []
  1023. signal.observeNext { value in
  1024. values.append(value)
  1025. }
  1026. expect(values) == []
  1027. observer.sendNext(0)
  1028. expect(values) == []
  1029. scheduler.advance()
  1030. expect(values) == []
  1031. observer.sendNext(1)
  1032. observer.sendNext(2)
  1033. expect(values) == []
  1034. scheduler.advanceByInterval(1.5)
  1035. expect(values) == [ 2 ]
  1036. scheduler.advanceByInterval(3)
  1037. expect(values) == [ 2 ]
  1038. observer.sendNext(3)
  1039. expect(values) == [ 2 ]
  1040. scheduler.advance()
  1041. expect(values) == [ 2 ]
  1042. observer.sendNext(4)
  1043. observer.sendNext(5)
  1044. scheduler.advance()
  1045. expect(values) == [ 2 ]
  1046. scheduler.run()
  1047. expect(values) == [ 2, 5 ]
  1048. }
  1049. it("should schedule completion immediately") {
  1050. var values: [Int] = []
  1051. var completed = false
  1052. signal.observe { event in
  1053. switch event {
  1054. case let .Next(value):
  1055. values.append(value)
  1056. case .Completed:
  1057. completed = true
  1058. default:
  1059. break
  1060. }
  1061. }
  1062. observer.sendNext(0)
  1063. scheduler.advance()
  1064. expect(values) == []
  1065. observer.sendNext(1)
  1066. observer.sendCompleted()
  1067. expect(completed) == false
  1068. scheduler.advance()
  1069. expect(values) == []
  1070. expect(completed) == true
  1071. scheduler.run()
  1072. expect(values) == []
  1073. expect(completed) == true
  1074. }
  1075. }
  1076. describe("sampleWith") {
  1077. var sampledSignal: Signal<(Int, String), NoError>!
  1078. var observer: Signal<Int, NoError>.Observer!
  1079. var samplerObserver: Signal<String, NoError>.Observer!
  1080. beforeEach {
  1081. let (signal, incomingObserver) = Signal<Int, NoError>.pipe()
  1082. let (sampler, incomingSamplerObserver) = Signal<String, NoError>.pipe()
  1083. sampledSignal = signal.sampleWith(sampler)
  1084. observer = incomingObserver
  1085. samplerObserver = incomingSamplerObserver
  1086. }
  1087. it("should forward the latest value when the sampler fires") {
  1088. var result: [String] = []
  1089. sampledSignal.observeNext { (left, right) in result.append("\(left)\(right)") }
  1090. observer.sendNext(1)
  1091. observer.sendNext(2)
  1092. samplerObserver.sendNext("a")
  1093. expect(result) == [ "2a" ]
  1094. }
  1095. it("should do nothing if sampler fires before signal receives value") {
  1096. var result: [String] = []
  1097. sampledSignal.observeNext { (left, right) in result.append("\(left)\(right)") }
  1098. samplerObserver.sendNext("a")
  1099. expect(result).to(beEmpty())
  1100. }
  1101. it("should send lates value with sampler value multiple times when sampler fires multiple times") {
  1102. var result: [String] = []
  1103. sampledSignal.observeNext { (left, right) in result.append("\(left)\(right)") }
  1104. observer.sendNext(1)
  1105. samplerObserver.sendNext("a")
  1106. samplerObserver.sendNext("b")
  1107. expect(result) == [ "1a", "1b" ]
  1108. }
  1109. it("should complete when both inputs have completed") {
  1110. var completed = false
  1111. sampledSignal.observeCompleted { completed = true }
  1112. observer.sendCompleted()
  1113. expect(completed) == false
  1114. samplerObserver.sendCompleted()
  1115. expect(completed) == true
  1116. }
  1117. }
  1118. describe("sampleOn") {
  1119. var sampledSignal: Signal<Int, NoError>!
  1120. var observer: Signal<Int, NoError>.Observer!
  1121. var samplerObserver: Signal<(), NoError>.Observer!
  1122. beforeEach {
  1123. let (signal, incomingObserver) = Signal<Int, NoError>.pipe()
  1124. let (sampler, incomingSamplerObserver) = Signal<(), NoError>.pipe()
  1125. sampledSignal = signal.sampleOn(sampler)
  1126. observer = incomingObserver
  1127. samplerObserver = incomingSamplerObserver
  1128. }
  1129. it("should forward the latest value when the sampler fires") {
  1130. var result: [Int] = []
  1131. sampledSignal.observeNext { result.append($0) }
  1132. observer.sendNext(1)
  1133. observer.sendNext(2)
  1134. samplerObserver.sendNext(())
  1135. expect(result) == [ 2 ]
  1136. }
  1137. it("should do nothing if sampler fires before signal receives value") {
  1138. var result: [Int] = []
  1139. sampledSignal.observeNext { result.append($0) }
  1140. samplerObserver.sendNext(())
  1141. expect(result).to(beEmpty())
  1142. }
  1143. it("should send lates value multiple times when sampler fires multiple times") {
  1144. var result: [Int] = []
  1145. sampledSignal.observeNext { result.append($0) }
  1146. observer.sendNext(1)
  1147. samplerObserver.sendNext(())
  1148. samplerObserver.sendNext(())
  1149. expect(result) == [ 1, 1 ]
  1150. }
  1151. it("should complete when both inputs have completed") {
  1152. var completed = false
  1153. sampledSignal.observeCompleted { completed = true }
  1154. observer.sendCompleted()
  1155. expect(completed) == false
  1156. samplerObserver.sendCompleted()
  1157. expect(completed) == true
  1158. }
  1159. }
  1160. describe("combineLatestWith") {
  1161. var combinedSignal: Signal<(Int, Double), NoError>!
  1162. var observer: Signal<Int, NoError>.Observer!
  1163. var otherObserver: Signal<Double, NoError>.Observer!
  1164. beforeEach {
  1165. let (signal, incomingObserver) = Signal<Int, NoError>.pipe()
  1166. let (otherSignal, incomingOtherObserver) = Signal<Double, NoError>.pipe()
  1167. combinedSignal = signal.combineLatestWith(otherSignal)
  1168. observer = incomingObserver
  1169. otherObserver = incomingOtherObserver
  1170. }
  1171. it("should forward the latest values from both inputs") {
  1172. var latest: (Int, Double)?
  1173. combinedSignal.observeNext { latest = $0 }
  1174. observer.sendNext(1)
  1175. expect(latest).to(beNil())
  1176. // is there a better way to test tuples?
  1177. otherObserver.sendNext(1.5)
  1178. expect(latest?.0) == 1
  1179. expect(latest?.1) == 1.5
  1180. observer.sendNext(2)
  1181. expect(latest?.0) == 2
  1182. expect(latest?.1) == 1.5
  1183. }
  1184. it("should complete when both inputs have completed") {
  1185. var completed = false
  1186. combinedSignal.observeCompleted { completed = true }
  1187. observer.sendCompleted()
  1188. expect(completed) == false
  1189. otherObserver.sendCompleted()
  1190. expect(completed) == true
  1191. }
  1192. }
  1193. describe("zipWith") {
  1194. var leftObserver: Signal<Int, NoError>.Observer!
  1195. var rightObserver: Signal<String, NoError>.Observer!
  1196. var zipped: Signal<(Int, String), NoError>!
  1197. beforeEach {
  1198. let (leftSignal, incomingLeftObserver) = Signal<Int, NoError>.pipe()
  1199. let (rightSignal, incomingRightObserver) = Signal<String, NoError>.pipe()
  1200. leftObserver = incomingLeftObserver
  1201. rightObserver = incomingRightObserver
  1202. zipped = leftSignal.zipWith(rightSignal)
  1203. }
  1204. it("should combine pairs") {
  1205. var result: [String] = []
  1206. zipped.observeNext { (left, right) in result.append("\(left)\(right)") }
  1207. leftObserver.sendNext(1)
  1208. leftObserver.sendNext(2)
  1209. expect(result) == []
  1210. rightObserver.sendNext("foo")
  1211. expect(result) == [ "1foo" ]
  1212. leftObserver.sendNext(3)
  1213. rightObserver.sendNext("bar")
  1214. expect(result) == [ "1foo", "2bar" ]
  1215. rightObserver.sendNext("buzz")
  1216. expect(result) == [ "1foo", "2bar", "3buzz" ]
  1217. rightObserver.sendNext("fuzz")
  1218. expect(result) == [ "1foo", "2bar", "3buzz" ]
  1219. leftObserver.sendNext(4)
  1220. expect(result) == [ "1foo", "2bar", "3buzz", "4fuzz" ]
  1221. }
  1222. it("should complete when the shorter signal has completed") {
  1223. var result: [String] = []
  1224. var completed = false
  1225. zipped.observe { event in
  1226. switch event {
  1227. case let .Next(left, right):
  1228. result.append("\(left)\(right)")
  1229. case .Completed:
  1230. completed = true
  1231. default:
  1232. break
  1233. }
  1234. }
  1235. expect(completed) == false
  1236. leftObserver.sendNext(0)
  1237. leftObserver.sendCompleted()
  1238. expect(completed) == false
  1239. expect(result) == []
  1240. rightObserver.sendNext("foo")
  1241. expect(completed) == true
  1242. expect(result) == [ "0foo" ]
  1243. }
  1244. it("should complete when both signal have completed") {
  1245. var result: [String] = []
  1246. var completed = false
  1247. zipped.observe { event in
  1248. switch event {
  1249. case let .Next(left, right):
  1250. result.append("\(left)\(right)")
  1251. case .Completed:
  1252. completed = true
  1253. default:
  1254. break
  1255. }
  1256. }
  1257. expect(completed) == false
  1258. leftObserver.sendNext(0)
  1259. leftObserver.sendCompleted()
  1260. expect(completed) == false
  1261. expect(result) == []
  1262. rightObserver.sendCompleted()
  1263. expect(result) == [ ]
  1264. }
  1265. it("should complete and drop unpaired pending values when both signal have completed") {
  1266. var result: [String] = []
  1267. var completed = false
  1268. zipped.observe { event in
  1269. switch event {
  1270. case let .Next(left, right):
  1271. result.append("\(left)\(right)")
  1272. case .Completed:
  1273. completed = true
  1274. default:
  1275. break
  1276. }
  1277. }
  1278. expect(completed) == false
  1279. leftObserver.sendNext(0)
  1280. leftObserver.sendNext(1)
  1281. leftObserver.sendNext(2)
  1282. leftObserver.sendNext(3)
  1283. leftObserver.sendCompleted()
  1284. expect(completed) == false
  1285. expect(result) == []
  1286. rightObserver.sendNext("foo")
  1287. rightObserver.sendNext("bar")
  1288. rightObserver.sendCompleted()
  1289. expect(result) == ["0foo", "1bar"]
  1290. }
  1291. }
  1292. describe("materialize") {
  1293. it("should reify events from the signal") {
  1294. let (signal, observer) = Signal<Int, TestError>.pipe()
  1295. var latestEvent: Event<Int, TestError>?
  1296. signal
  1297. .materialize()
  1298. .observeNext { latestEvent = $0 }
  1299. observer.sendNext(2)
  1300. expect(latestEvent).toNot(beNil())
  1301. if let latestEvent = latestEvent {
  1302. switch latestEvent {
  1303. case let .Next(value):
  1304. expect(value) == 2
  1305. default:
  1306. fail()
  1307. }
  1308. }
  1309. observer.sendFailed(TestError.Default)
  1310. if let latestEvent = latestEvent {
  1311. switch latestEvent {
  1312. case .Failed:
  1313. ()
  1314. default:
  1315. fail()
  1316. }
  1317. }
  1318. }
  1319. }
  1320. describe("dematerialize") {
  1321. typealias IntEvent = Event<Int, TestError>
  1322. var observer: Signal<IntEvent, NoError>.Observer!
  1323. var dematerialized: Signal<Int, TestError>!
  1324. beforeEach {
  1325. let (signal, incomingObserver) = Signal<IntEvent, NoError>.pipe()
  1326. observer = incomingObserver
  1327. dematerialized = signal.dematerialize()
  1328. }
  1329. it("should send values for Next events") {
  1330. var result: [Int] = []
  1331. dematerialized
  1332. .assumeNoErrors()
  1333. .observeNext { result.append($0) }
  1334. expect(result).to(beEmpty())
  1335. observer.sendNext(.Next(2))
  1336. expect(result) == [ 2 ]
  1337. observer.sendNext(.Next(4))
  1338. expect(result) == [ 2, 4 ]
  1339. }
  1340. it("should error out for Error events") {
  1341. var errored = false
  1342. dematerialized.observeFailed { _ in errored = true }
  1343. expect(errored) == false
  1344. observer.sendNext(.Failed(TestError.Default))
  1345. expect(errored) == true
  1346. }
  1347. it("should complete early for Completed events") {
  1348. var completed = false
  1349. dematerialized.observeCompleted { completed = true }
  1350. expect(completed) == false
  1351. observer.sendNext(IntEvent.Completed)
  1352. expect(completed) == true
  1353. }
  1354. }
  1355. describe("takeLast") {
  1356. var observer: Signal<Int, TestError>.Observer!
  1357. var lastThree: Signal<Int, TestError>!
  1358. beforeEach {
  1359. let (signal, incomingObserver) = Signal<Int, TestError>.pipe()
  1360. observer = incomingObserver
  1361. lastThree = signal.takeLast(3)
  1362. }
  1363. it("should send the last N values upon completion") {
  1364. var result: [Int] = []
  1365. lastThree
  1366. .assumeNoErrors()
  1367. .observeNext { result.append($0) }
  1368. observer.sendNext(1)
  1369. observer.sendNext(2)
  1370. observer.sendNext(3)
  1371. observer.sendNext(4)
  1372. expect(result).to(beEmpty())
  1373. observer.sendCompleted()
  1374. expect(result) == [ 2, 3, 4 ]
  1375. }
  1376. it("should send less than N values if not enough were received") {
  1377. var result: [Int] = []
  1378. lastThree
  1379. .assumeNoErrors()
  1380. .observeNext { result.append($0) }
  1381. observer.sendNext(1)
  1382. observer.sendNext(2)
  1383. observer.sendCompleted()
  1384. expect(result) == [ 1, 2 ]
  1385. }
  1386. it("should send nothing when errors") {
  1387. var result: [Int] = []
  1388. var errored = false
  1389. lastThree.observe { event in
  1390. switch event {
  1391. case let .Next(value):
  1392. result.append(value)
  1393. case .Failed:
  1394. errored = true
  1395. default:
  1396. break
  1397. }
  1398. }
  1399. observer.sendNext(1)
  1400. observer.sendNext(2)
  1401. observer.sendNext(3)
  1402. expect(errored) == false
  1403. observer.sendFailed(TestError.Default)
  1404. expect(errored) == true
  1405. expect(result).to(beEmpty())
  1406. }
  1407. }
  1408. describe("timeoutWithError") {
  1409. var testScheduler: TestScheduler!
  1410. var signal: Signal<Int, TestError>!
  1411. var observer: Signal<Int, TestError>.Observer!
  1412. beforeEach {
  1413. testScheduler = TestScheduler()
  1414. let (baseSignal, incomingObserver) = Signal<Int, TestError>.pipe()
  1415. signal = baseSignal.timeoutWithError(TestError.Default, afterInterval: 2, onScheduler: testScheduler)
  1416. observer = incomingObserver
  1417. }
  1418. it("should complete if within the interval") {
  1419. var completed = false
  1420. var errored = false
  1421. signal.observe { event in
  1422. switch event {
  1423. case .Completed:
  1424. completed = true
  1425. case .Failed:
  1426. errored = true
  1427. default:
  1428. break
  1429. }
  1430. }
  1431. testScheduler.scheduleAfter(1) {
  1432. observer.sendCompleted()
  1433. }
  1434. expect(completed) == false
  1435. expect(errored) == false
  1436. testScheduler.run()
  1437. expect(completed) == true
  1438. expect(errored) == false
  1439. }
  1440. it("should error if not completed before the interval has elapsed") {
  1441. var completed = false
  1442. var errored = false
  1443. signal.observe { event in
  1444. switch event {
  1445. case .Completed:
  1446. completed = true
  1447. case .Failed:
  1448. errored = true
  1449. default:
  1450. break
  1451. }
  1452. }
  1453. testScheduler.scheduleAfter(3) {
  1454. observer.sendCompleted()
  1455. }
  1456. expect(completed) == false
  1457. expect(errored) == false
  1458. testScheduler.run()
  1459. expect(completed) == false
  1460. expect(errored) == true
  1461. }
  1462. }
  1463. describe("attempt") {
  1464. it("should forward original values upon success") {
  1465. let (baseSignal, observer) = Signal<Int, TestError>.pipe()
  1466. let signal = baseSignal.attempt { _ in
  1467. return .Success()
  1468. }
  1469. var current: Int?
  1470. signal
  1471. .assumeNoErrors()
  1472. .observeNext { value in
  1473. current = value
  1474. }
  1475. for value in 1...5 {
  1476. observer.sendNext(value)
  1477. expect(current) == value
  1478. }
  1479. }
  1480. it("should error if an attempt fails") {
  1481. let (baseSignal, observer) = Signal<Int, TestError>.pipe()
  1482. let signal = baseSignal.attempt { _ in
  1483. return .Failure(.Default)
  1484. }
  1485. var error: TestError?
  1486. signal.observeFailed { err in
  1487. error = err
  1488. }
  1489. observer.sendNext(42)
  1490. expect(error) == TestError.Default
  1491. }
  1492. }
  1493. describe("attemptMap") {
  1494. it("should forward mapped values upon success") {
  1495. let (baseSignal, observer) = Signal<Int, TestError>.pipe()
  1496. let signal = baseSignal.attemptMap { num -> Result<Bool, TestError> in
  1497. return .Success(num % 2 == 0)
  1498. }
  1499. var even: Bool?
  1500. signal
  1501. .assumeNoErrors()
  1502. .observeNext { value in
  1503. even = value
  1504. }
  1505. observer.sendNext(1)
  1506. expect(even) == false
  1507. observer.sendNext(2)
  1508. expect(even) == true
  1509. }
  1510. it("should error if a mapping fails") {
  1511. let (baseSignal, observer) = Signal<Int, TestError>.pipe()
  1512. let signal = baseSignal.attemptMap { _ -> Result<Bool, TestError> in
  1513. return .Failure(.Default)
  1514. }
  1515. var error: TestError?
  1516. signal.observeFailed { err in
  1517. error = err
  1518. }
  1519. observer.sendNext(42)
  1520. expect(error) == TestError.Default
  1521. }
  1522. }
  1523. describe("combinePrevious") {
  1524. var observer: Signal<Int, NoError>.Observer!
  1525. let initialValue: Int = 0
  1526. var latestValues: (Int, Int)?
  1527. beforeEach {
  1528. latestValues = nil
  1529. let (signal, baseObserver) = Signal<Int, NoError>.pipe()
  1530. observer = baseObserver
  1531. signal.combinePrevious(initialValue).observeNext { latestValues = $0 }
  1532. }
  1533. it("should forward the latest value with previous value") {
  1534. expect(latestValues).to(beNil())
  1535. observer.sendNext(1)
  1536. expect(latestValues?.0) == initialValue
  1537. expect(latestValues?.1) == 1
  1538. observer.sendNext(2)
  1539. expect(latestValues?.0) == 1
  1540. expect(latestValues?.1) == 2
  1541. }
  1542. }
  1543. describe("combineLatest") {
  1544. var signalA: Signal<Int, NoError>!
  1545. var signalB: Signal<Int, NoError>!
  1546. var signalC: Signal<Int, NoError>!
  1547. var observerA: Signal<Int, NoError>.Observer!
  1548. var observerB: Signal<Int, NoError>.Observer!
  1549. var observerC: Signal<Int, NoError>.Observer!
  1550. var combinedValues: [Int]?
  1551. var completed: Bool!
  1552. beforeEach {
  1553. combinedValues = nil
  1554. completed = false
  1555. let (baseSignalA, baseObserverA) = Signal<Int, NoError>.pipe()
  1556. let (baseSignalB, baseObserverB) = Signal<Int, NoError>.pipe()
  1557. let (baseSignalC, baseObserverC) = Signal<Int, NoError>.pipe()
  1558. signalA = baseSignalA
  1559. signalB = baseSignalB
  1560. signalC = baseSignalC
  1561. observerA = baseObserverA
  1562. observerB = baseObserverB
  1563. observerC = baseObserverC
  1564. }
  1565. let combineLatestExampleName = "combineLatest examples"
  1566. sharedExamples(combineLatestExampleName) {
  1567. it("should forward the latest values from all inputs"){
  1568. expect(combinedValues).to(beNil())
  1569. observerA.sendNext(0)
  1570. observerB.sendNext(1)
  1571. observerC.sendNext(2)
  1572. expect(combinedValues) == [0, 1, 2]
  1573. observerA.sendNext(10)
  1574. expect(combinedValues) == [10, 1, 2]
  1575. }
  1576. it("should not forward the latest values before all inputs"){
  1577. expect(combinedValues).to(beNil())
  1578. observerA.sendNext(0)
  1579. expect(combinedValues).to(beNil())
  1580. observerB.sendNext(1)
  1581. expect(combinedValues).to(beNil())
  1582. observerC.sendNext(2)
  1583. expect(combinedValues) == [0, 1, 2]
  1584. }
  1585. it("should complete when all inputs have completed"){
  1586. expect(completed) == false
  1587. observerA.sendCompleted()
  1588. observerB.sendCompleted()
  1589. expect(completed) == false
  1590. observerC.sendCompleted()
  1591. expect(completed) == true
  1592. }
  1593. }
  1594. describe("tuple") {
  1595. beforeEach {
  1596. combineLatest(signalA, signalB, signalC)
  1597. .observe { event in
  1598. switch event {
  1599. case let .Next(value):
  1600. combinedValues = [value.0, value.1, value.2]
  1601. case .Completed:
  1602. completed = true
  1603. default:
  1604. break
  1605. }
  1606. }
  1607. }
  1608. itBehavesLike(combineLatestExampleName)
  1609. }
  1610. describe("sequence") {
  1611. beforeEach {
  1612. combineLatest([signalA, signalB, signalC])
  1613. .observe { event in
  1614. switch event {
  1615. case let .Next(values):
  1616. combinedValues = values
  1617. case .Completed:
  1618. completed = true
  1619. default:
  1620. break
  1621. }
  1622. }
  1623. }
  1624. itBehavesLike(combineLatestExampleName)
  1625. }
  1626. }
  1627. describe("zip") {
  1628. var signalA: Signal<Int, NoError>!
  1629. var signalB: Signal<Int, NoError>!
  1630. var signalC: Signal<Int, NoError>!
  1631. var observerA: Signal<Int, NoError>.Observer!
  1632. var observerB: Signal<Int, NoError>.Observer!
  1633. var observerC: Signal<Int, NoError>.Observer!
  1634. var zippedValues: [Int]?
  1635. var completed: Bool!
  1636. beforeEach {
  1637. zippedValues = nil
  1638. completed = false
  1639. let (baseSignalA, baseObserverA) = Signal<Int, NoError>.pipe()
  1640. let (baseSignalB, baseObserverB) = Signal<Int, NoError>.pipe()
  1641. let (baseSignalC, baseObserverC) = Signal<Int, NoError>.pipe()
  1642. signalA = baseSignalA
  1643. signalB = baseSignalB
  1644. signalC = baseSignalC
  1645. observerA = baseObserverA
  1646. observerB = baseObserverB
  1647. observerC = baseObserverC
  1648. }
  1649. let zipExampleName = "zip examples"
  1650. sharedExamples(zipExampleName) {
  1651. it("should combine all set"){
  1652. expect(zippedValues).to(beNil())
  1653. observerA.sendNext(0)
  1654. expect(zippedValues).to(beNil())
  1655. observerB.sendNext(1)
  1656. expect(zippedValues).to(beNil())
  1657. observerC.sendNext(2)
  1658. expect(zippedValues) == [0, 1, 2]
  1659. observerA.sendNext(10)
  1660. expect(zippedValues) == [0, 1, 2]
  1661. observerA.sendNext(20)
  1662. expect(zippedValues) == [0, 1, 2]
  1663. observerB.sendNext(11)
  1664. expect(zippedValues) == [0, 1, 2]
  1665. observerC.sendNext(12)
  1666. expect(zippedValues) == [10, 11, 12]
  1667. }
  1668. it("should complete when the shorter signal has completed"){
  1669. expect(completed) == false
  1670. observerB.sendNext(1)
  1671. observerC.sendNext(2)
  1672. observerB.sendCompleted()
  1673. observerC.sendCompleted()
  1674. expect(completed) == false
  1675. observerA.sendNext(0)
  1676. expect(completed) == true
  1677. }
  1678. }
  1679. describe("tuple") {
  1680. beforeEach {
  1681. zip(signalA, signalB, signalC)
  1682. .observe { event in
  1683. switch event {
  1684. case let .Next(value):
  1685. zippedValues = [value.0, value.1, value.2]
  1686. case .Completed:
  1687. completed = true
  1688. default:
  1689. break
  1690. }
  1691. }
  1692. }
  1693. itBehavesLike(zipExampleName)
  1694. }
  1695. describe("sequence") {
  1696. beforeEach {
  1697. zip([signalA, signalB, signalC])
  1698. .observe { event in
  1699. switch event {
  1700. case let .Next(values):
  1701. zippedValues = values
  1702. case .Completed:
  1703. completed = true
  1704. default:
  1705. break
  1706. }
  1707. }
  1708. }
  1709. itBehavesLike(zipExampleName)
  1710. }
  1711. describe("log events") {
  1712. it("should output the correct event without identifier") {
  1713. let expectations: [String -> Void] = [
  1714. { event in expect(event) == "[] Next 1" },
  1715. { event in expect(event) == "[] Completed" },
  1716. { event in expect(event) == "[] Terminated" },
  1717. { event in expect(event) == "[] Disposed" },
  1718. ]
  1719. let logger = TestLogger(expectations: expectations)
  1720. let (signal, observer) = Signal<Int, NoError>.pipe()
  1721. signal
  1722. .logEvents(logger: logger.logEvent)
  1723. .observe { _ in }
  1724. observer.sendNext(1)
  1725. observer.sendCompleted()
  1726. }
  1727. it("should output the correct event with identifier") {
  1728. let expectations: [String -> Void] = [
  1729. { event in expect(event) == "[test.rac] Next 1" },
  1730. { event in expect(event) == "[test.rac] Failed Error1" },
  1731. { event in expect(event) == "[test.rac] Terminated" },
  1732. { event in expect(event) == "[test.rac] Disposed" },
  1733. ]
  1734. let logger = TestLogger(expectations: expectations)
  1735. let (signal, observer) = Signal<Int, TestError>.pipe()
  1736. signal
  1737. .logEvents(identifier: "test.rac", logger: logger.logEvent)
  1738. .observe { _ in }
  1739. observer.sendNext(1)
  1740. observer.sendFailed(.Error1)
  1741. }
  1742. it("should only output the events specified in the `events` parameter") {
  1743. let expectations: [String -> Void] = [
  1744. { event in expect(event) == "[test.rac] Failed Error1" },
  1745. ]
  1746. let logger = TestLogger(expectations: expectations)
  1747. let (signal, observer) = Signal<Int, TestError>.pipe()
  1748. signal
  1749. .logEvents(identifier: "test.rac", events: [.Failed], logger: logger.logEvent)
  1750. .observe { _ in }
  1751. observer.sendNext(1)
  1752. observer.sendFailed(.Error1)
  1753. }
  1754. }
  1755. }
  1756. }
  1757. }