artrest 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MzNlODRhZDFkMWVkMjJmZjNhN2E2YmQ5Mzg1OWE0YTFhMWE5OTQzYw==
+  data.tar.gz: !binary |-
+    MzM0ZDBhOWMxOTkwZDQwYjQwM2I5MDRjMTUzZWE4NzdjMTA4Njk5MA==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    NjE4MjM0YTQ0MjczYmJiZGE2NzYyNDE1MzgwNDlmMDZhYTZlMDBlYjJkYmY3
+    MzUxYmYzZmYxY2ZlNWIzZGE3YzhlMmJlY2Y4MDA2ODk0MGNmN2M5ZDM1NDky
+    YzhjNTE4NGI5MTlmZjcyNjA4MGJlZGFkMDYxNWNhYjQxZWJmOTQ=
+  data.tar.gz: !binary |-
+    ZmYxZmMyZWYyOTUwY2ExYzUzMDA4NWQ2NjY3Y2Q2MmVhOGVmYzRmNWVhZGRl
+    MzhkMWQyZDkwZDJiODYzOGMxMTE0NGFiMjQ5N2U0ODZhYzYwZDg2ZjhkNWE3
+    NmMzOTE1ODgwNDZlOWE3NmIzMjYzNDgyNTE0YzE3ODc5MTM0MzU=

data/.gitignore

@@ -0,0 +1,20 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.swp
+requests/
+html/*

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in artrest.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Olaf Bergner
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,29 @@
+# Artrest
+
+ArtRest, a ruby client for the Artifactory REST API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'artrest'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install artrest
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,31 @@
+require 'rubygems'
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+if RUBY_VERSION <= '1.9.0'
+    require "rake/rdoctask"
+else
+    require 'rdoc/task'
+end
+
+desc "Run all specs"
+RSpec::Core::RakeTask.new(:spec) do |spec|
+    spec.rspec_opts = ["--color", "--format", "nested"]
+    spec.pattern = 'spec/**/*_spec.rb'
+end
+
+desc "Print specdocs"
+RSpec::Core::RakeTask.new(:doc) do |spec|
+    spec.rspec_opts = ["--format", "specdoc"]
+    spec.pattern = 'spec/*_spec.rb'
+end
+
+desc "Generate the rdoc"
+Rake::RDocTask.new do |rdoc|
+    files = ["README.md", "LICENSE.txt", "lib/**/*.rb"]
+    rdoc.rdoc_files.add(files)
+    rdoc.main = "README.md"
+    rdoc.title = "ArtRest: Ruby Artifactory client"
+end
+
+desc "Run the rspec"
+task :default => :spec

data/artrest.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'artrest/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "artrest"
+  gem.version       = ArtRest::VERSION
+  gem.authors       = ["Olaf Bergner"]
+  gem.email         = ["olaf.bergner@gmx.de"]
+  gem.description   = %q{ArtRest: A Ruby REST client for Artifactory}
+  gem.summary       = %q{ArtRest is a commandline client for the Artifactory REST API}
+  gem.homepage      = "http://github.com/obergner/artrest"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_runtime_dependency     'rest-client', '>= 1.6.7'
+  gem.add_runtime_dependency     'json', '>= 1.7.5'
+  gem.add_runtime_dependency     'activesupport', '>= 3.0.0'
+  gem.add_runtime_dependency     'gli', '>= 2.4.1'
+  gem.add_runtime_dependency     'mime-types', '>= 1.19'
+  gem.add_runtime_dependency     'addressable', '>= 2.3.2'
+  
+  gem.add_development_dependency 'rake', '>= 0.9.2.2'
+  gem.add_development_dependency 'rspec', '>= 2.11.0'
+  gem.add_development_dependency 'webmock', '>= 1.9.0'
+end

data/bin/artrest

@@ -0,0 +1,194 @@
+#!/usr/bin/env ruby
+require 'gli'
+require 'yaml'
+require 'active_support/core_ext/hash/keys'
+require 'artrest'
+
+include GLI::App
+
+#
+# Global options
+#
+program_desc 'A command-line interface for Artifactory\'s REST API'
+
+version ArtRest::VERSION
+
+desc 'Artifactory\'s base URL'
+default_value 'http://localhost:8081/artifactory'
+arg_name 'Artifactory URL'
+flag [:h,:host]
+
+desc 'Username used to access Artifactory'
+default_value 'admin'
+arg_name 'Artifactory user'
+flag [:u,:user]
+
+desc 'Password used to access Artifactory'
+default_value 'password'
+arg_name 'Artifactory password'
+flag [:p,:password]
+
+desc 'Configuration file containing default values for all options'
+long_desc 'Path to a configuration file containing default values for all global options that may be passed on the command line.
+
+It is intended that global options passed on the command line overwrite corresponding options defined in this configuration file.
+This feature is NOT YET IMPLEMENTED!'
+default_value File.join(ENV['HOME'], '.artrest.yml')
+arg_name 'Configuration file'
+flag [:c, :config]
+
+#
+# Preprocess commands
+#
+pre do |global,command,options,args|
+    # Pre logic here
+    # Return true to proceed; false to abourt and not call the
+    # chosen command
+    # Use skips_pre before a command to skip this block
+    # on that command only
+    config = load_config_file(global[:config])
+    global.merge!(config)
+    ArtRest.connect(global[:host], global[:user], global[:password])
+end
+
+def load_config_file(filename)
+    return {} unless File.exist?(filename)
+    YAML.load_file(filename).symbolize_keys
+end
+
+#
+# Artifactory's system API
+#
+desc 'Entry point into Artifactory\' system API: info, ping, global configuration'
+command :system do |c|
+
+    c.desc 'Print system info to stdout'
+    c.long_desc 'Print Artifactory\'s system configuration to stdout. Mainly
+     * JVM version
+     * JVM command line parameters
+     * JVM memory consumption
+    '
+
+    c.command :info do |info|
+        info.action do |global_options,options,args|
+            puts ArtRest.system.unparsed_content.to_s
+        end
+    end
+
+    c.desc 'Ping Artifactory and print response to stdout'
+    c.long_desc 'Issue a ping request to Artifactory and print its response to stdout'
+
+    c.command :ping do |ping|
+        ping.action do |global_options,options,args|
+            puts ArtRest.system.ping
+        end
+    end
+
+    c.desc 'Optional file to store configuration in. If not given, configuration will be printed to stdout.'
+    c.arg_name 'file'
+
+    c.desc 'Retrieve Artifactory\'s global configuration'
+    c.long_desc 'Retrieve Artifactory\'s global configuration and either print it to stdout or store it in a file'
+
+    c.command :config do |config|
+        config.action do |global_options,options,args|
+            filename = args[0]
+            cfg = ArtRest.system.configuration.unparsed_content.to_s
+            if filename
+                File.open(filename, 'w') { |f| f.write(cfg) }
+            else
+                puts cfg
+            end
+        end
+    end
+
+    c.default_command :info
+end
+
+#
+# Artifactory's builds API
+#
+desc 'Print information about builds to stdout'
+command :builds do |c|
+
+    c.desc 'Pretty print output in a format fit to be parsed by mere humans'
+    c.switch [:p, :pretty]
+
+    c.desc 'Print a list of all builds to stdout'
+
+    c.command :all do |all|
+
+        all.action do |global_options,options,args|
+            puts ArtRest.builds.unparsed_content(options[:pretty] ? :pretty : :plain).to_s
+        end
+    end
+
+    c.desc 'Name of build to retrieve'
+    c.arg_name 'build'
+
+    c.desc 'Print information on named build to stdout'
+
+    c.command :get do |get|
+
+        get.action do |global_options,options,args|
+            help_now!('name of build to retrieve is required') if args.empty?
+            puts ArtRest.builds[args[0]].unparsed_content(options[:pretty] ? :pretty : :plain).to_s
+        end
+    end
+
+    c.default_command :all
+end
+
+#
+# Artifactory's buildnumber API
+#
+desc 'Print information about buildnumbers to stdout'
+command :buildnumber do |c|
+
+    c.desc 'Pretty print output in a format fit to be parsed by mere humans'
+    c.switch [:p, :pretty]
+
+    c.desc 'Name of build to retrieve'
+    c.arg_name 'build'
+
+    c.desc 'Number of build to retrieve'
+    c.arg_name 'buildnumber'
+
+    c.desc 'Print information on named build/buildnumber to stdout'
+
+    c.action do |global_options,options,args|
+        help_now!('name of buildnumber to retrieve is required') if args[0].nil?
+        help_now!('number of buildnumber to retrieve is required') if args[1].nil?
+        puts ArtRest.builds[args[0]][args[1]].unparsed_content(options[:pretty] ? :pretty : :plain).to_s
+    end
+end
+#
+# Artifactory's repositories API
+#
+desc 'Print information about repositories to stdout'
+command :repositories do |c|
+
+    c.action do |global_options,options,args|
+        puts "repositories command ran"
+    end
+end
+
+#
+# Postprocess commands + error handling
+#
+post do |global,command,options,args|
+    # Post logic here
+    # Use skips_post before a command to skip this
+    # block on that command only
+end
+
+on_error do |exception|
+    # Error logic here
+    # return false to skip default error handling
+    true
+end
+
+#
+# Main
+#
+exit run(ARGV)

data/lib/artrest.rb

@@ -0,0 +1,81 @@
+require 'addressable/uri'
+require 'rest-client'
+require 'json'
+require 'mime/types'
+require 'active_support/core_ext/string/inflections'
+require 'active_support/core_ext/kernel/singleton_class'
+
+require 'artrest/version'
+require 'artrest/resource'
+require 'artrest/resources'
+require 'artrest/system'
+require 'artrest/system_general_configuration'
+require 'artrest/repositories'
+require 'artrest/repository'
+require 'artrest/dir_entry'
+require 'artrest/builds'
+require 'artrest/build'
+require 'artrest/buildnumber'
+
+module ArtRest
+
+    class << self
+        attr_accessor :options
+    end
+
+    # Cache supplied +base_url+, +username+ and +password+ prior to using this
+    # API.
+    #
+    # * *Args*    :
+    #   - +base_url+ -> Our Artifactory server's URL, typically
+    #     http://localhost:8081/artifactory
+    #   - +username+ -> Username used when connecting to Artifactory
+    #   - +password+ -> Password used when connecting to Artifactory
+    #   - +options+ -> Additional connections parameters, currently unused
+    # * *Raises* :
+    #   - +ArgumentError+ -> If one of the parameters is +nil+
+    #
+    def self.connect(base_url, user, password, options = {})
+        raise ArgumentError.new "Must pass base_url" unless base_url
+        raise ArgumentError.new "Must pass user" unless user
+        raise ArgumentError.new "Must pass password" unless password
+        self.options = {
+            :base_url => base_url,
+            :user     => user,
+            :password => password
+        }
+        self.options.merge!(options)
+    end
+
+    # Return *the* ArtRest::System resource.
+    #
+    # * *Returns* :
+    #   - *The* ArtRest::System resource
+    # * *Raises* :
+    #   - +RuntimeException+ -> If you didn't call ::connect prior to calling
+    #     this method
+    #
+    def self.system
+        self.check_connected
+        System.get(self.options[:base_url], self.options)
+    end
+
+    # Return *the* ArtRest::Builds resource.
+    #
+    # * *Returns* :
+    #   - *The* ArtRest::Builds resource
+    # * *Raises* :
+    #   - +RuntimeException+ -> If you didn't call ::connect prior to calling
+    #     this method
+    #
+    def self.builds
+        self.check_connected
+        Builds.get(self.options[:base_url], self.options)
+    end
+
+    private
+
+    def self.check_connected
+        raise RuntimeError, "You need to call ArtRest::connect prior to using this API" unless self.options
+    end
+end

data/lib/artrest/build.rb

@@ -0,0 +1,31 @@
+
+module ArtRest
+
+    # Represents an {Artifactory}[http://www.jfrog.com/home/v_artifactory_opensource_overview]
+    # {Build Runs}[http://wiki.jfrog.org/confluence/display/RTF/Artifactory's+REST+API#Artifactory'sRESTAPI-BuildRuns]
+    # resource.
+    #
+    # === Example
+    #
+    #  build = ArtRest::Build.new('http://localhost:8081/artifactory/api/build/wicket', { ... })
+    #
+    class Build < ArtRest::Resources
+
+        class << self
+
+            def matches_path(path, options) # :nodoc:
+                path =~ %r|^/api/build/[a-zA-Z+-._]+/?$|
+            end
+        end
+
+        self.mime_type = MIME::Types['application/json']
+
+        self.resources_creator = Proc.new do |content, options|
+            self_url = content['uri']
+            (content['buildsNumbers'] || []).map { |buildnr| ArtRest::Buildnumber.new("#{self_url}#{buildnr['uri']}", options) }
+        end
+
+        self.resource_attributes :uri,
+            :buildsNumbers
+    end
+end