nitro.erl 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481
  1. -module(nitro).
  2. %%-author('Maxim Sokhatsky').
  3. -include_lib("nitro/include/cx.hrl").
  4. -include_lib("nitro/include/nitro.hrl").
  5. -include_lib("nitro/include/event.hrl").
  6. -export([atom/1, q/1, q/2, qc/1, qc/2,
  7. config/3, pickle/1, depickle/1, unique_integer/0, temp_id/0,
  8. script/0, script/1, state/1, state/2,
  9. redirect/1, cookie_expire/1, cookie/2, cookie/3, cookies/0, cookie/1,
  10. f/1, f/2, coalesce/1,
  11. to_list/1, to_atom/1, to_binary/1, to_integer/1,
  12. join/2, replace/3, indexof/2, indexof/3, append/3, os_env/1, os_env/2,
  13. prolongate/0, authenticate/2,
  14. render/1, wire/1, hex/1, unhex/1, js_escape/1, js_escape/2,
  15. html_encode/1, html_encode/2, url_encode/1, url_decode/1,
  16. update/2, insert_top/2, insert_top/3, insert_bottom/2, insert_bottom/3,
  17. insert_before/2, insert_after/2, insert_adjacent/3, insert_adjacent/4,
  18. clear/1, remove/1, setAttr/3, style/2, style/3, display/2, show/1, hide/1,
  19. compact/1, meg/1, num/1 ]).
  20. atom(List) when erlang:is_list(List) ->
  21. string:join([ ?MODULE:to_list(L) || L <- List], "_");
  22. atom(Scalar) -> ?MODULE:to_list(Scalar).
  23. q(Key) -> q(Key, []). %% todo unwrap
  24. q(Key, Def) -> case get(Key) of undefined -> Def; Val -> Val end.
  25. qc(Key) -> CX = get(context), qc(Key,CX#cx.req).
  26. qc(Key, Req) -> proplists:get_value(?MODULE:to_binary(Key),cowboy_req:parse_qs(Req)).
  27. config(App, Key, Default) -> application:get_env(App, Key, Default).
  28. %% Convert and Utils API
  29. f(S) -> f(S, []).
  30. f(S, Args) -> lists:flatten(io_lib:format(S, Args)).
  31. coalesce({_, Y}) -> Y;
  32. coalesce(false) -> undefined;
  33. coalesce([]) -> undefined;
  34. coalesce([H]) -> H;
  35. coalesce([undefined|T]) -> coalesce(T);
  36. coalesce([[]|T]) -> coalesce(T);
  37. coalesce([H|_]) -> H.
  38. %% to_list to_atom to_binary to_integer
  39. -define(IS_STRING(Term),
  40. (erlang:is_list(Term) andalso Term /= [] andalso erlang:is_integer(hd(Term)))).
  41. to_list(L) when ?IS_STRING(L) -> L;
  42. to_list(L) when erlang:is_list(L) ->
  43. SubLists = [inner_to_list(X) || X <- L],
  44. lists:flatten(SubLists);
  45. to_list(A) -> inner_to_list(A).
  46. inner_to_list(A) when erlang:is_atom(A) -> erlang:atom_to_list(A);
  47. inner_to_list(B) when erlang:is_binary(B) -> erlang:binary_to_list(B);
  48. inner_to_list(I) when erlang:is_integer(I) -> erlang:integer_to_list(I);
  49. inner_to_list(L) when erlang:is_tuple(L) -> lists:flatten(io_lib:format("~p", [L]));
  50. inner_to_list(L) when erlang:is_list(L) -> L;
  51. inner_to_list(F) when erlang:is_float(F) -> erlang:float_to_list(F, [{decimals, 9}, compact]).
  52. to_atom(A) when erlang:is_atom(A) -> A;
  53. to_atom(B) when erlang:is_binary(B) -> erlang:binary_to_atom(B);
  54. to_atom(I) when erlang:is_integer(I) -> to_atom(erlang:integer_to_list(I));
  55. to_atom(F) when erlang:is_float(F) -> to_atom(erlang:float_to_list(F, [{decimals, 9}, compact]));
  56. to_atom(L) when erlang:is_list(L) -> erlang:list_to_atom(L).
  57. to_binary(A) when erlang:is_atom(A) -> erlang:atom_to_binary(A, latin1);
  58. to_binary(B) when erlang:is_binary(B) -> B;
  59. to_binary(I) when erlang:is_integer(I) -> erlang:integer_to_binary(I);
  60. to_binary(F) when erlang:is_float(F) -> erlang:float_to_binary(F, [{decimals, 9}, compact]);
  61. to_binary(L) when erlang:is_list(L) -> erlang:iolist_to_binary(L);
  62. to_binary(X) when erlang:is_tuple(X) -> erlang:term_to_binary(X).
  63. to_integer(A) when erlang:is_atom(A) -> ?MODULE:to_integer(erlang:atom_to_list(A));
  64. to_integer(B) when erlang:is_binary(B) -> ?MODULE:to_integer(erlang:binary_to_list(B));
  65. to_integer(I) when erlang:is_integer(I) -> I;
  66. to_integer([]) -> 0;
  67. to_integer(L) when erlang:is_list(L) -> erlang:list_to_integer(L);
  68. to_integer(F) when erlang:is_float(F) -> erlang:round(F).
  69. %% JOIN
  70. %% join(List, Delimiter)
  71. join([], _) -> [];
  72. join([Item], _Delim) -> [Item];
  73. join([Item|Items], Delim) ->
  74. [Item, Delim | join(Items, Delim)].
  75. %% replace(String, S1, S2)
  76. replace([], _, _) -> [];
  77. replace(String, S1, S2) when erlang:is_list(String), erlang:is_list(S1), erlang:is_list(S2) ->
  78. Length = erlang:length(S1),
  79. case string:substr(String, 1, Length) of
  80. S1 ->
  81. S2 ++ replace(string:substr(String, Length + 1), S1, S2);
  82. _ ->
  83. [erlang:hd(String) | replace(erlang:tl(String), S1, S2)]
  84. end.
  85. indexof(Key, Fields) -> indexof(Key, Fields, 2).
  86. indexof(_, [], _) -> undefined;
  87. indexof(Key, [Key|_], N) -> N;
  88. indexof(Key, [_|T], N) -> indexof(Key, T, N + 1).
  89. append(List, Key, Value) ->
  90. case Value of
  91. undefined -> List;
  92. _A -> [{Key, Value}|List]
  93. end.
  94. os_env(Key) -> os_env(Key, "").
  95. os_env(Key, Default) ->
  96. case os:getenv(Key) of
  97. false -> Default;
  98. V -> V
  99. end.
  100. -ifndef(PICKLER).
  101. -define(PICKLER, (application:get_env(nitro, pickler, nitro_pickle))).
  102. -endif.
  103. pickle(Data) -> ?PICKLER:pickle(Data).
  104. depickle(SerializedData) -> ?PICKLER:depickle(SerializedData).
  105. prolongate() -> %% todo mv this from nitro
  106. case application:get_env(n2o, session) of
  107. {ok, M} -> M:prolongate();
  108. undefined -> false
  109. end.
  110. authenticate(I, Auth) -> %% todo mv this from nitro
  111. (application:get_env(n2o, session, n2o_session)):authenticate(I, Auth).
  112. render(X) -> wf_render:render(X).
  113. % Wire JavaScript nitro:wire
  114. wire(Actions) -> action_wire:wire(Actions).
  115. unique_integer() -> erlang:unique_integer().
  116. temp_id() -> "auto" ++ erlang:integer_to_list(unique_integer() rem 1000000).
  117. %% Fast HEX
  118. %digit(0) -> $0;
  119. %digit(1) -> $1;
  120. %digit(2) -> $2;
  121. %digit(3) -> $3;
  122. %digit(4) -> $4;
  123. %digit(5) -> $5;
  124. %digit(6) -> $6;
  125. %digit(7) -> $7;
  126. %digit(8) -> $8;
  127. %digit(9) -> $9;
  128. %digit(10) -> $a;
  129. %digit(11) -> $b;
  130. %digit(12) -> $c;
  131. %digit(13) -> $d;
  132. %digit(14) -> $e;
  133. %digit(15) -> $f.
  134. digit(X) when X >= 0 andalso X =< 9 -> X + 48;
  135. digit(X) when X >= 10 andalso X =< 15 -> X + 87.
  136. hex(Bin) ->
  137. << << (digit(A1)), (digit(A2)) >> || <<A1:4, A2:4>> <= Bin >>.
  138. unhex(Hex) ->
  139. << << (erlang:list_to_integer([H1, H2], 16)) >> || <<H1, H2>> <= Hex >>.
  140. %% JavaScript escape
  141. js_escape(undefined) -> [];
  142. js_escape(Value) when erlang:is_list(Value) ->
  143. erlang:binary_to_list( ?MODULE:js_escape( erlang:iolist_to_binary(Value) ) );
  144. js_escape(Value) -> js_escape(Value, <<>>).
  145. js_escape(<<"\\", Rest/binary>>, Acc) -> %"
  146. js_escape(Rest, <<Acc/binary, "\\\\">>); %"
  147. js_escape(<<"\r", Rest/binary>>, Acc) ->
  148. js_escape(Rest, <<Acc/binary, "\\r">>);
  149. js_escape(<<"\n", Rest/binary>>, Acc) ->
  150. js_escape(Rest, <<Acc/binary, "\\n">>);
  151. js_escape(<<"\"", Rest/binary>>, Acc) ->
  152. js_escape(Rest, <<Acc/binary, "\\\"">>);
  153. js_escape(<<"'", Rest/binary>>, Acc) ->
  154. js_escape(Rest, <<Acc/binary, "\\'">>);
  155. js_escape(<<"`", Rest/binary>>, Acc) ->
  156. js_escape(Rest, <<Acc/binary, "\\`">>);
  157. js_escape(<<"<script", Rest/binary>>, Acc) ->
  158. js_escape(Rest, <<Acc/binary, "<script">>);
  159. js_escape(<<"script>", Rest/binary>>, Acc) ->
  160. js_escape(Rest, <<Acc/binary, "script>">>);
  161. js_escape(<<C, Rest/binary>>, Acc) ->
  162. js_escape(Rest, <<Acc/binary, C>>);
  163. js_escape(<<>>, Acc) -> Acc.
  164. %% HTML encode/decode
  165. %% html_encode(B, normal)
  166. html_encode(L, Fun) when erlang:is_function(Fun) ->
  167. Fun(L);
  168. html_encode(L, EncType) when erlang:is_atom(L) ->
  169. html_encode(?MODULE:to_list(L), EncType);
  170. html_encode(L, EncType) when erlang:is_integer(L) ->
  171. html_encode(erlang:integer_to_list(L), EncType);
  172. html_encode(L, EncType) when erlang:is_float(L) ->
  173. html_encode(erlang:float_to_list(L, [{decimals, 9}, compact]), EncType);
  174. html_encode(L, false) ->
  175. L;
  176. html_encode(L, true) ->
  177. L;
  178. html_encode(L, whites) ->
  179. html_encode_whites(?MODULE:to_list(lists:flatten([L]))).
  180. html_encode(<<>>) ->
  181. [];
  182. html_encode([]) ->
  183. [];
  184. html_encode(B) when is_binary(B) ->
  185. ?MODULE:to_binary(
  186. html_encode(erlang:binary_to_list(B))
  187. );
  188. html_encode([$\n |T]) ->
  189. "<br>" ++ html_encode(T);
  190. html_encode([H|T]) ->
  191. case H of
  192. $< -> "&lt;" ++ html_encode(T);
  193. $> -> "&gt;" ++ html_encode(T);
  194. $" -> "&quot;" ++ html_encode(T);
  195. $' -> "&#39;" ++ html_encode(T);
  196. $& -> "&amp;" ++ html_encode(T);
  197. $\\ -> "&#92;" ++ html_encode(T);
  198. BigNum when erlang:is_integer(BigNum) andalso BigNum > 255 ->
  199. %% Any integers above 255 are converted to their HTML encode equivalent
  200. %% Example: 7534 gets turned into &#7534;
  201. [$&, $# | ?MODULE:to_list(BigNum)] ++ ";" ++ html_encode(T);
  202. Tup when erlang:is_tuple(Tup) ->
  203. erlang:throw({html_encode, encountered_tuple, Tup});
  204. _ ->
  205. [H|html_encode(T)]
  206. end.
  207. html_encode_whites([]) -> [];
  208. html_encode_whites([H|T]) ->
  209. case H of
  210. $\s -> "&nbsp;" ++ html_encode_whites(T);
  211. $\t -> "&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;" ++ html_encode_whites(T);
  212. $< -> "&lt;" ++ html_encode_whites(T);
  213. $> -> "&gt;" ++ html_encode_whites(T);
  214. $" -> "&quot;" ++ html_encode_whites(T);
  215. $' -> "&#39;" ++ html_encode_whites(T);
  216. $& -> "&amp;" ++ html_encode_whites(T);
  217. $\n -> "<br>" ++ html_encode_whites(T);
  218. $\\ -> "&#92;" ++ html_encode_whites(T);
  219. _ -> [H|html_encode_whites(T)]
  220. end.
  221. %% URL encode/decode
  222. -define(PERCENT, 37). % $\%
  223. -define(FULLSTOP, 46). % $\.
  224. -define(IS_HEX(C), ((C >= $0 andalso C =< $9) orelse
  225. (C >= $a andalso C =< $f) orelse
  226. (C >= $A andalso C =< $F))).
  227. -define(QS_SAFE(C), ((C >= $a andalso C =< $z) orelse
  228. (C >= $A andalso C =< $Z) orelse
  229. (C >= $0 andalso C =< $9) orelse
  230. (C =:= ?FULLSTOP orelse C =:= $- orelse
  231. C =:= $~ orelse C =:= $_))).
  232. url_encode(Atom) when erlang:is_atom(Atom) ->
  233. url_encode(erlang:atom_to_list(Atom));
  234. url_encode(Int) when erlang:is_integer(Int) ->
  235. url_encode(erlang:integer_to_list(Int));
  236. url_encode(Bin) when erlang:is_binary(Bin) ->
  237. url_encode(erlang:binary_to_list(Bin));
  238. url_encode(String) ->
  239. url_encode(String, []).
  240. url_encode([], Acc) ->
  241. lists:reverse(Acc);
  242. url_encode([C | Rest], Acc) when ?QS_SAFE(C) ->
  243. url_encode(Rest, [C | Acc]);
  244. url_encode([$\s | Rest], Acc) ->
  245. url_encode(Rest, [$+ | Acc]);
  246. url_encode([C | Rest], Acc) ->
  247. <<Hi:4, Lo:4>> = <<C>>,
  248. url_encode(Rest, [digit(Lo), digit(Hi), ?PERCENT | Acc]).
  249. url_decode(Binary) when erlang:is_binary(Binary) ->
  250. url_decode(erlang:binary_to_list(Binary));
  251. url_decode(String) -> url_decode_h(lists:reverse(String)).
  252. unhexdigit(C) when C >= $0, C =< $9 ->
  253. C - $0;
  254. unhexdigit(C) when C >= $a, C =< $f ->
  255. C - $a + 10;
  256. unhexdigit(C) when C >= $A, C =< $F ->
  257. C - $A + 10.
  258. url_decode_h(S) -> url_decode_h(S, []).
  259. url_decode_h([], Acc) -> Acc;
  260. url_decode_h([$+ | Rest], Acc) ->
  261. url_decode_h(Rest, [$\s | Acc]);
  262. url_decode_h([Lo, Hi, ?PERCENT | Rest], Acc) when ?IS_HEX(Lo), ?IS_HEX(Hi) ->
  263. url_decode_h(Rest, [(unhexdigit(Lo) bor (unhexdigit(Hi) bsl 4)) | Acc]);
  264. url_decode_h([C | Rest], Acc) -> url_decode_h(Rest, [C | Acc]).
  265. script() -> get(script).
  266. script(Script) -> put(script, Script).
  267. %% Update DOM nitro:update
  268. update(Target, Elements) ->
  269. nitro:wire(#jq{target = Target, property = outerHTML, right = Elements, format = "`~s`"}).
  270. insert_top(Tag, Target, Elements) ->
  271. {Render, _Ref, Actions} = render_html(Elements),
  272. nitro:wire(nitro:f(
  273. "qi('~s').insertBefore("
  274. "(function(){var div = qn('~s'); div.innerHTML = `~s`; return div.firstChild; })(),"
  275. "qi('~s').firstChild);",
  276. [Target, Tag, Render, Target])),
  277. nitro:wire(nitro:render(Actions)).
  278. insert_bottom(Tag, Target, Elements) ->
  279. {Render, _Ref, Actions} = render_html(Elements),
  280. nitro:wire(nitro:f(
  281. "(function(){ var div = qn('~s'); div.innerHTML = `~s`;"
  282. "qi('~s').appendChild(div.firstChild); })();",
  283. [Tag, Render, Target])),
  284. nitro:wire(nitro:render(Actions)).
  285. insert_before(Target, Elements) -> insert_adjacent(beforebegin, Target, Elements).
  286. insert_after(Target, Elements) -> insert_adjacent(afterend, Target, Elements).
  287. insert_adjacent(Command, Target, Elements) ->
  288. insert_adjacent(Command, Target, Elements, "qi").
  289. insert_adjacent(Command, Target, Elements, Q) ->
  290. {Render, _Ref, Actions} = render_html(Elements),
  291. nitro:wire(nitro:f("~s('~s').insertAdjacentHTML('~s', `~s`);", [Q, Target, Command, Render])),
  292. nitro:wire(nitro:render(Actions)).
  293. render_html(Elements) ->
  294. Pid = erlang:self(),
  295. Ref = erlang:make_ref(),
  296. erlang:spawn(fun() ->
  297. R = nitro:render(Elements),
  298. Pid ! {R, Ref, erlang:get(actions)}
  299. end),
  300. {Render, Ref, Actions} = receive {_, Ref, _} = A -> A end,
  301. {Render, Ref, Actions}.
  302. insert_top(Target, Elements) when erlang:element(1, Elements) == tr ->
  303. insert_top(tbody, Target, Elements);
  304. insert_top(Target, Elements) ->
  305. insert_top('div', Target, Elements).
  306. insert_bottom(Target, Elements) when erlang:element(1, Elements) == tr ->
  307. insert_bottom(tbody, Target, Elements);
  308. insert_bottom(Target, Elements) ->
  309. insert_bottom('div', Target, Elements).
  310. clear(Target) ->
  311. nitro:wire("var x = qi('" ++ ?MODULE:to_list(Target) ++ "');"
  312. "while(x && x.firstChild) x.removeChild(x.firstChild);").
  313. remove(Target) ->
  314. nitro:wire("var x = qi('" ++ ?MODULE:to_list(Target) ++ "');"
  315. "x && x.parentNode.removeChild(x);").
  316. %% Wire JavaScript nitro:wire
  317. state(Key) -> erlang:get(Key).
  318. state(Key,Value) -> erlang:put(Key, Value).
  319. %% Redirect and purge connection nitro:redirect
  320. redirect(Url) -> nitro:wire(#jq{target = 'window', property = location, args = simple, right = Url}).
  321. %header(K,V) -> nitro:context((?CTX)#cx{req = cowboy_req:set_resp_header(K, V, ?CTX#cx.req)}).
  322. setAttr(Element, Attr, Value) ->
  323. nitro:wire("{ var x = qi('" ++ ?MODULE:to_list(Element) ++ "');"
  324. "if(x) x.setAttribute('" ++ ?MODULE:to_list(Attr) ++ "', '" ++ ?MODULE:to_list(Value) ++ "'); }").
  325. style(Element, Style) ->
  326. setAttr(Element, "style", Style).
  327. style(Element, Style, Value) ->
  328. nitro:wire("{ var x = qi('" ++ ?MODULE:to_list(Element) ++ "');"
  329. "if(x) x.style." ++ ?MODULE:to_list(Style) ++ " = '" ++ ?MODULE:to_list(Value) ++ "'; }").
  330. display(Element, Status) -> style(Element, "display", Status).
  331. show(Element) -> display(Element, block).
  332. hide(Element) -> display(Element, none).
  333. compact([]) -> "[]";
  334. compact("\n") -> "[]";
  335. compact([X|_] = Y) when erlang:is_tuple(X) ->
  336. [ compact(F) || F <- Y ];
  337. compact(Bin) when erlang:is_binary(Bin) ->
  338. unicode:characters_to_binary(Bin);
  339. compact(Tuple) when erlang:is_tuple(Tuple) ->
  340. Min = erlang:min(9, erlang:size(Tuple)),
  341. Fields = lists:zip(lists:seq(1, Min),
  342. lists:sublist(erlang:tuple_to_list(Tuple), 1, Min)),
  343. "{" ++ string:join([ io_lib:format("~s", [compact(F)]) || {_, F} <- Fields ], ",") ++ "}";
  344. compact(T) ->
  345. ?MODULE:js_escape(?MODULE:to_list(T)).
  346. meg(X) -> erlang:integer_to_list(X div 1000000) ++ "M".
  347. num(S) -> case lists:reverse(S) of
  348. [$K|K] -> erlang:list_to_integer(lists:reverse(K)) * 1000;
  349. [$M|M] -> erlang:list_to_integer(lists:reverse(M)) * 1000 * 1000;
  350. [$G|G] -> erlang:list_to_integer(lists:reverse(G)) * 1000 * 1000 * 1000;
  351. [$T|T] -> erlang:list_to_integer(lists:reverse(T)) * 1000 * 1000 * 1000 * 1000
  352. end.
  353. cookie_expire(SecondsToLive) ->
  354. Seconds = calendar:datetime_to_gregorian_seconds(calendar:local_time()),
  355. DateTime = calendar:gregorian_seconds_to_datetime(Seconds + SecondsToLive),
  356. cow_date:rfc2109(DateTime).
  357. cookie(Id, Value) -> cookie(Id, Value, 2147483647). %% expire never
  358. cookie(Id, Value, Expire) ->
  359. Format = "document.cookie='~s=~s; path=/; expires=~s';",
  360. nitro:wire(?MODULE:f(Format, [?MODULE:to_list(Id), ?MODULE:to_list(Value), cookie_expire(Expire)])).
  361. cookies() -> cowboy_req:parse_cookies((erlang:get(context))#cx.req).
  362. cookie(Key) ->
  363. case lists:keyfind(Key, 1, cowboy_req:parse_cookies((erlang:get(context))#cx.req)) of
  364. false -> undefined;
  365. {_, Value} -> Value
  366. end.