# -*- coding: utf-8 -*-
module Mushikago
  module Hotaru
    # Hotaruサービスを利用する
    #
    # @example
    #   client = Mushikago::Hotaru::Client.new(:api_key => '<api_key>', :secret_key => '<secret_key>')
    #
    #   client.capture('http://www.hotaru.ne.jp/', :thumbnail => true, :tags => ['hotaru', 'webservice'])
    #
    #   captures = client.captures
    #   captures['images'].each do |image|
    #     puts image['image_url']
    #   end
    #
    # @example APIキーをファイルから読み込む場合
    #   Mushikago.config.load(YAML.load(File.read('config.yml')))
    #   client = Mushikago::Hotaru::Client.new
    class Client < Mushikago::Http::Client
      # ドメインを作成する
      #
      # @param [String] domain_name ドメイン名
      # @param [String] splitter スプリッター
      # @param [Hash] options リクエストのオプション
      # @option options [String] :description ドメインの説明
      # @option options [String,Array] :dictionary_ids ユーザ辞書のID
      # @option options [String,Array] :tags ドメイン内で使用するタグ
      # @example
      #   client.domain_create('sample_domain', '2gram')
      # @return [Mushikago::Http::Response] リクエストの結果
      def domain_create domain_name, splitter, options={}
        request = Hotaru::DomainCreateRequest.new(domain_name, splitter, options)
        send_request(request)
      end

      # ドメインの情報を参照する
      #
      # @param [String] domain_name ドメイン名
      # @param [Hash] options リクエストのオプション
      # @option options [Integer] :time
      # @example
      #   client.domain_info('sample_domain')
      # @return [Mushikago::Http::Response] リクエストの結果
      def domain_info domain_name, options={}
        request = Hotaru::DomainInfoRequest.new(domain_name, options)
        send_request(request)
      end

      # ドメインの一覧を取得する
      #
      # @param [Hash] options リクエストのオプション
      # @option options [Integer] :limit
      # @option options [Integer] :offset
      # @option options [String] :filter
      # @example
      #   client.domain_list
      # @return [Mushikago::Http::Response] リクエストの結果
      def domain_list options={}
        request = Hotaru::DomainListRequest.new(options)
        send_request(request)
      end

      # ドメインを削除する
      #
      # @param [String] domain_name ドメイン名
      # @param [Hash] options リクエストのオプション
      # @example
      #   client.domain_delete 'sample_domain'
      # @return [Mushikago::Http::Response] リクエストの結果
      def domain_delete domain_name, options={}
        request = Hotaru::DomainDeleteRequest.new(domain_name, options)
        send_request(request)
      end

      # テキストを登録する 
      #
      # @param [String] domain_name ドメイン名
      # @param [String] text テキスト
      # @param [String] tags タグ
      # @param [Hash] options リクエストのオプション
      # @option options [String] :text_name テキストにつける名前
      # @example
      #   client.text_put 'sample_domain', '吾輩は猫である。名前はまだない。....', ['夏目漱石'], :text_name => '吾輩は猫である'
      # @return [Mushikago::Http::Response] リクエストの結果
      def text_put domain_name, text, tags, options={}
        request = Hotaru::TextPutRequest.new(domain_name, text, tags, options)
        send_request(request)
      end

      # テキストを削除する 
      #
      # @param [String] domain_name ドメイン名
      # @param [String] text_id テキストID
      # @param [Hash] options リクエストのオプション
      # @option options [String] :forcedelete textを強制的に削除する場合true
      # @example
      #   client.text_delete 'sample_domain', 'text_id'
      # @return [Mushikago::Http::Response] リクエストの結果
      def text_delete domain_name, text_id, options={}
        request = Hotaru::TextDeleteRequest.new(domain_name, text_id, options)
        send_request(request)
      end

      # テキストにヒモ付たタグの追加更新
      #
      # @param [String] domain_name ドメイン名
      # @param [String] text_id テキストID
      # @param [String,Array] tags タグ
      # @param [Hash] options リクエストのオプション
      # @option options [String] :replace tagを追加する場合false, 入れ替える場合true
      # @example
      #   client.text_tagset 'sample_domain', 'text_id', ['hoge']
      # @return [Mushikago::Http::Response] リクエストの結果
      def text_tagset domain_name, text_id, tags, options={}
        request = Hotaru::TextTagsetRequest.new(domain_name, text_id, tags, options)
        send_request(request)
      end

      # テキストを取得する 
      #
      # @param [String] domain_name ドメイン名
      # @param [String] text_id テキストID
      # @param [Hash] options リクエストのオプション
      # @option options [Boolean] :with_body trueを指定すると、response['body']でファイルの内容にアクセスすることができるようになります。
      # @example
      #   client.text_get 'sample_domain', 'text_id'
      # @return [Mushikago::Http::Response] リクエストの結果
      def text_get domain_name, text_id, options={}
        request = Hotaru::TextGetRequest.new(domain_name, text_id, options)
        result = send_request(request)
        if options[:with_body]
          begin
            uri = URI.parse(result['url'])
            result['body'] = Net::HTTP.get(uri.host, uri.request_uri)
          rescue
          end
        end
        return result
      end

      # テキスト一覧を取得する
      #
      # @param [String] domain_name ドメイン名
      # @param [Hash] options リクエストのオプション
      # @option options [Integer] :limit
      # @option options [Integer] :offset
      # @option options [String] :filter
      # @option options [String,Array] :tags
      # @option options [String] :status
      # @example
      #   client.text_list('sample_domain')
      # @return [Mushikago::Http::Response] リクエストの結果
      def text_list domain_name, options={}
        request = Hotaru::TextListRequest.new(domain_name, options)
        send_request(request)
      end

      # 指定されたtextにふさわしいtagを返す
      #
      # @param [String] domain_name ドメイン名
      # @param [String] text text
      # @param [Hash] options リクエストのオプション
      # @example
      #   client.classifier_judge
      # @return [Mushikago::Http::Response] リクエストの結果
      def classifier_judge domain_name, text, options={}
        request = Hotaru::ClassifierJudgeRequest.new(domain_name, text, options)
        send_request(request)
      end

      # 共起グラフを作成する
      #
      # @param [String] domain_name ドメイン名
      # @param [String,Array] tags タグ
      # @param [Hash] options リクエストのオプション
      # @option options [String,Array] :parts_of_speech 共起を取る単語の品詞
      # @option options [String] :collocation_name 共起グラフにつける名前
      # @option options [String] :lower_threshold 単語の出現数下限
      # @option options [String] :upper_threshold 単語の出現数上限
      # @option options [String] :description 共起グラフの説明
      # @example
      #   client.collocation_create('sample_domain', ['tag1', 'tag2'])
      #   client.collocation_create('sample_domain', 'tag1', :parts_of_speech => Mushikago::Hotaru::CollocationCreateRequest::POS_LARGE)
      # @return [Mushikago::Http::Response] リクエストの結果
      def collocation_create domain_name, tags, options={}
        request = Hotaru::CollocationCreateRequest.new(domain_name, tags, options)
        send_request(request)
      end

      # 共起グラフ一覧を取得する
      #
      # @param [String] domain_name ドメイン名
      # @param [Hash] options リクエストのオプション
      # @option options [Integer] :limit
      # @option options [Integer] :offset
      # @option options [String] :filter
      # @option options [String] :status
      # @example
      #   client.collocation_list('sample_domain')
      # @return [Mushikago::Http::Response] リクエストの結果
      def collocation_list domain_name, options={}
        request = Hotaru::CollocationListRequest.new(domain_name, options)
        send_request(request)
      end

      # 共起グラフを削除する
      #
      # @param [String] domain_name ドメイン名
      # @param [String] collocation_id 共起ID
      # @param [Hash] options リクエストのオプション
      # @example
      #   client.collocation_delete('sample_domain', 'c12345')
      # @return [Mushikago::Http::Response] リクエストの結果
      def collocation_delete domain_name, collocation_id, options={}
        request = Hotaru::CollocationDeleteRequest.new(domain_name, collocation_id, options)
        send_request(request)
      end

      # 共起語を取得する
      #
      # @param [String] domain_name ドメイン名
      # @param [String] collocation_id 共起ID
      # @param [String] word 共起語を取得したい単語
      # @param [Hash] options リクエストのオプション
      # @example
      #   client.collocation_get('sample_domain', 'c12345', '我輩')
      # @return [Mushikago::Http::Response] リクエストの結果
      def collocation_get domain_name, collocation_id, word, options={}
        request = Hotaru::CollocationGetRequest.new(domain_name, collocation_id, word, options)
        send_request(request)
      end

      # 共起グラフ内の単語一覧を取得する
      #
      # @param [String] domain_name ドメイン名
      # @param [String] collocation_id 共起ID
      # @param [Hash] options リクエストのオプション
      # @option options [Integer] :limit
      # @option options [Integer] :offset
      # @option options [String] :filter
      # @example
      #   client.collocation_wordlist('sample_domain', 'c12345')
      # @return [Mushikago::Http::Response] リクエストの結果
      def collocation_wordlist domain_name, collocation_id, options={}
        request = Hotaru::CollocationWordlistRequest.new(domain_name, collocation_id, options)
        send_request(request)
      end

      # 共起グラフをダウンロードする
      #
      # @param [String] domain_name ドメイン名
      # @param [String] collocation_id 共起ID
      # @param [Hash] options リクエストのオプション
      # @option options [Boolean] :with_body trueを指定すると、response['body']でファイルの内容にアクセスすることができるようになります。
      # @example
      #   client.collocation_download('sample_domain', 'c12345')
      # @return [Mushikago::Http::Response] リクエストの結果
      def collocation_download domain_name, collocation_id, options={}
        request = Hotaru::CollocationDownloadRequest.new(domain_name, collocation_id, options)
        result = send_request(request)
        if options[:with_body]
          begin
            uri = URI.parse(result['url'])
            result['body'] = Net::HTTP.get(uri.host, uri.request_uri)
          rescue
          end
        end
        return result
      end

      # ドメインにタグを登録する
      #
      # @param [String] domain_name ドメイン名
      # @param [String] tag タグ
      # @param [Hash] options リクエストのオプション
      # @example
      #   client.tag_put('sample_domain', 'tag1')
      # @return [Mushikago::Http::Response] リクエストの結果
      def tag_put domain_name, tag, options={}
        request = Hotaru::TagPutRequest.new(domain_name, tag, options)
        send_request(request)
      end

      # ドメインに登録されているタグを削除する
      #
      # @param [String] domain_name ドメイン名
      # @param [String] tag タグ
      # @param [Hash] options リクエストのオプション
      # @example
      #   client.tag_delete('sample_domain', 'tag1')
      # @return [Mushikago::Http::Response] リクエストの結果
      def tag_delete domain_name, tag, options={}
        request = Hotaru::TagDeleteRequest.new(domain_name, tag, options)
        send_request(request)
      end

      # ドメイン内のタグ一覧を取得する
      #
      # @param [String] domain_name ドメイン名
      # @param [Hash] options リクエストのオプション
      # @option options [String] :filter
      # @example
      #   client.tag_list('sample_domain')
      # @return [Mushikago::Http::Response] リクエストの結果
      def tag_list domain_name, options={}
        request = Hotaru::TagListRequest.new(domain_name, options)
        send_request(request)
      end

      # 単語の一覧を取得する
      #
      # @param [Hash] options リクエストのオプション
      # @param [String] domain_name ドメイン名
      # @option options [Integer] :limit
      # @option options [Integer] :offset
      # @option options [String] :filter
      # @example
      #   client.word_list 'sample_domain'
      # @return [Mushikago::Http::Response] リクエストの結果
      def word_list domain_name, options={}
        request = Hotaru::WordListRequest.new(domain_name, options)
        send_request(request)
      end

      # 指定した単語の詳細な情報を返す
      #
      # @param [String] domain_name ドメイン名
      # @param [String] word
      # @param [Hash] options リクエストのオプション
      # @example
      #   client.word_get('sample_domain', '我輩')
      # @return [Mushikago::Http::Response] リクエストの結果
      def word_get domain_name, word, options={}
        request = Hotaru::WordGetRequest.new(domain_name, word, options)
        send_request(request)
      end

      # 辞書を登録する 
      #
      # @param [String,File] dictionary_file 辞書ファイル
      # @param [Hash] options リクエストのオプション
      # @example
      #   client.dictionary_put 'custom.csv', :dictionary_name => 'mushikago用語'
      # @return [Mushikago::Http::Response] リクエストの結果
      def dictionary_put dictionary_file, options={}
        request = Hotaru::DictionaryPutRequest.new(dictionary_file, options)
        send_request(request)
      end

      # 辞書の一覧を取得する 
      #
      # @param [Hash] options リクエストのオプション
      # @example
      #   client.dictionary_list
      # @return [Mushikago::Http::Response] リクエストの結果
      def dictionary_list options={}
        request = Hotaru::DictionaryListRequest.new(options)
        send_request(request)
      end

      # 辞書を削除する 
      #
      # @param [String] dictionary_id 辞書ID
      # @param [Hash] options リクエストのオプション
      # @example
      #   client.dictionary_delete('dicid')
      # @return [Mushikago::Http::Response] リクエストの結果
      def dictionary_delete dictionary_id, options={}
        request = Hotaru::DictionaryDeleteRequest.new(dictionary_id, options)
        send_request(request)
      end
    end
  end
end