nwjsmith/thumbtack

# frozen_string_literal: true

module Thumbtack
  # Wraps API calls related to tags
  class Tags
    attr_reader :client

    # Initialize a Tags
    #
    # @param [Client] client
    #   client to communicate with the Pinboard API
    #
    # @api private
    def initialize(client)
      @client = client
    end

    # List tags with their counts
    #
    # @example
    #   tag_counts = tags.get
    #
    # @return [Hash{String => Integer}]
    #   tags associated with the number of times they have been used
    #
    # @api public
    #
    # @see https://pinboard.in/api/#tags_get
    def get
      response = client.get("/tags/get")
      Hash[response.map { |tag, count| [tag, count.to_i] }]
    end

    # Delete a tag
    #
    # @example
    #   tags.delete(tag)
    #
    # @param [String] tag
    #   the tag to delete
    #
    # @return [self]
    #
    # @api public
    #
    # @see https://pinboard.in/api/#tags_delete
    def delete(tag)
      parameters = Specification.new(tag: Types::Tags).parameters(tag: tag)
      client.action("/tags/delete", parameters)
      self
    end

    # Rename a tag
    #
    # @example
    #   tags.rename(old, new)
    #
    # @param [String] old
    #   the tag to be renamed
    # @param [String] new
    #   the new name for the tag
    #
    # @return [self]
    #
    # @api public
    #
    # @see https://pinboard.in/api/#tags_rename
    def rename(old, new)
      parameters = Specification.new(
        old: Types::Tags,
        new: Types::Tags
      ).parameters(old: old, new: new)
      client.action("/tags/rename", parameters)
      self
    end
  end
end