8000 leiningen/doc/ja/PLUGINS_ja.md at 2.6.1 · steini/leiningen · GitHub
[go: up one dir, main page]

Skip to content

Latest commit

 

History

History
311 lines (204 loc) · 32.1 KB

PLUGINS_ja.md

File metadata and controls

311 lines (204 loc) · 32.1 KB

Table of Contents generated with DocToc

English

Leiningen プラグむン

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)のない副䜜甚を含むべきでありたせん。

Maven Wagon

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を参考にしおください。

VCSメ゜ッド

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]])

Clojureのバヌゞョン

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の䟋を参照しおください。

プロゞェクト vs スタンドアロンでの実行

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名前空間内に䜜るこずで実珟するこずができたす。

1.x互換性

ひずたび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をカスタマむズするための簡単で、柔軟なシステムを提䟛しおいるこずを願っおいたす。

0