naver-sdk 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 902c0f867a9dd5fd7bf428f47c1dcc5a6c519c68
-  data.tar.gz: b1278f9fc5d852e56e6b74345228e500fb60dde0
+  metadata.gz: 3c55ce738ad94ea471c6009f367ceeb3c218fa7f
+  data.tar.gz: 37cac2f7a5327a355f5780a6db95876407e9b552
 SHA512:
-  metadata.gz: f152e5cdc319e234c633cb47232e9d7ce95dd012fec0c54c33ad606f701b3398f050dda67370f83508597112e0aeef218e7149e3b3b2fb3cfdee58a9f7053a66
-  data.tar.gz: f19dd9aaca20067fbd86c5eb42cfccd681424f8bef2120d8fa00ec8674909e07e4afc1badc559dc1aab4f06f78c4ef5112e5b95081b17002432a7729d8434726
+  metadata.gz: 7a84999ca63d2a7ee8c375fab770244789ae958d8738ff0ad1dd14d2af1f30b30b4d05af58e1fd4f7852f43d07da6344a3858757fc7fe301f256d415bea0f606
+  data.tar.gz: 3f428fc4872cc930f564fb878ca26ffb3a1cdb41638d2bab07c3461b62752b93a5206af6459bc40ec5b2653184951c334ead3b4a757bd7eb9568cb0e0e2e4d96

data/CHANGELOG.md

@@ -4,16 +4,22 @@ All notable changes to this project will be documented in this file.
 ## [unreleased]
 - No significant changes.
 
+## [0.3.0] - 2017-06-26
+- [new] 얼굴인식(Beta)
+- [breaking] `Naver::Clova::tts` renamed to `Naver::Voice::tts`.
+- [breaking] `Naver::Shortenurl::url` renamed to `Naver::Shorturl::shorten`.
+
 ## [0.2.0] - 2017-06-25
-- 음성합성(Beta)
-- 네이버 공유하기
-- Naver::Search.adult 리턴값을 "1" -> true, "0" -> false로 변경
-- Naver::Search.errata에서 오타가 없을 경우 리턴값을 "" -> nil로 변경
+- [new] 음성합성(Beta)
+- [new] 네이버 공유하기
+- [breaking] Naver::Search.adult 리턴값을 "1" -> true, "0" -> false로 변경
+- [breaking] Naver::Search.errata에서 오타가 없을 경우 리턴값을 "" -> nil로 변경
 
 ## [0.1.0] - 2017-06-24
 
 - first release
 
 [0.1.0]: https://github.com/kimsuelim/naver-sdk-ruby/releases/tag/v0.1.0
-[0.2.0]: https://github.com/kimsuelim/naver-sdk-ruby/compare/v0.2.0...v0.1.0
-[unreleased]: https://github.com/kimsuelim/naver-sdk-ruby/compare/v0.1.0...HEAD
+[0.2.0]: https://github.com/kimsuelim/naver-sdk-ruby/compare/v0.1.0...v0.2.0
+[0.3.0]: https://github.com/kimsuelim/naver-sdk-ruby/compare/v0.2.0...v0.3.0
+[unreleased]: https://github.com/kimsuelim/naver-sdk-ruby/compare/v0.3.0...HEAD

data/README.md

@@ -1,10 +1,17 @@
 # NAVER SDK for Ruby
 
 [![Build Status](https://travis-ci.org/kimsuelim/naver-sdk-ruby.svg?branch=master)](https://travis-ci.org/kimsuelim/naver-sdk-ruby)
-[![Coverage Status](https://coveralls.io/repos/kimsuelim/naver-sdk-ruby/badge.svg?branch=master)](https://coveralls.io/r/kimsuelim/naver-sdk-ruby?branch=master)
-[![Gem Version](https://badge.fury.io/rb/naver-sdk.svg)](http://badge.fury.io/rb/naver-sdk)
+[![Coverage Status](https://coveralls.io/repos/github/kimsuelim/naver-sdk-ruby/badge.svg?branch=master)](https://coveralls.io/github/kimsuelim/naver-sdk-ruby?branch=master)
+[![Gem Version](https://badge.fury.io/rb/naver-sdk.svg)](https://badge.fury.io/rb/naver-sdk)
 
 A ruby client for the NAVER API. [https://developers.naver.com](https://developers.naver.com)
+
+## Links of Interest
+
+* [네이버 개발자 센터](https://developers.naver.com)
+* [API 문서](http://www.rubydoc.info/github/kimsuelim/naver-sdk-ruby/)
+* [Change Log](https://github.com/kimsuelim/naver-sdk-ruby/blob/master/CHANGELOG.md)
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -41,6 +48,114 @@ Naver.configure do |config|
 end
 ```
 
+## 얼굴인식
+입력된 얼굴 사진을 분석해서 닮은 연예인이나 얼굴 감지
+
+### 유명인 얼굴인식(Beta)
+```
+response = Naver::Vision.celebrity(image: "test/resources/park.png")
+# => #<Naver::ObjectifiedHash:70286633240760 {hash: {
+  "info"=>{
+    "size"=>{"width"=>683, "height"=>377},
+    "faceCount"=>1
+  },
+  "faces"=>[
+    {"celebrity"=>{"value"=>"박성웅", "confidence"=>1.0}}
+  ]
+}}
+
+puts response.faces[0].celebrity.value
+# => "박성웅"
+```
+
+테스트에서 사용한 이미지 보기 [test/resources/park.png](test/resources/park.png)
+
+### 얼굴 감지(Beta)
+```
+response = Naver::Vision.face(image: "test/resources/park.png")
+# => #<Naver::ObjectifiedHash:70286633075440 {hash: {
+  "info"=>{"size"=>{"width"=>683, "height"=>377}, "faceCount"=>1},
+  "faces"=>[
+    {
+      "roi"=>{"x"=>214, "y"=>106, "width"=>117, "height"=>117},
+      "landmark"=>{
+        "leftEye"=>{"x"=>241, "y"=>137},
+        "rightEye"=>{"x"=>296, "y"=>126},
+        "nose"=>{"x"=>271, "y"=>166},
+        "leftMouth"=>{"x"=>250, "y"=>195},
+        "rightMouth"=>{"x"=>309, "y"=>185}
+      },
+      "gender"=>{"value"=>"male", "confidence"=>0.999884},
+      "age"=>{"value"=>"44~48", "confidence"=>0.79507},
+      "emotion"=>{"value"=>"smile", "confidence"=>0.988639},
+      "pose"=>{"value"=>"frontal_face", "confidence"=>0.99785}
+    }
+  ]
+}}
+
+puts response.faces[0].gender.value
+# => "male"
+
+puts response.faces[0].emotion.value
+# => "smile"
+```
+
+테스트에서 사용한 이미지 보기 [test/resources/park.png](test/resources/park.png)
+
+## 음성합성
+입력된 텍스트를 성우의 낭독 음성으로 합성
+
+### tts(Beta)
+```
+response = Naver::Voice.tts(
+  speaker: "mijin",
+  speed: 0,
+  text: "기술은 사람을 대체하는 것이 아니라 기술의 도움으로 사람을 더 창조적으로 만들 것이라 믿는다."
+)
+
+file = File.open("tts.mp3", "wb") { |f| f.write(response) }
+# => 62532
+```
+
+합성된 음성 듣기 [test/resources/tts.mp3](test/resources/tts.mp3)
+
+## 파파고
+
+### 한글인명 - 로마자 변환
+
+```ruby
+response = Naver::Papago.romanization(query: "김수림")
+=> #<Naver::ObjectifiedHash:70284972145960 {hash: {
+  "sFirstName"=>"김",
+  "aItems"=>[
+    {"name"=>"Kim Soorim", "score"=>"99"},
+    {"name"=>"Kim Soolim", "score"=>"97"},
+    {"name"=>"Kim Surim", "score"=>"78"},
+    {"name"=>"Kim Sulim", "score"=>"76"}
+  ]}
+}
+
+puts response.aItems[0].name
+# => "Kim Soorim"
+```
+
+### 기계번역(Beta)
+
+```ruby
+response = Naver::Papago.translate(
+  source: "ko",
+  target: "en",
+  text: "기술이 인간을 대체하는 것이 아니라 인간은 기술의 도움으로 더욱 창조적으로 될 것이라는 믿는다."
+)
+# => #<Naver::ObjectifiedHash:70362563050680 {hash: {
+  "translatedText"=>"To replace the technology not believe that humans are more creatively with the help of technology."
+  }
+}
+
+puts response.translatedText
+# => "To replace the technology not believe that humans are more creatively with the help of technology."
+```
+
 ## 지도
 
 ### 주소 -> 좌표 변환
@@ -86,7 +201,7 @@ puts response[0].point.x
 
 ### url
 ```ruby
-response = Naver::Shortenurl.url(url: "https://github.com/kimsuelim")
+response = Naver::Shorturl.shorten(url: "https://github.com/kimsuelim")
 # => #<Naver::ObjectifiedHash:70284972276780 {hash: {
   "hash"=>"Fr4K6WFj",
   "url"=>"http://me2.do/Fr4K6WFj",
@@ -97,44 +212,6 @@ puts response.url
 # => "http://me2.do/Fr4K6WFj"
 ```
 
-## 파파고
-
-### 한글인명 - 로마자 변환
-
-```ruby
-response = Naver::Papago.romanization(query: "김수림")
-=> #<Naver::ObjectifiedHash:70284972145960 {hash: {
-  "sFirstName"=>"김",
-  "aItems"=>[
-    {"name"=>"Kim Soorim", "score"=>"99"},
-    {"name"=>"Kim Soolim", "score"=>"97"},
-    {"name"=>"Kim Surim", "score"=>"78"},
-    {"name"=>"Kim Sulim", "score"=>"76"}
-  ]}
-}
-
-puts response.aItems[0].name
-# => "Kim Soorim"
-```
-
-### 기계번역(Beta)
-
-```ruby
-response = Naver::Papago.translate(
-  source: "ko",
-  target: "en",
-  text: "기술이 인간을 대체하는 것이 아니라 인간은 기술의 도움으로 더욱 창조적으로 될 것이라는 믿는다."
-)
-
-# => #<Naver::ObjectifiedHash:70362563050680 {hash: {
-  "translatedText"=>"To replace the technology not believe that humans are more creatively with the help of technology."
-  }
-}
-
-puts response.translatedText
-# => "To replace the technology not believe that humans are more creatively with the help of technology."
-```
-
 ## 네이버 공유하기
 
 ### url
@@ -143,23 +220,6 @@ Naver::Share.url(url: "https://github.com/kimsuelim", title: "The unofficial NAV
 # => "http://share.naver.com/web/shareView.nhn?url=https%3A%2F%2Fgithub.com%2Fkimsuelim&title=The+unofficial+NAVER+SDK+for+Ruby"
 ```
 
-## 클로바
-
-### 음성합성(Beta)
-```
-response = Naver::Clova.tts(
-  speaker: "mijin",
-  speed: 0,
-  text: "기술이 인간을 대체하는 것이 아니라 인간은 기술의 도움으로 더욱 창조적으로 될 것이라는 믿는다."
-)
-
-file = File.open("tts.mp3", "wb") { |f| f.write(response) }
-# => 62532
-```
-
-### 얼굴인식(Beta)
-TODO...
-
 ## 검색
 
 ### 블로그

data/lib/naver/papago.rb

@@ -3,14 +3,20 @@ module Naver # :nodoc:
   class Papago < Client
     class << self
       # 기계번역(Beta)
-      # @param params [Hash] Params for the translate
-      def translate(params = {})
+      # @param source [String] 번역 소스 텍스트의 언어 설정: (ko:한국어, en:영어, ja:일본어, zh-CN:중국어(간체), zh-TW:중국어(번체)
+      # @param target [String] 번역 대상 언어, 가능한 값은 source 파라미터와 동일
+      # @param text [String] 번역할 문장이며 UTF-8만 지원
+      # @return [Hash] 번역된 문장
+      def translate(source:, target:, text:)
+        params = method(__method__).parameters.map(&:last).map { |p| [p, eval(p.to_s)] }.to_h
         parse(JSON.parse(connection.post("/v1/language/translate", params).body)["message"]["result"])
       end
 
       # 한글인명 - 로마자 변환
-      # @param params [Hash] Params for the translate
-      def romanization(params = {})
+      # @param query [String] 로마자로 바꾸려는 한글 이름
+      # @return [Hash] 변환 결과
+      def romanization(query:)
+        params = { query: query }
         parse(JSON.parse(connection.get("/v1/krdict/romanization", params).body)["aResult"][0])
       end
     end

data/lib/naver/sdk.rb

@@ -9,13 +9,14 @@ require "naver/error"
 require "naver/oauth"
 require "naver/objectified_hash"
 
-require "naver/clova"
 require "naver/map"
 require "naver/papago"
 require "naver/profile"
 require "naver/search"
 require "naver/share"
-require "naver/shortenurl"
+require "naver/shorturl"
+require "naver/vision"
+require "naver/voice"
 
 module Naver
   extend Config

data/lib/naver/sdk/version.rb

@@ -1,5 +1,5 @@
 module Naver
   module Sdk
-    VERSION = "0.2.0"
+    VERSION = "0.3.0"
   end
 end

data/lib/naver/shorturl.rb

@@ -0,0 +1,14 @@
+module Naver # :nodoc:
+  # Naver Shorturl API
+  class Shorturl < Client
+    class << self
+      # 단축URL
+      # @param url [String] 단축하고자 하는 원본 URL
+      # @return [ObjectifiedHash] 단축 결과
+      def shorten(url:)
+        params = { url: url }
+        parse(JSON.parse(connection.post("/v1/util/shorturl", params).body)["result"])
+      end
+    end
+  end
+end

data/lib/naver/vision.rb

@@ -0,0 +1,24 @@
+module Naver # :nodoc:
+  # Naver Vision API
+  class Vision < Client
+    class << self
+      # 유명인 얼굴인식(Beta)
+      # @param image [Binary] 얼굴이 포함된 이미지 (최대 2MB)
+      # @return [Hash] 인식결과
+      def celebrity(image:)
+        params = {}
+        params[:image] = Faraday::UploadIO.new(image, "image/jpeg")
+        parse(JSON.parse(connection.post("/v1/vision/celebrity", params).body))
+      end
+
+      # 얼굴 감지(Beta)
+      # @param image [Binary] 얼굴이 포함된 이미지 (최대 2MB)
+      # @return [Hash] 인식결과
+      def face(image:)
+        params = {}
+        params[:image] = Faraday::UploadIO.new(image, "image/jpeg")
+        parse(JSON.parse(connection.post("/v1/vision/face", params).body))
+      end
+    end
+  end
+end

data/lib/naver/{clova.rb → voice.rb}

@@ -1,6 +1,6 @@
 module Naver # :nodoc:
-  # Naver Clova API
-  class Clova < Client
+  # Naver Voice API
+  class Voice < Client
     class << self
       # 음성합성(Beta)
       # @param speaker [String] 음성 합성할 목소리 설정: ( mijin:미진(한국어, 여성), jinho:진호(한국어, 남성), clara:클라라(영어, 여성), matt:매튜(영어, 남성), yuri:유리(일본어, 여성), shinji:신지(일본어, 남성), meimei:메이메이(중국어, 여성))

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: naver-sdk
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Surim Kim
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-06-24 00:00:00.000000000 Z
+date: 2017-06-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -133,7 +133,6 @@ files:
 - bin/console
 - bin/setup
 - lib/naver/client.rb
-- lib/naver/clova.rb
 - lib/naver/config.rb
 - lib/naver/connection.rb
 - lib/naver/error.rb
@@ -146,7 +145,9 @@ files:
 - lib/naver/sdk/version.rb
 - lib/naver/search.rb
 - lib/naver/share.rb
-- lib/naver/shortenurl.rb
+- lib/naver/shorturl.rb
+- lib/naver/vision.rb
+- lib/naver/voice.rb
 - naver-sdk.gemspec
 homepage: https://github.com/kimsuelim/naver-sdk-ruby
 licenses:

data/lib/naver/shortenurl.rb

@@ -1,12 +0,0 @@
-module Naver # :nodoc:
-  # Naver Shortenurl API
-  class Shortenurl < Client
-    class << self
-      # 단축URL
-      # @param params [Hash] Params for the origin url
-      def url(params = {})
-        parse(JSON.parse(connection.post("/v1/util/shorturl", params).body)["result"])
-      end
-    end
-  end
-end