> ## Documentation Index
> Fetch the complete documentation index at: https://jmail.world/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# JmailClient

> Costruttore e configurazione di JmailClient

## Costruttore

```python theme={null}
JmailClient(cache=True)
```

Crea una nuova istanza del client.

### Parametri

**cache** `bool` (default: True)

Abilita la memorizzazione nella cache locale dei file tramite ETag in `~/.cache/jmail/`. Imposta a `False` per scaricare sempre dati nuovi.

### Esempio

```python theme={null}
from jmail import JmailClient

# Predefinito: cache abilitata
client = JmailClient()

# Nessuna cache
client = JmailClient(cache=False)
```

## Metodi

| Method | Returns | Description |
| - | - | - |
| [`manifest()`](https://jmail.world/docs/it/api-reference/jmail-client#manifest) | `dict` | Manifest dell'API con metadati del dataset |
| [`emails(slim)`](https://jmail.world/docs/it/api-reference/emails) | `DataFrame` | Archivio di email |
| [`documents(include_text)`](https://jmail.world/docs/it/api-reference/documents) | `DataFrame` | Metadati e testo dei documenti |
| [`photos()`](https://jmail.world/docs/it/api-reference/photos) | `DataFrame` | Metadati delle foto |
| [`people()`](https://jmail.world/docs/it/api-reference/people) | `DataFrame` | Persone identificate |
| [`photo_faces()`](https://jmail.world/docs/it/api-reference/photo-faces) | `DataFrame` | Riquadri di delimitazione dei volti |
| [`imessage_conversations()`](https://jmail.world/docs/it/api-reference/imessages) | `DataFrame` | Conversazioni iMessage |
| [`imessage_messages()`](https://jmail.world/docs/it/api-reference/imessages) | `DataFrame` | Messaggi iMessage |
| [`star_counts()`](https://jmail.world/docs/it/api-reference/star-counts) | `DataFrame` | Conteggi delle stelle crowd-sourced |
| [`release_batches()`](https://jmail.world/docs/it/api-reference/release-batches) | `DataFrame` | Informazioni sui lotti di rilascio |
| [`url(dataset, fmt)`](https://jmail.world/docs/it/api-reference/jmail-client#url) | `str` | URL grezzo del dataset |

## `manifest()`

Recupera il manifest dell'API con i metadati dei dataset e i relativi checksum.

```python theme={null}
manifest = client.manifest()
print(manifest)
```

**Restituisce:** `dict` -- JSON analizzato proveniente da `data.jmail.world/v1/manifest.json`

## `url(dataset, fmt="parquet")`

Recupera l'URL diretto del file del dataset. Utile da passare direttamente a DuckDB, Polars o a qualsiasi strumento che legga file Parquet tramite HTTP.

```python theme={null}
url = client.url("emails-slim")
# "https://data.jmail.world/v1/emails-slim.parquet"

url = client.url("documents", fmt="ndjson.gz")
# "https://data.jmail.world/v1/documents.ndjson.gz"
```

**dataset** `str` *required*

Nome del dataset. Uno dei seguenti: `emails`, `emails-slim`, `documents`, `photos`, `people`, `photo_faces`, `imessage_conversations`, `imessage_messages`, `star_counts`, `release_batches`.

**fmt** `str` (default: parquet)

Formato del file. Può essere `parquet` oppure `ndjson.gz`.

**Restituisce:** `str` -- URL completo


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.