
    h                     "    S SK Jr  S SKrSS jrg)    )PathNc           
         [        U 5      nUR                  5       (       d  [        SU 35      eUR                  R	                  5       nUS:X  a   Uc  Sn[
        R                  " USUS9$ US	:X  a   Uc  Sn[
        R                  " X!S
9$ US:X  aC  / SQnU H  n [
        R                  " X&S9s  $    [        SUSSSSR                  U5       35      e[        SU S35      e! [         a  n[        SU SU 35      eSnAff = f! [         a  n[        SU SU 35      eSnAff = f! [         a     M  [         a  n[        SU SU 35      eSnAff = f)u  
Lee un archivo de datos (.csv, .xls, .xlsx) y lo devuelve como un DataFrame de Pandas.

Parámetros:
-----------
ruta_archivo : str o Path
    Ruta completa al archivo que deseas leer.
    
hoja : int, str o None, opcional (solo aplica para archivos Excel)
    - Si es un número entero (0, 1, 2...), selecciona la hoja por posición.
    - Si es una cadena, selecciona la hoja por nombre.
    - Si es None (por defecto), se carga la primera hoja.

Retorna:
--------
pd.DataFrame
    El contenido del archivo cargado como DataFrame.

Excepciones:
------------
FileNotFoundError
    Si el archivo no existe en la ruta proporcionada.

ValueError
    Si el archivo tiene una extensión no soportada o no puede ser leído.

UnicodeDecodeError
    Si el archivo CSV no puede ser leído con ninguna codificación común.

Ejemplo:
# Leer CSV (automáticamente prueba varias codificaciones)
df_csv = leer_archivo("datos.csv")

# Leer Excel, primera hoja por defecto
df_xlsx = leer_archivo("datos.xlsx")

# Leer Excel, segunda hoja (por posición)
df_hoja2 = leer_archivo("datos.xlsx", hoja=1)

# Leer Excel, por nombre de hoja
df_hoja_named = leer_archivo("datos.xlsx", hoja="Resumen")

Datos:
Si quieres ver las hojas disponibles en un archivo Excel, puedes usar el siguiente código:
import pandas as pd
ruta = 'Base de datos/Ventas con creditos/Mazatlan-Ventas-historicas-creditos.xlsx'
hojas_disponibles = pd.ExcelFile(ruta).sheet_names
print("Hojas disponibles:", hojas_disponibles)

u   El archivo no se encontró: z.xlsNr   xlrd)engine
sheet_namez!No se pudo leer el archivo .xls: z
Error: z.xlsx)r   z"No se pudo leer el archivo .xlsx: z.csv)zutf-8z
ISO-8859-1latin1cp1252)encodingu0   Error inesperado al leer CSV con codificación 'z': leer_archivoz7No se pudo leer el archivo CSV con las codificaciones: z, z"Formato de archivo no soportado: 'z%'. Solo se permiten .csv, .xls, .xlsx)r   existsFileNotFoundErrorsuffixlowerpd
read_excel	Exception
ValueErrorread_csvUnicodeDecodeErrorjoin)ruta_archivohojaruta	extensioneencodings_a_probarencs          OC:\Users\julio\OneDrive\Documentos\Trabajo\Ideas Frescas\Funciones\Funciones.pyr   r      s   f D;;==">tf EFF!!#I F	U|==fFF
 
g		V|==77 
f	H%Ca{{466 & !D!QEdiiPbFcEde
 	
 =i[Hmnoo=  	U@iPQsSTT	U  	VA$yQRPSTUU	V &  a #STWSXX[\][^!_``asN   C# 2D D)#
D-C>>D
D&D!!D&)
E6	E?EE)N)pathlibr   pandasr   r        r   <module>r#      s     ^pr"   