lock_jar 0.5.5 → 0.5.6

data/Gemfile

@@ -1,13 +1,13 @@
 source "http://rubygems.org"
 
 gem "naether", "~> 0.8.6"
-gem "gli", "~> 2.0.0"
+gem "thor",     "> 0.14.0"
 
 # Add dependencies to develop your gem here.
 # Include everything needed to run rake, tests, features, etc.
 group :development do
   gem "rspec", "~> 2.9.0"
   gem "bundler", "~> 1.1.0"
-  gem "jeweler", "~> 1.6.4"
+  gem "jeweler", "~> 1.8.4"
   gem "yard", "~> 0.8.0"
 end

data/README.md

@@ -0,0 +1,249 @@
+# LockJar
+
+LockJar manages Java Jars for Ruby. Powered by [Naether](https://github.com/mguymon/naether) to create a frankenstein of Bundler and Maven. A Jarfile ([example](https://github.com/mguymon/lock_jar/blob/master/spec/Jarfile)) is used to generate a Jarfile.lock that contains all the resolved jar dependencies for scopes runtime, compile, and test. The Jarfile.lock can be used to populate the classpath.
+
+LockJar can be used directly or integrates with Buildr.
+
+https://github.com/mguymon/lock_jar
+
+[RDoc](http://rubydoc.info/github/mguymon/lock_jar/master/frames)
+
+## Install
+
+    gem install lock_jar
+
+## Usage
+
+### Jarfile
+
+A Jarfile is a simple file using a Ruby DSL for defining a project's dependencies using the following 
+methods:
+
+* **local( path )**: Set the local Maven repository, this were dependencies are downloaded to. 
+* **repository( url )**: Add additional urlr of remote Maven repository.
+* **map( notation, paths )**: Map local compiled class paths to a notation. The map is applied when loading or listing jar. This is useful for local development that overrides an artifact. A single or Array of paths can be set.
+* **exclude( excludes )**: Add a artifact:group that will be excluded from resolved dependencies. A single or Array of excludes can be set.
+* **jar( notations, opts = {} )**: Add Jar dependency in artifact notation, artifact:group:version as the bare minimum. A single or Array of notations can be passed. Default scope is _compile_, can be specified by setting _opts = { :scope => ['new_scope'] }_
+* **pom( pom_path, opts = {} )**: Add a local Maven pom, default is to load dependencies for all scopes. To select the scopes to be loaded from the pom, set the _opts = { :scopes => ['new_scope'] }_
+* **scope( scopes )**: Set the scope for nested jar or pom. A single or Array of scopes can be set.
+
+#### Example Jarfile
+
+    repository 'http://repository.jboss.org/nexus/content/groups/public-jboss'
+  	
+    // Default scope is compile
+    jar "org.apache.mina:mina-core:2.0.4"
+  
+    scope 'runtime' do
+      jar 'org.apache.tomcat:servlet-api:jar:6.0.35'
+    end
+  
+    scope 'test' do
+      jar 'junit:junit:jar:4.10'
+    end
+  
+	
+### Resolving dependencies
+
+* **LockJar.lock( *args )**: Using a Jarfile, creates a lock file. Depending on the type of arg, a different configuration is set.
+  * An arg of a String will set the Jarfile path, e.g. _'/somewhere/Jarfile.different'_. Default jarfile is _'Jarfile'_
+  * An arg of a Hash will set the options, e.g. _{ :local_repo => 'path' }_
+      * **:download** if true, will download jars to local repo. Defaults to true.
+      * **:local_repo** sets the local repo path
+      * **:lockfile** sets the Jarfile.lock path. Default lockfile is _Jarfile.lock_.
+
+When the Jarfile is locked, the transitive dependencies are resolved and saved to the Jarfile.lock file.
+
+Example of locking a Jarfile to a Jarfile.lock
+
+    LockJar.lock
+  
+ 
+### Jarfile.lock
+
+The _Jarfile.lock_ generated is a YAML file containing the scoped dependencies, their resolved dependencies, and the additional Maven repositories.
+
+#### The Jarfile.lock
+
+    --- 
+    repositories: 
+      - http://repository.jboss.org/nexus/content/groups/public-jboss
+    scopes: 
+      compile: 
+        dependencies: 
+          - org.apache.mina:mina-core:2.0.4
+        resolved_dependencies: 
+          - org.apache.mina:mina-core:jar:2.0.4
+          - org.slf4j:slf4j-api:jar:1.6.1
+          - com.slackworks:modelcitizen:jar:0.2.2
+          - commons-lang:commons-lang:jar:2.6
+          - commons-beanutils:commons-beanutils:jar:1.8.3
+          - commons-logging:commons-logging:jar:1.1.1
+          - ch.qos.logback:logback-classic:jar:0.9.24
+          - ch.qos.logback:logback-core:jar:0.9.24
+          - com.metapossum:metapossum-scanner:jar:1.0
+          - commons-io:commons-io:jar:1.4
+          - junit:junit:jar:4.7
+      runtime: 
+        dependencies: 
+          - org.apache.tomcat:servlet-api:jar:6.0.35
+        resolved_dependencies: 
+          - org.apache.tomcat:servlet-api:jar:6.0.35
+      test: 
+        dependencies: 
+          - junit:junit:jar:4.10
+        resolved_dependencies: 
+          - junit:junit:jar:4.10
+          - org.hamcrest:hamcrest-core:jar:1.1
+  
+  
+### Accessing Jars
+
+* **LockJar.list(*args)**: Lists all dependencies as notations for scopes from the Jarfile.lock.  Depending on the type of arg, a different configuration is set.  
+  * An arg of a String will set the Jarfile.lock path, e.g. _Better.lock_. Default lock file is _Jarfile.lock_.
+  * An arg of an Array will set the scopes, e.g. _['compile','test']_. Defaults scopes are _compile_ and _runtime_.
+  * An arg of a Hash will set the options, e.g. _{ :local_repo => 'path' }_
+      * **:local_repo** sets the local repo path
+      * **:local_paths** converts the notations to paths of jars in the local repo
+      * **:resolve** to true will make transitive dependences resolve before returning list of jars
+  
+* **LockJar.load(*args)**: Loads all dependencies to the classpath for scopes from the Jarfile.lock. Defaults scopes are _compile_ and _runtime_. Default lock file is _Jarfile.lock_.
+  * An arg of a String will set the Jarfile.lock, e.g. _'Better.lock'_
+  * An arg of an Array will set the scopes, e.g. _['compile','test']_
+  * An arg of a Hash will set the options, e.g. _{ :local_repo => 'path' }_
+     * **:local_repo** sets the local repo path
+     * **:resolve** to true will make transitive dependences resolve before loading to classpath 
+
+Once a _Jarfile.lock_ is generated, you can list all resolved jars by
+  
+    jars = LockJar.list
+  
+or directly load all Jars into the classpath
+  
+    jars = LockJar.load  
+
+Do not forget, if you change your _Jarfile_, you have to re-generate the _Jarfile.lock_.
+  
+### Shortcuts
+
+#### Skipping the Jarfile
+
+You can skip the _Jarfile_ and _Jarfile.lock_ to directly play with dependencies by passing a block to _LockJar.lock_, _LockJar.list_, and _LockJar.load_
+
+#### Lock without a Jarfile
+
+    LockJar.lock do
+      jar 'org.eclipse.jetty:example-jetty-embedded:jar:8.1.2.v20120308'
+    end
+
+#### List without a Jarfile.lock
+    
+    LockJar.list do
+      jar 'org.eclipse.jetty:example-jetty-embedded:jar:8.1.2.v20120308'
+    end
+
+#### Load without a Jarfile.lock
+    
+    LockJar.load do
+      jar 'org.eclipse.jetty:example-jetty-embedded:jar:8.1.2.v20120308'
+    end
+
+Since you skipped the locking part, mostly likely you will need to resolve the dependences in the block, just pass the _:resolve => true_ option to enable dependency resolution (also works for _LockJar.list_).
+
+    LockJar.load( :resolve => true ) do
+      jar 'org.eclipse.jetty:example-jetty-embedded:jar:8.1.2.v20120308'
+    end
+
+## Command line
+
+There is a simple command line helper. You can lock a _Jarfile_ with the following command
+
+    lockjar lock
+
+List jars in a _Jarfile.lock_ with 
+ 
+    lockjar list
+  
+Download all jars in a _Jarfile.lock_ with
+
+    lockjar install
+  
+_lockjar_ _--help_ will give you list of all commands and their options.
+
+## Bundler Integration
+
+Has been deprecated to https://github.com/mguymon/lock_jar/tree/bundler_support
+  
+## Buildr Integration
+
+LockJar integrates with [Buildr](http://buildr.apache.org/) using an [Addon](https://github.com/mguymon/lock_jar/blob/master/lib/lock_jar/buildr.rb). This allows the Jarfile to be defined directly into a _buildfile_. A global LockJar definition can be set and is inherited to all projects. Each project may have its own LockJar definition. A lock file is generated per project based on the project name.
+
+A new Buildr task is added to generate the lockfile for all projects
+
+    buildr lock_jar:lock
+  
+and a task per project to generate the lockfile for a single project
+
+    buildr <app>:<project>:lock_jar:lock
+
+In a project, you can access an Array of notations using the **lock_jars** method, accepts same parameters as [LockJar.list](https://github.com/mguymon/lock_jar#accessing-jars)
+
+    lock_jars()
+
+
+The _compile_ scoped dependencies are automatically added to the classpath for compiling. The test scoped dependencies are automatically added to the classpath for tests. Do not forget, if you change the LockJar definitions, you have to rerun the **lock_jar:lock** task.
+
+
+### Example
+
+Sample buildfile with LockJar
+
+    require 'lock_jar/buildr'
+    
+    # app definition, inherited into all projects
+    lock_jar do
+
+         scope 'test' do
+           jar 'junit:junit:jar:4.10'
+         end
+    end
+
+    define 'app' do
+
+       def 'project1' do
+         lock_jar do
+           jar  "org.apache.mina:mina-core:2.0.4"
+         end
+       end
+
+       def 'project2' do
+          lock_jar do
+            pom 'pom.xml'
+          end
+       end
+
+    end
+
+Generated the following lock files using **lock_jar:lock**
+
+* project1.lock - contains _junit_ and _mina_ jars.
+* project2.lock - contains _junit_ and _pom.xml_ jars.
+  
+
+## License
+
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with this
+work for additional information regarding copyright ownership.  The ASF
+licenses this file to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+License for the specific language governing permissions and limitations under
+the License.
+

data/VERSION

@@ -1 +1 @@
-0.5.5
+0.5.6

data/bin/lockjar

@@ -1,64 +1,6 @@
 #!/usr/bin/env ruby
 require 'rubygems'
-require 'gli'
-require 'lock_jar'
-require 'lock_jar/version'
+require 'thor'
+require 'lock_jar/cli'
 
-include  GLI::App
-
-program_desc 'LockJar manages Java Jars for Ruby'
-
-version LockJar::VERSION
-
-desc 'Install Jars from a Jarfile.lock'
-command :install do |c|
-  c.desc 'Path to Jarfile.lock'
-  c.default_value 'Jarfile.lock'
-  c.flag :lockfile
-  
-  c.desc "Scopes to install from Jarfile.lock"
-  c.default_value 'compile, runtime'
-  c.flag :scopes
-  
-  c.action do |global_options,options,args|
-    scopes = options[:scopes].split(',').map{ |scope| scope.strip }
-    puts "Installing Jars from #{options[:lockfile]} for #{scopes.inspect}"
-    LockJar.install( options[:lockfile], scopes )
-  end
-end
-
-desc 'List Jars from a Jarfile.lock'
-command :list do |c|
-  c.desc 'Path to Jarfile.lock'
-  c.default_value 'Jarfile.lock'
-  c.flag :lockfile
-  
-  c.desc "Scopes to install from Jarfile.lock"
-  c.default_value 'compile, runtime'
-  c.flag :scopes
-  
-  c.action do |global_options,options,args|
-    scopes = options[:scopes].split(',').map{ |scope| scope.strip }
-    puts "Listing Jars from #{options[:lockfile]} for #{scopes.inspect}"
-    puts LockJar.list( options[:lockfile], scopes ).inspect
-  end
-end
-
-desc 'Lock Jars in a Jarfile.lock'
-command :lock do |c|
-  c.desc 'Path to Jarfile'
-  c.default_value 'Jarfile'
-  c.flag :jarfile
-  
-  c.desc "Path to Jarfile.lock"
-  c.default_value 'Jarfile.lock'
-  c.flag :lockfile
-  
-  c.action do |global_options,options,args|
-    puts "Locking #{options[:jarfile]} to #{options[:lockfile]}"
-    LockJar.lock( options[:jarfile], { :lockfile => options[:lockfile] } )
-  end
-end
-
-
-exit run(ARGV)
+LockJar::CLI.start

data/lib/lock_jar/cli.rb

@@ -0,0 +1,64 @@
+require 'rubygems'
+require 'thor'
+require 'lock_jar'
+
+module LockJar
+  
+  class CLI < Thor
+    
+    module ClassMethods
+      def generate_lockfile_option
+        method_option :lockfile, 
+          :aliases => "-l", 
+          :default => 'Jarfile.lock', 
+          :desc => "Path to Jarfile.lock"
+      end
+      
+      def generate_scopes_option
+        method_option :scopes, 
+          :aliases => "-s", 
+          :default => ['compile', 'runtime'], 
+          :desc => "Scopes to install from Jarfile.lock",
+          :type => :array
+      end
+      
+      def generate_jarfile_option
+        method_option :jarfile,
+          :aliases => "-j", 
+          :default => 'Jarfile', 
+          :desc => "Path to Jarfile"
+      end
+    end
+    extend(ClassMethods)
+    
+    desc "version", "LockJar version"
+    def version
+      puts LockJar::VERSION
+    end
+    
+    desc "install", "Install Jars from a Jarfile.lock"
+    generate_lockfile_option
+    generate_scopes_option
+    def install
+        puts "Installing Jars from #{options[:lockfile]} for #{options[:scopes].inspect}"
+        LockJar.install( options[:lockfile], options[:scopes] )      
+    end
+    
+    desc "list", "List Jars from a Jarfile.lock"
+    generate_lockfile_option
+    generate_scopes_option
+    def list
+      puts "Listing Jars from #{options[:lockfile]} for #{options[:scopes].inspect}"
+      puts LockJar.list( options[:lockfile], options[:scopes] ).inspect
+    end
+    
+    desc 'lock', 'Lock Jars in a Jarfile.lock'
+    generate_jarfile_option
+    generate_lockfile_option
+    def lock
+      puts "Locking #{options[:jarfile]} to #{options[:lockfile]}"
+      LockJar.lock( options[:jarfile], { :lockfile => options[:lockfile] } )
+    end
+    
+  end
+end

data/lock_jar.gemspec

@@ -5,28 +5,29 @@
 
 Gem::Specification.new do |s|
   s.name = "lock_jar"
-  s.version = "0.5.5"
+  s.version = "0.5.6"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Michael Guymon"]
-  s.date = "2012-08-28"
+  s.date = "2012-09-01"
   s.description = "Manage Jar files for Ruby. In the spirit of Bundler, a Jarfile\n  is used to generate a Jarfile.lock that contains all the resolved jar dependencies for scopes runtime, compile, and test.\n  The Jarfile.lock can be used to populate the classpath"
   s.email = "michael@tobedevoured.com"
   s.executables = ["lockjar"]
   s.extra_rdoc_files = [
     "LICENSE",
-    "README.rdoc"
+    "README.md"
   ]
   s.files = [
     ".gitignore",
     "Gemfile",
     "LICENSE",
-    "README.rdoc",
+    "README.md",
     "Rakefile",
     "VERSION",
     "bin/lockjar",
     "lib/lock_jar.rb",
     "lib/lock_jar/buildr.rb",
+    "lib/lock_jar/cli.rb",
     "lib/lock_jar/dsl.rb",
     "lib/lock_jar/maven.rb",
     "lib/lock_jar/resolver.rb",
@@ -53,25 +54,25 @@ Gem::Specification.new do |s|
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<naether>, ["~> 0.8.6"])
-      s.add_runtime_dependency(%q<gli>, ["~> 2.0.0"])
+      s.add_runtime_dependency(%q<thor>, ["> 0.14.0"])
       s.add_development_dependency(%q<rspec>, ["~> 2.9.0"])
       s.add_development_dependency(%q<bundler>, ["~> 1.1.0"])
-      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.4"])
       s.add_development_dependency(%q<yard>, ["~> 0.8.0"])
     else
       s.add_dependency(%q<naether>, ["~> 0.8.6"])
-      s.add_dependency(%q<gli>, ["~> 2.0.0"])
+      s.add_dependency(%q<thor>, ["> 0.14.0"])
       s.add_dependency(%q<rspec>, ["~> 2.9.0"])
       s.add_dependency(%q<bundler>, ["~> 1.1.0"])
-      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
       s.add_dependency(%q<yard>, ["~> 0.8.0"])
     end
   else
     s.add_dependency(%q<naether>, ["~> 0.8.6"])
-    s.add_dependency(%q<gli>, ["~> 2.0.0"])
+    s.add_dependency(%q<thor>, ["> 0.14.0"])
     s.add_dependency(%q<rspec>, ["~> 2.9.0"])
     s.add_dependency(%q<bundler>, ["~> 1.1.0"])
-    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
     s.add_dependency(%q<yard>, ["~> 0.8.0"])
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lock_jar
 version: !ruby/object:Gem::Version
-  version: 0.5.5
+  version: 0.5.6
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-28 00:00:00.000000000 Z
+date: 2012-09-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: naether
@@ -28,21 +28,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 0.8.6
 - !ruby/object:Gem::Dependency
-  name: gli
+  name: thor
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - ! '>'
       - !ruby/object:Gem::Version
-        version: 2.0.0
+        version: 0.14.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - ! '>'
       - !ruby/object:Gem::Version
-        version: 2.0.0
+        version: 0.14.0
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -82,7 +82,7 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.6.4
+        version: 1.8.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -90,7 +90,7 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.6.4
+        version: 1.8.4
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -117,17 +117,18 @@ executables:
 extensions: []
 extra_rdoc_files:
 - LICENSE
-- README.rdoc
+- README.md
 files:
 - .gitignore
 - Gemfile
 - LICENSE
-- README.rdoc
+- README.md
 - Rakefile
 - VERSION
 - bin/lockjar
 - lib/lock_jar.rb
 - lib/lock_jar/buildr.rb
+- lib/lock_jar/cli.rb
 - lib/lock_jar/dsl.rb
 - lib/lock_jar/maven.rb
 - lib/lock_jar/resolver.rb
@@ -157,7 +158,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2534310865284659612
+      hash: 3994584542198625779
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:

data/README.rdoc

@@ -1,260 +0,0 @@
-= LockJar
-
-LockJar manages Java Jars for Ruby. Powered by {Naether}[https://github.com/mguymon/naether] to create a frankenstein of 
-Bundler and Maven. A Jarfile ({example}[https://github.com/mguymon/lock_jar/blob/master/spec/Jarfile]) is used to 
-generate a Jarfile.lock that contains all the resolved jar dependencies for scopes runtime, compile, and test. 
-The Jarfile.lock can be used to populate the classpath.
-
-LockJar can be used directly or integrates directly with Bundler and Buildr.
-
-https://github.com/mguymon/lock_jar
-
-{RDoc}[http://rubydoc.info/github/mguymon/lock_jar/master/frames]
-
-== Install
-
-  gem install lock_jar
-
-== Usage
-
-=== Using a Jarfile
-
-==== Jarfile
-
-A Jarfile is a simple file using a Ruby DSL for defining a project's dependencies using the following 
-methods:
-
-* local( path ): Set the local Maven repository, this were dependencies are downloaded to. 
-* repository( url ): Add additional urlr of remote Maven repository.
-* map( notation, paths ): Map local compiled class paths to a notation. The map is applied when loading or listing jar. This is useful for local development that overrides an artifact. A single or Array of paths can be set.
-* exclude( excludes ): Add a artifact:group that will be excluded from resolved dependencies. A single or Array of excludes can be set.
-* jar( notations, opts = {} ): Add Jar dependency in artifact notation, artifact:group:version as the bare minimum. A single or Array of notations can be passed. Default scope is *compile*, can be specified by setting opts = { :scope => <new_scope> }
-* pom( pom_path, opts = {} ): Add a local Maven pom, default is to load dependencies for all scopes. To select the scopes to be loaded from the pom, set the opts = { :scopes => <new_scopes> }
-* scope( scopes ): Set the scope for nested jar or pom. A single or Array of scopes can be set.
-
-Example Jarfile
-
-  repository 'http://repository.jboss.org/nexus/content/groups/public-jboss'
-  	
-  // Default scope is compile
-  jar "org.apache.mina:mina-core:2.0.4"
-  
-  scope 'runtime' do
-    jar 'org.apache.tomcat:servlet-api:jar:6.0.35'
-  end
-  
-  scope 'test' do
-    jar 'junit:junit:jar:4.10'
-  end
-  
-	
-==== Resolving dependencies
-
-* LockJar.lock( *args ): Using a Jarfile, creates a lock file. Depending on the type of arg, a different configuration is set.
-  * An arg of a String will set the Jarfile path, e.g. '/somewhere/Jarfile.different'. Default jarfile is *Jarfile*
-  * An arg of a Hash will set the options, e.g. { :local_repo => 'path' }
-    * *:download* if true, will download jars to local repo. Defaults to true.
-    * *:local_repo* sets the local repo path
-    * *:lockfile* sets the Jarfile.lock path. Default lockfile is *Jarfile.lock*.
-
-When the Jarfile is locked, the transitive dependencies are resolved and saved to the Jarfile.lock file.
-
-Example of locking a Jarfile to a Jarfile.lock
-
-    LockJar.lock
-  
- 
-==== Jarfile.lock
-
-The Jarfile.lock generated is a YAML file containing the scoped dependencies, their resolved dependencies, and
-the additional Maven repositories.
-
-The Jarfile.lock
-
-  --- 
-  repositories: 
-    - http://repository.jboss.org/nexus/content/groups/public-jboss
-  scopes: 
-    compile: 
-      dependencies: 
-        - org.apache.mina:mina-core:2.0.4
-      resolved_dependencies: 
-        - org.apache.mina:mina-core:jar:2.0.4
-        - org.slf4j:slf4j-api:jar:1.6.1
-        - com.slackworks:modelcitizen:jar:0.2.2
-        - commons-lang:commons-lang:jar:2.6
-        - commons-beanutils:commons-beanutils:jar:1.8.3
-        - commons-logging:commons-logging:jar:1.1.1
-        - ch.qos.logback:logback-classic:jar:0.9.24
-        - ch.qos.logback:logback-core:jar:0.9.24
-        - com.metapossum:metapossum-scanner:jar:1.0
-        - commons-io:commons-io:jar:1.4
-        - junit:junit:jar:4.7
-    runtime: 
-      dependencies: 
-        - org.apache.tomcat:servlet-api:jar:6.0.35
-      resolved_dependencies: 
-        - org.apache.tomcat:servlet-api:jar:6.0.35
-    test: 
-      dependencies: 
-        - junit:junit:jar:4.10
-      resolved_dependencies: 
-        - junit:junit:jar:4.10
-        - org.hamcrest:hamcrest-core:jar:1.1
-  
-  
-==== Accessing Jars
-
-* LockJar.list(*args): Lists all dependencies as notations for scopes from the Jarfile.lock.  Depending on the type of arg, a different configuration is set.  
-  * An arg of a String will set the Jarfile.lock path, e.g. 'Better.lock'. Default lock file is *Jarfile.lock*.
-  * An arg of an Array will set the scopes, e.g. ['compile','test']. Defaults scopes are *compile* and *runtime*.
-  * An arg of a Hash will set the options, e.g. { :local_repo => 'path' }
-    * *:local_repo* sets the local repo path
-    * *:local_paths* converts the notations to paths of jars in the local repo
-    * *:resolve* to true will make transitive dependences resolve before returning list of jars
-  
-* LockJar.load(*args): Loads all dependencies to the classpath for scopes from the Jarfile.lock. Defaults scopes are *compile* and *runtime*. Default lock file is *Jarfile.lock*.
-  * An arg of a String will set the Jarfile.lock, e.g. 'Better.lock'
-  * An arg of an Array will set the scopes, e.g. ['compile','test']
-  * An arg of a Hash will set the options, e.g. { :local_repo => 'path' }
-    * *:local_repo* sets the local repo path
-    * *:resolve* to true will make transitive dependences resolve before loading to classpath 
-
-Once a Jarfile.lock is generated, you can list all resolved jars by
-  
-  jars = LockJar.list
-  
-or directly load all Jars into the classpath
-  
-  jars = LockJar.load  
-
-Do not forget, if you change your Jarfile, you have to re-generate the Jarfile.lock.
-  
-==== Skipping the Jarfile
-
-You can skip the Jarfile and Jarfile.lock to directly play with dependencies by passing a block to LockJar.lock, LockJar.list, LockJar.load
-
-===== Lock without a Jarfile
-
-    LockJar.lock do
-      jar 'org.eclipse.jetty:example-jetty-embedded:jar:8.1.2.v20120308'
-    end
-
-===== List without a Jarfile.lock
-    
-    LockJar.list do
-      jar 'org.eclipse.jetty:example-jetty-embedded:jar:8.1.2.v20120308'
-    end
-
-===== Load without a Jarfile.lock
-    
-    LockJar.load do
-      jar 'org.eclipse.jetty:example-jetty-embedded:jar:8.1.2.v20120308'
-    end
-
-Since you skipped the locking part, mostly likely you will need to resolve the dependences in the block, just pass the 
-:resolve => true option to enable dependency resolution (also works for LockJar.list).
-
-    LockJar.load( :resolve => true ) do
-      jar 'org.eclipse.jetty:example-jetty-embedded:jar:8.1.2.v20120308'
-    end
-
-=== Command line
-
-There is a simple command line helper. You can lock a Jarfile with the following command
-
-    lockjar lock
-
-List jars in a Jarfile.lock with 
- 
-   lockjar list
-  
-Download all jars in a Jarfile.lock with
-
-   lockjar install
-  
-_lockjar_ _--help_ will give you list of all commands and their options.
-
-=== Bundler Integration
-
-Has been deprecated to https://github.com/mguymon/lock_jar/tree/bundler_support
-  
-=== Buildr Integration
-
-LockJar integrates with {Buildr}[http://buildr.apache.org/] using an {Addon}[https://github.com/mguymon/lock_jar/blob/master/lib/lock_jar/buildr.rb].
-This allows the Jarfile to be defined directly into a buildfile. A global LockJar definition can be set and
-is inherited to all projects. Each project may have its own LockJar definition. A lock file is generated per project based
-on the project name.
-
-A new Buildr task is added to generate the lockfile for all projects
-
-  buildr lock_jar:lock
-  
-and a task per project to generate the lockfile for a single project
-
-  buildr <app>:<project>:lock_jar:lock
-
-In a project, you can access an Array of notations using the *lock_jars* method, accepts same parameters as {LockJar.list}[https://github.com/mguymon/lock_jar#accessing-jars]
-
-  lock_jars()
-
-
-
-The compile scoped dependencies are automatically added to the classpath for compiling. The test scoped dependencies are
-automatically added to the classpath for tests. Do not forget, if you change the lock_jar
-definitions, you have to rerun the *lock_jar:lock* task.
-
-
-==== Example
-
-Sample buildfile with LockJar
-
-  require 'lock_jar/buildr'
-  
-  # app definition, inherited into all projects
-  lock_jar do
-
-       scope 'test' do
-         jar 'junit:junit:jar:4.10'
-       end
-  end
-
-  define 'app' do
-
-     def 'project1' do
-       lock_jar do
-         jar  "org.apache.mina:mina-core:2.0.4"
-       end
-     end
-
-     def 'project2' do
-        lock_jar do
-          pom 'pom.xml'
-        end
-     end
-
-  end
-
-Generated the following lock files using lock_jar:lock
-
-* project1.lock - contains junit and mina jars.
-* project2.lock - contains junit and pom.xml jars.
-  
-
-== License
-
-Licensed to the Apache Software Foundation (ASF) under one or more
-contributor license agreements.  See the NOTICE file distributed with this
-work for additional information regarding copyright ownership.  The ASF
-licenses this file to you under the Apache License, Version 2.0 (the
-"License"); you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-  http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
-License for the specific language governing permissions and limitations under
-the License.
-