






"""simple docstring"""
import math






def 			__UpperCamelCase	(		snake_case__   ,   snake_case__					):
	if (
	    not isinstance(snake_case__   ,   (int, float)					)
	    or power_factor < -1
	    or power_factor > 1
	):
		raise ValueError("""power_factor must be a valid float value between -1 and 1."""					)
	return apparent_power * power_factor






def 			__UpperCamelCase	(		snake_case__   ,   snake_case__					):
	if (
	    not isinstance(snake_case__   ,   (int, float)					)
	    or power_factor < -1
	    or power_factor > 1
	):
		raise ValueError("""power_factor must be a valid float value between -1 and 1."""					)
	return apparent_power * math.sqrt(1 - power_factor**2					)


if __name__ == "__main__":
							import doctest

							doctest.testmod()









"""simple docstring"""
import os


# All paths are set with the intent you should run this script from the root of the repo with the command
# python utils/check_doctest_list.py
_lowerCAmelCase         =							"."


if __name__ == "__main__":
							_lowerCAmelCase         =							os.path.join(REPO_PATH, "utils/documentation_tests.txt")
							_lowerCAmelCase         =							[]
							_lowerCAmelCase         =							[]
							with open(doctest_file_path) as fp:
														for line in fp:
																					_lowerCAmelCase         =							line.strip()
																					_lowerCAmelCase         =							os.path.join(REPO_PATH, line)
																					if not (os.path.isfile(path) or os.path.isdir(path)):
																												non_existent_paths.append(line)
																					all_paths.append(path)
							if len(non_existent_paths) > 0:
														_lowerCAmelCase         =							"\n".join(non_existent_paths)
														raise ValueError(F'`utils/documentation_tests.txt` contains non-existent paths:\n{non_existent_paths}')
							if all_paths != sorted(all_paths):
														raise ValueError("Files in `utils/documentation_tests.txt` are not in alphabetical order.")

