Nf.Gravatar (neo_faker v0.4.4)

View Source

Provides functions for generating random Gravatar URLs.

This module is based on the Gravatar API documentation.

Summary

Types

email()

Email address

Functions

display(email \\ nil, opts \\ [])

Generates a Gravatar URL from an email address.

Types

email()

(since 0.3.1) 
@type email() :: String.t() | nil

Email address

Functions

display(email \\ nil, opts \\ [])

(since 0.3.1) 
@spec display(email(), Keyword.t()) :: String.t()

Generates a Gravatar URL from an email address.

The generated URL includes query parameters for image size and fallback options. If no email address is provided, a random one is used.

Options

The following options are available:

  • :size - Defines the image size.
  • :fallback - Specifies the default fallback image.

:size

Defines the image size.

  • nil (default) - Uses 80px.
  • integer - The image size in pixels (valid range: 1 to 2048).

:fallback

Specifies the default fallback image.

  • nil (default) - Uses "identicon".
  • :identicon - Generates an "identicon".
  • :monsterid - Generates a "monsterid".
  • :wavatar - Generates a "wavatar".
  • :robohash - Generates a "robohash".

Examples 

iex> Nf.Gravatar.display()
"https://gravatar.com/avatar/836f82db99121b3481011f16b49dfa5fbc714a0d1b1b9f784a1ebbbf5b39577f?d=identicon&s=80"

iex> Nf.Gravatar.display("john.doe@example.com")
"https://gravatar.com/avatar/836f82db99121b3481011f16b49dfa5fbc714a0d1b1b9f784a1ebbbf5b39577f?d=identicon&s=80"

iex> Nf.Gravatar.display("john.doe@example.com", size: 100)
"https://gravatar.com/avatar/836f82db99121b3481011f16b49dfa5fbc714a0d1b1b9f784a1ebbbf5b39577f?d=identicon&s=100"

iex> Nf.Gravatar.display("john.doe@example.com", fallback: "monsterid")
"https://gravatar.com/avatar/836f82db99121b3481011f16b49dfa5fbc714a0d1b1b9f784a1ebbbf5b39577f?d=monsterid&s=80"