# Naether

Naether is a Java Dependency Resolver using Maven's [Aether](https://github.com/sonatype/sonatype-aether) 
that can be used by Ruby or Java.

<https://github.com/mguymon/naether>

[RDoc](http://rubydoc.info/gems/naether/frames) | [JavaDoc](http://mguymon.github.com/naether/apidocs/index.html) | [Wiki](https://github.com/mguymon/naether/wiki)

## Install

### Ruby

JRuby 1.6.8 is natively supported. Ruby 1.8.7 and 1.9.3 use [Rjb](http://rjb.rubyforge.org) to proxy over JNI.

    gem install naether
    
The jar dependencies for Naether will automatically be downloaded when the gem installs.

### Java

    <dependency>
      <groupId>com.tobedevoured.naether</groupId>
      <artifactId>naether</artifactId>
      <version>0.9.0</version>
    </dependency>
   
May have to add the Sonatype Repo if the sync to Maven Central is slow.

    <repositories>
      <repository>
        <id>oss.sonatype.org</id>
        <name>Sonatype Repository</name>
        <url>https://oss.sonatype.org/content/groups/public</url>
      </repository>
    </repositories>

## Usage

### Ruby

All of the Naether dependencies are loaded via a Custom ClassLoader.

#### Bootstraping

Naether [jar dependences](https://github.com/mguymon/naether/blob/master/jar_dependencies.yml) 
must be loaded for Naether to work. This is easily done with the [bootstrap helper](http://rdoc.info/gems/naether/Naether/Bootstrap)

    Naether::Bootstrap.bootstrap_local_repo

#### Resolving Dependencies

    require 'rubygems
    require 'naether'
    
    Naether::Bootstrap.bootstrap_local_repo
    naether = Naether.new
    naether.dependencies = [ "ch.qos.logback:logback-classic:jar:0.9.29", "junit:junit:jar:4.8.2" ]
    naether.resolve_dependencies().
    
    puts naether.dependences_notation
    
Will output

    ["ch.qos.logback:logback-core:jar:0.9.29",
     "ch.qos.logback:logback-classic:jar:0.9.29",
     "junit:junit:jar:4.8.2",
     "org.slf4j:slf4j-api:jar:1.6.1" ]

[Additional documentation on Resolving Dependencies](https://github.com/mguymon/naether/wiki/Ruby-Resolving-Dependencies)

### Java

#### Resolving Dependencies

    Naether naether = new Naether();
    naether.addDependency( "ch.qos.logback:logback-classic:jar:0.9.29" );
    naether.addDependency( "junit:junit:jar:4.8.2" );
    naether.resolveDependencies();
    System.out.println( naether.getDependenciesNotation().toString() );

Will output:
   
    ["ch.qos.logback:logback-core:jar:0.9.29",
     "ch.qos.logback:logback-classic:jar:0.9.29",
     "junit:junit:jar:4.8.2",
     "org.slf4j:slf4j-api:jar:1.6.1" ]

[Additional documentation on Resolving Dependencies](https://github.com/mguymon/naether/wiki/Java-Resolving-Dependencies)

## 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.