# ___________________________________________________________________________
#
# Pyomo: Python Optimization Modeling Objects
# Copyright (c) 2008-2025
# National Technology and Engineering Solutions of Sandia, LLC
# Under the terms of Contract DE-NA0003525 with National Technology and
# Engineering Solutions of Sandia, LLC, the U.S. Government retains certain
# rights in this software.
# This software is distributed under the 3-clause BSD License.
# ___________________________________________________________________________
#
# Utility functions
#
import inspect
from pyomo.common.deprecation import relocated_module_attribute
from pyomo.core.base.indexed_component import normalize_index
relocated_module_attribute(
'disable_methods', 'pyomo.core.base.disable_methods.disable_methods', version='6.1'
)
relocated_module_attribute(
'Initializer', 'pyomo.core.base.initializer.Initializer', version='6.1'
)
relocated_module_attribute(
'IndexedCallInitializer', 'pyomo.core.base.initializer.Initializer', version='6.1'
)
relocated_module_attribute(
'CountedCallInitializer', 'pyomo.core.base.initializer.Initializer', version='6.1'
)
[docs]
def is_functor(obj):
"""
Returns true iff obj.__call__ is defined.
"""
return inspect.isfunction(obj) or hasattr(obj, '__call__')
[docs]
def flatten_tuple(x):
"""
This wraps around normalize_index. It flattens a nested sequence into
a single tuple and always returns a tuple, even for single
element inputs.
Returns
-------
tuple
"""
x = normalize_index(x)
if isinstance(x, tuple):
return x
return (x,)