Sexy.Utils (Sexy v0.10.0)

Utility functions used across Sexy: query parsing, number formatting, UUID compression, and struct conversion.

Query format

Sexy uses a compact query format for Telegram callback data:

"/command key1=value1-key2=value2-key3=value3"

Values are automatically parsed as integers, floats, or booleans when possible.

Examples

iex> Sexy.Utils.get_query("/buy id=42-amount=9.99-gift=true")
%{id: 42, amount: 9.99, gift: true}

iex> Sexy.Utils.stringify_query(%{id: 42, page: 1})
"id=42-page=1"

iex> Sexy.Utils.fiat_chunk(1234567, 0)
"1 234 567"

Summary

Functions

fiat_chunk(val, dec)

Format a number with thousands separators (space-separated groups).

get_and_avoid_nil(map, key, default)

Get a value from a map, falling back to default if the key is missing or nil.

get_query(string)

Parse a command string and extract query parameters.

normalize_uuid(compact)

Expand a Base62-compressed UUID back to the standard xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx format.

split_query(query_string)

Parse a query string in "key=val-key=val" format into an atom-keyed map.

stringify_query(query)

Convert an atom-keyed map back to a "key=val-key=val" query string.

stringify_uuid(uuid)

Compress a UUID string into a short Base62 representation.

strip(map)

Recursively convert string keys to atoms and structs to plain maps.

Functions

fiat_chunk(val, dec)

@spec fiat_chunk(number(), non_neg_integer()) :: String.t()

Format a number with thousands separators (space-separated groups).

Examples

iex> Sexy.Utils.fiat_chunk(1234567, 0)
"1 234 567"

iex> Sexy.Utils.fiat_chunk(1234.5, 2)
"1 234.50"

get_and_avoid_nil(map, key, default)

@spec get_and_avoid_nil(map(), atom(), term()) :: term()

Get a value from a map, falling back to default if the key is missing or nil.

Unlike Map.get/3, this also replaces explicit nil values with the default.

get_query(string)

@spec get_query(String.t()) :: map()

Parse a command string and extract query parameters.

Returns an empty map if no parameters are present.

Examples

iex> Sexy.Utils.get_query("/buy id=42-page=1")
%{id: 42, page: 1}

iex> Sexy.Utils.get_query("/start")
%{}

normalize_uuid(compact)

@spec normalize_uuid(String.t()) :: String.t()

Expand a Base62-compressed UUID back to the standard xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx format.

Example

iex> Sexy.Utils.normalize_uuid("2aUyqjCzEIiEcYMKj7TZtw")
"550e8400-e29b-41d4-a716-446655440000"

split_query(query_string)

@spec split_query(String.t() | nil) :: map()

Parse a query string in "key=val-key=val" format into an atom-keyed map.

Values may contain - (negative numbers, UUIDs, dates): a - splits pairs only when followed by a key= sequence. The character sequence -<key>= inside a value is reserved as the pair separator; = in values is not supported.

Examples

iex> Sexy.Utils.split_query("id=42-name=hello")
%{id: 42, name: "hello"}

iex> Sexy.Utils.split_query("id=-1001234-page=2")
%{id: -1001234, page: 2}

iex> Sexy.Utils.split_query(nil)
%{}

stringify_query(query)

@spec stringify_query(map()) :: String.t()

Convert an atom-keyed map back to a "key=val-key=val" query string.

Example

iex> Sexy.Utils.stringify_query(%{id: 42, page: 1})
"id=42-page=1"

stringify_uuid(uuid)

@spec stringify_uuid(String.t()) :: String.t()

Compress a UUID string into a short Base62 representation.

Example

iex> Sexy.Utils.stringify_uuid("550e8400-e29b-41d4-a716-446655440000")
"2aUyqjCzEIiEcYMKj7TZtw"

strip(map)

@spec strip(map() | struct() | list() | term()) :: map() | list() | term()

Recursively convert string keys to atoms and structs to plain maps.

Used internally to normalize Telegram API responses and TDLib JSON before processing.