#
# Author:: Adam Jacob (<adam@chef.io>)
# Author:: Tyler Cloke (<tyler@chef.io>)
# Copyright:: Copyright (c) Chef Software Inc.
# License:: Apache License, Version 2.0
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#

require_relative "../resource"
require_relative "../mixin/securable"

class Chef
  class Resource
    class Link < Chef::Resource
      include Chef::Mixin::Securable

      provides :link, target_mode: true
      target_mode support: :full

      description "Use the **link** resource to create symbolic or hard links.\n\n" \
                  "A symbolic link—sometimes referred to as a soft link—is a directory entry" \
                  " that associates a file name with a string that contains an absolute or" \
                  " relative path to a file on any file system. In other words, 'a file that" \
                  " contains a path that points to another file.' A symbolic link creates a new" \
                  " file with a new inode that points to the inode location of the original file.\n\n" \
                  "A hard link is a directory entry that associates a file with another file in the" \
                  " same file system. In other words, 'multiple directory entries to the same file.'" \
                  " A hard link creates a new file that points to the same inode as the original file."

      state_attrs :owner # required since it's not a property below

      default_action :create
      allowed_actions :create, :delete

      property :target_file, String,
        description: "An optional property to set the target file if it differs from the resource block's name.",
        name_property: true

      property :to, [String, nil],
        description: "The actual file to which the link is to be created."

      property :link_type, [String, Symbol],
        description: "The type of link: :symbolic or :hard.",
        coerce: proc { |arg| arg.is_a?(String) ? arg.to_sym : arg },
        equal_to: %i{symbolic hard}, default: :symbolic

      property :group, [String, Integer],
        description: "A group name or ID number that identifies the group associated with a symbolic link.",
        regex: [Chef::Config[:group_valid_regex]]

      property :owner, [String, Integer],
        description: "The owner associated with a symbolic link.",
        regex: [Chef::Config[:user_valid_regex]]

      # make link quack like a file (XXX: not for public consumption)
      def path
        target_file
      end
    end
  end
end
