/*
 * Copyright 2023 the original author or authors.
 *
 * 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.
 */

package org.gradle.kotlin.dsl

import org.gradle.api.Incubating
import org.gradle.api.file.FileSystemLocation
import org.gradle.api.file.FileSystemLocationProperty
import org.gradle.api.provider.HasMultipleValues
import org.gradle.api.provider.MapProperty
import org.gradle.api.provider.Property
import org.gradle.api.provider.Provider
import java.io.File


/**
 * Assign value: T to a property with assign operator
 *
 * @since 8.2
 */
fun <T : Any> Property<T>.assign(value: T?) {
    this.set(value)
}


/**
 * Assign value: Provider<T> to a property with assign operator
 *
 * @since 8.2
 */
fun <T : Any> Property<T>.assign(value: Provider<out T>) {
    this.set(value)
}


/**
 * Assign file to a FileSystemLocationProperty with assign operator
 *
 * @since 8.2
 */
fun <T : FileSystemLocation> FileSystemLocationProperty<T>.assign(file: File?) {
    this.set(file)
}


/**
 * Assign file provided by a Provider to a FileSystemLocationProperty with assign operator
 *
 * @since 8.2
 */
fun <T : FileSystemLocation> FileSystemLocationProperty<T>.assign(provider: Provider<File>) {
    this.fileProvider(provider)
}


/**
 * Sets the value of the property to the elements of the given iterable, and replaces any existing value
 *
 * @since 8.2
 */
fun <T : Any> HasMultipleValues<T>.assign(elements: Iterable<T>?) {
    this.set(elements)
}


/**
 * Sets the property to have the same value of the given provider, and replaces any existing value
 *
 * @since 8.2
 */
fun <T : Any> HasMultipleValues<T>.assign(provider: Provider<out Iterable<T>>) {
    this.set(provider)
}


/**
 * Sets the value of this property to the entries of the given Map, and replaces any existing value
 *
 * @since 8.2
 */
fun <K : Any, V : Any> MapProperty<K, V>.assign(entries: Map<out K, V>?) {
    this.set(entries)
}


/**
 * Sets the property to have the same value of the given provider, and replaces any existing value
 *
 * @since 8.2
 */
fun <K : Any, V : Any> MapProperty<K, V>.assign(provider: Provider<out Map<out K, V>>) {
    this.set(provider)
}


/**
 * Adds an element to the property value.
 *
 * @see HasMultipleValues.add
 * @since 9.6.0
 */
@Incubating
operator fun <T : Any> HasMultipleValues<T>.plusAssign(element: T) {
    // TODO(mlopatkin): consider changing this to a function with better incremental update semantics
    this.add(element)
}


/**
 * Adds an element to the property value.
 *
 * The given provider will be queried when the value of this property is queried.
 * Adding a provider with no value discards the value of the whole property.
 *
 * @see HasMultipleValues.add
 * @since 9.6.0
 */
@Incubating
@JvmName("plusAssignElementProvider")
operator fun <T : Any> HasMultipleValues<T>.plusAssign(provider: Provider<out T>) {
    // TODO(mlopatkin): consider changing this to a function with better incremental update semantics
    this.add(provider)
}


/**
 * Adds zero or more elements to the property value.
 *
 * The given iterable will be queried when the value of this property is queried.
 *
 * @see HasMultipleValues.addAll
 * @since 9.6.0
 */
@Incubating
operator fun <T : Any> HasMultipleValues<T>.plusAssign(elements: Iterable<T>) {
    // TODO(mlopatkin): consider changing this to a function with better incremental update semantics
    this.addAll(elements)
}


/**
 * Adds zero or more elements to the property value.
 *
 * @see HasMultipleValues.addAll
 * @since 9.6.0
 */
@Incubating
operator fun <T : Any> HasMultipleValues<T>.plusAssign(elements: Array<T>) {
    // TODO(mlopatkin): consider changing this to a function with better incremental update semantics
    this.addAll(elements.asList())
}


/**
 * Adds zero or more elements to the property value.
 *
 * The given provider will be queried when the value of this property is queried.
 *
 * Adding a provider with no value discards the value of the whole property.
 *
 * @see HasMultipleValues.addAll
 * @since 9.6.0
 */
@Incubating
@JvmName("plusAssignElementsProvider")
operator fun <T : Any> HasMultipleValues<T>.plusAssign(provider: Provider<out Iterable<T>>) {
    // TODO(mlopatkin): consider changing this to a function with better incremental update semantics
    this.addAll(provider)
}


/**
 * Adds a map entry to the property value.
 *
 * @see MapProperty.put
 * @since 9.6.0
 */
@Incubating
operator fun <K : Any, V : Any> MapProperty<K, V>.plusAssign(value: Pair<K, V>) {
    // TODO(mlopatkin): consider changing this to a function with better incremental update semantics
    this.put(value.first, value.second)
}

/**
 * Returns a provider that resolves to the value of the mapping of the given key. It will have no value
 * if the property has no value, or if it does not contain a mapping for the key.
 *
 * @see MapProperty.getting
 * @since 9.6.0
 */
@Incubating
operator fun <K : Any, V : Any> MapProperty<K, V>.get(key: K): Provider<V> {
    return this.getting(key)
}

/**
 * Adds a map entry to the property value.
 *
 * @param key the key
 * @param value the value
 *
 * @see MapProperty.put
 * @since 9.6.0
 */
@Incubating
operator fun <K : Any, V : Any> MapProperty<K, V>.set(key: K, value: V) {
    this.put(key, value)
}

/**
 * Adds a map entry to the property value.
 *
 * @param key the key
 * @param providerOfValue the provider of the value
 *
 * @see MapProperty.put
 * @since 9.6.0
 */
@Incubating
operator fun <K : Any, V : Any> MapProperty<K, V>.set(key: K, providerOfValue: Provider<out V>) {
    this.put(key, providerOfValue)
}

/**
 * Adds a map entry to the property value.
 *
 * The given provider will be queried when the value of this property is queried.
 * Adding a provider with no value discards the value of the whole property.
 *
 * @see MapProperty.put
 * @since 9.6.0
 */
@Incubating
@JvmName("plusAssignElementProvider")
operator fun <K : Any, V : Any> MapProperty<K, V>.plusAssign(value: Provider<out Pair<K, V>>) {
    // TODO(mlopatkin): consider changing this to a function with better incremental update semantics
    this.putAll(value.map { pair -> mapOf(pair) })
}


/**
 * Adds all entries from another [Map] to the property value.
 *
 * @see MapProperty.putAll
 * @since 9.6.0
 */
@Incubating
operator fun <K : Any, V : Any> MapProperty<K, V>.plusAssign(value: Map<out K, V>) {
    // TODO(mlopatkin): consider changing this to a function with better incremental update semantics
    this.putAll(value)
}


/**
 * Adds all entries from another [Map] to the property value.
 *
 * The given provider will be queried when the value of this property is queried.
 * Adding a provider with no value discards the value of the whole property.
 * @see MapProperty.putAll
 * @since 9.6.0
 */
@Incubating
@JvmName("plusAssignElementsProvider")
operator fun <K : Any, V : Any> MapProperty<K, V>.plusAssign(value: Provider<out Map<out K, V>>) {
    // TODO(mlopatkin): consider changing this to a function with better incremental update semantics
    this.putAll(value)
}
