The following scripts are in Python and they can be invoked from the command line using python (or jython). For example, if you want to run the quick-search.py script, you would run “jython quick-search.py activemq” to search for artfiacts that contain the string “activemq”. I tested these Python scripts using the latest Jython 2.5b0 distribution with version 1.2.6 of the jython-elementtree project at Google Code.  Go to the Jython page, download Jython 2.5b0, and then following the instructions on the jython-elementtree project list to check out the ElementTree library from source control and install it in your own Jython installation.  These scripts don’t require Jython, the could run in any Python 2.5 implementation.

The Nexus REST API

The UI of Nexus is written in ExtJS and it makes heavy use of AJAX callbacks to REST services. In fact, if you load up Nexus in a tool like Firebug, an extension for Firefox which allows you to trace all network activity, you will see that almost every action in Nexus triggers a call to a REST service. For more details about the Nexus REST services and for a pointer to the documentation, read the previous blog post in this series which was focused on a similar set of Ruby scripts.

If you would like to download the sample scripts in this blog post, you can download this ZIP file which contains four Python scripts: http://books.sonatype.com/tutorial-files/nexus-rest-python.zip

Listing Repositories

The first script simply lists all of the repositories in a Nexus installation. Here it is:

import urllib,sys
from xml.etree import ElementTree
from xml.etree import ElementPath
 
url = 'http://repository.sonatype.org/service/local/repositories'
data = urllib.urlopen( url ).read()
 
doc = ElementTree.XML( data )
 
for a in ElementPath.findall(doc, ".//repositories-item"):
  print ( a.find("name").text + " (" +
        a.find("id").text + ")\n\t" +
        a.find("resourceURI").text ) + "\n"

This script sets the pattern for the scripts to follow. We construct a URL, then we call urlopen and read the response body into a String. Then we use ElementTree to parse the XML document. Once the document is parsed, we use ElementPath to apply our XPath expression to the document. Finally the repository, the repository id, and the repository URL is printed out. This script could not be more straightforward. This post is simply a pointer to the service and a quick demonstration so I’m not going to dive into the meaning of every single element in the XML document returned by the repositories service. If you are interested in see the full set of elements that are available, load up the results of this service in a web browser by click on this: http://repository.sonatype.org/service/local/repositories.

Performing a “Quick Search”

import urllib,sys
from xml.etree import ElementTree
from xml.etree import ElementPath
 
url = 'http://repository.sonatype.org/service/local/data_index?q='
data = urllib.urlopen( url + sys.argv[1] ).read()
 
doc = ElementTree.XML( data )
 
for a in ElementPath.findall(doc, ".//artifact"):
  print ( a.find("groupId").text + ":" +
        a.find("artifactId").text + ":" +
        a.find("version").text )

This script follows the pattern of the previous script to list all repositories with the exception that it reads an argument from the command line. This script performs a quick search by hitting the data_index service and passing in the q parameter. This script simply prints out the groupId:artifactId:version of all the artifacts located.

If you would like to see an example of the XML that this service produces click here: http://repository.sonatype.org/service/local/data_index?q=activemq. In the full results, you’ll see more information such as the number of search hits available, the resource URL for each artifact found, and the context (or repository) in which the artifact is available.

Searching by Class Name

import urllib,sys
from xml.etree import ElementTree
from xml.etree import ElementPath
 
url = 'http://repository.sonatype.org/service/local/data_index?cn='
data = urllib.urlopen( url + sys.argv[1] ).read()
 
doc = ElementTree.XML( data )
 
for a in ElementPath.findall(doc, ".//artifact"):
  print ( a.find("groupId").text + ":" +
        a.find("artifactId").text + ":" +
        a.find("version").text )

This script is almost exactly the same as the prior script that performed a quick search. The difference in this script is that instead of passing the q parameter, this script passes the cn parameter. Passing the cn parameter causes Nexus to search for artifacts which contain classes that match the given value. The results are going to look the same as the quick search query script. To see the XML yourself, search for all artifacts which contain a class named HibernateDaoSupport: http://repository.sonatype.org/service/local/data_index?cn=HibernateDaoSupport.

Performing a GAV Search

import urllib,sys
from xml.etree import ElementTree
from xml.etree import ElementPath
 
url = 'http://repository.sonatype.org/service/local/data_index?'
url = url + "g=" + sys.argv[1] + "&a=" + sys.argv[2] + "&v=" + sys.argv[3]
data = urllib.urlopen( url ).read()
 
doc = ElementTree.XML( data )
 
for a in ElementPath.findall(doc, ".//artifact"):
  print ( a.find("groupId").text + ":" +
        a.find("artifactId").text + ":" +
        a.find("version").text )

This final script takes three command line arguments: groupId, artifactId, version, and it performs a GAV (groupId, artifactId, version) coordinate search over the repository.

The following scripts are in Groovy and they can be invoked from the command line using groovy.  For example, if you want to run the QuickSearch.groovy script, you would run “groovy QuickSearch.groovy activemq” to search for artfiacts that contain the string “activemq”.   I tested these Ruby scripts using the latest Groovy 1.5.7 distribution.  Go to the Groovy page, click on Download, and download the Cross-platform Installer, this will install Groovy on your machine and also tell you what you’ll need to add to your PATH.

The Nexus REST API

The UI of Nexus is written in ExtJS and it makes heavy use of AJAX callbacks to REST services.  In fact, if you load up Nexus in a tool like Firebug, an extension for Firefox which allows you to trace all network activity, you will see that almost every action in Nexus triggers a call to a REST service. For more details about the Nexus REST services and for a pointer to the documentation, read the previous blog post in this series which was focused on a similar set of Ruby scripts.

If you would like to download the sample scripts in this blog post, you can download this ZIP file which contains four Groovy scripts: http://books.sonatype.com/tutorial-files/nexus-rest-groovy.zip

Listing Repositories

The first script simply lists all of the repositories in a Nexus installation.  Here it is:

def xml = "http://repository.sonatype.org/service/local/repositories".toURL().text
 
def root = new XmlParser().parseText( xml )
root.data.'repositories-item'.each {
  println "${it.name.text()} (${it.id.text()})"
  println "\t${it.resourceURI.text()}\n"
}

This script sets the pattern for the scripts to follow.  We construct a URL in String, then we call toURL() and get the text attribute from the method call. In one line we fetch the response body. then we use the XmlParser in Groovy to print out the Repository name, id, and URL. This script could not be more straightforward. This post is simply a pointer to the service and a quick demonstration so I’m not going to dive into the meaning of every single element in the XML document returned by the repositories service.   If you are interested in see the full set of elements that are available, load up the results of this service in a web browser by click on this: http://repository.sonatype.org/service/local/repositories.

Performing a “Quick Search”

def xml = ("http://repository.sonatype.org/service/local/data_index?q=" + args[0]).toURL().text
 
def root = new XmlParser().parseText( xml )
root.data.artifact.each {
  println "${it.groupId.text()}:${it.artifactId.text()}:${it.version.text()}"
}

This script follows the pattern of the previous script to list all repositories with the exception that it reads an argument from the command line.   This script performs a quick search by hitting the data_index service and passing in the q parameter.   This script simply prints out the groupId:artifactId:version of all the artifacts located.

If you would like to see an example of the XML that this service produces click here: http://repository.sonatype.org/service/local/data_index?q=activemq. In the full results, you’ll see more information such as the number of search hits available, the resource URL for each artifact found, and the context (or repository) in which the artifact is available.

Searching by Class Name

def xml = ("http://repository.sonatype.org/service/local/data_index?cn=" + args[0]).toURL().text
 
def root = new XmlParser().parseText( xml )
root.data.artifact.each {
  println "${it.groupId.text()}:${it.artifactId.text()}:${it.version.text()}"
}

This script is almost exactly the same as the prior script that performed a quick search.  The difference in this script is that instead of passing the q parameter, this script passes the cn parameter.   Passing the cn parameter causes Nexus to search for artifacts which contain classes that match the given value.   The results are going to look the same as the quick search query script.     To see the XML yourself, search for all artifacts which contain a class named HibernateDaoSupport: http://repository.sonatype.org/service/local/data_index?cn=HibernateDaoSupport.

Performing a GAV Search

def xml = "http://repository.sonatype.org/service/local/data_index?g=${args[0]}&a=${args[1]}&v=${args[2]}".toURL().text
 
def root = new XmlParser().parseText( xml )
root.data.artifact.each {
  println "${it.groupId.text()}:${it.artifactId.text()}:${it.version.text()}"
}

This final script takes three command line arguments: groupId, artifactId, version, and it performs a GAV (groupId, artifactId, version) coordinate search over the repository.

The following scripts are in Ruby and they use the REXML XML processor and the Net:HTTP library.  Both of these libraries are available in the Ruby standard library.   I tested these Ruby scripts using the latest JRuby release.  If you want to try these scripts out on your own, they will run in any standard Ruby interpreter without requiring any extra RubyGems.

The Nexus REST API

The UI of Nexus is written in ExtJS and it makes heavy use of AJAX callbacks to REST services.  In fact, if you load up Nexus in a tool like Firebug, an extension for Firefox which allows you to trace all network activity, you will see that almost every action in Nexus triggers a call to a REST service.  We’re going to focus on just two services in this post: list repositories and searching for artifacts, but you should know that there are hundreds of things you can do to Nexus via the various REST interfaces that are available.  In fact, you could create a custom UI tailored to your own needs that interfaces with Nexus via this REST backend.    In addition to the REST services in the core Nexus installation, you can extend Nexus and add in your own REST services via a Nexus plugin.  The Nexus UI is completely decoupled from the set of services Nexus provides, and the services which Nexus provides can be extended.

The Nexus REST Services are documented here.  In this post, we’re going to be writing scripts that hit the public instance of Sonatype Nexus at http://repository.sonatype.org, our REST URLs are going to look something like this: http://repository.sonatype.org/service/local/data_index?q=maven.  If you were attempting to hit the services on your local Nexus installation, your REST URL would look more like this: http://localhost:8081/nexus/service/local/data_index?cn=HibernateDaoSupport.   These REST URLs follow the pattern:  “http://{host}:{port}/{context}/service/{instance}/{service}?{query_params}” where the {instance} will almost always be “local”.

If you would like to download the sample scripts in this blog post, you can download this ZIP file which contains four Ruby scripts: http://books.sonatype.com/tutorial-files/nexus-rest-ruby.zip

Listing Repositories

The first script simply lists all of the repositories in a Nexus installation.  Here it is:

require 'net/http'
require 'rexml/document'
include REXML
 
url = 'http://repository.sonatype.org/service/local/repositories'
resp = Net::HTTP.get_response( URI.parse( url ) )
 
doc = REXML::Document.new( resp.body )
 
XPath.each( doc, "//repositories-item" ) do |r|
  puts "#{r.elements["name"].text}(#{r.elements["id"].text})"
  puts "\t" + r.elements["resourceURI"].text + "\n\n"
end

This script sets the pattern for the scripts to follow.  We construct a URL in the script (a more general script would read this from a config file), then we make the request using Net::HTTP and we parse the results with REXML by passing it to the Document constructor.  At this point, I use XPath to select all of the repositories and I print out the name, id, and the URL of the repository as served by Nexus.

This post is simply a pointer to the service and a quick demonstration so I’m not going to dive into the meaning of every single element in the XML document returned by the repositories service.   If you are interested in see the full set of elements that are available, load up the results of this service in a web browser by click on this: http://repository.sonatype.org/service/local/repositories.

Performing a “Quick Search”

require 'net/http'
require 'rexml/document'
include REXML
 
url = 'http://repository.sonatype.org/service/local/data_index?q='
resp = Net::HTTP.get_response( URI.parse( url + ARGV[0]) )
 
doc = REXML::Document.new( resp.body )
 
XPath.each( doc, "//data/artifact" ) do |r|
  puts "#{r.elements["groupId"].text}:#{r.elements["artifactId"].text}:#{r.elem\
ents["version"].text}"
end

This script follows the pattern of the previous script to list all repositories with the exception that it reads an argument from the command line.   This script performs a quick search by hitting the data_index service and passing in the q parameter.   This script simply prints out the groupId:artifactId:version of all the artifacts located.

If you would like to see an example of the XML that this service produces click here: http://repository.sonatype.org/service/local/data_index?q=activemq. In the full results, you’ll see more information such as the number of search hits available, the resource URL for each artifact found, and the context (or repository) in which the artifact is available.

Searching by Class Name

require 'net/http'
require 'rexml/document'
include REXML
 
url = 'http://repository.sonatype.org/service/local/data_index?cn='
resp = Net::HTTP.get_response( URI.parse( url + ARGV[0]) )
 
doc = REXML::Document.new( resp.body )
 
XPath.each( doc, "//data/artifact" ) do |r|
  puts "#{r.elements["groupId"].text}:#{r.elements["artifactId"].text}:#{r.elem\
ents["version"].text}"
end

This script is almost exactly the same as the prior script that performed a quick search.  The difference in this script is that instead of passing the q parameter, this script passes the cn parameter.   Passing the cn parameter causes Nexus to search for artifacts which contain classes that match the given value.   The results are going to look the same as the quick search query script.     To see the XML yourself, search for all artifacts which contain a class named HibernateDaoSupport: http://repository.sonatype.org/service/local/data_index?cn=HibernateDaoSupport.

Performing a GAV Search

require 'net/http'
require 'rexml/document'
include REXML
 
url = "http://repository.sonatype.org/service/local/data_index?g=#{ARGV[0]}&a=#\
{ARGV[1]}&v=#{ARGV[2]}"
resp = Net::HTTP.get_response( URI.parse( url ) )
 
doc = REXML::Document.new( resp.body )
 
XPath.each( doc, "//data/artifact" ) do |r|
  puts "#{r.elements["groupId"].text}:#{r.elements["artifactId"].text}:#{r.elem\
ents["version"].text}"
end

This final script takes three command line arguments: groupId, artifactId, version, and it performs a GAV (groupId, artifactId, version) coordinate search over the repository.