Table of Contents generated with DocToc
- Leiningen ãã©ã°ã€ã³
- ãã©ã°ã€ã³ãæžã
- ã³ãŒãè©äŸ¡
- ä»ã®ãã©ã°ã€ã³ã³ã³ãã³ã
- ãã©ã°ã€ã³ã®åŒã³åºã
- Clojureã®ããŒãžã§ã³
- æ¢åã®ãã©ã°ã€ã³ã®ã¢ããã°ã¬ãŒã
- ãããžã§ã¯ã vs ã¹ã¿ã³ãã¢ãã³ã§ã®å®è¡
- æšæºã¿ã¹ã¯ã®äžæžã
- 1.xäºææ§
- 楜ããã§ãã ãã
Leiningenã®ã¿ã¹ã¯ã¯leiningen.$TASKåå空éã«ãã$TASKãšããååã®é¢æ°ã«éããŸãããã§ããããLeiningenã®ãã©ã°ã€ã³ãèšè¿°ããã®ã¯ãåã«ãã®ãããªé¢æ°ãå«ããããžã§ã¯ããäœãã ãã®ããšã§ãäžèšã®å 容ã®å€ãã¯ãLeiningenãã®ãã®ã«å«ãŸããŠããã¿ã¹ã¯ã«ãåæ§ã«åœãŠã¯ãŸããŸãã
ãã©ã°ã€ã³ã䜿çšããã«ã¯ããããžã§ã¯ããããã®:pluginsã«ãã®ãã©ã°ã€ã³ã宣èšããã ãã§ãããããžã§ã¯ãã®å®è¡çšã§ã¯ãªãã䜿ãåæãåäžããããã©ã°ã€ã³ã¯ãproject.cljãã¡ã€ã«ã«çŽæ¥èšè¿°ãã代ããã«~/.lein/profiles.cljã®:userãããã¡ã€ã«ã«èšè¿°ããŠãã ããã
lein new plugin mypluginã§ãããžã§ã¯ããäœæãããšããããã¯ãããleiningen.mypluginåå空éã®myplugin颿°ãç·šéããŠãã ãããproject.cljå
ã«ãã:eval-in-leningen trueã«ãã£ãŠãã¿ã¹ã¯ã¯ãµãããã»ã¹ã§ã¯ãªããleiningenããã»ã¹å
éšã§åäœããŸãããã©ã°ã€ã³ã¯ãclojureãã®ãã®ãžã®äŸåé¢ä¿ã宣èšããå¿
èŠã¯ãããŸããã
Leiningenæ¬äœã®äŸåé¢ä¿å
šãŠããã©ã°ã€ã³ããå©çšå¯èœã§ãã
éåžžã«åçŽãªãã©ã°ã€ã³ã®äŸãšããŠã ãœãŒã¹ã³ãŒãå
ã®
lein-pprintãã£ã¬ã¯ããªãåç
§ããŠãã ããã
ãã©ã°ã€ã³ã®éçºäžããããžã§ã¯ãå
ã§lein installãåå®è¡ãããããããã¹ããããžã§ã¯ãã«åãæ¿ããã®ã¯éåžžã«æéãããããŸããäžåºŠãã©ã°ã€ã³ãã€ã³ã¹ããŒã«ããã°ããã¹ããããžã§ã¯ãå
ã®.lein-classpathãã¡ã€ã«ã«ããã©ã°ã€ã³ã®srcãã£ã¬ã¯ããªã®ãã¹ãèšè¿°ããŠããããšã§ãã®æéãçãããšãã§ããŸãããã®ãã©ã°ã€ã³ãå¥ã®éçºäžã®ã©ã€ãã©ãªã«äŸåããŠããå Žåã¯ã.lein-classpathã«UNIXã§ã¯:ãWindowsã§ã¯;ã®ã¯ã©ã¹ãã¹ã»ãã¬ãŒã¿ã§åºåã£ãŠã©ã€ãã©ãªã®ãã£ã¬ã¯ããªã远å ããããšãã§ããŸãã
åºåãããå Žåã¯ãprintlnã®ä»£ããã«ãleiningen.core.main/infoãleiningen.core.main/warnãleiningen.core.main/debugã®ããããã䜿çšããŠãã ããããŠãŒã¶ã®åºåèšå®ã®å¶åŸ¡ãé©çšãããŸãã
ã¿ã¹ã¯é¢æ°ã®æåã®åŒæ°ã¯çŸåšã®ãããžã§ã¯ãã«ããŠãã ãããããã¯project.cljãå
ã«ãããããã§ããã:nameã:groupã:versionã:rootãªã©ã®ããŒã远å ãããŠããŸãããã®ãããžã§ã¯ãããããã©ã®ãããªãã®ã確èªããããã«ã¯ãlein-pprintãã©ã°ã€ã³ã䜿ã£ãŠã¿ãŠãã ããããããžã§ã¯ããšããããã¡ã€ã«ã®çµã¿åããã確èªããããã«pprintã¿ã¹ã¯ãå®è¡ããããšãã§ããŸãã
ã³ãã³ãã©ã€ã³ãããã©ã¡ã¿ããšãã¿ã¹ã¯ãå¿
èŠãªå Žåãã²ãšã€ä»¥äžã®åŒæ°ããšã颿°ãäœãããšãã§ããŸããã¿ã¹ã¯ã¯åãªãClojureã®é¢æ°ã§ããããšã匷調ããããã«ãåŒæ°ã¯éåžžãUNIXã®äŒçµ±çãª--dashedã¹ã¿ã€ã«ã§ãªãã:keywordsãåãä»ããããã«èšè¿°ããŸããåŒæ°ã¯å
šãŠStringãšããŠæž¡ãããããšã«çæããŠãã ãããåŒæ°ãããŒã¯ãŒããã·ã³ãã«ãæŽæ°ãšããŠæ±ãããå Žåã«ã¯read-stringãåŒã³åºãããšãã§ããŸãããããã¯ããªããèšè¿°ãã颿°æ¬¡ç¬¬ã§ããä»ã®ã¿ã¹ã¯ã颿°ãšããŠåŒã³åºãéãããã®ç¹ãçæããŠãã ããã
ã»ãšãã©ã®ã¿ã¹ã¯ã¯ãä»ã®ãããžã§ã¯ãã®å
éšã§ã®ã¿å®è¡ãããŸããããã¿ã¹ã¯ãããããžã§ã¯ããã£ã¬ã¯ããªã®å€åŽã§å®è¡ã§ããããã«ãããå Žåã¯ã^:no-project-neededã¡ã¿ããŒã¿ãã¿ã¹ã¯é¢æ°ã«è¿œå ããŠãã ããããã®å Žåã§ãã£ãŠããã¿ã¹ã¯é¢æ°ã®ç¬¬äžåŒæ°ã¯ãããžã§ã¯ãããšãããã«èšè¿°ãããããžã§ã¯ãå€ã§å®è¡ããéã«æž¡ãããnilãåãå
¥ããããã«ããŠãã ããããããžã§ã¯ãå
ã§å®è¡ããå Žåã¯ãLeiningenã¯JVMãèµ·åããåã«ããããžã§ã¯ãã®ã«ãŒããã£ã¬ã¯ãã«cdããŸãããIDE飿ºãªã©ãleiningen-coreã©ã€ãã©ãªã䜿çšããŠããããŒã«ã¯åãããã«ãµããŸããªãå¯èœæ§ãããããããããžã§ã¯ãã®:rootããŒã¯ãŒãã確èªãããã®ãã£ã¬ã¯ããªãèµ·ç¹ãšãããšæå€§éã®ç§»æ€æ§ãåŸãããŸãã
lein helpã¿ã¹ã¯ã¯docstringã䜿ã£ãŠããŸããåå空éã¬ãã«ã®docstringãå®çŸ©ãããŠããã°ããããçããµããªãšããŠäœ¿çšããŸãããªããã°ã颿°ã®docstringã®ç¬¬äžæã䜿çšãããŸãããã©ãŒãããã®éœåäžããµããªã¯68æå以å
ã«åããããã«ããŠãã ããã颿°ã®åŒæ°åã衚瀺ãããã®ã§ãæå¿«ã§èª¬æçãªåŒæ°åãéžã¶ããã«ããŠãã ããããŠãŒã¶ãŒã«èŠããããªã代æ¿ã®åŒæ°ãæã€å Žåã颿°ã®ã¡ã¿ããŒã¿ã«:help-arglistsãèšå®ããããšãã§ããŸãããã®å Žåã¯å
šãŠã®åŒæ°ã«ã€ããŠèª¬æããããã«ããŠãã ãããåŒæ°ã¯å
šãŠStringãªã®ã§ãããŒã¯ãŒããæ°åãã·ã³ãã«ãå¿
èŠãªå Žåã¯read-stringãåŒã³åºãå¿
èŠãããããšã«çæããŠãã ããã
è€éãªã¿ã¹ã¯ã¯ãµãã¿ã¹ã¯ã«åå²ããããšããããããŸãããµãã¿ã¹ã¯ã®å€æ°ã®ãã¯ã¿ãŒãå«ãã :subtasksã¡ã¿ããŒã¿ãã¿ã¹ã¯é¢æ°ã«æž¡ãããšã«ãã£ãŠãlein help $TASK_CONTAINING_SUBTASKSãå®è¡ããéã«ããµãã¿ã¹ã¯ã衚瀺ããããšãã§ããŸãããµãã¿ã¹ã¯äžèЧã¯ãããããã®ãµãã¿ã¹ã¯ã®docstringã®ç¬¬äžæã衚瀺ããŸãããµãã¿ã¹ã¯ã®å®å
šçã®ãã«ãã¯ãlein help $TASK_CONTAINING_SUBTASKS $SUBTASKã§è¡šç€ºããããšãã§ããŸãã
ç¹å¥ãªæå®ããªãå ŽåãLeiningenã¯lein $MYTASK helpã®åŒã³åºããæšªåãããŠlein help $MYTASKã«å€æããŸããã¿ã¹ã¯å
ã§ç¬èªã®helpãµãã¿ã¹ã¯ã衚瀺ãããå Žåã¯ã¿ã¹ã¯é¢æ°ã«^:pass-through-helpã¡ã¿ããŒã¿ãæå®ããŠãã®ãµããŸããç¡å¹åããããšãã§ããŸãã
ãã©ã°ã€ã³ã®é¢æ°ã¯ãLeiningenã®ããã»ã¹å
ã§å®è¡ãããã®ã§ãæ¢åã®Leiningenã®é¢æ°å
šãŠã«ã¢ã¯ã»ã¹ããããšãã§ããŸããleiningen.core.*åå空éå
ã®ã^:internalã¡ã¿ããŒã¿ãä»äžãããŠããªã颿°å
šãŠãšã¿ã¹ã¯é¢æ°ã¯å
šãŠå
¬éãããŠããAPIãšèããŠãã ãããã¿ã¹ã¯åå空éã®ã¿ã¹ã¯ä»¥å€ã®é¢æ°ã¯å
éšçšã§ããã€ããŒããŒãžã§ã³ãªãªãŒã¹ã§ã倿Žãããå¯èœæ§ããããŸãã
ã¿ã¹ã¯ã®å€ãã¯ãããžã§ã¯ãã®ã³ã³ãã¯ã¹ãå
ã§ã³ãŒããå®è¡ããå¿
èŠããããŸããleiningen.core.eval/eval-in-project颿°ã¯ãã®ç®çã§äœ¿çšãããŸãããã®é¢æ°ã¯ãããžã§ã¯ãåŒæ°ãè©äŸ¡ãããã©ãŒã ããããŠæåŸã«ãªãã·ã§ã³ãšããŠãã¡ã€ã³ãã©ãŒã ã®åã«è©äŸ¡ããããåæåçšã®ãã©ãŒã ããšãããšãã§ããŸãããã®æåŸã®ãã©ãŒã ã¯ãžã©ã«ãã£ã·ããªãªãé²ãããã«ãåå空éãäºåã«requireããããã«çšããããšãã§ããŸãã
eval-in-project颿°å
ã§ã¯ãããžã§ã¯ãã®ã¯ã©ã¹ãã¹ãæå¹ã«ãªã£ãŠãããLeiningenèªäœã®å
éšé¢æ°ãšãã©ã°ã€ã³ã¯ç¡å¹åãããŠããŸãã
ãããžã§ã¯ããããã¯eval-in-projectã«æž¡ãåã«æ¹å€ããããšãã§ããŸããããããã¡ã€ã«ãããŒãžããããšã§å€æŽããæ¹æ³ãããŠãŒã¶ãŒã«ãããªãŒããŒã©ã€ããå¯èœã«ããã®ã§æšå¥šãããŸãã倿Žãå ããããã«ãleiningen.core.project/merge-profilesã䜿çšããŠãã ããã
(def swank-profile {:dependencies [['swank-clojure "1.4.3"]]})
(defn swank
"Launch swank server for Emacs to connect. Optionally takes PORT and HOST."
[project port host & opts]
(let [profile (or (:swank (:profiles project)) swank-profile)
project (project/merge-profiles project [profile])]
(eval-in-project project
`(swank.core/-main ~@opts)
'(require 'swank.core))))swank-clojureäŸåé¢ä¿ã®ã³ãŒãããããžã§ã¯ãå
ã§å¿
èŠãªãããç¬èªã®ãããã¡ã€ã«ãããã宣èšããããŒãžããŠããŸãããããã:swankãããã¡ã€ã«ããããžã§ã¯ããããã«å®çŸ©ãããŠããå Žåã¯ããã䜿ãããããŠãŒã¶ã¯ãã©ã°ã€ã³å
ã«ããŒãã³ãŒããããããŒãžã§ã³ã«äŸåããããªãå Žåã¯èªåã§éãããŒãžã§ã³ãéžæããããšãã§ããŸãã
äžèšã§çšããã³ãŒãã¯åã«eval-in-projectãšmerge-profilesãã©ããããã ããªã®ã§ããã©ã°ã€ã³ã®äŸãšããŠã¯ãµãããããªãããšã«çæããŠãã ãããããå®çŸãããããšãããã ããªã®ã§ããã°ããã©ã°ã€ã³ãå®è£
ããããšãªãå®çŸããããšãã§ããŸããåã«with-profilesãšå¿
èŠãªé¢æ°ãåŒã³åºãrunã¿ã¹ã¯ã䜿ã£ããšã€ãªã¢ã¹ãå®çŸ©ããã°ããã®ã§ãã
eval-in-projectãå®è¡ããåã«ãLeiningenã¯å
šãŠã®Javaã³ãŒããšå®è¡ã«å¿
èŠãªClojureã³ãŒãããã€ãã³ãŒãã«äºåã«ã³ã³ãã€ã«ããŠããããžã§ã¯ããå®è¡å¯èœãªç¶æ
ã«ãªãããæºåããªããã°ãªããŸãããããã¯ãããžã§ã¯ãã®:prep-tasksããŒã«å®çŸ©ãããŠããã¿ã¹ã¯å
šãŠãå®è¡ããããšã§è¡ãããŸããæšæºã§ã¯["javac" "compile"]ã§ããããããªãã®ãã©ã°ã€ã³ãä»ã®æºåäœæ¥ãå¿
èŠãšããå ŽåãïŒäŸãã°ãããã³ã«ãããã¡ã®ã³ã³ãã€ã«ïŒããŠãŒã¶ã«å¥ã®ãšã³ããªã:prep-tasksã«è¿œå ããŠãããããæç€ºããããšãã§ããŸãããã®ã¿ã¹ã¯ã¯eval-in-projectãå®è¡ãããã³ã«è©äŸ¡ãããããšã«çæããŠãã ãããååã®å®è¡æããäœãå€ãã£ãŠããªããã°çŽ æ©ãçµäºããããã«å®è£
ããŠãã ããã
ãã©ã°ã€ã³ã¯äž»ã«ã¿ã¹ã¯ãæäŸããããã®ãã®ã§ãããä»ã«ããããã¡ã€ã«ãããã¯ãããã«ãŠã§ã¢ãwagon(äŸåé¢ä¿ãã©ã³ã¹ããŒãã¡ãœããïŒãããŒãžã§ã³ç®¡çæ¹æ³ãå«ããããšãã§ããŸãã
ããªãã®ãã©ã°ã€ã³ã䜿çšãããããžã§ã¯ãã®å€ãã§å¿ èŠã«ãªããããªãã®ã®ãäœããã®çç±ã§ããã©ã«ãã§æå¹åã§ããªãèšå®ããããšãããã©ã°ã€ã³å ã§ãããã¡ã€ã«ãšããŠå«ããããšãã§ããŸãã
src/myplugin/profiles.cljãšãããã¡ã€ã«ããã©ã°ã€ã³å
ã«äœæããŠãäžèšã®ããããå®çŸ©ããŠãã ããã
{:default {:x "y and z"}
:extra {:other "settings"}}ãããå
ã®ããããã®å€ããããã¡ã€ã«ã§ããŠãŒã¶ãŒããããžã§ã¯ãã«ããŒãžããããšãã§ããŸããwith-profileãçšããŠãå®è¡æã«æç€ºçã«æå®ããããšãã§ããŸãã
$ lein with-profile plugin.myplugin/extra test
ãŠãŒã¶ã¯:defaultãããã¡ã€ã«ã倿Žããããšã§èªåçã«æå¹åããããšãã§ããŸãã
:profiles {:default [:base :system :user :provided :dev :plugin.myplugin/default]
:other {...}}:defaultãããã¡ã€ã«å
ã®ãšã³ããªã¯ãjarãuberjarãpomãªã©ãäžæµåãã«ææç©ãçæããã¿ã¹ã¯ãšãwith-profileãæå®ããã¿ã¹ã¯ãé€ãããä»ã®å
šãŠã®ã¿ã¹ã¯ã§æå¹åãããŸãã
ããã¯ãçšããŠãLeiningenæšæºã¿ã¹ã¯ã®ãµããŸããããçšåºŠå€æŽããããšãã§ããŸããããã¯æ©èœã¯ãLeiningenã«å«ãŸããŠãã Robert Hookeã©ã€ãã©ãªã«ãã£ãŠæäŸãããŠããŸãã
clojure.testã®ãã£ã¯ã¹ãã£æ©èœã«çæ³ãåŸãŠãããã¯ã¯ä»ã®é¢æ°ãå€ãã®å Žåã¯ã¿ã¹ã¯ãã©ããããä»ã®å€æ°ããã€ã³ãã£ã³ã°ããããè¿ãå€ãæ¹å€ãããã颿°ã®å®è¡ãæ¡ä»¶ã§å¶åŸ¡ãããããããšã§ãµããŸããå€ããŸããadd-hook颿°ã¯é©çšããã¿ã¹ã¯ã®å€æ°ãšã©ããã³ã°ãã颿°ãåŒæ°ã«ãšããŸãã
(ns lein-integration.plugin
(:require [robert.hooke]
[leiningen.test]))
(defn add-test-var-println [f & args]
`(binding [~'clojure.test/assert-expr
(fn [msg# form#]
(println "Asserting" form#)
((.getRawRoot #'clojure.test/assert-expr) msg# form#))]
~(apply f args)))
;; Place the body of the activate function at the top-level for
;; compatibility with Leiningen 1.x
(defn activate []
(robert.hooke/add-hook #'leiningen.test/form-for-testing-namespaces
#'add-test-var-println))ããã¯ã¯é¢æ°åæ(compose)ããŸãã®ã§ãããªãã®ããã¯ãä»ã®ããã¯ã®å
åŽã§å®è¡ãããå Žåãããããšã«æ°ãã€ããŠãã ããã詳现ã¯
Hookeã®ããã¥ã¡ã³ããŒã·ã§ã³ãåç
§ããŠãã ãããadd-hookãžã®åŒã³åºãã¯ç¬¬äžã第äºåŒæ°ã®äž¡æ¹ã«Varãçšããã¹ãã§ããããšã«çæããŠãã ãããããããããšã§ããã¯ãéè€ããŠè¿œå ããããšãªãç¹°ãè¿ãããŒãã£ã³ã°å¯èœã«ãªããŸããããã¯ãClojureã§ã¯é¢æ°ã¯åäžæ§ãæ¯èŒã§ããŸããããVarã¯å¯èœã ããã§ãã
ããããªãã®ããã¯ããããªãã®ãã©ã°ã€ã³ãå«ããããžã§ã¯ãã§èªåçã«ããŒããããããã«ãããå Žåã¯ãplugin-name.plugin/hooks颿°ã§åŒã³åºããŠæå¹åããŠãã ãããäžèšã®äŸã§ã¯ãã©ã°ã€ã³ã¯lein-integrationãšããååãªã®ã§ãlein-integration.plugin/hooks颿°ããlein-integrationãã©ã°ã€ã³ã®ããŒãæã«èªåçã«åŒã³åºãããŸãã
ããã¯ã¯ãproject.cljå
ã®:hooksããŒã«æå¹åããããã®Varã®ã·ãŒã¯ãšã³ã¹ãèšå®ããããšã§ãæåã§ããŒãããããšãã§ããŸããäžäœäºææ§ã®ããã«ã:hookså
ã§Varã®ä»£ããã«åå空éãæå®ãããããšãã§ããŸãããã®åå空éå
ã®activate颿°ãåŒã³åºãããŸããèªåããŒãã£ã³ã°ã®ããã¯ã¯æåã§æå®ãããããã¯ããåã«æå¹åãããŸãã
ãããžã§ã¯ãããã«ãŠã§ã¢ã¯ããããžã§ã¯ãããããåŒæ°ã«ãšããæ°ãããããžã§ã¯ãããããè¿ã颿°ã«ãããŸãããããã«ãŠã§ã¢ã«ãã£ãŠããã©ã°ã€ã³ã¯ãããžã§ã¯ããããã倿ããããšãã§ããããã«ãªããŸãããããããã«ãŠã§ã¢ã¯æè»ã§ééçãªã®ã§ããããã°ãé£ãããããšããåé¡ç¹ããããŸãããããã©ã°ã€ã³å ã®ãããã¡ã€ã«ã䜿ã£ãŠå¿ èŠãªããšãã§ããã®ã§ããã°ããã®ã»ãããã宣èšçã§ããµããŸãã芳å¯ããããã®ã§ãåŸã§èµ·ããé çã®çš®ãæžããããšãã§ããŸãã
äžèšã®ããã«ãŠã§ã¢ã¯ãããžã§ã¯ããããã®å 容ããããžã§ã¯ãã®ãªãœãŒã¹ãã©ã«ãå ã«æ¿å ¥ããŠã³ãŒãããèªã¿åãå¯èœã«ããŸãã
(ns lein-inject.plugin)
(defn middleware [project]
(update-in project [:injections] concat
`[(spit "resources/project.clj" ~(prn-str project))]))ããã¯ãšåæ§ãããã«ãŠã§ã¢ãplugin-name.plugin/middlewareå
ã«å®çŸ©ããã°èªåçã«é©çšãããŸãããŸããproject.cljå
ã®:middlewareããŒã«ãããžã§ã¯ããããã倿ããVarã®ã·ãŒã¯ãšã³ã¹ãå®çŸ©ããããšã§æåã§ããŒãã£ã³ã°ããããšãã§ããŸããããã«ãŠã§ã¢ã®èªåããŒãã£ã³ã°ãæåã§å®çŸ©ãããããã«ãŠã§ã¢ãããåã«é©çšãããããšã«çæããŠãã ããã
ãŸããçŸåšæå¹ãªããã«ãŠã§ã¢ã¯æå¹ã«ãªã£ãŠãããããã¡ã€ã«ã«äŸåããŠããããšã«ã泚æããŠãã ãããã€ãŸãã¢ã¯ãã£ããªãããã¡ã€ã«ãåãæ¿ãããã³ã«ããã«ãŠã§ã¢é¢æ°ãåé©çšããå¿
èŠããããšããããšã§ãããªãªãžãã«ã®ãããžã§ã¯ãããããä¿åããŠãããmerge-profilesãunmerge-profilesãset-profilesãåŒã³åºããã³ã«å
ã®ç¶æ
ãã倿ããããšã«ãã£ãŠå®çŸããŠããŸããããã«ãŠã§ã¢é¢æ°ã¯ç¹°ãè¿ãåŒã³åºãããå¯èœæ§ãããã®ã§ãåªçæ§(idempotent)ã®ãªãå¯äœçšãå«ãã¹ãã§ãããŸããã
Pomegranate (äŸå解決ã®ããã«Leiningenã«ãã£ãŠçšããããŠããã©ã€ãã©ãª)ã¯"wagon"ãã¡ã¯ããªã®ç»é²ããµããŒãããŠããŸããwagonã¯ãªããžããªçšã®éæšæºãã©ã³ã¹ããŒããããã³ã«ãæ±ãããã«çšãããããªããžããªURLã®ãããã³ã«ã«å¿ããŠéžæãããŸãããããããªãã®ãã©ã°ã€ã³ãwagonãã¡ã¯ããªãç»é²ããå¿
èŠãããã®ã§ããã°ããããã³ã«ãšããã®ãããã³ã«çšã®wagonã€ã³ã¹ã¿ã³ã¹ãè¿ã颿°ã®ããããå«ãleiningen/wagons.cljãã¡ã€ã«ãå«ããããšã§å®çŸã§ããŸããäŸãã°ãäžèšã®wagons.cljã¯dav:URLçšã®wagonãã¡ã¯ããªãç»é²ããŸãã
{"dav" #(org.apache.maven.wagon.providers.webdav.WebDavWagon.)}ãã®ãã¯ããã¯ãçšãããã©ã°ã€ã³ã®äŸãšããŠãS3 wagon privateã lein-webdavãåèã«ããŠãã ããã
Leiningenã«ã¯ãã«ãã¡ãœãããçšããŠãªãªãŒã¹é¢é£ã®ããŒãžã§ã³ç®¡çã¿ã¹ã¯ãè¡ããvcsã¿ã¹ã¯ãå«ãŸããŠããŸããæšæºã§ã¯ãGitåãã®å®è£
ãå«ãŸããŠããŸãããleiningen.vcs.$SYSTEMåå空éã«å«ããããšã§ä»ã®ã·ã¹ãã ã®ãµããŒãã远å ããããšãã§ããŸããvcsã¿ã¹ã¯ãåŒã³åºãããéãleiningen.vcsãã¬ãã£ãã¯ã¹é
äžã®åå空éå
šãŠãããŒãã£ã³ã°ãããŸãããããã®åå空éã§ã¯ãleiningen.vcså
ã§å®çŸ©ãããŠããdefmultiåãã®ã¡ãœããã®ã¿ãç¹å®ã®ããŒãžã§ã³ç®¡çã·ã¹ãã çšã«å®çŸ©ããããã«ããŠãã ããã
ãã©ã°ã€ã³ããããžã§ã¯ãå
ã§çšããããã«ã¯ã:dependenciesãšåããã©ãŒãããã§ã:pluginsããŒãproject.cljã«è¿œå ããã ãã§ãã:dependenciesã§æ±ãããªãã·ã§ã³ã«å ãã:pluginsã«ã¯ããã¯ãããã«ãŠã§ã¢ã®èªåããŒãã£ã³ã°ãç¡å¹åãããªãã·ã§ã³ã远å ãããŠããŸãã
(defproject foo "0.1.0"
:plugins [[lein-pprint "1.1.1"]
[lein-foo "0.0.1" :hooks false]
[lein-bar "0.0.1" :middleware false]])Leiningen2.4.0以äžã¯Clojure1.6.0ã䜿çšããŠããŸããããLeiningenã®ãã©ã°ã€ã³å
ã§å¥ã®ããŒãžã§ã³ã®Clojureã䜿ãå¿
èŠãããå Žåã¯ãeval-in-projectããããŒã®ãããžã§ã¯ãåŒæ°ãšå
±ã«çšããããšãã§ããŸãã
(eval-in-project {:dependencies '[[org.clojure/clojure "1.4.0"]]}
'(println "hello from" *clojure-version*))Leiningenã®ä»¥åã®ããŒãžã§ã³ã¯ãã©ã°ã€ã³ã®åãæ¹ã«éããããã€ããããŸãããã¢ããã°ã¬ãŒããããã®ã¯ããã»ã©é£ãããªãã¯ãã§ãã
ããŒãžã§ã³1.xãš2.xã®æã倧ããªéãã¯:dev-dependenciesããªããªã£ãããšã§ããLeiningenã®ããã»ã¹ãšãããžã§ã¯ãã®ããã»ã¹ã®äž¡æ¹ã«ååšããäŸåé¢ä¿ã¯ãã¯ãååšããŸãããLeiningenã¯:pluginsã ããåç
§ãããããžã§ã¯ãã¯:dependenciesã ããåç
§ããŸãããã ããããã®ãããã¯çŸåšæå¹åãããŠãããããã¡ã€ã«ã«ãã£ãŠåœ±é¿ãåããå ŽåããããŸãã
ããããªãã®ãããžã§ã¯ããeval-in-projectã䜿çšããå¿
èŠãå
šããªãã®ã§ããã°ãç§»æ€ã¯æ¯èŒç容æã§ããç§»åããLeiningen颿°ãžã®åç
§ãæŽæ°ããã ãã§ååã§ããleiningen.util.*åå空éå
ã®é¢æ°ã¯å
šãŠãªããªããleiningen.coreã¯leiningen.core.mainã«ç§»åããŸããã詳现ã«ã€ããŠã¯leiningen-coreã®ããã¥ã¡ã³ããåèã«ããŠãã ããã
eval-in-projectã䜿çšããŠãããã©ã°ã€ã³ã«ã€ããŠã¯ããã©ã°ã€ã³ã®äŸåé¢ä¿ãšãœãŒã¹ã³ãŒãããããžã§ã¯ãå
ã§ã¯å©çšå¯èœã§ã¯ãªããªããšããããšã«æ°ãã€ããŠãã ãããããããªãã®ãã©ã°ã€ã³ãããã©ã°ã€ã³ãšãããžã§ã¯ãã®äž¡æ¹ã®ã³ã³ãã¯ã¹ãã§å®è¡ããå¿
èŠã®ããã³ãŒããå«ãã§ããå Žåã¯ãè€æ°ã®ãããžã§ã¯ãã«åå²ããããããã:pluginsãš:dependenciesã«ç»é²ããå¿
èŠããããŸããeval-in-projectã®åŒã³åºãã§:dependenciesãæ¿å
¥ããæ¹æ³ã«ã€ããŠã¯äžèšã®lein-swankã®äŸãåç
§ããŠãã ããã
Leiningenã¿ã¹ã¯ã®äžã«ã¯ã©ã®ãã£ã¬ã¯ããªããã§ãå®è¡å¯èœãªãã®ããããŸããïŒäŸïŒlein repl)ããããžã§ã¯ãã³ã³ãã¯ã¹ãå
ã§ã®ã¿æå¹ãªã¿ã¹ã¯ããããŸãã
Leiningenããããžã§ã¯ãã®ã³ã³ãã¯ã¹ãå
ã§å®è¡ãããŠãããã©ããïŒã€ãŸããçŸåšã®ãã£ã¬ã¯ããªã«project.cljããããã©ããïŒã調ã¹ãã«ã¯ããããžã§ã¯ããããã®:rootããŒã調ã¹ãŸãã
(if (:root project)
(comment "Running in a project directory")
(comment "Running standalone"))ããããªãã®ãã©ã°ã€ã³ããããžã§ã¯ãã³ã³ãã¯ã¹ãã®å€åŽã§åäœãããšããŠãããããžã§ã¯ããããçšã®åŒæ°ãªã¹ãã®äœå°ãæ®ããŠããã¹ãã§ãããããžã§ã¯ããååšããªãå Žåã¯nilãæž¡ã£ãŠãããã®ãšèããŠãã ããã^:no-project-neededã¡ã¿ããŒã¿ã䜿ã£ãŠããããžã§ã¯ããå¿
èŠãšããŠãªãããšã瀺ããŠãã ããã
Leiningen 1.xã§ã¯ãæ°å€ãè¿ãã¿ã¹ã¯é¢æ°ã¯ããã»ã¹ã®exitå€ãåºåããæ¹æ³ãšããŠäœ¿ãããŠããŸãããã2.xã§ã¯èŽåœçãªãšã©ãŒãèµ·ãã£ãéã«ã¯leiningen.core.main/abortãåŒã³åºãã¹ãã§ããleiningen.core.main/*exit-process?*倿°ã«trueãèšå®ãããŠããå Žåããã®é¢æ°ã®åŒã³åºãã¯exitãåŒãèµ·ãããŸãããwith-profilesãªã©ãã³ã³ãã¯ã¹ãã«ãã£ãŠã¯ãåã«äŸå€ãã¹ããŒããŠæ¬¡ã®ã¿ã¹ã¯ã«é²ãå ŽåããããŸãã
éåžžã¯ãäŸãã°leiningen.compileãšããåå空éãæã€ãã©ã°ã€ã³ãäœã£ããšããŠããããã¯lein compileãå®è¡ããæã«åŒã³åºãããããšã¯ãããŸãããæšæºã¿ã¹ã¯ãããªãã®ãã©ã°ã€ã³ãäžæžãããŸããããæšæºã¿ã¹ã¯ãé ãããå Žåããšã€ãªã¢ã¹ãäœããããã©ã°ã€ã³ãleiningen.plugin.compileåå空éå
ã«äœãããšã§å®çŸããããšãã§ããŸãã
ã²ãšãã³2.xãšã®äºææ§ã確ä¿ããã®ã«å¿
èŠãªå€æŽç¹ãç¹å®ããã°ãåäžã®ã³ãŒãããŒã¹å
ã§ããŒãžã§ã³1.xãš2.xã®äž¡æ¹ããµããŒããããã©ãããæ±ºããããšãã§ããŸããå¥ã®ãã©ã³ãã§ç®¡çããã»ããæ¥œãªå ŽåããããŸãããäž¡æ¹ã®ããŒãžã§ã³ããµããŒãããã»ããç°¡åãªå ŽåããããŸãã幞éãªããšã«ã:pluginsãçšããŠãeval-in-projectã®ããã ãã«:dependenciesã远å ããæŠç¥ã¯Leiningen 1.7äžã§ã¯ããŸãåäœããŸãã
ãã2.xã§ç§»åããŠããŸã£ã颿°ã䜿ãããå Žåã¯ãã³ã³ãã€ã«æã«è§£æ±ºãã代ããã«å®è¡æã«è§£æ±ºããããèŠã€ãããªããã°1.xããŒãžã§ã³ã®é¢æ°ã«çž®éããæ¹æ³ã詊ããŠã¿ãŠãã ãããlein-swankãã©ã°ã€ã³ã¯ãã®äºææ§ã·ã ã䜿ã£ãäŸãæäŸããŠããŸãã
(defn eval-in-project
"Support eval-in-project in both Leiningen 1.x and 2.x."
[project form init]
(let [[eip two?] (or (try (require 'leiningen.core.eval)
[(resolve 'leiningen.core.eval/eval-in-project)
true]
(catch java.io.FileNotFoundException _))
(try (require 'leiningen.compile)
[(resolve 'leiningen.compile/eval-in-project)]
(catch java.io.FileNotFoundException _)))]
(if two?
(eip project form init)
(eip project form nil nil init))))ãã¡ããã颿°ããšãåŒæ°ã®æ°ãå€ãã£ããã颿°ãå®å šã«ãªããªã£ãå Žåã¯ãã®ææ³ã¯é©çšã§ããŸããããã»ãšãã©ã®å Žåã¯ããã§å åãªã¯ãã§ãã
2.xã§å€æŽããã颿°ã®ãã¡ãåºãçšããããŠãããã®ã¯ã1.xãš2.xã®äž¡æ¹ããµããŒãããäºææ§ã·ã ãæäŸãããleinjackerãããžã§ã¯ãçµç±ã§å©çšå¯èœã§ãã
ä»ã®éèŠãªå€æŽç¹ãšããŠã:source-pathã:resources-pathã:java-source-pathã:test-pathã¯ã:source-pathsã:resource-pathsã:java-source-pathsã:test-pathsã«å€æŽãããStringã®ä»£ããã«ãã¯ã¿ãŒããšãããã«ãªããŸããã以åã®:dev-resourcesããŒã¯ã:devãããã¡ã€ã«ãæå¹ãªå Žåã®ã¿:resource-pathsã®ãšã³ããªã®äžã€ãšããŠå«ãŸããããã«ãªããŸããã
åŸæ¹äºææ§ãä¿ã€æ¹æ³ã§ã¿ã¹ã¯ããããžã§ã¯ããã£ã¬ã¯ããªã®å€åŽã§å®è¡ãããã®ã¯ã2.xãåã«ãããžã§ã¯ããåŒæ°ãšããŠæž¡ãããªããã°nilã«ããŠããã®ã«å¯Ÿãã1.xã¯å¿ èŠä»¥äžã«è³¢ããåŒæ°ãªã¹ããå®éã«ãããžã§ã¯ãã®åŒæ°ãšããŠæž¡ããããã§ãã¯ããããããç°¡åã§ã¯ãããŸãããæåã®åŒæ°ããããžã§ã¯ãããããã©ãããå€å®ããããšã¯ã§ããŸãããåŒæ°ãäºã€ä»¥äžã®å Žåããã®ãã§ãã¯ã¯éåžžã«é£ãããªããŸãããã®ãããªç¶æ³ã§ã¯ãäºã€ã®ãã©ã³ãã§ç®¡çããã»ãããããããããŸããã
ãããžã§ã¯ãã®ã³ãŒãããŒã¹ã«ã¿ã¹ã¯ãå«ããªããã°ãããªãå ŽåããšããšããŠãããŸãããããã¯æã£ãã»ã©é »ç¹ã«ãããããšã§ã¯ãããŸãããã³ãã³ãã©ã€ã³ããå®è¡ããå¿
èŠãããã ããªãããããžã§ã¯ãå
ã®-main颿°ãšããŠå®è¡ãããlein garbleã®ãããªãšã€ãªã¢ã¹ãšããŠèµ·åããã»ããã¯ããã«ç°¡åã§ãã
:aliases {"garble" ["run" "-m" "myproject.garble" "supergarble"]}ãšã€ãªã¢ã¹ã®ãã¯ã¿ãŒã¯éšåé©çšãããã¿ã¹ã¯é¢æ°ã«ãªããŸããããäžèšã®èšå®ã®å Žåãlein garble seventeenã¯ãlein run -m myproject.garble supergarble seventeenïŒãããã¯replãã(myproject.garble/-main "supergarble" "seventeen")ãå®è¡ããå ŽåïŒãšåçã§ããããšã«æ³šæããŠãã ããããšã€ãªã¢ã¹ã®åŒæ°ã¯å®è¡æã«ããããããæž¡ãããŠããåŒæ°ã®åŸãã«è¿œå ãããŸãã
Leiningenã¿ã¹ã¯ãèšè¿°ããå¿
èŠãããã®ã¯ãäŸãã°eval-in-projectãLeiningenã®å
éšãžçŽæ¥ã¢ã¯ã»ã¹ããã¿ã¹ã¯ãåŒã³åºãåã«ãããžã§ã¯ããããã調æŽããå¿
èŠãããå Žåãªã©ããããžã§ã¯ãã³ã³ãã¯ã¹ãã®å€åŽã§æäœããå¿
èŠãããå Žåã®ã¿ã§ãããšã€ãªã¢ã¹ã䜿ã£ãŠããããžã§ã¯ããããããå€ãèªã¿åãããšããã§ããŸãã
:aliases {"garble" ["run" "-m" "myproject.garble" :project/version]}ãã®äŸã§ã¯ãããžã§ã¯ããããã®:versionãã£ãŒã«ããåŒæ°ãªã¹ãã«æž¡ãããšã§ããããžã§ã¯ãå
ã§å®è¡ããã-main颿°ãå€ã«ã¢ã¯ã»ã¹ã§ããããã«ããŠããŸãã
ãããã£ãäŸã®å€ãã¯æ¢åã®ãã©ã°ã€ã³ã§ã«ããŒãããŠããã¯ãã§ãããããé¡äŒŒã®äŸãèŠã€ããããäœããã®çç±ã§å¥ã®ãã©ã°ã€ã³ã«åé¢ã§ããªãå Žåãtasks/leiningen/ã®äžã«æ°ããã¿ã¹ã¯ãå®çŸ©ããfoo.cljãã¡ã€ã«ãäœæããtasksã.lein-classpathã«è¿œå ããããšã§ãã®ãµããŸããå®çŸããããšãã§ããŸãã
$ ls
README.md project.clj src tasks test
$ ls -R tasks
leiningen
tasks/leiningen:
foo.clj
$ echo -ne ":tasks" | cat >> .lein-classpath
$ lein foo
Hello, Foo!
ãã ããã»ãšãã©ã®å Žåãå¥ã®ãã©ã°ã€ã³ãããžã§ã¯ãã«ã¿ã¹ã¯ãåé¢ããã®ãæãŸããã§ãã.lein-classpathã¯äž»ã«å®éšçšããé©åãªãã©ã°ã€ã³ãäœãæéããªãç·æ¥ã®å Žåã®ããã«ãããã®ã ããã§ãã
ããªãã®ãã©ã°ã€ã³ãã§ãããã£ãããWikiäžã®ãªã¹ãã«è¿œå ããŠãã ããã
ãã®ãã©ã°ã€ã³ã·ã¹ãã ããããªãã®æãã®ãŸãŸã«Leiningenãã«ã¹ã¿ãã€ãºããããã®ç°¡åã§ãæè»ãªã·ã¹ãã ãæäŸããŠããããšãé¡ã£ãŠããŸãã