/*
---------------------------------------------------------
   Project activething
   Active Thing (activething.com) git.activething.com/go

   File name  option.go
   Created by DEV
   Modified   23/10/2023

   Copyright 2023 activething.com
---------------------------------------------------------
// 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 opts

type (

	// OptionFnc
	// es un tipo de función que se utiliza para configurar objetos en constructores,
	// permitiendo evitar largas listas de parámetros y mantener el código limpio.
	OptionFnc[T any] func(obj *T)

	// OptionErrFnc
	// es un tipo de función de opción que puede devolver un error, lo que lo hace
	// adecuado para manejar configuraciones que pueden generar errores.
	//
	OptionErrFnc[T any] func(obj *T) error
)



// Apply
// aplica una serie de funciones OptionFnc a un objeto dado y lo retorna modificado.
func Apply[T any](target *T, options ...OptionFnc[T]) *T {
	if target == nil {
		return nil
	}
	for _, fn := range options {
		fn(target)
	}
	return target
}

// ApplyAndCheck
// aplica una serie de funciones OptionErrFnc a un objeto y retorna el objeto modificado,
// junto con un posible error en caso de configuración incorrecta.
func ApplyAndCheck[T any](target *T, options ...OptionErrFnc[T]) (*T, error) {
	for _, fn := range options {
		if err := fn(target); err != nil {
			return nil, err
		}
	}
	return target, nil
}

// ApplyAndCheckAll
// aplica una serie de funciones OptionErrFnc a un objeto y retorna el objeto modificado,
// junto con una lista de errores que se han producido durante la configuración.
func ApplyAndCheckAll[T any](target T, options ...OptionErrFnc[T]) (T, []error) {
	var lst []error
	for _, fn := range options {
		if err := fn(&target); err != nil {
			lst = append(lst, err)
		}
	}
	return target, lst
}