




def 					__SCREAMING_SNAKE_CASE   (  lowercase_      )       ->	list[int]:

    """simple docstring"""


    if length <= 0 or not isinstance(lowercase_					,     lowercase_      ):
        raise ValueError('''Length must be a positive integer.'''      )
    return [n * (2 * n - 1) for n in range(lowercase_      )]


if __name__ == "__main__":
 print(hexagonal_numbers(length=5))
 print(hexagonal_numbers(length=10))












from pathlib import PurePosixPath
from typing import Optional

import fsspec
from fsspec import AbstractFileSystem
from huggingface_hub.hf_api import DatasetInfo

from ..utils.file_utils import get_authentication_headers_for_url
from ..utils.hub import hf_hub_url

class  _lowerCamelCase						(			_SCREAMING_SNAKE_CASE   ):

      """simple docstring"""

      lowerCAmelCase__			: Any    =					""
      lowerCAmelCase__			: Any    =					"hf-legacy"  # "hf://"" is reserved for hffs







      def __init__(     self					: str ,       snake_case					: Optional[DatasetInfo] = None ,       snake_case					: Optional[str] = None ,       **snake_case					: List[Any] ,       ):
          super().__init__(self ,       **snake_case				)
          __UpperCamelCase  		=						repo_info
          __UpperCamelCase  		=						token
          __UpperCamelCase  		=						None







      def       snake_case	(     self					: List[Any]				):
          if self.dir_cache is None:
              __UpperCamelCase  		=						{}
              for hf_file in self.repo_info.siblings:
                  # TODO(QL): add sizes
                  __UpperCamelCase  		=						{
                      '''name''': hf_file.rfilename,
                      '''size''': None,
                      '''type''': '''file''',
                  }
                  self.dir_cache.update(
                      {
                          str(snake_case				): {'''name''': str(snake_case				), '''size''': None, '''type''': '''directory'''}
                          for d in list(PurePosixPath(hf_file.rfilename				).parents				)[:-1]
                      }				)







      def       snake_case	(     self					: Dict ,       snake_case					: str ,       snake_case					: str = "rb" ,       **snake_case					: Union[str, Any] ,       ):
          if not isinstance(self.repo_info ,       snake_case				):
              raise NotImplementedError(F"Open is only implemented for dataset repositories, but got {self.repo_info}"				)
          __UpperCamelCase  		=						hf_hub_url(self.repo_info.id ,       snake_case ,       revision=self.repo_info.sha				)
          return fsspec.open(
              snake_case ,       mode=snake_case ,       headers=get_authentication_headers_for_url(snake_case ,       use_auth_token=self.token				) ,       client_kwargs={'''trust_env''': True} ,       ).open()







      def       snake_case	(     self					: Optional[Any] ,       snake_case					: Tuple ,       **snake_case					: List[Any]				):
          self._get_dirs()
          __UpperCamelCase  		=						self._strip_protocol(snake_case				)
          if path in self.dir_cache:
              return self.dir_cache[path]
          else:
              raise FileNotFoundError(snake_case				)







      def       snake_case	(     self					: List[str] ,       snake_case					: int ,       snake_case					: Tuple=False ,       **snake_case					: Dict				):
          self._get_dirs()
          __UpperCamelCase  		=						PurePosixPath(path.strip('''/'''				)				)
          __UpperCamelCase  		=						{}
          for p, f in self.dir_cache.items():
              __UpperCamelCase  		=						PurePosixPath(p.strip('''/'''				)				)
              __UpperCamelCase  		=						p.parent
              if root == path:
                  __UpperCamelCase  		=						f
          __UpperCamelCase  		=						list(paths.values()				)
          if detail:
              return out
          else:
              return sorted(f['''name'''] for f in out				)






