code: 
  
  
  
  import logging
  from pathlib import Path
  from typing import Any, List, Tuple
  
  import yaml
  
  
  # loading package files: https://stackoverflow.com/a/20885799
  try:
  			import importlib.resources as pkg_resources
  except ImportError:
  			# Try backported to PY<37 `importlib_resources`.
  			import importlib_resources as pkg_resources
  
  from . import resources
  
  
  lowerCAmelCase__	:  Tuple 		='''https://github.com/huggingface/datasets/tree/main/src/datasets/utils'''
  lowerCAmelCase__	:  Union[str, Any] 		=F'''{BASE_REF_URL}/{__file__}'''
  lowerCAmelCase__	:  Tuple 		=logging.getLogger(__name__)
  
  
  
  
  
  
  def 			__lowercase     (				a__     )       ->				Tuple[Any, str]:
  							__SCREAMING_SNAKE_CASE								=      pkg_resources.read_text(a__							,     a__     )
  							return yaml.safe_load(a__     ), f"""{BASE_REF_URL}/resources/{resource}"""
  
  
  lowerCAmelCase__		,  lowerCAmelCase__	:  Optional[Any] 		=load_yaml_resource('''readme_structure.yaml''')
  
  lowerCAmelCase__	:  Dict 		=[
      '''[Needs More Information]''',
      '''[More Information Needed]''',
      '''(https://github.com/huggingface/datasets/blob/main/CONTRIBUTING.md#how-to-contribute-to-the-dataset-cards)''',
  ]
  
  # Dictionary representation of section/readme, error_list, warning_list
  lowerCAmelCase__	:  Union[str, Any] 		=Tuple[dict, List[str], List[str]]
  
  class      UpperCAmelCase_						:
  
  						'''simple docstring'''
  
  
  
  
  						def __init__(					self   ,							_A   ,							_A   ,							_A = None   ,							_A = False	):
  
  
  
  
  
  
  
  													'''simple docstring'''
  
  													__SCREAMING_SNAKE_CASE								=      name
  													__SCREAMING_SNAKE_CASE								=      level
  													__SCREAMING_SNAKE_CASE								=      lines
  													__SCREAMING_SNAKE_CASE								=      ''
  													__SCREAMING_SNAKE_CASE								=      True
  													__SCREAMING_SNAKE_CASE								=      {}
  													__SCREAMING_SNAKE_CASE								=      []
  													__SCREAMING_SNAKE_CASE								=      []
  													if self.lines is not None:
  																				self.parse(suppress_parsing_errors=_A	)
  
  
  
  
  
  
  						def  _A			(					self   ,							_A = False	):
  
  
  
  
  
  
  
  													'''simple docstring'''
  
  													__SCREAMING_SNAKE_CASE								=      ''
  													__SCREAMING_SNAKE_CASE								=      []
  													__SCREAMING_SNAKE_CASE								=      False
  													for line in self.lines:
  																				if line.strip(' \n'	) == "":
  																											continue
  																				elif line.strip(' \n'	)[:3] == "```":
  																											__SCREAMING_SNAKE_CASE								=      not code_start
  																				elif line.split()[0] == self.level + "#" and not code_start:
  																											if current_sub_level != "":
  																																		__SCREAMING_SNAKE_CASE								=      Section(_A   ,							self.level + '#'   ,							_A	)
  																																		__SCREAMING_SNAKE_CASE								=      []
  																											else:
  																																		if current_lines != []:
  																																									self.text += "".join(_A	).strip()
  																																									if self.text != "" and self.text not in FILLER_TEXT:
  																																																__SCREAMING_SNAKE_CASE								=      False
  																																									__SCREAMING_SNAKE_CASE								=      []
  
  																											__SCREAMING_SNAKE_CASE								=      ' '.join(line.split()[1:]	).strip(' \n'	)
  																				else:
  																											current_lines.append(_A	)
  													else:
  																				if current_sub_level != "":
  																											if current_sub_level in self.content:
  																																		self.parsing_error_list.append(
  																																		    f"""Multiple sections with the same heading `{current_sub_level}` have been found. Please keep only one of these sections."""	)
  																											__SCREAMING_SNAKE_CASE								=      Section(_A   ,							self.level + '#'   ,							_A	)
  																				else:
  																											if current_lines != []:
  																																		self.text += "".join(_A	).strip()
  																																		if self.text != "" and self.text not in FILLER_TEXT:
  																																									__SCREAMING_SNAKE_CASE								=      False
  
  													if self.level == "" and not suppress_parsing_errors:
  																				if self.parsing_error_list != [] or self.parsing_warning_list != []:
  																											__SCREAMING_SNAKE_CASE								=      __SCREAMING_SNAKE_CASE								=      '\n'.join('-\t' + x for x in self.parsing_error_list + self.parsing_warning_list	)
  																											__SCREAMING_SNAKE_CASE								=      f"""The following issues were found while parsing the README at `{self.name}`:\n""" + errors
  																											raise ValueError(_A	)
  
  
  
  
  
  
  						def  _A			(					self   ,							_A	):
  
  
  
  
  
  
  
  													'''simple docstring'''
  
  													__SCREAMING_SNAKE_CASE								=      []
  													__SCREAMING_SNAKE_CASE								=      []
  													if structure["allow_empty"] is False:
  																				# If content is expected
  																				if self.is_empty_text and self.content == {}:
  																											# If no content is found, mention it in the error_list
  																											error_list.append(f"""Expected some content in section `{self.name}` but it is empty."""	)
  
  													if structure["allow_empty_text"] is False:
  																				# If some text is expected
  																				if self.is_empty_text:
  																											# If no text is found, mention it in the error_list
  																											error_list.append(
  																											    f"""Expected some text in section `{self.name}` but it is empty (text in subsections are ignored)."""	)
          # Subsections Validation
  													if structure["subsections"] is not None:
  																				# If subsections are expected
  																				if self.content == {}:
  																											# If no subsections are present
  																											__SCREAMING_SNAKE_CASE								=      [subsection['name'] for subsection in structure['subsections']]
  																											# Mention the expected values in the error_list
  																											error_list.append(
  																											    f"""Section `{self.name}` expected the following subsections: {", ".join(["`"+x+"`" for x in values]	)}. Found 'None'."""	)
  																				else:
  																											# If some subsections are present
  																											__SCREAMING_SNAKE_CASE								=      [subsection['name'] for subsection in structure['subsections']]
  																											__SCREAMING_SNAKE_CASE								=      False
  																											for idx, name in enumerate(_A	):
  																																		if name not in self.content:
  																																									# If the expected subsection is not present
  																																									error_list.append(f"""Section `{self.name}` is missing subsection: `{name}`."""	)
  																																									__SCREAMING_SNAKE_CASE								=      True
  																																		else:
  																																									# If the subsection is present, validate subsection, return the result
  																																									# and concat the errors from subsection to section error_list
  
  																																									# Skip sublevel validation if current level is `###`
  																																									if self.level == "###":
  																																																continue
  																																									else:
  																																																__SCREAMING_SNAKE_CASE							, __SCREAMING_SNAKE_CASE							, __SCREAMING_SNAKE_CASE								=      self.content[name].validate(
  																																																    structure['subsections'][idx]	)
  																																									error_list += subsec_error_list
  																																									warning_list += subsec_warning_list
  
  																											if has_missing_subsections:  # we only allow to have extra subsections if all the other ones are here
  																																		for name in self.content:
  																																									if name not in structure_names:
  																																																# If an extra subsection is present
  																																																warning_list.append(
  																																																    f"""`{self.name}` has an extra subsection: `{name}`. Skipping further validation checks for this subsection as expected structure is unknown."""	)
  													if error_list:
  																				# If there are errors, do not return the dictionary as it is invalid
  																				return {}, error_list, warning_list
  													else:
  																				return self.to_dict(), error_list, warning_list
  
  
  
  
  
  
  						def  _A			(					self	):
  
  
  
  
  
  
  
  													'''simple docstring'''
  
  													return {
  													    "name": self.name,
  													    "text": self.text,
  													    "is_empty_text": self.is_empty_text,
  													    "subsections": [value.to_dict() for value in self.content.values()],
  													}
  
  
  
  
  
  
  
  class      UpperCAmelCase_						(     UpperCamelCase_ ):  # Level 0
  
  						'''simple docstring'''
  
  
  
  
  						def __init__(					self   ,							_A   ,							_A   ,							_A = None   ,							_A = False	):
  
  
  
  
  
  
  
  													'''simple docstring'''
  
  													super().__init__(name=_A   ,							level=''	)  # Not using lines here as we need to use a child class parse
  													__SCREAMING_SNAKE_CASE								=      structure
  													__SCREAMING_SNAKE_CASE								=      -2
  													__SCREAMING_SNAKE_CASE								=      0
  													__SCREAMING_SNAKE_CASE								=      lines
  													if self.lines is not None:
  																				self.parse(suppress_parsing_errors=_A	)
  
  
  
  
  
  
  						def  _A			(					self	):
  
  
  
  
  
  
  
  													'''simple docstring'''
  
  													if self.structure is None:
  																				__SCREAMING_SNAKE_CASE							, __SCREAMING_SNAKE_CASE							, __SCREAMING_SNAKE_CASE								=      self._validate(_A	)
  													else:
  																				__SCREAMING_SNAKE_CASE							, __SCREAMING_SNAKE_CASE							, __SCREAMING_SNAKE_CASE								=      self._validate(self.structure	)
  													if error_list != [] or warning_list != []:
  																				__SCREAMING_SNAKE_CASE								=      '\n'.join(['-\t' + x for x in error_list + warning_list]	)
  																				__SCREAMING_SNAKE_CASE								=      f"""The following issues were found for the README at `{self.name}`:\n""" + errors
  																				raise ValueError(_A	)
  
  
  
  
  
  
  						@classmethod
  						def  _A			(					cls   ,							_A   ,							_A = None   ,							_A = False	):
  
  
  
  
  
  
  
  													'''simple docstring'''
  
  													with open(_A   ,							encoding='utf-8'	) as f:
  																				__SCREAMING_SNAKE_CASE								=      f.readlines()
  													return cls(_A   ,							_A   ,							_A   ,							suppress_parsing_errors=_A	)
  
  
  
  
  
  
  						@classmethod
  						def  _A			(					cls   ,							_A   ,							_A = None   ,							_A = "root"   ,							_A = False	):
  
  
  
  
  
  
  
  													'''simple docstring'''
  
  													__SCREAMING_SNAKE_CASE								=      string.split('\n'	)
  													return cls(_A   ,							_A   ,							_A   ,							suppress_parsing_errors=_A	)
  
  
  
  
  
  
  						def  _A			(					self   ,							_A = False	):
  
  
  
  
  
  
  
  													'''simple docstring'''
  
  													__SCREAMING_SNAKE_CASE								=      0
  
  													for line in self.lines:
  																				self.yaml_tags_line_count += 1
  																				if line.strip(' \n'	) == "---":
  																											self.tag_count += 1
  																											if self.tag_count == 2:
  																																		break
  																				line_count += 1
  													if self.tag_count == 2:
  																				__SCREAMING_SNAKE_CASE								=      self.lines[line_count + 1 :]  # Get the last + 1 th item.
  													else:
  																				__SCREAMING_SNAKE_CASE								=      self.lines[self.tag_count :]
  													super().parse(suppress_parsing_errors=_A	)
  
  
  
  
  
  
  						def __str__(					self	):
  
  
  
  
  
  
  
  													'''simple docstring'''
  
  													return str(self.to_dict()	)
  
  
  
  
  
  
  						def  _A			(					self   ,							_A	):
  
  
  
  
  
  
  
  													'''simple docstring'''
  
  													__SCREAMING_SNAKE_CASE								=      []
  													__SCREAMING_SNAKE_CASE								=      []
  													if self.yaml_tags_line_count == 0:
  																				warning_list.append('Empty YAML markers are present in the README.'	)
  													elif self.tag_count == 0:
  																				warning_list.append('No YAML markers are present in the README.'	)
  													elif self.tag_count == 1:
  																				warning_list.append('Only the start of YAML tags present in the README.'	)
  													# Check how many first level sections are present.
  													__SCREAMING_SNAKE_CASE								=      len(self.content.keys()	)
  													if num_first_level_keys > 1:
  																				# If more than one, add to the error list, continue
  																				error_list.append(
  																				    f"""The README has several first-level headings: {", ".join(["`"+x+"`" for x in list(self.content.keys()	)]	)}. Only one heading is expected. Skipping further validation for this README."""	)
  													elif num_first_level_keys < 1:
  																				# If less than one, append error.
  																				error_list.append(
  																				    'The README has no first-level headings. One heading is expected. Skipping further validation for this README.'	)
  
  													else:
  																				# If one exactly
  																				__SCREAMING_SNAKE_CASE								=      list(self.content.keys()	)[0]  # Get the key
  																				if start_key.startswith('Dataset Card for'	):  # Check correct start
  																											# If the starting is correct, validate all the sections
  																											__SCREAMING_SNAKE_CASE							, __SCREAMING_SNAKE_CASE							, __SCREAMING_SNAKE_CASE								=      self.content[start_key].validate(
  																											    readme_structure['subsections'][0]	)
  																											error_list += sec_error_list
  																											warning_list += sec_warning_list
  																				else:
  																											# If not found, append error
  																											error_list.append(
  																											    'No first-level heading starting with `Dataset Card for` found in README. Skipping further validation for this README.'	)
  													if error_list:
  																				# If there are errors, do not return the dictionary as it is invalid
  																				return {}, error_list, warning_list
  													else:
  																				return self.to_dict(), error_list, warning_list
  
  
  if __name__ == "__main__":
  			from argparse import ArgumentParser
  
  			lowerCAmelCase__	:  List[str] 		=ArgumentParser(usage='''Validate the content (excluding YAML tags) of a README.md file.''')
  			ap.add_argument('''readme_filepath''')
  			lowerCAmelCase__	:  Union[str, Any] 		=ap.parse_args()
  			lowerCAmelCase__	:  Any 		=Path(args.readme_filepath)
  			lowerCAmelCase__	:  Optional[int] 		=ReadMe.from_readme(readme_filepath)
  
  
  
  
  
  
  
style_context: 
  
  
  
  def 			__lowercase     (				a__							,     a__     )       ->				List[str]:
  							if n == 0:
  														return 1
  
  							elif n % 2 == 1:
  														return binary_exponentiation(a__							,     n - 1     ) * a
  
  							else:
  														__SCREAMING_SNAKE_CASE								=      binary_exponentiation(a__							,     n / 2     )
  														return b * b
  
  
  if __name__ == "__main__":
  			try:
  						lowerCAmelCase__	:  str 		=int(input('''Enter Base : ''').strip())
  						lowerCAmelCase__	:  Optional[int] 		=int(input('''Enter Power : ''').strip())
  			except ValueError:
  						print('''Invalid literal for integer''')
  
  			lowerCAmelCase__	:  Any 		=binary_exponentiation(BASE, POWER)
  			print(F'''{BASE}^({POWER}) : {RESULT}''')
  
  
  
  
  
  
  