+
    QV-jŠW ã                   óz  € R t ^ RIt^ RIt^ RIt^ RIt^ RIt^ RIt^ RIt^ RIt^ RI	t	^ RI
Ht ^ RIHt ^ RIHt ^ RIHt ^ RIHtHtHtHt ^ RIHt ^ RIt^ RIt^ RIHt ^ R	IHt ^ R
I H!t! ^RI"H#t#H$t$ ^RI%H&t& ^RI'H(t(H)t) ^RI*H+t+H,t,H-t- ^RI.H/t/H0t0H1t1 ^RI2H3t3H4t4 ^RI5H6t6 ^RI7H8t8H9t9 ^RI:H;t;H<t< ^RI=H>t>H?t?H@t@ ^RIAHBtB ^RICHDtDHEtE ^RIFHGtG ^RIHHItI ^RIJHKtKHLtLHMtMHNtN ^RIOHPtPHQtQ ^RIRHStSHTtTHUtUHVtV ^RIWHXtX ^RIYHZtZ ^RI$H[t[ ^RI$H\t] ^R I^H_t_ ^R!I`Hata ^R"IbHctcHdtdHete ^R#IfHgtgHhthHitiHjtjHktkHltlHmtmHntn ^R$IoHptpHqtq ^R%IrHsts ]'       d   ^R&ItHutu ][Pì                  ! ]w4      tx ! R' R(]y4      tz] ! R) R*4      4       t{ ! R+ R,4      t|] ! R- R.4      4       t} ! R/ R0]|4      t~ ! R1 R2]|4      t ! R3 R4]|4      t€R# )5zDatasetBuilder base class.N)ÚIterator)Ú	dataclass)Úpartial)ÚPath)ÚTYPE_CHECKINGÚAnyÚOptionalÚUnion)Úpatch)Ú	url_to_fs)ÚPool)Ú
thread_map)ÚconfigÚutils)ÚDataset)ÚArrowReaderÚReadInstruction)ÚArrowWriterÚParquetWriterÚSchemaInferenceError)ÚDataFilesDictÚDataFilesPatternsDictÚsanitize_patterns)ÚDatasetDictÚIterableDatasetDict)ÚDownloadConfig)ÚDownloadManagerÚDownloadMode)ÚStreamingDownloadManagerÚxjoin)ÚDatasetGenerationCastErrorÚDatasetGenerationErrorÚFileFormatError)ÚFeatures)Úis_remote_filesystemÚrename)ÚHasher©ÚDatasetInfo)ÚArrowExamplesIterableÚExamplesIterableÚIterableDatasetÚ_concatenate_iterable_datasets)Ú"INVALID_WINDOWS_CHARACTERS_IN_PATHÚcamelcase_to_snakecase)ÚSplitÚ	SplitDictÚSplitGeneratorÚ	SplitInfo)Ú$extend_dataset_builder_for_streaming)Ú	CastError)Úlogging)Útqdm)ÚFileLock)Úis_remote_url)ÚVerificationModeÚverify_checksumsÚverify_splits)ÚclasspropertyÚconvert_file_size_to_intÚhas_sufficient_disk_spaceÚiflatmap_unorderedÚ
map_nestedÚmemoizeÚsize_strÚtemporary_assignment)Ú_number_of_shards_in_gen_kwargsÚ_split_gen_kwargs)Útracked_list)ÚDatasetModulec                   ó   € ] tR t^`tRtR# )ÚInvalidConfigName© N)Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__Ú__static_attributes__rJ   ó    Úa/Volumes/fast/ai/experiments/ui-tars-smoke/.venv/lib/python3.14/site-packages/datasets/builder.pyrI   rI   `   s   † ÛrP   rI   c                   ó˜   a € ] tR t^dt o RtRt]P                  ! R4      tRt	Rt
RtR tR tRV 3R lR lltV 3R	 lR
 ltV 3R ltRtV tR# )ÚBuilderConfiga‡  Base class for `DatasetBuilder` data configuration.

`DatasetBuilder` subclasses with data configuration options should subclass
`BuilderConfig` and add their own properties.

Attributes:
    name (`str`, defaults to `default`):
        The name of the configuration.
    version (`Version` or `str`, defaults to `0.0.0`):
        The version of the configuration.
    data_dir (`str`, *optional*):
        Path to the directory containing the source data.
    data_files (`str` or `Sequence` or `Mapping`, *optional*):
        Path(s) to source data file(s).
    description (`str`, *optional*):
        A human description of the configuration.
Údefaultú0.0.0Nc                ó  € \          F3  pWP                  9   g   K  \        R \          RV P                   R24      h	  V P                  eA   \	        V P                  \
        \        34      '       g   \        RV P                   24      hR# R# )z Bad characters from black list 'z' found in 'z\'. They could create issues when creating a directory for this config on Windows filesystem.Nz/Expected a DataFilesDict in data_files but got )r-   ÚnamerI   Ú
data_filesÚ
isinstancer   r   Ú
ValueError)ÚselfÚinvalid_chars   & rQ   Ú__post_init__ÚBuilderConfig.__post_init__~   s‹   € ç>ˆLØŸy™yÖ(Ü'Ø6Ô7YÐ6ZÐZfÐgk×gpÑgpÐfqð rpð qóð ñ ?ð �?‰?Ò&¬z¸$¿/¹/ÌMÔ[pÐKq×/rÒ/rÜÐNÈtÏÉÐN_Ð`ÓaÐañ 0sÑ&rP   c                ót  a a€ \        S P                  P                  4       4      \        SP                  P                  4       4      8w  d   R # \        ;QJ d8    VV 3R lS P                  P                  4        4       F  '       d   K   R # 	  R# ! VV 3R lS P                  P                  4        4       4      # )Fc              3   ó\   <"  € T F!  q\        SV4      3V\        SV4      38H  x € K#  	  R # 5i©N)Úgetattr)Ú.0ÚkÚor[   s   & €€rQ   Ú	<genexpr>Ú'BuilderConfig.__eq__.<locals>.<genexpr>Ž   s-   øé € Ð]ÑH\À1”w˜t QÓ'Ð(¨Q´¸¸1³Ð,>Ö>ÓH\ùs   ƒ),T)ÚsetÚ__dict__ÚkeysÚall)r[   re   s   ffrQ   Ú__eq__ÚBuilderConfig.__eq__‰   su   ù€ ô ˆt�}‰}×!Ñ!Ó#Ó$¬¨A¯J©J¯O©OÓ,=Ó(>Ô>Ùß‹sÕ]ÈÏÉ×HZÑHZÔH\Ó]�sŒsÐ]ŠsÐ]ˆsÕ]ÈÏÉ×HZÑHZÔH\Ó]Ó]Ð]rP   c                ó<   <€ V ^8„  d   QhRS[ RS[S[,          RS[/# )é   Úconfig_kwargsÚcustom_featuresÚreturn)Údictr   r#   Ústr)ÚformatÚ__classdict__s   "€rQ   Ú__annotate__ÚBuilderConfig.__annotate__�   s.   ø€ ÷ >ñ >áð>ñ "¡(Õ+ð>ñ 
ñ	>rP   c                ód  € RpVP                  4       pVP                  RR4       VP                  RR4       RV9   dK   VR,          f   VP                  RR4       M,VR,          p\        P                  P	                  V4      pWTR&   V'       dÚ   \        V4       Uu/ uF  qfWF,          bK  	  pp\        ;QJ d*    R VP                  4        4       F  '       d   K   RM	  RM! R VP                  4        4       4      '       dN   RP                  R	 VP                  4        4       4      p\        V4      ^ 8”  d   \        P                  ! V4      pM\        P                  ! V4      pVeE   \        4       pV'       d   VP                  V4       VP                  V4       VP                  4       pV'       di   V P                  R
,           V,           p\        V4      \         P"                  8”  d/   V P                  R
,           \        P                  ! V4      ,           pV# V P                  # u upi )aè  
The config id is used to build the cache directory.
By default it is equal to the config name.
However the name of a config is not sufficient to have a unique identifier for the dataset being generated
since it doesn't take into account:
- the config kwargs that can be used to overwrite attributes
- the custom features used to write the dataset
- the data_files for json/text/csv/pandas datasets

Therefore the config id is just the config name with an optional suffix based on these.
NrW   ÚversionÚdata_dirc              3   ób   "  € T F%  p\        V\        \        \        \        34      x € K'  	  R # 5ira   )rY   rt   ÚboolÚintÚfloat)rc   Úvs   & rQ   rf   Ú1BuilderConfig.create_config_id.<locals>.<genexpr>¸   s%   é € ÐkÑCj¸a”:˜a¤#¤t¬S´%Ð!8×9Ð9ÓCjùs   ‚-/FTÚ,c              3   ó¤   "  € T FF  w  r\        V4      R ,           \        P                  P                  \        V4      4      ,           x € KH  	  R# 5i)Ú=N)rt   ÚurllibÚparseÚ
quote_plus)rc   rd   r€   s   &  rQ   rf   r�   ¹   s9   é € ð "ÙOuÁtÀq”C˜“F˜S•L¤6§<¡<×#:Ñ#:¼3¸q»6Ó#B×BÒBÓOuùs   ‚AAÚ-)ÚcopyÚpopÚosÚpathÚnormpathÚsortedrk   ÚvaluesÚjoinÚitemsÚlenr&   ÚhashÚupdateÚ	hexdigestrW   r   Ú%MAX_DATASET_CONFIG_ID_READABLE_LENGTH)	r[   rp   rq   ÚsuffixÚconfig_kwargs_to_add_to_suffixr{   rd   ÚmÚ	config_ids	   &&&      rQ   Úcreate_config_idÚBuilderConfig.create_config_id�   sÈ  € ð" !%ˆØ)6×);Ñ);Ó)=Ð&à&×*Ñ*¨6°4Ô8Ø&×*Ñ*¨9°dÔ;ð
 Ð7Ô7Ø-¨jÕ9ÒAØ.×2Ñ2°:¸tÕDð :¸*ÕE�ÜŸ7™7×+Ñ+¨HÓ5�Ø=E¨zÑ:ß)ô ?EÐEcÔ>dó.Ù>d¸Ð1Õ4Ò4Ñ>dð +ð .÷ ‹sÑkÐCa×ChÑChÔCjÓk�s�sŠsÑkÐCa×ChÑChÔCjÓk×kÒkØŸ™ñ "ØOm×OsÑOsÔOuó"ó �ô �v“; Ô#Ü#Ÿ[š[Ð)GÓH�FøäŸšÐ%CÓD�àÒ&Ü“ˆAßØ—‘˜Ô Ø�H‰H�_Ô%Ø—[‘[“]ˆFçØŸ	™	 C�¨&Õ0ˆIÜ�9‹~¤× LÑ LÔLØ ŸI™I¨�O¬f¯kªk¸&Ó.AÕA�	ØÐà—9‘9Ðùò3.s   ÂH-c                ó*   <€ V ^8„  d   QhRS[ RS[RR/# )ro   Ú	base_pathÚdownload_configrr   N)rt   r   )ru   rv   s   "€rQ   rw   rx   Ð   s(   ø€ ÷ Rñ R©Sð RÁ>ð RÐVZñ RrP   c                óÜ   € \        V P                  \        4      '       dL   V P                  '       d   \	        WP                  4      MTpV P                  P                  W4      V n        R # R # ra   )rY   rX   r   r{   r   Úresolve)r[   rž   rŸ   s   &&&rQ   Ú_resolve_data_filesÚ!BuilderConfig._resolve_data_filesÐ   sG   € Ü�d—o‘oÔ'<×=Ò=Ø;?¿=¿=¸=œ˜i¯©Ô7ÈiˆIØ"Ÿo™o×5Ñ5°iÓQˆDŽOñ >rP   c                óÖ   <€ V ^8„  d   Qh/ S[ ;R&   S[S[S[P                  S[ 3,          ,          ;R&   S[S[ ,          ;R&   S[S[S[S[3,          ,          ;R&   S[S[ ,          ;R&   # )ro   rW   rz   r{   rX   Údescription)rt   r   r	   r   ÚVersionr   r   )ru   rv   s   "€rQ   rw   rx   d   sq   ø‡ ‚ ñ( Ññ) ñ* ‘e™EŸM™M©3Ð.Õ/Õ0ÑIñ+ ñ, ‘s�mÑ"ñ- ñ. ™™}Ñ.CÐCÕDÕEÑLñ/ ñ0 ™#•Ñ%ò1 rP   )rX   ra   )rK   rL   rM   rN   Ú__doc__rW   r   r¦   rz   r{   rX   r¥   r]   rl   r›   r¢   Ú__annotate_func__rO   Ú__classdictcell__©rv   s   @rQ   rS   rS   d   sY   ø‡ € ñð$ €DØ38·=²=ÀÓ3I€GØ"€HØHL€JØ!%€Kò	bò^÷>ò >÷@Rð R÷Y ƒ rP   rS   c                   ó¦  a € ] tR t^Öt o RtRt]t. tRt	Rt
RtR5V 3R lR lltR tR tV 3R lR	 ltV 3R
 lR ltR6V 3R lR llt]]]! 4       V 3R lR l4       4       4       t]R 4       tV 3R lR ltR7V 3R lR lltR t]P8                  V 3R lR l4       t]R 4       tV 3R lR ltR8V 3R lR llt R t!V 3R lR lt"R  t#R! t$R9V 3R" lR# llt%R:V 3R$ lR% llt&]'PP                  R3V 3R& lR' llt)V 3R( lR) lt*R;V 3R* lR+ llt+V 3R, lR- lt,]P8                  V 3R. lR/ l4       t-]P8                  R<V 3R0 lR1 ll4       t.V 3R2 lR3 lt/R4t0V t1R# )=ÚDatasetBuildera+  Abstract base class for all datasets.

`DatasetBuilder` has 3 key methods:

    - [`DatasetBuilder.info`]: Documents the dataset, including feature
      names, types, shapes, version, splits, citation, etc.
    - [`DatasetBuilder.download_and_prepare`]: Downloads the source data
      and writes it to disk.
    - [`DatasetBuilder.as_dataset`]: Generates a [`Dataset`].

Some `DatasetBuilder`s expose multiple variants of the
dataset by defining a [`BuilderConfig`] subclass and accepting a
config object (or name) on construction. Configurable datasets expose a
pre-defined set of configurations in [`DatasetBuilder.builder_configs`].

Args:
    cache_dir (`str`, *optional*):
        Directory to cache data. Defaults to `"~/.cache/huggingface/datasets"`.
    dataset_name (`str`, *optional*):
        Name of the dataset, if different from the builder name. Useful for packaged builders
        like csv, imagefolder, audiofolder, etc. to reflect the difference between datasets
        that use the same packaged builder.
    config_name (`str`, *optional*):
        Name of the dataset configuration.
        It affects the data generated on disk. Different configurations will have their own subdirectories and
        versions.
        If not provided, the default configuration is used (if it exists).

        <Added version="2.3.0">

        Parameter `name` was renamed to `config_name`.

        </Added>
    hash (`str`, *optional*):
        Hash specific to the dataset builder code. Used to update the caching directory when the
        dataset builder code is updated (to avoid reusing old data).
        The typical caching directory (defined in `self._relative_data_dir`) is `name/version/hash/`.
    base_path (`str`, *optional*):
        Base path for relative paths that are used to download files.
        This can be a remote URL.
    features ([`Features`], *optional*):
        Features types to use with this dataset.
        It can be used to change the [`Features`] types of a dataset, for example.
    token (`str` or `bool`, *optional*):
        String or boolean to use as Bearer token for remote files on the
        Datasets Hub. If `True`, will get token from `"~/.huggingface"`.
    repo_id (`str`, *optional*):
        ID of the dataset repository.
        Used to distinguish builders with the same name but not coming from the same namespace, for example "rajpurkar/squad"
        and "lhoestq/squad" repo IDs. In the latter, the builder name would be "lhoestq___squad".
    data_files (`str` or `Sequence` or `Mapping`, *optional*):
        Path(s) to source data file(s).
        For builders like "csv" or "json" that need the user to specify data files. They can be either
        local or remote files. For convenience, you can use a `DataFilesDict`.
    data_dir (`str`, *optional*):
        Path to directory containing source data file(s).
        Use only if `data_files` is not passed, in which case it is equivalent to passing
        `os.path.join(data_dir, "**")` as `data_files`.
        For builders that require manual download, it must be the path to the local directory containing the
        manually downloaded data.
    storage_options (`dict`, *optional*):
        Key/value pairs to be passed on to the dataset file-system backend, if any.
    writer_batch_size (`int`, *optional*):
        Batch size used by the ArrowWriter.
        It defines the number of samples that are kept in memory before writing them
        and also the length of the arrow chunks.
        None means that the ArrowWriter will use its default value.
    **config_kwargs (additional keyword arguments): Keyword arguments to be passed to the corresponding builder
        configuration class, set on the class attribute [`DatasetBuilder.BUILDER_CONFIG_CLASS`]. The builder
        configuration class is [`BuilderConfig`] or a subclass of it.
NFc                ó‚  <€ V ^8„  d   QhRS[ S[,          RS[ S[,          RS[ S[,          RS[ S[,          RS[ S[,          RS[ S[,          RS[ S[,          RS[ S[S[S[3,          ,          R	S[ S[,          R
S[ S[S[S[S[S[3,          ,          RS[ S[,          RS[ S[,          RS[ S[	,          RS[ S[,          /# )ro   Ú	cache_dirÚdataset_nameÚconfig_namer“   rž   ÚinfoÚfeaturesÚtokenÚrepo_idrX   r{   Ústorage_optionsÚwriter_batch_sizerš   )
r   rt   r(   r#   r	   r}   Úlistrs   r   r~   )ru   rv   s   "€rQ   rw   ÚDatasetBuilder.__annotate__4  sú   ø€ ÷ s3ñ s3á™C•=ðs3ñ ™s•mðs3ñ ™c•]ð	s3ñ
 ‘s�mðs3ñ ™C•=ðs3ñ ‘{Õ#ðs3ñ ™8Õ$ðs3ñ ™™d¡C˜iÕ(Õ)ðs3ñ ™#•ðs3ñ ™U¡3©©d±MÐ#AÕBÕCðs3ñ ™3•-ðs3ñ "¡$�ðs3ñ $¡C�=ðs3ñ ™C•=ñs3rP   c           	     ó  € \        V P                  P                  R 4      R,          4      V n        W@n        WPn        W€n        W�n        T;'       g    / V n        V'       d   \        V4      MV P                  V n	        T;'       g    V P                  V n        V
eM   \        V
\        4      '       g7   \        P                  ! \        V
4      V\!        W€P                  R7      R7      p
R\"        P$                  ! V P&                  P(                  4      P*                  9   d	   Ve   WR&   V
e   W¯R&   Ve   W¿R&   Wðn        V P.                  ! RRVRVR	V/VB w  V n        V n        Vf   V P5                  4       pV P                  Vn        V P                  Vn	        V P0                  P                  Vn        V P0                  P:                  Vn        W`n        Ve   WpP<                  n        \A        T;'       g    \0        PB                  4      V n"        \G        V PD                  4      '       d   V PD                  M(\H        PJ                  PM                  V PD                  4      V n"        V'       d0   \N        PP                  ! V PD                  \0        PR                  4      M\A        \0        PT                  4      V n+        \G        V PV                  4      '       d   V PV                  M(\H        PJ                  PM                  V PV                  4      V n+        RV n,        V P[                  4       V n.        \G        V PD                  4      '       Egå   \H        P^                  ! V PD                  R
R7       \H        PJ                  PQ                  V PD                  \a        V P\                  4      Pc                  4       Pe                  RR4      R,           4      p\g        V4      ;_uu_ 4        \H        PJ                  Pi                  V P\                  4      '       Ed   \k        \H        Pl                  ! V P\                  4      4      ^ 8”  d—   \H        PJ                  Pi                  \H        PJ                  PQ                  V P\                  \0        Pn                  4      4      '       d;   \p        Ps                  R4       \t        Pv                  ! V P\                  4      V n        MP\p        Py                  RV P\                   RV P                   R24       \H        Pz                  ! V P\                  4       RRR4       V P\                  V n>        \~        P€                  ! R4      V nA        RV nB        RV nC        RV nD        \‹        V 4       R#   + '       g   i     L^; i)Ú.N©r³   rµ   ©rž   rŸ   r²   rX   r{   r°   rq   rš   T©Úexist_okÚ/Ú_z.lockz<Overwrite dataset info from restored data version if exists.zOld caching folder z for dataset z- exists but no data were found. Removing it. ÚfileFéÿÿÿÿrJ   )Fr.   rL   ÚsplitrW   r“   rž   r³   r´   rµ   r¯   ÚDEFAULT_WRITER_BATCH_SIZEÚ_writer_batch_sizerY   r   Úfrom_patternsr   r   ÚinspectÚ	signatureÚBUILDER_CONFIG_CLASSÚ__init__Ú
parametersrp   Ú_create_builder_configr   rš   Ú_infoÚbuilder_namer°   rz   r±   r²   rt   ÚHF_DATASETS_CACHEÚ_cache_dir_rootr8   r‹   rŒ   Ú
expanduserÚ	posixpathr�   ÚDOWNLOADED_DATASETS_DIRÚDOWNLOADED_DATASETS_PATHÚ_cache_downloaded_dirÚ_legacy_relative_data_dirÚ_build_cache_dirÚ
_cache_dirÚmakedirsr   Úas_posixÚreplacer7   Úexistsr’   ÚlistdirÚDATASET_INFO_FILENAMEÚloggerÚdebugr(   Úfrom_directoryÚwarningÚrmdirÚ_output_dirÚfsspecÚ
filesystemÚ_fsÚ
dl_managerÚ_record_checksumsÚ_file_formatr3   )r[   r®   r¯   r°   r“   rž   r±   r²   r³   r´   rX   r{   rµ   r¶   rš   rp   Ú	lock_paths   &&&&&&&&&&&&&&&, rQ   rÊ   ÚDatasetBuilder.__init__4  s  € ô& 0°·±×0EÑ0EÀcÓ0JÈ2Õ0NÓOˆŒ	Ø#'Œ	Ø"ŒØŒ
ØŒØ.×4Ð4°"ˆÔßDPÔ2°<Ô@ÐVZ×V_ÑV_ˆÔØ"3×"UÐ"U°t×7UÑ7UˆÔàÒ!¬*°ZÄ×*OÒ*OÜ&×4Ò4Ü! *Ó-Ø#Ü .°U×L`ÑL`Ô aôˆJð œ×*Ò*¨4×+DÑ+D×+MÑ+MÓN×YÑYÔYÐ^fÒ^rØ(0˜*Ñ%ØÒ!Ø*4˜,Ñ'ØÒØ(0˜*Ñ%Ø*ÔØ&*×&AÒ&Añ '
Ø#ð'
à$ð'
ð  ð'
ð ñ	'
Ñ#ˆŒ�T”^ð Š<Ø—:‘:“<ˆDØ ŸI™IˆÔØ ×-Ñ-ˆÔØŸ;™;×+Ñ+ˆÔØ—{‘{×*Ñ*ˆŒØŒ	àÒØ!)�I‰IÔô  # 9×#HÐ#H´×0HÑ0HÓIˆÔä$1°$×2FÑ2F×$GÒ$GˆD× Ò ÌRÏWÉW×M_ÑM_Ð`d×`tÑ`tÓMuð 	Ô÷
 ô �NŠN˜4×/Ñ/´×1OÑ1OÔPä”V×4Ñ4Ó5ð 	Ô"ô ˜T×7Ñ7×8Ò8ð ×&Ò&ä—‘×#Ñ# D×$>Ñ$>Ó?ð 	Ô"ð *.ˆÔ&à×/Ñ/Ó1ˆŒÜ˜T×1Ñ1×2Ó2Ü�KŠK˜×,Ñ,°tÕ<ÜŸ™Ÿ™Ø×$Ñ$¤d¨4¯?©?Ó&;×&DÑ&DÓ&F×&NÑ&NÈsÐTWÓ&XÐ[bÕ&bóˆIô ˜)×$Õ$Ü—7‘7—>‘> $§/¡/×2Ó2Üœ2Ÿ:š: d§o¡oÓ6Ó7¸!Ô;ÜŸ7™7Ÿ>™>¬"¯'©'¯,©,°t·±Ì×HdÑHdÓ*e×fÒfÜ"ŸL™LÐ)gÔhÜ(3×(BÒ(BÀ4Ç?Á?Ó(S˜DœIøäŸ™Ø1°$·/±/Ð1BÀ-ÐPT×PaÑPaÐObð  cPð  Qôô Ÿš §¡Ô1÷ %ð  Ÿ?™?ˆÔÜ.4×.?Ò.?ÀÓ.GˆŒð ˆŒð "'ˆÔð !ˆÔô 	-¨TÖ2÷5 %×$ús   Ï!B9U<ÒBU<Õ<V	c                ó   € V P                   # ra   )ri   ©r[   s   &rQ   Ú__getstate__ÚDatasetBuilder.__getstate__©  s   € Ø�}‰}ÐrP   c                ó(   € Wn         \        V 4       R # ra   )ri   r3   )r[   Úds   &&rQ   Ú__setstate__ÚDatasetBuilder.__setstate__¬  s   € ØŒä,¨TÖ2rP   c                ó0   <€ V ^8„  d   QhRS[ S[,          /# ©ro   rr   ©r   rt   )ru   rv   s   "€rQ   rw   r¸   ±  s   ø€ ÷ 0ñ 0¡X©c¥]ñ 0rP   c                ó”  € V P                   P                  R4      '       Ed¦   \        V P                  4      '       Egˆ   V P                  P
                  R8X  Edj   ^RIHp V P                  '       dC   V P                  P                  R4      ^ 8”  d#   V P                  P                  R4      ^ ,          MRpV P                  e   V P                  P                  RR4      MV P                  pW0P                  \        V P                  P
                  4      R ,           pVP                  V P
                  R4      ^,          p\         P"                  ! Vf   V P                  MV RV P                   2VR	V4      p\         P"                  ! V P                  V4      p\$        P&                  P)                  V4      '       d   V# R# R# R# R# )
z]Check for the old cache directory template {cache_dir}/{namespace}___{builder_name} from 2.13ú	datasets.rT   )Ú_PACKAGED_DATASETS_MODULESr¿   Nz--ÚmissingÚ___rU   )rL   Ú
startswithr8   rÐ   r   rW   Úpackaged_modulesrú   r´   ÚcountrÃ   rÛ   r¯   rš   r’   ÚgetrÒ   r�   r‹   rŒ   Úisdir)r[   rú   Ú	namespacer°   rš   r“   Úlegacy_relative_data_dirÚlegacy_cache_dirs   &       rQ   Ú_check_legacy_cacheÚ"DatasetBuilder._check_legacy_cache±  sc  € ð �O‰O×&Ñ& {×3Ó3Ü! $×"6Ñ"6×7Ó7Ø—‘× Ñ  IÕ-åDà6:·l·l°lÀtÇ|Á|×GYÑGYÐZ]ÓG^ÐabÔGb˜Ÿ™×*Ñ*¨3Ó/°Ö2ÐhlˆIØ=A¿\¹\Ò=U˜$Ÿ,™,×.Ñ.¨s°DÔ9Ð[_×[lÑ[lˆKØ#§n¡n´S¸¿¹×9IÑ9IÓ5JÐ5LÐ&MÕMˆIØ-×1Ñ1°$·)±)¸YÓGÈÕJˆDÜ'0§~¢~Ø%.Ò%6�×!Ò!¸y¸kÈÈT×M^ÑM^ÐL_Ð<`ØØØó	(Ð$ô  )Ÿ~š~¨d×.BÑ.BÐD\Ó]ÐÜ�w‰w�}‰}Ð-×.Ò.Ø/Ð/ñ /ñ .ñ 8ñ 4rP   c                ó4   <€ V ^8„  d   QhRRRS[ S[,          /# )ro   Údataset_modulerG   rr   r÷   )ru   rv   s   "€rQ   rw   r¸   È  s    ø€ ÷ -0ñ -0°?ð -0ÁxÑPSÅ}ñ -0rP   c                óú  € V P                   P                  R4      '       EdE   \        V P                  4      '       Eg'   \	        V P
                  4      RR0,
          '       Eg    ^RIHp ^RIH	p R R lpV P                  '       dC   V P                  P                  R4      ^ 8”  d#   V P                  P                  R4      ^ ,          MR	p\        P                  ! VR
R4      ;_uu_ 4        V P                  P                   R,           \"        P$                  ! RV P                  P&                  /4      ,           pR	R	R	4       VP)                  V P                   R4      pVP*                  P,                  '       dg   V P                  P                   VP*                  P,                  9   d8   V! WqP*                  P,                  V P                  P                   ,          4      p\.        P0                  ! Vf   V P2                  MV RV P2                   2XRV4      p\.        P0                  ! V P                  V4      p	\4        P6                  P9                  V	4      '       d   V# R	# R	# R	# R	#   + '       g   i     EL7; i)zxCheck for the old cache directory template {cache_dir}/{namespace}___{dataset_name}/{config_name}-xxx from 2.14 and 2.15rù   rX   r{   )Ú&_PACKAGED_DATASETS_MODULES_2_15_HASHES)ÚPicklerc                ó<   € V ^8„  d   QhR\         R\        R\         /# )ro   r“   Úconfig_parametersrr   )rt   rs   )ru   s   "rQ   rw   Ú9DatasetBuilder._check_legacy_cache2.<locals>.__annotate__Ò  s#   € ÷ %ñ %¼ð %ÔQUð %ÔZ]ñ %rP   c                óö   € 0 Rmp\        VP                  4       4       UUu/ uF  w  r4W29  g   K  W4bK  	  ppp\        4       pVP                  V 4       VP                  V4       VP	                  4       # u uppi )z®
Used to update hash of packaged modules which is used for creating unique cache directories to reflect
different config parameters which are passed in metadata from readme.
>   rz   r°   r¥   )rŽ   r‘   r&   r”   r•   )r“   r  Úparams_to_excludeÚparamÚvalueÚparams_to_add_to_hashr™   s   &&     rQ   Ú"update_hash_with_config_parametersÚODatasetBuilder._check_legacy_cache2.<locals>.update_hash_with_config_parametersÒ  sz   € ò
 %NÐ!ô )/Ð/@×/FÑ/FÓ/HÔ(Iô)á(I™˜ØÑ5ô !�E’LÙ(Ið &ñ )ô
 “H�Ø—‘˜”Ø—‘Ð.Ô/Ø—{‘{“}Ð$ùó)s
   ¡
A5°A5r¿   NÚ_legacy_no_dict_keys_sortingTrˆ   rû   rü   rU   )rL   rý   r8   rÐ   rh   rp   rþ   r
  Úutils._dillr  r´   rÿ   rÃ   r
   Úobjectr   rW   r&   r“   rX   r   Úbuilder_configs_parametersÚmetadata_configsrÒ   r�   r¯   r‹   rŒ   r  )
r[   r  r
  r  r  r  rš   r“   r  r  s
   &&        rQ   Ú_check_legacy_cache2Ú#DatasetBuilder._check_legacy_cache2È  sà  € ð �O‰O×&Ñ& {×3Ó3Ü! $×"6Ñ"6×7Ó7Ü˜×+Ñ+Ó,°¸jÐ/I×IÕIåPÝ,õ%ð  7;·l·l°lÀtÇ|Á|×GYÑGYÐZ]ÓG^ÐabÔGb˜Ÿ™×*Ñ*¨3Ó/°Ö2ÐhlˆIÜ—’˜gÐ'EÀt×LÕLØ ŸK™K×,Ñ,¨sÕ2´V·[²[À,ÐPT×P[ÑP[×PfÑPfÐAgÓ5hÕh�	÷ Mà9×=Ñ=¸d¿i¹iÈÓSˆDà×9Ñ9×J×JÐJØ—K‘K×$Ñ$¨×(QÑ(Q×(bÑ(bÔbá9Ø×CÑC×TÑTÐUY×U`ÑU`×UeÑUeÕfó�ô (1§~¢~Ø%.Ò%6�×!Ò!¸y¸kÈÈT×M^ÑM^ÐL_Ð<`ØØØó	(Ð$ô  )Ÿ~š~¨d×.BÑ.BÐD\Ó]ÐÜ�w‰w�}‰}Ð-×.Ò.Ø/Ð/ñ /ñO Jñ 8ñ 4÷0 M×LÐLús   Ã,AI)É)I:	c                ó6   <€ V ^8„  d   QhRS[ S[S[3,          /# rö   )ÚtuplerS   rt   )ru   rv   s   "€rQ   rw   r¸   ÷  s"   ø€ ÷ Y)ñ Y)á	‰}™cÐ!Õ	"ñY)rP   c           	     óB  € RpVEfX   V P                   '       EdE   V P                  eV   V P                  P                  V P                  4      p\        P                  RV P                   RVP                   24       Má\        V P                   4      ^8”  d†   V'       g}   RV P                  ;'       g    V P                   RV P                   ^ ,          P                   R2p\        R\        V P                  P                  4       4       2RV R	2,           4      hMBV P                   ^ ,          p\        P                  R
V P                   RVP                   24       \        V\        4      '       dd   V P                  P                  V4      pVfE   V P                   '       d3   \        RV R\        V P                  P                  4       4       24      hV'       g€   Ve   WR&   M)V P                  '       d   V'       g   V P                  VR&   RV9  d4   \        V R4      '       d"   V P                   '       d   V P                   VR&   V P"                  ! R/ VB pMnV'       d   \$        P&                  ! V4      MTpVP)                  4        F:  w  rxVf   K  \        WW4      '       g   \        RV RV R24      h\+        WWV4       K<  	  VP                  '       g   \        RVP                   24      hVP-                  V P.                  \1        V P2                  V P4                  R7      R7       Vf   VP7                  VVR7      pW0P                  9  ;'       d    VR8g  p	V	'       d   \        P                  RV 24       WS3# VP                  V P                  9   dQ   WPP                  VP                  ,          8w  d0   \        R\        V P                  P                  4       4       24      hVP8                  '       g   \        RVP                   R24      hWS3# )z÷Create and validate BuilderConfig object as well as a unique config id for this config.
Raises ValueError if there are multiple builder configs and config_name and DEFAULT_CONFIG_NAME are None.
config_kwargs override the defaults kwargs in config
Nz$No config specified, defaulting to: r¿   zload_dataset('z', 'z')zEConfig name is missing.
Please pick one among the available configs: z
Example of usage:
	`Ú`z6No config specified, defaulting to the single config: zBuilderConfig 'z' not found. Available: rW   rz   ÚVERSIONzBuilderConfig z doesn't have a 'z' key.z$BuilderConfig must have a name, got r»   r¼   )rq   rT   z Using custom data configuration zvCannot name a custom BuilderConfig the same as an available BuilderConfig. Change the name. Available BuilderConfigs: z must have a versionrJ   )ÚBUILDER_CONFIGSÚDEFAULT_CONFIG_NAMEÚbuilder_configsr   rß   r±   r¯   rW   r’   r´   rZ   r·   rj   rY   rt   Úhasattrr!  rÉ   r‰   Údeepcopyr‘   Úsetattrr¢   rž   r   r³   rµ   r›   rz   )
r[   r°   rq   rš   rp   Úbuilder_configÚexample_of_usageÚkeyr  Ú	is_customs
   &&&&,     rQ   rÌ   Ú%DatasetBuilder._create_builder_config÷  sÜ  € ð ˆð Ó 4×#7×#7Ñ#7Ø×'Ñ'Ò3Ø!%×!5Ñ!5×!9Ñ!9¸$×:RÑ:RÓ!S�Ü—‘ÐBÀ4×CTÑCTÐBUÐUVÐWe×WjÑWjÐVkÐlÕmä�t×+Ñ+Ó,¨qÔ0ß(à,¨T¯\©\×-NÐ-N¸T×=NÑ=NÐ,OÈtÐTX×ThÑThÐijÕTk×TpÑTpÐSqÐqsÐtð )ô )ðNÜNRÐSW×SgÑSg×SlÑSlÓSnÓNoÐMpðrà 8Ð9IÐ8JÈ!ÐLõMóð ð	 )ð &*×%9Ñ%9¸!Õ%<�NÜ—K‘KØPÐQU×QbÑQbÐPcÐcdÐes×exÑexÐdyÐzôô
 �k¤3×'Ò'Ø!×1Ñ1×5Ñ5°kÓBˆNØÒ%¨$×*>×*>Ð*>Ü Ø% k ]Ð2JÌ4ÐPT×PdÑPd×PiÑPiÓPkÓKlÐJmÐnóð ÷
 ØÒ&Ø(3˜fÒ%Ø×)×)Ð)·-à(,×(@Ñ(@�˜fÑ%Ø Ô-´'¸$À	×2JÒ2JÈtÏ|Ï|È|Ø+/¯<©<�˜iÑ(Ø!×6Ò6ÑG¸ÑG‰N÷ ?LœTŸ]š]¨>Ô:ÐQ_ˆNØ+×1Ñ1Ö3‘
�ØÔ$Ü" >×7Ò7Ü(¨>¸.Ð9IÐIZÐ[^ÐZ_Ð_eÐ)fÓgÐgÜ˜N°Ö7ñ	 4ð ×"×"Ð"ÜÐCÀN×DWÑDWÐCXÐYÓZÐZð 	×*Ñ*Ø—n‘nÜ*°·±ÈT×MaÑMaÔbð 	+ô 	
ð ÒØ&×7Ñ7ØØ /ð 8ó ˆIð ×&:Ñ&:Ñ:×VÐVÀ	ÈYÑ@Vˆ	ßÜ�K‰KÐ:¸9¸+ÐFÔGð Ð(Ð(ð ×#Ñ# t×';Ñ';Ô;Ø"×&:Ñ&:¸>×;NÑ;NÕ&OÔOä ðQÜQUÐVZ×VjÑVj×VoÑVoÓVqÓQrÐPsðuóð ð "×)×)Ð)Ü  >°.×2EÑ2EÐ1FÐFZÐ![Ó\Ð\àÐ(Ð(rP   c                ó6   <€ V ^8„  d   QhRS[ S[S[3,          /# rö   )rs   rt   rS   )ru   rv   s   "€rQ   rw   r¸   U  s   ø€ ÷ ñ ¡¡S©-Ð%7Õ 8ñ rP   c                ó  € V P                    Uu/ uF  qP                  VbK  	  pp\        V4      \        V P                   4      8w  d3   V P                    Uu. uF  qP                  NK  	  pp\        RV 24      hV# u upi u upi )z@Dictionary of pre-defined configurations for this builder class.z5Names in BUILDER_CONFIGS must not be duplicated. Got )r"  rW   r’   rZ   )Úclsr   ÚconfigsÚnamess   &   rQ   r$  ÚDatasetBuilder.builder_configsR  s   € ð
 69×5HÒ5HÓIÑ5H¨6—;‘; Ò&Ñ5HˆÐIÜˆw‹<œ3˜s×2Ñ2Ó3Ô3Ø/2×/BÒ/BÓCÑ/B V—[”[Ñ/BˆEÐCÜÐTÐUZÐT[Ð\Ó]Ð]Øˆùò	 JùâCs   �A=ÁBc                ó   € V P                   # ra   )rØ   rî   s   &rQ   r®   ÚDatasetBuilder.cache_dir]  s   € à�‰ÐrP   c                ó   <€ V ^8„  d   QhRR/# )ro   r  rG   rJ   )ru   rv   s   "€rQ   rw   r¸   a  s   ø€ ÷ +ñ +Àñ +rP   c                óÂ   € V P                  V4      ;'       g    V P                  4       ;'       g    R V n        V P                  4       V n        V P                  V n        R # ra   )r  r  rÖ   r×   rØ   rä   )r[   r  s   &&rQ   Ú!_use_legacy_cache_dir_if_possibleÚ0DatasetBuilder._use_legacy_cache_dir_if_possiblea  sR   € ð ×%Ñ% nÓ5×[Ð[¸×9QÑ9QÓ9S×[Ð[ÐW[ð 	Ô&ð ×/Ñ/Ó1ˆŒØŸ?™?ˆÖrP   c                ó    <€ V ^8„  d   QhRS[ /# rö   ©rt   )ru   rv   s   "€rQ   rw   r¸   i  s   ø€ ÷  ñ  Ásñ  rP   c                ó´  € V P                   e   V'       d   V'       d   V P                   # V P                  '       dC   V P                  P                  R4      ^ 8”  d#   V P                  P                  R4      ^ ,          MRpVf   V P                  MV RV P                   2p\
        P                  ! W@P                  4      pV'       d5   \
        P                  ! V\        V P                  P                  4      4      pV'       dS   V P                  '       dA   \        V P                  \        4      '       d!   \
        P                  ! W@P                  4      pV# )aO  Relative path of this dataset in cache_dir:
Will be:
    self.dataset_name/self.config.version/self.hash/
or if a repo_id with a namespace has been specified:
    self.namespace___self.dataset_name/self.config.version/self.hash/
If any of these element is missing or if ``with_version=False`` the corresponding subfolders are dropped.
Nr¿   rü   )rÖ   r´   rÿ   rÃ   r¯   rÒ   r�   rš   rt   r   rz   r“   rY   )r[   Úwith_versionÚ	with_hashr  Úbuilder_data_dirs   &&&  rQ   Ú_relative_data_dirÚ!DatasetBuilder._relative_data_diri  sð   € ð ×)Ñ)Ò5¿,Ï9Ø×1Ñ1Ð1à26·,·,°,À4Ç<Á<×CUÑCUÐVYÓCZÐ]^ÔC^�D—L‘L×&Ñ& sÓ+¨AÖ.Ðdhˆ	Ø09Ò0A˜4×,Ò,È)ÈÐTWÐX\×XiÑXiÐWjÐGkÐÜ$Ÿ>š>Ð*:¿N¹NÓKÐßÜ(Ÿ~š~Ð.>ÄÀDÇKÁK×DWÑDWÓ@XÓYÐß˜ŸŸ˜¤z°$·)±)¼S×'AÒ'AÜ(Ÿ~š~Ð.>Ç	Á	ÓJÐØÐrP   c           
     ó(  a€ \         P                  ! V P                  V P                  RR7      4      o\         P                  ! V P                  V P                  RR7      4      pV3R lp\	        S4      '       g˜   V! 4       pV'       d‰   V^ ,          ^ ,          pW@P
                  P                  8w  d_   R\        V4       RV P                   RV P                   R\        V P
                  P                  4       R	2	p\        P                  V4       V# )
z2Return the data directory for the current version.F)r<  Tc                 ó,  <€ \         P                  P                  S4      '       g   . # . p \         P                  ! S4       F+  p V P	                  \
        P                  ! V4      V34       K-  	  V P                  RR7       V #   \         d     KQ  i ; i)z"Returns previous versions on disk.T)Úreverse)	r‹   rŒ   rÜ   rÝ   Úappendr   r¦   rZ   Úsort)Úversion_dirnamesÚdir_namer>  s     €rQ   Ú_other_versions_on_diskÚ@DatasetBuilder._build_cache_dir.<locals>._other_versions_on_disk‚  s„   ø€ ä—7‘7—>‘>Ð"2×3Ò3Ø�	à!ÐÜŸJšJÐ'7Ö8�ðØ$×+Ñ+¬U¯]ª]¸8Ó-DÀhÐ,OÖPñ 9ð
 ×!Ñ!¨$Ð!Ô/Ø#Ð#øô "ô Úðús   Á'BÂBÂBzFound a different version z of dataset z in cache_dir z". Using currently defined version rº   )rÒ   r�   rÐ   r?  r8   r   rz   rt   r¯   rß   râ   )r[   Úversion_data_dirrH  Úversion_dirsÚother_versionÚwarn_msgr>  s   &     @rQ   r×   ÚDatasetBuilder._build_cache_dir}  sð   ø€ ä$Ÿ>š>¨$×*>Ñ*>À×@WÑ@WÐejÐ@WÓ@kÓlÐÜ$Ÿ>š>¨$×*>Ñ*>À×@WÑ@WÐeiÐ@WÓ@jÓkÐõ	$ô Ð-×.Ò.Ù2Ó4ˆLßØ ,¨Q¥°Õ 2�Ø §K¡K×$7Ñ$7Ô7à4´S¸Ó5GÐ4HÈÐUY×UfÑUfÐTgð h%Ø%)×%9Ñ%9Ð$:Ð:\Ü˜tŸ{™{×2Ñ2Ó3Ð4°Að7ð ô
 —N‘N 8Ô,àÐrP   c                ó    <€ V ^8„  d   QhRS[ /# rö   r'   )ru   rv   s   "€rQ   rw   r¸      s   ø€ ÷ 	"ñ 	"‘{ñ 	"rP   c                ó   € \         h)záConstruct the DatasetInfo object. See `DatasetInfo` for details.

Warning: This function is only called once and the result is cached for all
following .info() calls.

Returns:
    info: (DatasetInfo) The dataset information
©ÚNotImplementedErrorrî   s   &rQ   rÍ   ÚDatasetBuilder._infoŸ  s
   € ô "Ð!rP   c                ó�   € \         P                  P                  \        P                  ! \        P
                  ! V 4      4      4      # )z8Return the path of the module of this class or subclass.)r‹   rŒ   ÚdirnamerÇ   ÚgetfileÚ	getmodule)r/  s   &rQ   Úget_imported_module_dirÚ&DatasetBuilder.get_imported_module_dir«  s+   € ô �w‰w�‰œwŸš¬w×/@Ò/@ÀÓ/EÓFÓGÐGrP   c                ó&   <€ V ^8„  d   QhRS[ RS[ /# )ro   ÚsrcÚdstr:  )ru   rv   s   "€rQ   rw   r¸   °  s   ø€ ÷ #ñ #™3ð #¡Sñ #rP   c                ó2   € \        V P                  W4       R # ra   )r%   rç   )r[   r[  r\  s   &&&rQ   Ú_renameÚDatasetBuilder._rename°  s   € Üˆt�x‰x˜Ö"rP   c                ó(  <€ V ^8„  d   QhRS[ S[,          RS[ S[,          RS[ S[S[S[3,          ,          RS[ S[S[S[3,          ,          RS[ S[,          RS[ S[,          RS[RS[ S[S[S[3,          ,          R	S[ S[,          R
S[ S[,          /
# )ro   Ú
output_dirrŸ   Údownload_modeÚverification_moderè   rž   Úfile_formatÚmax_shard_sizeÚnum_procrµ   )	r   rt   r   r	   r   r9   r   r~   rs   )ru   rv   s   "€rQ   rw   r¸   ³  sÁ   ø€ ÷ Yñ Yá™S•MðYñ "¡.Õ1ðYñ  ¡¡l±CÐ&7Õ 8Õ9ð	Yñ
 $¡EÑ*:¹CÐ*?Õ$@ÕAðYñ ™_Õ-ðYñ ™C•=ðYñ ðYñ !¡¡s©C x¥Õ1ðYñ ™3•-ðYñ "¡$�ñYrP   c                ó¢  a a€ Ve   TMS P                   p\        V3/ T
;'       g    / B w  rÁVS n        \        S P                  4      '       g   TMS P                  P	                  V4      S n        \        T;'       g    \        P                  4      p\        T;'       g    \        P                  4      pVe   TMS P                  pVe   VR'9  d   \        RV R24      hVS n        S P                  P                  S P
                  4      R8X  d8   \        RS P
                   RS P
                  S P                  ,            R24      hVf�   VfS   \!        S P"                  V\        P$                  8H  V\        P$                  8H  RV	S P&                  S P(                  R	7      p\+        S P                  VS P,                  P.                  VS P0                  R
7      p\        S P                  4      '       * oVS n        S'       dD   \5        S P
                  4      P6                  P9                  RRR7       S P
                  R,           pS'       d   \;        X4      M\<        P>                  ! 4       ;_uu_ 4        S P                  PA                  \B        PD                  ! S P
                  \,        PF                  4      4      pV'       df   V\        P                  8X  dQ   \H        PK                  RS P                   RS P
                   R24       S PM                  4       S n%         RRR4       R# \H        PK                  RS P                   RS P
                   R24       S'       dØ   \O        S PJ                  PP                  ;'       g    ^ \5        S P
                  4      P6                  R7      '       gŠ   \S        R\U        S PJ                  PP                  ;'       g    ^ 4       R\U        S PJ                  PV                  ;'       g    ^ 4       R\U        S PJ                  PX                  ;'       g    ^ 4       24      h\<        PZ                  VV 3R l4       pS PJ                  PP                  '       d©   \H        PK                  RS P                   RS P,                  P\                   R\U        S PJ                  PV                  4       R\U        S PJ                  PX                  4       R\U        S PJ                  PP                  4       RS P
                   R24       MvS'       d&   S P                  P                  S P
                  4      MS P
                  p\H        PK                  RS P                   RS P,                  P\                   RV R24       V! S P
                  4      ;_uu_ 4       p\_        S RV4      ;_uu_ 4        RV/pVe   VVR&   V	e   V	VR &   S P`                  ! R(R!VR"V/VBVB  \c        R# S PJ                  Pd                  Pg                  4        4       4      S PJ                  n,        VPh                  '       d    VPk                  4       S PJ                  n6        S PJ                  PV                  eA   S PJ                  PX                  S PJ                  PV                  ,           S PJ                  n(        S Po                  4        RRR4       RRR4       \H        PK                  R$S P                   R%S P
                   R&24       RRR4       R#   + '       g   i     LR; i  + '       g   i     L]; i  + '       g   i     R# ; i))a›  Downloads and prepares dataset for reading.

Args:
    output_dir (`str`, *optional*):
        Output directory for the dataset.
        Default to this builder's `cache_dir`, which is inside `~/.cache/huggingface/datasets` by default.

        <Added version="2.5.0"/>
    download_config (`DownloadConfig`, *optional*):
        Specific download configuration parameters.
    download_mode ([`DownloadMode`] or `str`, *optional*):
        Select the download/generate mode, default to `REUSE_DATASET_IF_EXISTS`.
    verification_mode ([`VerificationMode`] or `str`, defaults to `BASIC_CHECKS`):
        Verification mode determining the checks to run on the downloaded/processed dataset information (checksums/size/splits/...).

        <Added version="2.9.1"/>
    dl_manager (`DownloadManager`, *optional*):
        Specific `DownloadManger` to use.
    base_path (`str`, *optional*):
        Base path for relative paths that are used to download files. This can be a remote url.
        If not specified, the value of the `base_path` attribute (`self.base_path`) will be used instead.
    file_format (`str`, *optional*):
        Format of the data files in which the dataset will be written.
        Supported formats: "arrow", "parquet". Default to "arrow" format.
        If the format is "parquet", then image and audio data are embedded into the Parquet files instead of pointing to local files.

        <Added version="2.5.0"/>
    max_shard_size (`Union[str, int]`, *optional*):
        Maximum number of bytes written per shard, default is "500MB".
        The size is based on uncompressed data size, so in practice your shard files may be smaller than
        `max_shard_size` thanks to Parquet compression for example.

        <Added version="2.5.0"/>
    num_proc (`int`, *optional*, defaults to `None`):
        Number of processes when downloading and generating the dataset locally.
        Multiprocessing is disabled by default.

        <Added version="2.7.0"/>
    storage_options (`dict`, *optional*):
        Key/value pairs to be passed on to the caching file-system backend, if any.

        <Added version="2.5.0"/>
    **download_and_prepare_kwargs (additional keyword arguments): Keyword arguments.

Example:

Download and prepare the dataset as Arrow files that can be loaded as a Dataset using `builder.as_dataset()`:

```py
>>> from datasets import load_dataset_builder
>>> builder = load_dataset_builder("cornell-movie-review-data/rotten_tomatoes")
>>> builder.download_and_prepare()
```

Download and prepare the dataset as sharded Parquet files locally:

```py
>>> from datasets import load_dataset_builder
>>> builder = load_dataset_builder("cornell-movie-review-data/rotten_tomatoes")
>>> builder.download_and_prepare("./output_dir", file_format="parquet")
```

Download and prepare the dataset as sharded Parquet files in a cloud storage:

```py
>>> from datasets import load_dataset_builder
>>> storage_options = {"key": aws_access_key_id, "secret": aws_secret_access_key}
>>> builder = load_dataset_builder("cornell-movie-review-data/rotten_tomatoes")
>>> builder.download_and_prepare("s3://my-bucket/my_rotten_tomatoes", storage_options=storage_options, file_format="parquet")
```
NzUnsupported file_format: z. Expected 'arrow' or 'parquet'Ú z7Unable to download and prepare the dataset at the root z'. Please specify a subdirectory, e.g. 'Ú'F)r®   Úforce_downloadÚforce_extractÚuse_etagrf  r³   rµ   )r¯   rŸ   r{   rž   Úrecord_checksumsT)Úparentsr¾   z_builder.lockzFound cached dataset z (Ú)zGenerating dataset )Ú	directoryzNot enough disk space. Needed: z (download: z, generated: c              3  óP  <"  € S'       g$   SP                   P                  V RR7       V x € R# V R,           p\        P                  ! VRR7        Vx € \        P                  P	                  V 4      '       d   \
        P                  ! V 4       \
        P                  ! W4       \        P                  P                  V4      '       d   \
        P                  ! V4       R# R#   \        P                  P                  T4      '       d   \
        P                  ! T4       i i ; i5i)z4Create temporary dir for dirname and rename on exit.Tr½   z.incompleteN)	rç   rÙ   r‹   rŒ   r  ÚshutilÚrmtreeÚmoverÜ   )rU  Útmp_dirÚis_localr[   s   & €€rQ   Úincomplete_dirÚ;DatasetBuilder.download_and_prepare.<locals>.incomplete_dirP  s¼   øé € ÷  Ø—H‘H×%Ñ% g¸Ð%Ô=Ø!”Mà%¨Õ5�GÜ—K’K °$Õ7ð3Ø%šÜŸ7™7Ÿ=™=¨×1Ò1Ü"ŸMšM¨'Ô2äŸš GÔ5äŸ7™7Ÿ>™>¨'×2Ò2Ü"ŸMšM¨'Ö2ñ 3øœ2Ÿ7™7Ÿ>™>¨'×2Ò2Ü"ŸMšM¨'Õ2ð 3üs$   ƒAD&Á(C% Á:,C% Â&?D&Ã%>D#Ä#D&z"Downloading and preparing dataset r¿   z	, total: z) to z...ú to rä   rd  re  rf  rè   rc  c              3   ó8   "  € T F  qP                   x € K  	  R # 5ira   )Ú	num_bytes)rc   rÃ   s   & rQ   rf   Ú6DatasetBuilder.download_and_prepare.<locals>.<genexpr>�  s   é € Ð0hÑNgÀU·¶ÓNgùs   ‚úDataset z downloaded and prepared to z(. Subsequent calls will reuse this data.)ÚarrowÚparquetrJ   )8rØ   r   rç   r$   Úunstrip_protocolrä   r   ÚREUSE_DATASET_IF_EXISTSr9   ÚBASIC_CHECKSrž   rZ   rê   Ú_strip_protocolÚRuntimeErrorr¯   r   rÕ   ÚFORCE_REDOWNLOADr³   rµ   r   r   r{   ré   rè   r   ÚparentÚmkdirr7   Ú
contextlibÚnullcontextrÜ   rÒ   r�   rÞ   rß   r±   Ú
_load_infor>   Úsize_in_bytesÚOSErrorrB   Údownload_sizeÚdataset_sizeÚcontextmanagerrW   rC   Ú_download_and_prepareÚsumÚsplitsr�   rm  Úget_recorded_sizes_checksumsÚdownload_checksumsÚ
_save_info)r[   ra  rŸ   rb  rc  rè   rž   rd  re  rf  rµ   Údownload_and_prepare_kwargsÚfsrë   Údata_existsrw  Ú_destÚtmp_output_dirÚprepare_split_kwargsrv  s   f&&&&&&&&&&,       @rQ   Údownload_and_prepareÚ#DatasetBuilder.download_and_prepare³  sz  ù€ ðj $.Ò#9‘Z¸t¿¹ˆ
ä" :ÑI°/×2GÐ2GÀRÑI‰ˆØˆŒÜ-AÀ$Ç(Á(×-KÒ-K™:ÐQU×QYÑQY×QjÑQjÐkuÓQvˆÔä$ ]×%ZÐ%Z´l×6ZÑ6ZÓ[ˆÜ,Ð->×-_Ð-_ÔBR×B_ÑB_Ó`ÐØ!*Ò!6‘I¸D¿N¹Nˆ	àÒ" {Ð:NÔ'NÜÐ8¸¸ÐEdÐeÓfÐfØ'ˆÔà�8‰8×#Ñ# D×$4Ñ$4Ó5¸Ô;ô ØIÈ$×JZÑJZÐI[ð \8Ø8<×8HÑ8HÈ4×K\ÑK\Õ8\Ð7]Ð]^ð`óð ð
 ÒØÒ&Ü"0Ø"×8Ñ8Ø#0´L×4QÑ4QÑ#QØ"/´<×3PÑ3PÑ"PØ"Ø%ØŸ*™*Ø$(×$8Ñ$8ô#�ô )Ø!×.Ñ.Ø /ØŸ™×-Ñ-Ø#Ø!%×!7Ñ!7ôˆJô ,¨D¯H©HÓ5Ô5ˆØ$ˆŒ÷ ä�×!Ñ!Ó"×)Ñ)×/Ñ/¸ÀtÐ/ÔLØ×(Ñ(¨?Õ:ˆI÷ %-ŒX�iÔ ´*×2HÒ2HÓ2J×JÑJàŸ(™(Ÿ/™/¬)¯.ª.¸×9IÑ9IÌ6×KgÑKgÓ*hÓiˆKß˜}´×0TÑ0TÔTÜ—‘Ð3°D×4EÑ4EÐ3FÀbÈ×IYÑIYÐHZÐZ[Ð\Ô]ð !ŸO™OÓ-�”	Ø÷ KÑJô �K‰KÐ-¨d×.?Ñ.?Ð-@ÀÀ4×CSÑCSÐBTÐTUÐVÔWßÜ0Ø—I‘I×+Ñ+×0Ð0¨q¼DÀ×AQÑAQÓ<R×<YÑ<Y÷ó ô "Ø9¼(À4Ç9Á9×CZÑCZ×C_ÐC_Ð^_Ó:`Ð9aÐamÔnvÐw{÷  xAñ  xA÷  xOñ  xO÷  xTð  xTð  STó  oUð  nVð  Vcô  dlð  mq÷  mvñ  mv÷  mCñ  mC÷  mHð  mHð  GHó  dIð  cJð  Kóð ô ×&Ñ&õ3ó 'ð3ð* �y‰y×&×&Ð&Ü—‘Ø8¸×9JÑ9JÐ8KÈ1ÈTÏ[É[×M]ÑM]ÐL^ð _"Ü"*¨4¯9©9×+BÑ+BÓ"CÐ!DÀMÔRZÐ[_×[dÑ[d×[qÑ[qÓRrÐQsð tÜ& t§y¡y×'>Ñ'>Ó?Ð@ÀÀd×FVÑFVÐEWÐWZð\õ÷ GO˜Ÿ™×0Ñ0°×1AÑ1AÔBÐTX×TdÑTd�Ü—‘Ð@À×ARÑARÐ@SÐSTÐUY×U`ÑU`×UeÑUeÐTfÐfjÐkpÐjqÐqtÐuÔvñ   × 0Ñ 0×1Ô1°^ô *¨$°¸~×NÕNØ,9¸;Ð+GÐ(Ø%Ò1ØAOÐ,Ð-=Ñ>ØÒ+Ø;CÐ,¨ZÑ8Ø×.Ò.ñ Ø#-ðà*;ðð /ðð 6ò	ô .1Ñ0hÈdÏiÉi×N^ÑN^×NeÑNeÔNgÓ0hÓ-h�D—I‘IÔ*Ø!×2×2Ð2Ø7A×7^Ñ7^Ó7`˜Ÿ	™	Ô4Ø—y‘y×.Ñ.Ò:Ø26·)±)×2HÑ2HÈ4Ï9É9×KbÑKbÕ2b˜Ÿ	™	Ô/à—O‘OÔ%÷' O÷ 2ô0 �K‰KØ˜4×,Ñ,Ð-Ð-IÈ$×JZÑJZÐI[ð \9ð :ô÷Y KÑJ÷n O×Nú÷ 2×1ú÷i K×JÐJúsr   É9B,\=Ì/7\=Í'!\=Î	A\=Ï)\=Ð)\=Ð1A\=Ñ4B/\=Ô$B\=Ö,\*	×D\Û\*	Û8\=Ü\'Ü"\*	Ü*\:Ü5\=Ü=]	c                óÒ  € \        V P                  R7      pV P                  V4      pV P                  ! V3/ VB pV\        P
                  8X  dB   VP                  '       d0   \        V P                  P                  VP                  4       R4       V F¬  p\        VP                  P                  4      P                  4       R8X  d   \        R4      h\         P                  RVP                  P                   R24       VP#                  VP                  4        V P$                  ! V3/ VB  TP)                  4        K®  	  V\        P*                  8X  g   V\        P
                  8X  d!   \-        V P                  P.                  V4       W@P                  n        VP0                  V P                  n        R#   \&         d"   p\'        R\        T4      ,           4      RhRp?ii ; i)	a¡  Downloads and prepares dataset for reading.

This is the internal implementation to overwrite called when user calls
`download_and_prepare`. It should download all required data and generate
the pre-processed datasets files.

Args:
    dl_manager ([`DownloadManager`]):
        `DownloadManager` used to download and cache data.
    verification_mode ([`VerificationMode`]):
        if `ALL_CHECKS`, perform all the verifications including checksums.
        if `BASIC_CHECKS`, do not perform checksums, only perform split tests.
        if `NO_CHECKS`, do not perform any verification.
    prepare_split_kwargs: Additional options, such as `file_format`, `max_shard_size`
)r¯   zdataset source filesrk   z{`all` is a special split keyword corresponding to the union of all splits, so cannot be used as key in ._split_generator().úGenerating ú splitNz(Cannot find data file. 
Original error:
)r0   r¯   Ú_make_split_generators_kwargsÚ_split_generatorsr9   Ú
ALL_CHECKSrm  r:   r±   r”  r“  rt   Ú
split_inforW   ÚlowerrZ   rß   ÚaddÚ_prepare_splitrŒ  Úmanage_extracted_filesr‚  r;   r’  Údownloaded_sizer�  )	r[   rè   rc  r›  Ú
split_dictÚsplit_generators_kwargsÚsplit_generatorsÚsplit_generatorÚes	   &&&,     rQ   r�  Ú$DatasetBuilder._download_and_prepareŽ  s›  € ô" ¨D×,=Ñ,=Ô>ˆ
Ø"&×"DÑ"DÐEYÓ"ZÐØ15×1GÒ1GÈ
Ñ1nÐVmÑ1nÐð Ô 0× ;Ñ ;Ô;À
×@[×@[Ð@[ÜØ—	‘	×,Ñ,¨j×.UÑ.UÓ.WÐYoôó
  0ˆOÜ�?×-Ñ-×2Ñ2Ó3×9Ñ9Ó;¸uÔDÜ ð+óð ô �K‰K˜+ o×&@Ñ&@×&EÑ&EÐ%FÀfÐMÔNØ�N‰N˜?×5Ñ5Ô6ðdà×#Ò# OÑLÐ7KÒLð ×-Ñ-Ö/ñ!  0ð$ Ô 0× =Ñ =Ô=ÐARÔVf×VqÑVqÔAqÜ˜$Ÿ)™)×*Ñ*¨JÔ7ð &�	‰	ÔØ",×"<Ñ"<ˆ�	‰	Öøô ô dÜÐOÔRUÐVWÓRXÕXÓYÐ_cÐcûðdús   ÄF:Æ:G&ÇG!Ç!G&c                ó    <€ V ^8„  d   QhRS[ /# rö   r'   )ru   rv   s   "€rQ   rw   r¸   Ã  s   ø€ ÷ fñ f™Kñ frP   c                ón   € \         P                  ! V P                  V P                  P                  R 7      # )©rµ   )r(   rá   rä   rç   rµ   rî   s   &rQ   rŠ  ÚDatasetBuilder._load_infoÃ  s%   € Ü×)Ò)¨$×*:Ñ*:ÈDÏHÉH×LdÑLdÔeÐerP   c                ób  € \        V P                  4      '       g   \        V P                  R ,           4      M\        P
                  ! 4       pV;_uu_ 4        V P                  P                  V P                  V P                  P                  R7       RRR4       R#   + '       g   i     R# ; i)z
_info.lockr²  N)	r$   rç   r7   rä   rˆ  r‰  r±   Úwrite_to_directoryrµ   )r[   Ú	file_locks   & rQ   r•  ÚDatasetBuilder._save_infoÆ  ss   € ô (¨¯©×1Ò1ô �T×%Ñ%¨Õ4Ô5ä×'Ò'Ó)ð 	÷
 ŠYØ�I‰I×(Ñ(¨×)9Ñ)9È4Ï8É8×KcÑKcÐ(Ôd÷ �Y�YŠYús   Á<BÂB.	c                ó   € ?/ # )zFGet kwargs for `self._split_generators()` from `prepare_split_kwargs`.rJ   )r[   r›  s   &&rQ   r¡  Ú,DatasetBuilder._make_split_generators_kwargsÏ  s
   € à Øˆ	rP   c                óŠ   <€ V ^8„  d   QhRS[ S[S[S[S[S[,          S[S[,          3,          ,          RS[S[S[3,          /# ©ro   rÃ   rr   )r   r	   rt   r/   r·   r   r   )ru   rv   s   "€rQ   rw   r¸   Ô  sH   ø€ ÷ @ñ @á™™c¡5©$©s­)±T¹%µ[Ð@ÕAÕBð@ñ 
‰w™Ð#Õ	$ñ	@rP   c                ó  € V P                   e   V P                   R8w  d   \        R4      h\        V P                  4      '       d-   \	        R\        V P                  4      P                   R24      h\        P                  P                  V P                  4      '       g'   \        RV P                   RV P                   R24      h\        P                  RT;'       g&    R	P                  V P                   P"                  4       R
V P                   24       Vf&   V P                   P"                   Uu/ uF  q3VbK  	  pp\%        \'        V P(                  VR7      VRRR7      p\+        V\,        4      '       d   \/        V4      pV# u upi )a  Return a Dataset for the specified split.

Args:
    split (`datasets.Split`):
        Which subset of the data to return.
    verification_mode ([`VerificationMode`] or `str`, defaults to `BASIC_CHECKS`):
        Verification mode determining the checks to run on the
        downloaded/processed dataset information (checksums/size/splits/...).

        <Added version="2.9.1"/>
    in_memory (`bool`, defaults to `False`):
        Whether to copy the data in-memory.

Returns:
    datasets.Dataset

Example:

```py
>>> from datasets import load_dataset_builder
>>> builder = load_dataset_builder('cornell-movie-review-data/rotten_tomatoes')
>>> builder.download_and_prepare()
>>> ds = builder.as_dataset(split='train')
>>> ds
Dataset({
    features: ['text', 'label'],
    num_rows: 8530
})
```
r~  zELoading a dataset not written in the "arrow" format is not supported.zLoading a dataset cached in a z is not supported.r}  z: could not find data in z…. Please make sure to call builder.download_and_prepare(), or use datasets.load_dataset() before trying to access the Dataset object.zConstructing Dataset for split z, z, from )Ú	in_memoryT)Ú	map_tupleÚdisable_tqdm)rê   r"   r$   rç   rR  ÚtyperK   r‹   rŒ   rÜ   rä   ÚFileNotFoundErrorr¯   rß   rà   r�   r±   r’  r@   r   Ú_build_single_datasetrY   rs   r   )r[   rÃ   r½  ÚsÚdatasetss   &&&  rQ   Ú
as_datasetÚDatasetBuilder.as_datasetÔ  se  € ðF ×ÑÒ(¨T×->Ñ->À'Ô-IÜ!Ð"iÓjÐjÜ §¡×)Ò)Ü%Ð(FÄtÈDÏHÉHÃ~×G^ÑG^ÐF_Ð_qÐ&rÓsÐsÜ�w‰w�~‰~˜d×.Ñ.×/Ò/Ü#Ø˜4×,Ñ,Ð-Ð-FÀt×GWÑGWÐFXð YVð Vóð ô 	�‰Ð6°u×7[Ð7[ÀÇ	Á	È$Ï)É)×JZÑJZÓ@[Ð6\Ð\cÐdh×dtÑdtÐcuÐvÔwð Š=Ø#'§9¡9×#3Ò#3Ó4Ñ#3˜a˜’TÑ#3ˆEÐ4ô ÜØ×*Ñ*Ø#ôð ØØô
ˆô �h¤×%Ò%Ü" 8Ó,ˆHØˆùò 5s   Ä5F	c                ó@   <€ V ^8„  d   QhRS[ S[S[S[3,          RS[/# )ro   rÃ   r½  )r	   rt   r   r/   r}   )ru   rv   s   "€rQ   rw   r¸     s+   ø€ ÷ ñ á‘S™/©5Ð0Õ1ðñ ñrP   c                óø   € \        V\        4      '       gQ   \        V4      pVR8X  d4   RP                  V P                  P
                  P                  4       4      p\        V4      pV P                  VVR7      pV# )zas_dataset for a single split.rk   Ú+)rÃ   r½  )	rY   r   rt   r�   r±   r’  rj   r/   Ú_as_dataset)r[   rÃ   r½  Údss   &&& rQ   rÂ  Ú$DatasetBuilder._build_single_dataset  so   € ô ˜%¤×1Ò1Ü˜“JˆEØ˜Œ~ØŸ™ §¡×!1Ñ!1×!6Ñ!6Ó!8Ó9�Ü˜%“LˆEð ×ÑØØð ó 
ˆð ˆ	rP   c                óB   <€ V ^8„  d   QhRS[ S[S[3,          RS[RS[/# )ro   rÃ   r½  rr   )r	   r   r/   r}   r   )ru   rv   s   "€rQ   rw   r¸   )  s3   ø€ ÷ Bñ B¡¡¹Ð'=Õ!>ð BÑY]ð BÑjqñ BrP   c                óx  € V P                   P                  V P                  4      pV P                  pV P	                  4       '       d   V P
                  p\        W0P                  4      P                  VVV P                  P                  P                  4       VR7      pV P                  V4      p\        RRV/VB # )a‚  Constructs a `Dataset`.

This is the internal implementation to overwrite called when user calls
`as_dataset`. It should read the pre-processed datasets files and generate
the `Dataset` object.

Args:
    split (`datasets.Split`):
        which subset of the data to read.
    in_memory (`bool`, defaults to `False`):
        Whether to copy the data in-memory.

Returns:
    `Dataset`
)rW   ÚinstructionsÚsplit_infosr½  ÚfingerprintrJ   )rç   rƒ  rä   r¯   r  rW   r   r±   Úreadr’  r�   Ú_get_dataset_fingerprintr   )r[   rÃ   r½  r®   r¯   Údataset_kwargsrÑ  s   &&&    rQ   rÊ  ÚDatasetBuilder._as_dataset)  s¤   € ð  —H‘H×,Ñ,¨T×-=Ñ-=Ó>ˆ	Ø×(Ñ(ˆØ×#Ñ#×%Ò%ØŸ9™9ˆLÜ$ Y·	±	Ó:×?Ñ?ØØØŸ	™	×(Ñ(×/Ñ/Ó1Øð	 @ó 
ˆð ×3Ñ3°EÓ:ˆÜÑA ;ÐA°.ÑAÐArP   c                ó<   <€ V ^8„  d   QhRS[ S[S[3,          RS[/# r»  )r	   r   r/   rt   )ru   rv   s   "€rQ   rw   r¸   F  s&   ø€ ÷ ñ ©e±OÁUÐ4JÕ.Kð ÑPSñ rP   c                óÚ   € \        4       pVP                  \        V P                  4       4      P	                  4       4       VP                  \        V4      4       VP                  4       pV# )z€The dataset fingerprint is the hash of the relative directory dataset_name/config_name/version/hash, as well as the split specs.)r&   r”   r   r?  rÚ   rt   r•   )r[   rÃ   ÚhasherrÑ  s   &&  rQ   rÓ  Ú'DatasetBuilder._get_dataset_fingerprintF  sP   € ä“ˆØ�‰”d˜4×2Ñ2Ó4Ó5×>Ñ>Ó@ÔAØ�‰”c˜%“jÔ!Ø×&Ñ&Ó(ˆØÐrP   c          	      óx   <€ V ^8„  d   QhRS[ S[,          RS[ S[,          RS[S[S[S[3,          S[3,          /# )ro   rÃ   rž   rr   )r   rt   r	   rs   r+   )ru   rv   s   "€rQ   rw   r¸   N  sE   ø€ ÷ >ñ >á™�}ð>ñ ™C•=ð>ñ 
‰t‘C™Ð(Õ)©?Ð:Õ	;ñ	>rP   c           	     óØ  a€ \        V P                  4      '       d-   \        R \        V P                  4      P                   R24      h\        T;'       g    V P                  \        V P                  V P                  R7      V P                  V P                  P                  R7      pV P                  V4       Uu/ uF  qDP                  VbK  	  upoVf   SpEM¶\        V4      S9   d   S\        V4      ,          pEM’\!        VR4      '       dÿ   \#        SP%                  4        UUu/ uF  w  rdWdP&                  bK  	  upp4      pVP)                  V4      pVP+                  4       p	\,        ;QJ d    R V	 4       F  '       g   K   RM	  RM! R V	 4       4      '       d   \/        RV R	\1        S4       24      h\3        V	 U
u. uF/  p
V P5                  SV
P&                  P                  ,          4      NK1  	  up
V P6                  VR
7      # \        V4      \        \8        P:                  4      8X  dE   \3        SP=                  4        Uu. uF  q@P5                  V4      NK  	  upV P6                  VR
7      # R\        V4      9   dî   R\        V4      9  dÞ   R\        V4      9  dÎ   \        V4      P?                  R4       Uu. uF  q»PA                  4       NK  	  pp\B        ;QJ d    V3R lV 4       F  '       d   K   RM	  RM! V3R lV 4       4      '       g   \/        RV R	\1        S4       24      h\3        V Uu. uF  q°P5                  SV,          4      NK  	  upV P6                  VR
7      # \/        RV R	\1        S4       24      h\E        V P4                  VRR7      p\G        V\H        4      '       d   \K        V4      pV# u upi u uppi u up
i u upi u upi u upi )z(Loading a streaming dataset cached in a z is not supported yet.r»   )rž   rŸ   r¯   r{   Úget_read_instructionc              3   ó<   "  € T F  qP                   R Jx € K  	  R # 5ira   )Úslice_value)rc   r¤  s   & rQ   rf   Ú6DatasetBuilder.as_streaming_dataset.<locals>.<genexpr>h  s   é € ÐTÉ¸*×)Ñ)°Õ5Ëùs   ‚TFzBad split: z. Available splits: )r±   rÃ   rÉ  Ú[Ú]c              3   ó,   <"  € T F	  qS9   x € K  	  R # 5ira   rJ   )rc   Ú
split_nameÚsplits_generatorss   & €rQ   rf   rß  z  s   øé € ÐUÉ¸:Ð%6Ö6Ëùs   ƒ)r¾  )&r$   rç   rR  rÀ  rK   r   rž   r   r³   rµ   r¯   r   r{   r¢  rW   rt   r%  r0   r‘   r¤  rÜ  Úget_list_sliced_split_infoÚanyrZ   r·   r,   Ú_as_streaming_dataset_singler±   r/   ÚALLr�   rÃ   Ústriprk   r@   rY   rs   r   )r[   rÃ   rž   rè   ÚsgÚsplits_generatorrW   rª  Úsplit_instructionrÐ  r¤  rã  Úsplit_namesrÄ  rä  s   &&&           @rQ   Úas_streaming_datasetÚ#DatasetBuilder.as_streaming_datasetN  sa  ø€ ô
   §¡×)Ò)Ü%Ø:¼4ÀÇÁ»>×;RÑ;RÐ:SÐSiÐjóð ô .Ø×1Ð1 4§>¡>Ü*°·±ÈT×MaÑMaÔbØ×*Ñ*Ø—[‘[×)Ñ)ô	
ˆ
ð 48×3IÑ3IÈ*Ô3UÓVÑ3U¨RŸW™W bš[Ñ3UÑVÐàŠ=Ø0ÒÜ�‹ZÐ,Ô,Ø0´°U³Õ<ÒÜ�UÐ2×3Ò3Ü"ÐHY×H_ÑH_ÔHaÔ#bÑHa¹H¸D D¯-©-Ò$7ÑHaÒ#bÓcˆJØ %× :Ñ :¸:Ó FÐØ+×FÑFÓHˆKß‹sÑTÉÓT�s�sŠsÑTÉÓT×TÒTÜ  ;¨u¨gÐ5IÌ$ÐO`ÓJaÐIbÐ!cÓdÐdÜ1ñ '2óá&1˜
ð ×5Ñ5Ð6GÈ
×H]ÑH]×HbÑHbÕ6cÖdÙ&1ñð —Y‘YØôð ô �‹Zœ3œuŸy™y›>Ô)Ü1ØAR×AYÑAYÔA[Ó\ÑA[¸2×2Ñ2°2Ö6ÑA[Ñ\Ø—Y‘YØôð ð
 ”C˜“JÔ 3¬c°%«jÔ#8¸SÌÈEË
Ô=RÜ@CÀEÃ
×@PÑ@PÐQTÔ@UÓVÑ@U°*×+Ñ+Ö-Ñ@UˆKÐVß“3ÔUÉÓU—3—3’3ÔUÉÓU×UÒUÜ  ;¨u¨gÐ5IÌ$ÐO`ÓJaÐIbÐ!cÓdÐdÜ1ÙdoÓpÑdoÐV`×2Ñ2Ð3DÀZÕ3PÖQÑdoÑpØ—Y‘YØôð ô ˜{¨5¨'Ð1EÄdÐK\ÓF]ÐE^Ð_Ó`Ð`ô Ø×-Ñ-ØØô
ˆô
 �h¤×%Ò%Ü*¨8Ó4ˆHØˆùò] Wùó $cùòùò ]ùò
 Wùò qs$   Â<OÄ*O
Ç5OÉOËO"Í O'c                ó    <€ V ^8„  d   QhRS[ /# rö   )r+   )ru   rv   s   "€rQ   rw   r¸   Ž  s   ø€ ÷ 	
ñ 	
ñ 
ñ	
rP   c                óÀ   € V P                  V4      pV P                  '       d   V P                  V P                  /M/ p\        W P                  VP
                  VR 7      # ))r±   rÃ   Útoken_per_repo_id)Ú _get_examples_iterable_for_splitr´   r³   r+   r±   rW   )r[   rë  Úex_iterablerò  s   &&  rQ   rç  Ú+DatasetBuilder._as_streaming_dataset_singleŽ  sR   € ð ×;Ñ;Ð<LÓMˆà:>¿,¿,¸,˜TŸ\™\¨4¯:©:Ñ6ÈBÐÜØŸi™iÐ/?×/DÑ/DÐXiô
ð 	
rP   c                ó6   <€ V ^8„  d   QhRS[ S[S[3,          /# )ro   rè   )r	   r   r   )ru   rv   s   "€rQ   rw   r¸   š  s   ø€ ÷ ,$ñ ,$©E±/ÑC[Ð2[Õ,\ñ ,$rP   c                ó   € \        4       h)a¹  Specify feature dictionary generators and dataset splits.

This function returns a list of `SplitGenerator`s defining how to generate
data and what splits to use.

Example:

    return [
            datasets.SplitGenerator(
                    name=datasets.Split.TRAIN,
                    gen_kwargs={'file': 'train_data.zip'},
            ),
            datasets.SplitGenerator(
                    name=datasets.Split.TEST,
                    gen_kwargs={'file': 'test_data.zip'},
            ),
    ]

The above code will first call `_generate_examples(file='train_data.zip')`
to write the train data, then `_generate_examples(file='test_data.zip')` to
write the test data.

Datasets are typically split into different subsets to be used at various
stages of training and evaluation.

Note that for datasets without a `VALIDATION` split, you can use a
fraction of the `TRAIN` data for evaluation as you iterate on your model
so as not to overfit to the `TEST` data.

For downloads and extractions, use the given `download_manager`.
Note that the `DownloadManager` caches downloads, so it is fine to have each
generator attempt to download the source data.

A good practice is to download all data in this function, and then
distribute the relevant parts to each split with the `gen_kwargs` argument

Args:
    dl_manager (`Union[DownloadManager, StreamingDownloadManager]`):
        Download manager to download the data

Returns:
    `list<SplitGenerator>`.
rQ  )r[   rè   s   &&rQ   r¢  Ú DatasetBuilder._split_generators™  s   € ôZ "Ó#Ð#rP   c          	      óh   <€ V ^8„  d   QhRS[ RS[RS[S[S[S[3,          ,          RS[S[,          /# )ro   r­  rd  re  rf  )r1   rt   r   r	   r~   )ru   rv   s   "€rQ   rw   r¸   É  sD   ø€ ÷ $ñ $á'ð$ñ ð$ñ !¡¡s©C x¥Õ1ð	$ñ
 ™3•-ñ$rP   c                ó   € \        4       h)a}  Generate the examples and record them on disk.

Args:
    split_generator (`SplitGenerator`):
        Split generator to process
    file_format (`str`, *optional*):
        format of the data files in which the dataset will be written.
        Supported formats: "arrow", "parquet". Default to "arrow" format.
    max_shard_size (`Union[str, int]`, *optional*):
        Maximum number of bytes written per shard, default is "500MB".
        The size is based on uncompressed data size, so in practice your shard files may be smaller than
        `max_shard_size` thanks to Parquet compression for example.
    num_proc (`int`, *optional*, defaults to `None`):
        Number of processes when downloading and generating the dataset locally.
        Multiprocessing is disabled by default.

        <Added version="2.7.0"/>
    **kwargs: Additional kwargs forwarded from _download_and_prepare
rQ  )r[   r­  rd  re  rf  Úkwargss   &&&&&,rQ   r§  ÚDatasetBuilder._prepare_splitÈ  s   € ô8 "Ó#Ð#rP   c                ó&   <€ V ^8„  d   QhRS[ RS[/# ©ro   r­  rr   ©r1   r*   )ru   rv   s   "€rQ   rw   r¸   æ  s   ø€ ÷ $ñ $Áð $ÑScñ $rP   c                ó   € \        4       h)ztGenerate the examples on the fly.

Args:
    split_generator (`SplitGenerator`):
        Split generator to process
rQ  ©r[   r­  s   &&rQ   ró  Ú/DatasetBuilder._get_examples_iterable_for_splitæ  s   € ô "Ó#Ð#rP   )ri   rØ   rÐ   rÕ   rê   rç   rÖ   rä   ré   rÅ   rž   r   rš   rp   r¯   rè   r“   r±   rW   r´   rµ   r³   )NNNNNNNNNNNNNN)NNN)TT)
NNNNNNr~  NNN)NF)F)NN©r~  NN)2rK   rL   rM   rN   r§   r!  rS   rÉ   r"  r#  rÄ   ÚSLEEP_ON_THREADS_SHUTDOWNSrÊ   rï   ró   r  r  rÌ   r<   ÚclassmethodrA   r$  Úpropertyr®   r7  r?  r×   ÚabcÚabstractmethodrÍ   rX  r^  rœ  r�  rŠ  r•  r¡  rÅ  rÂ  r/   ÚTRAINrÊ  rÓ  rî  rç  r¢  r§  ró  rO   r©   rª   s   @rQ   r¬   r¬   Ö   s¿  ø‡ € ñFðR €Gð )Ðð €Oð Ðð !%Ðð "'Ð÷s3ò s3òjò3÷
0ð 0÷.-0ð -0÷^Y)ò Y)ðv ØÙƒY÷ó ó ó ðð ñó ð÷+ð +÷ ò  ò(  ðD 	×Ñ÷	"ó ð	"ð ñHó ðH÷#ð #÷Yò Yòv3=÷jfð fòeò÷
@ò @÷Dò ð& BGÇÁÐ`e÷ Bò B÷:ð ÷>ò >÷@	
ð 	
ð 	×Ñ÷,$ó ð,$ð\ 	×Ñ÷$ñ $ó ð$÷:$ö $rP   r¬   c                   ó2   a € ] tR tRt o R tV 3R ltRtV tR# )ÚKeyið  c                óD   € \        V P                  V P                  34      # ra   )rt   Úoriginal_shard_idÚitem_or_batch_idrî   s   &rQ   Ú__str__ÚKey.__str__õ  s   € Ü�D×*Ñ*¨D×,AÑ,AÐBÓCÐCrP   c                ó2   <€ V ^8„  d   Qh/ S[ ;R&   S[ ;R&   # )ro   r  r  )r~   )ru   rv   s   "€rQ   rw   ÚKey.__annotate__ð  s   ø‡ ‚ áÑñ ñ Ñò rP   rJ   N)rK   rL   rM   rN   r  r¨   rO   r©   rª   s   @rQ   r  r  ð  s   ø‡ € ò
D÷ ƒ rP   r  c                   ó²   a a€ ] tR tRt oRtV3R lR lt]P                  V3R lR l4       tRV3R lR llt	V3R	 lR
 lt
V 3R ltV3R lR ltRtVtV ;t# )ÚGeneratorBasedBuilderiù  ac  Base class for datasets with data generation based on dict generators.

`GeneratorBasedBuilder` is a convenience class that abstracts away much
of the data writing and reading of `DatasetBuilder`. It expects subclasses to
implement generators of feature dictionaries across the dataset splits
(`_split_generators`). See the method docstrings for details.
c                ó\   <€ V ^8„  d   QhRS[ S[S[S[S[S[3,          3,          ,          /# rö   ©r   r	   rt   rs   r   )ru   rv   s   "€rQ   rw   Ú"GeneratorBasedBuilder.__annotate__  ó+   ø€ ÷ $ñ $©H±U¹3ÁÁSÉ#ÀXÅÐ;NÕ5OÕ,Pñ $rP   c                ó   € \        4       h©a°  Default function generating shards paths for each `SplitGenerator`.

This function is useful to list the original shards from where the data
comes from and is either converted to Arrow or streamed to an IterableDataset.

This is optional and only used for certain utilities, but not in Dataset
nor IterableDataset. E.g. it's used to map original shard files to Parquet
files in the Dataset Viewer after conversion.

Args:
    **kwargs (additional keyword arguments):
        Arguments forwarded from the SplitGenerator.gen_kwargs

Yields:
    shard: generally a string representing the shard path, or a dict
        representing the shard in case of shards spanning intra or inter-files.
rQ  ©r[   rû  s   &,rQ   Ú_generate_shardsÚ&GeneratorBasedBuilder._generate_shards  ó   € ô$ "Ó#Ð#rP   c                ó\   <€ V ^8„  d   QhRS[ S[S[S[S[S[3,          3,          ,          /# rö   )r   r  r  rs   rt   r   )ru   rv   s   "€rQ   rw   r    s+   ø€ ÷ $ñ $©h±u¹SÁ$ÁsÉCÀxÅ.Ð=PÕ7QÕ.Rñ $rP   c                ó   € \        4       h)a¯  Default function generating examples for each `SplitGenerator`.

This function preprocess the examples from the raw data to the preprocessed
dataset files.
This function is called once for each `SplitGenerator` defined in
`_split_generators`. The examples yielded here will be written on
disk.

Args:
    **kwargs (additional keyword arguments):
        Arguments forwarded from the SplitGenerator.gen_kwargs

Yields:
    key: `str` or `int`, a unique deterministic example identification key.
        * Unique: An error will be raised if two examples are yield with the
            same key.
        * Deterministic: When generating the dataset twice, the same example
            should have the same key.
        Good keys can be the image id, or line number if examples are extracted
        from a text file.
        The key will be hashed and sorted to shuffle examples deterministically,
        such as generating the dataset multiple times keep examples in the
        same order.
    example: `dict<str feature_name, feature_value>`, a feature dictionary
        ready to be encoded and written to disk. The example will be
        encoded with `self.info.features.encode_example({...})`.
rQ  r  s   &,rQ   Ú_generate_examplesÚ(GeneratorBasedBuilder._generate_examples  s   € ô: "Ó#Ð#rP   c          	      ób   <€ V ^8„  d   QhRS[ RS[S[,          RS[S[S[S[3,          ,          /# )ro   r­  rf  re  )r1   r   r~   r	   rt   )ru   rv   s   "€rQ   rw   r  5  s?   ø€ ÷ \*ñ \*á'ð\*ñ ™3•-ð	\*ñ
 !¡¡s©C x¥Õ1ñ\*rP   c                óP
  a a%a&a'€ \        T;'       g    \        P                  4      pS P                  P                  e)   S P                  P                  VP
                  ,          pMVP                  pRpS P                   RVP
                   V RV 2p\        P                  ! S P                  V4      o%V'       d�   V^8”  dz   \        VP                  4      pV^8:  d*   \        P                  RV RVP
                   R24       ^pM4Wƒ8  d/   \        P                  RV RV RVP
                   R	V R
2	4       Tp\        RVP                   RVP
                   R2R7      p	RS%RVRVRV/p
Ve   V^8X  d   R pVP                  p^ pT	;_uu_ 4        S P"                  ! R$RVRV/V
B  F#  w  rÞpV'       d   TpK  V	P%                  V4       K%  	  R R R 4       Vf   Q R4       hR V 4       w  pppo&pppEM'\'        \)        VP                  VR7      4       UUu. uF  w  rÜRVRV/V
CNK  	  ppp\+        V4      pR .V,          pR .V,          pR .V,          pR .V,          o&R .V,          pR .V,          pR .V,          p\-        V4      ;_uu_ 4       pT	;_uu_ 4        \/        VS P"                  VR7       F@  w  rÞpV'       d"   Vw  VV&   VV&   VV&   S&V&   VV&   VV&   VV&   K/  V	P%                  V4       KB  	  R R R 4       R R R 4       R V9  g   Q RV R24       h\1        S&4      o'\1        V4      p\1        V4      p\1        V4      pV^ ,          pVVP                  n        VVP                  n        \        P5                  RS' R
24       S'^8”  d~   R V%V V&V'3R llp\'        S&4       UUUu. uF  w  pp\7        V4       F  pVV3NK	  	  K  	  p ppp\9        VV R^@R7       V U!U"u. uF  p!V! F  p"V"NK  	  K  	  up"p!VP                  n        MJ^ ^ ppS P=                  S%P?                  R VR! 4      P?                  R"VR! 4      S%P?                  VR#4      4       V^8”  dC   \        P@                  '       d-   V U#U$u. uF  p#V# F  p$V$NK  	  K  	  up$p#VP                  n!        S P                  PD                  f   VS P                  n"        R # R #   + '       g   i     EL
; iu uppi   + '       g   i     ELù; i  + '       g   i     EL; iu upppi u up"p!i u up$p#i )%Nú-JJJJJ-SSSSS-of-NNNNNrˆ   rº   úSetting num_proc from ú back to 1 for the ú@ split to disable multiprocessing as it only contains one shard.ry  ú	 for the ú split as it only contains ú shards.ú	 examplesrŸ  r   ©ÚunitÚtotalÚdescÚfpathrd  re  r¤  Ú
gen_kwargsÚjob_idú-Failed to retrieve results from prepare_splitc              3   ó&   "  € T F  q.x € K	  	  R # 5ira   rJ   ©rc   Úitems   & rQ   rf   Ú7GeneratorBasedBuilder._prepare_split.<locals>.<genexpr>w  ó   é € Ð+¡F˜D•£Fùó   ‚©Úmax_num_jobs©Úkwargs_iterableú;Failed to retrieve results from prepare_split: result list úG still contains None - at least one worker failed to return its resultsú	Renaming c                ó:   € V ^8„  d   QhR\         \        ,          /# )ro   Úshard_and_job©r  r~   )ru   s   "rQ   rw   Ú:GeneratorBasedBuilder._prepare_split.<locals>.__annotate__¯  s   € ÷ ñ ¬U´3­Zñ rP   c                 óî   <€ V w  r\        SR V 4      V,           pSP                  SP                  RVR 4      P                  RVR 4      SP                  RVR 4      P                  RSR 4      4       R # ©NÚSSSSSÚ05dÚJJJJJzJJJJJ-SSSSSÚNNNNN©r‘  r^  rÛ   )rC  Úshard_idr3  Úglobal_shard_idr1  r[   Úshards_per_jobÚtotal_shardss   &   €€€€rQ   Ú_rename_shardÚ;GeneratorBasedBuilder._prepare_split.<locals>._rename_shard¯  s{   ø€ Ø#0Ñ �Ü"% n°W°fÐ&=Ó">ÀÕ"I�Ø—‘Ø—M‘M '¨h°s¨^Ó=×EÑEÀgÐRXÐY\ÐQ]Ó_Ø—M‘M -°OÀCÐ3HÓJ×RÑRÐSZÐ_kÐloÐ^pÓrörP   T©ÚdisableÚmax_workersrH  rI  rJ  rh  rJ   )#r=   r   ÚMAX_SHARD_SIZEr±   r’  rW   r¤  r¯   rÒ   r�   rä   rD   r2  rß   râ   Úhf_tqdmÚnum_examplesÚ_prepare_split_singler”   Ú	enumeraterE   r’   r   r?   r‘  r{  rà   Úranger   Úshard_lengthsr^  rÛ   ÚSAVE_ORIGINAL_SHARD_LENGTHSÚoriginal_shard_lengthsr²   )(r[   r­  rd  rf  re  r¤  ÚSUFFIXÚfnameÚnum_original_shardsÚpbarÚ_prepare_split_argsÚresultr2  r3  ÚdoneÚcontentÚexamples_per_jobÚbytes_per_jobÚfeatures_per_jobÚshard_lengths_per_jobÚoriginal_shards_per_jobÚoriginal_shard_lengths_per_jobÚkwargs_per_jobÚnum_jobsÚpoolÚtotal_original_shardsÚtotal_num_examplesÚtotal_num_bytesr²   rQ  Ú
num_shardsrM  Úshards_and_jobsr\  Úshard_lengthr^  Úoriginal_shard_lengthr1  rO  rP  s(   f&&&&                                @@@rQ   r§  Ú$GeneratorBasedBuilder._prepare_split5  s“  û€ ô 2°.×2YÐ2YÄF×DYÑDYÓZˆà�9‰9×ÑÒ'ØŸ™×)Ñ)¨/×*>Ñ*>Õ?‰Jà(×3Ñ3ˆJà(ˆØ×$Ñ$Ð% Q ×';Ñ';Ð&<¸V¸HÀAÀkÀ]ÐSˆÜ—’˜t×/Ñ/°Ó7ˆç˜ 1œÜ"AÀ/×B\ÑB\Ó"]ÐØ" aÔ'Ü—‘Ø,¨X¨JÐ6IÈ*Ï/É/ÐIZð  [[ð  \ôð ‘Ø$Ô/Ü—‘Ø,¨X¨J°dÐ;NÐ:OÈyÐYc×YhÑYhÐXið  jEð  FYð  EZð  Zbð  côð /�äØØ×)Ñ)Ø˜zŸ™Ð/¨vÐ6ô
ˆð �UØ˜;Ø˜nØ˜*ð	
Ðð Ò˜x¨1œ}ØˆFØ(×3Ñ3ˆJØˆFß’Ø-1×-GÒ-Gñ .Ø)ð.Ø28ð.Ø<Oô.Ñ)�F '÷ Ø!(šàŸ™ GÖ,ñ.÷ ð Ò%ÐVÐ'VÓVÐ%ñ ,¡FÓ+ñØ ØØ ØØ%Ø'Ú.ô
 +4Ü% o×&@Ñ&@ÈxÔXô+ôñ+Ñ&�Fð ˜z¨8°VÐSÐ?RÓSñ+ð ñ ô ˜>Ó*ˆHà $˜v¨Õ0ÐØ!˜F XÕ-ˆMØ $˜v¨Õ0ÐØ"˜V hÕ.ˆNØ%) F¨XÕ$5Ð!Ø'+ f¨xÕ&7Ð#Ø.2¨V°hÕ->Ð*ä�h—” 4ß’TÜ1CØ˜d×8Ñ8È.÷2Ñ-˜ g÷  ð !(ñØ 0°Ñ 8Ø -¨fÑ 5Ø 0°Ñ 8Ø .¨vÑ 6Ø 5°fÑ =Ø 7¸Ñ ?Ø >¸vÓ Fð !ŸK™K¨Ö0ñ!2÷ ÷  ð( Ð/Ô/ð ØMÐN^ÐM_ð  `gð  hóÐ/ô ˜>Ó*ˆÜ #Ð$;Ó <ÐÜ Ð!1Ó2ÐÜ˜mÓ,ˆØ# AÕ&ˆà2Dˆ×"Ñ"Ô/Ø/>ˆ×"Ñ"Ô,ô 	�‰�y  ¨hÐ7Ô8Ø˜!Ô÷ó ô +4°NÔ*Cõá*CÑ&�F˜JÜ % jÖ 1�Hð ˜6Ó"á 1ñ #Ù*Cð ò ô
 �} o¸tÐQSÕTñ 3Hô8Ù2G Ó\iÈL“Ñ\i‘Ñ2Gò8ˆO×&Ñ&Õ4ð
  ! !�fˆHØ�L‰LØ—‘˜g¨(°3¨Ó9×AÑAÀ'ÈfÐUXÈ\Ó[Ø—‘˜f bÓ)ôð
 ! 1Ô$¬×)K×)KÐ)Kñ /MôAá.LÐ*Û-CÐ)ó &á-Cñ &Ù.LòAˆO×&Ñ&Ô=ð �9‰9×ÑÒ%Ø!)ˆD�I‰IÖñ &÷W —�üó(÷" —T�Tú÷  —�üô\ùó8ùóAsI   Æ>SÈS'ÊTÊ AS-	Ë=TÎ1"TÏ+TÑ?T"ÓS$	Ó-S>Ó8	TÔT	c                ó”   <€ V ^8„  d   QhRS[ RS[RS[RS[RS[RS[RS[S[S[S[S[S[S[S[S[S[S[3,          3,          ,          /# )ro   r2  r1  rd  re  r¤  r3  rr   )rs   rt   r~   r2   r   r  r}   r#   )ru   rv   s   "€rQ   rw   r  Ó  s}   ø€ ÷ S
ñ S
áðS
ñ ðS
ñ ð	S
ñ
 ðS
ñ ðS
ñ ðS
ñ 
‘%™™T¡5©©c±8¹SÁ#ÁsÐ)JÕ#KÐKÕLÕ	MñS
rP   c           	   #  ó˜  "  € V P                   ! R	/ VB pVR 8X  d   \        M\        pVR 8H  p	. p
. p^ ^ rÜ^ p^ p^ p V! V P                  P                  VP                  RVR 4      P                  RVR 4      V P                  V P                  P                  V	R7      p \        P                  ! 4       pV EFã  w  pp\        V\        4      '       d   VP                  pVeº   VP                  V8”  d©   VP                  4       w  ppVP                  4        V
P!                  V4       VV,          pVV,          pV^,          pV! VP"                  VP                  RVR 4      P                  RVR 4      V P                  V P                  P                  V	R7      pV P                  P                  e&   V P                  P                  P%                  V4      MTpVP'                  V4       \)        V4      V8:  d1   VP+                  ^ .^V,           \)        V4      ,
          ,          4       W¿;;,          ^,          uu&   V^,          p\        P                  ! 4       V\,        P.                  ,           8”  g   EKÅ  \        P                  ! 4       pVRV3x € ^ pEKæ  	  VRV3x € V^,           pV^,           pVP                  4       w  ppVP                  4        V
P!                  V4       VV,          pVV,          pTRTTTP"                  TT
TT33x € R#   TRT3x € T^,           pT^,           pTP                  4       w  ppTP                  4        T
P!                  T4       TT,          pTT,          pi ; i  \0         dB   p\        T\2        4      '       d   TP4                  e   TP4                  p\7        R4      ThRp?ii ; i5i)
r  rH  rI  rJ  ©r²   rŒ   r¶   rµ   Úembed_local_filesNFú.An error occurred while generating the datasetTrJ   )r!  r   r   r±   r²   rÛ   rÅ   rç   rµ   ÚtimerY   r  r  Ú
_num_bytesÚfinalizeÚcloserD  Ú	_featuresÚencode_exampleÚwriter’   Úextendr   ÚPBAR_REFRESH_TIME_INTERVALÚ	Exceptionr   Ú__context__r!   )r[   r2  r1  rd  re  r¤  r3  Ú	generatorÚwriter_classr{  r\  r^  rq  rr  rM  r  Únum_examples_progress_updateÚwriterÚ_timer*  ÚrecordrX  r{  Úexamplers  ra  r®  s   &&&&&&&                    rQ   rY  Ú+GeneratorBasedBuilder._prepare_split_singleÓ  s�  é € ð ×+Ò+Ñ9¨jÑ9ˆ	Ø(3°yÔ(@•}ÄkˆØ'¨9Ñ4ÐØˆØ!#ÐØ./°˜OàˆØÐØ'(Ð$ð2	bÙ!ØŸ™×+Ñ+Ø—]‘] 7¨x¸¨nÓ>×FÑFÀwÐSYÐZ]ÐR^Ó`Ø"&×"9Ñ"9Ø $§¡× 8Ñ 8Ø"3ôˆFð%-ÜŸ	š	›�Ü#,‘K�C˜Ü! #¤s×+Ò+Ø,/×,AÑ,AÐ)Ø%Ò1°f×6GÑ6GÈ.Ô6XØ28·/±/Ó2CÑ/˜ iØŸ™œØ%×,Ñ,¨\Ô:Ø*¨lÕ:Ð*Ø'¨9Õ4˜Ø  A�˜Ù!-Ø%+×%5Ñ%5Ø!&§¡¨w¸8ÀC¸.Ó!J×!RÑ!RÐSZÐ_eÐfiÐ^jÓ!lØ.2×.EÑ.EØ,0¯H©H×,DÑ,DØ.?ô"˜ð LPÏ9É9×K]ÑK]ÒKi˜dŸi™i×0Ñ0×?Ñ?ÀÔGÐou�GØ—L‘L Ô)ÜÐ1Ó2Ð6GÔGØ.×5Ñ5°q°c¸QÐARÕ=RÔUXÐYoÓUpÕ=pÕ6qÔrØ*×=ÀÕBÓ=Ø0°AÕ5Ð0Ü—y’y“{ U¬V×-NÑ-NÕ%N×NÜ $§	¢	£˜Ø$ eÐ-IÐIÒIØ78Ó4ñ5 $-ð8 ˜eÐ%AÐAÒAØ%¨�\�
Ø&7¸!Õ&;Ð#Ø*0¯/©/Ó*;Ñ'�˜iØ—‘”Ø×$Ñ$ \Ô2Ø" lÕ2Ð"Ø 9Õ,�ð Øà"ØØ× Ñ ØØØ#Ø&ðð
ô 	
øð ˜eÐ%AÐAÒAØ%¨�\�
Ø&7¸!Õ&;Ð#Ø*0¯/©/Ó*;Ñ'�˜iØ—‘”Ø×$Ñ$ \Ô2Ø" lÕ2Ð"Ø 9Õ,‘ûÜô 	bä˜!Ô1×2Ò2°q·}±}Ò7PØ—M‘M�Ü(Ð)YÓZÐ`aÐaûð		büsJ   ‚8O
»A#M; ÂGL É;#L ÊAM; Ë=O
ÌA!M8Í8M; Í;OÎ<OÏOÏO
c                ó,   <€ \         SV `  ! VV3/ VB  R # ra   )Úsuperr�  )r[   rè   rc  Úprepare_splits_kwargsÚ	__class__s   &&&,€rQ   r�  Ú+GeneratorBasedBuilder._download_and_prepare(  s    ø€ Ü‰Ò%ØØñ	
ð $ô	
rP   c                ó&   <€ V ^8„  d   QhRS[ RS[/# rþ  rÿ  )ru   rv   s   "€rQ   rw   r  /  s   ø€ ÷ 
ñ 
Áð 
ÑScñ 
rP   c           	     ó\   € \        V P                  VP                  \        V R R4      R7      # )Ú_generate_more_gen_kwargsN)Úgenerate_more_kwargs_fn)r*   r!  r2  rb   r  s   &&rQ   ró  Ú6GeneratorBasedBuilder._get_examples_iterable_for_split/  s.   € ÜØ×#Ñ#Ø×&Ñ&Ü$+¨DÐ2MÈtÓ$Tô
ð 	
rP   rJ   r  )rK   rL   rM   rN   r§   r  r  r  r!  r§  rY  r�  ró  rO   r©   Ú__classcell__)r“  rv   s   @@rQ   r  r  ù  s\   ù‡ € ñ÷$ð $ð( 	×Ñ÷$ó ð$÷<\*ò \*÷|S
ð S
õj
÷
÷ 
ð 
rP   r  c                   ó    a € ] tR tRt o RtV 3R lR lt]P                  V 3R lR l4       tRV 3R lR	 llt	V 3R
 lR lt
V 3R lR ltRtV tR# )ÚArrowBasedBuilderi7  zaBase class for datasets with data generation based on Arrow loading functions (CSV/JSON/Parquet).c                ó\   <€ V ^8„  d   QhRS[ S[S[S[S[S[3,          3,          ,          /# rö   r  )ru   rv   s   "€rQ   rw   ÚArrowBasedBuilder.__annotate__:  r  rP   c                ó   € \        4       hr  rQ  r  s   &,rQ   r  Ú"ArrowBasedBuilder._generate_shards:  r  rP   c                óZ   <€ V ^8„  d   QhRS[ S[S[S[P                  3,          ,          /# rö   )r   r  r  ÚpaÚTable)ru   rv   s   "€rQ   rw   rž  O  s&   ø€ ÷ $ñ $©H±U¹3ÁÇÁ¸=Õ5IÕ,Jñ $rP   c                ó   € \        4       h)aL  Default function generating examples for each `SplitGenerator`.

This function preprocess the examples from the raw data to the preprocessed
dataset files.
This function is called once for each `SplitGenerator` defined in
`_split_generators`. The examples yielded here will be written on
disk.

Args:
    **kwargs (additional keyword arguments):
        Arguments forwarded from the SplitGenerator.gen_kwargs

Yields:
    key: tuple[int, int] original_shard_id and table_idx within that shard
    example: `pyarrow.Table`, a feature table
        ready to be encoded and written to disk.
rQ  r  s   &,rQ   Ú_generate_tablesÚ"ArrowBasedBuilder._generate_tablesN  s   € ô& "Ó#Ð#rP   Nc                óh   <€ V ^8„  d   QhRS[ RS[RS[S[,          RS[S[S[S[3,          ,          /# )ro   r­  rd  rf  re  )r1   rt   r   r~   r	   )ru   rv   s   "€rQ   rw   rž  c  sJ   ø€ ÷ [*ñ [*á'ð[*ñ ð[*ñ ™3•-ð	[*ñ
 !¡¡s©C x¥Õ1ñ[*rP   c                ó@
  a a%a&a'€ \        T;'       g    \        P                  4      p S P                  P                  VP
                  ,          pR pS P                   RVP
                   V RV 2p\        P                  ! S P                  V4      o%V'       d�   V^8”  dz   \        VP                  4      pV^8:  d*   \        P                  RV RVP
                   R24       ^pM4Wƒ8  d/   \        P                  RV RV RVP
                   RV R	2	4       Tp\!        R
VP"                  RVP
                   R2R7      p	RS%RVRV/p
Ve   V^8X  d   RpVP                  p^ pT	;_uu_ 4        S P$                  ! R#RVRV/V
B  F#  w  rÞpV'       d   TpK  V	P'                  V4       K%  	  RRR4       Vf   Q R4       hR V 4       w  pppo&pppEM'\)        \+        VP                  VR7      4       UUu. uF  w  rÜRVRV/V
CNK  	  ppp\-        V4      pR.V,          pR.V,          pR.V,          pR.V,          o&R.V,          pR.V,          pR.V,          p\/        V4      ;_uu_ 4       pT	;_uu_ 4        \1        VS P$                  VR7       F@  w  rÞpV'       d"   Vw  VV&   VV&   VV&   S&V&   VV&   VV&   VV&   K/  V	P'                  V4       KB  	  RRR4       RRR4       RV9  g   Q RV R24       h\3        S&4      o'\3        V4      p\3        V4      p\3        V4      pV^ ,          pVVP                  n        VVP                  n        \        P7                  RS' R	24       S'^8”  d~   R V%V V&V'3R llp\)        S&4       UUUu. uF  w  pp\9        V4       F  pVV3NK	  	  K  	  p ppp\;        VV R^@R7       V U!U"u. uF  p!V! F  p"V"NK  	  K  	  up"p!VP                  n        MJ^ ^ ppS P?                  S%PA                  RVR  4      PA                  R!VR  4      S%PA                  VR"4      4       V^8”  dC   \        PB                  '       d-   V U#U$u. uF  p#V# F  p$V$NK  	  K  	  up$p#VP                  n"        S P                  PF                  f   VS P                  n#        R# R#   \         d    TP                  p ELwi ; i  + '       g   i     EL(; iu uppi   + '       g   i     EL; i  + '       g   i     EL#; iu upppi u up"p!i u up$p#i )$r%  rˆ   rº   r&  r'  r(  ry  r)  r*  r+  r,  rŸ  r   r-  r1  rd  re  Nr2  r3  r4  c              3   ó&   "  € T F  q.x € K	  	  R # 5ira   rJ   r6  s   & rQ   rf   Ú3ArrowBasedBuilder._prepare_split.<locals>.<genexpr>¤  r9  r:  r;  r=  r?  r@  rA  c                ó:   € V ^8„  d   QhR\         \        ,          /# )ro   Úshard_id_and_jobrD  )ru   s   "rQ   rw   Ú6ArrowBasedBuilder._prepare_split.<locals>.__annotate__Ü  s   € ÷ ñ ´´cµ
ñ rP   c                 óî   <€ V w  r\        SR V 4      V,           pSP                  SP                  RVR 4      P                  RVR 4      SP                  RVR 4      P                  RSR 4      4       R # rG  rL  )r¬  rM  r3  rN  r1  r[   rO  rP  s   &   €€€€rQ   rQ  Ú7ArrowBasedBuilder._prepare_split.<locals>._rename_shardÜ  s{   ø€ Ø#3Ñ �Ü"% n°W°fÐ&=Ó">ÀÕ"I�Ø—‘Ø—M‘M '¨h°s¨^Ó=×EÑEÀgÐRXÐY\ÐQ]Ó_Ø—M‘M -°OÀCÐ3HÓJ×RÑRÐSZÐ_kÐloÐ^pÓrörP   TrS  rH  rI  rJ  rh  rJ   )$r=   r   rV  r±   r’  rW   r†  r¤  r¯   rÒ   r�   rä   rD   r2  rß   râ   rW  rX  rY  r”   rZ  rE   r’   r   r?   r‘  r{  rà   r[  r   r\  r^  rÛ   r]  r^  r²   )(r[   r­  rd  rf  re  r¤  r_  r`  ra  rb  rc  rd  r2  r3  re  rf  rg  rh  ri  rj  rk  rl  rm  rn  ro  rp  rq  rr  r²   rQ  rs  rM  Úshard_ids_and_jobsr\  ru  r^  rv  r1  rO  rP  s(   f&&&&                                @@@rQ   r§  Ú ArrowBasedBuilder._prepare_splitc  s˜  û€ ô 2°.×2YÐ2YÄF×DYÑDYÓZˆð	4ØŸ™×)Ñ)¨/×*>Ñ*>Õ?ˆJð )ˆØ×$Ñ$Ð% Q ×';Ñ';Ð&<¸V¸HÀAÀkÀ]ÐSˆÜ—’˜t×/Ñ/°Ó7ˆç˜ 1œÜ"AÀ/×B\ÑB\Ó"]ÐØ" aÔ'Ü—‘Ø,¨X¨JÐ6IÈ*Ï/É/ÐIZð  [[ð  \ôð ‘Ø$Ô/Ü—‘Ø,¨X¨J°dÐ;NÐ:OÈyÐYc×YhÑYhÐXið  jEð  FYð  EZð  Zbð  côð /�äØØ×)Ñ)Ø˜zŸ™Ð/¨vÐ6ô
ˆð �UØ˜;Ø˜nð
Ðð Ò˜x¨1œ}ØˆFØ(×3Ñ3ˆJØˆFß’Ø-1×-GÒ-Gñ .Ø)ð.Ø28ð.Ø<Oô.Ñ)�F '÷ Ø!(šàŸ™ GÖ,ñ.÷ ð Ò%ÐVÐ'VÓVÐ%ñ ,¡FÓ+ñØ ØØ ØØ%Ø'Ú.ô
 +4Ü% o×&@Ñ&@ÈxÔXô+ôñ+Ñ&�Fð ˜z¨8°VÐSÐ?RÓSñ+ð ñ ô ˜>Ó*ˆHà $˜v¨Õ0ÐØ!˜F XÕ-ˆMØ $˜v¨Õ0ÐØ"˜V hÕ.ˆNØ%) F¨XÕ$5Ð!Ø'+ f¨xÕ&7Ð#Ø.2¨V°hÕ->Ð*ä�h—” 4ß’TÜ1CØ˜d×8Ñ8È.÷2Ñ-˜ g÷  ð !(ñØ 0°Ñ 8Ø -¨fÑ 5Ø 0°Ñ 8Ø .¨vÑ 6Ø 5°fÑ =Ø 7¸Ñ ?Ø >¸vÓ Fð !ŸK™K¨Ö0ñ!2÷ ÷  ð( Ð/Ô/ð ØMÐN^ÐM_ð  `gð  hóÐ/ô ˜>Ó*ˆÜ #Ð$;Ó <ÐÜ Ð!1Ó2ÐÜ˜mÓ,ˆØ# AÕ&ˆà2Dˆ×"Ñ"Ô/Ø/>ˆ×"Ñ"Ô,ô 	�‰�y  ¨hÐ7Ô8Ø˜!Ô÷ó ô +4°NÔ*Cõ"á*CÑ&�F˜JÜ % jÖ 1�Hð ˜6Ó"á 1ñ #Ù*Cð ò "ô
 �}Ð&8À$ÐTVÕWñ 3Hô8Ù2G Ó\iÈL“Ñ\i‘Ñ2Gò8ˆO×&Ñ&Õ4ð
  ! !�fˆHØ�L‰LØ—‘˜g¨(°3¨Ó9×AÑAÀ'ÈfÐUXÈ\Ó[Ø—‘˜f bÓ)ôð
 ! 1Ô$¬×)K×)KÐ)Kñ /MôAá.LÐ*Û-CÐ)ó &á-Cñ &Ù.LòAˆO×&Ñ&Ô=ð �9‰9×ÑÒ%Ø!)ˆD�I‰IÖñ &øô_ ô 	4Ø(×3Ñ3‹Jð	4ú÷H —�üó(÷" —T�Tú÷  —�üô\"ùó8ùóAsZ   ©'R- Å.>SÇ5SÉ/S9É:AS%	ËS9Î"TÏTÑTÒ-SÓSÓS	Ó%S6Ó0	S9Ó9T
	c                óŽ   <€ V ^8„  d   QhRS[ RS[RS[RS[RS[RS[S[S[S[S[S[S[S[S[S[S[3,          3,          ,          /# )ro   r2  r1  rd  re  r3  rr   )rs   rt   r~   r   r  r}   r#   )ru   rv   s   "€rQ   rw   rž     sh   ø€ ÷ [
ñ [
Ùð[
Ù'*ð[
Ù9<ð[
ÙNQð[
Ù[^ð[
á	‘%™™T¡5©©c±8¹SÁ#ÁsÐ)JÕ#KÐKÕLÕ	Mñ[
rP   c           	   #  ó¸  "  € VP                  4        UUu/ uF)  w  rgT\        V\        4      '       d   \        V4      MTbK+  	  pppV P                  ! R
/ VB pVR 8X  d   \
        M\        p	VR 8H  p
. p. p^ ^ rí^ p^ p^ p V	! V P                  P                  VP                  RVR 4      P                  RVR 4      V P                  V P                  P                  V
R7      p \        P                  ! 4       pV EFÆ  w  pp\        V\        4      '       d   VP                  pVeº   VP                   V8”  d©   VP#                  4       w  ppVP%                  4        VP'                  V4       VV,          pVV,          pV^,          pV	! VP(                  VP                  RVR 4      P                  RVR 4      V P                  V P                  P                  V
R7      p \+        V4      ^8X  d   VP-                  V4       MVP/                  V4        \+        V4      V8X  d   VP'                  \+        V4      4       MVV;;,          \+        V4      ,          uu&   V\+        V4      ,          p\        P                  ! 4       V\:        P<                  ,           8”  g   EK¨  \        P                  ! 4       pVRV3x € ^ pEKÉ  	  VRV3x € V^,           pV^,           pVP#                  4       w  ppVP%                  4        VP'                  V4       VV,          pVV,          pTR	TTTP(                  TTTT33x € R# u uppi   \0         d>   p\2        P4                  ! TT P                  P6                  TT P8                  R7      hRp?ii ; i  TRT3x € T^,           pT^,           pTP#                  4       w  ppTP%                  4        TP'                  T4       TT,          pTT,          pi ; i  \>         dY   p\        T\@        4      '       d   TPB                  e   TPB                  p\        T\D        4      '       d   h \E        R4      ThRp?ii ; i5i)r  rH  rI  rJ  rz  N)Ú
cast_errorrÎ   r2  r³   Fr|  TrJ   )#r‘   rY   r·   rF   r¥  r   r   r±   r²   rÛ   rÅ   rç   rµ   r}  r  r  r~  r  r€  rD  r�  r’   Ú	write_rowÚwrite_tabler4   r    Úfrom_cast_errorrÎ   r³   r   r…  r†  r   r‡  r!   )r[   r2  r1  rd  re  r3  rd   r€   rˆ  r‰  r{  r\  r^  rq  rr  rM  r  rŠ  r‹  rŒ  r*  ÚtablerX  r{  r´  rs  ra  r®  s   &&&&&&                      rQ   rY  Ú'ArrowBasedBuilder._prepare_split_single   s  é € ð T^×ScÑScÔSeÔfÑSeÉ4È1�a¬J°q¼$×,?Ò,?œ aœÀQÒFÑSeˆ
ÑfØ×)Ò)Ñ7¨JÑ7ˆ	Ø(3°yÔ(@•}ÄkˆØ'¨9Ñ4ÐØˆØ!#ÐØ./°˜OàˆØÐØ'(Ð$ð?	bÙ!ØŸ™×+Ñ+Ø—]‘] 7¨x¸¨nÓ>×FÑFÀwÐSYÐZ]ÐR^Ó`Ø"&×"9Ñ"9Ø $§¡× 8Ñ 8Ø"3ôˆFð0-ÜŸ	š	›�Ü"+‘J�C˜Ü! #¤s×+Ò+Ø,/×,AÑ,AÐ)Ø%Ò1°f×6GÑ6GÈ.Ô6XØ28·/±/Ó2CÑ/˜ iØŸ™œØ%×,Ñ,¨\Ô:Ø*¨lÕ:Ð*Ø'¨9Õ4˜Ø  A�˜Ù!-Ø%+×%5Ñ%5Ø!&§¡¨w¸8ÀC¸.Ó!J×!RÑ!RÐSZÐ_eÐfiÐ^jÓ!lØ.2×.EÑ.EØ,0¯H©H×,DÑ,DØ.?ô"˜ðÜ˜u›:¨œ?Ø"×,Ñ,¨UÕ3à"×.Ñ.¨uÕ5ô Ð1Ó2Ð6GÔGØ.×5Ñ5´c¸%³jÕAà.Ð/@×AÄSÈÃZÕOÓAØ0´C¸³JÕ>Ð0Ü—y’y“{ U¬V×-NÑ-NÕ%N×NÜ $§	¢	£˜Ø$ eÐ-IÐIÒIØ78Ó4ñK #,ðN ˜eÐ%AÐAÒAØ%¨�\�
Ø&7¸!Õ&;Ð#Ø*0¯/©/Ó*;Ñ'�˜iØ—‘”Ø×$Ñ$ \Ô2Ø" lÕ2Ð"Ø 9Õ,�ð Øà"ØØ× Ñ ØØØ#Ø&ðð
ô 	
ùóY gøôV %ô Ü8×HÒHØ'1Ø)-¯©×)?Ñ)?Ø'1Ø"&§*¡*ô	ð ûðûð" ˜eÐ%AÐAÒAØ%¨�\�
Ø&7¸!Õ&;Ð#Ø*0¯/©/Ó*;Ñ'�˜iØ—‘”Ø×$Ñ$ \Ô2Ø" lÕ2Ð"Ø 9Õ,‘ûÜô 	bä˜!Ô1×2Ò2°q·}±}Ò7PØ—M‘M�Ü˜!Ô3×4Ò4ØÜ(Ð)YÓZÐ`aÐaûð	büsˆ   ‚Q–/L?Á:QÂ A#O4 Ã$C=N Ç"!MÈN ÈMÈBN Ê##N ËAO4 Ì% QÍNÍ8NÎNÎN ÎA!O1Ï1O4 Ï4QÏ?AQÑQÑQc                ó&   <€ V ^8„  d   QhRS[ RS[/# rþ  rÿ  )ru   rv   s   "€rQ   rw   rž  ]  s   ø€ ÷ 
ñ 
Áð 
ÑScñ 
rP   c           	     ór   € \        V P                  VP                  \        V R R4      V P                  R7      # )r—  N)rû  r˜  Úsleep_on_threads_shutdown)r)   r¥  r2  rb   r  r  s   &&rQ   ró  Ú2ArrowBasedBuilder._get_examples_iterable_for_split]  s7   € Ü$Ø×!Ñ!Ø"×-Ñ-Ü$+¨DÐ2MÈtÓ$TØ&*×&EÑ&Eô	
ð 	
rP   rJ   r  )rK   rL   rM   rN   r§   r  r  r  r¥  r§  rY  ró  rO   r©   rª   s   @rQ   rœ  rœ  7  sP   ø‡ € Ùk÷$ð $ð( 	×Ñ÷$ó ð$÷([*ò [*÷z[
ð [
÷z
ö 
rP   rœ  c                   ó†   a € ] tR tRt o ]P
                  V 3R lR l4       tV 3R lR ltV 3R lR ltV 3R lR	 lt	R
t
V tR# )Ú_CountableBuilderMixinif  c                ó0   <€ V ^8„  d   QhRS[ S[,          /# rö   )r   r~   )ru   rv   s   "€rQ   rw   Ú#_CountableBuilderMixin.__annotate__h  s   ø€ ÷ $ñ $±(¹3µ-ñ $rP   c                ó   € \        4       hra   rQ  r  s   &,rQ   Ú_generate_num_examplesÚ-_CountableBuilderMixin._generate_num_examplesg  s   € ä!Ó#Ð#rP   c                ó<   <€ V ^8„  d   QhRS[ RS[S[S[3,          /# )ro   rè   rr   )r   rs   rt   r~   )ru   rv   s   "€rQ   rw   rÁ  k  s'   ø€ ÷ uñ u©ð u¹TÁ#ÁsÀ(½^ñ urP   c                óª   € V P                  / 4      pV P                  ! V3/ VB pV Uu/ uF  qDP                  V P                  V4      bK   	  up# u upi ra   )r¡  r¢  rW   Ú_count_examples)r[   rè   r«  r¬  r­  s   &&   rQ   Úcount_examplesÚ%_CountableBuilderMixin.count_examplesk  sY   € Ø"&×"DÑ"DÀRÓ"HÐØ15×1GÒ1GÈ
Ñ1nÐVmÑ1nÐÙcsÓtÑcsÐP_×$Ñ$ d×&:Ñ&:¸?Ó&KÒKÑcsÑtÐtùÒts   ©$Ac                ó&   <€ V ^8„  d   QhRS[ RS[/# rþ  )r1   r~   )ru   rv   s   "€rQ   rw   rÁ  p  s   ø€ ÷ 	
ñ 	
©~ð 	
Á#ñ 	
rP   c           	     óÔ   € \        ^ \        P                  ! 4       ^,           4      p\        \	        V P
                  \        VP                  V4      ^RVP                   2R7      4      # )é    zCounting rows for split=)Údelayr0  )	Úminr‹   Ú	cpu_countr‘  r   Ú_count_examples_singlerE   r2  rW   )r[   r­  rU  s   && rQ   rÇ  Ú&_CountableBuilderMixin._count_examplesp  s[   € Ü˜"œbŸlšl›n¨qÕ0Ó1ˆÜÜØ×+Ñ+Ü! /×"<Ñ"<¸kÓJØØ/°×0DÑ0DÐ/EÐFô	ó
ð 	
rP   c                ó<   <€ V ^8„  d   QhRS[ S[S[3,          RS[/# )ro   r2  rr   )rs   rt   r   r~   )ru   rv   s   "€rQ   rw   rÁ  {  s#   ø€ ÷ >ñ >±±c¹3°hµð >ÁCñ >rP   c                ó8   € \        V P                  ! R/ VB 4      # )NrJ   )r‘  rÃ  )r[   r2  s   &&rQ   rÐ  Ú-_CountableBuilderMixin._count_examples_single{  s   € Ü�4×.Ò.Ñ<°Ñ<Ó=Ð=rP   rJ   N)rK   rL   rM   rN   r  r  rÃ  rÈ  rÇ  rÐ  rO   r©   rª   s   @rQ   r¿  r¿  f  s=   ø‡ € Ø×Ñ÷$ó ð$÷uð u÷
	
ð 	
÷>ö >rP   r¿  )�r§   r  rˆ  r‰   rÇ   r‹   rÒ   rr  r}  r…   Úcollections.abcr   Údataclassesr   Ú	functoolsr   Úpathlibr   Útypingr   r   r   r	   Úunittest.mockr
   rå   Úpyarrowr¢  Úfsspec.corer   Úmultiprocessr   Útqdm.contrib.concurrentr   rh  r   r   Úarrow_datasetr   Úarrow_readerr   r   Úarrow_writerr   r   r   rX   r   r   r   Údataset_dictr   r   Údownload.download_configr   Údownload.download_managerr   r   Ú#download.streaming_download_managerr   r   Ú
exceptionsr    r!   r"   r²   r#   Úfilesystemsr$   r%   rÑ  r&   r±   r(   Úiterable_datasetr)   r*   r+   r,   Únamingr-   r.   r’  r/   r0   r1   r2   Ú	streamingr3   r¸  r4   r5   r6   rW  Úutils._filelockr7   Úutils.file_utilsr8   Úutils.info_utilsr9   r:   r;   Úutils.py_utilsr<   r=   r>   r?   r@   rA   rB   rC   Úutils.shardingrD   rE   Úutils.trackrF   ÚloadrG   Ú
get_loggerrK   rß   rZ   rI   rS   r¬   r  r  rœ  r¿  rJ   rP   rQ   Ú<module>ró     sd  ðñ  !ã 
Û Û Û Û 	Û Û Û Û Ý $Ý !Ý Ý ß 6Ó 6Ý ã Û Ý !Ý Ý .ç Ý "÷÷ KÑ Jß OÑ Oß :Ý 4ß Dß Pß [Ñ [Ý ÷õ  Ý ÷ó ÷ Oß ?Ó ?Ý ;Ý Ý Ý "Ý %Ý +ß OÑ O÷	÷ 	ó 	÷ OÝ %÷ Ý#ð 
×	Ò	˜HÓ	%€ô	˜
ô 	ð ÷nRð nRó ðnR÷bW$ñ W$ðt  ÷Dð Dó ðDô{
˜Nô {
ô|	l
˜ô l
ô^	>˜^ö >rP   