Descargar kaggle_downloader_package - kaggle_downloader

kaggle_downloader_package

Código Fuente de IA

1.0.0

Descargar

Kaggdownloader

KaggleDownloader es una clase de Python diseñada para interactuar con Kaggle, lo que permite a los usuarios autenticar, buscar, descargar y extraer conjuntos de datos. La clase se puede usar tanto interactivamente en los cuadernos Jupyter o a través de la línea de comandos.

Requisitos previos

Antes de usar la clase KaggleDownloader , asegúrese de tener:

Un token API de Kaggle, disponible en su cuenta de Kaggle en "API" (https://www.kaggle.com/settings).
Python 3.x instalado.

Sección 1: Uso de KaggleDownloader en un cuaderno de Jupyter

Puede importar y usar KaggleDownloader directamente dentro de un cuaderno Jupyter. A continuación se muestra una guía paso a paso para autenticar y descargar conjuntos de datos utilizando los métodos de clase.

1.1 Código de ejemplo

 import kaggle_downloader as kd  # Assuming you've saved the class in kaggle_downloader.py
import pandas as pd

# Initialize KaggleDownloader
downloader = kd . KaggleDownloader ( api_token_path = "./kaggle.json" )

# Authenticate with Kaggle API
downloader . authenticate_kaggle ()

# Search for datasets related to a theme
downloader . search_datasets ( "netflix" )

# Download a specific dataset by its slug
downloader . download_dataset ( "shivamb/netflix-shows" )

df = pd . read_csv ( "./netflix_titles.csv" , delimiter = ',' , encoding = "utf-8" , encoding_errors = "replace" )
df . head ()

1.2 Métodos disponibles

get_api_token_path() : Devuelve la ruta al archivo de token API Kaggle primario.
get_alternative_token_path() : Devuelve la ruta al archivo de token API Kaggle alternativo.
get_path_downloads() : Devuelve la ruta de directorio de descarga.
set_api_token_path(new_path) : establece una nueva ruta para el token de la API Kaggle.
set_alternative_token_path(new_path) : establece una nueva ruta para el token API Kaggle alternativo.
set_path_downloads(new_path) : establece una nueva ruta para conjuntos de datos descargados.
authenticate_kaggle() : Authentices con la API de Kaggle cargando credenciales desde el archivo token.
authenticate_with_credentials() : solicita al usuario que ingrese manualmente las credenciales de Kaggle y las guarde en un archivo.
search_datasets(dataset_theme) : busca Kaggle para conjuntos de datos que coincidan con una palabra clave o tema determinado.
download_dataset(dataset_slug) : descarga un conjunto de datos de Kaggle al directorio especificado.
extract_zip(zip_file) : extrae un archivo zip descargado al directorio de descarga.
check_kaggle_json() : verifica si el archivo de token de la API Kaggle existe en la ruta primaria o alternativa.
create_download_directory(path) : crea el directorio donde se guardarán los conjuntos de datos, si aún no existe.

Sección 2: Uso de KaggleDownloader a través de la interfaz de línea de comandos (CLI)

Alternativamente, puede usar la clase KaggleDownloader a través de la línea de comando. El método main() permite a los usuarios ejecutar la clase y descargar conjuntos de datos especificando el conjunto de datos como argumento.

2.1 Ejemplo de uso de CLI

Primero, asegúrese de que su script sea ejecutable:
```
chmod +x kaggle_downloader.py
```

Use el siguiente comando para descargar un conjunto de datos de Kaggle:

python kaggle_downloader_package/kaggle_downloader.py benroshan/ecommerce-data

Esto se autenticará con Kaggle (basado en su archivo token kaggle.json ) y descargará el conjunto de datos al directorio especificado en path_downloads (o el directorio de trabajo actual de forma predeterminada).

2.2 Argumentos de CLI

dataset_slug : el identificador de conjunto de datos Kaggle (Slug) que desea descargar, por ejemplo, benroshan/ecommerce-data .

Notas

Asegúrese de tener un token de Kaggle API en su lugar ( kaggle.json ).
Puede especificar rutas de token alternativas en caso de que no se use la predeterminada.
Si prefiere cargar manualmente su nombre de usuario y clave de Kaggle, nuestro KaggleDownloader los solicitará, ya que no puede encontrar el archivo Kaggle.json.
Grandes conjuntos de datos se desabrocharán automáticamente si se descargan como archivos zip.
La interfaz CLI analizará los argumentos e invocará las funciones necesarias para una experiencia perfecta.

Personalización:

Reemplace kaggle_downloader.py con el nombre de archivo real si es diferente.
Ajuste la ruta de importación de clase ( from kaggle_downloader import KaggleDownloader ) si organiza su código de manera diferente.