# FastAPI Gravatar

***

**1. Get Gravatar URL**

```python
from fastapi_gravatar import gravatar_url_for

email = "john.doe@example.com"
url = gravatar_url_for(email)  # https://www.gravatar.com/avatar/{hash}?s={size}&d={default}
```

**2. Get Gravatar URL with Custom Size**

```python
url = gravatar_url_for(email, size=200)  # https://www.gravatar.com/avatar/{hash}?s=200&d={default}
```

**3. Get Gravatar URL with Custom Default Image**

```python
url = gravatar_url_for(email, default="identicon")  # https://www.gravatar.com/avatar/{hash}?s={size}&d=identicon
```

**4. Get Gravatar Image as Bytes**

```python
from fastapi_gravatar import Gravatar

gravatar = Gravatar(email)
image_bytes = gravatar.get_image()
```

**5. Get Gravatar Image as PIL Image**

```python
from fastapi_gravatar import Gravatar

gravatar = Gravatar(email)
image = gravatar.get_image_as_pil()
```

**6. Get Gravatar Image as Numpy Array**

```python
from fastapi_gravatar import Gravatar

gravatar = Gravatar(email)
image_array = gravatar.get_image_as_array()
```

**7. Get Gravatar Image as SVG**

```python
from fastapi_gravatar import Gravatar

gravatar = Gravatar(email)
svg = gravatar.get_image_as_svg()
```

**8. Get Gravatar Image as JSON**

```python
from fastapi_gravatar import Gravatar

gravatar = Gravatar(email)
json = gravatar.get_image_as_json()
```

**9. Check if Gravatar Image Exists**

```python
from fastapi_gravatar import Gravatar

gravatar = Gravatar(email)
exists = gravatar.exists()
```

**10. Get Gravatar Image for Multiple Emails**

```python
from fastapi_gravatar import Gravatar

emails = ["john.doe@example.com", "jane.doe@example.com"]
gravatars = [Gravatar(email) for email in emails]
```

**11. Get Gravatar Images as Async**

```python
import asyncio

async def get_gravatar_images(emails):
    gravatars = [Gravatar(email) for email in emails]
    tasks = [gravatar.get_image() for gravatar in gravatars]
    return await asyncio.gather(*tasks)
```

**12. Use Default Gravatar Image**

```python
from fastapi_gravatar import Gravatar

gravatar = Gravatar(email, default="monsterid")  # https://www.gravatar.com/avatar/{hash}?s={size}&d=monsterid
```

**13. Use Gravatar Secure URL**

```python
from fastapi_gravatar import Gravatar

gravatar = Gravatar(email, secure=True)  # https://secure.gravatar.com/avatar/{hash}?s={size}&d={default}
```

**14. Specify Gravatar Rating**

```python
from fastapi_gravatar import Gravatar

gravatar = Gravatar(email, rating="g")  # https://www.gravatar.com/avatar/{hash}?s={size}&d={default}&r=g
```

**15. Get Gravatar URL for Multiple Emails**

```python
from fastapi_gravatar import gravatar_url_for_multiple

emails = ["john.doe@example.com", "jane.doe@example.com"]
urls = gravatar_url_for_multiple(emails)  # [{"email": "john.doe@example.com", "url": "..."}, {"email": "jane.doe@example.com", "url": "..."}]
```

**16. Get Gravatar URL with Custom Default Image for Multiple Emails**

```python
urls = gravatar_url_for_multiple(emails, default="monsterid")  # [{"email": "john.doe@example.com", "url": "..."}, {"email": "jane.doe@example.com", "url": "..."}]
```

**17. Get Gravatar URL with Custom Size for Multiple Emails**

```python
urls = gravatar_url_for_multiple(emails, size=200)  # [{"email": "john.doe@example.com", "url": "..."}, {"email": "jane.doe@example.com", "url": "..."}]
```

**18. Get Gravatar URL with Custom Rating for Multiple Emails**

```python
urls = gravatar_url_for_multiple(emails, rating="g")  # [{"email": "john.doe@example.com", "url": "..."}, {"email": "jane.doe@example.com", "url": "..."}]
```

**19. Get Gravatar URL with Custom Secure Setting for Multiple Emails**

```python
urls = gravatar_url_for_multiple(emails, secure=True)  # [{"email": "john.doe@example.com", "url": "..."}, {"email": "jane.doe@example.com", "url": "..."}]
```

**20. Get Gravatar Image as Bytes for Multiple Emails**

```python
from fastapi_gravatar import Gravatar

gravatars = [Gravatar(email) for email in emails]
images = [gravatar.get_image() for gravatar in gravatars]
```

**21. Get Gravatar Image as PIL Image for Multiple Emails**

```python
from fastapi_gravatar import Gravatar

gravatars = [Gravatar(email) for email in emails]
images = [gravatar.get_image_as_pil() for gravatar in gravatars]
```

**22. Get Gravatar Image as Numpy Array for Multiple Emails**

```python
from fastapi_gravatar import Gravatar

gravatars = [Gravatar(email) for email in emails]
images = [gravatar.get_image_as_array() for gravatar in gravatars]
```

**23. Get Gravatar Image as SVG for Multiple Emails**

```python
from fastapi_gravatar import Gravatar

gravatars = [Gravatar(email) for email in emails]
svgs = [gravatar.get_image_as_svg() for gravatar in gravatars]
```

**24. Get Gravatar Image as JSON for Multiple Emails**

```python
from fastapi_gravatar import Gravatar

gravatars = [Gravatar(email) for email in emails]
jsons = [gravatar.get_image_as_json() for gravatar in gravatars]
```

**25. Check if Gravatar Image Exists for Multiple Emails**

```python
from fastapi_gravatar import Gravatar

gravatars = [Gravatar(email) for email in emails]
exists = [gravatar.exists() for gravatar in gravatars]
```

**26. Get Gravatar URL for Multiple Emails with Async**

```python
import asyncio

async def get_gravatar_urls(emails):
    gravatars = [Gravatar(email) for email in emails]
    tasks = [gravatar.get_image_url() for gravatar in gravatars]
    return await asyncio.gather(*tasks)
```

**27. Get Gravatar Image as Bytes for Multiple Emails with Async**

```python
import asyncio

async def get_gravatar_images(emails):
    gravatars = [Gravatar(email) for email in emails]
    tasks = [gravatar.get_image() for gravatar in gravatars]
    return await asyncio.gather(*tasks)
```

**28. Get Gravatar Image as PIL Image for Multiple Emails with Async**

```python
import asyncio

async def get_gravatar_images_as_pil(emails):
    gravatars = [Gravatar(email) for email in emails]
    tasks = [gravatar.get_image_as_pil() for gravatar in gravatars]
    return await asyncio.gather(*tasks)
```

**29. Get Gravatar Image as Numpy Array for Multiple Emails with Async**

```python
import asyncio

async def get_gravatar_images_as_array(emails):
    gravatars = [Gravatar(email) for email in emails]
    tasks = [gravatar.get_image_as_array() for gravatar in gravatars]
    return await asyncio.gather(*tasks)
```

**30. Get Gravatar Image as SVG for Multiple Emails with Async**