[Scala] SPlurk 0.0.1 釋出!

既然生活在台灣,我想噗浪是什麼就不用多說了。

簡介

SPlurk 是一套 Scala 程式語言的函式庫,實作了官方的 Plurk API 裡所有的函式,透過 SPlurk,你可以在 Scala 的程式裡面操作噗浪,例如讀取噗文或者發噗。要用他來寫噗浪機器人當然也是沒有問題的。:-)

SPlurk 擁有以下的特點:

  • 容易使用

    • SPlurk 實作了所有官方列出的 Plurk API,而且裡面使用的是你所熟悉的 Map、List 以及 case class 和 tuple 等東西。
    • SPlurk 裡的命名是與官方的 Plurk API 對應的,不用怕找不到。
  • Type-Safe

    • SPlurk 是以 type-safe 為設計理念的,所有 optional 的回傳值,都被標成 Option[T],讓你免於 NullPointerException 爆炸的痛苦。
  • No JSONObject

    • 你不用再去處理煩人的 JSONObject,SPlurk 已經幫你做好了。所有從噗浪撈回來的資料,都會被轉成一般的物件,用就對了!

使用範例

來看些使用範例,就知道 SPlurk 用起來有多簡單囉!

  • 登入並取得使用者的時間軸
import org.bone.splurk._

val username = "YourUserName" // 設定你的噗浪帳號
val password = "YourPassword" // 設定你的噗浪密碼
val apiKey   = "YourAPIKey"   // 設定你所申請到的 API Key

val client = new PlurkClient(apiKey)     // 建立 SPlurk 物件
client.Users.login (username, password)  // 登入噗浪

val (users, plurks) = client.Timeline.getPlurks()  // 撈回使用者的時間軸

// users 的型別是 Map[Long, PlurkUser]、key 是使用者的 userID,值是使用者資料
users.foreach(println)

// plurks 的型別是 List[Plurk],就是時間軸上的噗文囉!
plurks.foreach(println)
  • 發噗
import org.bone.splurk._
import org.bone.splurk.constant._

val username = "YourUserName" // 設定你的噗浪帳號
val password = "YourPassword" // 設定你的噗浪密碼
val apiKey   = "YourAPIKey"   // 設定你所申請到的 API Key

val client = new PlurkClient(apiKey)     // 建立 SPlurk 物件
client.Users.login (username, password)  // 登入噗浪

// 發噗
client.Timeline.plurkAdd (
    qualifier = Qualifier.Says,  // 設定噗文前的修飾詞(說、喜歡、正在……等)
    content   = "我是用 SPlurk 發噗的喔",  // 噗文的內容
    language  = Some(Language.tr_ch)  // 修飾詞的語言(tr_ch 為中文)
)

回響