2014年12月5日 星期五

故事爸爸的十五分鐘

上週到國小一年級的女兒教室當故事爸爸,同時也有另外一位(應該是學務處的志工)故事媽媽,我們在早自習時段各講了一個故事給女兒班上的小鬼頭們聽。看到小鬼頭的反應,讓我很有想法。

首先上場的是故事媽媽,她講了一個海馬故事 —— 海馬爸爸和海馬媽媽生了一堆小海馬(這裡穿插了一些海馬知識的介紹,例如公海馬有育兒袋),其中一隻特別不愛練習變色(繼續穿插海馬小知識,海馬靠變色隱身在環境中躲避天敵),有一天大難來臨,海馬都被大魚吃了,但不愛變色的小海馬卻剛好躲在石堆裡睡覺沒被吃(!),還救出了全家,最後被海馬公主看上,稀哩呼嚕居然變成駙馬。


credit: snaulkter  CC 2.0

故事媽媽講得認真,長得又漂亮,連講帶演,最厲害的是她居然會模仿海馬游泳的樣子,我下巴都快掉下來了。小朋友的反應呢?還好而已,並不是很熱烈,有些人托腮,有些人打呵欠。我倒是沒看到有人吃雞腿和滑手機,還好還好!

為什麼?

因為海馬故事本身一點都不有趣啊!一個不有趣的故事,表演得再生動再誇張,也沒有辦法牢牢吸住小朋友。



我講的是『好想吃榴槤』,我女兒指定我講的故事 —— 有隻天真的小老鼠沒吃過榴槤,於是跑去問他的好朋友獅子、山羊、河馬榴槤倒底是什麼味道。獅子、山羊、河馬根本沒吃過,但都胡謅一通,硬是說榴槤超好吃,吃起來像芭樂鳳梨與西瓜。小老鼠聽得傻了,口水都流出來了,於是...................... 哈哈,賣個關子。

這本故事書確實也是我最喜歡的一本,故事就是有趣,圖畫又可愛,每次看到裡面河馬張大嘴巴大喊:「當然吃過榴槤啊!味道跟芭樂一樣!」我就覺得他真的是我小時候認識的某個朋友,沒心機的不懂裝懂又愛吹牛,但很可愛。看到最後一頁大結局,又會覺得這群動物真的太好笑太可愛了,好想每一隻都抓起來捏一捏。

小朋友的反應最直接,每一雙眼睛都牢牢地盯著我,露出好奇的神情,到最後的開懷大笑,這就是故事吸引力的差別,

畢竟故事本身有趣才是一切!


 credit: Hafiz Issadeen CC 2.0


2014年12月4日 星期四

AngularJS Unit Testing

最近換工作以來突然寫Web UI的機會變多了,原本的UI是陳年老code了,多用 jquery 搭配各式 componant 再加上各種 event handler 刻出來的,程式裡到處都在操作 DOM,頗難維護。之前在W公司時就看到專業的前端工程師使用 backbone.js 這種 MVC framework,當時就頗想偷師。現在就趁此機會撥亂反正一下,把 MVC 架構帶入目前產品中,讓 UI code 更好維護。

我研究了一下最近常聽到的 javascript MVC framework,依照“要用就要用最潮的技術”的原則引領之下,選擇了 angularjs 這個 model-view-whatever framework。先不論 angularjs 與其他 framework 相比有哪些優缺點,光看 tutorial 裡每一節都有 unit test 該怎麼寫就讓身為 TDD 愛用者的我小高潮了。

接下來就分享一下我這一個月來學習 angularjs 與 unit test 的心得感想吧。

angularjs + jasmine + karma


javascrip unit testing 的工具非常多,因為太多了,我都採用 angularjs tutorial 裡面使用的 tool: jasmine test framework + karam test runner.

Test Framework - jasmine


jasmine 是個 javascript testing framework,在單元測試中的角色如同寫 c++ / java 時用到的 cppunit 與 junit 一樣,讓你方便地寫出 test cases、組合成 test suite、比較預期結果與實際結果、回報執行結果。jasmine 比較特別的是用 it() 來定義 test case,引導你要把要測試的行為用完整句子寫出來。如果你的作文能力不錯的話,真的能把 test case 寫得像文章一樣好讀。

describe('FizzBuzz', function() {

    it('outputs the original number if the input number is not multiple of 3 or 7,
        function() {
            expect(fizzbuzz(1)).toBe("1");
            expect(fizzbuzz(2)).toBe("2");
            expect(fizzbuzz(4)).toBe("4");
    });

    it('outputs "fizz" if the input number is multiple of 3', function() {
            expect(fizzbuzz(3)).toBe("fizz");
            expect(fizzbuzz(6)).toBe("fizz");
            expect(fizzbuzz(9)).toBe("fizz");
    });

    it('outputs "buzz" if the input number is multiple of 7', function() {
            expect(fizzbuzz(7)).toBe("buzz");
            expect(fizzbuzz(14)).toBe("buzz");
            expect(fizzbuzz(28)).toBe("buzz");
    });

    it('outputs "fizzbuzz" if the input number is multiple of 7 and 3',
       function() {
            expect(fizzbuzz(21)).toBe("fizzbuzz");
    });
});

我的作文能力還OK嗎?

Test Runner - karma


以前用 C++ / C# / java 時都比較不會注意到 test runner 這件事,反正你用什麼 testing framework,就是要用專用的 test runner,IDE 裡也許有內建,所以無感於 test runner 的存在。但是做 UI javascript testing 時有個大不同,UI 上的 javacript 是要丟到瀏覽器上面跑的,怎麼丟給瀏覽器?要丟給哪些瀏覽器?Test runner 就是幫我們搞定這些事情。

我這次選用的 Karam test runner 很厲害,可以跟各種 testing framework 與瀏覽器整合,無論用 jasmine、mocha 或是其他 framework,要在 chrome、firefox、safari、ie 執行測試,karma 都可以搞定。karma 還有個很貼心的服務—偵測到檔案變更時它會自己重新執行所有 test cases,對 TDD 更方便了。

karam 一次幫我搞定四個瀏覽器,非常盡責



安裝 karma 請參考這裡,安裝完可以用 karma init 產生預設的 config 再來修改。

module.exports = function(config) {
  config.set({

    basePath: '../',

    // 使用 jasmine test framework
    frameworks: ['jasmine'],

    // 哪些 file 要載入測試。陷阱注意:順序很重要
    files: [
        'test/phantomjs-fix.js',
        'js/angular.min.js',
        'test/angular-mocks.js',
        'js/volume_dialog.js',
        'test/spec/*spec.js'
    ],

    // 產生 progress 訊息與 junit report
    reporters: ['progress', 'junit'],

    // junit report 檔案名稱
    junitReporter: {
        outputFile: 'test-results.xml',
        suites: ''
    },

    port: 9876,

    colors: true,

    logLevel: config.LOG_INFO,

    autoWatch: true,

    // 要在哪些瀏覽器上面執行
    browsers: ['Chrome', 'Firefox', 'Safari', 'PhantomJS'],

    singleRun: false
  });
};


設定裡頭有兩個陷阱,一是一定要把 angular-mock.js 加入到 files 裡,二是 files 是有順序性的,angular.js 在前,angular-mock*.js 要在後。搞這個就搞死我了。

Angularjs Unit Test 到底怎麼寫


angularjs developer's guide 浮光掠影的解釋了 unit testing 要怎麼做。但看完一定沒法馬上動手寫,最有效的方法還是去找人做一遍給你看,哈!啪一下額頭就是 youtube,這個 Introduction to angularjs unit testing 很適合。


整合到 CI - 沒有 GUI怎麼辦?


寫了測試就一定要整合到 CI 裡,否則就是白寫。ㄟ .... 只是測試都是跑在瀏覽器上面,我的 CI server 沒有 GUI 沒有瀏覽器怎麼辦?就是 PhantomJS 出場的時機了。PhantomJS 也是個以WebKit 為基礎的瀏覽器,只是他不真的把畫面呈現出來,若想操作存取網頁,必須透過 PhantomJS 提供的 javascript API。

要用 PhantomJS 執行 unit test,除了安裝 PhantomJS 外,還需要 karma-phantomjs-launcher。執行 karma 時可以用 karma start --browsers PhantomJS 指定只要用 PhantomJS

用 PhantomJS 執行測試通常也很容易撞到這座牆:PhantomJS 不支援 Function.bind() method。解法就是自己實做吧!


// phantomjs-fix.js
// phantomJs does not support bind().
// See https://github.com/ractivejs/ractive/issues/679
Function.prototype.bind = Function.prototype.bind || function (thisp) {
    var fn = this;
    return function () {
        return fn.apply(thisp, arguments);
    };
};

整合到 CI - 產生 junit report


最後,在安裝 karma-junit-reporter 並設定產生檔案的名稱就能產出xml report.

2014年1月3日 星期五

純 C 的 unit testing framework - CUnit

最近我轉職去寫純 C 的程式,太多年沒接觸 C  了,好多 C  語言奇器淫巧都不熟悉,有種時光倒流回到10年前當菜鳥工程師的感覺。雖然工具不熟,但是寫程式的好習慣還沒忘記,我一開工就立刻找找有什麼純 C 的 unit testing framework  可以使用。

我找到了個 CUnit。CUnit  文件相當精要,掃過一遍之後就知道它合用了。真正用起來果然也容易上手。唯一碰到的小討厭就是和 Jenkins CI  整合的問題 - 廣大的 JUnit / NUnit  / 甚至是 JsUnit 用戶都有專屬 plugin  分析 unit test 產生的 XML 測試結果,可以直接在  Jenkins  上面看到哪些 test case 失敗以及測試歷史紀錄,但是CUnit 太小眾了,當然沒有人為他寫 Jenkins plugin。

好險我找到了個好東西 - xUnit plugin,他可以把很多稀奇古怪 unit test framework (例如:AUnit / UnitTest++ / boost test / pascal unit ...)產生的 XML
測試文件轉成最常用支援最多的 JUnit 格式,再由,再由 JUnit plugin 去分析統計結果!雖然 CUnit  太小眾了,讓 xUnit  不知如何轉換(靠!有比 Pascal  Unit 小眾嗎?),但是 xUnit 可以讓使用者自訂 xml style sheet  來轉換 XML,哈,那擴充支援 CUnit 就是小菜一疊而已了。

我寫好的 CUnit -> JUnit xml style sheet 在  GitHub 上,歡迎取用。

2013年2月1日 星期五

關於占用騎樓


做生意的店家佔用騎樓這種小事,我想大家看到都麻木了吧!尤其當店家不是第一天佔地為王,而是已經佔用了好幾年,甚至是整條街都這樣搞,如果還有人覺得「跟相關單位反映」會有用的,那他也太天真了。

我雖然很天真,但也沒那麼天真。只是每次看到那幾個把整個廚房搬到騎樓的店家、把地上弄得油油膩膩腳踩上去就快黏住的店家、把冰箱料理台都放在騎樓的店家... 心裡真是非常不愉快。算是死馬當活馬醫兼發洩一下而已,於是我上了新北市政府的網站,點進了市長信箱,反映此些商家的違規情況並附上幾張照片。猜想一周後會大概會有個「本府已行文OO單位處理,若對本案仍有其他意見或疑問,惠請與XXX聯絡,將竭誠為您服務與說明」類似的制式回應吧。

一周後真的收到非常類似的回應,而且還有一句「市長非常重視」。嘿嘿,朱市長有重視耶~~ 最好是這樣。

再一周,ㄟ,這幾家店開始施工了,是擴大營業嗎?又再過三天,原來他是在裝修廚房,真的是把鍋碗瓢盆料理台菜刀切菜板搬回店裡面了。又過了三天,經過店面的時候聽見幾家店的老闆聚在一起,居然是在討論到底是誰去檢舉的!!!(哈)

不可思議啊!透過市長信箱檢舉長久當路霸的店家居然有用,真得太出乎意料了!身為市長頭家的我,第一次有當頭家的快意。警察局也頗有效率,雖然仍是打一鞭才會動一下有告才有理(我就不相信轄區派出所不知道這條路上占用騎樓嚴重,只是沒人檢舉他樂的不處理而已),但有處理就真的有效果,也比我以為得好多了。

從前我看到破壞生活環境的事物多是心理忿忿不平而已,但經過這次的檢舉成功,更讓我心中的抓耙子檢舉魂再次燃燒(是的,我從小就是個愛告狀兼打小報告令同學討厭的人),哈哈,現在你們得小心我這個超級抓耙子了!

2012年6月21日 星期四

王品餐後感


上周末到王品為岳父大人慶生,回家之後著實不舒服至今,忍不住說說它的壞話...

分量實在太大  大到不舒服

所有人到過王品的人都學會這項求生技能:主菜上了就要直接打包帶走,免得撐死 。可是.... 幹.... 嘛要餵我吃這麼多呢?當我看到岳父點的超大一塊台塑牛排上桌時,心裡只覺得好險沒選這道主菜,否則撐死的就是我。王品就不能把分量弄少一點、但更精緻一點嗎?

另外,隔壁是男生幫女友慶生,我非常為那位精心準備的男生感到惋惜,他準備了花和禮物,在王品吃個午餐卻身心受到極大負荷(至少胃腸啦),接下來要去薇閣其他安排好的行程勢必受到影響。


吃完牛排  喉嚨痛到現在

吃完王品第二天起我喉嚨就開始痛,雖然時間順序不代表因果關係,算我賴到王品頭上好了,我猜極有可能因為牛排燒烤的火候太烈,傷害了我細嫩的喉嚨。#@%^$#@$%.... (喉嚨太痛胡言亂語中)


總之,王品的後座力時在驚人,沒甚麼意外我應該不太敢再去嘗試了。

2012年6月17日 星期日

關於一個熱血開發團隊

要離開前公司時,我部門的大老闆問我到底新公司是哪裡吸引我?我說我很期待跟一群好漢一起坐個新產品,雖然面對很多不確定 - 客戶到底存不存在? 產品概念能不能被接受? - 但是我們一起學習,一起解決,互相幫忙,完成困難的任務,這非常很吸引我。

大老闆聽完後說:「你追求的東西好虛幻」,而我馬上就臉紅了....

※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※

換到新公司的第一個月,我獨自開發 Windows 產品的後端程式,進展得相當穩定,卻是穩定的慢。看著其他 team 的 burndown chart 真的是狂燒,我的卻是蝸牛慢慢爬,又沒有 team member 可以靠一下,心中真的是相當焦慮又無助。

某天,突然同事「大支」跑來找我,跟我說他手上的工作快要到一個段落了,即日起自願加入 Windows 的陣營一起用 C# 開發,而他本來都是寫 python 和 C/C++ , 完全沒寫過 C#!我問他為什麼會想轉職,他說他兩個月前剛來公司的時候也是自己一個人開發,感覺真的很糟,他了解這種苦悶,所以才想過來幫忙。

大支看了一篇 從 C++ 到 C# 注意事項後就上工了。兩個月後我們的 release 了我們產品的第一個版本,回想起孤軍奮戰的那一個月,真是慶幸有大支的見義勇為。

今年二月底賴瑞加入 Windows 團隊後,我們變得更像個精實的作戰部隊了 ─ 接到任務後我們可以拆解成數個獨立目標,和 Product Owner 討論執行優先順序後,大支、賴瑞、我又一起反覆討論該程式該怎麼實作然後再去分工。兩個讓我覺得最棒的地方就是


  1. 我們是共同設計程式 : 我們會討論到應該用哪些 class 用哪種 pattern 加哪些 handler 送出那些 event 物件之間怎麼樣call來call去都討論得很深入,不是「就地分贓」式的儘把工作分三塊然後老死不相往來直到程式爆炸的那一天! 設計定案後再把該做的工作分成三塊,由最菜的開始先開始認領要做哪一塊。
  2. 我們互相幫忙 : 發現了 bug 永遠會有人搶著把他解掉,先完成工作的人會隨時來問有沒有地方需要他的幫忙 。
這樣熱血合作的開發團隊,幾乎就是我心目中理想的團隊了!(成員全是宅男扣5分 應該要搭配兩位腐女才對....)

※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※ ※

回到前公司大老闆的 comment:「你追求的東西好虛幻」。是的,「熱血合作團隊」對大老闆那種職位的人來說已經是太遙遠的過去而沒有任何意義了。但對我來說,在一個「熱血合作團隊」中工作很重要,它能讓我安定並發揮最大的力量。

事隔快一年再度想起大老闆的 comment 還是會讓我有點臉紅,但這次是因為能夠身處一個讓我熱血澎湃的團隊而潮紅。