erlang.mk 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844
  1. # Copyright (c) 2013-2014, Loïc Hoguin <essen@ninenines.eu>
  2. #
  3. # Permission to use, copy, modify, and/or distribute this software for any
  4. # purpose with or without fee is hereby granted, provided that the above
  5. # copyright notice and this permission notice appear in all copies.
  6. #
  7. # THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  8. # WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  9. # MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  10. # ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  11. # WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  12. # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  13. # OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  14. .PHONY: all deps app rel docs tests clean distclean help erlang-mk
  15. ERLANG_MK_VERSION = 1
  16. # Core configuration.
  17. PROJECT ?= $(notdir $(CURDIR))
  18. PROJECT := $(strip $(PROJECT))
  19. # Verbosity.
  20. V ?= 0
  21. gen_verbose_0 = @echo " GEN " $@;
  22. gen_verbose = $(gen_verbose_$(V))
  23. # Core targets.
  24. all:: deps app rel
  25. clean::
  26. $(gen_verbose) rm -f erl_crash.dump
  27. distclean:: clean
  28. help::
  29. @printf "%s\n" \
  30. "erlang.mk (version $(ERLANG_MK_VERSION)) is distributed under the terms of the ISC License." \
  31. "Copyright (c) 2013-2014 Loïc Hoguin <essen@ninenines.eu>" \
  32. "" \
  33. "Usage: [V=1] make [target]" \
  34. "" \
  35. "Core targets:" \
  36. " all Run deps, app and rel targets in that order" \
  37. " deps Fetch dependencies (if needed) and compile them" \
  38. " app Compile the project" \
  39. " rel Build a release for this project, if applicable" \
  40. " docs Build the documentation for this project" \
  41. " tests Run the tests for this project" \
  42. " clean Delete temporary and output files from most targets" \
  43. " distclean Delete all temporary and output files" \
  44. " help Display this help and exit" \
  45. "" \
  46. "The target clean only removes files that are commonly removed." \
  47. "Dependencies and releases are left untouched." \
  48. "" \
  49. "Setting V=1 when calling make enables verbose mode."
  50. # Core functions.
  51. ifeq ($(shell which wget 2>/dev/null | wc -l), 1)
  52. define core_http_get
  53. wget --no-check-certificate -O $(1) $(2)|| rm $(1)
  54. endef
  55. else
  56. define core_http_get
  57. erl -noshell -eval 'ssl:start(), inets:start(), case httpc:request(get, {"$(2)", []}, [{autoredirect, true}], []) of {ok, {{_, 200, _}, _, Body}} -> case file:write_file("$(1)", Body) of ok -> ok; {error, R1} -> halt(R1) end; {error, R2} -> halt(R2) end, halt(0).'
  58. endef
  59. endif
  60. # Automated update.
  61. ERLANG_MK_BUILD_CONFIG ?= build.config
  62. ERLANG_MK_BUILD_DIR ?= .erlang.mk.build
  63. erlang-mk:
  64. git clone https://github.com/ninenines/erlang.mk $(ERLANG_MK_BUILD_DIR)
  65. if [ -f $(ERLANG_MK_BUILD_CONFIG) ]; then cp $(ERLANG_MK_BUILD_CONFIG) $(ERLANG_MK_BUILD_DIR); fi
  66. cd $(ERLANG_MK_BUILD_DIR) && make
  67. cp $(ERLANG_MK_BUILD_DIR)/erlang.mk ./erlang.mk
  68. rm -rf $(ERLANG_MK_BUILD_DIR)
  69. # Copyright (c) 2013-2014, Loïc Hoguin <essen@ninenines.eu>
  70. # This file is part of erlang.mk and subject to the terms of the ISC License.
  71. .PHONY: distclean-deps distclean-pkg pkg-list pkg-search
  72. # Configuration.
  73. DEPS_DIR ?= $(CURDIR)/deps
  74. export DEPS_DIR
  75. REBAR_DEPS_DIR = $(DEPS_DIR)
  76. export REBAR_DEPS_DIR
  77. ALL_DEPS_DIRS = $(addprefix $(DEPS_DIR)/,$(DEPS))
  78. ifeq ($(filter $(DEPS_DIR),$(subst :, ,$(ERL_LIBS))),)
  79. ifeq ($(ERL_LIBS),)
  80. ERL_LIBS = $(DEPS_DIR)
  81. else
  82. ERL_LIBS := $(ERL_LIBS):$(DEPS_DIR)
  83. endif
  84. endif
  85. export ERL_LIBS
  86. PKG_FILE2 ?= $(CURDIR)/.erlang.mk.packages.v2
  87. export PKG_FILE2
  88. PKG_FILE_URL ?= https://raw.githubusercontent.com/ninenines/erlang.mk/master/packages.v2.tsv
  89. # Core targets.
  90. deps:: $(ALL_DEPS_DIRS)
  91. @for dep in $(ALL_DEPS_DIRS) ; do \
  92. if [ -f $$dep/GNUmakefile ] || [ -f $$dep/makefile ] || [ -f $$dep/Makefile ] ; then \
  93. $(MAKE) -C $$dep ; \
  94. else \
  95. echo "include $(CURDIR)/erlang.mk" | ERLC_OPTS=+debug_info $(MAKE) -f - -C $$dep ; \
  96. fi ; \
  97. done
  98. distclean:: distclean-deps distclean-pkg
  99. # Deps related targets.
  100. define dep_fetch
  101. if [ "$$$$VS" = "git" ]; then \
  102. git clone -n -- $$$$REPO $(DEPS_DIR)/$(1); \
  103. cd $(DEPS_DIR)/$(1) && git checkout -q $$$$COMMIT; \
  104. elif [ "$$$$VS" = "hg" ]; then \
  105. hg clone -U $$$$REPO $(DEPS_DIR)/$(1); \
  106. cd $(DEPS_DIR)/$(1) && hg update -q $$$$COMMIT; \
  107. else \
  108. echo "Unknown or invalid dependency: $(1). Please consult the erlang.mk README for instructions." >&2; \
  109. exit 78; \
  110. fi
  111. endef
  112. define dep_target
  113. $(DEPS_DIR)/$(1):
  114. @mkdir -p $(DEPS_DIR)
  115. ifeq (,$(dep_$(1)))
  116. @if [ ! -f $(PKG_FILE2) ]; then $(call core_http_get,$(PKG_FILE2),$(PKG_FILE_URL)); fi
  117. @DEPPKG=$$$$(awk 'BEGIN { FS = "\t" }; $$$$1 == "$(1)" { print $$$$2 " " $$$$3 " " $$$$4 }' $(PKG_FILE2);); \
  118. VS=$$$$(echo $$$$DEPPKG | cut -d " " -f1); \
  119. REPO=$$$$(echo $$$$DEPPKG | cut -d " " -f2); \
  120. COMMIT=$$$$(echo $$$$DEPPKG | cut -d " " -f3); \
  121. $(call dep_fetch,$(1))
  122. else
  123. @VS=$(word 1,$(dep_$(1))); \
  124. REPO=$(word 2,$(dep_$(1))); \
  125. COMMIT=$(word 3,$(dep_$(1))); \
  126. $(call dep_fetch,$(1))
  127. endif
  128. endef
  129. $(foreach dep,$(DEPS),$(eval $(call dep_target,$(dep))))
  130. distclean-deps:
  131. $(gen_verbose) rm -rf $(DEPS_DIR)
  132. # Packages related targets.
  133. $(PKG_FILE2):
  134. @$(call core_http_get,$(PKG_FILE2),$(PKG_FILE_URL))
  135. pkg-list: $(PKG_FILE2)
  136. @cat $(PKG_FILE2) | awk 'BEGIN { FS = "\t" }; { print \
  137. "Name:\t\t" $$1 "\n" \
  138. "Repository:\t" $$3 "\n" \
  139. "Website:\t" $$5 "\n" \
  140. "Description:\t" $$6 "\n" }'
  141. ifdef q
  142. pkg-search: $(PKG_FILE2)
  143. @cat $(PKG_FILE2) | grep -i ${q} | awk 'BEGIN { FS = "\t" }; { print \
  144. "Name:\t\t" $$1 "\n" \
  145. "Repository:\t" $$3 "\n" \
  146. "Website:\t" $$5 "\n" \
  147. "Description:\t" $$6 "\n" }'
  148. else
  149. pkg-search:
  150. $(error Usage: make pkg-search q=STRING)
  151. endif
  152. ifeq ($(PKG_FILE2),$(CURDIR)/.erlang.mk.packages.v2)
  153. distclean-pkg:
  154. $(gen_verbose) rm -f $(PKG_FILE2)
  155. endif
  156. help::
  157. @printf "%s\n" "" \
  158. "Package-related targets:" \
  159. " pkg-list List all known packages" \
  160. " pkg-search q=STRING Search for STRING in the package index"
  161. # Copyright (c) 2013-2014, Loïc Hoguin <essen@ninenines.eu>
  162. # This file is part of erlang.mk and subject to the terms of the ISC License.
  163. .PHONY: clean-app
  164. # Configuration.
  165. ERLC_OPTS ?= -Werror +debug_info +warn_export_all +warn_export_vars \
  166. +warn_shadow_vars +warn_obsolete_guard # +bin_opt_info +warn_missing_spec
  167. COMPILE_FIRST ?=
  168. COMPILE_FIRST_PATHS = $(addprefix src/,$(addsuffix .erl,$(COMPILE_FIRST)))
  169. ERLC_EXCLUDE ?=
  170. ERLC_EXCLUDE_PATHS = $(addprefix src/,$(addsuffix .erl,$(ERLC_EXCLUDE)))
  171. # Verbosity.
  172. appsrc_verbose_0 = @echo " APP " $(PROJECT).app.src;
  173. appsrc_verbose = $(appsrc_verbose_$(V))
  174. erlc_verbose_0 = @echo " ERLC " $(filter-out $(patsubst %,%.erl,$(ERLC_EXCLUDE)),\
  175. $(filter %.erl %.core,$(?F)));
  176. erlc_verbose = $(erlc_verbose_$(V))
  177. xyrl_verbose_0 = @echo " XYRL " $(filter %.xrl %.yrl,$(?F));
  178. xyrl_verbose = $(xyrl_verbose_$(V))
  179. # Core targets.
  180. app:: erlc-include ebin/$(PROJECT).app
  181. $(eval MODULES := $(shell find ebin -type f -name \*.beam \
  182. | sed "s/ebin\//'/;s/\.beam/',/" | sed '$$s/.$$//'))
  183. @if [ -z "$$(grep -E '^[^%]*{modules,' src/$(PROJECT).app.src)" ]; then \
  184. echo "Empty modules entry not found in $(PROJECT).app.src. Please consult the erlang.mk README for instructions." >&2; \
  185. exit 1; \
  186. fi
  187. $(eval GITDESCRIBE := $(shell git describe --dirty --abbrev=7 --tags --always --first-parent 2>/dev/null || true))
  188. $(appsrc_verbose) cat src/$(PROJECT).app.src \
  189. | sed "s/{modules,[[:space:]]*\[\]}/{modules, \[$(MODULES)\]}/" \
  190. | sed "s/{id,[[:space:]]*\"git\"}/{id, \"$(GITDESCRIBE)\"}/" \
  191. > ebin/$(PROJECT).app
  192. define compile_erl
  193. $(erlc_verbose) erlc -v $(ERLC_OPTS) -o ebin/ \
  194. -pa ebin/ -I include/ $(filter-out $(ERLC_EXCLUDE_PATHS),\
  195. $(COMPILE_FIRST_PATHS) $(1))
  196. endef
  197. define compile_xyrl
  198. $(xyrl_verbose) erlc -v -o ebin/ $(1)
  199. $(xyrl_verbose) erlc $(ERLC_OPTS) -o ebin/ ebin/*.erl
  200. @rm ebin/*.erl
  201. endef
  202. ifneq ($(wildcard src/),)
  203. ebin/$(PROJECT).app::
  204. @mkdir -p ebin/
  205. ebin/$(PROJECT).app:: $(shell find src -type f -name \*.erl) \
  206. $(shell find src -type f -name \*.core)
  207. $(if $(strip $?),$(call compile_erl,$?))
  208. ebin/$(PROJECT).app:: $(shell find src -type f -name \*.xrl) \
  209. $(shell find src -type f -name \*.yrl)
  210. $(if $(strip $?),$(call compile_xyrl,$?))
  211. endif
  212. clean:: clean-app
  213. # Extra targets.
  214. erlc-include:
  215. -@if [ -d ebin/ ]; then \
  216. find include/ src/ -type f -name \*.hrl -newer ebin -exec touch $(shell find src/ -type f -name "*.erl") \; 2>/dev/null || printf ''; \
  217. fi
  218. clean-app:
  219. $(gen_verbose) rm -rf ebin/
  220. # Copyright (c) 2014, Loïc Hoguin <essen@ninenines.eu>
  221. # This file is part of erlang.mk and subject to the terms of the ISC License.
  222. .PHONY: bootstrap bootstrap-lib bootstrap-rel new list-templates
  223. # Core targets.
  224. help::
  225. @printf "%s\n" "" \
  226. "Bootstrap targets:" \
  227. " bootstrap Generate a skeleton of an OTP application" \
  228. " bootstrap-lib Generate a skeleton of an OTP library" \
  229. " bootstrap-rel Generate the files needed to build a release" \
  230. " new t=TPL n=NAME Generate a module NAME based on the template TPL" \
  231. " list-templates List available templates"
  232. # Bootstrap templates.
  233. bs_appsrc = "{application, $(PROJECT), [" \
  234. " {description, \"\"}," \
  235. " {vsn, \"0.1.0\"}," \
  236. " {id, \"git\"}," \
  237. " {modules, []}," \
  238. " {registered, []}," \
  239. " {applications, [" \
  240. " kernel," \
  241. " stdlib" \
  242. " ]}," \
  243. " {mod, {$(PROJECT)_app, []}}," \
  244. " {env, []}" \
  245. "]}."
  246. bs_appsrc_lib = "{application, $(PROJECT), [" \
  247. " {description, \"\"}," \
  248. " {vsn, \"0.1.0\"}," \
  249. " {id, \"git\"}," \
  250. " {modules, []}," \
  251. " {registered, []}," \
  252. " {applications, [" \
  253. " kernel," \
  254. " stdlib" \
  255. " ]}" \
  256. "]}."
  257. bs_Makefile = "PROJECT = $(PROJECT)" \
  258. "include erlang.mk"
  259. bs_app = "-module($(PROJECT)_app)." \
  260. "-behaviour(application)." \
  261. "" \
  262. "-export([start/2])." \
  263. "-export([stop/1])." \
  264. "" \
  265. "start(_Type, _Args) ->" \
  266. " $(PROJECT)_sup:start_link()." \
  267. "" \
  268. "stop(_State) ->" \
  269. " ok."
  270. bs_relx_config = "{release, {$(PROJECT)_release, \"1\"}, [$(PROJECT)]}." \
  271. "{extended_start_script, true}." \
  272. "{sys_config, \"rel/sys.config\"}." \
  273. "{vm_args, \"rel/vm.args\"}."
  274. bs_sys_config = "[" \
  275. "]."
  276. bs_vm_args = "-name $(PROJECT)@127.0.0.1" \
  277. "-setcookie $(PROJECT)" \
  278. "-heart"
  279. # Normal templates.
  280. tpl_supervisor = "-module($(n))." \
  281. "-behaviour(supervisor)." \
  282. "" \
  283. "-export([start_link/0])." \
  284. "-export([init/1])." \
  285. "" \
  286. "start_link() ->" \
  287. " supervisor:start_link({local, ?MODULE}, ?MODULE, [])." \
  288. "" \
  289. "init([]) ->" \
  290. " Procs = []," \
  291. " {ok, {{one_for_one, 1, 5}, Procs}}."
  292. tpl_gen_server = "-module($(n))." \
  293. "-behaviour(gen_server)." \
  294. "" \
  295. "%% API." \
  296. "-export([start_link/0])." \
  297. "" \
  298. "%% gen_server." \
  299. "-export([init/1])." \
  300. "-export([handle_call/3])." \
  301. "-export([handle_cast/2])." \
  302. "-export([handle_info/2])." \
  303. "-export([terminate/2])." \
  304. "-export([code_change/3])." \
  305. "" \
  306. "-record(state, {" \
  307. "})." \
  308. "" \
  309. "%% API." \
  310. "" \
  311. "-spec start_link() -> {ok, pid()}." \
  312. "start_link() ->" \
  313. " gen_server:start_link(?MODULE, [], [])." \
  314. "" \
  315. "%% gen_server." \
  316. "" \
  317. "init([]) ->" \
  318. " {ok, \#state{}}." \
  319. "" \
  320. "handle_call(_Request, _From, State) ->" \
  321. " {reply, ignored, State}." \
  322. "" \
  323. "handle_cast(_Msg, State) ->" \
  324. " {noreply, State}." \
  325. "" \
  326. "handle_info(_Info, State) ->" \
  327. " {noreply, State}." \
  328. "" \
  329. "terminate(_Reason, _State) ->" \
  330. " ok." \
  331. "" \
  332. "code_change(_OldVsn, State, _Extra) ->" \
  333. " {ok, State}."
  334. tpl_cowboy_http = "-module($(n))." \
  335. "-behaviour(cowboy_http_handler)." \
  336. "" \
  337. "-export([init/3])." \
  338. "-export([handle/2])." \
  339. "-export([terminate/3])." \
  340. "" \
  341. "-record(state, {" \
  342. "})." \
  343. "" \
  344. "init(_, Req, _Opts) ->" \
  345. " {ok, Req, \#state{}}." \
  346. "" \
  347. "handle(Req, State=\#state{}) ->" \
  348. " {ok, Req2} = cowboy_req:reply(200, Req)," \
  349. " {ok, Req2, State}." \
  350. "" \
  351. "terminate(_Reason, _Req, _State) ->" \
  352. " ok."
  353. tpl_cowboy_loop = "-module($(n))." \
  354. "-behaviour(cowboy_loop_handler)." \
  355. "" \
  356. "-export([init/3])." \
  357. "-export([info/3])." \
  358. "-export([terminate/3])." \
  359. "" \
  360. "-record(state, {" \
  361. "})." \
  362. "" \
  363. "init(_, Req, _Opts) ->" \
  364. " {loop, Req, \#state{}, 5000, hibernate}." \
  365. "" \
  366. "info(_Info, Req, State) ->" \
  367. " {loop, Req, State, hibernate}." \
  368. "" \
  369. "terminate(_Reason, _Req, _State) ->" \
  370. " ok."
  371. tpl_cowboy_rest = "-module($(n))." \
  372. "" \
  373. "-export([init/3])." \
  374. "-export([content_types_provided/2])." \
  375. "-export([get_html/2])." \
  376. "" \
  377. "init(_, _Req, _Opts) ->" \
  378. " {upgrade, protocol, cowboy_rest}." \
  379. "" \
  380. "content_types_provided(Req, State) ->" \
  381. " {[{{<<\"text\">>, <<\"html\">>, '*'}, get_html}], Req, State}." \
  382. "" \
  383. "get_html(Req, State) ->" \
  384. " {<<\"<html><body>This is REST!</body></html>\">>, Req, State}."
  385. tpl_cowboy_ws = "-module($(n))." \
  386. "-behaviour(cowboy_websocket_handler)." \
  387. "" \
  388. "-export([init/3])." \
  389. "-export([websocket_init/3])." \
  390. "-export([websocket_handle/3])." \
  391. "-export([websocket_info/3])." \
  392. "-export([websocket_terminate/3])." \
  393. "" \
  394. "-record(state, {" \
  395. "})." \
  396. "" \
  397. "init(_, _, _) ->" \
  398. " {upgrade, protocol, cowboy_websocket}." \
  399. "" \
  400. "websocket_init(_, Req, _Opts) ->" \
  401. " Req2 = cowboy_req:compact(Req)," \
  402. " {ok, Req2, \#state{}}." \
  403. "" \
  404. "websocket_handle({text, Data}, Req, State) ->" \
  405. " {reply, {text, Data}, Req, State};" \
  406. "websocket_handle({binary, Data}, Req, State) ->" \
  407. " {reply, {binary, Data}, Req, State};" \
  408. "websocket_handle(_Frame, Req, State) ->" \
  409. " {ok, Req, State}." \
  410. "" \
  411. "websocket_info(_Info, Req, State) ->" \
  412. " {ok, Req, State}." \
  413. "" \
  414. "websocket_terminate(_Reason, _Req, _State) ->" \
  415. " ok."
  416. tpl_ranch_protocol = "-module($(n))." \
  417. "-behaviour(ranch_protocol)." \
  418. "" \
  419. "-export([start_link/4])." \
  420. "-export([init/4])." \
  421. "" \
  422. "-type opts() :: []." \
  423. "-export_type([opts/0])." \
  424. "" \
  425. "-record(state, {" \
  426. " socket :: inet:socket()," \
  427. " transport :: module()" \
  428. "})." \
  429. "" \
  430. "start_link(Ref, Socket, Transport, Opts) ->" \
  431. " Pid = spawn_link(?MODULE, init, [Ref, Socket, Transport, Opts])," \
  432. " {ok, Pid}." \
  433. "" \
  434. "-spec init(ranch:ref(), inet:socket(), module(), opts()) -> ok." \
  435. "init(Ref, Socket, Transport, _Opts) ->" \
  436. " ok = ranch:accept_ack(Ref)," \
  437. " loop(\#state{socket=Socket, transport=Transport})." \
  438. "" \
  439. "loop(State) ->" \
  440. " loop(State)."
  441. # Plugin-specific targets.
  442. bootstrap:
  443. ifneq ($(wildcard src/),)
  444. $(error Error: src/ directory already exists)
  445. endif
  446. @printf "%s\n" $(bs_Makefile) > Makefile
  447. @mkdir src/
  448. @printf "%s\n" $(bs_appsrc) > src/$(PROJECT).app.src
  449. @printf "%s\n" $(bs_app) > src/$(PROJECT)_app.erl
  450. $(eval n := $(PROJECT)_sup)
  451. @printf "%s\n" $(tpl_supervisor) > src/$(PROJECT)_sup.erl
  452. bootstrap-lib:
  453. ifneq ($(wildcard src/),)
  454. $(error Error: src/ directory already exists)
  455. endif
  456. @printf "%s\n" $(bs_Makefile) > Makefile
  457. @mkdir src/
  458. @printf "%s\n" $(bs_appsrc_lib) > src/$(PROJECT).app.src
  459. bootstrap-rel:
  460. ifneq ($(wildcard relx.config),)
  461. $(error Error: relx.config already exists)
  462. endif
  463. ifneq ($(wildcard rel/),)
  464. $(error Error: rel/ directory already exists)
  465. endif
  466. @printf "%s\n" $(bs_relx_config) > relx.config
  467. @mkdir rel/
  468. @printf "%s\n" $(bs_sys_config) > rel/sys.config
  469. @printf "%s\n" $(bs_vm_args) > rel/vm.args
  470. new:
  471. ifeq ($(wildcard src/),)
  472. $(error Error: src/ directory does not exist)
  473. endif
  474. ifndef t
  475. $(error Usage: make new t=TEMPLATE n=NAME)
  476. endif
  477. ifndef tpl_$(t)
  478. $(error Unknown template)
  479. endif
  480. ifndef n
  481. $(error Usage: make new t=TEMPLATE n=NAME)
  482. endif
  483. @printf "%s\n" $(tpl_$(t)) > src/$(n).erl
  484. list-templates:
  485. @echo Available templates: $(sort $(patsubst tpl_%,%,$(filter tpl_%,$(.VARIABLES))))
  486. # Copyright (c) 2013-2014, Loïc Hoguin <essen@ninenines.eu>
  487. # This file is part of erlang.mk and subject to the terms of the ISC License.
  488. .PHONY: build-ct-deps build-ct-suites tests-ct clean-ct distclean-ct
  489. # Configuration.
  490. CT_OPTS ?=
  491. ifneq ($(wildcard test/),)
  492. CT_SUITES ?= $(sort $(subst _SUITE.erl,,$(shell find test -type f -name \*_SUITE.erl -exec basename {} \;)))
  493. else
  494. CT_SUITES ?=
  495. endif
  496. TEST_ERLC_OPTS ?= +debug_info +warn_export_vars +warn_shadow_vars +warn_obsolete_guard
  497. TEST_ERLC_OPTS += -DTEST=1 -DEXTRA=1 +'{parse_transform, eunit_autoexport}'
  498. # Core targets.
  499. tests:: tests-ct
  500. clean:: clean-ct
  501. distclean:: distclean-ct
  502. help::
  503. @printf "%s\n" "" \
  504. "All your common_test suites have their associated targets." \
  505. "A suite named http_SUITE can be ran using the ct-http target."
  506. # Plugin-specific targets.
  507. ALL_TEST_DEPS_DIRS = $(addprefix $(DEPS_DIR)/,$(TEST_DEPS))
  508. CT_RUN = ct_run \
  509. -no_auto_compile \
  510. -noshell \
  511. -pa $(realpath ebin) $(DEPS_DIR)/*/ebin \
  512. -dir test \
  513. -logdir logs
  514. $(foreach dep,$(TEST_DEPS),$(eval $(call dep_target,$(dep))))
  515. build-ct-deps: $(ALL_TEST_DEPS_DIRS)
  516. @for dep in $(ALL_TEST_DEPS_DIRS) ; do $(MAKE) -C $$dep; done
  517. build-ct-suites: build-ct-deps
  518. $(gen_verbose) erlc -v $(TEST_ERLC_OPTS) -I include/ -o test/ \
  519. $(wildcard test/*.erl test/*/*.erl) -pa ebin/
  520. tests-ct: ERLC_OPTS = $(TEST_ERLC_OPTS)
  521. tests-ct: clean deps app build-ct-suites
  522. @if [ -d "test" ] ; \
  523. then \
  524. mkdir -p logs/ ; \
  525. $(CT_RUN) -suite $(addsuffix _SUITE,$(CT_SUITES)) $(CT_OPTS) ; \
  526. fi
  527. $(gen_verbose) rm -f test/*.beam
  528. define ct_suite_target
  529. ct-$(1): ERLC_OPTS = $(TEST_ERLC_OPTS)
  530. ct-$(1): clean deps app build-ct-suites
  531. @if [ -d "test" ] ; \
  532. then \
  533. mkdir -p logs/ ; \
  534. $(CT_RUN) -suite $(addsuffix _SUITE,$(1)) $(CT_OPTS) ; \
  535. fi
  536. $(gen_verbose) rm -f test/*.beam
  537. endef
  538. $(foreach test,$(CT_SUITES),$(eval $(call ct_suite_target,$(test))))
  539. clean-ct:
  540. $(gen_verbose) rm -rf test/*.beam
  541. distclean-ct:
  542. $(gen_verbose) rm -rf logs/
  543. # Copyright (c) 2013-2014, Loïc Hoguin <essen@ninenines.eu>
  544. # This file is part of erlang.mk and subject to the terms of the ISC License.
  545. .PHONY: plt distclean-plt dialyze
  546. # Configuration.
  547. DIALYZER_PLT ?= $(CURDIR)/.$(PROJECT).plt
  548. export DIALYZER_PLT
  549. PLT_APPS ?=
  550. DIALYZER_DIRS ?= --src -r src
  551. DIALYZER_OPTS ?= -Werror_handling -Wrace_conditions \
  552. -Wunmatched_returns # -Wunderspecs
  553. # Core targets.
  554. distclean:: distclean-plt
  555. help::
  556. @printf "%s\n" "" \
  557. "Dialyzer targets:" \
  558. " plt Build a PLT file for this project" \
  559. " dialyze Analyze the project using Dialyzer"
  560. # Plugin-specific targets.
  561. $(DIALYZER_PLT): deps app
  562. @dialyzer --build_plt --apps erts kernel stdlib $(PLT_APPS) $(ALL_DEPS_DIRS)
  563. plt: $(DIALYZER_PLT)
  564. distclean-plt:
  565. $(gen_verbose) rm -f $(DIALYZER_PLT)
  566. ifneq ($(wildcard $(DIALYZER_PLT)),)
  567. dialyze:
  568. else
  569. dialyze: $(DIALYZER_PLT)
  570. endif
  571. @dialyzer --no_native $(DIALYZER_DIRS) $(DIALYZER_OPTS)
  572. # Copyright (c) 2013-2014, Loïc Hoguin <essen@ninenines.eu>
  573. # This file is part of erlang.mk and subject to the terms of the ISC License.
  574. .PHONY: distclean-edoc
  575. # Configuration.
  576. EDOC_OPTS ?=
  577. # Core targets.
  578. docs:: distclean-edoc
  579. $(gen_verbose) erl -noshell \
  580. -eval 'edoc:application($(PROJECT), ".", [$(EDOC_OPTS)]), init:stop().'
  581. distclean:: distclean-edoc
  582. # Plugin-specific targets.
  583. distclean-edoc:
  584. $(gen_verbose) rm -f doc/*.css doc/*.html doc/*.png doc/edoc-info
  585. # Copyright (c) 2014, Juan Facorro <juan@inaka.net>
  586. # This file is part of erlang.mk and subject to the terms of the ISC License.
  587. .PHONY: elvis distclean-elvis
  588. # Configuration.
  589. ELVIS_CONFIG ?= $(CURDIR)/elvis.config
  590. ELVIS ?= $(CURDIR)/elvis
  591. export ELVIS
  592. ELVIS_URL ?= https://github.com/inaka/elvis/releases/download/0.2.3/elvis
  593. ELVIS_CONFIG_URL ?= https://github.com/inaka/elvis/releases/download/0.2.3/elvis.config
  594. ELVIS_OPTS ?=
  595. # Core targets.
  596. help::
  597. @printf "%s\n" "" \
  598. "Elvis targets:" \
  599. " elvis Run Elvis using the local elvis.config or download the default otherwise"
  600. ifneq ($(wildcard $(ELVIS_CONFIG)),)
  601. rel:: distclean-elvis
  602. endif
  603. distclean:: distclean-elvis
  604. # Plugin-specific targets.
  605. $(ELVIS):
  606. @$(call core_http_get,$(ELVIS_CONFIG),$(ELVIS_CONFIG_URL))
  607. @$(call core_http_get,$(ELVIS),$(ELVIS_URL))
  608. @chmod +x $(ELVIS)
  609. elvis: $(ELVIS)
  610. @$(ELVIS) rock -c $(ELVIS_CONFIG) $(ELVIS_OPTS)
  611. distclean-elvis:
  612. $(gen_verbose) rm -rf $(ELVIS)
  613. # Copyright (c) 2013-2014, Loïc Hoguin <essen@ninenines.eu>
  614. # This file is part of erlang.mk and subject to the terms of the ISC License.
  615. # Verbosity.
  616. dtl_verbose_0 = @echo " DTL " $(filter %.dtl,$(?F));
  617. dtl_verbose = $(dtl_verbose_$(V))
  618. # Core targets.
  619. define compile_erlydtl
  620. $(dtl_verbose) erl -noshell -pa ebin/ $(DEPS_DIR)/erlydtl/ebin/ -eval ' \
  621. Compile = fun(F) -> \
  622. Module = list_to_atom( \
  623. string:to_lower(filename:basename(F, ".dtl")) ++ "_dtl"), \
  624. erlydtl:compile(F, Module, [{out_dir, "ebin/"}]) \
  625. end, \
  626. _ = [Compile(F) || F <- string:tokens("$(1)", " ")], \
  627. init:stop()'
  628. endef
  629. ifneq ($(wildcard src/),)
  630. ebin/$(PROJECT).app:: $(shell find templates -type f -name \*.dtl 2>/dev/null)
  631. $(if $(strip $?),$(call compile_erlydtl,$?))
  632. endif
  633. # Copyright (c) 2013-2014, Loïc Hoguin <essen@ninenines.eu>
  634. # This file is part of erlang.mk and subject to the terms of the ISC License.
  635. .PHONY: relx-rel distclean-relx-rel distclean-relx
  636. # Configuration.
  637. RELX_CONFIG ?= $(CURDIR)/relx.config
  638. RELX ?= $(CURDIR)/relx
  639. export RELX
  640. RELX_URL ?= https://github.com/erlware/relx/releases/download/v1.0.2/relx
  641. RELX_OPTS ?=
  642. RELX_OUTPUT_DIR ?= _rel
  643. ifeq ($(firstword $(RELX_OPTS)),-o)
  644. RELX_OUTPUT_DIR = $(word 2,$(RELX_OPTS))
  645. else
  646. RELX_OPTS += -o $(RELX_OUTPUT_DIR)
  647. endif
  648. # Core targets.
  649. ifneq ($(wildcard $(RELX_CONFIG)),)
  650. rel:: distclean-relx-rel relx-rel
  651. endif
  652. distclean:: distclean-relx-rel distclean-relx
  653. # Plugin-specific targets.
  654. define relx_fetch
  655. $(call core_http_get,$(RELX),$(RELX_URL))
  656. chmod +x $(RELX)
  657. endef
  658. $(RELX):
  659. @$(call relx_fetch)
  660. relx-rel: $(RELX)
  661. @$(RELX) -c $(RELX_CONFIG) $(RELX_OPTS)
  662. distclean-relx-rel:
  663. $(gen_verbose) rm -rf $(RELX_OUTPUT_DIR)
  664. distclean-relx:
  665. $(gen_verbose) rm -rf $(RELX)
  666. # Copyright (c) 2014, M Robert Martin <rob@version2beta.com>
  667. # This file is contributed to erlang.mk and subject to the terms of the ISC License.
  668. .PHONY: shell
  669. # Configuration.
  670. SHELL_PATH ?= -pa ../$(PROJECT)/ebin $(DEPS_DIR)/*/ebin
  671. SHELL_OPTS ?=
  672. ALL_SHELL_DEPS_DIRS = $(addprefix $(DEPS_DIR)/,$(SHELL_DEPS))
  673. # Core targets
  674. help::
  675. @printf "%s\n" "" \
  676. "Shell targets:" \
  677. " shell Run an erlang shell with SHELL_OPTS or reasonable default"
  678. # Plugin-specific targets.
  679. $(foreach dep,$(SHELL_DEPS),$(eval $(call dep_target,$(dep))))
  680. build-shell-deps: $(ALL_SHELL_DEPS_DIRS)
  681. @for dep in $(ALL_SHELL_DEPS_DIRS) ; do $(MAKE) -C $$dep ; done
  682. shell: build-shell-deps
  683. $(gen_verbose) erl $(SHELL_PATH) $(SHELL_OPTS)