Ⅰ. 插件描述
Automate Clojure projects without setting your hair on fire.Ⅱ. 基本信息
|
Ⅲ. 安装方法
使用Vundle管理器安装
在你的.vimrc下添加:Plugin 'technomancy/leiningen'
… 然后在Vim中运行以下命令:
:source %
:PluginInstall
对于Vundle版本 < 0.10.2,请用上面的Bundle替换Plugin。
使用NeoBundle管理器安装
在你的.vimrc下添加:NeoBundle 'technomancy/leiningen'
… 然后在Vim中运行以下命令:
:source %
:NeoBundleInstall
使用VimPlug管理器安装
在你的.vimrc下添加:Plug 'technomancy/leiningen'
… 然后在Vim中运行以下命令:
:source %
:PlugInstall
使用Pathogen管理器安装
在终端中运行以下命令:cd ~/.vim/bundle
git clone https://github.com/technomancy/leiningen
Ⅳ. 文档说明
# Leiningen
<img src="https://leiningen.org/img/leiningen.jpg"
alt="Leiningen logo" title="The man himself" align="right" />
"Leiningen!" he shouted. "You're insane! They're not creatures you can
fight—they're an elemental—an 'act of God!' Ten miles long, two
miles wide—ants, nothing but ants! And every single one of them a
fiend from hell..."
- from Leiningen Versus the Ants by Carl Stephenson
Leiningen is for automating Clojure projects without setting your hair on fire.
Installation
If your preferred
package manager
offers a recent version of Leiningen, try that first as long as it has version 2.x.
Leiningen installs itself on the first run of the lein shell script; there is no
separate install script. Follow these instructions to install Leiningen manually:
- Make sure you have Java installed; OpenJDK version 8 is recommended at this time.
- Download the
leinscript from thestablebranch
of this project. - Place it on your
$PATH. (~/binis a good choice if it is on your path.) - Set it to be executable. (
chmod +x ~/bin/lein) - Run it.
Windows users can use the above script in the Linux subsystem or try
the batch file or
Powershell version
instead.
Basic Usage
The
tutorial
has a detailed walk-through of the steps involved in creating a new
project, but here are the commonly-used tasks:
$ lein new [TEMPLATE] NAME # generate a new project skeleton
$ lein test [TESTS] # run the tests in the TESTS namespaces, or all tests
$ lein repl # launch an interactive REPL session
$ lein run -m my.namespace # run the -main function of a namespace
$ lein uberjar # package the project and dependencies as standalone jar
$ lein deploy clojars # publish the project to Clojars as a library
Use lein help to see a complete list. lein help $TASK shows the
usage for a specific task.
You can also chain tasks together in a single command by using thedo task with comma-separated tasks:
$ lein do clean, test foo.test-core, jar
Most tasks need to be run from somewhere inside a project directory to
work, but some (new, help, search, version, and repl) may
run from anywhere.
Configuration
The project.clj file in the project root should look like this:
(defproject myproject "0.5.0-SNAPSHOT"
:description "A project for doing things."
:license "Eclipse Public License 1.0"
:url "http://github.com/technomancy/myproject"
:dependencies [[org.clojure/clojure "1.8.0"]]
:plugins [[lein-tar "3.2.0"]])The lein new task generates a project skeleton with an appropriate
starting point from which you can work. See the
sample.project.clj
file (also available via lein help sample) for a detailed listing of
configuration options.
The project.clj file can be customized further with the use of
profiles.
Documentation
Leiningen documentation is organized as a number of guides:
Usage
- Tutorial (start here if you are new)
- FAQ
- Profiles
- Deployment & Distribution of Libraries
- Sample project.clj
- Polyglot (e.g. Clojure/Java) projects
Development
Plugins
Leiningen supports plugins which may introduce new tasks. See
the plugins wiki page
for a full list. If a plugin is needed for successful test or build
runs, (such as lein-tar) then it should be added to :plugins in
project.clj, but if it's for your own convenience (such aslein-pprint) then it should be added to the :plugins list in the:user profile in ~/.lein/profiles.clj. See the
profiles guide
for details on how to add to your :user profile. The
plugin guide
explains how to write plugins.
License
Source Copyright © 2009-2018 Phil Hagelberg, Alex Osborne, Dan Larkin, and
contributors.
Distributed under the Eclipse Public License, the same as Clojure
- See the file COPYING.
Thanks to Stuart Halloway for Lancet and Tim Dysinger for convincing
me that good builds are important.
Images Copyright © 2010 Phil Hagelberg. Distributed under the Creative
Commons Attribution + ShareAlike
License. Full-size version
available.