# encoding: utf-8

module Github
  # The Repository Hooks API manages the post-receive web and
  # service hooks for a repository.
  class Repos::Hooks < API

    VALID_HOOK_PARAM_NAMES = %w[
      name
      config
      active
      events
      add_events
      remove_events
    ].freeze # :nodoc:

    # Active hooks can be configured to trigger for one or more events.
    # The default event is push. The available events are:
    VALID_HOOK_PARAM_VALUES = {
      'events' => %w[
        push
        issues
        issue_comment
        commit_comment
        pull_request
        gollum
        watch
        download
        fork
        fork_apply
        member
        public
      ]
    }.freeze # :nodoc:

    REQUIRED_PARAMS = %w[ name config ].freeze # :nodoc:

    # List repository hooks
    #
    # = Examples
    #  github = Github.new
    #  github.repos.hooks.list 'user-name', 'repo-name'
    #  github.repos.hooks.list 'user-name', 'repo-name' { |hook| ... }
    #
    def list(user_name, repo_name, params={})
      set :user => user_name, :repo => repo_name
      assert_presence_of user, repo
      normalize! params

      response = get_request("/repos/#{user}/#{repo}/hooks", params)
      return response unless block_given?
      response.each { |el| yield el }
    end
    alias :all :list

    # Get a single hook
    #
    # = Examples
    #  github = Github.new
    #  github.repos.hooks.get 'user-name', 'repo-name'
    #
    def get(user_name, repo_name, hook_id, params={})
      set :user => user_name, :repo => repo_name
      assert_presence_of user, repo, hook_id
      normalize! params

      get_request("/repos/#{user}/#{repo}/hooks/#{hook_id}", params)
    end
    alias :find :get

    # Create a hook
    #
    # = Inputs
    # * <tt>:name</tt> - Required string - the name of the service that is being called.
    # * <tt>:config</tt> - Required hash - A Hash containing key/value pairs to provide settings for this hook.
    # * <tt>:events</tt> - Optional array - Determines what events the hook is triggered for. Default: ["push"]
    # * <tt>:active</tt> - Optional boolean - Determines whether the hook is actually triggered on pushes.
    #
    # = Examples
    #  github = Github.new
    #  github.repos.hooks.create 'user-name', 'repo-name',
    #    "name" =>  "web",
    #    "active" => true,
    #    "config" => {
    #      "url" => "http://something.com/webhook"
    #      }
    #    }
    #
    def create(user_name, repo_name, params={})
      set :user => user_name, :repo => repo_name
      assert_presence_of user, repo

      normalize! params
      filter! VALID_HOOK_PARAM_NAMES, params, :recursive => false
      assert_required_keys(REQUIRED_PARAMS, params)

      post_request("/repos/#{user}/#{repo}/hooks", params)
    end

    # Edit a hook
    #
    # = Inputs
    # * <tt>:name</tt> - Required string - the name of the service that is being called.
    # * <tt>:config</tt> - Required hash - A Hash containing key/value pairs to provide settings for this hook.
    # * <tt>:events</tt> - Optional array - Determines what events the hook is triggered for. This replaces the entire array of events. Default: ["push"].
    # * <tt>:add_events</tt> - Optional array - Determines a list of events to be added to the list of events that the Hook triggers for.
    # * <tt>:remove_events</tt> - Optional array - Determines a list of events to be removed from the list of events that the Hook triggers for.
    # * <tt>:active</tt> - Optional boolean - Determines whether the hook is actually triggered on pushes.
    #
    # = Examples
    #  github = Github.new
    #  github.repos.hooks.edit 'user-name', 'repo-name',
    #    "name" => "campfire",
    #    "active" =>  true,
    #    "config" =>  {
    #      "subdomain" => "github",
    #      "room" =>  "Commits",
    #      "token" => "abc123"
    #    }
    #
    def edit(user_name, repo_name, hook_id, params={})
      set :user => user_name, :repo => repo_name
      assert_presence_of user, repo, hook_id

      normalize! params
      filter! VALID_HOOK_PARAM_NAMES, params, :recursive => false
      assert_required_keys(REQUIRED_PARAMS, params)

      patch_request("/repos/#{user}/#{repo}/hooks/#{hook_id}", params)
    end

    # Test a hook
    #
    # This will trigger the hook with the latest push to the current repository.
    #
    # = Examples
    #  github = Github.new
    #  github.repos.hooks.test 'user-name', 'repo-name', 'hook-id'
    #
    def test(user_name, repo_name, hook_id, params={})
      set :user => user_name, :repo => repo_name
      assert_presence_of user, repo, hook_id
      normalize! params

      post_request("/repos/#{user}/#{repo}/hooks/#{hook_id}/test", params)
    end

    # Delete a hook
    #
    # = Examples
    #  github = Github.new
    #  github.repos.hooks.delete 'user-name', 'repo-name', 'hook-id'
    #
    def delete(user_name, repo_name, hook_id, params={})
      set :user => user_name, :repo => repo_name
      assert_presence_of user, repo, hook_id
      normalize! params

      delete_request("/repos/#{user}/#{repo}/hooks/#{hook_id}", params)
    end

  end # Repos::Hooks
end # Github