# LockableValue.kt

    /*
     * The MIT License
     *
     * Original work sponsored and donated by The Danish Health Data Authority (http://www.sundhedsdatastyrelsen.dk)
     *
     * Copyright (C) 2021 The Danish Health Data Authority (http://www.sundhedsdatastyrelsen.dk)
     *
     *
     * Permission is hereby granted, free of charge, to any person obtaining a copy of
     * this software and associated documentation files (the "Software"), to deal in
     * the Software without restriction, including without limitation the rights to
     * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
     * of the Software, and to permit persons to whom the Software is furnished to do
     * so, subject to the following conditions:
     *
     *
     * The above copyright notice and this permission notice shall be included in all
     * copies or substantial portions of the Software.
     *
     *
     * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
     * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
     * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
     * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
     * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
     * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
     * SOFTWARE.
     */

    package dk.nsp.mingraviditet.util.commonsense_helpers

    import kotlin.reflect.KProperty

    /**
     * A mutable container that locks the amount of updates that are allowed
     * @param initialValue [T] the type of value we are to contain
     * @param maxUpdateCount [Int] the amount of updates that are allowed
     * @property value T the starting value that "may" be updated up to the provided update count
     */
    public open class LockableValue<T>(
        @IntLimit(from = 1) maxUpdateCount: Int,
        initialValue: T,
        private val onUpdateRejected: (() -> Unit)? = null
    ) {
        @IntLimit(from = 0)
        private var remainingUpdateCount = maxUpdateCount

        /**
         * The current value (getter)
         * setting the value might not update it if the maxUpdateCount reaches zero or negative
         */
        public var value: T = initialValue
            set(newValue) {
                if (remainingUpdateCount < 0 || remainingUpdateCount == 0) {
                    onUpdateRejected?.invoke()
                    return
                }
                remainingUpdateCount -= 1
                field = newValue
            }
    }

    /**
     *
     * @receiver LockableValue<T>
     * @param any Any?
     * @param property KProperty<*>
     * @return T
     */
    public operator fun <T> LockableValue<T>.getValue(any: Any?, property: KProperty<*>): T {
        return value
    }

    /**
     *
     * @receiver LockableValue<T>
     * @param item Any?
     * @param property KProperty<*>
     * @param newValue T
     */
    public operator fun <T> LockableValue<T>.setValue(item: Any?, property: KProperty<*>, newValue: T) {
        value = newValue
    }