





'''simple docstring'''







_lowercase       						=			[
    999,
    800,
    799,
    600,
    599,
    500,
    400,
    399,
    377,
    355,
    333,
    311,
    288,
    266,
    244,
    222,
    200,
    199,
    177,
    155,
    133,
    111,
    88,
    66,
    44,
    22,
    0,
]

_lowercase       						=			[
    999,
    976,
    952,
    928,
    905,
    882,
    858,
    857,
    810,
    762,
    715,
    714,
    572,
    429,
    428,
    286,
    285,
    238,
    190,
    143,
    142,
    118,
    95,
    71,
    47,
    24,
    0,
]

_lowercase       						=			[
    999,
    988,
    977,
    966,
    955,
    944,
    933,
    922,
    911,
    900,
    899,
    879,
    859,
    840,
    820,
    800,
    799,
    766,
    733,
    700,
    699,
    650,
    600,
    599,
    500,
    499,
    400,
    399,
    350,
    300,
    299,
    266,
    233,
    200,
    199,
    179,
    159,
    140,
    120,
    100,
    99,
    88,
    77,
    66,
    55,
    44,
    33,
    22,
    11,
    0,
]

_lowercase       						=			[
    999,
    995,
    992,
    989,
    985,
    981,
    978,
    975,
    971,
    967,
    964,
    961,
    957,
    956,
    951,
    947,
    942,
    937,
    933,
    928,
    923,
    919,
    914,
    913,
    908,
    903,
    897,
    892,
    887,
    881,
    876,
    871,
    870,
    864,
    858,
    852,
    846,
    840,
    834,
    828,
    827,
    820,
    813,
    806,
    799,
    792,
    785,
    784,
    777,
    770,
    763,
    756,
    749,
    742,
    741,
    733,
    724,
    716,
    707,
    699,
    698,
    688,
    677,
    666,
    656,
    655,
    645,
    634,
    623,
    613,
    612,
    598,
    584,
    570,
    569,
    555,
    541,
    527,
    526,
    505,
    484,
    483,
    462,
    440,
    439,
    396,
    395,
    352,
    351,
    308,
    307,
    264,
    263,
    220,
    219,
    176,
    132,
    88,
    44,
    0,
]

_lowercase       						=			[
    999,
    997,
    995,
    992,
    990,
    988,
    986,
    984,
    981,
    979,
    977,
    975,
    972,
    970,
    968,
    966,
    964,
    961,
    959,
    957,
    956,
    954,
    951,
    949,
    946,
    944,
    941,
    939,
    936,
    934,
    931,
    929,
    926,
    924,
    921,
    919,
    916,
    914,
    913,
    910,
    907,
    905,
    902,
    899,
    896,
    893,
    891,
    888,
    885,
    882,
    879,
    877,
    874,
    871,
    870,
    867,
    864,
    861,
    858,
    855,
    852,
    849,
    846,
    843,
    840,
    837,
    834,
    831,
    828,
    827,
    824,
    821,
    817,
    814,
    811,
    808,
    804,
    801,
    798,
    795,
    791,
    788,
    785,
    784,
    780,
    777,
    774,
    770,
    766,
    763,
    760,
    756,
    752,
    749,
    746,
    742,
    741,
    737,
    733,
    730,
    726,
    722,
    718,
    714,
    710,
    707,
    703,
    699,
    698,
    694,
    690,
    685,
    681,
    677,
    673,
    669,
    664,
    660,
    656,
    655,
    650,
    646,
    641,
    636,
    632,
    627,
    622,
    618,
    613,
    612,
    607,
    602,
    596,
    591,
    586,
    580,
    575,
    570,
    569,
    563,
    557,
    551,
    545,
    539,
    533,
    527,
    526,
    519,
    512,
    505,
    498,
    491,
    484,
    483,
    474,
    466,
    457,
    449,
    440,
    439,
    428,
    418,
    407,
    396,
    395,
    381,
    366,
    352,
    351,
    330,
    308,
    307,
    286,
    264,
    263,
    242,
    220,
    219,
    176,
    175,
    132,
    131,
    88,
    44,
    0,
]

_lowercase       						=			[
    999,
    991,
    982,
    974,
    966,
    958,
    950,
    941,
    933,
    925,
    916,
    908,
    900,
    899,
    874,
    850,
    825,
    800,
    799,
    700,
    600,
    500,
    400,
    300,
    200,
    100,
    0,
]

_lowercase       						=			[
    999,
    992,
    985,
    978,
    971,
    964,
    957,
    949,
    942,
    935,
    928,
    921,
    914,
    907,
    900,
    899,
    879,
    859,
    840,
    820,
    800,
    799,
    766,
    733,
    700,
    699,
    650,
    600,
    599,
    500,
    499,
    400,
    399,
    300,
    299,
    200,
    199,
    100,
    99,
    0,
]

_lowercase       						=			[
    999,
    996,
    992,
    989,
    985,
    982,
    979,
    975,
    972,
    968,
    965,
    961,
    958,
    955,
    951,
    948,
    944,
    941,
    938,
    934,
    931,
    927,
    924,
    920,
    917,
    914,
    910,
    907,
    903,
    900,
    899,
    891,
    884,
    876,
    869,
    861,
    853,
    846,
    838,
    830,
    823,
    815,
    808,
    800,
    799,
    788,
    777,
    766,
    755,
    744,
    733,
    722,
    711,
    700,
    699,
    688,
    677,
    666,
    655,
    644,
    633,
    622,
    611,
    600,
    599,
    585,
    571,
    557,
    542,
    528,
    514,
    500,
    499,
    485,
    471,
    457,
    442,
    428,
    414,
    400,
    399,
    379,
    359,
    340,
    320,
    300,
    299,
    279,
    259,
    240,
    220,
    200,
    199,
    166,
    133,
    100,
    99,
    66,
    33,
    0,
]








'''simple docstring'''







import os
from dataclasses import dataclass, field
from io import BytesIO
from typing import TYPE_CHECKING, Any, ClassVar, Dict, Optional, Union

import numpy as np
import pyarrow as pa

from .. import config
from ..download.streaming_download_manager import xopen, xsplitext
from ..table import array_cast
from ..utils.py_utils import no_op_if_value_is_null, string_to_dict


if TYPE_CHECKING:
   from .features import FeatureType


_lowercase						,				_lowercase						,				_lowercase       						=			False, False, False
@dataclass
class 			_lowercase						:
     _UpperCAmelCase										=					None
     _UpperCAmelCase										=					True
     _UpperCAmelCase										=					True
     _UpperCAmelCase										=					None
     # Automatically constructed
     _UpperCAmelCase										=					"dict"
     _UpperCAmelCase										=					pa.struct({'''bytes''': pa.binary(), '''path''': pa.string()}					)
     _UpperCAmelCase										=					field(default='''Audio'''				,		init=__a				,		repr=__a					)







     def __call__( self    ) ->	Optional[Any]:
      return self.pa_type







     def     UpperCamelCase			( self    ,   A__    ) ->	dict:
      try:
       import soundfile as sf  # soundfile is a dependency of librosa, needed to decode audio files.
      except ImportError as err:
       raise ImportError('''To support encoding audio data, please install \'soundfile\'.'''    ) from err
      if isinstance(A__    ,   A__    ):
       return {"bytes": None, "path": value}
      elif isinstance(A__    ,   A__    ):
       return {"bytes": value, "path": None}
      elif "array" in value:
       # convert the audio array to wav bytes
       snake_case				=			BytesIO()
       sf.write(A__    ,   value['''array''']    ,   value['''sampling_rate''']    ,   format='''wav'''    )
       return {"bytes": buffer.getvalue(), "path": None}
      elif value.get('''path'''    ) is not None and os.path.isfile(value['''path''']    ):
       # we set "bytes": None to not duplicate the data if they're already available locally
       if value["path"].endswith('''pcm'''    ):
        # "PCM" only has raw audio bytes
        if value.get('''sampling_rate'''    ) is None:
         # At least, If you want to convert "PCM-byte" to "WAV-byte", you have to know sampling rate
         raise KeyError('''To use PCM files, please specify a \'sampling_rate\' in Audio object'''    )
        if value.get('''bytes'''    ):
         # If we already had PCM-byte, we don`t have to make "read file, make bytes" (just use it!)
         snake_case				=			np.frombuffer(value['''bytes''']    ,   dtype=np.intaa    ).astype(np.floataa    ) / 3_27_67
        else:
         snake_case				=			np.memmap(value['''path''']    ,   dtype='''h'''    ,   mode='''r'''    ).astype(np.floataa    ) / 3_27_67

        snake_case				=			BytesIO(bytes()    )
        sf.write(A__    ,   A__    ,   value['''sampling_rate''']    ,   format='''wav'''    )
        return {"bytes": buffer.getvalue(), "path": None}
       else:
        return {"bytes": None, "path": value.get('''path'''    )}
      elif value.get('''bytes'''    ) is not None or value.get('''path'''    ) is not None:
       # store the audio bytes, and path is used to infer the audio format using the file extension
       return {"bytes": value.get('''bytes'''    ), "path": value.get('''path'''    )}
      else:
       raise ValueError(
           F"""An audio sample should have one of 'path' or 'bytes' but they are missing or None in {value}."""    )







     def     UpperCamelCase			( self    ,   A__    ,   A__ = None    ) ->	dict:
      if not self.decode:
       raise RuntimeError('''Decoding is disabled for this feature. Please use Audio(decode=True) instead.'''    )

      snake_case				,		snake_case				=			(value['''path'''], BytesIO(value['''bytes''']    )) if value['''bytes'''] is not None else (value['''path'''], None)
      if path is None and file is None:
       raise ValueError(F"""An audio sample should have one of 'path' or 'bytes' but both are None in {value}."""    )

      try:
       import librosa
       import soundfile as sf
      except ImportError as err:
       raise ImportError('''To support decoding audio files, please install \'librosa\' and \'soundfile\'.'''    ) from err

      snake_case				=			xsplitext(A__    )[1][1:].lower() if path is not None else None
      if not config.IS_OPUS_SUPPORTED and audio_format == "opus":
       raise RuntimeError(
           '''Decoding \'opus\' files requires system library \'libsndfile\'>=1.0.31, '''
           '''You can try to update `soundfile` python library: `pip install "soundfile>=0.12.1"`. '''    )
      elif not config.IS_MP3_SUPPORTED and audio_format == "mp3":
       raise RuntimeError(
           '''Decoding \'mp3\' files requires system library \'libsndfile\'>=1.1.0, '''
           '''You can try to update `soundfile` python library: `pip install "soundfile>=0.12.1"`. '''    )

      if file is None:
       snake_case				=			token_per_repo_id or {}
       snake_case				=			path.split('''::'''    )[-1]
       try:
        snake_case				=			string_to_dict(A__    ,   config.HUB_DATASETS_URL    )['''repo_id''']
        snake_case				=			token_per_repo_id[repo_id]
       except (ValueError, KeyError):
        snake_case				=			None

       with xopen(A__    ,   '''rb'''    ,   use_auth_token=A__    ) as f:
        snake_case				,		snake_case				=			sf.read(A__    )

      else:
       snake_case				,		snake_case				=			sf.read(A__    )

      snake_case				=			array.T
      if self.mono:
       snake_case				=			librosa.to_mono(A__    )
      if self.sampling_rate and self.sampling_rate != sampling_rate:
       snake_case				=			librosa.resample(A__    ,   orig_sr=A__    ,   target_sr=self.sampling_rate    )
       snake_case				=			self.sampling_rate

      return {"path": path, "array": array, "sampling_rate": sampling_rate}







     def     UpperCamelCase			( self    ) ->	Union["FeatureType", Dict[str, "FeatureType"]]:
      from .features import Value

      if self.decode:
       raise ValueError('''Cannot flatten a decoded Audio feature.'''    )
      return {
          "bytes": Value('''binary'''    ),
          "path": Value('''string'''    ),
      }







     def     UpperCamelCase			( self    ,   A__    ) ->	pa.StructArray:
      if pa.types.is_string(storage.type    ):
       snake_case				=			pa.array([None] * len(A__    )    ,   type=pa.binary()    )
       snake_case				=			pa.StructArray.from_arrays([bytes_array, storage]    ,   ['''bytes''', '''path''']    ,   mask=storage.is_null()    )
      elif pa.types.is_binary(storage.type    ):
       snake_case				=			pa.array([None] * len(A__    )    ,   type=pa.string()    )
       snake_case				=			pa.StructArray.from_arrays([storage, path_array]    ,   ['''bytes''', '''path''']    ,   mask=storage.is_null()    )
      elif pa.types.is_struct(storage.type    ) and storage.type.get_all_field_indices('''array'''    ):
       snake_case				=			pa.array([Audio().encode_example(A__    ) if x is not None else None for x in storage.to_pylist()]    )
      elif pa.types.is_struct(storage.type    ):
       if storage.type.get_field_index('''bytes'''    ) >= 0:
        snake_case				=			storage.field('''bytes'''    )
       else:
        snake_case				=			pa.array([None] * len(A__    )    ,   type=pa.binary()    )
       if storage.type.get_field_index('''path'''    ) >= 0:
        snake_case				=			storage.field('''path'''    )
       else:
        snake_case				=			pa.array([None] * len(A__    )    ,   type=pa.string()    )
       snake_case				=			pa.StructArray.from_arrays([bytes_array, path_array]    ,   ['''bytes''', '''path''']    ,   mask=storage.is_null()    )
      return array_cast(A__    ,   self.pa_type    )







     def     UpperCamelCase			( self    ,   A__    ) ->	pa.StructArray:

      @no_op_if_value_is_null
      def path_to_bytes(A__    ):
       with xopen(A__    ,   '''rb'''    ) as f:
        snake_case				=			f.read()
       return bytes_

      snake_case				=			pa.array(
          [
              (path_to_bytes(x['''path''']    ) if x['''bytes'''] is None else x['''bytes''']) if x is not None else None
              for x in storage.to_pylist()
          ]    ,   type=pa.binary()    ,   )
      snake_case				=			pa.array(
          [os.path.basename(A__    ) if path is not None else None for path in storage.field('''path'''    ).to_pylist()]    ,   type=pa.string()    ,   )
      snake_case				=			pa.StructArray.from_arrays([bytes_array, path_array]    ,   ['''bytes''', '''path''']    ,   mask=bytes_array.is_null()    )
      return array_cast(A__    ,   self.pa_type    )

