require "picasa/api/base"

module Picasa
  module API
    class Tag < Base
      # Returns tag list - when album_id is not specified, list of user tags will be returned
      #
      # @param [Hash] options additional options included in request
      # @option options [String] :album_id retrieve tags for given album
      # @option options [String] :photo_id retrieve tags for given photo (album_id must be provided)
      #
      # @return [Presenter::TagList]
      def list(options = {})
        album_id = options.delete(:album_id)
        photo_id = options.delete(:photo_id)
        raise(ArgumentError, "You must specify album_id when providing photo_id") if photo_id && !album_id

        path = "/data/feed/api/user/#{user_id}"
        path << "/albumid/#{album_id}" if album_id
        path << "/photoid/#{photo_id}" if photo_id

        response = Connection.new.get(:path => path, :query => options.merge(:kind => "tag"), :headers => auth_header)

        Presenter::TagList.new(response.parsed_response["feed"])
      end

      # Creates a tag for a photo.
      #
      # @param [Hash]
      # @option options [String] :album_id id of album
      # @option options [String] :photo_id id of photo
      # @option options [String] :title name of tag
      #
      # @return [Presenter::Tag]
      def create(params = {})
        album_id = params.delete(:album_id) || raise(ArgumentError, "You must specify album_id")
        photo_id = params.delete(:photo_id) || raise(ArgumentError, "You must specify photo_id")
        params[:title] || raise(ArgumentError, "You must specify title")

        path = "/data/feed/api/user/#{user_id}/albumid/#{album_id}/photoid/#{photo_id}"

        template = Template.new("new_tag", params)

        response = Connection.new.post(:path => path, :body => template.render, :headers => auth_header)

        Presenter::Tag.new(response.parsed_response["entry"])
      end

      # Removes a tag from given photo.
      #
      # @param [String] tag_id tag name (title)
      # @param [Hash]
      # @option options [String] :album_id id pof album
      # @option options [String] :photo_id id of photo
      #
      # @return [true]
      def destroy(tag_id, params = {})
        album_id = params.delete(:album_id) || raise(ArgumentError, "You must specify album_id")
        photo_id = params.delete(:photo_id) || raise(ArgumentError, "You must specify photo_id")

        path = "/data/entry/api/user/#{user_id}/albumid/#{album_id}/photoid/#{photo_id}/tag/#{tag_id}"
        Connection.new.delete(:path => path, :headers => auth_header)
        true
      end
      alias :delete :destroy
    end
  end
end