require Logger defmodule ExoSQL.Builtins do @moduledoc """ Builtin functions. There are two categories, normal functions and aggregate functions. Aggregate functions receive as first parameter a ExoSQL.Result with a full table, and the rest of parameters are the function calling parameters, unsolved. These expressions must be first simplified with `ExoSQL.executor.simplify_expr_columns` and then executed on the rows with `ExoSQL.Expr.run_expr`. """ import ExoSQL.Utils, only: [to_number: 1, to_float: 1] @functions %{ "round" => {ExoSQL.Builtins, :round}, "concat" => {ExoSQL.Builtins, :concat}, "not" => {ExoSQL.Builtins, :not_}, "if" => {ExoSQL.Builtins, :if_}, "bool" => {ExoSQL.Builtins, :bool}, "lower" => {ExoSQL.Builtins, :lower}, "upper" => {ExoSQL.Builtins, :upper}, "to_string" => {ExoSQL.Builtins, :to_string}, "to_datetime" => {ExoSQL.Builtins, :to_datetime}, "to_timestamp" => {ExoSQL.Builtins, :to_timestamp}, "substr" => {ExoSQL.Builtins, :substr}, "now" => {ExoSQL.Builtins, :now}, "strftime" => {ExoSQL.Builtins, :strftime}, "format" => {ExoSQL.Builtins, :format}, ## Aggregates "count" => {ExoSQL.Builtins, :count}, "sum" => {ExoSQL.Builtins, :sum}, "avg" => {ExoSQL.Builtins, :avg}, "max" => {ExoSQL.Builtins, :max}, "min" => {ExoSQL.Builtins, :min}, } def call_function(name, args) do case @functions[name] do nil -> raise BadFunctionError, {:builtin, name} {mod, fun} -> apply(mod, fun, args) end end def round(n, r) do {:ok, n} = to_float(n) {:ok, r} = to_number(r) Float.round(n, r) end def concat(a, b) do a = to_string(a) b = to_string(b) a <> b end def not_(a) do not bool(a) end def if_(cond_, then_, else_ \\ nil) do if cond_ do then_ else else_ end end def bool(nil), do: false def bool(0), do: false def bool(""), do: false def bool(false), do: false def bool(_), do: true def lower(s), do: String.downcase(s) def upper(s), do: String.upcase(s) def to_string_(%DateTime{} = d), do: DateTime.to_iso8601(d) def to_string_(s), do: to_string(s) def now(), do: DateTime.utc_now() def to_datetime(other), do: ExoSQL.DateTime.to_datetime(other) def to_timestamp(%DateTime{} = d), do: DateTime.to_unix(d) def substr(nil, _skip, _len) do "" end def substr(str, skip, len) do str = to_string_(str) # force string {:ok, skip} = to_number(skip) {:ok, len} = to_number(len) if len < 0 do String.slice(str, skip, String.length(str) + len - skip) else String.slice(str, skip, len) end end def substr(str, skip) do substr(str, skip, 10_000) # A upper limit on what to return, should be enought end @doc ~S""" Convert datetime to string. If no format is given, it is as to_string, which returns the ISO 8601. Format allows all substitutions from [Timex.format](https://hexdocs.pm/timex/Timex.Format.DateTime.Formatters.Strftime.html), for example: %d day of month: 00 %H hour: 00-24 %m month: 01-12 %M minute: 00-59 %s seconds since 1970-01-01 %S seconds: 00-59 %Y year: 0000-9999 %i ISO 8601 format %V Week number %% % """ def strftime(%DateTime{} = d), do: to_string_(d) def strftime(%DateTime{} = d, format), do: ExoSQL.DateTime.strftime(d, format) def strftime(other, format), do: strftime(to_datetime(other), format) @doc ~S""" sprintf style formatting. Uses exprintf. """ def format(str, args) when is_list(args) do ExoSQL.Format.format(str, args) end @doc ~S""" Very simple sprintf formatter. Knows this formats: * %% * %s * %d * %f (only two decimals) * %.{ndec}f """ def format(str, arg1), do: format(str, [arg1]) def format(str, arg1, arg2), do: format(str, [arg1, arg2]) def format(str, arg1, arg2, arg3), do: format(str, [arg1, arg2, arg3]) def format(str, arg1, arg2, arg3, arg4), do: format(str, [arg1, arg2, arg3, arg4]) def format(str, arg1, arg2, arg3, arg4, arg5), do: format(str, [arg1, arg2, arg3, arg4, arg5]) def format(str, arg1, arg2, arg3, arg4, arg5, arg6), do: format(str, [arg1, arg2, arg3, arg4, arg5, arg6]) def format(str, arg1, arg2, arg3, arg4, arg5, arg6, arg7), do: format(str, [arg1, arg2, arg3, arg4, arg5, arg6, arg7]) def format(str, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8), do: format(str, [arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8]) def format(str, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9), do: format(str, [arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9]) ### Aggregate functions def is_aggregate("count"), do: true def is_aggregate("avg"), do: true def is_aggregate("sum"), do: true def is_aggregate(_other), do: false def count(data, _) do # Logger.debug("Count #{inspect data}") Enum.count(data.rows) end def avg(data, expr) do # Logger.debug("Avg of #{inspect data} by #{inspect expr}") sum(data, expr) / count(data, nil) end def sum(data, expr) do # Logger.debug("Sum of #{inspect data} by #{inspect expr}") expr = ExoSQL.Executor.simplify_expr_columns(expr, data.columns, nil) # Logger.debug("Simplified expression #{inspect expr}") Enum.reduce(data.rows, 0, fn row, acc -> n = ExoSQL.Expr.run_expr(expr, row) {:ok, n} = ExoSQL.Utils.to_number(n) acc + n end) end def max(data, expr) do expr = ExoSQL.Executor.simplify_expr_columns(expr, data.columns, nil) Enum.reduce(data.rows, nil, fn row, acc -> n = ExoSQL.Expr.run_expr(expr, row) {:ok, n} = ExoSQL.Utils.to_number(n) if not acc or n > acc do n else acc end end) end def min(data, expr) do expr = ExoSQL.Executor.simplify_expr_columns(expr, data.columns, nil) Enum.reduce(data.rows, nil, fn row, acc -> n = ExoSQL.Expr.run_expr(expr, row) {:ok, n} = ExoSQL.Utils.to_number(n) if not acc or n < acc do n else acc end end) end end